New Docu: interfacing with Kenwood TH-F7E Transceiver

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

1 files changed, 249 insertions, 0 deletions

diff --git a/doc/protocols/mpu-transceiver.txt b/doc/protocols/mpu-transceiver.txt
new file mode 100644
index 0000000..f629510
--- /dev/null
+++ b/doc/protocols/mpu-transceiver.txt
@@ -0,0 +1,249 @@
+Notes about electrical Interface betwem MPU and TH-F7E
+
+
+
+============================================================
+Open Issues:
+============================================================
+  in Electrical connections:
+    * TODO: confirm 5way button also works with serial/audioGND
+  generally:
+    * does "Battery Saver" Feature work if DC In powered ??
+
+
+============================================================
+Electrical connections:
+============================================================
+  PTT               optional, connect to PTT key on TH-F7E, can also be done via serial interface
+  Vss               connect to battery minus terminal (7.4V) or DC In (13.8V)
+  Vdd               connect to battery plus terminal (7.4V) or DC In (13.8V)
+
+  serialRX          connect to audio jack (~4V signal level)
+  serialTX          connect to audio jack (~4V signal level)
+  serial/audioGND   connect to audio jack
+  serialVdd         connect to audio jack (TH-F7E provides ~4V here when on)
+  Speaker           connect to audio jack (4V signal level ????)
+  Microphone        connect to audio jack (4V signal level ????)
+
+  5way-Enter        connect to 5way rocker button (press down aka enter)
+  5way-Up           connect to 5way rocker button (press up)
+  5way-Right        connect to 5way rocker button (press right)
+                    TODO: confirm 5way button also works with serial/audioGND
+
+  PWR               connect to PWR Button (works with serial/audioGND (even if OFF))
+
+  Reset             ??? still needs to be found on TH-F7E
+
+
+
+
+
+Setting "PC" Mode via 5way rocker button after Menu Reset "SR 2" (enable serial commands):
+  Send following buttons in sequence:
+  Button            #times
+  5way-Enter        1
+  5way-Up           8
+  5way-Right        1
+  5way-Up           2
+  5way-Right        1
+
+  after enabling PC mode, any serial command sent will exit menu. menu position will remain at entry 9 so
+  Menu Reset has to be sent before repeating above sequence
+
+
+
+============================================================
+Notes about serial PC protocol of Kenwood TH-F7E Transceiver
+============================================================
+
+TH-F7E needs to be in "PC" Mode (Menu Entry #9)
+TH-F7E needs to be in "9600bps" Mode (Menu Entry #28) but can be set via serial command. It disables volume dial,speaker and microphone, lowers volume on speaker jack and enables speaker/mic jack for broadband transmissions
+
+Baud rate: 9600
+Bits: 8
+Parity: none
+
+Note:
+Transceiver actually has 2 transceivers A and B. Unit can be switched between dual or two single modes, where the audio in/out is either A, B or A+B. In case of A+B the balance between the two channels can be set. Transmission (push PTT) occurs on the active channel.
+
+Note on Commands:
+Query commands usually return same strings as setting commands. i.e. The string returned from a query always is a valid set command.
+Commands to be sent are enclosed in "CMD" and are sent without hyphens and terminated with newline.
+
+----------
+Commands:
+----------
+
+Squelch
+  Query TRX A: "SQ 0"
+  Query TRX B: "SQ 1"
+  Squelch A Off: "SQ 0,00"
+  Squelch B Off: "SQ 1,00"
+  Squelch A Max: "SQ 0,05"
+  ...
+
+Start Transmitting
+  "TX"
+
+Stop Transmitting:
+  "RX"
+
+Switch Lamp Off:
+  "LMP 0"
+
+Keyboard Lock (locks everything except PTT,MON,FN and volume dial/keys)
+  Query: "LK"
+  Lock Keys: "LK 1"
+  Unlock Keys: "LK 0"
+
+Set Modulation on currently active TRX (A or B)
+  Query: "MD"
+  Set Modulation to FM : "MD 0"
+  Set Modulation to AM : "MD 2" (only on B, only RX)
+  Set Modulation to LSB: "MD 3" (only on B, only RX)
+  Set Modulation to USB: "MD 4" (only on B, only RX)
+  Set Modulation to CW : "MD 5" (only on B, onlx RX)
+
+Set Narrow FM Mode (off: 5Khz FM-Hub, on: 2.5KHz FM-Hub)
+  Narrow FM Off: "NAR 0,0"  "NAR 1,0"
+  Narrow FM On : "NAR 0,1"  "NAR 1,1"
+
+Set TX Power
+  Set Power on A to HIGH: "PC 0,0"
+  Set Power on B to HIGH: "PC 1,0"
+  Set Power on A to LOW : "PC 0,1"
+  Set Power on A to LOW : "PC 1,1"
+  Set Power on B to ELOW: "PC 0,2"
+  Set Power on B to ELOW: "PC 1,2"
+
+System Reset
+  Don't Reset "SR 0"  (no effect)
+  VFO Reset   "SR 1"
+    (reboots TH-F7E, resets frequency, band, trx, squelch level and power.
+     Is SAFE i.e. does not touch PC mode setting)
+  Menu Reset  "SR 2"
+    (reboots TH-F7E,
+     resets menu settings to defaults,
+     resets menu position to first entry,
+     does NOT reset set frequency, band, trx, power or squelch
+     WARNING will reset from PC to SP/MIC mode. Afterwards TH-F7E can no longer be controlled via serial commands )
+  Full Reset  "SR 3"
+    (reboots TH-F7E while printing "RESETTING",
+     pretty much SR 1 and 2 combined + reset of saved memory channels)
+
+Automatic Power Off
+  Query:     "APO"
+  APO Off    "APO 0"
+  APO 30min  "APO 1"
+  APO 60min  "APO 2"
+
+Dual Mode (A/B or A+B)
+  Query: "DL"
+  Switch On : "DL 1"
+  Switch Off: "DL 0"
+
+Switch to A or B transceiver
+  Query:        "BC"
+  Switch to A:  "BC 0"
+  Switch to B:  "BC 1"
+
+Switch Band when A trx is selected
+  to 2m      "RBN 0"
+  to 70cm    "RBN 2"
+
+Switch Band when B trx is selected
+  to 2m      "RBN 9"
+  to 70cm    "RBN C"
+
+Read current frequency and step size on active band and trx
+  Query: "FQ"
+  returns: "FQ <11digit frequency>,<1digit step size>"
+
+Get frequency of arbitrary band (band
+  get info about 2m on A:  "VR 0"
+  get info about 70cm on A: "VR 2"
+  get info about 2m on B:  "VR 9"
+  get info about 70cm on B: "VR C"
+
+Set frequency of arbitrary band
+  "VW <freq>,<stepsize>,..."
+  (see documentation page 27, or just echo back "VR" output after substituting VR with VW)
+  (note that 2nd argument after frequency is step size which affects what frequency can be set,
+   use ",0" for 5kHz step size and ",1" for 6.25kHz step size, everything else is just multiple of those)
+
+
+VFO Mode (instead of memory mode)
+  Set A trx to VFO Mode:  "VMC 0,0"
+  Set B trx to VFO Mode:  "VMC 1,0"
+
+Adjust balance between A and B transceiver in A+B mode
+  Set Balance 0.5*A + 0.5 B   "BAL 2"
+  Set Balance 1*A + 0*B       "BAL 0"
+  Set Balance 0*A + 1*B       "BAL 4"
+
+Set Battery Saver (receiver switches off periodically until carrier above squelch level is detected)
+  Query: "SV"
+  Switch battery saver off:            "SV 0"
+  Set receiver check interval to 0.8s: "SV 4"
+  Set receiver check interval to 1s:   "SV 5"
+  Set receiver check interval to 3s:   "SV 7"
+  Set receiver check interval to 5s:   "SV 9"
+
+Switch 9600 bps mode on/off:
+(9600-mode disables squelch, speaker, microphone and puts broadband (lower signal level) signal on mic/speaker jacks)
+  Query: "DATP"
+  Enable 9600bps mode:  "DATP 1"
+  Disable 9600bps mode: "DATP 0"
+
+
+---------------
+Initialization:
+---------------
+
+Switch off B transceiver, and set A and B (even if off) to 144.90Mhz FM and 433.00625MHz FM on 2m/70cm bands respectively
+and set A and B to use TX Power 0.5W (using 7.4V Battery) or 2W (using 13.8V DC In)
+and switch off squelch
+
+  "SR 1"
+  wait 2s
+  "APO 0"
+  "BAL 2"
+  "DL 0"              (switch off Dual Mode. alternatively "DL 1" and we can listen on B while transmitting on A)
+  "BC 0"
+  "RX"
+  "SQ 0,00"
+  "SQ 1,00"
+  "DATP 1"
+  "PC 0,1"
+  "PC 1,1"
+  "VW 0,00144905000,0,0,0,0,0,0,08,08,000,000600000,0"
+  "VW 2,00433006250,1,0,0,0,0,0,08,08,000,001600000,0"  (take care to use the right step size for each frequency)
+  "VW 9,00144900000,0,0,0,0,0,0,08,08,000,000600000,0"
+  "VW C,00433006250,1,0,0,0,0,0,08,08,000,001600000,0"
+  "RBN 0"
+
+------
+Usage:
+------
+
+Listen on A previously set 144.90MHz:
+  "BC 0"
+  "RBN 0"
+
+Listen on B previously set 144.90MHz:
+  "BC 1"
+  "RBN 9"
+
+Listen on A previously set 433.00625MHz:
+  "BC 0"
+  "RBN 2"
+
+Listen on A previously set 433.00625MHz:
+  "BC 1"
+  "RBN C"
+
+Start transmitting:
+  "TX"
+
+Stop transmitting:
+  "RX"