summaryrefslogtreecommitdiff
path: root/doc/protocols/mpu-transceiver.txt
blob: f629510a79884a71d1603ebf489b68cd777146d0 (plain) (blame)
1
2
3
4
5
6
7
8
9
10
11
12
13
14
15
16
17
18
19
20
21
22
23
24
25
26
27
28
29
30
31
32
33
34
35
36
37
38
39
40
41
42
43
44
45
46
47
48
49
50
51
52
53
54
55
56
57
58
59
60
61
62
63
64
65
66
67
68
69
70
71
72
73
74
75
76
77
78
79
80
81
82
83
84
85
86
87
88
89
90
91
92
93
94
95
96
97
98
99
100
101
102
103
104
105
106
107
108
109
110
111
112
113
114
115
116
117
118
119
120
121
122
123
124
125
126
127
128
129
130
131
132
133
134
135
136
137
138
139
140
141
142
143
144
145
146
147
148
149
150
151
152
153
154
155
156
157
158
159
160
161
162
163
164
165
166
167
168
169
170
171
172
173
174
175
176
177
178
179
180
181
182
183
184
185
186
187
188
189
190
191
192
193
194
195
196
197
198
199
200
201
202
203
204
205
206
207
208
209
210
211
212
213
214
215
216
217
218
219
220
221
222
223
224
225
226
227
228
229
230
231
232
233
234
235
236
237
238
239
240
241
242
243
244
245
246
247
248
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"