远程管理接口
工程师电脑上的 IDE 远程管理面板连现场 Darra.PLC.Service 的 RemoteAccessServer。通道固定 HTTPS 18443,端口硬编码,界面不可改。鉴权是 API Key + JWT,速率 100 req/s。
运维只走产品自带通道:主数据面 DarraLink 18821,本页管理面 18443。不要用 RDP / SSH / VNC / Telnet。本页是该 HTTPS 通道上已发布的状态、诊断、启停与变量写入。
确认报警
RemoteAccessServer.AcknowledgeAlarm · 可执行
确认指定活动报警。
签名
POST /api/alarms/{id}/ack
参数
idint- 报警编号。
返回值
returnjson- 确认结果。
行为
- 报警不存在或已经确认时返回 404。
- 与 HMI 报警页同一
AlarmManager单源,不另建缓存。
错误与限制
404:编号不存在或已确认。
示例
POST /api/alarms/12/ack
读取活动报警
RemoteAccessServer.GetAlarms · 可执行
读取当前活动报警。
签名
GET /api/alarms
参数
无参数。
返回值
returnjson- 报警数量和报警列表。
行为
- 列表是请求时刻快照。
- 空列表表示当前无活动报警。
错误与限制
- 未声明额外错误码。
示例
GET /api/alarms
读取系统诊断
RemoteAccessServer.GetDiagnostics · 可执行
读取现场运行进程和设备资源的诊断摘要。
签名
GET /api/diagnostics
参数
无参数。
返回值
returnjson- CPU、内存、磁盘、网络与请求统计。未探测项带 *Probed=false,不得当成已隔离或已连接。
行为
- 只读,不改变运行状态。
- 资源真伪与 profile 标签按现场机器角色显示,不隐藏。
错误与限制
- 未声明额外错误码。
示例
GET /api/diagnostics
读取运行日志
RemoteAccessServer.GetLogs · 可执行
读取最近的 Service 日志。日志在 Service 可执行文件同目录 logs/service_*.log。
签名
GET /api/logs?count=100&level=all
参数
countint- 最多返回的日志行数。
levelstring- 日志级别筛选;all 表示不过滤。
返回值
returnjson- 日志行数和日志内容。
行为
- 最多返回 500 行。
- 只读现场 Service 日志,不是 IDE 日志。
错误与限制
- 超出 500 的 count 被截到上限。
示例
GET /api/logs?count=50&level=error
读取 PLC 诊断
RemoteAccessServer.GetPlcDiagnostics · 可执行
读取扫描次数、错误数和周期时间统计。
签名
GET /api/plc/diagnostics
参数
无参数。
返回值
returnjson- scanCount、errorCount、周期百分位 p50/p95/p99、通讯质量。isolatedCoresProbed=false 时 isolatedCores 不是已隔离证明。
行为
- 运行时尚未就绪时返回 503。
- HTTP 200 不等于硬实时隔离已通过。
错误与限制
503:PLCDiagnostics未在 ServiceRegistry 就绪。
示例
GET /api/plc/diagnostics
启动 PLC
RemoteAccessServer.StartPlc · 可执行
按受控启动流程连接设备并启动 PLC 扫描。经 RuntimeHost 强类型回执确认最终态。
签名
POST /api/plc/start
参数
无参数。
返回值
returnjson- 启动回执和最终运行状态。回执成功才算已启动。
行为
- 要求操作员权限。
- 运行时未就绪或安全条件不满足时拒绝启动。
- 不打开 RDP / SSH,不改端口。
错误与限制
- 非 operator 角色拒绝。
- 安全条件不满足时拒绝,不伪造成功。
示例
POST /api/plc/start
停止 PLC
RemoteAccessServer.StopPlc · 可执行
按受控停机流程停止 PLC 扫描并处理输出。
签名
POST /api/plc/stop
参数
无参数。
返回值
returnjson- 停机回执和最终运行状态。
行为
- 要求操作员权限。
- 输出行为遵循项目停机策略(通常 Q 区清零)。
- 远程急停复位
/api/plc/clear-estop在强审计确认合同落地前固定拒绝。
错误与限制
- 非 operator 角色拒绝。
示例
POST /api/plc/stop
扫描现场设备
RemoteAccessServer.ScanDevices · 可执行
扫描指定 IPv4 子网中的可发现设备。走 DeviceScannerService,不是 L2 Discovery 帧。
签名
GET /api/scan?subnet=192.168.3
参数
subnetstring- IPv4 子网前三段。省略时用本机第一个非环回 IPv4 的前三段。推断失败不默认 192.168.1。
返回值
returnjson- 子网、设备数量和设备列表。deviceCount=0 不等于扫描成功。
行为
- 扫描超时由服务端控制。
- 空目录不是健康态。
- 同广播域裸机发现走 L2 EtherType
0x88B5+ Magic0xDA53,不走本 HTTP。
错误与限制
503:DeviceScannerService未就绪,扫描未发出。
示例
GET /api/scan?subnet=192.168.3
读取运行状态
RemoteAccessServer.GetStatus · 可执行
读取 PLC、IO、运动与扫描周期的当前状态。
签名
GET /api/status
参数
无参数。
返回值
returnjson- 当前运行状态与采样时间。
行为
- 用于监控页刷新,不改变设备状态。
- 运行态权威在 Service
IRuntimeStateService,本接口是只读镜像。
错误与限制
- 未声明额外错误码。
示例
GET /api/status
读取变量
RemoteAccessServer.GetVariable · 可执行
按 PLC 地址或变量名读取当前值。
签名
GET /api/variables/{address}
参数
addressstring- PLC 地址或变量名。
返回值
returnjson- 变量地址、当前值和数据类型。
行为
- 变量不存在时返回 404。
- 读的是过程映像当前值,不是 Historian。
错误与限制
404:变量不存在。
示例
GET /api/variables/DB1.Speed
提交变量写入
RemoteAccessServer.SubmitVariableWrite · 可执行
把变量写入请求提交到下一扫描边界。202 只表示已入队。
签名
POST /api/variables/{address}
Body: { "value": 1500 }
参数
addressstring- PLC 地址或变量名。
valueobject- 请求体中的目标值。
返回值
returnjson- 202 含 transactionId 与 GET /api/variable-writes/{transactionId} 查询路径。
行为
- 要求操作员权限。
- 必须续查最终扫描结果,禁止把 202 当写入完成。
- 写入在扫描边界提交,不旁路 Force 安全门。
错误与限制
- 非 operator 角色拒绝。
- 变量不存在或类型不匹配拒绝入队。
示例
POST /api/variables/DB1.Speed
Content-Type: application/json
{ "value": 1500 }
查询写入结果
RemoteAccessServer.GetVariableWriteReceipt · 可执行
查询一次已提交变量写入的最终扫描结果。
签名
GET /api/variable-writes/{transactionId}
参数
transactionIdlong- 提交写入时返回的事务编号。
返回值
returnjson- 待处理、已提交、已拒绝或已过期状态。
行为
- 查询不会重复提交写入。
- 事务未知返回对应失败态,不假装已写入。
错误与限制
- 非法 transactionId 拒绝。
示例
GET /api/variable-writes/42