イベントとモニタリング

サービスは、専用の読み取り専用のWebSocketをポート 10020 で使用して、システムイベントをプッシュします。イベントは、安全機能のトリガー、デバイスの接続、バッテリーの警告、セッションのライフサイクルの変更、制御レートの異常を通知します。

デフォルトの URL: 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	string	安定したイベント識別子（フィルタリングや切り替えに使用）
category	string	device, session, system
level	string	info, notice, warning, error, critical, panic
data	object	イベント固有のペイロード
message	string	人が読める形式の説明

イベントの種類

デバイスイベント

名前	レベル	発生条件
device-connected	info	新しいデバイスが検出され、使用可能になったとき
device-disconnected	warning	デバイスが検出できなくなったとき（取り外し、またはタイムアウト）
device-battery-low	warning	ワイヤレスVerseGripのバッテリーがしきい値を下回ったとき
device-battery-critical	error	ワイヤレスVerseGripのバッテリーが危険なレベルまで低下したとき
device-sleep	info	ワイヤレスVerseGripがスリープモードに入ったとき
device-busy	warning	デバイスが別のセッションで使用中のとき
device-connection-loop	warning	ポートで接続と切断の繰り返しが検出されたとき

安全イベント

名前	レベル	発生条件
device-safety-triggered	可変	ファームウェアからの安全通知（下記を参照）
device-calibration-failed	warning	Inkwellのキャリブレーションが開始されたが、ペンが使用できないとき

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	Verse gripが一切接続されていない
pen_asleep	ワイヤレスのVerse gripはペアリング済みだが、スリープモードになっている
pen_not_attached	Verse gripは準備完了しているが、ホールセンサーの値がしきい値を下回っている

セッションイベント

名前	レベル	発生条件
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*"