.. zephyr:code-sample:: lora-receive
:name: LoRa receive
:relevant-api: lora_api
Receive packets in both synchronous and asynchronous mode using the LoRa
radio.
Overview
********
This sample demonstrates how to use the LoRa radio driver to receive packets
both synchronously and asynchronously.
In order to successfully receive messages, build and flash the accompanying
LoRa send sample :zephyr:code-sample:`lora-send` on another board within range.
As this sample receives a finite number of packets and then sleeps infinitely,
the user must be ready to inspect the console output immediately after
resetting the device.
Building and Running
********************
Build and flash the sample as follows, changing ``b_l072z_lrwan1`` for
your board, where your board has a ``lora0`` alias in the devicetree.
.. zephyr-app-commands::
:zephyr-app: samples/drivers/lora/receive
:host-os: unix
:board: b_l072z_lrwan1
:goals: build flash
:compact:
Sample Output
=============
.. code-block:: console
[00:00:00.235,000] <inf> lora_receive: Synchronous reception
[00:00:00.956,000] <inf> lora_receive: LoRa RX RSSI: -60dBm, SNR: 7dB
[00:00:00.956,000] <inf> lora_receive: LoRa RX payload
68 65 6c 6c 6f 77 6f 72 6c 64 |hellowor ld
[00:00:02.249,000] <inf> lora_receive: LoRa RX RSSI: -57dBm, SNR: 9dB
[00:00:02.249,000] <inf> lora_receive: LoRa RX payload
68 65 6c 6c 6f 77 6f 72 6c 64 |hellowor ld
[00:00:03.541,000] <inf> lora_receive: LoRa RX RSSI: -57dBm, SNR: 9dB
[00:00:03.541,000] <inf> lora_receive: LoRa RX payload
68 65 6c 6c 6f 77 6f 72 6c 64 |hellowor ld
[00:00:04.834,000] <inf> lora_receive: LoRa RX RSSI: -55dBm, SNR: 9dB
[00:00:04.834,000] <inf> lora_receive: LoRa RX payload
68 65 6c 6c 6f 77 6f 72 6c 64 |hellowor ld
[00:00:04.834,000] <inf> lora_receive: Asynchronous reception
[00:00:06.127,000] <inf> lora_receive: LoRa RX RSSI: -55dBm, SNR: 9dB
[00:00:06.127,000] <inf> lora_receive: LoRa RX payload
68 65 6c 6c 6f 77 6f 72 6c 64 |hellowor ld
[00:00:07.419,000] <inf> lora_receive: LoRa RX RSSI: -55dBm, SNR: 9dB
[00:00:07.419,000] <inf> lora_receive: LoRa RX payload
68 65 6c 6c 6f 77 6f 72 6c 64 |hellowor ld
[00:00:08.712,000] <inf> lora_receive: LoRa RX RSSI: -55dBm, SNR: 9dB
[00:00:08.712,000] <inf> lora_receive: LoRa RX payload
68 65 6c 6c 6f 77 6f 72 6c 64 |hellowor ld
[00:00:10.004,000] <inf> lora_receive: LoRa RX RSSI: -55dBm, SNR: 9dB
[00:00:10.004,000] <inf> lora_receive: LoRa RX payload
68 65 6c 6c 6f 77 6f 72 6c 64 |hellowor ld
[00:00:11.297,000] <inf> lora_receive: LoRa RX RSSI: -55dBm, SNR: 9dB
[00:00:11.297,000] <inf> lora_receive: LoRa RX payload
68 65 6c 6c 6f 77 6f 72 6c 64 |hellowor ld
[00:00:12.590,000] <inf> lora_receive: LoRa RX RSSI: -55dBm, SNR: 9dB
[00:00:12.590,000] <inf> lora_receive: LoRa RX payload
68 65 6c 6c 6f 77 6f 72 6c 64 |hellowor ld
[00:00:13.884,000] <inf> lora_receive: LoRa RX RSSI: -55dBm, SNR: 9dB
[00:00:13.884,000] <inf> lora_receive: LoRa RX payload
68 65 6c 6c 6f 77 6f 72 6c 64 |hellowor ld
[00:00:15.177,000] <inf> lora_receive: LoRa RX RSSI: -55dBm, SNR: 9dB
[00:00:15.177,000] <inf> lora_receive: LoRa RX payload
68 65 6c 6c 6f 77 6f 72 6c 64 |hellowor ld
[00:00:16.470,000] <inf> lora_receive: LoRa RX RSSI: -55dBm, SNR: 9dB
[00:00:16.470,000] <inf> lora_receive: LoRa RX payload
68 65 6c 6c 6f 77 6f 72 6c 64 |hellowor ld
[00:00:17.762,000] <inf> lora_receive: LoRa RX RSSI: -55dBm, SNR: 9dB
[00:00:17.762,000] <inf> lora_receive: LoRa RX payload
68 65 6c 6c 6f 77 6f 72 6c 64 |hellowor ld
[00:00:17.762,000] <inf> lora_receive: Stopping packet receptions
a4e31487d5