Mask of bits, that defines the format of data that will be sent by the data server.
It is a combination of bits. You can set all the bits to 1 if you want all the informations 0b11111 = 31.
You can also, for example, only wants the timestamp and the digital I/Os state ( 0b11 = 3).
You can also choose, for example, to get the additional data 2 ( 0b1000 = 8 ).
Bit 0: Timestamp
- 0 Not sent
- 1 timestamp sent by the dataserver
Bit 1: Digital I/Os state
- 0 Not sent
- 1 digital I/Os state sent by the data server
Bit 2: Additional data 1
- 0 Not sent
- 1 Additional data 1 sent by the data server
Bit 3: Additional data 2
- 0 Not sent
- 1 Additional data 2 sent by the data server
Bit 4: Format of the value
- 0 Raw value (as sent by the sensor)
- 1 Standardised value. The format of the frame will then depends on the model of the sensor. See system documentation.
If ulDataFormat is set to 0, the frame send by the dataserver will have the following definition
unsigned long eventsrc;
unsigned long positionlow;
unsigned long positionhigh;
unsigned long error;
If you set ulDataFormat to 1 (send timestamp), then the frame send by the dataserver will be changed. At the end of the "basic" frame, we add the timestamp.
unsigned long ts;
unsigned long tus;
If you set ulDataFormat to 2 = 0b10 (send digital I/Os state), then the frame send by the dataserver will be changed. At the end of the "basic" frame, we add the state of the digital I/Os.
unsigned long digiostate;
If you set ulDataFormat to 4 = 0b100 (send additional data 1), then the frame send by the dataserver will be changed. At the end of the "basic" frame, we add the value of the first additional data.
unsigned long ad1value;
\encode
If you set ulDataFormat to 8 = 0b1000 (send additional data 2), then the frame send by the dataserver will be changed. At the end of the "basic" frame, we add the value of the second additional data. \n
\code
unsigned long ad2value;
\encode
If you set the bits 0, 1, 2 and 3 to 1, the format of the frame will then be: \n
\code
unsigned long eventsrc;
unsigned long positionlow;
unsigned long positionhigh;
unsigned long error;
unsigned long ts;
unsigned long tus;
unsigned long digiostate;
unsigned long ad1value;
unsigned long ad2value;
The bit 4 of the ulDataFormat is more complex. The format of the frame that is sent by the dataserver will depend on the model of the sensor used. See the system documentation for more information, or the "Acquisition" menu of the web site. |