summaryrefslogtreecommitdiff
path: root/host/mex/doc/mex.txt
diff options
context:
space:
mode:
authorNicolas Schodet2011-03-30 20:08:34 +0200
committerNicolas Schodet2011-03-30 20:08:34 +0200
commit057180987cacfe47edbe21bf2f8c0573901ded2f (patch)
treece5eb7c68525ead0430d43051428a9234ebfa053 /host/mex/doc/mex.txt
parentc9a004ed32389dd17167f19be7916ef9320e8e39 (diff)
host/mex, digital/avr/modules/host: add message type reservation, refs #157
Diffstat (limited to 'host/mex/doc/mex.txt')
-rw-r--r--host/mex/doc/mex.txt21
1 files changed, 18 insertions, 3 deletions
diff --git a/host/mex/doc/mex.txt b/host/mex/doc/mex.txt
index 4c8eb559..ef299d56 100644
--- a/host/mex/doc/mex.txt
+++ b/host/mex/doc/mex.txt
@@ -37,9 +37,8 @@ been handled (or discarded).
The minimum required information in a message is the message type. This is a
single byte (with some reserved values) which should be sufficient to decode
-the rest of the message. There is for the moment no central message type
-identifier repository, the developer is responsible to ensure no collision
-occurs.
+the rest of the message. Message types should be reserved by requesting them
+from the hub.
When the message is sent to another process, it is prepended with its size and
sequence number (which are not part of the message, neither its size). The
@@ -167,6 +166,22 @@ RSP
The receiving node will decapsulate the message and will use it as a
response to its request.
+RES
+ This is a message type reservation request.
+
+ When sent to the hub, it contains a reservation string which identify the
+ message type.
+
+ +------------+--------------------+
+ | RES (B: 4) | reservation string |
+ +------------+--------------------+
+
+ When sent to the node, it contains the allocated message type.
+
+ +------------+-----------------+
+ | RES (B: 4) | allocated mtype |
+ +------------+-----------------+
+
Programmer interface
====================