跳转到内容

cap_system — 系统信息与设备重启

源码:cap_system.c · 头文件:cap_system.h

cap_system 提供设备运行状态的统一查询入口,并提供可控的重启动作。它属于可被 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(可选,毫秒)
  • get_system_info 会组合多个子结构:memorycpuwifiip
  • get_cpu_usage 在未启用 FreeRTOS 运行时统计时,返回 supported: false 与说明消息。
  • get_wifi_info / get_ip_address 在未连网时会返回 connected: false 与空值字段。
  • delay_ms 可选,0 或省略时使用默认延迟。目前,默认延迟为 500ms。
  • 重启是异步安排的:工具会先返回成功结果,再由后台任务执行 esp_restart()
  • 失败时会返回 ok: false 和错误码字符串。

示例:

{"delay_ms": 1500}

可能返回:

{"ok":true,"message":"device restart scheduled","delay_ms":1500}