硬件接口清单(JSON协议)


硬件接口根路径 /hw/



蜂鸣器接口集合

路径: /hw/buzzer/


/hw/buzzer/music

播放简谱音乐

参数:{music: 简谱字符串}

返回:执行结果


/hw/buzzer/hello

播放开机音乐

参数:<无>

返回:执行结果


/hw/buzzer/fire

播放火警

参数:<无>

返回:执行结果


/hw/buzzer/freq

播放指定频率声音

参数:{freq: 频率, keep: 持续时长毫秒}

返回:执行结果


/hw/buzzer/stop

停止播放

参数:<无>

返回:执行结果



ADC接口集合

路径: /hw/adc/


/hw/adc/battery

查询电池电压

参数:<无>

返回:查询结果




RMT接口集合

路径: /hw/rmt/



/hw/rmt/ws2812/play

设置WS2812炫彩灯带的颜色

参数:{pin: 灯带接的管脚, colors: [依次灯珠颜色序列]}

返回:执行结果



/hw/rmt/ws2812/clear

关闭WS2812炫彩灯带

参数:{pin: 灯带接的管脚, count: 灯珠数量}

返回:执行结果




姿态传感器接口集合

路径: /hw/icm/


/hw/icm/ping

监测姿态传感器是否接通

参数:<无>

返回:查询结果



/hw/icm/temp

监测传感器温度

参数:<无>

返回:查询结果






PCA9685接口集合

路径: /hw/pca9685/



/hw/pca9685/gpio

管脚GPIO电位操作

参数:{pin: 管脚编号, val: 电位}

返回:执行结果



/hw/pca9685/pwm

管脚PWM操作

参数:{start_pin: 开始管脚, pwms: [依次PWM占空比序列]}

返回:执行结果



/hw/pca9685/servo

管脚舵机操作

参数:{start_pin: 开始管脚, angles: [依次舵机角度序列]}

返回:执行结果



/hw/pca9685/rgb

设置板载RGB三色灯的颜色

参数:{r: 红色等颜色值, g: 绿色灯颜色值, b: 蓝色灯颜色值}

返回:执行结果


/hw/pca9685/setfreq

设置PCA9685频率

参数:{freq:新频率}

返回:执行结果


/hw/pca9685/getfreq

获取PCA9685频率

参数:<无>

返回:执行结果






用户I2C接口集合

路径: /hw/i2c/



/hw/i2c/writereg

用户I2C总线往指定寄存器写入数据

参数:{addr: 设备地址, reg: 寄存器地址, data: [依次字节单位值序列]}

返回:执行结果



/hw/i2c/readreg

用户I2C总线从指定寄存器读入数据

参数:{addr: 设备地址, reg: 寄存器地址, size: 读入字节数}

返回:执行结果



/hw/i2c/scan

扫描接在用户总线上的全部设备

参数:<无>

返回:查询结果




系统I2C总线接口集合

路径: /hw/i2csys/


/hw/i2csys/scan

扫描接在系统总线上的全部设备

参数:<无>

返回:查询结果




管脚接口集合

路径: /hw/pin/



/hw/pin/setpin

设置指定管脚的电位

参数:{pin: 管脚, val: 新电位值}

返回:执行结果



/hw/pin/getpin

获得指定管脚的电位

参数:{pin:管脚}

返回:查询结果



/hw/pin/setservo

设置指定管脚的舵机角度

参数:{pin: 管脚, val: 舵机角度值}

返回:执行结果



/hw/pin/getservo

获取指定管脚的舵机角度

参数:{pin: 管脚}

返回:查询结果






PWM接口集合

路径: /hw/pwm/



/hw/pwm/servo

设置指定管脚上的舵机角度

参数:{pin: 管脚, angle: 角度值}

返回:查询结果



/hw/pwm/duty

设置指定管脚的PWM占空比

参数:{pin: 管脚, duty: 占空比值}

返回:查询结果



/hw/pwm/freq

设置整体频率

参数:{val:新频率}

返回:查询结果





屏幕接口集合

路径: /hw/screen/



/hw/screen/close

关闭屏幕

参数:<无>

返回:执行结果



/hw/screen/open

打开屏幕

参数:{width: 设置屏幕宽度, height: 设置屏幕高度, addr: 设置屏幕I2C地址}

返回:执行结果



/hw/screen/flush

重刷屏幕

参数:<无>

返回:执行结果



/hw/screen/clear

清空屏幕

参数:<无>

返回:执行结果



/hw/screen/rotate

旋转屏幕

参数:{mode: 旋转模式}

返回:执行结果



/hw/screen/brightness

调整屏幕亮度

参数:{level: 亮度值}

返回:执行结果



/hw/screen/size

查询屏幕尺寸

参数:<无>

返回:查询结果



/hw/screen/print

往屏幕上输出文字

参数:{text: 输出内容, x: 输出起始X坐标, y: 输出起始Y坐标}

返回:执行结果





硬件信息接口集合

路径: /hw/info/



/hw/info/all

查询硬件全部信息

参数:<无>

返回:查询结果



/hw/info/wifi

查询WiFi信息

参数:<无>

返回:查询结果



/hw/info/flash

查询Flash信息

参数:<无>

返回:查询结果



/hw/info/mem

查询内存信息

参数:<无>

返回:查询结果



/hw/info/cpu

查询CPU信息

参数:<无>

返回:查询结果



/hw/info/i2c

查询I2C系统总线设备信息

参数:<无>

返回:查询结果



/hw/info/camera

查询摄像头信息

参数:<无>

返回:查询结果



/hw/info/device

查询板载设备信息

参数:<无>

返回:查询结果





WiFi接口集合

路径: /hw/wifi/



/hw/wifi/info

查询WiFi信息

参数:<无>

返回:查询结果



/hw/wifi/guidan

查询服务器访问能力

参数:<无>

返回:查询结果



/hw/wifi/hotspot/info

查询热点模式信息

参数:<无>

返回:查询结果



/hw/wifi/hotspot/save

保存热点模式配置

参数:{ssid: 热点的SSID名称, pwd: 热点的密码}

返回:执行结果



/hw/wifi/hotspot/factory

恢复热点模式配置到出厂状态

参数:<无>

返回:执行结果



/hw/wifi/scan/scan

执行同步WiFi扫描

参数:<无>

返回:查询结果



/hw/wifi/scan/start

启动WiFi扫描

参数:<无>

返回:执行结果



/hw/wifi/scan/list

查询WiFi扫描结果

参数:<无>

返回:查询结果



/hw/wifi/sta/info

查询当前WiFi信息

参数:<无>

返回:查询结果



/hw/wifi/sta/disconnect

断开当前WiFi连接

参数:<无>

返回:执行结果



/hw/wifi/sta/connect

连接指定WiFi

参数:{ssid: WiFi名称, pwd: WiFi密码, save: 是否保存, retry: 重试最大次数}

返回:执行结果



/hw/wifi/sta/factory

恢复WiFi到出厂配置

参数:<无>

返回:执行结果



/hw/wifi/ap/close

关闭小车自身热点

参数:<无>

返回:执行结果



/hw/wifi/ap/info

查询小车自身热点状态

参数:<无>

返回:查询结果






摄像头接口集合

路径: /hw/camera/



/hw/camera/config/get

查询摄像头的配置

参数:<无>

返回:查询结果



/hw/camera/config/set

更新并保存摄像头的配置

参数:<无>

返回:执行结果



/hw/camera/config/factory

恢复摄像头的配置到出厂状态

参数:<无>

返回:执行结果



/hw/camera/reopen

重启摄像头

参数:<无>

返回:执行结果



/hw/camera/standby

睡眠摄像头

参数:<无>

返回:执行结果



/hw/camera/resume

恢复摄像头

参数:<无>

返回:执行结果



/hw/camera/mode

切换摄像头模式

参数:<无>

返回:执行结果



/hw/camera/perf

查询摄像头当前性能

参数:<无>

返回:查询结果





硬件功能接口集合

路径: /hw/



/hw/close

关闭指定管脚

参数:{pin: 管脚}

返回:执行结果