实时计数穿越围栏的绵羊，并将 进/出/在栏 数量发送到您的手机和 Home Assistant 看板——即使在没有 WiFi 的牧场也能正常工作。
| 设备 | 用途 |
|---|---|
| reCamera 2002 | 运行 YOLO 绵羊检测和穿越计数程序 |
| XIAO ESP32-S3 + Wio-SX1262 | LoRa 发射节点（Meshtastic 固件） |
| reComputer R1100 / 树莓派 | 网关——将 LoRa 消息桥接到 MQTT 和 Home Assistant |
部署后您将获得：
前提条件： reCamera 通过 USB 或以太网连接 · XIAO ESP32-S3 + Wio-SX1262 LoRa 板 · 在本地网络上运行 Home Assistant 的 reComputer 或树莓派
将绵羊计数程序部署到 reCamera，开机自动启动。
/dev/ttyS3）：
192.168.42.1）和 SSH 密码| 问题 | 解决方案 |
|---|---|
| SSH 连接失败 | 检查连接线缆；如果密码 recamera 无效，请尝试 recamera.2 |
| 计数器立即退出 | 检查 /var/log/sheep_counter.log，然后执行 /etc/init.d/S85sscma-keepalive restart |
| 2 分钟后仍无日志输出 | 确认 SSCMA 推理守护进程正在运行：/etc/init.d/S85sscma-keepalive start |
| XIAO 未收到 UART 事件 | 确认 XIAO 与 reCamera 共用 GND；检查 /dev/ttyS3 接线 |
部署会停止 reCamera 默认的 Node-RED 服务。部署完成后，通过 SSH 登录摄像头并查看日志，确认程序正在运行：
ssh recamera@192.168.42.1
tail -f /var/log/sheep_counter.log
当羊只穿越围栏线时，您应能看到类似 EVT,IN,1,0,1,123 的事件出现。
为 XIAO ESP32-S3 刷写 Meshtastic 固件，并将其配置为串口 + 检测传感器节点。
115200 → 接收模式：透传490 → 高电平检测 → 告警消息前缀：SHEEPSheepGate1）以便在网格中识别| 问题 | 解决方案 |
|---|---|
| 刷写工具无法检测到 XIAO | 插入 USB 时按住 BOOT 键；端口出现后松开 |
| 网格中无消息 | 检查 RF 频率是否与所有网格节点一致；确认频道预设相同 |
| 串口数据乱码 | 确认 XIAO 串口模块和 reCamera UART 的波特率均为 115200 |
| GPIO 告警未触发 | 验证 sheep_counter 二进制文件在每次穿越时是否向 GPIO 490 发送 ~0.5 秒脉冲 |
配置完成后，短暂将 GPIO 490 拉高来触发一次测试穿越。您应该能看到：
EVT,IN,... 数据作为文本消息出现在您的 Meshtastic 频道中将桥接服务部署到本地网关电脑，把 LoRa 收到的羊只计数通过 MQTT 发布到 Home Assistant。
开始部署前，请确认 Home Assistant 已在局域网中运行，且 MQTT 集成已连接到同一 Broker 并启用自动发现。部署表单中需要填写网关 SSH 连接、MQTT Broker IP 和 Meshtastic 接收器串口。
| 问题 | 解决方案 |
|---|---|
| meshtastic-bridge 无法启动 | 确认 Meshtastic USB 无线电已插入网关；检查 journalctl -u meshtastic-bridge |
| ha-bridge 连接失败 | 确认 MQTT Broker IP 的 1883 端口可达，且允许网关连接 |
| 无 MQTT 消息 | 检查 MQTT Broker IP 是否正确，以及 Broker 是否接受 1883 端口的匿名连接 |
| 重启后服务停止 | 执行 systemctl enable meshtastic-bridge ha-bridge 重新启用 |
部署完成后，验证 systemd 服务是否正常：
ssh recomputer@<网关-ip>
systemctl status meshtastic-bridge ha-bridge
两者均应显示 active (running)。
将 ha_dashboard.yaml 导入 Home Assistant：
assets/gateway/ha_dashboard.yaml 复制到 HA 配置目录（如果网关脚本已部署，也可使用 /opt/sheep-gateway/ha_dashboard.yaml）整个系统现已运行。点击下方链接打开 Home Assistant 绵羊计数看板，确认实时计数正常更新。
| 问题 | 解决方案 |
|---|---|
| 看板页面无数据 | 确认 ha-bridge 正在运行、HA 已启用 MQTT 自动发现，且 sensor.sheep_* 实体已出现 |
| 计数未更新 | 手动触发一次穿越；通过 mosquitto_sub -t sheep/# -v 检查 MQTT 流量 |
| HA 实体显示"不可用" | 重新导入 ha_dashboard.yaml 并重启 ha-bridge 服务 |
您的绵羊计数器已上线！看板将显示：
/var/log/sheep_counter.log 中出现的 EVT,IN,... 日志行HB 消息）可在无线电中断后保持显示同步