updated protocol docs

git-svn-id: https://svn.spreadspace.org/mur.sat@32 7de4ea59-55d0-425e-a1af-a3118ea81d4c

3 files changed, 136 insertions, 0 deletions

diff --git a/doc/protocols/ground-crx.txt b/doc/protocols/ground-crx.txt
new file mode 100644
index 0000000..08b87fb
--- /dev/null
+++ b/doc/protocols/ground-crx.txt
@@ -0,0 +1,33 @@
+Protocol Definition between Ground Stations and Command RX
+==========================================================
+
+
+Introduction
+------------
+
+using DTMF on FM
+receiver should be activated for min. 200ms every 5s to listen for new commands
+signs get scrambled using a secret Code Table
+every command must be aknowledge by a beacon with the unscrambled code
+
+Frame
+-----
+
+#42<code><cs>
+
+Checksum:
+---------
+
+Xor over Signs intrepreted as HEX (0-9A-D#*)
+
+Codes:
+------
+
+0    ..    shut up (rfkill)
+1    ..    unshut up (no rfkill)
+
+8    ..    activate payload reciever
+
+C    ..    cancel all commands
+#    ..    reset
+*    ..    safe mode
diff --git a/doc/protocols/ihu-cpu.txt b/doc/protocols/ihu-cpu.txt
index 165c36d..90678ff 100644
--- a/doc/protocols/ihu-cpu.txt
+++ b/doc/protocols/ihu-cpu.txt
@@ -44,6 +44,24 @@ Messages
 Messages are separated in request and responses. Requests use upper case
 letters and replies use lower case.
 
+ 'A' - Activate Payload receiver (IHU -> IHU)
+ ~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~
+
+ This command tells the CPU to activate the payload receiver and
+ listen for incoming commands from ground stations.
+
+ Expected response: 'a'
+
+
+ 'C' - Cancel active and all pending commands (IHU -> IHU)
+ ~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~
+
+ This command cancels all downlinḱ commands in terms of 
+ communication between the satellite and an ground station.
+
+ Expected response: 'c'
+
+
  'F' - Finish up (IHU -> CPU)
  ~~~~~~~~~~~~~~~
 
@@ -78,6 +96,28 @@ letters and replies use lower case.
  Expected response: 't'
 
 
+ 'V' - Config Value update (CPU -IHU)
+ ~~~~~~~~~~~~~~~~~~~~~~~~~
+ 
+ Tell the IHU that the configuration values have been updated by a ground
+ station. 
+ Config Values:
+  - Beacon Interval in seconds (1 Byte)
+
+
+
+ 'a' - Ack to activate receiver (CPU -> IHU)
+ ~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~
+
+ Sent as an acknowledge to a received 'A' when the
+ receiver is enabled.
+
+ 'c' - Ack to cancel commands (CPU -> IHU)
+ ~~~~~~~~~~~~~~~~~~~~~~~~~~~~
+
+ Sent as an acknowledge to a received 'C' when all commands
+ are canceled.
+
 
  'f' - Ack to finish up (CPU -> IHU)
  ~~~~~~~~~~~~~~~~~~~~~~
@@ -99,6 +139,14 @@ letters and replies use lower case.
  as data.
 
 
+ 'v' - Ack to config value change (IHU -> CPU)
+ ~~~~~~~~~~~~~~~~~~~~~~~~~
+
+ Sent as an acknowledge to a received 'V' when the new configuraion
+ is in place.
+
+
+
 Example Communication
 ---------------------
 
diff --git a/doc/protocols/ttx-down.txt b/doc/protocols/ttx-down.txt
new file mode 100644
index 0000000..bc06d4f
--- /dev/null
+++ b/doc/protocols/ttx-down.txt
@@ -0,0 +1,55 @@
+Protocol Definition for TTX Beacon to Ground Stations
+=====================================================
+
+
+Introduction
+------------
+
+using CW on FSK
+transceiver should send a beacon about every 60s
+transceiver sends a aknowledge frame if requested
+
+Signs (Char Table)
+------------------
+
+!"$&'()+
+,-./0123
+456789:;
+<=>?@ABC
+DEFGHIJK
+LMNOPQRS
+TUVWXYZ
+
+Base32 Coded Signs
+------------------
+
+   | 0 1 2 3 4 5 6 7 8 9 A B C D E F
+-------------------------------------
+00 | A B C D E F G H I J K L M N O P
+10 | Q R S T U V W X Y Z 0 1 2 3 4 5
+
+Beacon Frame:
+-------------
+
+CALLSIGN (4 Signs)  .. the satellites call sign (i.e. OE0M)
+CNT      (3 Signs)  .. beacon counter
+STATE    (1 Sign)   .. Base32 coded bitfield
+CMDQLEN  (1 Sign)   .. Number of commands in queue (Base32)
+... tba
+CHECKSUM (1 Sign)   .. Parity Sign
+
+
+ Bitfields
+ ~~~~~~~~~
+ 
+  STATE:
+
+  LSB    RX_STATE    .. Payload Receiver State (0 = OFF, 1 = ON)
+  ... tba
+  MSB    
+
+Aknowledge Frame
+----------------
+
+'A'       (1 Sign)     .. Preamble for Aknowledgments
+CRXCODE   (1 Sign)     .. unscrambled command code from CRX