Cronologic Ndigo5G-10, User Manual

Page: 32 / 54

3.3 Status Information
3.3.1 Functions for Information Retrieval
The driver provides functions to retrieve detailed information on the type of board, its configu-
ration, settings and state. The information is split according to its scope and the computational
requirements to query the information from the board.
int ndigo get static info( ndigo device *device , ndigo static info *info)
This structure contains information about the board that does not change during run time.
int ndigo get param info( ndigo device *device , ndigo param info *info)
The structure returned by this call contains information that changes indirectly due to configu-
ration changes.
int ndigo get fast info( ndigo device *device , ndigo fast info *info)
This call returns a structure that contains dynamic information that can be obtained within a
few microseconds.
int ndigo get slow info( ndigo device *device , ndigo slow info *info)
The data reported in this structure requires milliseconds to be obtained. The application should
only call it in situation where the program flow can cope with an interruption of that magnitude.
3.3.2 Structure ndigo static info
This structure contains information about the board that does not change during run time. It
is provided by the function
ndigo get static info .
int size
The number of bytes occupied by the structure
int version
A version number that is increased when the definition of the structure is changed. The incre-
ment can be larger than one to match driver version numbers or similar. Set to 0 for all versions
up to first release.
int board id
Index of the board as passed to the constructor or set via int ndigo set board id(ndigo device
*device, int board id) .
int driver revision
The lower three bytes contain a triple level hierarchy of version numbers, e.g. 0x010103 encodes
version 1.1.3.
A change in the first digit generally requires a recompilation of user applications. Change in
the second digit denote significant improvements or changes that don’t break compatibility and
the third digit changes with minor bugfixes and similar updates.
int firmware revision
Firmware revision of the FPGA configuration. This increments only when there is a functional
change.
int board revision
0 for experimental prototypes labeled “Rev. 1”
2 for the version produced until 2010 labeled “Rev. 2”‘
cronologic GmbH & Co. KG 27 Ndigo5G User Guide