rak-rui3-eh-driver

Crates.iorak-rui3-eh-driver
lib.rsrak-rui3-eh-driver
version0.1.0
sourcesrc
created_at2024-08-02 07:14:49.917955
updated_at2024-08-02 07:14:49.917955
descriptionRust embedded-hal driver for the RAK LoRaWAN modules running RUI3 firmware in AT mode
homepagehttps://gitlab.com/scrobotics/embedded-rs/rak-rui3-atat-rs
repository
max_upload_size
id1322894
size32,094
Xabi Crespo (crespum)

documentation

README

AT Driver for the RAK3172 WisDuo LPWAN Module

This respository contains a driver for the RAK3172 module running the RUI3 (RAK Unified Interface V3) firmware in AT mode. The driver is built on top of the atat crate.

The module doesn't really comply with the AT standard. In fact, the behavior of the module doesn't even match the official documentation. The following are the main differences we've found:

  • There's no \r\n marking the beginning of a response
  • It uses test commands (AT+FOO=?) instead of read commands (AT+FOO?)
  • Command parameters are separated by semicolons (:) instead of commas (,)

To overcome the differences we had to build our own digester (i.e. the command parser in the atat world).

TODO

  • Create a serializer similar to serde_at to support the limitations of the AT mode that we mentioned previously.
  • Remove STD dependencies
  • Publish on crates.io

Examples

  • linux-simple: example of interacting with the LoRaWAN module connected through a serial converter to a Linux computer. Requires the converter to be /dev/ttyUSB0.
    cd examples/linux_simple
    cargo run
    

For a more complete example visit Tested with the Dark Sky Meter Firmware.

Commit count: 0

cargo fmt