API 使用说明
API 或应用程序编程接口指的是一些预设程序。使用前,需要导入 API 库:
set_led(mode, R, G, B)
设置 led 灯颜色
- 参数
- mode – 1 - 常亮. 2 - 闪烁.
- R – (int) 0 ~ 255
- G – (int) 0 ~ 255
- B – (int) 0 ~ 255
get_firmware_version
获取固件版本号
get_motors_current
获取电机电流信息
get_battery_info
获取电池信息
- Return
list : [battery_data, battery_1_voltage, battery_2_voltage].
battery_data
: 长度为 6 的字符串, 从左到右依次对应: bit5, bit4, bit3, bit2, bit1, bit0. bit5 : 电池 2 插入接口,1 表示插入,0 未插入. bit4 : 电池 1 插入接口,1 表示插入,0 未插入. bit3 : 适配器插入接口,1 表示插入,0 未插入. bit2 : 充电桩插入接口,1 表示插入,0 未插入. bit1 : 电池 2 充电灯,0 表示没亮,1 表示亮. bit0 : 电池 1 充电灯,0 表示没亮,1 表示亮.battery_1_voltage
: 电池 1 电压.battery_2_voltage
: 电池 2 电压.
go_ahead(go_speed, timeout=5)
控制前进,默认运动 5 秒
- 参数
- go_speed – (int) 1 ~ 127 数值越小,速度越慢
- timeout – (int) 运动时长
retreat(back_speed, timeout=5)
控制后退,默认运动 5 秒
- 参数
- back_speed – (int) 1 ~ 127 数值越小,速度越慢
- timeout – (int) 运动时长
pan_left(pan_left_speed, timeout=5)
控制左平移,默认运动 5 秒
- 参数
- pan_left_speed – (int) 1 ~ 127 数值越小,速度越慢
- timeout – (int) 运动时长
pan_right(pan_right_speed, timeout=5)
控制右平移,默认运动 5 秒
- 参数
- pan_right_speed – (int) 1 ~ 127 数值越小,速度越慢
- timeout – (int) 运动时长
clockwise_rotation(rotate_right_speed, timeout=5)
控制顺时针旋转,默认运动 5 秒
- 参数
- rotate_right_speed – (int) 1 ~ 127 数值越小,速度越慢
- timeout – (int) 运动时长
counterclockwise_rotation(rotate_left_speed)
控制逆时针旋转,默认运动 5 秒
- 参数
- rotate_left_speed – (int) 1 ~ 127 数值越小,速度越慢
- timeout – (int) 运动时长
stop()
停止运动
restore()
堵转恢复