RF433R Unit

This library is the driver for Unit RF433R.

Support the following products:

Note

ESP32-S3 related devices, such as CoreS2 and AtomS3, are not supported yet.

UiFlow2 Example:

Receive data

Open the basic_rf433r_recv_example.m5f2 project in UiFlow2.

The example program demonstrates communication using RF433TUnit and RF433RUnit. Please refer to the sending end. RF433TUnit

UiFlow2 Code Block:

Example output:

None

MicroPython Example:

Receive data

The example program demonstrates communication using RF433TUnit and RF433RUnit. Please refer to the sending end. RF433TUnit

MicroPython Code Block:

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

import os, sys, io
import M5
from M5 import *
from unit import RF433RUnit


title0 = None
label_cnt = None
rf433r_0 = None
rf433r_data = None
cnt = None


def rf433r_0_receive_event(received_data):
    global title0, label_cnt, rf433r_0, rf433r_data, cnt
    rf433r_data = received_data
    cnt = rf433r_data[-1]
    label_cnt.setText(str((str("Count: ") + str(cnt))))
    print(rf433r_data)


def setup():
    global title0, label_cnt, rf433r_0, rf433r_data, cnt
    M5.begin()
    title0 = Widgets.Title("RF433R Recv Data", 3, 0xFFFFFF, 0x0000FF, Widgets.FONTS.DejaVu24)
    label_cnt = Widgets.Label("Count", 115, 118, 1.0, 0x00FF00, 0x000000, Widgets.FONTS.DejaVu18)
    rf433r_0 = RF433RUnit((36, 26))
    rf433r_0.set_recv_callback(rf433r_0_receive_event)
    rf433r_0.start_recv()


def loop():
    global title0, label_cnt, rf433r_0, rf433r_data, cnt
    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")

Example output:

None

API

RF433RUnit

class unit.rf433r.RF433RUnit(port=None)

Bases: object

Create an RF433RUnit object.

Parameters:

port (list|tuple) – Tuple containing grove port pin numbers.

UiFlow2 Code Block:

MicroPython Code Block:

from unit import RF433RUnit

unit_rf433r = RF433RUnit(port=(36, 26))

read()

Read data.

Returns:

receive data.

Return type:

bytes | None

If no data is received, return None.

UiFlow2 Code Block:

MicroPython Code Block:

unit_rf433r.read()

set_recv_callback(callback)

Set receive data callback function.

Parameters:

callback – A function that will be called when data is received.

UiFlow2 Code Block:

MicroPython Code Block:

def unit_rf433r_receive_event(received_data):
    rf433r_data = received_data

unit_rf433r.set_recv_callback(unit_rf433r_receive_event)

start_recv()

Start receive data.

UiFlow2 Code Block:

MicroPython Code Block:

unit_rf433r.start_recv()

Return type:

None

stop_recv()

Stop receive data.

UiFlow2 Code Block:

MicroPython Code Block:

unit_rf433r.stop_recv()

Return type:

None