English →

3C 全流程 · 一张图

2026-09-07 · 从一堆积木到一台会动的机器,中间到底发生什么
2026-09-19 更新:真板部分按 cube 线现状改过(cube_总览.html 09-15 · 登记流程.html 09-16)

拼什么 → 插了什么 → 干什么 → 在哪跑

整条流程只有这四格。看着复杂,是因为把「平台替你做的」也摆出来了 —— 那些你一次都不用碰。这是目标流程:仿真里现在就是这样;真板上哪些已通、哪些还没有,见最后的表。

3你要做的动作
(拖机构 · 拖 cube · 拖积木)
1你要填的东西
(WiFi 密码,一辈子一次)
9平台替你做的
(下面逐条列出,不是凑的数)

那 9 件:① 算引脚分配 ② 把抢同一个脚的挪开 ③ 推断传动链 ④ 把积木编成 MicroPython ⑤ 拼出 main.py ⑥ 认领板子(MAC → 你的账号) ⑦ 扫 I2C 认出接了什么 ⑧ 推固件进板子 ⑨ 重启并把读数收回页面
真板现状:⑥ 认领还没做;⑧ 目前经本机桥走 WebREPL 推,只对测距、蜂鸣器、屏端到端验过。

脑图

MakerKit 3C 一台会动的机器 🧱 拼什么 construct · 667 台库里挑 🔌 插了什么 cube · 12 种器件,拖上去 ⌁ 干什么 code · 拖积木 或 选预设 一份程序 一块板 = 一个程序 仿真里跑 现在就能 真板子上跑 下面四步 真板子那四步 ① 配网  手机连板子热点,填 WiFi      ★ 你唯一要填的东西,一次 ② 注册  板子报 MAC,自动挂到你账号 ③ 编固件 平台排引脚、拼 main.py ④ 下发  经 WebREPL 推进去,重启就跑  目标是②③④ 全自动;现状见下表 你只做三件事(全是拖) 🧱 拖一台机构进来    从 667 台库里挑,或传自己的 🔌 把 cube 拖到机构上  想放哪放哪,随便挪 ⌁ 拖积木 / 点一个预设  「近了就停并报警」 仿真里不问你:端口 · IP · 引脚 · 板子是哪块 真板上要按列出的引脚接线(MAC 是身份,不是 COM 口)

四步展开:谁做什么

1
配网你,一次
板子没连过 WiFi 就自己开个热点 MK-CUBE-xxxx。手机连上,填家里 WiFi 密码 + 一个从页面复制的 6 位绑定码。之后再也不用管。
只能填 2.4G 的网络 —— ESP32 收不到 5GHz(实测扫到 8 个 AP,信道全在 1–11)。
现状:手机配网代码已写、本机自检 35/35,真机还没走过;现在新板是按登记流程接串口手工配网。
2
注册自动
板子连上网就报到,报的是 MAC,不是 COM 口 —— 同一天同一个 COM5 上出现过四块不同的板子, 端口号根本不是身份。报到时顺便扫一下 I2C,能自动认出 OLED、陀螺仪。
现状:自动报到的代码在,还没装到板上;认领到账号(/cube/*)还没做。现在按 MAC 手工登记。
3
编固件自动
按你拖上去的 cube 算引脚(谁跟谁抢脚平台自己错开),把积木编成一份 main.py。 引脚分配的测试里 10 种 cube 一起上一块板排得开 —— 这是软件检查,不是真接线。
现状:导出的板上代码只对测距、蜂鸣器、屏在真板上端到端验过。「插上即用」不成立: 真板上要按列出的引脚接线(原版程序里有 5 个脚互相冲突);电机在单独的电机板上。
4
下发自动
走 WiFi 推进板子,重启就跑。登记之后不用再插 USB 线、不用找端口。
现状:本机桥(mk_bridge.py)经 WebREPL 推,测距、蜂鸣器、屏已走通; 服务器上的 /deploy 连不进家里的局域网,恒返 503 并给出手动步骤。

现在到哪了

环节状态说明
拖机构 / 拖 cube通了想放哪放哪,位置会记住
拖积木 · 仿真里跑通了一块板一个程序,蓝的读红的写
算引脚通了判据 + 24 条测试;刚接上后端口子
12 种器件的真机状态3/12 打通★ 3 种从 Blockly 打通到真板(测距、蜂鸣器、屏);2 种在各自板上跑通(摄像头、电机);7 种是桩(原版程序在,没量过)
编出能烧的固件半通测距、蜂鸣器、屏的导出代码在真板上跑通(09-09);其余种类没验
配网 / 注册 / 下发部分有手机配网代码 + 本机自检 35/35(真机没走);新板按登记流程手工认 MAC、配网、开 WebREPL(09-16 走通);经 WebREPL 下发已通;认领到账号没做
多块板互相配合还不通09-09 定了:不用 ESP-NOW / BLE mesh,平台经 WebREPL + 主机中转连板子;同板内广播已通,跨板中转还没做,真板之间的消息目前不通

能用 部分通 还没有

唯一真正简化不掉的一步:WiFi 密码。板子不可能猜到你家路由密码,所以第一次必须有人告诉它。 其余每一样(端口、IP、引脚、板子是哪块、代码怎么传)都能消失 —— (引脚要靠出厂时登记进板子的接线画像才能消失,这一步还没做) 而且必须消失,因为它们正是今天最贵的那个坑:一份文档里写死 -p COM5, 而那个口上插的其实是别的板子。