
3.5 Readout
int ndigo250m read(ndigo device *device, ndigo250m read in *in, ndigo250m read out *out)
For each DMA channel returns 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 ndigo250m 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 ndigo250m read in
ndigo bool t acknowledge last read
If set ndigo read automatically acknowledges packets from the last read.
mask
This is a bitmask that defines which channels are to be read. All other channels will be left
untouched. A value of 0 reads all channels.
3.5.2 Input Structure ndigo250m read out
ndigo packet *first packet[NDIGO25M DMA COUNT]
For each DMA channel a pointer to the first packet that was captured by the call of ndigo read.
ndigo packet *last packet[NDIGO25M DMA COUNT]
For each DMA channels the address of the header of the last packet in the buffer.
int error code[NDIGO25M DMA COUNT]
#define NDIGO READ OK 0
#define NDIGO READ NO DATA 1
#define NDIGO READ INTERNAL ERROR 2
const char *error message[NDIGO25M DMA COUNT] Error messages created by readout
cronologic GmbH & Co. KG 39 Ndigo250M-14 User Guide
Comentarios a estos manuales