Stamp LoRa-1262
===============

.. sku: S014
.. py:currentmodule:: stamp
.. include:: ../refs/stamp.lora1262.ref

Stamp LoRa-1262 is an SX1262 LoRa transceiver for the Stamp Series FPC12
interface. ``StampLoRa1262`` selects the current host's FPC12 GPIO mapping,
enables the RF switch, and provides synchronous send, receive, and radio
configuration operations.

Support the following products:

    |Stamp LoRa-1262|


The following are the host's support for Stamp LoRa-1262:

.. list-table:: Stamp LoRa-1262 host support
    :header-rows: 1

    * - Controller
      - Status
    * - StampC5
      - |S|
    * - StampC6
      - |S|
    * - StampS3Mini
      - |S|

.. |S| unicode:: U+2714


The supported RF frequency range is 868-923 MHz. Attach a suitable antenna
before transmitting. The module's ``SHUT_DOWN`` signal is not part of the
Stamp Series FPC12 interface and is not controlled by this driver.

Pin Mapping
-----------

.. list-table:: Stamp LoRa-1262 FPC12 mapping
    :header-rows: 1

    * - Position
      - Signal
      - StampC5
      - StampC6
      - StampS3Mini
    * - 1
      - 3V3
      - 3V3
      - 3V3
      - 3V3
    * - 2
      - 3V3
      - 3V3
      - 3V3
      - 3V3
    * - 3
      - SW
      - G23
      - G8
      - G38
    * - 4
      - IRQ
      - G0
      - G0
      - G21
    * - 5
      - BUSY
      - G24
      - G18
      - G39
    * - 6
      - RST
      - G25
      - G19
      - G40
    * - 7
      - GND
      - GND
      - GND
      - GND
    * - 8
      - MISO
      - G26
      - G20
      - G41
    * - 9
      - MOSI
      - G27
      - G21
      - G42
    * - 10
      - CS
      - G11
      - G22
      - G43
    * - 11
      - GND
      - GND
      - GND
      - GND
    * - 12
      - CLK
      - G12
      - G23
      - G44

UiFlow2 Example
---------------

Sender
^^^^^^

Open the |stamp_lora1262_sender_example.m5f2| project in UiFlow2. It sends a
sequence message once per second.

UiFlow2 Code Block:

    |stamp_lora1262_sender_example.png|

Receiver
^^^^^^^^

Open the |stamp_lora1262_receiver_example.m5f2| project in UiFlow2. It starts
continuous reception and prints each packet with RSSI and SNR.

UiFlow2 Code Block:

    |stamp_lora1262_receiver_example.png|

MicroPython Example
-------------------

Sender
^^^^^^

.. literalinclude:: ../../../examples/stamp/lora1262/stamp_lora1262_sender_example.py
    :language: python
    :linenos:

Receiver
^^^^^^^^

.. literalinclude:: ../../../examples/stamp/lora1262/stamp_lora1262_receiver_example.py
    :language: python
    :linenos:

API
---

.. autoclass:: stamp.lora1262.StampLoRa1262
    :members:
    :member-order: bysource