xiaoyang/smart-home
1
0
Fork 0
Code Issues Pull Requests Actions Packages Projects Releases Wiki Activity
0548c1555f
smart-home/使用手册/手册指南/433MHz_使用指南.md
小羊肉肉. 0548c1555f 更新项目文档和传感器模块 
主要更改：
1. 新增使用手册：
   - AI算法更新指南
   - HTPA60x40传感器升级指南
   - 环境配置教程

2. 传感器模块优化：
   - HTPA60x40dR1L0.9传感器集成
   - HTPAd32x32L1k7传感器更新
   - 传感器配置文档完善

3. 项目文档整理：
   - 删除过期的433MHz使用指南
   - 更新README文档结构
   - 完善配置教程链接

 目标：完善项目文档，优化传感器集成
2026-02-26 18:11:43 +08:00

3.0 KiB
Raw Blame History

433MHz模块使用指南

概述

本文档介绍如何使用ESP32上集成的RTM300-433M模块进行433MHz无线通信。该模块基于CMT2300A芯片，支持FSK调制，可用于各类433MHz无线设备的控制和数据接收。

硬件连接

RTM300-433M模块通过以下引脚连接到ESP32：

模块引脚 ESP32引脚 功能描述
CSB GPIO48 主片选（寄存器控制）
FCSB GPIO47 FIFO片选（数据控制）
SCLK GPIO9 SPI时钟线
SDIO GPIO4 SPI双向数据线
IO3 GPIO37 接收中断引脚
IO1 GPIO36 辅助状态引脚

功能特性

  • 工作频率：433.92MHz
  • 调制方式：FSK
  • 数据速率：1.2Kbps
  • FIFO大小：32字节
  • 通信方式：HTTP API接口

HTTP API接口

1. 获取模块状态

GET /api/rf433/status

响应示例：

{
  "ready": true,
  "version": "1.0.0",
  "mode": "receive"
}

2. 发送数据

POST /api/rf433/send

请求体：

{
  "data": "A55A01020304"  // 十六进制字符串
}

响应示例：

{
  "success": true,
  "length": 6,
  "message": "数据发送成功"
}

3. 设置接收模式

POST /api/rf433/receive

请求体：

{
  "enable": true  // true启用接收模式，false禁用
}

响应示例：

{
  "success": true,
  "mode": "receive",
  "message": "接收模式已启用"
}

4. 读取寄存器（调试用）

GET /api/rf433/register?addr=0x00

响应示例：

{
  "address": "0x00",
  "value": "0x05",
  "description": "控制寄存器"
}

使用示例

Python测试脚本

项目根目录下提供了test_433mhz.py脚本，用于测试433MHz模块的基本功能：

# 使用默认IP地址(192.168.1.3)
python test_433mhz.py

# 指定设备IP地址
python test_433mhz.py --ip 192.168.1.100

发送自定义数据

可以使用任何HTTP客户端（如curl、Postman等）发送自定义数据：

curl -X POST http://192.168.1.3/api/rf433/send \
  -H "Content-Type: application/json" \
  -d '{"data": "A55A01020304"}'

常见问题

  1. 模块初始化失败

    • 检查硬件连接是否正确
    • 确认ESP32固件已正确烧录
    • 重启设备尝试重新初始化

  2. 发送数据失败

    • 确认数据格式正确（十六进制字符串）
    • 数据长度不能超过32字节
    • 检查模块状态是否就绪

  3. 无法接收数据

    • 确认已启用接收模式
    • 检查发送设备是否工作在相同频率
    • 确认发送设备与接收设备距离适当

注意事项

  1. 433MHz模块初始化在单独的任务中进行，不会阻塞主系统运行
  2. 模块初始化有3秒超时保护，超时后系统会继续运行
  3. 中断处理已优化，不会导致串口监视器卡顿
  4. 使用433MHz功能时，请遵守当地无线电管理规定

技术支持

如有问题或需要技术支持，请联系项目维护人员。