示例49:433MHz 射频模块

使用常见 433MHz OOK/EV1527/PT2262 类发射模块发送遥控编码，也可以把接收模块配置为电平监测输入。FastBee 内置 RF_MODULE 外设类型，类型 ID 为 48，无需额外下载射频库。

接线

模块引脚	ESP32/ESP32-S3	说明
VCC	3.3V 或模块要求的电源	按模块标称供电
GND	GND	必须共地
DATA / DIN / ATAD	GPIO4 示例	发射模式不能使用输入专用 GPIO
ANT	天线	建议接 17cm 左右导线或配套天线

接收模块使用 mode=1，DATA/OUT 接到一个可输入 GPIO。

外设执行发送

新增外设执行规则，动作选择 调用其他外设，目标选择 rf_tx_01，动作值填写：

{"periphId":"rf_tx_01","action":"send","code":"0xA1B2C3","bits":24,"pulseWidth":350,"repeat":8}

code 支持十进制、0x 十六进制、0b 二进制。多数 433MHz 遥控器使用 24 位编码，先保持默认参数测试，无法触发时再调整 pulseWidth。

接收电平监测

如果使用接收模块，可新增 mode=1 的 RF 外设：

{
  "id": "rf_rx_01",
  "name": "433M接收电平",
  "type": 48,
  "enabled": true,
  "pins": [16],
  "params": {
    "mode": 1,
    "activeHigh": true
  }
}

外设执行中使用 传感器读取：

{
  "periphId": "rf_rx_01",
  "sensorCategory": "rf",
  "dataField": "value",
  "sensorLabel": "射频电平",
  "unit": "",
  "decimalPlaces": 0
}

读取后会生成 ds:rf_rx_01_value，值为 1 或 0。当前内置接收模式用于电平监测，不做完整遥控码学习解码；需要学习编码时可先用配套学习遥控器或逻辑分析仪获得编码。

调试接口

POST /api/peripherals/write
Content-Type: application/x-www-form-urlencoded

id=rf_tx_01&code=0xA1B2C3&bits=24&pulseWidth=350&repeat=8

注意事项

• 发射脚不要选 GPIO34-39 等输入专用脚，也不要选 Flash/PSRAM 保留脚。
• 射频模块对供电和天线敏感，测试时先近距离验证，再调整天线和安装位置。
• 不要连续高频发送，建议由外设执行规则按事件触发或低频定时触发。