XCTrack Open Data

XCTOD is a text protocol that allows to show any generic data in the “External data” widget.

Structure of the message

$XCTOD,field1,field2,...,field50[\r]\n

• every message starts with $XCTOD header
• fields are divided by the comma , character
• the comma character can be escaped by \ (this\,is\,one\,field)
• the value of the field is shown “as is” in the widget (spaces are allowed)
• for the simplicity there is no checksum
• number of fields is limited up to 50
• the line is finished by \n character, the \r character is optional
• if you want to leave the value in particular field untouched, use #N# value
  • useful when you have 2 independent devices
  • from XCTrack 0.9.12

Example

Here is the example of configured widgets and some input data:

Another usage of External data display widget

If you have amazing external sensor connected by BLE with a new feature that is cool, but too specialized to earn its own widget, you can contact us with service and characteristics uuids. We can implement reading the data and propagate it to open data values, so the External data display widget can be configured to display them. User can control this functionality by allowing “Extended and open data (XCTOD)” (EXT) property of the sensor.