企业官网建设流程全解析

哪吒1 (nezha-1) 快速上手指南：大师兄板接线与第一个电机程序完整教程

【免费下载链接】nezha-1源师兄扩展项目: 哪吒1 | 由源师兄组织创建项目地址: https://gitcode.com/yuanshixiong/nezha-1

这是一份面向初学者的哪吒1 (nezha-1)智能编程扩展完整上手指南：3 步完成大师兄板接线，5 个积木块拼出你的第一个电机程序，无需编写复杂代码，新手也能立刻上手让电机转起来。🚀

📦 哪吒1扩展是什么？

哪吒1（nezha-1）是由源师兄组织发布的、面向大师兄板的智能编程扩展项目（"智能编程的哪吒"）。安装后，积木编程环境里会出现专属的红色「哪吒」积木分组，用拖拽积木的方式就能驱动4 路电机（M1–M4）和4 路舵机（S1–S4），完全不用手写底层通信代码。

• 支持设备：大师兄板
• 扩展名称：哪吒
• 一句话简介：智能编程的哪吒

项目基本信息定义在 config.json 中，项目说明见 README.md，整个积木面板的结构与配色（红色#ff0000）由 category.json 和 blocksdef.js 定义。

两大分组、6 个积木块速览

积木清单见 category.json，每个积木的界面与生成逻辑实现在 blocksdef.js。

🔌 大师兄板接线教程：3 步连好电机和舵机

哪吒扩展通过I2C 总线（I2C0 总线、频率 100kHz、设备地址0x10）控制电机和舵机，接线非常简单：

1. 接电源：扩展板电源端接大师兄板的 VCC 电源端。
2. 接地的：GND 对 GND 对齐，保证可靠共地（这一步最容易漏！）。
3. 接 I2C：扩展板的 SDA（数据线）、SCL（时钟线）分别接到大师兄板的 I2C 接口。

初始化参数可以从「初始化哪吒」积木生成的代码里看到（blocksdef.js）：

i2c = I2C(0, freq=100000) i2c_addr = 0x10

💡小贴士：接线完成后若设备毫无反应，90% 是 SDA/SCL 接反或 GND 没接好，优先排查这两处。

🏁 写第一个电机程序：5 步让电机动起来

我们来做第一个经典案例：M1 电机以 50% 速度正转 2 秒，然后刹车，总共 5 步：

1. 拖出初始化哪吒积木放在程序最顶部，它会自动初始化 I2C 并等待 1 秒让板子准备就绪（见 blocksdef.js）。
2. 拖出设置电机积木，选择M1，速度填50——正数正转、负数反转，关键逻辑在 blocksdef.js。
3. 中间加一个系统自带的等待 2 秒积木。
4. 拖出停止电机积木，选择M1（见 blocksdef.js）。
5. 想一次停全部？换成停止全部电机积木即可（见 blocksdef.js）。

拼好的程序结构长这样：

初始化哪吒 设置电机 M1 速度 50% 等待 2 秒 停止电机 M1

下载到板子上运行：电机会以半速转动 2 秒后平稳停住。想让它反转？把50改成-50就行。✅

🎯 进阶玩法：舵机定位与连续转动

• 设置舵机：先选类型（180° / 270° / 360°），再选端口（S1–S4）和角度（0~360°）。积木会自动把角度换算成 0–180 的协议值发送，换算逻辑见 blocksdef.js。
• 设置连续转动舵机：直接填 -100%~100% 的速度，积木会自动换算成连续转动指令（见 blocksdef.js）。

不妨试试这两个小实验：

1. 让 S1 舵机从 0° 慢慢扫到 180°（用循环 + 每次加 1°，动作更平滑）。
2. 用连续转动舵机模拟"哪吒"绕场一圈后反向刹停。

❓ 常见问题：快速排查

📝 小结

接线 3 步 + 积木 5 块，你就用哪吒1 (nezha-1)扩展在大师兄板上完成了第一个智能编程项目：电机正反转、刹车、舵机定位全部搞定。项目许可信息见 LICENSE，下一步建议加入循环结构，让 4 路电机协同工作，做出更酷的作品吧！🎉

【免费下载链接】nezha-1源师兄扩展项目: 哪吒1 | 由源师兄组织创建项目地址: https://gitcode.com/yuanshixiong/nezha-1