筛选条件
该服务会在出站流量到达
设备之前对其应用一系列过滤器。每个过滤器均可按会话进行配置(通过 configure 或 HTTP)或
整体上(通过 参数).
过滤器管道
力依次经历以下阶段:
your force → [osc-damper] → [force-gate] → [damping] → [force-scale] → device
| Étape | 角色 | Portée | 配置 |
|---|---|---|---|
| Osc-damper | 检测振荡并降低增益 | 按外设(自动) | 内部 — 用户无法配置 |
| 强行门 | 在检测到振荡时减弱振幅 | 每节课 | configure.force_gate ou config/filters/force_gate |
| 摊销 | 添加粘性阻力(标量和/或方向性) | 每节课 | configure.damping ou config/filters/damping |
| 力级 | 应用于所有力的全局乘数 | 全球 | POST /settings → devices/force_scale |
阻尼功能需要固件版本 7.5 或更高版本
在低于 7.5 版的设备固件上,一个请求 POST/DELETE vers config/filters/damping 转回 HTTP 422 与某项活动 device-protocol-unsupported (而此前,它会返回一个静默的 200 状态码,从而忽略写入操作)。请将设备的固件升级至 7.5 版或更高版本,或处理 422 状态码。
安全航迹
安全轨迹是一种滤波器,其 模式位置 : 限制光标速度
当使用 set_cursor_position,这确保了向
目标的平稳移动。
| 参数密钥 | 默认值 | 说明 |
|---|---|---|
features/safe_trajectory/enabled | false | 启用位置流量限制 |
features/safe_trajectory/max_vel | 0.5 | 光标最大速度(米/秒) |
通过设置进行配置:
curl -X POST http://localhost:10001/settings \
-H "Content-Type: application/json" \
-d '{"features/safe_trajectory/enabled": true, "features/safe_trajectory/max_vel": 0.3}'