BioBoard/Documentation/Arduino protocol

From Noisebridge
Revision as of 03:43, 4 May 2011 by Rolfvw (talk | contribs) (Created page with '=The BioBoard Protocol= In order for the Arduino with all its sensors connected to communicate to the outside world, there needs to be an agreement on how that data should look. …')
(diff) ← Older revision | Latest revision (diff) | Newer revision → (diff)
Jump to: navigation, search

The BioBoard Protocol

In order for the Arduino with all its sensors connected to communicate to the outside world, there needs to be an agreement on how that data should look. Otherwise, all that interesting data would be lost. Hence, the BioBoard Protocol.

An Example

The best way to explain the details of the protocol is with some examples. If we want to tell the server that the current temperature is 25.5 degrees C, we send the following packet from the Arduino:

 @TC:0:25.5$

TC is the tag for "temperature in degrees C". It is a floating point number (i.e. has a decimal point). Besides that, the rest is really just syntactic sugar. Here are some simple rules:

  • All packets begin with @ and end with $ characters.
  • Fields are separated with a : character.
  • After the @ character, is a tag for the type of packet. The tags are typically in all capitals.
  • If the tag indicates a type of probe or sensor, it is followed by a probe number. This is always an integer.