事件与监控

该服务通过端口10020 上的专用只读 WebSocket推送系统事件。这些事件包括安全触发、设备连接、电池警告、会话生命周期变化以及控制速率异常。

默认网址： ws://localhost:10020

事件JSON结构

                
{
  "name": "device-safety-triggered",
  "category": "device",
  "level": "warning",
  "data": { "device_family": "inverse", "device_id": "049D", … },
  "message": "FOD stage changed: guard -> hard"
}

现场	类型	说明
name	字符串	稳定的事件标识符（用于过滤/切换）
category	字符串	device, session, system
level	字符串	info, notice, warning, error, critical, panic
data	对象	特定事件的有效载荷
message	字符串	通俗易懂的描述

活动类型

设备事件

名称	级别	何时
device-connected	info	检测到新设备，已准备就绪
device-disconnected	warning	设备已丢失（已断开连接或超时）
device-battery-low	warning	无线VerseGrip电池电量低于阈值
device-battery-critical	error	电量极低
device-sleep	info	无线 VerseGrip 已进入待机模式
device-busy	warning	该设备正在被另一个会话使用
device-connection-loop	warning	检测到端口上出现反复的连接/断开循环

安全事件

名称	级别	何时
device-safety-triggered	warning	安全通知（见下文）
device-calibration-failed	warning	墨水壶校准已触发，但笔无法使用

device-safety-triggered 子类型

(《世界人权宣言》) safety_type 事件数据中的该字段说明了发生了什么：

safety_type	级别	含义
ebrake_triggered	error	紧急制动已启动 — 设备已锁定
ebrake_released	notice	紧急制动已解除
fod_stage_changed	warning / info	FOD安全阶段已跨越低/高风险界限
stall_detected	warning	检测到电机失速
stability_ceiling	warning	已达到稳定性上限

device-calibration-failed 原因

reason	含义
pen_not_connected	没有根本没有连接任何诗句握柄
pen_asleep	无线Verse握把已配对，但处于休眠模式
pen_not_attached	Verse 握把已就绪，但霍尔传感器读数低于阈值

会话事件

名称	级别	何时
session-started	notice	已建立一个 WebSocket 会话
session-stopped	notice	WebSocket 会话已被终止
device-low-control-rate	warning	会话的控制率已降至推荐阈值以下
device-critical-control-rate	error	控制率已降至临界水平

系统事件

名称	级别	何时
system-rate-report	info	主循环定时器周期性报告

关注动态

请参考“事件”教程，获取一个可直接运行的 Python 监听器，该监听器支持按级别、名称模式和排除条件进行过滤：

                
# All events
python 10-haply-inverse-events.py

# Only warnings and above
python 10-haply-inverse-events.py --level warning

# Only device events
python 10-haply-inverse-events.py --name "device-*"

# Exclude battery noise
python 10-haply-inverse-events.py --exclude "*battery*"