CANgate User's Manual - dataTaker

The floating point conversion only supports values in the range -16777216 to 16777216. Values outside this range will
be returned as 99999.9.
If an integer conversion type is specified, the scale and offset parameters will be converted to integers.
The format strings "%X\n" and "\n" do different things. The former will output the scaled data value as a
hexadecimal number; the latter will output the raw data value as it appears in the CAN message (no byte reversal,
scaling, etc.)
To include a literal % or \ character, enter %% or \\ respectively.
Defaults
To summarise the rules regarding default formatting behaviour:
Examples
if FORMAT is present, with a formatString, and the format string contains a conversion specifier, then the data will be
formatted according to the conversion specifier. (Numeric conversion specifiers will only work if the data size is 32 bits
or less, if it is longer then the data will be returned in raw hexadecimal format.)
if FORMAT is present, with a formatString, and the format string does not contain a conversion specifier, then the data
will be returned in raw hexadecimal form (or ASCII string form for GPS slots), followed by the format string text.
if FORMAT is present, without a formatString, then a default format string will be used: "%f\n" for CAN slots, or
"%s\n" for GPS.
if FORMAT is not present, then a default format string will be used: "\n" for CAN slots (ie. raw hexadecimal followed
by CRLF), or "%s\n" for GPS.
The following examples assume that the last matching CAN message had the data: 01234567AABBCCDD.
RECV 1 0x100 1 2 – returns 0123 CR LF.
RECV 1 0x100 1 2 FORMAT 100 – returns 29100.00 CR LF. (0123 hex, scaled by 100)
RECV 1 0x100 1 2 FORMAT ";" – returns 0123;
RECV 1 0x100 1 2 FORMAT "%d %%\n" – returns 291 % CR LF. (0123 hex)
RECV 1 0x100 1 2 FORMAT N "x=%d Pa\n" – returns x=8961 Pa CR LF. (2301 hex)
RECV 1 0x100 1 8 FORMAT "%d\n" – returns 01234567AABBCCDD CR LF. (no conversion if > 32 bits)
RECV 1 0x100 1 2 FORMAT .5 10 "%9.3f\n" – returns
155.500 CR LF. (2 leading spaces)
RECV 1 0x100 1 2 FORMAT .5 10 "%09.3f\n" – returns 00155.500 CR LF. (2 leading zeroes)
RECV 1 0x100 1 2 FORMAT .5 10 "%-9.3f\n" – returns 155.500
RECV 1 0x100 1 2 FORMAT .5 10 "%f," – returns 155.50,
CR LF. (2 trailing spaces)
RECV 1 0x100 4.8 4.6 FORMAT "Z\t%d" – returns Z TAB 3 (byte 4 = 67 hex, bits 8:6 = 011 binary = 3)
The following assume that the last received GPS string was: $GPGLL,1244.98,S,11102.09,E
GPS "GPGLL" 2 FORMAT ">%3s%.4s