Sensoray 817 - Manual (Page 15)

15
Troubleshooting and Debugging Tools
This section describes data types and functions used for obtaining various status
information from the 817 board. Though not required to be used during normal
operation, those could provide assistance in resolving various performance issues.
CHAN_STATUS
typedef struct {
int lastCmd;
unsigned int chanTick;
int putToSleep;
int lockPend;
int fvidStat;
unsigned int noFreeBufJpg;
unsigned int noFreeBufBmp;
} CHAN_STATUS;
Defines a status structure for a capture channel. Returned as part of
SYS_STATUS
structure by S817_GetStatusInfo function.
lastCmd
Last command received by a channel.
chanTick
Value of system 1 ms timer corresponding to the last frame captured by a channel
(frame capture rate always equals the video source frame rate regardless of the
frame decimation setting which affects the output frame rate).
putToSleep
lockPend
A non-zero value of any of those indicates a critical hardware error on a channel.
fvidStat
A value of 1 indicates normal operation. Other values indicate a critical hardware
error.
noFreeBufJpg, noFreeBufBmp
This value is a running count of the conditions when there was no free buffer
available on the host to accept data from the board. It does not indicate a critical
error, but could be used to gauge the overall performance of the system. Usually a
small number of those cases is registered when the application starts. Steady
increase of this value indicates an application’s performance bottleneck and results
in some decrease of capture rate.
SYS_STATUS
typedef struct {