Document delimiters for both formats.
authorChristopher Peplin <chris.peplin@rhubarbtech.com>
Thu, 27 Mar 2014 15:38:33 +0000 (11:38 -0400)
committerChristopher Peplin <chris.peplin@rhubarbtech.com>
Thu, 27 Mar 2014 15:38:33 +0000 (11:38 -0400)
README.md

index f67dad9..0ad8942 100644 (file)
--- a/README.md
+++ b/README.md
@@ -3,16 +3,22 @@
 This specification is a part of the [OpenXC platform][OpenXC].
 
 An OpenXC vehicle interface sends generic vehicle data over one or more output
-interfaces (e.g. USB or Bluetooth) as JSON objects, separated by newlines.
+interfaces (e.g. USB or Bluetooth) as JSON or Protocol Buffers (protobuf).
 
-There are two valid message types - single valued and evented.
+This document describes the JSON format and includes a high level description of
+each type and field. Each JSON message published by a VI is delimited with a
+`\0` character.
+
+The Protocol Buffer format is specified in the file `openxc.proto`. Those are
+published using the standard length-delimited method (any protobuf library
+should support this).
+
+## Single Valued
 
 There may not be a 1:1 relationship between input and output signals - i.e. raw
 engine timing CAN signals may be summarized in an "engine performance" metric on
 the abstract side of the interface.
 
-## Single Valued
-
 The expected format of a single valued message is:
 
     {"name": "steering_wheel_angle", "value": 45}