A Rusty interface for the RN2903 LoRa module's serial protocol
You can not select more than 25 topics Topics must start with a letter or number, can include dashes ('-') and can be up to 35 characters long.
Leonora Tindall aa6d70b3a2
Add example for packet sending support
3 weken geleden
docu Add documentation PDFs 8 maanden geleden
examples Add example for packet sending support 3 weken geleden
src add packet sending support 4 maanden geleden
.gitignore Basic SerialPort wrapper 8 maanden geleden
CHANGELOG.md This is 0.2 🎉 8 maanden geleden
CONTRIBUTING.md Formalize release process 8 maanden geleden
Cargo.lock add packet sending support 4 maanden geleden
Cargo.toml add packet sending support 4 maanden geleden
LICENSE.html Add GNU GPL v3 license, and package metadata 8 maanden geleden
README.md Add LoRa and FSK packet reception 8 maanden geleden

README.md

RN2903

A Rusty interface for the RN2903 LoRa module's serial protocol

The RN2903 is a LoRa and FSK transciever for the 915MHz ISM band, commonly used in USB devices like the LoStik.

This crate provides a safe, idiomatic interface using cross-platform native serial functionality via serialport. This supports, for instance, a LoStik connected to a USB TTY or virtual COM port, or a RN2903 connected via a TTL serial interface.

This crate is available under the GNU General Public License, version 3.0 only, and does not directly depend on unstable crates.

Example

For instance, here is a simple program which dumps all LoRa packets received.

use rn2903::{Rn2903, ModulationMode};

fn main() {
    let mut txvr = Rn2903::new_at("/dev/ttyUSB0")
        .expect("Could not open device. Error");
    txvr.mac_pause().unwrap();
    txvr.radio_set_modulation_mode(ModulationMode::LoRa).unwrap();
    loop {
        if let Some(packet) = txvr.radio_rx(65535).unwrap() {
            println!("{:?}", packet);
        }
    }
}

Module Documentation

This repository reproduces the relevant documents for the RN2903 module at command_reference-40001811B.pdf and datasheet-DS5000239H.pdf.