.. _lora_api: .. _lorawan_api:

LoRa and LoRaWAN ################

Overview

LoRa (abbrev. for Long Range) is a proprietary low-power wireless communication protocol developed by the Semtech Corporation_.

LoRa acts as the physical layer (PHY) based on the chirp spread spectrum (CSS) modulation technique.

LoRaWAN (for Long Range Wide Area Network) defines a networking layer on top of the LoRa PHY.

Zephyr provides APIs for LoRa to send raw data packets directly over the wireless interface as well as APIs for LoRaWAN to connect the end device to the internet through a gateway.

The Zephyr implementation is based on Semtech's LoRaMac-node library_, which is included as a Zephyr module.

.. note::

    ``LoRaMac-node`` has been deprecated by Semtech in favor of
    `LoRa Basics Modem`_. Porting the Zephyr API's to use
    ``LoRa Basics Modem`` as the backend is in progress.

    Currently, only the base LoRa API is supported for the SX1261, SX1262,
    SX1272 and SX1276 chipsets through
    :kconfig:option:`CONFIG_LORA_MODULE_BACKEND_LORA_BASICS_MODEM`.

The LoRaWAN specification is published by the LoRa Alliance_.

.. _Semtech Corporation: https://www.semtech.com/

.. _LoRaMac-node library: https://github.com/Lora-net/LoRaMac-node

.. _LoRa Basics Modem: https://github.com/Lora-net/SWL2001

.. _LoRa Alliance: https://lora-alliance.org/

Configuration Options