Petoi Bittle X 的做法
Petoi Bittle X 的 146 个步骤,附出处文档。
Bittle X 319 美元,Bittle 289 美元(官网)
组装
- 安装构建套件的螺丝
完成关节校准后,安装中心螺丝以固定组件和舵机齿轮。
- 用 USB 连接主板
使用 USB 电缆将计算机连接到机器人主板,并按照对应主板型号的后续子页面操作。
软件与固件
- 删除 WebSocketsServer 库并重启 Arduino IDE
进入 ~/Documents/Arduino/libraries/,删除 "WebSocketsServer" 文件夹,然后重启 Arduino IDE,只保留 "WebSockets" 库。
- 让 Arduino IDE 自动选择库
代码使用任意一个库都可以工作,Arduino IDE 会使用它找到的第一个库。
- 上传后 ESP8266 生成唯一 SSID
上传代码后,ESP8266 会生成格式为 Petoi-AP[XXXX] 的唯一 SSID,其中 XXXX 是随机的 4 位数字。
- SSID 与随机数保存到 EEPROM
SSID 和随机数字会保存到 EEPROM,并在重新启动后依然保留。
- 无已保存凭据时创建配置门户
如果没有保存的 WiFi 凭据,WiFiManager 会用生成的 SSID 创建一个配置门户。
- 更改 WiFi 名称
发送 `n[newName]`,例如 `nLittleDog`、`nMyRobot` 或 `nBittle`。SSID 将变为 `[newName]-AP`,并移除随机数字。
- 清除 WiFi 设置
发送 `w!` 清除已保存的 WiFi 凭据。设备下次重启时将显示配置门户。
- 重置 WiFi 设置
发送 `r` 清除已保存的 WiFi 凭据。设备下次重启时将显示配置门户。
- 清除所有 EEPROM 数据
发送 `E` 清除所有存储数据,包括 SSID 和 WiFi 设置。
- 使用串口监视器
以 115200 波特率打开串口监视器,发送上述任一命令,然后重启设备使更改生效。
- 连接示例网页客户端
使用提供的 HTML/JavaScript 示例连接到 `ws://192.168.4.1:81`。输入命令并点击 Send;客户端发送包含 `command` 和 `wait: 0` 的 JSON,在 `output` 中显示收到的消息,并将状态更新为 Connected 或 Disconnected。
- 发送 Base64 编码命令
将 `b64:QgoBDgERAX4=` 放入 `commands` 数组,并使用 `type: "command"` 和 `taskId: "12345"` 发送 JSON。系统检测 `b64:` 前缀,解码 Base64 数据,将原始字节及正确的终止符发送给机器人;示例会解码为 `[0x42, 0x0A, 0x01, 0x0E, 0x01, 0x11, 0x01, 0x7E]`。
- 配置智能超时管理
按照 OpenCatEsp32/PetoiWebBlock 的超时配置设置 Web 编码模块。
- 添加任务完成跟踪
为包含 taskId 的命令提供详细进度跟踪,使 Web 客户端能够监控执行状态。
- 发送即时确认
收到命令后立即返回类型为 ack 的确认响应,其中包含命令名称。
- 记录任务完成结果
任务完成后返回 taskId、completed 状态和 results 结果数组。
- 处理任务错误状态
任务失败时返回 taskId、error 状态以及 timeout 等错误信息。
- 发送前清除串口缓冲区
发送命令前清空串口缓冲区,避免旧数据干扰当前通信。
- 按命令类型自动终止
根据命令类型自动选择并发送相应的终止符。
- 等待完整机器人响应
收集响应时等待机器人返回完整响应。
- 添加超时保护
使用超时保护,防止程序无限期等待串口响应。
- 优化串口缓冲区管理
将串口缓冲区管理的超时设置为 40 毫秒。
- 延长移动命令响应等待
为移动命令使用延长的响应等待时间。
- 优化 JSON 解析
使用 ArduinoJson 7.x 优化 JSON 解析。
- 配置智能心跳机制
将智能心跳机制的超时设置为 25 秒。
- 节省内存并优化存储
将全局 Base64 字母表放入 PROGMEM 以节省 RAM,优化字符串操作、缓冲区清理及设置存储。
- 安装 Python
安装 Python 3.6 或更高版本,例如 Anaconda3-5.2.0-Windows-x86_64.exe。
- 安装 pyserial 库
安装 pyserial 3.5 库。
- 确认 USB 串口
使用 USB 适配器连接 Nybble 或 Bittle 时,通常只有一个串口号。
- 确认蓝牙串口
使用蓝牙模块时,会有两个串口号。
- 进入脚本目录
打开终端(例如 Anaconda Prompt),进入脚本所在的 serialMaster 路径。
- 运行 ardSerial.py
使用 kbalance 参数运行 ardSerial.py;kbalance 是代表 Nybble 或 Bittle 技能的串口命令。
- 无参数运行脚本
也可以不使用参数运行 ardSerial.py。
- 运行自定义脚本
在 serialMaster 目录中运行 example.py。
- 执行测试命令列表
example.py 中的 testSchedule 列表用于测试各种串口命令;循环会依次执行列表中的每个任务。
- 发送蜂鸣器音符命令
发送 [10, 255, 2] 格式的蜂鸣器命令。10 是音乐音调,255 是持续时间,取值范围为 0~255;发音结束后延迟 2 秒。
- 发送多音符旋律命令
发送列出的多音符蜂鸣器命令,依次播放音调 14、14、21、21、23、23、21。对应持续时间为 90、90、90、90、90、90、180;旋律播放结束后延迟 5 秒。
- 连接 Petoi 机器人
使用随附的 USB 适配器或蓝牙加密狗连接 Petoi 机器人,然后再运行应用。
- 下载预编译程序
从项目的 GitHub Releases 下载预编译二进制文件。
- 在 Windows 上运行
双击 exe 文件运行应用。移动应用时,务必保留 Win 文件夹中的所有文件。
标定与测试
- 使用软件版本 2.0
只有版本 2.0 能通过该 App 校准关节。
- 按主控板准备机器人
按照子页面中的说明,根据机器人的主控板完成校准准备。
- 通过电池开启机器人
将电池连接到主控板,然后长按电池按钮超过 3 秒,为机器人供电开机。
- 进入校准状态
机器人由电池开机后,使用图片中所示的两种方法之一进入校准状态。
- 在串口监视器输入 c
在串口监视器中输入‘c’,使所有舵机转到零位角度。
- 安装头、尾和腿
所有舵机处于零位角度时,将前一节准备好的头、尾和腿安装到机身;它们通常应与相连的机身框架垂直。
- 安装舵机相关部件
套件组装时,按照所示图片安装舵机相关部件,并尽量使上腿垂直于躯干、下腿垂直于上腿。
- 直接插入舵机输出轴
将舵机相关部件直接插入舵机输出轴,在此过程中不要转动输出轴。
- 确认关节正方向
从零位逆时针旋转肢体为正方向;从机器人身体左侧观察时,关节逆时针旋转定义为正方向。
- 使用校准参考工具
使用随附的L形工具作为校准参考,并按照对应产品子页面中的说明进行安装和微调。
- 测试校准效果
在“Rest”“Stand up”和“Walk”之间切换,以测试校准效果。
- 继续执行校准
点击Calibration按钮继续校准;机器人会立即进入校准状态,所有舵机都会移动到校准位置。
- 执行第二轮校准
为获得最佳效果,可能需要进行第二轮校准。
- 保存或放弃校准数据
校准后点击“Save”保存校准偏移量;点击“Abort”则放弃校准数据。
- 中途保存校准数据
如果连接中断,可以在校准过程中途保存校准数据。
- 处理关闭窗口提示
关闭窗口时,如需保存校准数据则点击“Yes”;否则点击“No”。点击“Cancel”可取消操作或退出。
- 用手机或电脑连接 ESP8266 的 WiFi 网络
从你的手机或电脑连接到 ESP8266 的 WiFi 网络。
- 打开强制门户或访问 192.168.4.1
强制门户应自动打开;若未打开,请导航到 http://192.168.4.1。
- 选择 Configure WiFi 并选择家庭 WiFi
选择 "Configure WiFi",然后选择你的家庭 WiFi 网络。
- 输入 WiFi 密码并点击 Save
输入你的 WiFi 密码并点击 "Save"。
- 设备重启并连接你的 WiFi 网络
设备将重启并连接到你的 WiFi 网络。
- 记录串口监视器显示的 IP 地址
记下串口监视器中显示的 IP 地址。
- 生成默认 SSID
首次启动时,系统生成随机4位数字,并按 `Petoi-AP[XXXX]` 格式组成 SSID。该数字保存在 EEPROM 中,后续启动时复用。
- 重置关节偏移量
在串口提示中确认重置关节偏移量。
- 校准 IMU
将机器人平放在桌面上。程序发出 6 声长鸣,读取传感器数据、保存偏移量,并在完成后再次鸣响。
- 校准各个关节
让机器人一侧朝上启动以进入校准模式,或直接通过串口监视器进行校准。
用起来
- 连接 WebSocket
连接到 ESP8266 的 81 端口上的 WebSocket 服务器:`ws://[ESP8266_IP]:81`。
- 发送任务 JSON 命令
发送包含 `type`、`taskId`、`commands` 和 `timestamp` 的 JSON 对象。该命令会将 `?` 发送给机器人。
- 发送令牌 JSON 命令
发送包含 `token` 和 `command` 的 JSON 对象。该命令会将 `ksit` 发送给机器人。
- 发送仅含命令的 JSON
发送仅包含 `command` 的 JSON 对象。该命令会将 `khi` 发送给机器人。
- 发送纯文本命令
直接发送纯文本 `ksit`。机器人会收到 `ksit`。
- 发送 Base64 命令
发送 `b64:QgoBDgERAX4=`。它会解码为二进制音乐命令 `B 10 1 14 1 17 1~`,并将原始字节发送给机器人。
- 发送休息姿势命令
发送 `d\n`,让机器人进入休息姿势。
- 发送问候命令
发送 `khi\n`,让机器人执行问候动作。
- 发送俯卧撑命令
发送 `kpu\n`,让机器人执行俯卧撑动作。
- 发送向前走命令
发送 `kwkF\n`,让机器人向前行走。
- 发送小跑前进命令
发送 `ktrF\n`,让机器人小跑向前。
- 发送坐下命令
发送 `ksit\n`,让机器人坐下。
- 开启陀螺仪
发送 `g\n`,开启机器人的陀螺仪。
- 关闭陀螺仪
发送 `G~`,关闭机器人的陀螺仪。
- 发送索引同步二进制动作
发送 `I~`,执行索引式同步二进制动作。
- 发送索引同步动作
发送 `i0 90\n`,执行索引式同步动作。
- 控制全部关节
发送 `L~`,以二进制方式控制所有关节。
- 发送索引顺序动作
发送 `m1 45 0 45\n`,执行索引式顺序动作。
- 查询关节角度
发送 `j\n`,查询机器人的关节角度。
- 读取陀螺仪数据
发送 `gu\n`,读取机器人的陀螺仪数据。
- 发送 Base64 音乐命令
发送 `b64:QgoBDgERAX4=`;该 Base64 数据会解码为 `B 10 1 14 1 17 1~`。
- 发送二进制蜂鸣命令
发送 `B~`,执行二进制蜂鸣命令。
- 发送 ASCII 蜂鸣命令
发送 `b12 8 14 8\n`,执行 ASCII 蜂鸣命令。
- 处理客户端连接事件
客户端连接时处理 `WStype_CONNECTED`,服务器发送欢迎消息。
- 处理客户端断开事件
客户端断开时处理 `WStype_DISCONNECTED` 事件。
- 发送并处理心跳消息
发送 `{"type":"heartbeat"}`,系统会以时间戳响应。
- 发送前清空串行缓冲区
处理客户端文本命令时,先移除串行缓冲区中已有的数据,再发送命令。
- 解析 JSON 命令格式
解析 `{"token":"k", "command":"sit"}` 或 `{"type":"command","taskId":"123","commands":["ksit"]}` 格式。
- 合并令牌与命令
将 token 与 command 合并,并向机器人发送 `ksit`。
- 解码 Base64 命令
对带 `b64:` 前缀的命令进行解码,以处理二进制数据,例如音乐命令。
- 添加正确命令终止符
大写命令 A–Z 使用 `~`,小写命令使用 `\n`,例如 `G~`、`i0 90\n` 和 `m1 45\n`。
- 发送即时确认
命令发送后立即返回 `{"type":"ack","command":"ksit"}` 确认。
- 配置命令超时时间
动作、复杂技能、音乐或二进制命令及心跳超时为 30 秒、25 秒;传感器读取为 5 秒,简单命令为 5 秒。
- 等待动作命令确认
对于移动命令,等待收到 token 确认后才视为响应完整。
- 返回任务命令结果
任务命令完成后返回 `{"taskId":"123","status":"completed","results":["robot_reply"]}`。
- 返回普通命令响应
普通命令返回 `{"type":"response","data":"robot_reply"}`;超时则返回任务错误或 `{"type":"timeout","command":"ksit"}`。
- 打开状态页面
访问 WebSocket 服务器的根路径 `/`,查看状态页面。
- 读取 JSON 状态信息
访问 `/status`,获取 JSON 格式的状态信息。
- 控制并退出机器人
脚本启动后,可以在终端输入串口命令控制 Nybble 或 Bittle 执行动作;输入 quit 或 q 退出。
- 编写行为命令列表
testSchedule 中的 kbalance 命令使 Bittle 正常站立;列表中的数字表示命令完成后的延迟秒数。还可以参考 stepup.py 中的 stepUpSchedule 列表,根据需要编写行为列表。
常见问题
数据集
物料
- 官网首页未列盒内物品;基于 Arduino 的控制板
工具
- 官网未列
技能
- C++、Python 或积木编程
软件
- OpenCat