┌──────────────────────────────────────────────────────────────────────┐
│  上行：传感器数据 → 终端节点 → ZigBee → 协调器 → 串口 → 智云平台 → 上位机  │
│  下行：控制命令 → 上位机 → 智云平台 → 串口 → 协调器 → ZigBee → 终端节点      │
└──────────────────────────────────────────────────────────────────────┘

QianRuShi-main/
├── README.md                           # 项目说明
├── 使用与实验开展指南.md                # 👈 本文档
├── 通信接口说明.md                      # 通信协议与字段定义
├── 智云平台测试命令手册.md              # 智云命令速查
├── 接线说明_安防传感器节点.md           # Sensor-C 硬件接线
├── 测试报告_安防传感器.md               # 驱动测试报告
├── D部分通信协议与ZigBee任务说明.md     # 通信层任务说明
├── D部分通信协议与ZigBee完成说明.md     # 通信层完成说明
└── zstack-2.4.0-1.4.0x/
    ├── Projects/zstack/Samples/
    │   ├── common/                      # 公共协议层 (ZXBee)
    │   │   ├── zxbee.h/c               # 协议核心（帧构建/解析/校验）
    │   │   ├── zxbee-inf.h/c           # ZigBee 收发接口
    │   │   └── ...
    │   ├── sensor-a/                    # 环境采集节点 (601, addr=0x0001)
    │   │   ├── CC2530DB/sensor-a.eww   # IAR 工程
    │   │   └── Source/
    │   │       ├── sensor.c             # 主程序 (temp/humi/lux)
    │   │       ├── htu21d.c/h          # 温湿度传感器 (I²C)
    │   │       ├── bh1750.c/h          # 光照传感器 (I²C)
    │   │       └── ...
    │   ├── sensor-b/                    # 控制执行节点 (602, addr=0x0002)
    │   │   ├── CC2530DB/sensor-b.eww   # IAR 工程
    │   │   └── Source/
    │   │       ├── sensor.c             # 主程序 (unlock/buzz/rgb/alert)
    │   │       ├── rgb.c/h              # RGB 灯驱动
    │   │       ├── beep.c/h             # 蜂鸣器驱动
    │   │       └── relay.c/h            # 继电器/门锁驱动
    │   ├── sensor-c/                    # 安防检测节点 (603, addr=0x0003)
    │   │   ├── CC2530DB/sensor-c.eww   # IAR 工程
    │   │   └── Source/
    │   │       ├── sensor.c             # 主程序 (pir/tch/door/alert...)
    │   │       ├── infrared.c/h         # PIR 人体红外
    │   │       ├── hall.c/h             # 霍尔门磁
    │   │       ├── vibration.c/h        # 震动
    │   │       ├── Touch.c/h            # 触摸按键
    │   │       ├── Flame.c/h            # 火焰
    │   │       ├── gpio_int.c/h         # GPIO 中断配置
    │   │       ├── security_logic.c/h   # 安防逻辑（徘徊检测/夜间判断）
    │   │       └── ...
    │   └── Coordinator/                  # 协调器工程 (000, addr=0x0000)
    │       └── CC2530DB/Coordinator.eww
    └── ...

          ┌─────────────────┐
          │   协调器 (000)   │ ◄── 串口 ──► 智云平台 / 上位机
          └────┬──┬──┬──────┘
               │  │  │           ZigBee 无线网络 (2.4GHz)
      ┌────────┘  │  └─────────────────┐
      ▼           ▼                     ▼
┌──────────┐ ┌──────────┐         ┌──────────┐
│ sensor-a │ │ sensor-b │         │ sensor-c │
│  601     │ │  602     │         │  603     │
│ 环境采集 │ │ 控制执行 │         │ 安防检测 │
└──────────┘ └──────────┘         └──────────┘

┌──────┬──────┬──────┬──────┬──────┬────────────┬──────┬──────┐
│ SOF  │ DST  │ SRC  │ CMD  │ LEN  │   PAYLOAD  │ CHK  │ EOF  │
│ 1B   │ 2B   │ 2B   │ 1B   │ 1B   │    N B     │ 1B   │ 1B   │
└──────┴──────┴──────┴──────┴──────┴────────────┴──────┴──────┘
  0xAA  (大端) (大端)              JSON内容     累加和   0x55

SOF  DST        SRC        CMD  LEN  PAYLOAD                                        CHK   EOF
AA   00 00      00 01      01   17   7B 22 74 65 6D 70 22 3A 32 37 2E 30 2C 22 68 75 6D 69 22 3A 36 35 2E 30 7D   ??    55
     └─ 目的=协调器(0x0000)  └─ 源=sensor-a(0x0001) └─ 上报命令     └─ {"temp":27.0,"humi":65.0}

AA   00 02      00 00      03   0F   7B 22 75 6E 6C 6F 63 6B 22 3A 31 7D              ??    55
     └─ 目的=sensor-b(0x0002)  └─ 源=协调器(0x0000)  └─ 写入命令     └─ {"unlock":1}

CC2530 引脚    传感器/模块        信号方向
──────────────────────────────────────────
P1.7 (SDA) ──► HTU21D / BH1750   ◄──► I²C 数据线 (双向)
P1.6 (SCL) ──► HTU21D / BH1750   ──► I²C 时钟线 (CC2530输出)
VCC 3.3V   ──► 所有模块           ──  3.3V 供电
GND        ──► 所有模块           ──  共地

CC2530 引脚    执行器              信号方向    功能
──────────────────────────────────────────────────
P0.0 ───────► RGB_R (红色)        ◄──         GPIO 推挽输出
P0.1 ───────► RGB_G (绿色)        ◄──         GPIO 推挽输出
P0.2 ───────► RGB_B (蓝色)        ◄──         GPIO 推挽输出
P0.3 ───────► 蜂鸣器              ◄──         GPIO (低电平触发/高电平触发，看模块)
P0.6 ───────► 继电器1 (门锁)       ◄──         GPIO 推挽输出
P0.7 ───────► 继电器2 (报警灯)      ◄──         GPIO 推挽输出 (可选)
VCC 3.3V/5V ─► 所有模块           ──         供电 (继电器注意 5V 供电)
GND        ──► 所有模块           ──         共地

CC2530 引脚    传感器              信号方向    说明
──────────────────────────────────────────────────
P0.0 ──────── PIR 人体红外 / 触摸  ◄──         *Mode=1: PIR；Mode=2: 触摸*
P0.1 ──────── 震动模块             ◄──         低电平触发
P0.2 ──────── 霍尔门磁             ◄──         有磁场=低，无磁场=高
P0.3 ──────── 火焰传感器           ◄──         有火焰=低
P0.4 (AIN4) ─ 可燃气体 (ADC)       ◄──         模拟量输入 (0~3.3V)
P0.5 ──────── 光栅模块             ◄──         有人=低
P0.6 ──────── 继电器1              ◄──►        本地告警输出 (可选)
P0.7 ──────── 继电器2              ◄──►        本地告警输出 (可选)
VCC 3.3V/5V ─ 所有模块             ──          供电 (传感器一般 3.3V)
GND        ── 所有模块             ──          共地

1. 打开 IAR Embedded Workbench
2. File → Open → Workspace
3. 选择路径：zstack-2.4.0-1.4.0x\Projects\zstack\Samples\sensor-a\CC2530DB\sensor-a.eww
4. Workspace 窗口中确认目标为 CC2530DB
5. Project → Rebuild All (或按 F7)
6. 等待编译完成，底部 Build 窗口无 Error 即可
7. 编译输出：sensor-a\CC2530DB\Exe\sensor-a.hex

1. 将 CC Debugger 连接到 CC2530 开发板的 Debug 接口
2. 将 CC Debugger 通过 USB 连接电脑
3. CC Debugger 上的 LED 应变为 **绿色**（红灯表示未识别到目标板）
4. IAR 中：Project → Download and Debug (或按 Ctrl+D)
5. 等待烧录完成，程序自动进入调试模式
6. 按 F5 全速运行 → 观察节点是否入网（绿灯常亮）
7. 完成后点击 Stop Debugging (Shift+F5)，程序会继续在板上运行

1. 连接 CC Debugger → CC2530 板 → 电脑
2. 打开 SmartRF Flash Programmer
3. 左侧选择目标板 (System-on-Chip → CC2530)
4. Flash image 选择编译好的 .hex 文件
5. 勾选 Erase + Program + Verify
6. 点击 "Perform Actions"
7. 烧录完成后移除调试器，重新上电即可运行

┌──────────────┐        ┌──────────────┐        ┌──────────────┐
│ 协调器 CC2530 │  UART  │ USB 转串口模块 │  USB   │ 电脑（智云平台）│
│   (节点 000)  │ ◄────► │  (CH340G 等)   │ ◄────► │  上位机软件     │
└──────────────┘  38400  └──────────────┘        └──────────────┘
         │
         │ ZigBee 无线
         ▼
   [其它终端节点]

1. 连接协调器 CC2530 → USB 转串口 → 电脑
2. 协调器上电，观察 LED（约 2 秒后红灯常亮 = 网络建立）
3. sensor-a 节点上电（HTU21D + BH1750 已接线）
4. 观察 sensor-a 的 LED，红灯常亮 = 入网成功

1. 打开智云平台，确认设备在线
2. 查看"实时数据"窗口
3. 每 30 秒（默认）应出现一次 sensor-a 的数据
4. 预期数据格式：{"temp":27.0,"humi":65.0,"lux":200}
5. 用手捂住 HTU21D，观察 temp 和 humi 数值是否变化
6. 用手电筒照射 BH1750，观察 lux 数值是否增大

1. 发送 {V0=10} 到 sensor-a
   → 预期：上报周期改为 10 秒
2. 观察实时数据窗口
   → 预期：数据刷新频率提高到约 10 秒一次
3. 发送 {V0=30} 恢复默认

1. sensor-c 上电，等待入网（红灯常亮）
2. 人离开传感器 3 米以上，静止 10 秒
   → 智云平台显示 {pir:0}
3. 人走向 PIR 传感器，距离约 1~2 米，做挥动手臂动作
   → 智云平台应立即显示 {pir:1}
4. 人离开，静止 2 秒后
   → pir 应恢复为 0
5. 重复 5 次，记录检测成功率

1. 将霍尔模块放在桌上，磁铁远离
   → 智云平台显示 {door:1} (无磁场=开门状态)
2. 将磁铁贴近霍尔模块（距离 < 1cm）
   → 智云平台应立即显示 {door:0} (有磁场=关门状态)
3. 将磁铁快速移开
   → door 应立即恢复为 1
4. 重复 10 次（磁铁靠近→远离），记录误判次数

1. 将震动模块安装在一个硬纸板上（模拟门扇）
2. 保持静止
   → {tch:0} (A1=0)
3. 用手指轻敲纸板 1 次
   → 应立即显示 {tch:1} 一次，随后恢复 0
4. 连续快速敲击 3 次（< 100ms 间隔）
   → 应合并为一次事件上报（去抖机制生效）
5. 调节震动模块上的电位器，测试灵敏度：
   → 顺时针旋转：更灵敏（轻微震动即触发）
   → 逆时针旋转：更迟钝（需要较大震动才触发）

1. 人靠近 PIR → 同时用磁铁移开霍尔 → 同时敲击震动模块
2. 观察智云平台的上报顺序与内容
   → 预期：pir, door, tch 三个字段分别正确变化
   → 预期：无数据丢失，各字段独立

1. 观察无事件时的数据刷新频率 → 30 秒一次
2. 触发 PIR（有事件）→ 立即上报（< 50ms 延迟）
3. 用秒表测量：
   - 从人靠近 PIR → 智云平台显示 pir=1 的时间差
   - 从磁铁靠近霍尔 → 智云平台显示 door=0 的时间差
   → 预期：均 < 100ms（中断模式下）

1. 发送 {unlock=1}
2. 观察智云平台是否收到 sensor-b 的上报：
   → 预期：{unlock:1, rgb:[0,255,0]}
3. 等待 4 秒
   → 预期：{unlock:0} (3秒自动关门后状态回传)

1. 在 10 秒内连续发送 10 条命令（如交替亮红、亮绿）
2. 观察：
   - 每条命令是否都被执行
   - RGB 灯是否立即响应
   - 有无命令丢失或延迟
   - 智云平台是否正确回传状态

sensor-c 内置的安防逻辑 (security_logic.c)：
  ├── PIR 检测到人 → 开始计时
  │   ├── 持续 < 10秒 → 正常 (alert=0)
  │   └── 持续 ≥ 10秒 → 徘徊 (alert=1, stay=XX秒)
  ├── night=1 (夜间模式) + door=1 → 入侵 (alert=2)
  └── alert=2 上报 → 人工或 Python 转发 alert=2 到 sensor-b → 声光告警

告警等级说明：
  0 = SAFE（安全，绿灯）
  1 = ATTENTION（注意，蓝灯）
  2 = ALARM（报警，红灯 + 蜂鸣器长响）

1. 确认系统处于白天状态（night=0，默认）
2. 在 sensor-c 的 PIR 前持续晃动或停留（模拟"有人徘徊"）
3. 观察智云平台：
   → 先显示 {pir:1}
   → 约 10 秒后显示 {stay:10, alert:1}
4. 人离开 PIR 范围
   → pir 恢复为 0，但 alert 保持 1（需手动解除）

1. 通过智云平台向 sensor-c 发送 {night=1}（启用夜间模式）
   → 预期返回 {night:1}
2. 用磁铁模拟门状态：磁铁远离霍尔 = 门被打开
   → door 变为 1
3. 观察智云平台：
   → 预期立即显示 {door:1, alert:2} (入侵！)
4. 观察/验证告警联动：
   → 方案 A (Python 转发)：Python 上位机检测到 alert=2 → 自动下发 alert=2 到 sensor-b
   → 方案 B (手动测试)：在智云平台手动发送 {alert=2} 到 sensor-b (602)
   → sensor-b 现象：RGB 红灯 + 蜂鸣器长响

1. 在 sensor-b 告警状态下（红灯 + 蜂鸣器响）
2. 向 sensor-b 发送 {reset=1}
   → 预期：蜂鸣器停止，RGB 恢复绿灯，alert 变回 0
3. 向 sensor-c 发送 {night=0}
   → 退出夜间模式，恢复白天正常状态

时间线（秒）  动作                              预期现象
────────────────────────────────────────────────────────────
 0           系统正常，所有节点在线             alert=0, RGB绿灯
10           下发 {night=1} 到 sensor-c        night=1
20           人走到 PIR 前                      pir=1
25           磁铁远离霍尔(模拟门被打开)          door=1, alert=2
26           sensor-b 开始告警                  RGB红灯 + 蜂鸣器
60           点击"解除告警"下发 {reset=1}       停止告警，绿灯
70           下发 {night=0} 到 sensor-c         恢复白天

时间 (秒)   场景动作                          系统响应与演示要点
────────────────────────────────────────────────────────────────
 0-10    【场景设置】白天，门口无人             temp/humi/lux 周期上报，所有状态=0
                                                  → 展示"环境监测"功能

10-20    【访客到访】人走到门口                PIR 检测到 pir=1 (event 上报)
                                                  → 展示"人体检测"功能
                                                  → sensor-a 继续上报环境数据

20-25    【访客按门铃】按触摸按键              tch=1 事件上报
                                                  → 展示"门铃触发"功能
                                                  → (可选) 语音播报 "叮咚，有访客"

25-40    【远程确认与开门】
          在智云平台/Python 界面点击"开门"
                                                  → 下发 {unlock=1} 到 sensor-b
                                                  → 继电器吸合 + RGB 绿灯
                                                  → 展示"远程控制"功能
                                                  → 3 秒后自动关门

40-60    【访客进入】门打开(霍尔状态变化)       door=1 → door=0
          人进门，停止在门前徘徊
                                                  → (可选) 停留 < 10 秒，无告警
                                                  → 展示"门磁检测"功能

60-70    【访客离开】人走出门口                 pir=0, door=0→1→0
                                                  → 系统恢复空闲状态
                                                  → 记录一次"访客事件"

70+     【系统日志】智云平台查看数据历史        temp/humi/lux 图表 + 事件时间线
                                                  → 展示"数据记录"功能

时间 (秒)   场景动作                          系统响应与演示要点
────────────────────────────────────────────────────────────────
 0        【设置夜间模式】下发 {night=1}       night=1 (模拟深夜 02:00)

10        【模拟入侵】磁铁远离霍尔              door=1 → 立即触发 alert=2
                                                  → 展示"入侵检测"功能
                                                  → (联动) sensor-b 红灯 + 蜂鸣器长响
                                                  → 智云平台显示红色告警提示

20        【解除告警】点击"解除告警"按钮        下发 {reset=1} 到 sensor-b + sensor-c
                                                  → 蜂鸣器停止，RGB 恢复绿灯
                                                  → alert 变回 0
                                                  → 展示"告警管理"功能

30        【恢复白天模式】下发 {night=0}       night=0
                                                  → 系统恢复正常