模拟设备快速开始
云桩通帮助您在无需真实充电桩与负载的情况下，于物联网平台创建虚拟充电桩，对接自有充电平台完成协议联调。支持云快充 1.6与 OCPP 1.6-J 单设备调试；海量设备压测见 设备压测。
为什么需要模拟设备
在充电桩业务开发中，若每次测试都依赖真实桩体与耗电量，联调周期会被严重拉长。云桩通提供协议级模拟能力，让开发、测试与运维人员在控制台完成连接、充电流程与报文级排查。
协议支持情况
| 协议 | 模拟设备调试 | 模拟设备压测 |
|---|---|---|
| 云快充 1.6 | ✅ | ✅ |
| OCPP 1.6-J | ✅ | ✅ |
云快充协议字段说明可参考 云快充协议文档。
快速上手（5 步）
步骤 1：创建虚拟设备配置
打开控制台 虚拟设备 → 设备模拟 → 虚拟设备配置，点击 新增，选择协议，填写枪数量、电气参数等。
主要配置项
| 配置项 | 说明 |
|---|---|
| 协议 | YKC1.6：云快充 1.6；OCPP1.6-J：OCPP 1.6 JSON over WebSocket |
| 枪数量 | 模拟充电枪数量 |
| 固件版本 | YKC 对应 0x01 程序版本；OCPP 对应 BootNotification.firmwareVersion |
| 桩类型 | 快充 / 慢充（快充含 SoC 与 BMS 相关上报） |
| 工作电流 / 电压 / 温度 | 充电过程中上报的电气量 |
| 充满时间 | 远程启动订单后触发充满自停的时长 |
| 心跳间隔 / 状态间隔 | OCPP 心跳与 StatusNotification 周期（OCPP 配置区） |
| 即插即充 | OCPP 是否启用 Plug and Charge 行为 |
步骤 2：创建虚拟设备
打开 虚拟设备 → 设备模拟 → 虚拟设备管理，点击 新增，填写：
| 字段 | 说明 |
|---|---|
| 设备 ID | 平台侧识别的桩编号（唯一） |
| 服务器 IP / 端口 | 目标充电平台协议服务地址 |
| 协议类型 | 与配置一致 |
| 设备配置 | 选择步骤 1 创建的配置 |
| 路径 | OCPP 必填 WebSocket 路径 |
| 启用 SSL | OCPP 可选；支持单向 TLS 或 mTLS |
步骤 3：进入设备详情
在虚拟设备列表中点击设备名称进入详情页，可查看设备 ID、协议、连接地址、连接状态等。
步骤 4：启动设备并模拟插枪
未连接时点击 启动设备，平台将按配置拉起模拟实例（约数秒后刷新为「已连接」）。在 充电枪状态 表格中可切换 插枪 / 拔枪，查看枪状态与充电状态。
步骤 5：订阅实时报文
设备 已连接 后，页面底部 原始交互报文 区域可：
- 订阅最新：只看最新交互报文（推荐日常调试）
- 订阅所有：完整流量
- 清空：清除当前日志区
设备操作（在线可用）
设备在线后，点击 设备操作 打开侧栏，可进行：
| 功能 | 说明 |
|---|---|
| 申请充电 | 模拟刷卡或 VIN 即插即充；支持单枪 / 双枪并充 |
| 异常模拟 | 选择异常码模拟故障上报 |
| 清除异常 | 恢复异常状态 |
| 发送报文 | 发送自定义协议报文（高级调试） |
云快充计费模板（YKC）
云快充设备在线并收到平台下发的计费模型（0x58 / 0x0A）后，详情页会展示 计费模板：模型编号、尖峰平谷费率、分时时段等，便于核对平台计费下发是否正确。
与压测的关系
| 能力 | 模拟设备（本文） | 海量设备压测 |
|---|---|---|
| 适用场景 | 单桩联调、报文排查 | 万级连接、容量评估 |
| 运行方式 | 控制台一键启停 | 用户侧 Agent + 压测计划 |
| 文档 | 本文 | 设备压测 |
常见问题（FAQ）
支持哪些充电协议？
云快充 1.6 与 OCPP 1.6-J 均支持单设备模拟调试与海量设备压测，见 压测文档。
OCPP 设备需要填哪些额外字段？
除 IP、端口外必须填写 WebSocket 路径；若平台要求加密，可启用 SSL，并配置客户端证书 / 根证书（mTLS 或单向 TLS）。
如何模拟刷卡或远程启动充电？
设备在线后点击 设备操作，选择刷卡或 VIN，填写卡号 / VIN 与枪号后 请求充电。
如何查看与平台的通信报文？
启动设备后在详情页底部 订阅最新 或 订阅所有 报文，日志区实时滚动显示。
模拟设备与压测有什么区别？
模拟设备面向单桩协议与业务流程调试；压测通过分布式 Agent 模拟大量设备连接，用于性能与容量测试。
设备已启动但看不到报文？
确认连接状态为「已连接」，且已成功订阅；若仍无数据，检查平台是否正常响应心跳/登录。