Interact with RFM69HCW radio modules via spi.
- Packet encryption/decryption
- Send packets
- Receive packets
- Auto Ack packets
- only 915 mhz is currently supported
- AES encryption
- Basic Usage documentation
- RSSI value reading
- Processing packet data outside of the library
- Packet recv/send telemetry (because why not?)
- Unit tests?
Be sure to check your local laws for legal radio bands.
Packets are encoded/decoded with the same format as LowPowerLabs RF69 library version 1.4 (described here). The goal is to have feature parity with the Arduino library.
Currently i've only tested on Raspberry Pi, but it should work on any device that ElixirCircuits supports.
iex()> {:ok, pid} = RF69.start_link [
reset_pin: 16,
ss_pin: 25,
irq_pin: 13,
spi_bus_name: "spidev0.0",
]
{:ok, #PID<0.1660.0>}
iex()> receive do
...()> %RF69.Packet{} = packet ->
...()> IO.inspect(packet, label: "received packet")
...()> :ok
...()> end
packet received: %RF69.Packet{
ack_requested?: true,
is_ack?: false,
payload: "123 ABCDEFGHIJK",
rssi: -42,
sender_id: 2,
target_id: 1
}
:ok
iex()> RF69.send(pid, 2, "hello node 2 from gateway node!")
:ok
iex()>
The API defined is pretty low level. If you want to use it, you should probably
wrap the radio server in your own genserver. See the Logger
Example
for an example.
There is a repo here with some more examples
By default the rf69 server will respond to acks If your implementation requires user acking, when starting
the rf69 server, pass in auto_ack?: false
.
This will require that in your code when you receive a packet, you will be responsible for acking it in
the configured amount of time required by your other nodes. Here's an example:
def handle_info(%Packet{requires_ack?: true} = packet, state) do
# Process the packet (whatever that means to your application)
case process_packet(packet) do
:ok ->
# packet processed successfully.
RF69.ack(state.rf69, packet)
:error ->
# packet processed unsuccessfully.
# The protocol has no concept of "nack"ing, so the lack of
# an ack should be considered a "nack"
Logger.error "Not acking #{inspect(packet)}"
end
{:noreply, state}
end
AES Encryption is handled at the hardware level. All you as a developer need to do is load the encryption key when starting the server.
WARNING: This key must be EXACTLY 16 bytes wide.
{:ok, pid} = RF69.start_link(encrypt_key: "sampleEncryptKey")