Stamp LoRa-1262

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:

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

Stamp LoRa-1262 host support
Controller	Status
StampC5	✔
StampC6	✔
StampS3Mini	✔

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

Stamp LoRa-1262 FPC12 mapping
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:

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:

MicroPython Example

Sender

# SPDX-FileCopyrightText: 2026 M5Stack Technology CO LTD
#
# SPDX-License-Identifier: MIT

import time

import M5
from stamp import StampLoRa1262


radio = None
sequence = None


def setup():
    global radio, sequence

    M5.begin()
    radio = StampLoRa1262()
    sequence = 0


def loop():
    global radio, sequence

    M5.update()
    message = "Stamp LoRa1262 %d" % sequence
    radio.send(message)
    print("sent:", message)
    sequence = (sequence + 1) & 0xFF
    time.sleep_ms(1000)


if __name__ == "__main__":
    try:
        setup()
        while True:
            loop()
    except (Exception, KeyboardInterrupt) as e:
        try:
            from utility import print_error_msg

            print_error_msg(e)
        except ImportError:
            print("please update to latest firmware")

Receiver

# SPDX-FileCopyrightText: 2026 M5Stack Technology CO LTD
#
# SPDX-License-Identifier: MIT

import M5
from stamp import StampLoRa1262


radio = None


def receive_event(packet):
    print("received:", packet.decode())
    print("rssi:", packet.rssi, "snr:", packet.snr / 4)


def setup():
    global radio

    M5.begin()
    radio = StampLoRa1262()
    radio.set_rx_callback(receive_event)
    radio.start_recv()


def loop():
    M5.update()


if __name__ == "__main__":
    try:
        setup()
        while True:
            loop()
    except (Exception, KeyboardInterrupt) as e:
        try:
            from utility import print_error_msg

            print_error_msg(e)
        except ImportError:
            print("please update to latest firmware")

API

class stamp.lora1262.StampLoRa1262(freq_khz=868000, bw='250', sf=8, coding_rate=8, preamble_len=12, syncword=18, output_power=10, sw=None, irq=None, busy=None, reset=None, miso=None, mosi=None, cs=None, clock=None, spi_id=1)

Bases: object

SX1262 LoRa radio connected through the Stamp FPC12 interface.

Passing None for a pin uses the current Stamp host’s FPC12 mapping. StampC5, StampC6, and StampS3Mini are supported by default. Other hosts can be used when every signal pin is provided explicitly.

set_freq(freq_khz=868000)

Set the LoRa carrier frequency.

Parameters:: freq_khz (int) – Carrier frequency in kHz, from 868000 to 923000.
Raises:: ValueError – If freq_khz is outside the supported range.

UiFlow2 Code Block:

MicroPython Code Block:

radio.set_freq(868000)

set_sf(sf)

Set the LoRa spreading factor.

Parameters:: sf (int) – Spreading factor, from 6 to 12.
Raises:: ValueError – If sf is outside the supported range.

UiFlow2 Code Block:

MicroPython Code Block:

radio.set_sf(8)

set_bw(bw)

Set the LoRa bandwidth.

Parameters:: bw (str) – Bandwidth in kHz. Use one of BANDWIDTHS.
Raises:: ValueError – If bw is not supported.

UiFlow2 Code Block:

MicroPython Code Block:

radio.set_bw("250")

set_coding_rate(coding_rate)

Set the coding-rate denominator for 4/N coding.

Parameters:: coding_rate (int) – Coding-rate denominator, from 5 to 8.
Raises:: ValueError – If coding_rate is outside the supported range.

UiFlow2 Code Block:

MicroPython Code Block:

radio.set_coding_rate(8)

set_syncword(syncword)

Set the LoRa sync word.

Parameters:: syncword (int) – Sync word value, from 1 to 255.
Raises:: ValueError – If syncword is outside the supported range.

UiFlow2 Code Block:

MicroPython Code Block:

radio.set_syncword(0x12)

set_preamble_len(preamble_len)

Set the LoRa preamble length.

Parameters:: preamble_len (int) – Preamble length in symbols, from 5 to 255.
Raises:: ValueError – If preamble_len is outside the supported range.

UiFlow2 Code Block:

MicroPython Code Block:

radio.set_preamble_len(12)

set_output_power(output_power)

Set the LoRa output power.

Parameters:: output_power (int) – Output power in dBm, from -9 to 22.
Raises:: ValueError – If output_power is outside the supported range.

UiFlow2 Code Block:

MicroPython Code Block:

radio.set_output_power(10)

send(packet, tx_at_ms=None)

Send a packet and return its transmission timestamp.

Parameters:

packet – String, bytes-like object, list, tuple, or integer payload. Strings are encoded as UTF-8 and integers are sent as one-byte payloads.
tx_at_ms (int) – Optional scheduled transmission timestamp.

Returns:

Transmission timestamp in milliseconds.

Return type: