Crate sx127x_lora

sx127x_lora

The sx127x_lora crate provides an interface to Semtech SX1276/77/78/79 based boards. Due to its dependency on the rppal crate, the library currently only works on Raspberry Pi. It requires that both the SPI and GPIO interfaces are enabled on the Pi. This can accomplished with sudo raspi-config and a reboot. This library is under heavy development is subject to changes

Hookup

Radio ––––> Raspberry Pi

3V ———–> 3V

GND –––––> GND

MOSI ———> MOSI/BCM 10/GPIO 19

MISO ———> MISO/BCM 9/GPIO 21

SCK –––––> SCLK/BCM 11/GPIO 23

RESET ––––> Any Open GPIO

DIO_0 ––––> Any Open GPIO

Examples

Basic send

extern crate sx127x_lora;
const LORA_CS_PIN: u8 = 8;
const DIO_0_PIN: u8 = 20;
const LORA_RESET_PIN: u8 = 21;
const FREQUENCY: i64 = 915;
fn main(){
    let mut lora = sx127x_lora::LoRa::new(LORA_CS_PIN,LORA_RESET_PIN,
                                          DIO_0_PIN,FREQUENCY).unwrap();
    lora.set_tx_power(17,1); //Using PA_BOOST. See your board for correct pin.
    let transmit = lora.transmit_string("Hello World!".to_string());
    match transmit {
        Ok(packet_size) => println!("Sent packet with size: {}", packet_size),
        Err(e) => println!("Error: {}", e),
    }
}

Asynchronous send and receive

Utilizes a Arc<Mutex<sx127x_lora::LoRa>> to allow for an asynchronous interrupt to be handled when a new packet is received. The lazy_static crate is used to create a global static ref. The example is utilizes the rppal crate directly to setup the interrupt pin. This will change in the future. Make sure to add lazy_static = "1.2.0" under [dependencies] in your Cargo.toml.

#[macro_use]
extern crate lazy_static;
extern crate sx127x_lora;

use rppal::gpio::{Level,Trigger};
use std::time::Duration;
use std::{thread};
use std::sync::{Arc, Mutex};

const LORA_CS_PIN: u8 = 8;
const DIO_0_PIN: u8 = 20;
const LORA_RESET_PIN: u8 = 21;
const FREQUENCY: i64 = 915;

lazy_static! {
    static ref LORA: Arc<Mutex<sx127x_lora::LoRa>> = Arc::new(Mutex::new(sx127x_lora::LoRa::
        new(LORA_CS_PIN,LORA_RESET_PIN, DIO_0_PIN,FREQUENCY).unwrap()));
}

fn main() {
    let lora_clone = LORA.clone();
    let mut lora = lora_clone.lock().unwrap();
    lora.set_tx_power(17,1);
    lora.gpio.set_async_interrupt(DIO_0_PIN,Trigger::RisingEdge,handle_new_packet);
    lora.set_mode(sx127x_lora::RadioMode::RxContinuous);
    drop(lora);
    loop{
        let mut lora = lora_clone.lock().unwrap();
        let transmit = lora.transmit_string("Hello world!".to_string());
        match transmit {
            Ok(s) => println!("Sent packet with size: {}", s),
            Err(e) => println!("Error: {}",e),
        }
        lora.set_mode(sx127x_lora::RadioMode::RxContinuous);
        drop(lora);
        thread::sleep(Duration::from_millis(5000));
    }
}

fn handle_new_packet(_level: Level){
    let lora_clone = LORA.clone();
    let mut lora = lora_clone.lock().unwrap();
    println!("New Packet with rssi: {} and SNR: {}",lora.get_packet_rssi(),
    lora.get_packet_snr());
    let buffer = lora.read_packet();
    print!("Payload: ");
    for i in buffer.iter() {
        print!("{}",*i as char);
    }
    println!();
    lora.set_mode(sx127x_lora::RadioMode::RxContinuous);
    drop(lora);
}

Structs

LoRa

Provides high-level access to Semtech SX1276/77/78/79 based boards connected to a Raspberry Pi

Enums

RadioMode

Radio states