YCBox 驱动功能设计

YCBox 驱动是 EasyPro 平台用于接入源创自研 YCBox 网关的驱动。YCBox 是一类边缘网关设备，下接各类传感器与执行器，将采集数据通过 MQTT 协议上报到平台云。

YCBox 驱动采用物模型（Thing Model）建模——网关上报的不仅是数据值，还有完整的设备结构（产品/设备/属性），平台据此自动创建设备类型、设备与点位。这是它与通用 MQTT 驱动的核心区别。

YCBox 物模型采用清晰的四层结构，网关上报时按此结构组织数据：

物模型属性（Identifier.type）映射为平台点位的数据类型：

方法名：thing.service.subDevice.property.set / thing.service.batch.property.set。

同 MQTT 驱动，YCBox 维护一个共享 Paho 客户端。入站消息经 MqttMessagePipLine 分发给 10 个 handler，每条消息在独立虚拟线程处理：

YCBox 网关接入是「两步式」：网关先自荐，用户确认后平台异步拉取完整物模型建实例：

YCBox 网关以批量方式上报属性——一次消息包含多个设备多个属性的最新值，平台 BatchPropertyHandler 解析后批量推送入库。相比单条上报，批量大幅减少消息数与处理开销。

平台下发控制（issuePointValue）时，构建 BatchSet JSON 发布到 /sys/{gateway}/batch/property/set：

与 MQTT 驱动结构一致，存在 iot_driver_config：

实例属性由驱动在导入时自动填充：

YCBox 点位由设备名 + 标识编码唯一定位，唯一码格式：

# 点位唯一码
<...>&&deviceName&&identifierCode

另外，点位的 OrgName 属性保存产品名（编码网关与产品信息）。

调用路径前缀：POST /driver/api/ycbox/{mapping}。