[−][src]Crate drogue_rak811
A network driver for a RAK811 attached via a UART.
Currently requires the RAK811 to be flashed with a 2.x version of the AT firmware.
At first, the UART must be configured and handed to the driver. The uart must implement the embedded_hal::serial traits.
Usage
let (uarte_tx, uarte_rx) = uarte .split(ctx.resources.tx_buf, ctx.resources.rx_buf) .unwrap(); let driver = rak811::Rak811Driver::new( uarte_tx, uarte_rx, port1.p1_02.into_push_pull_output(Level::High).degrade(), ) .unwrap();
In order to connect to the gateway, the LoRa node needs to be configured with the following:
- Frequency band - This depends on where you live.
- Mode of operation - This can either be LoRa P2P which allows the node to send and receive data directly from another LoRa node, or LoRaWAN which connects the node to a gateway.
The driver can be used to configure the properties in this way:
driver.set_band(rak811::LoraRegion::EU868).unwrap(); driver.set_mode(rak811::LoraMode::WAN).unwrap();
In addition, the following settings from the TTN console must be set:
- Device EUI
- Application EUI
- Application Key
driver.set_device_eui(&[0x00, 0xBB, 0x7C, 0x95, 0xAD, 0xB5, 0x30, 0xB9]).unwrap(); driver.set_app_eui(&[0x70, 0xB3, 0xD5, 0x7E, 0xD0, 0x03, 0xB1, 0x84]) // Secret generated by network provider driver .set_app_key(&[0x00]).unwrap();
To join the network and send packets:
driver.join(rak811::ConnectMode::OTAA).unwrap(); // Port number can be between 1 and 255 driver.send(rak811::QoS::Confirmed, 1, b"hello!").unwrap();
Structs
| FirmwareInfo | Version information for the RAK811 board |
| Rak811Driver |
Enums
| Command | |
| ConfigKey | |
| ConfigOption | |
| ConnectMode | |
| DriverError | |
| EventCode | |
| LoraMode | |
| LoraRegion | |
| QoS | |
| ResetMode | |
| Response |
Type Definitions
| AppKey | |
| AppsKey | |
| CommandBuffer | |
| DevAddr | |
| EUI | |
| NwksKey | |
| Port |