5.2.14 - StreamData

After starting the stream, the data will be sent as available in the following format. Reads oldest data from buffer.

Table 5.2.14-1. StreamData Response

• SamplesPerPacket: From StreamConfig function.
• TimeStamp: Not currently implemented during normal operation, but after auto-recovery this reports the number of packets missed (1-65535).
• PacketCounter: An 8-bit (0-255) counter that is incremented by one for each packet of data. Useful to make sure packets are in order and no packets are missing.
• Sample#: Stream data is placed in a FIFO (first in first out) buffer, so Sample0 is the oldest data read from the buffer. The analog input reading is returned justified as a 16-bit value.
• Backlog: When streaming, the processor acquires data at precise intervals, and transfers it to a FIFO buffer until it can be sent to the host. This value represents how much data is left in the buffer after this read. The value ranges from 0-255, where 256 would equal 100% full.

Stream mode on the U6 uses a feature called auto-recovery. If the stream buffer gets too full, the U6 will go into auto-recovery mode. In this mode, the U6 no longer stores new scans in the buffer, but rather new scans are discarded. Data already in the buffer will be sent until the buffer contains fewer samples than SamplesPerPacket, and every StreamData packet will have errorcode 59. Once the stream buffer contains less samples than SamplesPerPacket, the U6 will start to buffer new scans again. The next packet returned will have errorcode 60. This packet will have 1 dummy scan where each sample is 0xFFFF, this scan separates new data from any pre auto-recovery data. Note that the dummy scan could be at the beginning, middle, or end of this packet, and can span multiple packets. If the dummy scan spans multiple packets then the packet with error code 60 will contain the end of the dummy scan. Also, the TimeStamp parameter in this packet contains the number of scans that were discarded, allowing correct time to be calculated. The dummy scan counts as one of the missing scans included in the TimeStamp value.