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; version 2 of the License.
8 * This program is distributed in the hope that it will be useful, but
9 * WITHOUT ANY WARRANTY; without even the implied warranty of
10 * MERCHANTABILITY or FITNESS FOR A PARTICULAR PURPOSE. See the GNU
11 * General Public License for more details.
13 * You should have received a copy of the GNU General Public License along
14 * with this program; if not, write to the Free Software Foundation, Inc.,
15 * 59 Temple Place, Suite 330, Boston, MA 02111-1307 USA.
23 /* Values from SmartRF® Studio for:
25 * Deviation: 20.507812 kHz
26 * Datarate: 38.360596 kBaud
28 * RF Freq: 434.549927 MHz
29 * Channel: 99.975586 kHz
31 * RX filter: 93.75 kHz
35 * For IF freq of 140.62kHz, the IF value is:
37 * 140.62e3 / (24e6 / 2**10) = 6
40 #define IF_FREQ_CONTROL 6
43 * http://www.ntia.doc.gov/files/ntia/publications/84-168.pdf
45 * Necessary bandwidth for a FSK modulated signal:
47 * bw = 2.6d + 0.55b 1.5 < m < 5.5
48 * bw = 2.1d + 1.9b 5.5 < m < 20
50 * b is the modulation rate in bps
51 * d is the peak deviation (from the center)
55 * 20.5 kHz deviation 38.4kbps signal:
57 * m = 41 / 38.4, which is < 5.5:
59 * bw = 2.6 * 20.5 + 0.55 * 38.4 = 74.42kHz
61 * M = 1, E = 3, bw = 75kHz
63 * 20.5 kHz deviation, 9.6kbps signal
65 * m = 41 / 9.6, which is < 5.5:
67 * bw = 2.6 * 20.5 + 0.55 * 9.6 = 58.58kHz
69 * M = 2, E = 3, bw = 62.5kHz
71 * 20.5kHz deviation, 2.4kbps signal
73 * m = 41 / 2.4, which is > 5.5:
75 * bw = 2.1 * 20.5 + 1.9 * 2.4 = 47.61kHz
77 * M = 3, E = 3, bw = 53.6kHz
79 * For channel bandwidth of 93.75 kHz, the CHANBW_E and CHANBW_M values are
81 * BW = 24e6 / (8 * (4 + M) * 2 ** E)
86 #define CHANBW_M_384 1
92 * For a symbol rate of 38360kBaud, the DRATE_E and DRATE_M values are:
94 * R = (256 + M) * 2** E * 24e6 / 2**28
96 * So for 38360kBaud, M is 163 and E is 10
101 #define DRATE_E_384 10
103 /* For 9600 baud, M is 163 and E is 8
108 /* For 2400 baud, M is 163 and E is 6
114 * For a channel deviation of 20.5kHz, the DEVIATION_E and DEVIATION_M values are:
116 * F = 24e6/2**17 * (8 + DEVIATION_M) * 2**DEVIATION_E
118 * So M is 6 and E is 3
121 #define DEVIATION_M 6
122 #define DEVIATION_E 3
125 * For our RDF beacon, set the symbol rate to 2kBaud (for a 1kHz tone),
126 * so the DRATE_E and DRATE_M values are:
130 * To make the tone last for 200ms, we need 2000 * .2 = 400 bits or 50 bytes
133 #define RDF_DRATE_E 6
134 #define RDF_DRATE_M 94
135 #define RDF_PACKET_LEN 50
138 * RDF deviation should match the normal NFM value of 5kHz
144 #define RDF_DEVIATION_M 6
145 #define RDF_DEVIATION_E 1
147 /* This are from the table for 433MHz */
149 #define RF_POWER_M30_DBM 0x12
150 #define RF_POWER_M20_DBM 0x0e
151 #define RF_POWER_M15_DBM 0x1d
152 #define RF_POWER_M10_DBM 0x34
153 #define RF_POWER_M5_DBM 0x2c
154 #define RF_POWER_0_DBM 0x60
155 #define RF_POWER_5_DBM 0x84
156 #define RF_POWER_7_DBM 0xc8
157 #define RF_POWER_10_DBM 0xc0
159 #define RF_POWER RF_POWER_10_DBM
161 static __code uint8_t radio_setup[] = {
162 RF_PA_TABLE7_OFF, RF_POWER,
163 RF_PA_TABLE6_OFF, RF_POWER,
164 RF_PA_TABLE5_OFF, RF_POWER,
165 RF_PA_TABLE4_OFF, RF_POWER,
166 RF_PA_TABLE3_OFF, RF_POWER,
167 RF_PA_TABLE2_OFF, RF_POWER,
168 RF_PA_TABLE1_OFF, RF_POWER,
169 RF_PA_TABLE0_OFF, RF_POWER,
171 RF_FSCTRL1_OFF, (IF_FREQ_CONTROL << RF_FSCTRL1_FREQ_IF_SHIFT),
172 RF_FSCTRL0_OFF, (0 << RF_FSCTRL0_FREQOFF_SHIFT),
174 RF_MDMCFG3_OFF, (DRATE_M << RF_MDMCFG3_DRATE_M_SHIFT),
175 RF_MDMCFG2_OFF, (RF_MDMCFG2_DEM_DCFILT_ON |
176 RF_MDMCFG2_MOD_FORMAT_GFSK |
177 RF_MDMCFG2_SYNC_MODE_15_16),
178 RF_MDMCFG1_OFF, (RF_MDMCFG1_FEC_EN |
179 RF_MDMCFG1_NUM_PREAMBLE_4 |
180 (2 << RF_MDMCFG1_CHANSPC_E_SHIFT)),
181 RF_MDMCFG0_OFF, (17 << RF_MDMCFG0_CHANSPC_M_SHIFT),
185 RF_DEVIATN_OFF, ((DEVIATION_E << RF_DEVIATN_DEVIATION_E_SHIFT) |
186 (DEVIATION_M << RF_DEVIATN_DEVIATION_M_SHIFT)),
188 /* SmartRF says set LODIV_BUF_CURRENT_TX to 0
189 * And, we're not using power ramping, so use PA_POWER 0
191 RF_FREND0_OFF, ((1 << RF_FREND0_LODIV_BUF_CURRENT_TX_SHIFT) |
192 (0 << RF_FREND0_PA_POWER_SHIFT)),
194 RF_FREND1_OFF, ((1 << RF_FREND1_LNA_CURRENT_SHIFT) |
195 (1 << RF_FREND1_LNA2MIX_CURRENT_SHIFT) |
196 (1 << RF_FREND1_LODIV_BUF_CURRENT_RX_SHIFT) |
197 (2 << RF_FREND1_MIX_CURRENT_SHIFT)),
204 RF_TEST2_OFF, RF_TEST2_RX_LOW_DATA_RATE_MAGIC,
205 RF_TEST1_OFF, RF_TEST1_RX_LOW_DATA_RATE_MAGIC,
208 /* default sync values */
212 /* max packet length */
213 RF_PKTCTRL1_OFF, ((1 << PKTCTRL1_PQT_SHIFT)|
214 PKTCTRL1_APPEND_STATUS|
215 PKTCTRL1_ADR_CHK_NONE),
216 RF_PKTCTRL0_OFF, (RF_PKTCTRL0_WHITE_DATA|
217 RF_PKTCTRL0_PKT_FORMAT_NORMAL|
219 RF_PKTCTRL0_LENGTH_CONFIG_FIXED),
221 RF_MCSM2_OFF, (RF_MCSM2_RX_TIME_END_OF_PACKET),
222 RF_MCSM1_OFF, (RF_MCSM1_CCA_MODE_RSSI_BELOW_UNLESS_RECEIVING|
223 RF_MCSM1_RXOFF_MODE_IDLE|
224 RF_MCSM1_TXOFF_MODE_IDLE),
225 RF_MCSM0_OFF, (RF_MCSM0_FS_AUTOCAL_FROM_IDLE|
227 RF_MCSM0_CLOSE_IN_RX_0DB),
228 RF_FOCCFG_OFF, (RF_FOCCFG_FOC_PRE_K_3K,
229 RF_FOCCFG_FOC_POST_K_PRE_K,
230 RF_FOCCFG_FOC_LIMIT_BW_OVER_4),
231 RF_BSCFG_OFF, (RF_BSCFG_BS_PRE_K_2K|
232 RF_BSCFG_BS_PRE_KP_3KP|
233 RF_BSCFG_BS_POST_KI_PRE_KI|
234 RF_BSCFG_BS_POST_KP_PRE_KP|
235 RF_BSCFG_BS_LIMIT_0),
236 RF_AGCCTRL2_OFF, (RF_AGCCTRL2_MAX_DVGA_GAIN_ALL|
237 RF_AGCCTRL2_MAX_LNA_GAIN_0|
238 RF_AGCCTRL2_MAGN_TARGET_33dB),
239 RF_AGCCTRL1_OFF, (RF_AGCCTRL1_AGC_LNA_PRIORITY_0 |
240 RF_AGCCTRL1_CARRIER_SENSE_REL_THR_DISABLE |
241 RF_AGCCTRL1_CARRIER_SENSE_ABS_THR_0DB),
242 RF_AGCCTRL0_OFF, (RF_AGCCTRL0_HYST_LEVEL_NONE |
243 RF_AGCCTRL0_WAIT_TIME_8 |
244 RF_AGCCTRL0_AGC_FREEZE_NORMAL |
245 RF_AGCCTRL0_FILTER_LENGTH_8),
251 static __code uint8_t rdf_setup[] = {
252 RF_MDMCFG4_OFF, ((CHANBW_E << RF_MDMCFG4_CHANBW_E_SHIFT) |
253 (CHANBW_M_384 << RF_MDMCFG4_CHANBW_M_SHIFT) |
254 (RDF_DRATE_E << RF_MDMCFG4_DRATE_E_SHIFT)),
255 RF_MDMCFG3_OFF, (RDF_DRATE_M << RF_MDMCFG3_DRATE_M_SHIFT),
256 RF_MDMCFG2_OFF, (RF_MDMCFG2_DEM_DCFILT_OFF |
257 RF_MDMCFG2_MOD_FORMAT_GFSK |
258 RF_MDMCFG2_SYNC_MODE_NONE),
259 RF_MDMCFG1_OFF, (RF_MDMCFG1_FEC_DIS |
260 RF_MDMCFG1_NUM_PREAMBLE_2 |
261 (2 << RF_MDMCFG1_CHANSPC_E_SHIFT)),
263 RF_DEVIATN_OFF, ((RDF_DEVIATION_E << RF_DEVIATN_DEVIATION_E_SHIFT) |
264 (RDF_DEVIATION_M << RF_DEVIATN_DEVIATION_M_SHIFT)),
266 /* packet length is set in-line */
267 RF_PKTCTRL1_OFF, ((0 << PKTCTRL1_PQT_SHIFT)|
268 PKTCTRL1_ADR_CHK_NONE),
269 RF_PKTCTRL0_OFF, (RF_PKTCTRL0_PKT_FORMAT_NORMAL|
270 RF_PKTCTRL0_LENGTH_CONFIG_FIXED),
273 static __code uint8_t fixed_pkt_setup[] = {
275 RF_MDMCFG4_OFF, ((CHANBW_E << RF_MDMCFG4_CHANBW_E_SHIFT) |
276 (CHANBW_M_384 << RF_MDMCFG4_CHANBW_M_SHIFT) |
277 (DRATE_E_384 << RF_MDMCFG4_DRATE_E_SHIFT)),
279 RF_MDMCFG3_OFF, (DRATE_M << RF_MDMCFG3_DRATE_M_SHIFT),
280 RF_MDMCFG2_OFF, (RF_MDMCFG2_DEM_DCFILT_ON |
281 RF_MDMCFG2_MOD_FORMAT_GFSK |
282 RF_MDMCFG2_SYNC_MODE_15_16),
283 RF_MDMCFG1_OFF, (RF_MDMCFG1_FEC_EN |
284 RF_MDMCFG1_NUM_PREAMBLE_4 |
285 (2 << RF_MDMCFG1_CHANSPC_E_SHIFT)),
287 RF_DEVIATN_OFF, ((DEVIATION_E << RF_DEVIATN_DEVIATION_E_SHIFT) |
288 (DEVIATION_M << RF_DEVIATN_DEVIATION_M_SHIFT)),
290 /* max packet length -- now set inline */
291 RF_PKTCTRL1_OFF, ((1 << PKTCTRL1_PQT_SHIFT)|
292 PKTCTRL1_APPEND_STATUS|
293 PKTCTRL1_ADR_CHK_NONE),
294 RF_PKTCTRL0_OFF, (RF_PKTCTRL0_WHITE_DATA|
295 RF_PKTCTRL0_PKT_FORMAT_NORMAL|
297 RF_PKTCTRL0_LENGTH_CONFIG_FIXED),
301 static __code uint8_t packet_rate_setup[] = {
303 ((CHANBW_E << RF_MDMCFG4_CHANBW_E_SHIFT) |
304 (CHANBW_M_384 << RF_MDMCFG4_CHANBW_M_SHIFT) |
305 (DRATE_E_384 << RF_MDMCFG4_DRATE_E_SHIFT)),
307 ((CHANBW_E << RF_MDMCFG4_CHANBW_E_SHIFT) |
308 (CHANBW_M_96 << RF_MDMCFG4_CHANBW_M_SHIFT) |
309 (DRATE_E_96 << RF_MDMCFG4_DRATE_E_SHIFT)),
311 ((CHANBW_E << RF_MDMCFG4_CHANBW_E_SHIFT) |
312 (CHANBW_M_24 << RF_MDMCFG4_CHANBW_M_SHIFT) |
313 (DRATE_E_24 << RF_MDMCFG4_DRATE_E_SHIFT)),
317 __xdata uint8_t ao_radio_dma;
318 __xdata uint8_t ao_radio_dma_done;
319 __xdata uint8_t ao_radio_done;
320 __xdata uint8_t ao_radio_abort;
321 __xdata uint8_t ao_radio_mutex;
323 #if PACKET_HAS_MASTER || HAS_AES
324 #define NEED_RADIO_RSSI 1
327 #ifndef NEED_RADIO_RSSI
328 #define NEED_RADIO_RSSI 0
332 __xdata int8_t ao_radio_rssi;
336 ao_radio_general_isr(void) __interrupt 16
339 if (RFIF & RFIF_IM_TIMEOUT) {
340 ao_radio_recv_abort();
341 RFIF &= ~ RFIF_IM_TIMEOUT;
342 } else if (RFIF & RFIF_IM_DONE) {
344 ao_wakeup(&ao_radio_done);
345 RFIF &= ~RFIF_IM_DONE;
350 ao_radio_set_packet(void)
353 for (i = 0; i < sizeof (fixed_pkt_setup); i += 2)
354 RF[fixed_pkt_setup[i]] = fixed_pkt_setup[i+1];
360 if (RF_MARCSTATE != RF_MARCSTATE_IDLE)
365 } while (RF_MARCSTATE != RF_MARCSTATE_IDLE);
369 #define ao_radio_put() ao_mutex_put(&ao_radio_mutex)
372 ao_radio_get(uint8_t len)
375 ao_mutex_get(&ao_radio_mutex);
378 RF_FREQ2 = (uint8_t) (ao_config.radio_setting >> 16);
379 RF_FREQ1 = (uint8_t) (ao_config.radio_setting >> 8);
380 RF_FREQ0 = (uint8_t) (ao_config.radio_setting);
383 RF_MDMCFG4 = packet_rate_setup[ao_config.radio_rate];
389 ao_radio_send(__xdata void *packet, uint8_t size) __reentrant
393 ao_dma_set_transfer(ao_radio_dma,
397 DMA_CFG0_WORDSIZE_8 |
398 DMA_CFG0_TMODE_SINGLE |
399 DMA_CFG0_TRIGGER_RADIO,
402 DMA_CFG1_PRIORITY_HIGH);
403 ao_dma_start(ao_radio_dma);
405 __critical while (!ao_radio_done)
406 ao_sleep(&ao_radio_done);
411 ao_radio_recv(__xdata void *packet, uint8_t size, uint8_t timeout) __reentrant
414 ao_radio_get(size - 2);
415 ao_dma_set_transfer(ao_radio_dma,
419 DMA_CFG0_WORDSIZE_8 |
420 DMA_CFG0_TMODE_SINGLE |
421 DMA_CFG0_TRIGGER_RADIO,
424 DMA_CFG1_PRIORITY_HIGH);
425 ao_dma_start(ao_radio_dma);
428 /* Wait for DMA to be done, for the radio receive process to
429 * get aborted or for a receive timeout to fire
433 __critical while (!ao_radio_dma_done && !ao_radio_abort)
434 if (ao_sleep(&ao_radio_dma_done))
439 /* If recv was aborted, clean up by stopping the DMA engine
440 * and idling the radio
442 if (!ao_radio_dma_done) {
443 ao_dma_abort(ao_radio_dma);
451 ao_radio_rssi = AO_RSSI_FROM_RADIO(((uint8_t *)packet)[size - 2]);
454 return ao_radio_dma_done;
458 * Wake up a task waiting to receive a radio packet
459 * and tell them to abort the transfer
463 ao_radio_recv_abort(void)
466 ao_wakeup(&ao_radio_dma_done);
469 __code ao_radio_rdf_value = 0x55;
472 ao_radio_rdf_start(void)
476 ao_radio_get(AO_RADIO_RDF_LEN);
478 for (i = 0; i < sizeof (rdf_setup); i += 2)
479 RF[rdf_setup[i]] = rdf_setup[i+1];
483 ao_radio_rdf_run(void)
485 ao_dma_start(ao_radio_dma);
487 __critical while (!ao_radio_done && !ao_radio_abort)
488 ao_sleep(&ao_radio_done);
489 if (!ao_radio_done) {
490 ao_dma_abort(ao_radio_dma);
493 ao_radio_set_packet();
500 ao_radio_rdf_start();
502 ao_dma_set_transfer(ao_radio_dma,
503 CODE_TO_XDATA(&ao_radio_rdf_value),
506 DMA_CFG0_WORDSIZE_8 |
507 DMA_CFG0_TMODE_SINGLE |
508 DMA_CFG0_TRIGGER_RADIO,
511 DMA_CFG1_PRIORITY_HIGH);
518 #define CONT_PAUSE_8 PA, PA, PA, PA, PA, PA, PA, PA
519 #define CONT_PAUSE_16 CONT_PAUSE_8, CONT_PAUSE_8
520 #define CONT_PAUSE_24 CONT_PAUSE_16, CONT_PAUSE_8
522 #define CONT_BEEP_8 BE, BE, BE, BE, BE, BE, BE, BE
524 #if AO_RADIO_CONT_PAUSE_LEN == 24
525 #define CONT_PAUSE CONT_PAUSE_24
528 #if AO_RADIO_CONT_TONE_LEN == 8
529 #define CONT_BEEP CONT_BEEP_8
530 #define CONT_PAUSE_SHORT CONT_PAUSE_8
533 #define CONT_ADDR(c) CODE_TO_XDATA(&ao_radio_cont[(3-(c)) * (AO_RADIO_CONT_PAUSE_LEN + AO_RADIO_CONT_TONE_LEN)])
535 __code uint8_t ao_radio_cont[] = {
536 CONT_PAUSE, CONT_BEEP,
537 CONT_PAUSE, CONT_BEEP,
538 CONT_PAUSE, CONT_BEEP,
539 CONT_PAUSE, CONT_PAUSE_SHORT,
540 CONT_PAUSE, CONT_PAUSE_SHORT,
545 ao_radio_continuity(uint8_t c)
547 ao_radio_rdf_start();
548 ao_dma_set_transfer(ao_radio_dma,
551 AO_RADIO_CONT_TOTAL_LEN,
552 DMA_CFG0_WORDSIZE_8 |
553 DMA_CFG0_TMODE_SINGLE |
554 DMA_CFG0_TRIGGER_RADIO,
557 DMA_CFG1_PRIORITY_HIGH);
562 ao_radio_rdf_abort(void)
565 ao_wakeup(&ao_radio_done);
571 static __xdata ao_radio_test_on;
574 ao_radio_test(uint8_t on)
577 if (!ao_radio_test_on) {
579 ao_monitor_disable();
582 ao_packet_slave_stop();
589 ao_radio_test_on = 1;
592 if (ao_radio_test_on) {
595 ao_radio_test_on = 0;
607 ao_radio_test_cmd(void)
610 static __xdata radio_on;
612 if (ao_cmd_lex_c != '\n') {
614 mode = (uint8_t) ao_cmd_lex_u32;
620 printf ("Hit a character to stop..."); flush();
628 #if AO_RADIO_REG_TEST
630 ao_radio_set_reg(void)
634 offset = ao_cmd_lex_i;
635 if (ao_cmd_status != ao_cmd_success)
638 printf("RF[%x] %x", offset, RF[offset]);
639 if (ao_cmd_status == ao_cmd_success) {
640 RF[offset] = ao_cmd_lex_i;
641 printf (" -> %x", RF[offset]);
643 ao_cmd_status = ao_cmd_success;
648 __code struct ao_cmds ao_radio_cmds[] = {
649 { ao_radio_test_cmd, "C <1 start, 0 stop, none both>\0Radio carrier test" },
650 #if AO_RADIO_REG_TEST
651 { ao_radio_set_reg, "V <offset> <value>\0Set radio register" },
660 for (i = 0; i < sizeof (radio_setup); i += 2)
661 RF[radio_setup[i]] = radio_setup[i+1];
662 ao_radio_set_packet();
663 ao_radio_dma_done = 1;
664 ao_radio_dma = ao_dma_alloc(&ao_radio_dma_done);
666 RFIM = RFIM_IM_TIMEOUT|RFIM_IM_DONE;
668 ao_cmd_register(&ao_radio_cmds[0]);