softbus_OPC/docs/edge_device_setup.md

Edge 设备配置指南

配置目录

目录	用途
config/edge/	边缘设备本地配置（物理层 + 可选本地绑定子集）
config/daemon/	核心守护进程配置（逻辑点、全局绑定、OPC 主题规则）

双域配置

文件	目录	职责
edge.json	config/edge/	edge 入口：uplink 地址、子配置文件路径
physical_channels.json	config/edge/	串口/网络接口
physical_devices.json	config/edge/	从站、寄存器、物理点 ID
bindings_local.json	config/edge/	可选，本 edge 绑定子集（校验/本地调试）
logical_points.json	config/daemon/	OPC/业务语义
bindings_global.json	config/daemon/	物理点 ↔ 逻辑点 + edgeId 路由
topic_rule.json	config/daemon/	总线主题模板
point_table.json	config/daemon/	遗留全量点表，仅 daemon 兼容加载

edge 不加载 logical_points.json、point_table.json 或全量 bindings_global；下行命令由 daemon 解析后携带 physicalPointId 与 edgeId。

已知设备流程

1. edge：编辑 config/edge/physical_channels.json、config/edge/physical_devices.json
2. daemon：编辑 config/daemon/logical_points.json
3. daemon：编辑 config/daemon/bindings_global.json（含 edgeId、scale）
4. 启动：softbus_daemon --logical-points config/daemon/logical_points.json --bindings-global config/daemon/bindings_global.json
5. 启动：softbus_edge --config config/edge/edge.json
6. 热加载：kill -HUP <daemon-pid> 或 kill -HUP <edge-pid>

未知设备（物理先行）

1. 仅配置 physical_devices.json，物理点 ID 如 phy_modbus_s1_r40001
2. edge 启动后 daemon 收到 edge/raw/unbound/* 主题数据
3. 后补 logical_points.json 与 bindings_global.json，HUP daemon 即可打通 OPC

libmodbus

构建时自动选择：

1. 系统包（优先）：sudo apt install libmodbus-dev
2. vendor（默认回退）：third_party/libmodbus v3.1.10 静态编译进 softbus_edge

强制使用 vendor：

cmake -B build -DSOFTBUS_FORCE_VENDOR_LIBMODBUS=ON
cmake --build build

串口权限：sudo usermod -aG dialout $USER 后重新登录。

Mock 模式

./build/bin/softbus_edge --config config/edge/edge.json --mock