跳到主要内容

REST/HTTP API

Limelight OS 具有一个运行在 (ipaddress):5807 的 REST/HTTP 服务器

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

注意:例如 http://(limelight-ip-address):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/upload-fieldmap上传场地地图。在请求体中发送 JSON 数据。可选包含 'index' 参数
POST/upload-python上传 Python 代码。在请求体中以纯文本发送代码。可选包含 'index' 参数
POST/upload-nn上传神经网络。包含 'type' 参数("detector" 或 "classifier"),文件内容在请求体中,可选包含 'index' 参数
POST/upload-nnlabels上传神经网络标签。包含 'type' 参数("detector" 或 "classifier"),文件在请求体中,可选包含 'index' 参数
GET/getsnapscriptnamesSnapScriptPro 名称列表

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' 参数