2 * Copyright © 2009 Keith Packard <keithp@keithp.com>
4 * This program is free software; you can redistribute it and/or modify
5 * it under the terms of the GNU General Public License as published by
6 * the Free Software Foundation; either version 2 of the License, or
7 * (at your option) any later version.
9 * This program is distributed in the hope that it will be useful, but
10 * WITHOUT ANY WARRANTY; without even the implied warranty of
11 * MERCHANTABILITY or FITNESS FOR A PARTICULAR PURPOSE. See the GNU
12 * General Public License for more details.
14 * You should have received a copy of the GNU General Public License along
15 * with this program; if not, write to the Free Software Foundation, Inc.,
16 * 59 Temple Place, Suite 330, Boston, MA 02111-1307 USA.
24 /* Values from SmartRF® Studio for:
26 * Deviation: 20.507812 kHz
27 * Datarate: 38.360596 kBaud
29 * RF Freq: 434.549927 MHz
30 * Channel: 99.975586 kHz
32 * RX filter: 93.75 kHz
36 * For IF freq of 140.62kHz, the IF value is:
38 * 140.62e3 / (24e6 / 2**10) = 6
41 #define IF_FREQ_CONTROL 6
44 * http://www.ntia.doc.gov/files/ntia/publications/84-168.pdf
46 * Necessary bandwidth for a FSK modulated signal:
48 * bw = 2.6d + 0.55b 1.5 < m < 5.5
49 * bw = 2.1d + 1.9b 5.5 < m < 20
51 * b is the modulation rate in bps
52 * d is the peak deviation (from the center)
56 * 20.5 kHz deviation 38.4kbps signal:
58 * m = 41 / 38.4, which is < 5.5:
60 * bw = 2.6 * 20.5 + 0.55 * 38.4 = 74.42kHz
62 * M = 1, E = 3, bw = 75kHz
64 * 5.125 kHz deviation, 9.6kbps signal
66 * m = 10.25 / 9.6, which is < 5.5:
68 * bw = 2.6 * 5.125 + 0.55 * 9.6 = 18.6kHz
70 * M = 2, E = 3, bw = 53.6kHz
72 * 1.28125kHz deviation, 2.4kbps signal
74 * m = 2.565 / 2.4, which is < 5.5:
76 * bw = 2.6 * 20.5 + 1.9 * 2.4 = 47.61kHz
78 * M = 3, E = 3, bw = 53.6kHz
80 * For channel bandwidth of 93.75 kHz, the CHANBW_E and CHANBW_M values are
82 * BW = 24e6 / (8 * (4 + M) * 2 ** E)
87 #define CHANBW_M_384 1
93 * For a symbol rate of 38360kBaud, the DRATE_E and DRATE_M values are:
95 * R = (256 + M) * 2** E * 24e6 / 2**28
97 * So for 38360kBaud, M is 163 and E is 10
102 #define DRATE_E_384 10
104 /* For 9600 baud, M is 163 and E is 8
109 /* For 2400 baud, M is 163 and E is 6
115 * For a channel deviation of 20.5kHz, the DEVIATION_E and DEVIATION_M values are:
117 * F = 24e6/2**17 * (8 + DEVIATION_M) * 2**DEVIATION_E
119 * For 20.5kHz deviation, M is 6 and E is 3
120 * For 5.125kHz deviation, M is 6 and E is 1
121 * For 1.28125kHz deviation, M is 0 and E is 0
124 #define DEVIATION_M_384 6
125 #define DEVIATION_E_384 3
127 #define DEVIATION_M_96 6
128 #define DEVIATION_E_96 1
130 #define DEVIATION_M_24 0
131 #define DEVIATION_E_24 0
134 * For our RDF beacon, set the symbol rate to 2kBaud (for a 1kHz tone),
135 * so the DRATE_E and DRATE_M values are:
139 * To make the tone last for 200ms, we need 2000 * .2 = 400 bits or 50 bytes
142 #define RDF_DRATE_E 6
143 #define RDF_DRATE_M 94
144 #define RDF_PACKET_LEN 50
147 * RDF deviation should match the normal NFM value of 5kHz
153 #define RDF_DEVIATION_M 6
154 #define RDF_DEVIATION_E 1
156 /* This are from the table for 433MHz */
158 #define RF_POWER_M30_DBM 0x12
159 #define RF_POWER_M20_DBM 0x0e
160 #define RF_POWER_M15_DBM 0x1d
161 #define RF_POWER_M10_DBM 0x34
162 #define RF_POWER_M5_DBM 0x2c
163 #define RF_POWER_0_DBM 0x60
164 #define RF_POWER_5_DBM 0x84
165 #define RF_POWER_7_DBM 0xc8
166 #define RF_POWER_10_DBM 0xc0
168 #define RF_POWER RF_POWER_10_DBM
170 static __code uint8_t radio_setup[] = {
171 RF_PA_TABLE7_OFF, RF_POWER,
172 RF_PA_TABLE6_OFF, RF_POWER,
173 RF_PA_TABLE5_OFF, RF_POWER,
174 RF_PA_TABLE4_OFF, RF_POWER,
175 RF_PA_TABLE3_OFF, RF_POWER,
176 RF_PA_TABLE2_OFF, RF_POWER,
177 RF_PA_TABLE1_OFF, RF_POWER,
178 RF_PA_TABLE0_OFF, RF_POWER,
180 RF_FSCTRL1_OFF, (IF_FREQ_CONTROL << RF_FSCTRL1_FREQ_IF_SHIFT),
181 RF_FSCTRL0_OFF, (0 << RF_FSCTRL0_FREQOFF_SHIFT),
183 RF_MDMCFG3_OFF, (DRATE_M << RF_MDMCFG3_DRATE_M_SHIFT),
184 RF_MDMCFG2_OFF, (RF_MDMCFG2_DEM_DCFILT_ON |
185 RF_MDMCFG2_MOD_FORMAT_GFSK |
186 RF_MDMCFG2_SYNC_MODE_15_16),
187 RF_MDMCFG1_OFF, (RF_MDMCFG1_FEC_EN |
188 RF_MDMCFG1_NUM_PREAMBLE_4 |
189 (2 << RF_MDMCFG1_CHANSPC_E_SHIFT)),
190 RF_MDMCFG0_OFF, (17 << RF_MDMCFG0_CHANSPC_M_SHIFT),
194 /* SmartRF says set LODIV_BUF_CURRENT_TX to 0
195 * And, we're not using power ramping, so use PA_POWER 0
197 RF_FREND0_OFF, ((1 << RF_FREND0_LODIV_BUF_CURRENT_TX_SHIFT) |
198 (0 << RF_FREND0_PA_POWER_SHIFT)),
200 RF_FREND1_OFF, ((1 << RF_FREND1_LNA_CURRENT_SHIFT) |
201 (1 << RF_FREND1_LNA2MIX_CURRENT_SHIFT) |
202 (1 << RF_FREND1_LODIV_BUF_CURRENT_RX_SHIFT) |
203 (2 << RF_FREND1_MIX_CURRENT_SHIFT)),
210 RF_TEST2_OFF, RF_TEST2_RX_LOW_DATA_RATE_MAGIC,
211 RF_TEST1_OFF, RF_TEST1_RX_LOW_DATA_RATE_MAGIC,
214 /* default sync values */
218 /* max packet length */
219 RF_PKTCTRL1_OFF, ((1 << PKTCTRL1_PQT_SHIFT)|
220 PKTCTRL1_APPEND_STATUS|
221 PKTCTRL1_ADR_CHK_NONE),
222 RF_PKTCTRL0_OFF, (RF_PKTCTRL0_WHITE_DATA|
223 RF_PKTCTRL0_PKT_FORMAT_NORMAL|
225 RF_PKTCTRL0_LENGTH_CONFIG_FIXED),
227 RF_MCSM2_OFF, (RF_MCSM2_RX_TIME_END_OF_PACKET),
228 RF_MCSM1_OFF, (RF_MCSM1_CCA_MODE_RSSI_BELOW_UNLESS_RECEIVING|
229 RF_MCSM1_RXOFF_MODE_IDLE|
230 RF_MCSM1_TXOFF_MODE_IDLE),
231 RF_MCSM0_OFF, (RF_MCSM0_FS_AUTOCAL_FROM_IDLE|
233 RF_MCSM0_CLOSE_IN_RX_0DB),
234 RF_FOCCFG_OFF, (RF_FOCCFG_FOC_PRE_K_3K,
235 RF_FOCCFG_FOC_POST_K_PRE_K,
236 RF_FOCCFG_FOC_LIMIT_BW_OVER_4),
237 RF_BSCFG_OFF, (RF_BSCFG_BS_PRE_K_2K|
238 RF_BSCFG_BS_PRE_KP_3KP|
239 RF_BSCFG_BS_POST_KI_PRE_KI|
240 RF_BSCFG_BS_POST_KP_PRE_KP|
241 RF_BSCFG_BS_LIMIT_0),
242 RF_AGCCTRL2_OFF, (RF_AGCCTRL2_MAX_DVGA_GAIN_ALL|
243 RF_AGCCTRL2_MAX_LNA_GAIN_0|
244 RF_AGCCTRL2_MAGN_TARGET_33dB),
245 RF_AGCCTRL1_OFF, (RF_AGCCTRL1_AGC_LNA_PRIORITY_0 |
246 RF_AGCCTRL1_CARRIER_SENSE_REL_THR_DISABLE |
247 RF_AGCCTRL1_CARRIER_SENSE_ABS_THR_0DB),
248 RF_AGCCTRL0_OFF, (RF_AGCCTRL0_HYST_LEVEL_NONE |
249 RF_AGCCTRL0_WAIT_TIME_8 |
250 RF_AGCCTRL0_AGC_FREEZE_NORMAL |
251 RF_AGCCTRL0_FILTER_LENGTH_8),
257 static __code uint8_t rdf_setup[] = {
258 RF_MDMCFG4_OFF, ((CHANBW_E << RF_MDMCFG4_CHANBW_E_SHIFT) |
259 (CHANBW_M_384 << RF_MDMCFG4_CHANBW_M_SHIFT) |
260 (RDF_DRATE_E << RF_MDMCFG4_DRATE_E_SHIFT)),
261 RF_MDMCFG3_OFF, (RDF_DRATE_M << RF_MDMCFG3_DRATE_M_SHIFT),
262 RF_MDMCFG2_OFF, (RF_MDMCFG2_DEM_DCFILT_OFF |
263 RF_MDMCFG2_MOD_FORMAT_GFSK |
264 RF_MDMCFG2_SYNC_MODE_NONE),
265 RF_MDMCFG1_OFF, (RF_MDMCFG1_FEC_DIS |
266 RF_MDMCFG1_NUM_PREAMBLE_2 |
267 (2 << RF_MDMCFG1_CHANSPC_E_SHIFT)),
269 RF_DEVIATN_OFF, ((RDF_DEVIATION_E << RF_DEVIATN_DEVIATION_E_SHIFT) |
270 (RDF_DEVIATION_M << RF_DEVIATN_DEVIATION_M_SHIFT)),
272 /* packet length is set in-line */
273 RF_PKTCTRL1_OFF, ((0 << PKTCTRL1_PQT_SHIFT)|
274 PKTCTRL1_ADR_CHK_NONE),
275 RF_PKTCTRL0_OFF, (RF_PKTCTRL0_PKT_FORMAT_NORMAL|
276 RF_PKTCTRL0_LENGTH_CONFIG_FIXED),
279 static __code uint8_t fixed_pkt_setup[] = {
281 RF_MDMCFG4_OFF, ((CHANBW_E << RF_MDMCFG4_CHANBW_E_SHIFT) |
282 (CHANBW_M_384 << RF_MDMCFG4_CHANBW_M_SHIFT) |
283 (DRATE_E_384 << RF_MDMCFG4_DRATE_E_SHIFT)),
285 RF_MDMCFG3_OFF, (DRATE_M << RF_MDMCFG3_DRATE_M_SHIFT),
286 RF_MDMCFG2_OFF, (RF_MDMCFG2_DEM_DCFILT_ON |
287 RF_MDMCFG2_MOD_FORMAT_GFSK |
288 RF_MDMCFG2_SYNC_MODE_15_16),
289 RF_MDMCFG1_OFF, (RF_MDMCFG1_FEC_EN |
290 RF_MDMCFG1_NUM_PREAMBLE_4 |
291 (2 << RF_MDMCFG1_CHANSPC_E_SHIFT)),
294 RF_DEVIATN_OFF, ((DEVIATION_E_384 << RF_DEVIATN_DEVIATION_E_SHIFT) |
295 (DEVIATION_M_384 << RF_DEVIATN_DEVIATION_M_SHIFT)),
298 /* max packet length -- now set inline */
299 RF_PKTCTRL1_OFF, ((1 << PKTCTRL1_PQT_SHIFT)|
300 PKTCTRL1_APPEND_STATUS|
301 PKTCTRL1_ADR_CHK_NONE),
302 RF_PKTCTRL0_OFF, (RF_PKTCTRL0_WHITE_DATA|
303 RF_PKTCTRL0_PKT_FORMAT_NORMAL|
305 RF_PKTCTRL0_LENGTH_CONFIG_FIXED),
309 static __code struct {
312 } packet_rate_setup[] = {
315 ((CHANBW_E << RF_MDMCFG4_CHANBW_E_SHIFT) |
316 (CHANBW_M_384 << RF_MDMCFG4_CHANBW_M_SHIFT) |
317 (DRATE_E_384 << RF_MDMCFG4_DRATE_E_SHIFT)),
318 ((DEVIATION_E_384 << RF_DEVIATN_DEVIATION_E_SHIFT) |
319 (DEVIATION_M_384 << RF_DEVIATN_DEVIATION_M_SHIFT)),
323 ((CHANBW_E << RF_MDMCFG4_CHANBW_E_SHIFT) |
324 (CHANBW_M_96 << RF_MDMCFG4_CHANBW_M_SHIFT) |
325 (DRATE_E_96 << RF_MDMCFG4_DRATE_E_SHIFT)),
326 ((DEVIATION_E_96 << RF_DEVIATN_DEVIATION_E_SHIFT) |
327 (DEVIATION_M_96 << RF_DEVIATN_DEVIATION_M_SHIFT)),
331 ((CHANBW_E << RF_MDMCFG4_CHANBW_E_SHIFT) |
332 (CHANBW_M_24 << RF_MDMCFG4_CHANBW_M_SHIFT) |
333 (DRATE_E_24 << RF_MDMCFG4_DRATE_E_SHIFT)),
334 ((DEVIATION_E_24 << RF_DEVIATN_DEVIATION_E_SHIFT) |
335 (DEVIATION_M_24 << RF_DEVIATN_DEVIATION_M_SHIFT)),
340 __xdata uint8_t ao_radio_dma;
341 __xdata uint8_t ao_radio_dma_done;
342 __xdata uint8_t ao_radio_done;
343 __xdata uint8_t ao_radio_abort;
344 __xdata uint8_t ao_radio_mutex;
346 #if PACKET_HAS_MASTER || HAS_AES
347 #define NEED_RADIO_RSSI 1
350 #ifndef NEED_RADIO_RSSI
351 #define NEED_RADIO_RSSI 0
355 __xdata int8_t ao_radio_rssi;
359 ao_radio_general_isr(void) __interrupt 16
362 if (RFIF & RFIF_IM_TIMEOUT) {
363 ao_radio_recv_abort();
364 RFIF &= ~ RFIF_IM_TIMEOUT;
365 } else if (RFIF & RFIF_IM_DONE) {
367 ao_wakeup(&ao_radio_done);
368 RFIF &= ~RFIF_IM_DONE;
373 ao_radio_set_packet(void)
376 for (i = 0; i < sizeof (fixed_pkt_setup); i += 2)
377 RF[fixed_pkt_setup[i]] = fixed_pkt_setup[i+1];
383 if (RF_MARCSTATE != RF_MARCSTATE_IDLE)
388 } while (RF_MARCSTATE != RF_MARCSTATE_IDLE);
392 #define ao_radio_put() ao_mutex_put(&ao_radio_mutex)
395 ao_radio_get(uint8_t len)
398 ao_mutex_get(&ao_radio_mutex);
401 RF_FREQ2 = (uint8_t) (ao_config.radio_setting >> 16);
402 RF_FREQ1 = (uint8_t) (ao_config.radio_setting >> 8);
403 RF_FREQ0 = (uint8_t) (ao_config.radio_setting);
406 RF_MDMCFG4 = packet_rate_setup[ao_config.radio_rate].mdmcfg4;
407 RF_DEVIATN = packet_rate_setup[ao_config.radio_rate].deviatn;
413 ao_radio_send(__xdata void *packet, uint8_t size) __reentrant
417 ao_dma_set_transfer(ao_radio_dma,
421 DMA_CFG0_WORDSIZE_8 |
422 DMA_CFG0_TMODE_SINGLE |
423 DMA_CFG0_TRIGGER_RADIO,
426 DMA_CFG1_PRIORITY_HIGH);
427 ao_dma_start(ao_radio_dma);
429 __critical while (!ao_radio_done)
430 ao_sleep(&ao_radio_done);
435 ao_radio_recv(__xdata void *packet, uint8_t size, uint8_t timeout) __reentrant
438 ao_radio_get(size - 2);
439 ao_dma_set_transfer(ao_radio_dma,
443 DMA_CFG0_WORDSIZE_8 |
444 DMA_CFG0_TMODE_SINGLE |
445 DMA_CFG0_TRIGGER_RADIO,
448 DMA_CFG1_PRIORITY_HIGH);
449 ao_dma_start(ao_radio_dma);
452 /* Wait for DMA to be done, for the radio receive process to
453 * get aborted or for a receive timeout to fire
455 __critical while (!ao_radio_dma_done && !ao_radio_abort)
456 if (ao_sleep_for(&ao_radio_dma_done, timeout))
459 /* If recv was aborted, clean up by stopping the DMA engine
460 * and idling the radio
462 if (!ao_radio_dma_done) {
463 ao_dma_abort(ao_radio_dma);
471 ao_radio_rssi = AO_RSSI_FROM_RADIO(((uint8_t *)packet)[size - 2]);
474 return ao_radio_dma_done;
478 * Wake up a task waiting to receive a radio packet
479 * and tell them to abort the transfer
483 ao_radio_recv_abort(void)
486 ao_wakeup(&ao_radio_dma_done);
489 __code ao_radio_rdf_value = 0x55;
492 ao_radio_rdf_start(void)
496 ao_radio_get(AO_RADIO_RDF_LEN);
498 for (i = 0; i < sizeof (rdf_setup); i += 2)
499 RF[rdf_setup[i]] = rdf_setup[i+1];
503 ao_radio_rdf_run(void)
505 ao_dma_start(ao_radio_dma);
507 __critical while (!ao_radio_done && !ao_radio_abort)
508 ao_sleep(&ao_radio_done);
509 if (!ao_radio_done) {
510 ao_dma_abort(ao_radio_dma);
513 ao_radio_set_packet();
520 ao_radio_rdf_start();
522 ao_dma_set_transfer(ao_radio_dma,
523 CODE_TO_XDATA(&ao_radio_rdf_value),
526 DMA_CFG0_WORDSIZE_8 |
527 DMA_CFG0_TMODE_SINGLE |
528 DMA_CFG0_TRIGGER_RADIO,
531 DMA_CFG1_PRIORITY_HIGH);
538 #define CONT_PAUSE_8 PA, PA, PA, PA, PA, PA, PA, PA
539 #define CONT_PAUSE_16 CONT_PAUSE_8, CONT_PAUSE_8
540 #define CONT_PAUSE_24 CONT_PAUSE_16, CONT_PAUSE_8
542 #define CONT_BEEP_8 BE, BE, BE, BE, BE, BE, BE, BE
544 #if AO_RADIO_CONT_PAUSE_LEN == 24
545 #define CONT_PAUSE CONT_PAUSE_24
548 #if AO_RADIO_CONT_TONE_LEN == 8
549 #define CONT_BEEP CONT_BEEP_8
550 #define CONT_PAUSE_SHORT CONT_PAUSE_8
553 #define CONT_ADDR(c) CODE_TO_XDATA(&ao_radio_cont[(3-(c)) * (AO_RADIO_CONT_PAUSE_LEN + AO_RADIO_CONT_TONE_LEN)])
555 __code uint8_t ao_radio_cont[] = {
556 CONT_PAUSE, CONT_BEEP,
557 CONT_PAUSE, CONT_BEEP,
558 CONT_PAUSE, CONT_BEEP,
559 CONT_PAUSE, CONT_PAUSE_SHORT,
560 CONT_PAUSE, CONT_PAUSE_SHORT,
565 ao_radio_continuity(uint8_t c)
567 ao_radio_rdf_start();
568 ao_dma_set_transfer(ao_radio_dma,
571 AO_RADIO_CONT_TOTAL_LEN,
572 DMA_CFG0_WORDSIZE_8 |
573 DMA_CFG0_TMODE_SINGLE |
574 DMA_CFG0_TRIGGER_RADIO,
577 DMA_CFG1_PRIORITY_HIGH);
582 ao_radio_rdf_abort(void)
585 ao_wakeup(&ao_radio_done);
591 static __xdata radio_test_on;
594 ao_radio_test(uint8_t on)
597 if (!radio_test_on) {
599 ao_monitor_disable();
602 ao_packet_slave_stop();
627 ao_radio_test_cmd(void)
630 static __xdata radio_on;
632 if (ao_cmd_lex_c != '\n') {
634 mode = (uint8_t) ao_cmd_lex_u32;
640 printf ("Hit a character to stop..."); flush();
648 #if AO_RADIO_REG_TEST
650 ao_radio_set_reg(void)
654 offset = ao_cmd_lex_i;
655 if (ao_cmd_status != ao_cmd_success)
658 printf("RF[%x] %x", offset, RF[offset]);
659 if (ao_cmd_status == ao_cmd_success) {
660 RF[offset] = ao_cmd_lex_i;
661 printf (" -> %x", RF[offset]);
663 ao_cmd_status = ao_cmd_success;
668 __code struct ao_cmds ao_radio_cmds[] = {
669 { ao_radio_test_cmd, "C <1 start, 0 stop, none both>\0Radio carrier test" },
670 #if AO_RADIO_REG_TEST
671 { ao_radio_set_reg, "V <offset> <value>\0Set radio register" },
680 for (i = 0; i < sizeof (radio_setup); i += 2)
681 RF[radio_setup[i]] = radio_setup[i+1];
682 ao_radio_set_packet();
683 ao_radio_dma_done = 1;
684 ao_radio_dma = ao_dma_alloc(&ao_radio_dma_done);
686 RFIM = RFIM_IM_TIMEOUT|RFIM_IM_DONE;
688 ao_cmd_register(&ao_radio_cmds[0]);