Protocol Format.txt

A blocks packet consists of a stream of packed bits.

The first 7 bits of a message is the index of the device within the topology to which the
message should be delivered, or from which it originated. The 0x40 bit of this will be set
to indicate that it's a device->host message, or clear for host->device

The next 32 bits are a timestamp, in milliseconds since the source device was booted.
If sending from the host to the device, or for types of packet 
where the timestamp is irrelevant, this can be 0.

This is followed by a sequence of 1 or more messages. Each message starts with
a 7 bit message type, followed by message-type-specific data.


---------------------------------------------------------------------------------------
Device topology update (device -> host)

7 bits - message type (0x01)
7 bits - number of device-info blocks to follow
8 bits - number of connection-info blocks to follow

This is followed by a series of device-info blocks of the form:

10 bits - device model identifier (see code for list of types)
32 bits - device GUID
10 bits - device firmware version
6 bits - battery status

Next follows by a series of connection-info blocks of the form:

7 bits - device 1 index (i.e. index in the list of devices sent above)
5 bits - device 1 port type
7 bits - device 2 index
5 bits - device 2 port type

Ports are indicated by being either North, South, East or West on a device, plus
an index to indicate their position along that edge.

---------------------------------------------------------------------------------------
Control button down/up (device -> host)

7 bits - message type (down = 0x20, up = 0x21)
7 bits - device index
12 bits - control button ID (see code for values)

---------------------------------------------------------------------------------------
Touch start/move/end (device -> host)

7 bits - message type (start = 0x10, move = 0x11, end = 0x12)
7 bits - device index
5 bits - touch index
12 bits - touch X position
12 bits - touch Y position
8 bits - touch Z position

---------------------------------------------------------------------------------------
Touch start/move/end with velocity (device -> host)

7 bits - message type (start = 0x13, move = 0x14, end = 0x15)
7 bits - device index
5 bits - touch index
12 bits - touch X position
12 bits - touch Y position
8 bits - touch Z position
8 bits - X velocity
8 bits - Y velocity
8 bits - Z velocity

---------------------------------------------------------------------------------------
---------------------------------------------------------------------------------------
Device command message (host -> device)

7 bits - message type (0x01)
8 bits - command type

Command types:

    resetDevice                         = 0x00,
    requestTopologyMessage              = 0x01,
    setHighResTouchDetectionMode        = 0x02,
    setLowResTouchDetectionMode         = 0x03,

---------------------------------------------------------------------------------------
Modify shared state data block

7 bits - message type (0x02)

..then repeatedly:
  3 bits - type of data change command
  ...extra command-specific bits..
  3 bits - type of data change command
  ..etc..
  3 bits - end of sequence command