Skip to content

Commit eed6f11

Browse files
ktaborowskiktaborowski
committed
doc: add lr 1110 support
experimental support for lr1110 radio Signed-off-by: Krzysztof Taborowski <[email protected]>
1 parent e472eef commit eed6f11

File tree

6 files changed

+140
-6
lines changed

6 files changed

+140
-6
lines changed

‎doc/includes/include_building_and_running.txt‎

Lines changed: 19 additions & 1 deletion
Original file line numberDiff line numberDiff line change
@@ -11,7 +11,7 @@ This sample can be found under :file:`samples/sid_end_device`.
1111

1212
To build the sample, follow the steps in the `Building and programming an application`_ documentation.
1313

14-
To build the sample for sub-GHz (LoRa/FSK) operation, use the ``--shield`` option with ``west build``. This configures the correct device tree overlays and pin mappings for the Semtech SX1262 shield, and enables the correct Sidewalk radio configuration.
14+
To build the sample for sub-GHz (LoRa/FSK) operation, use the ``--shield`` option with ``west build``. This configures the correct device tree overlays and pin mappings for the Semtech radio shield (SX1262 or LR1110), and enables the correct Sidewalk radio configuration.
1515

1616
.. tabs::
1717

@@ -32,3 +32,21 @@ To build the sample for sub-GHz (LoRa/FSK) operation, use the ``--shield`` optio
3232
.. code-block:: console
3333

3434
west build -b nrf54l15dk/nrf54l15/cpuapp --shield nrf54l15dk_arduino_adapter --shield semtech_sx1262mb2cas
35+
36+
.. tab:: nrf52840dk/nrf52840 (LR1110)
37+
38+
.. code-block:: console
39+
40+
west build -b nrf52840dk/nrf52840 --shield simple_arduino_adapter --shield semtech_lr1110mb1xxs
41+
42+
.. tab:: nrf5340dk/nrf5340/cpuapp (LR1110)
43+
44+
.. code-block:: console
45+
46+
west build -b nrf5340dk/nrf5340/cpuapp --shield simple_arduino_adapter --shield semtech_lr1110mb1xxs
47+
48+
.. tab:: nrf54l15dk/nrf54l15/cpuapp (LR1110)
49+
50+
.. code-block:: console
51+
52+
west build -b nrf54l15dk/nrf54l15/cpuapp --shield simple_arduino_adapter --shield semtech_lr1110mb1xxs

‎doc/links.rst‎

Lines changed: 1 addition & 0 deletions
Original file line numberDiff line numberDiff line change
@@ -82,6 +82,7 @@
8282
.. Other links and additional resources
8383
8484
.. _SX1262: https://os.mbed.com/components/SX126xMB2xAS/
85+
.. _LR1110: https://www.semtech.com/products/wireless-rf/lora-edge/lr1110
8586
.. _Semtech SX1262MB2CAS: https://www.semtech.com/products/wireless-rf/lora-transceivers/sx1262mb2cas
8687
.. _PICS v2.9.0 - BLE only: https://docs.nordicsemi.com/bundle/Amazon-Sidewalk-Protocol-PICS---BLE-only/resource/Amazon_Sidewalk_Protocol_PICS_-_BLE_only.pdf
8788
.. _PICS v2.9.0: https://docs.nordicsemi.com/bundle/Amazon-Sidewalk-Protocol-PICS/resource/Amazon_Sidewalk_Protocol_PICS.pdf

‎doc/location_services.rst‎

Lines changed: 3 additions & 0 deletions
Original file line numberDiff line numberDiff line change
@@ -53,6 +53,9 @@ WiFi and GNSS scanning leverage the Semtech LoRa Basics Modem middleware to mana
5353
Semtech SX1262 radio does not support WiFi and GNSS scans.
5454
However, you can use your nRF + SX1262 device with BLE location.
5555

56+
.. note::
57+
LR1110 support for WiFi and GNSS location services is experimental.
58+
5659
Location Levels
5760
===============
5861

‎doc/samples/samples_list.rst‎

Lines changed: 3 additions & 3 deletions
Original file line numberDiff line numberDiff line change
@@ -12,18 +12,18 @@ The following table demonstrates the variants' configuration for the supported d
1212
| Sample variant | Description | Development kit | Additional hardware | Bootloader (in release and debug configs) | Application overlays |
1313
+===================================+==========================================+===========================================+===========================================================================+===============================================+===========================+
1414
| :ref:`variant_sidewalk_hello` | Sample application showing communication | * `nRF52840 DK`_ | * External flash (included in the DK) except `nRF54L15 DK`_ | * MCUboot - DFU partition in external flash | * ``overlay-hello.conf`` |
15-
| | over Sidewalk network. | * `nRF5340 DK`_ | * `Semtech SX1262MB2CAS`_ (only for the configurations with LoRa or FSK) | * Application partition size = 956 kB | |
15+
| | over Sidewalk network. | * `nRF5340 DK`_ | * `Semtech SX1262MB2CAS`_ or LR1110MB1xxS (LoRa/FSK only) | * Application partition size = 956 kB | |
1616
| | | * `nRF54L15 DK`_ | | | |
1717
| | | * nRF54L10 emulating on `nRF54L15 DK`_ | | | |
1818
+-----------------------------------+------------------------------------------+-------------------------------------------+---------------------------------------------------------------------------+-----------------------------------------------+---------------------------+
1919
| :ref:`variant_sensor_monitoring` | Demo application of Sidewalk protocol | * `nRF52840 DK`_ | * External flash (included in the DK) except `nRF54L15 DK`_ | * MCUboot - DFU partition in external flash | * ``overlay-demo.conf`` |
20-
| | with temperature sensor monitoring. | * `nRF5340 DK`_ | * `Semtech SX1262MB2CAS`_ (only for the configurations with LoRa or FSK) | * Application partition size = 956 kB | |
20+
| | with temperature sensor monitoring. | * `nRF5340 DK`_ | * `Semtech SX1262MB2CAS`_ or LR1110MB1xxS (LoRa/FSK only) | * Application partition size = 956 kB | |
2121
| | | * `Thingy53`_ | | | |
2222
| | | * `nRF54L15 DK`_ | | | |
2323
| | | * nRF54L10 emulating on `nRF54L15 DK`_ | | | |
2424
+-----------------------------------+------------------------------------------+-------------------------------------------+---------------------------------------------------------------------------+-----------------------------------------------+---------------------------+
2525
| :ref:`variant_sidewalk_dut` | Device under test generic application | * `nRF52840 DK`_ | * External flash (included in the DK) except `nRF54L15 DK`_ | * MCUboot - DFU partition in external flash | * ``overlay-dut.conf`` |
26-
| | having activated CLI. | * `nRF5340 DK`_ | * `Semtech SX1262MB2CAS`_ (only for the configurations with LoRa or FSK) | * Application partition size = 956 kB | |
26+
| | having activated CLI. | * `nRF5340 DK`_ | * `Semtech SX1262MB2CAS`_ or LR1110MB1xxS (LoRa/FSK only) | * Application partition size = 956 kB | |
2727
| | | * `nRF54L15 DK`_ | | | |
2828
| | | * nRF54L10 emulating on `nRF54L15 DK`_ | | | |
2929
+-----------------------------------+------------------------------------------+-------------------------------------------+---------------------------------------------------------------------------+-----------------------------------------------+---------------------------+

‎doc/samples/sid_end_device.rst‎

Lines changed: 2 additions & 0 deletions
Original file line numberDiff line numberDiff line change
@@ -42,6 +42,8 @@ The supported modules are as follows:
4242
+============+===============+============+
4343
| `SX1262`_ | SX126xMB2xAS | SPI @ 8Mhz |
4444
+------------+---------------+------------+
45+
| `LR1110`_ | LR1110MB1LCKS | SPI @ 8Mhz |
46+
+------------+---------------+------------+
4547

4648
.. note::
4749
To use sub-GHz radio, the Semtech shield must be connected to the development kit header, and the antenna must be connected to the radio module.

‎doc/setting_up_sidewalk_environment/setting_up_hardware.rst‎

Lines changed: 112 additions & 2 deletions
Original file line numberDiff line numberDiff line change
@@ -21,12 +21,23 @@ Depending on the device, refer to the getting started guide for setup instructio
2121
* `Getting started with nRF53 Series`_
2222
* `Getting started with nRF54L Series`_
2323

24-
Semtech SX1262
25-
**************
24+
Sub-GHz radio transceivers
25+
**************************
2626

2727
Sidewalk samples use sub-GHz radio transceivers to support LoRa and (G)FSK modulation.
2828
You will need it to run :ref:`LoRa and FSK applications <samples_list>`.
2929

30+
The following radio shields are supported:
31+
32+
* **Semtech SX1262** - For LoRa and FSK applications
33+
* **Semtech LR1110** - For LoRa, FSK, and location services (WiFi/GNSS scanning)
34+
35+
.. warning::
36+
LR1110 support is experimental.
37+
38+
Semtech SX1262
39+
==============
40+
3041
For evaluation, use the `Semtech SX1262MB2CAS`_ Arduino Shield.
3142

3243
.. figure:: /images/nRF52840-Semtech-SX1262.jpg
@@ -132,6 +143,105 @@ Connect the Semtech shield to the Arduino-compatible headers on the development
132143
| SPI SCK | P0.3 |
133144
+---------------+--------------+
134145

146+
Semtech LR1110
147+
==============
148+
149+
For evaluation, use the Semtech LR1110MB1xxS Arduino Shield.
150+
151+
.. warning::
152+
LR1110 support is experimental.
153+
154+
The LR1110 shield supports WiFi and GNSS scanning for location services in addition to LoRa and FSK communication.
155+
156+
.. _setting_up_hardware_lr1110_pinout:
157+
158+
Pinout
159+
------
160+
161+
Connect the Semtech LR1110 shield to the Arduino-compatible headers on the development kit.
162+
163+
.. tabs::
164+
165+
.. tab:: nRF52840 DK
166+
167+
Refer to the pinout assignment for the nRF52840 DK:
168+
169+
+------------------+-------------+
170+
| LR1110 shield | nRF52840 DK |
171+
+==================+=============+
172+
| NRESET (A0) | P0.3 |
173+
+------------------+-------------+
174+
| BUSY (D9) | P1.11 |
175+
+------------------+-------------+
176+
| DIO1/Event (D11) | P1.13 |
177+
+------------------+-------------+
178+
| Antenna (D14) | P0.26 |
179+
+------------------+-------------+
180+
| GNSS LNA (A3) | P0.29 |
181+
+------------------+-------------+
182+
| SPI NSS (D13) | P1.15 |
183+
+------------------+-------------+
184+
| SPI MOSI (D11) | P1.13 |
185+
+------------------+-------------+
186+
| SPI MISO (D12) | P1.14 |
187+
+------------------+-------------+
188+
| SPI SCK (D13) | P1.15 |
189+
+------------------+-------------+
190+
191+
.. tab:: nRF5340 DK
192+
193+
Refer to the pinout assignment for the nRF5340 DK:
194+
195+
+------------------+-------------+
196+
| LR1110 shield | nRF5340 DK |
197+
+==================+=============+
198+
| NRESET (A0) | P0.4 |
199+
+------------------+-------------+
200+
| BUSY (D9) | P1.11 |
201+
+------------------+-------------+
202+
| DIO1/Event (D11) | P1.13 |
203+
+------------------+-------------+
204+
| Antenna (D14) | P1.2 |
205+
+------------------+-------------+
206+
| GNSS LNA (A3) | P0.7 |
207+
+------------------+-------------+
208+
| SPI NSS (D13) | P1.15 |
209+
+------------------+-------------+
210+
| SPI MOSI (D11) | P1.13 |
211+
+------------------+-------------+
212+
| SPI MISO (D12) | P1.14 |
213+
+------------------+-------------+
214+
| SPI SCK (D13) | P1.15 |
215+
+------------------+-------------+
216+
217+
.. tab:: nRF54L15 DK
218+
219+
The nRF54L15 DK requires the ``simple_arduino_adapter`` shield to connect the LR1110 shield.
220+
221+
Refer to the pinout assignment for the nRF54L15 DK with Arduino adapter:
222+
223+
+------------------+--------------+
224+
| LR1110 shield | nRF54L15 DK |
225+
+==================+==============+
226+
| NRESET (A0) | P2.8 |
227+
+------------------+--------------+
228+
| BUSY (D9) | P2.6 |
229+
+------------------+--------------+
230+
| DIO1/Event (D11) | P1.11 |
231+
+------------------+--------------+
232+
| Antenna (D14) | P2.10 |
233+
+------------------+--------------+
234+
| GNSS LNA (A3) | P1.12 |
235+
+------------------+--------------+
236+
| SPI NSS (D13) | P0.0 |
237+
+------------------+--------------+
238+
| SPI MOSI (D11) | P0.1 |
239+
+------------------+--------------+
240+
| SPI MISO (D12) | P0.2 |
241+
+------------------+--------------+
242+
| SPI SCK (D13) | P0.3 |
243+
+------------------+--------------+
244+
135245
.. _setting_up_sidewalk_gateway:
136246

137247
Sidewalk gateway

0 commit comments

Comments
 (0)