1.. _semtech_sx1276mb1mas:
2
3Semtech SX1276MB1MAS LoRa Shield
4################################
5
6Overview
7********
8
9The Semtech SX1276MB1MAS LoRa shield is an Arduino compatible shield based on
10the SX1276 LoRa transceiver from Semtech.
11
12More information about the shield can be found at the `mbed SX1276MB1xAS
13website`_.
14
15Pins Assignment of the Semtech SX1276MB1MAS LoRa Shield
16=======================================================
17
18+-----------------------+-----------------+
19| Shield Connector Pin  | Function        |
20+=======================+=================+
21| A0                    | SX1276 RESET    |
22+-----------------------+-----------------+
23| A3                    | SX1276 DIO4 (1) |
24+-----------------------+-----------------+
25| A4                    | Antenna RX/TX   |
26+-----------------------+-----------------+
27| D2                    | SX1276 DIO0     |
28+-----------------------+-----------------+
29| D3                    | SX1276 DIO1     |
30+-----------------------+-----------------+
31| D4                    | SX1276 DIO2     |
32+-----------------------+-----------------+
33| D5                    | SX1276 DIO3     |
34+-----------------------+-----------------+
35| D8                    | SX1276 DIO4 (1) |
36+-----------------------+-----------------+
37| D9                    | SX1276 DIO5     |
38+-----------------------+-----------------+
39| D10                   | SX1276 SPI NSS  |
40+-----------------------+-----------------+
41| D11                   | SX1276 SPI MOSI |
42+-----------------------+-----------------+
43| D12                   | SX1276 SPI MISO |
44+-----------------------+-----------------+
45| D13                   | SX1276 SPI SCK  |
46+-----------------------+-----------------+
47
48(1) SX1276 DIO4 is configured on D8 by default. It is possible to reconfigure it
49    in devicetree to A3 if needed.
50
51Requirements
52************
53
54This shield can only be used with a board which provides a configuration for
55Arduino connectors and defines node aliases for SPI and GPIO interfaces (see
56:ref:`shields` for more details).
57
58Programming
59***********
60
61Set ``--shield semtech_sx1276mb1mas`` when you invoke ``west build``. For
62example:
63
64.. zephyr-app-commands::
65   :zephyr-app: samples/subsys/lorawan/class_a
66   :board: nucleo_l073rz
67   :shield: semtech_sx1276mb1mas
68   :goals: build
69
70References
71**********
72
73.. target-notes::
74
75.. _mbed SX1276MB1xAS website:
76   https://os.mbed.com/components/SX1276MB1xAS/
77