Ai-Thinker Rd-01

python -m venv .venv
# Активируйте .venv способом своей ОС, затем:
python -m pip install pyserial==3.5

Команды подготовки, а не выполненный тест. Python 3 и pyserial 3.5; драйвер USB–UART должен быть установлен из официального источника. Уточнить реальное имя порта через ОС.

"""Rd-01 receive-only UART diagnostic. Python 3 + pyserial 3.5.
Wire sensor TX (GPIO16, module pin 9) to adapter RX and share GND.
Leave adapter TX/RTS/DTR disconnected. Supply sensor separately at 3.3 V.
"""
import argparse
import time

HEADER = bytes.fromhex("F4 F3 F2 F1")
FOOTER = bytes.fromhex("F8 F7 F6 F5")
STATES = {0: "none", 1: "moving", 2: "stationary", 3: "moving_and_stationary"}


def extract_frames(buf):
    """Consume complete report frames; preserve partial input for the next read."""
    frames = []
    while True:
        start = buf.find(HEADER)
        if start < 0:
            if len(buf) > 3:
                del buf[:-3]
            break
        if start:
            del buf[:start]
        if len(buf) < 6:
            break
        size = int.from_bytes(buf[4:6], "little")
        if not 13 <= size <= 1024:
            del buf[0]
            continue
        total = 6 + size + 4
        if len(buf) < total:
            break
        if bytes(buf[6 + size:total]) != FOOTER:
            del buf[0]
            continue
        payload = bytes(buf[6:6 + size])
        del buf[:total]
        if payload[1] == 0xAA and payload[-2:] == b"\x55\x00":
            frames.append(payload)
    return frames


def decode_basic(payload):
    if len(payload) != 13 or payload[0] != 0x02:
        return None
    if payload[2] not in STATES or payload[5] > 100 or payload[8] > 100:
        return None
    return {
        "state": STATES[payload[2]],
        "moving_cm": int.from_bytes(payload[3:5], "little"),
        "moving_energy": payload[5],
        "stationary_cm": int.from_bytes(payload[6:8], "little"),
        "stationary_energy": payload[8],
        "detection_cm": int.from_bytes(payload[9:11], "little"),
    }


def main():
    import serial
    ap = argparse.ArgumentParser(description=__doc__)
    ap.add_argument("port", help="Actual adapter port, e.g. COM4 or /dev/ttyUSB0")
    args = ap.parse_args()
    for baud in (115200, 256000):
        framed = decoded = received = 0
        buf = bytearray()
        print("Trying", baud, "8N1, receive only")
        try:
            with serial.Serial(args.port, baudrate=baud,
                               bytesize=serial.EIGHTBITS, parity=serial.PARITY_NONE,
                               stopbits=serial.STOPBITS_ONE, timeout=0.2,
                               xonxoff=False, rtscts=False, dsrdtr=False) as port:
                deadline = time.monotonic() + 8.0
                while time.monotonic() < deadline:
                    chunk = port.read(512)
                    received += len(chunk)
                    buf.extend(chunk)
                    if len(buf) > 8192:
                        del buf[:-8192]
                    for payload in extract_frames(buf):
                        framed += 1
                        data = decode_basic(payload)
                        if data is not None:
                            decoded += 1
                            print(data)
                print("Bytes:", received, "report frames:", framed,
                      "supported basic reports:", decoded)
        except (serial.SerialException, ValueError) as err:
            print("Port/rate error:", err)
        if decoded == 0:
            print("No supported basic reports. This does NOT mean no person.")
            print("Check power, common GND, TX-to-RX, baud, firmware and output mode.")


if __name__ == "__main__":
    main()

Полный пример для Rd-01 + ПК + 3,3-В USB–UART, не для конкретной платы ESP32. Проверены синтаксис и разбор контрольного кадра из официального протокола; физического модуля и COM-порта для проверки не было. Серийные данные только читаются. Инженерный/другой payload может иметь валидное обрамление, но не декодируется как обычный отчёт.

python rd01_receive_only.py COM4
# Альтернатива Linux, если это фактический порт:
python rd01_receive_only.py /dev/ttyUSB0

Выбрать одну команду и заменить порт своим. Ожидаются валидные базовые отчёты с state и полями сантиметров/энергии, если установленная прошивка их выдаёт. Восемь секунд без отчётов не доказывают неисправность или пустую комнату: проверить проводку, питание, скорость, режим и прошивку. Для сравнения состояния пройти в зоне, затем спокойно посидеть и покинуть её, учитывая задержку исчезновения цели. Это план проверки, не подтверждённый результат.