REST/HTTP API

Limelight OS 提供了一个运行在 (ip地址):5807 的 REST/HTTP 服务器

LimelightLib Python 是一个利用 Limelight HTTP/REST API 的开源库。

注意：例如 http://(limelight-ip地址):5807/results

通用

方法	路由	描述
GET	/results	获取当前目标识别结果的完整 JSON 数据
GET	/status	获取包含温度、帧率、设备名称、流水线索引、CPU 使用率、内存使用率的 JSON 状态对象
GET	/hwreport	返回完整硬件报告的 JSON 数组。硬件报告包含人类可读的信息，如视场角、主点偏移等。

流水线管理

方法	路由	描述
GET	/pipeline-default	获取默认流水线 (JSON)
GET	/pipeline-atindex	从相机获取流水线[n] (JSON)。从磁盘加载流水线。在请求中包含 'index' URL 参数。
POST	/pipeline-switch	切换到不同的流水线。在请求中包含 'index' URL 参数。
POST	/reload-pipeline	强制相机重新加载当前流水线和所有流水线资源
POST	/update-pipeline	接受包含一个或多个设置更新的 JSON。将 URL 参数 "flush" 设置为 1 以将这些设置保存到磁盘。
POST	/upload-pipeline	上传流水线。在请求体中发送 JSON 数据。可选包含 'index' 参数。覆盖磁盘上的流水线

相机管理

方法	路由	描述
POST	/set-imumode	设置 IMU 模式 (JSON)
POST	/set-throttle	设置处理帧之间跳过的帧数，用于热管理
POST	/set-imuassistalpha	设置 IMU 辅助模式互补滤波器 alpha 值（默认 0.001）

资源管理

方法	路由	描述
POST	/upload-fieldmap	上传场地地图。在请求体中发送 JSON 数据。可选包含 'index' 参数。
POST	/upload-python	上传 Python 代码。在请求体中以纯文本形式发送代码。可选包含 'index' 参数。
POST	/upload-nn	上传神经网络。包含 'type' 参数（"detector" 或 "classifier"）、请求体中的文件内容，可选包含 'index' 参数。
POST	/upload-nnlabels	上传神经网络标签。包含 'type' 参数（"detector" 或 "classifier"）、请求体中的文件，可选包含 'index' 参数。
GET	/getsnapscriptnames	SnapScriptPro 名称列表

Python 和机器人方向

方法	路由	描述
POST	/update-pythoninputs	更新 SnapScript 流水线的 Python 输入。在请求体中发送 JSON 数据（数组）。
POST	/update-robotorientation	更新机器人方向。在请求体中发送 JSON 数据（数组）。例如 "[45,0,0,0,0,0]。使用此方法将禁用基于 NetworkTables 的方向更新，直到重启/重新启动

标定

方法	路由	描述
GET	/cal-default	返回默认标定结果
GET	/cal-file	返回自定义标定结果（文件系统）
GET	/cal-eeprom	返回自定义标定结果（eeprom）
GET	/cal-latest	返回最新的自定义标定结果。除非保存到文件系统或 eeprom，否则不会使用此结果
POST	/cal-eeprom	更新 eeprom 标定结果。在请求体中发送标定数据。
POST	/cal-file	更新文件系统标定结果。在请求体中发送标定数据。
DELETE	/cal-latest	删除最新标定结果
DELETE	/cal-eeprom	删除 eeprom 标定结果
DELETE	/cal-file	删除文件系统标定结果

快照

方法	路由	描述
POST	/capture-snapshot	捕获快照。包含 'snapname' URL 参数来命名快照。
POST	/upload-snapshot	上传命名快照。包含 'snapname' URL 参数和请求体中的图像文件。
GET	/snapshotmanifest	返回快照文件名列表
DELETE	/delete-snapshots	删除所有快照
DELETE	/delete-snapshot	删除特定快照。在请求中包含 'snapname' 参数。