/
RF12.h
173 lines (136 loc) · 6.77 KB
/
RF12.h
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
// 2009-02-09 <jc@wippler.nl> http://opensource.org/licenses/mit-license.php
#ifndef RF12_h
#define RF12_h
/// @file
/// RFM12B driver definitions
// Modify the RF12 driver in such a way that it can inter-operate with RFM69
// modules running in "native" mode. This affects packet layout and some more.
#define RF12_COMPAT 0
#include <stdint.h>
/// RFM12B Protocol version.
/// Version 1 did not include the group code in the crc.
/// Version 2 does include the group code in the crc.
#define RF12_VERSION 2
/// Shorthand for RFM12B group byte in rf12_buf.
#define rf12_grp rf12_buf[0]
#if RF12_COMPAT
#define rf12_len (rf12_buf[1] - 2)
#define rf12_dst rf12_buf[2] // parity bits and dest addr
#define rf12_hdr rf12_buf[3] // flag bits and origin addr
#define rf12_data (rf12_buf + 4)
#define RF12_HDR_CTL 0x80
#define RF12_HDR_DST 0 // never set in native RF69 packets
#define RF12_HDR_ACK 0x40
#define RF12_HDR_MASK 0x3F
#else
/// Shorthand for RFM12B header byte in rf12_buf.
#define rf12_hdr rf12_buf[1]
/// Shorthand for RFM12B length byte in rf12_buf.
#define rf12_len rf12_buf[2]
/// Shorthand for first RFM12B data byte in rf12_buf.
#define rf12_data (rf12_buf + 3)
/// RFM12B CTL bit mask.
#define RF12_HDR_CTL 0x80
/// RFM12B DST bit mask.
#define RF12_HDR_DST 0x40
/// RFM12B ACK bit mask.
#define RF12_HDR_ACK 0x20
/// RFM12B HDR bit mask.
#define RF12_HDR_MASK 0x1F
#endif
/// RFM12B Maximum message size in bytes.
#define RF12_MAXDATA 66
#define RF12_433MHZ 1 ///< RFM12B 433 MHz frequency band.
#define RF12_868MHZ 2 ///< RFM12B 868 MHz frequency band.
#define RF12_915MHZ 3 ///< RFM12B 915 MHz frequency band.
// EEPROM address range used by the rf12_config() code
#define RF12_EEPROM_ADDR ((uint8_t*) 0x20) ///< Starting offset.
#define RF12_EEPROM_SIZE 16 ///< Number of bytes.
#define RF12_EEPROM_EKEY ((uint8_t*) 0x40) ///< EE start, same as before.
#define RF12_EEPROM_ELEN 16 ///< EE number of bytes.
#define RF12_EEPROM_VERSION 1 ///< Only this version is valid.
/// Shorthand to simplify detecting a request for an ACK.
#define RF12_WANTS_ACK ((rf12_hdr & RF12_HDR_ACK) && !(rf12_hdr & RF12_HDR_CTL))
/// Shorthand to simplify sending out the proper ACK reply.
#define RF12_ACK_REPLY (rf12_hdr & RF12_HDR_DST ? RF12_HDR_CTL : \
RF12_HDR_CTL | RF12_HDR_DST | (rf12_hdr & RF12_HDR_MASK))
// options for RF12_sleep()
#define RF12_SLEEP 0 ///< Enter sleep mode.
#define RF12_WAKEUP -1 ///< Wake up from sleep mode.
/// Running crc value, should be zero at end.
extern volatile uint16_t rf12_crc;
/// Recv/xmit buf including hdr & crc bytes.
extern volatile uint8_t rf12_buf[];
/// Seq number of encrypted packet (or -1).
extern long rf12_seq;
/// Option to set RFM12 CS (or SS) pin for use on different hardware setups.
/// Set to Dig10 by default for JeeNode. Can be Dig10, Dig9 or Dig8
void rf12_set_cs(uint8_t pin);
/// Only needed if you want to init the SPI bus before rf12_initialize() does.
void rf12_spiInit(void);
/// Call this once with the node ID, frequency band, and optional group.
uint8_t rf12_initialize(uint8_t id, uint8_t band, uint8_t group=0xD4, uint16_t frequency=1600);
/// Initialize the RFM12B module from settings stored in EEPROM by "RF12demo"
/// don't call rf12_initialize() if you init the hardware with rf12_config().
/// @return the node ID as 1..31, or 0 if there is no config on EEPROM.
uint8_t rf12_configSilent();
/// Call this to send a description of the EEPROM settings to the serial port.
void rf12_configDump();
/// @deprecated Please switch over to rf12_configSilent() and rf12_configDump().
uint8_t rf12_config(uint8_t show =1);
/// Call this frequently, returns true if a packet has been received.
uint8_t rf12_recvDone(void);
/// Call this to check whether a new transmission can be started.
/// @return true when a new transmission may be started with rf12_sendStart().
uint8_t rf12_canSend(void);
/// Call this only when rf12_recvDone() or rf12_canSend() return true.
void rf12_sendStart(uint8_t hdr);
/// Call this only when rf12_recvDone() or rf12_canSend() return true.
void rf12_sendStart(uint8_t hdr, const void* ptr, uint8_t len);
/// This variant loops on rf12_canSend() and then calls rf12_sendStart() asap.
void rf12_sendNow(uint8_t hdr, const void* ptr, uint8_t len);
/// Wait for send to finish.
/// @param mode sleep mode 0=none, 1=idle, 2=standby, 3=powerdown.
void rf12_sendWait(uint8_t mode);
/// This simulates OOK by turning the transmitter on and off via SPI commands.
/// Use this only when the radio was initialized with a fake zero node ID.
void rf12_onOff(uint8_t value);
/// Power off the RFM12B, ms > 0 sets watchdog to wake up again after N * 32 ms.
/// @note if off, calling this with -1 can be used to bring the RFM12B back up.
void rf12_sleep(char n);
/// Return true if the supply voltage is below 3.1V.
char rf12_lowbat(void);
/// Set up the easy tranmission mode, arg is number of seconds between packets.
void rf12_easyInit(uint8_t secs);
/// Call this often to keep the easy transmission mode going.
char rf12_easyPoll(void);
/// Send new data using easy transmission mode, buffer gets copied to driver.
char rf12_easySend(const void* data, uint8_t size);
/// Enable encryption (null arg disables it again).
void rf12_encrypt(const uint8_t*);
/// Enable raw receive mode with fixed packet length.
void rf12_setRawRecvMode(uint8_t fixed_pkt_len);
/// Low-level control of the RFM12B via direct register access.
/// http://tools.jeelabs.org/rfm12b is useful for calculating these.
uint16_t rf12_control(uint16_t cmd);
/// See http://blog.strobotics.com.au/2009/07/27/rfm12-tutorial-part-3a/
/// Transmissions are packetized, don't assume you can sustain these speeds!
///
/// @note Data rates are approximate. For higher data rates you may need to
/// alter receiver radio bandwidth and transmitter modulator bandwidth.
/// Note that bit 7 is a prescaler - don't just interpolate rates between
/// RF12_DATA_RATE_3 and RF12_DATA_RATE_2.
enum rf12DataRates {
RF12_DATA_RATE_CMD = 0xC600,
RF12_DATA_RATE_9 = RF12_DATA_RATE_CMD | 0x02, // Approx 115200 bps
RF12_DATA_RATE_8 = RF12_DATA_RATE_CMD | 0x05, // Approx 57600 bps
RF12_DATA_RATE_7 = RF12_DATA_RATE_CMD | 0x06, // Approx 49200 bps
RF12_DATA_RATE_6 = RF12_DATA_RATE_CMD | 0x08, // Approx 38400 bps
RF12_DATA_RATE_5 = RF12_DATA_RATE_CMD | 0x11, // Approx 19200 bps
RF12_DATA_RATE_4 = RF12_DATA_RATE_CMD | 0x23, // Approx 9600 bps
RF12_DATA_RATE_3 = RF12_DATA_RATE_CMD | 0x47, // Approx 4800 bps
RF12_DATA_RATE_2 = RF12_DATA_RATE_CMD | 0x91, // Approx 2400 bps
RF12_DATA_RATE_1 = RF12_DATA_RATE_CMD | 0x9E, // Approx 1200 bps
RF12_DATA_RATE_DEFAULT = RF12_DATA_RATE_7,
};
#endif