cap_system — 系统信息与设备重启
源码:cap_system.c · 头文件:cap_system.h
cap_system 提供设备运行状态的统一查询入口,并提供可控的重启动作。它属于可被 LLM 直接调用的系统级工具组,适合用于设备诊断、健康检查和远程恢复。
暴露给 LLM 的工具
Section titled “暴露给 LLM 的工具”| 工具 ID | 功能 | 输入参数 |
|---|---|---|
get_system_info | 返回系统汇总(芯片、内存、CPU、Wi-Fi、IP、uptime) | (无) |
get_memory_info | 返回内存信息(内部内存、heap、PSRAM) | (无) |
get_cpu_usage | 返回 CPU 使用率与运行时统计信息 | (无) |
get_wifi_info | 返回当前 Wi-Fi 连接信息(SSID、RSSI、信道等) | (无) |
get_ip_address | 返回当前站点 IP / netmask / gateway | (无) |
restart_device | 安排设备延迟重启 | delay_ms(可选,毫秒) |
返回结构说明
Section titled “返回结构说明”get_system_info会组合多个子结构:memory、cpu、wifi、ip。get_cpu_usage在未启用 FreeRTOS 运行时统计时,返回supported: false与说明消息。get_wifi_info/get_ip_address在未连网时会返回connected: false与空值字段。
restart_device 行为
Section titled “restart_device 行为”delay_ms可选,0或省略时使用默认延迟。目前,默认延迟为 500ms。- 重启是异步安排的:工具会先返回成功结果,再由后台任务执行
esp_restart()。 - 失败时会返回
ok: false和错误码字符串。
示例:
可能返回: