LoRa APIs

Data Structures
struct	lora_modem_config
	Structure containing the configuration of a LoRa modem. More...

Enumerations
enum	lora_signal_bandwidth { BW_125_KHZ = 0 , BW_250_KHZ , BW_500_KHZ }
	LoRa signal bandwidth. More...
enum	lora_datarate {   SF_6 = 6 , SF_7 , SF_8 , SF_9 ,   SF_10 , SF_11 , SF_12 }
	LoRa data-rate. More...
enum	lora_coding_rate { CR_4_5 = 1 , CR_4_6 = 2 , CR_4_7 = 3 , CR_4_8 = 4 }
	LoRa coding rate. More...

Functions
static int	lora_config (const struct device *dev, struct lora_modem_config *config)
	Configure the LoRa modem.
static int	lora_send (const struct device *dev, uint8_t *data, uint32_t data_len)
	Send data over LoRa.
static int	lora_send_async (const struct device *dev, uint8_t *data, uint32_t data_len, struct k_poll_signal *async)
	Asynchronously send data over LoRa.
static int	lora_recv (const struct device *dev, uint8_t *data, uint8_t size, k_timeout_t timeout, int16_t *rssi, int8_t *snr)
	Receive data over LoRa.
static int	lora_recv_async (const struct device *dev, lora_recv_cb cb, void *user_data)
	Receive data asynchronously over LoRa.
static int	lora_test_cw (const struct device *dev, uint32_t frequency, int8_t tx_power, uint16_t duration)
	Transmit an unmodulated continuous wave at a given frequency.

Detailed Description

Since

2.2

Version

0.1.0

Enumeration Type Documentation

lora_coding_rate

enum lora_coding_rate

#include <zephyr/drivers/lora.h>

LoRa coding rate.

Enumerator
CR_4_5
CR_4_6
CR_4_7
CR_4_8

lora_datarate

enum lora_datarate

#include <zephyr/drivers/lora.h>

LoRa data-rate.

Enumerator
SF_6
SF_7
SF_8
SF_9
SF_10
SF_11
SF_12

lora_signal_bandwidth

enum lora_signal_bandwidth

#include <zephyr/drivers/lora.h>

LoRa signal bandwidth.

Enumerator
BW_125_KHZ
BW_250_KHZ
BW_500_KHZ

Function Documentation

lora_config()

static int lora_config ( const struct device * dev, struct lora_modem_config * config )

inlinestatic

#include <zephyr/drivers/lora.h>

Configure the LoRa modem.

Parameters

dev	LoRa device
config	Data structure containing the intended configuration for the modem

Returns

0 on success, negative on error

lora_recv()

static int lora_recv ( const struct device * dev, uint8_t * data, uint8_t size, k_timeout_t timeout, int16_t * rssi, int8_t * snr )

inlinestatic

#include <zephyr/drivers/lora.h>

Receive data over LoRa.

Note

This is a blocking call.

Parameters

dev	LoRa device
data	Buffer to hold received data
size	Size of the buffer to hold the received data. Max size allowed is 255.
timeout	Duration to wait for a packet.
rssi	RSSI of received data
snr	SNR of received data

Returns

Length of the data received on success, negative on error

lora_recv_async()

static int lora_recv_async ( const struct device * dev, lora_recv_cb cb, void * user_data )

inlinestatic

#include <zephyr/drivers/lora.h>

Receive data asynchronously over LoRa.

Receive packets continuously under the configuration previously setup by lora_config.

Reception is cancelled by calling this function again with cb = NULL. This can be done within the callback handler.

Parameters

dev	Modem to receive data on.
cb	Callback to run on receiving data. If NULL, any pending asynchronous receptions will be cancelled.
user_data	User data passed to callback

Returns

0 when reception successfully setup, negative on error

lora_send()

static int lora_send ( const struct device * dev, uint8_t * data, uint32_t data_len )

inlinestatic

#include <zephyr/drivers/lora.h>

Send data over LoRa.

Note

This blocks until transmission is complete.

Parameters

dev	LoRa device
data	Data to be sent
data_len	Length of the data to be sent

Returns

0 on success, negative on error

lora_send_async()

static int lora_send_async ( const struct device * dev, uint8_t * data, uint32_t data_len, struct k_poll_signal * async )

inlinestatic

#include <zephyr/drivers/lora.h>

Asynchronously send data over LoRa.

Note

This returns immediately after starting transmission, and locks the LoRa modem until the transmission completes.

Parameters

dev	LoRa device
data	Data to be sent
data_len	Length of the data to be sent
async	A pointer to a valid and ready to be signaled struct k_poll_signal. (Note: if NULL this function will not notify the end of the transmission).

Returns

0 on success, negative on error

lora_test_cw()

static int lora_test_cw ( const struct device * dev, uint32_t frequency, int8_t tx_power, uint16_t duration )

inlinestatic

#include <zephyr/drivers/lora.h>

Transmit an unmodulated continuous wave at a given frequency.

Note

Only use this functionality in a test setup where the transmission does not interfere with other devices.

Parameters

dev	LoRa device
frequency	Output frequency (Hertz)
tx_power	TX power (dBm)
duration	Transmission duration in seconds.

Returns

0 on success, negative on error