summaryrefslogtreecommitdiff
diff options
context:
space:
mode:
-rw-r--r--doc/protocols/ground-crx.txt33
-rw-r--r--doc/protocols/ihu-cpu.txt48
-rw-r--r--doc/protocols/ttx-down.txt55
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