HOME Using the ESM Getting Started

You have to write code in your Arduino sketch to send data out to the ESM in a formatted way for the relevant visualiser to display the data appropriately. Additionally the ESM library can make it easy to receive data into your Arduino sketch, even if you only use the supplied IDE monitor.

Unformatted data can be sent to the ESM and it will simply appear as-is in the Monitor visualiser.

All the visualisers receive formatted data from the Arduino in the same way. In order to make this easy to do some simple functions are provided in a library. These relieve you of having to manage buffers and simplify the code in the sketch and ensure that data is correctly formatted. For example each message comprises of the following:-

  1. A start character which is the #.
  2. A visualiser name to be used to display the data.
  3. Optional commands to tell the visualiser to do something other than display data such as go into pause mode, set titles.
  4. Data which is separated by the ~ character.
  5. And finally the length of the data sent, preceded by a $ character, which the ESM uses to check it has received the data correctly.

The ESM support library should be copied into your Arduino library directory. You can choose any folder name to put it into but it is suggested that “_ESM” is used.

The library can also be down loaded from this ZIP file which also includes the sample sketch.