Cronologic Ndigo5G-10, User Manual

Page: 43 / 54

3.5 Readout
int ndigo read( ndigo device *device, ndigo read in *in, ndigo read out *out)
Return a pointer to an array of captured data in read out . The result can contain any number
of packets of type ndigo packet . read in provides parameters to the driver. A call to this method
automatically allows the driver to reuse the memory returned in the previous call.
Returns an error code as defined in the structure ndigo read out .
int ndigo acknowledge( ndigo device *device, ndigo packet *packet)
Acknowledge all data up to the packet provided as parameter. This is mandatory if acknowl-
edge last read in the ndigo read in structure is set to false for calls to ndigo read .
This feature allows to either free up partial DMA space early if there will be no call to
ndigo read anytime soon. It also allows to keep data over multiple calls to ndigo read to avoid
unnecessary copying of data.
int ndigo process tdc packet( ndigo device *device, ndigo packet *packet)
Call on a TDC packet to update the timestamp of the packet with a more accurate value. If
called more than once on a packet the timestamp will be invalid.
3.5.1 Input Structure ndigo read in
ndigo bool t acknowledge last read
If set ndigo read automatically acknowledges packets from the last read.
3.5.2 Input Structure ndigo read out
ndigo packet *first packet
Pointer to the first packet that was capture by the call of ndigo read .
ndigo packet *last packet
Address of header of the last packet in the buffer.
int error code
#define NDIGO READ OK 0
#define NDIGO READ NO DATA 1
#define NDIGO READ INTERNAL ERROR 2
const char *error message
3.6 Other Functions
3.6.1 LED control
There are six LEDs on the front panel. The intensity of the red and green part can be set from
0 to 255. There is no blue component in the current version. Per default all LEDs are set to
auto mode. This means that used channels are lit green, activity is shown as yellow on overflow
is shown as red.
int ndigo set led color( ndigo device *device, int led, unsigned short r, unsigned short g,
cronologic GmbH & Co. KG 38 Ndigo5G User Guide