哪吒1 (nezha-1) 常见问题自查清单10个高频故障电机不转、I2C地址0x10、初始化失败排查方案【免费下载链接】nezha-1源师兄扩展项目: 哪吒1 | 由源师兄组织创建项目地址: https://gitcode.com/yuanshixiong/nezha-1使用源师兄平台的哪吒1 (nezha-1)扩展时新手最常遇到三类问题电机不转、I2C 地址 0x10 通信异常、初始化失败。本文按电机 → I2C 通信 → 舵机 → 加载使用四大类整理出 10 个高频故障的自查清单帮你快速定位原因并解决。一分钟了解扩展哪吒1 配合大师兄板使用通过 I2C 总线固定地址0x10、波特率 100000控制4 路电机M1~M4和4 路舵机S1~S4全部以图形化积木块的形式提供详见 config.json。 哪吒1 扩展速览有哪些积木块积木块功能控制对象初始化哪吒开启 I2C 总线地址 0x10并内置 1 秒等待全模块设置电机按百分比控制转速正负数决定转向M1 ~ M4停止电机 / 停止全部电机让指定电机或 4 路电机全部停止M1 ~ M4设置舵机按角度控制分 180° / 270° / 360° 三种类型S1 ~ S4设置连续转动舵机按速度-100% ~ 100%持续旋转S1 ~ S4积木面板的分类结构定义在 category.json所有积木的通信指令生成逻辑集中在 blocksdef.js。 排查前先确认的 3 件事在逐个对号入座之前先确认这三项可排除一半以上的故障✅接线模块的 SDA、SCL 是否正确连接到主控板的 I2C 0 总线供电是否稳定✅地址哪吒模块的 I2C 地址固定为0x10无法修改✅顺序程序开头必须先拖入初始化哪吒积木块再放其他控制块。⚡ 一、电机类故障不转 / 转向 / 转速故障1电机完全不转先检查初始化哪吒积木现象拖了设置电机积木电机毫无反应。原因90% 的情况是程序里没有初始化哪吒积木I2C 总线从未开启控制指令发不出去。排查方案确认程序第一块积木是初始化哪吒确认接线后重新运行程序再试。故障2电机抖一下就停上电时序不能少现象电机通电瞬间抖一下随后停止。原因电机驱动模块上电后需要稳定时间。初始化积木内置了time.sleep(1)等待 1 秒来处理这个时序见 blocksdef.js#L15-L26。排查方案检查是否有人手动删除了初始化等待或把其他控制块放到了初始化积木之前执行。故障3电机转向反了用负数速度反转现象电机在转但方向和预期相反。原因速度为正数0~100时电机正转负数-100~-1时反转逻辑见 blocksdef.js#L46-L55。排查方案直接把速度值改成相反符号即可无需修改接线。故障4转速和设置的对不上确认速度取值范围现象设置的速度和实际转出来的快慢不一致。原因速度范围是-100% ~ 100%0 表示停止超出范围的值无效。排查方案确认速度输入在合法范围内并检查电源电压是否偏低导致带载减速。 二、I2C 通信类故障0x10 地址 / 初始化失败故障5扫不到 I2C 地址 0x10四步排查现象I2C 扫描工具里找不到地址 0x10 的设备。排查方案按顺序执行检查 SDA、SCL 是否接反或接错总线哪吒模块走的是I2C 0检查 VCC / GND 供电模块未上电时总线扫描必然失败检查 I2C 地址固定为0x10见 blocksdef.js#L16-L18扫描时注意别把它当成没找到换一段已知好的杜邦线排除线路接触不良。故障6初始化失败报错确认 I2C 端口与频率现象程序运行到初始化时抛错或卡死。原因初始化代码固定为I2C(0, freq100000)即I2C 总线 0、频率 100000。若主控板固件的 I2C 引脚被其他外设占用初始化就会失败。排查方案确认 I2C 0 对应的引脚没有其他设备占用不要用其他总线号替换。故障7程序整体无反应检查积木顺序现象代码看似完整但运行后什么都发生。原因图形化积木按从上到下的顺序生成代码控制块被放在初始化块之前时指令会发往尚未开启的 I2C 总线。排查方案把初始化哪吒拖到最顶部其余控制块按执行顺序排列。️ 三、舵机类故障角度 / 速度故障8舵机角度达不到设定值检查舵机类型现象设 180°舵机只转到一半就停了。原因设置舵机积木需要先选类型180° / 270° / 360°角度超过类型上限时会被自动截断逻辑见 blocksdef.js#L115-L126。排查方案对照实际舵机型号选择正确类型——普通舵机选 180°可调 270° 的选 270°旋转舵机选 360°。故障9连续转动舵机速度怪怪的了解速度映射规则现象速度设为 0 时舵机却停在中间位置感觉不听话。原因连续转动舵机的速度会做线性映射-100% → 最慢反向0% → 中间位100% → 最慢正向映射公式见 blocksdef.js#L146-L1520% 并不是停止而是中位。排查方案想让舵机停住就改用设置舵机积木指定角度或把速度推到 ±100%。 四、加载与使用类故障故障10编辑器里看不到哪吒扩展检查扩展文件现象积木面板中没有哪吒分类或积木显示不完整。排查方案确认扩展已成功导入源师兄图形化编辑器检查扩展文件是否齐全blocksdef.js积木定义、category.json面板分类、config.json扩展信息缺一不可重新加载扩展后刷新编辑器。✅ 10 个故障快速自查表#故障现象最可能原因快速解决1电机不转缺少初始化积木程序开头放初始化哪吒2电机抖一下就停上电时序不足保留初始化的 1 秒等待3电机转向反速度符号写错速度改成正 / 负数4转速不符预期速度超出范围控制在 -100% ~ 100%5扫不到地址 0x10接线 / 供电问题查 SDA、SCL、VCC6初始化失败I2C 0 引脚被占用释放 I2C 0 总线引脚7程序无反应积木顺序错误初始化块放最顶部8舵机角度不够舵机类型选错匹配 180° / 270° / 360°9连续转动异常误解速度映射0% 是中位而非停止10找不到扩展积木扩展文件缺失检查三个核心文件是否齐全 获取完整扩展源码如需查看通信协议细节或二次开发可以拉取源码git clone https://gitcode.com/yuanshixiong/nezha-1重点文件速查blocksdef.js全部积木块定义与 Python 指令生成逻辑category.json积木面板分类结构初始化 / 电机 / 舵机config.json扩展名称与适配设备大师兄板信息README.md项目简介按这份清单从上到下逐项检查绝大多数电机不转、I2C 地址 0x10、初始化失败类问题都能在半小时内定位。祝开发顺利 【免费下载链接】nezha-1源师兄扩展项目: 哪吒1 | 由源师兄组织创建项目地址: https://gitcode.com/yuanshixiong/nezha-1创作声明：本文部分内容由AI辅助生成（AIGC），仅供参考