正在连接信源…

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 列表,根据需要编写行为列表。

常见问题

  • 固件超出板载存储和内存,导致编译失败 #2 #65
  • 主程序缺少传感器输出,陀螺仪与超声波也无法同时使用 #77 #93
  • 缺失依赖、摄像头示例报错及代码规范检查导致构建失败 #5 #38 #41
  • 零位技能存储错误,校准函数还可能发生除零 #3 #12
  • Linux 与树莓派上的串口和资源路径识别错误 #16 #70 #88
  • 串口命令已发送,但机器人没有执行相应动作 #19
  • 蓝牙连接异常或固件更新后无法编程和控制机器人 #42 #64 #67
  • 应用在 Apple 芯片上崩溃,语音与移动端还会断网 #31 #47 #62

数据集

物料

  • 官网首页未列盒内物品;基于 Arduino 的控制板

工具

  • 官网未列

技能

  • C++、Python 或积木编程

软件

  • OpenCat

文档