当前位置：首页 > news >正文

Mixly米思齐1.0 2.0 3.0 软件windows版本MAC苹果电脑系统安装使用常见问题与解决

news 来源：原创 2025/6/9 7:04:45

Mixly软件应用常见问题

Mixly米思齐编译或上传报错？

1、软件安装与驱动（Mixly1-2）

1-1 Windows版本

软件及驱动可以在Mixly群（QQ群号621937623）的群文件夹中找到，或到Mixly在线软件下载链接中重新下安装包！【Mixly软件安装包下载】

Win版本安装软件方法：

Windows安装版

安装路径（很重要！）：安装路径在硬件根目录下，如D:\mixly,文件夹名不能有中文、空格、符号。

Windows gitee工具更新版

A：解压后，把Mixly安装路径改成D:\mixly,文件夹不能有中文、空格、符号、（如果是Mixly2.0）官方文件的原解压名也不行，移动后更新两次再运行能好。比如D盘不是只能D盘，如果不小心装在其它多级目录，移动后把文件夹属性设置成【可读可写】再更新两次，更新时全选Y!!

B: 电脑必须联网，运行两次以上【一键更新】，打开Mixly运行。

1-2 MAC版本Mixly2.0的安装

安装视频教程：

注：下载文件的区别，因为苹果电脑有M1-M2芯片，那么就要用带arm标识的压缩包，如果是旧的Intel的芯片的请用带X64的压缩包！在电脑左上角苹果标识中右键盘----关于本机----芯片，可以查看到自己电脑的是哪种芯片。
如：

用于M1-M2芯片的：mixly2.0-mac-arm64-一键更新版.7z

用于intel芯片的：mixly2.0-mac-X64-一键更新版.7z

1，解压到⾃定义位置（可以在桌面），并把所有文件移到文件夹的根目录中，文件夹重命名为Mixly2,不要有更多的二级目录及不要有空格，中文，其它符号。

2 安装git：安装此⽬录下提供的 git-2.15.0-intel-universal-mavericks.dmg 安装包。

3 打开终端：使⽤快捷键 command+空格打开聚焦搜索，输⼊ terminal.app 并选中匹配项， Enter 后即可打开终端（或用siri呼叫“打开端终”）。

4 切换路径到Mixly⽂件夹：在终端中输⼊ cd [path] —回车Enter，其中 [path] 为所解压的mixly2.0更新⽂件夹路径。例如：当前mixly2.0⽂件夹路径为/Users/xxx/mixly2.0，则对应指令为 cd /Users/xxx/mixly2.0 。或终端中输入cd空格，然后拉入文件夹也可以。不要退出接着操作第5步。

5 开启root权限：在终端中输⼊“ sudo su ”，（注这里最后要个空格） Enter 后按照提示输⼊密码即可开启root权限，注意：以下操作必须在root下执⾏，否则可能会出错。

6 运⾏⼀键更新脚本：在终端中输⼊ “sh 一键更新.sh”，（注这里中间的sh后有空格，最后无空格）Enter后根据提示选择需要安装的板卡，然后等待完成，安装完成后，关闭终端。

7 有的电脑当运行完第6步后打开时提示错误或少文件，可以手动再操作一次第6步，注：操作第6步是要从第3步开始：）

8 在K210 MPY上传报错时，因为 PY在mac 要不能跟安装包一起，这时我们自己打开终端将没有的手动安装，指令格式：pip3 install XXXXX, 最后的 X 为报错要安装的内容，如报错：ModuleNotFoundError: No module named ‘dotenv’ ，这时我们就是差了 dotenv 库，打开终端输入指令：pip3 install dotenv，或如报错：ModuleNotFoundError: No module named ‘click’，这时我们就是差了 click 库，打开终端输入指令：pip3 install click回车即可自动安装（要保持网络正常）。如上指令安装不了时，换用指令：pip3 install python-XXXXX，X 为报错要安装的内容。

2、Mixly2.0常见问题及建议解决方案

通常打开软件时就报错，最好的的解决办法是更新或重装软件！不然你可找半天也不一定找得出问题！

2-1 Windows版本常见

A:软件白屏不显模块，或缺少主板的选择项等

B:编译不过，出现了“Linking everything together…”这一行后，到查找COM口时出现一堆路径文件

解决方案：

1，必须做的通用解决方案：把Mixly2.0的存放目录放到根目录下，如：D:\Mixly2 (不要再有二级文件夹，不要有空格，中文，其它符号），移动后把文件夹【属性】设为【可读可写】，再运行两次软件文件夹内的“一键更新.bat”，再重新启动通常能解决。

2，重启电脑移除硬件，直接再运行软件右上角的【更新】或到软件文件夹内找到【一键更新.bat】运行后重启软件。

2-2 MAC版本常见

不能导入云库，不能编译成功，不能打开软件，不能上传，提示错误信息（非程序代码的错误）

解决方案：以上原因为MAC系统的安全机制限制了用户软件对文件的操作，运行指令解除文件夹的安全限制： 1.把Mixly文件夹放在桌面上并把文件夹名改简单一点，不要那么长，把中文、空格、小数点等符号全部去掉，剩下mixly ，安装文件夹内的python3.XX,重启电脑 2.打开终端APP或对着siri说”打开终端“进入命令行，输入指令：sudo xattr -r -d com.apple.quarantine 复制这一段粘贴上去
3.然后再把你的mixly文件夹拖进去，它自动会生成路径注：路径跟前面2上的指令要有一个空格 4.回车/输入开机密码（如果有显示一个钥匙图标时）就完事了。

2-3 上传不了

3-1 选择正确的主板

A01/C01等UNO主控: Mixly 在上传处选QDProbot Arduino UNO ，或UNO

IOTstart/物联屏等ESP8266主控：Mixly 在上传处选ESP8266

AIcam:Mixly 在上传处选QDProbotAIcam

C02/C02Mini/IOTpro/齐护遥控等ESP32主控：Mixly 在上传处选ESP32_Arduino 、QDProbotAIcam或QDProbotC02

然后选对应的COM口，要对应自己的主控制口，如无法判断是哪一个，请拔去设备再检查哪个不显示了，再重插上后又有显示的就是这个口；

3-2 A01/C01的P5是专供蓝牙模块wifi模块用，同硬串口，为了高速传输数据，所以它跟数据USB口是并联的，只要上传程序时不要插模块即可，上传完成后正常用，不影响在线监视功能！

2-4 打开文件缺少块，出现黑色块？

旧文件，软件升级后不支持一些编程块或缺少库文件的支持，要先手动导入对应文件所用到的库文件，然后再打开文件！

2-5 打开文件空白？

Mixly的文件不支持在文件夹上双击打开，如果这样打开软件会显示空白！

正确的方法是：先打开软件，然后从软件的文件—打开，找到文件打开；或先打开软件，然后把文件托到软件上，也可以正常打开！

3 、Arduino ESP 主控编程硬件（主板/模块）使用常见问题

3-1 ESP32主控常见问题

1-1 ESP32开启wifi后有的引脚不能读取或应用？
使用Wi-Fi时不能使用ADC2管脚。因此，如果您使用Wi-Fi，并且无法从ADC2 GPIO获取值，则可以考虑改用ADC1 GPIO，这应该可以解决您的问题，具体哪些是ADC2请查看【二次开发资料】。

1-2 接了传感器后不能上传程序？
ESP32的主控，在上传前最好不要在2号引脚，15号引脚及12号引脚上有传感器或执行器，否则有可能影响上传。

1-3 上传时软件报错：ESP32-MD5 of file does not match data in flash!为什么？
这是ESP32芯片内部错误，需要用工具修复。

修复方法：将工具文件夹中的esp_reset.bat文件用记事本打开，将文件中串口号修改为有问题的开发板串口号并保存，运行即可：【修复工具】

1-4 上传时显示：waiting for download
在上传时串口监视器显示：

rst:0x1 (POWERON_RESET),boot:0x0 (DOWNLOAD_BOOT(UART0/UART1/SDIO_FEI_FEO_V2))

waiting for download
这是可能你的主板上的2-12-15 号GPIO上有接传感器或模块影响到了上传，这三个引脚是ESP32的特殊引脚，在上传时要固定拉高或拉低，如果接了传感器就不能执行上传，一直显示等待上传。

解决方法：先把这些引脚的的模块去除，重新上传完成后再接回。

3-2 已知wifi环境都正常，为什么不能正常联网？

A: ESP32的WiFi需为2.4G频段WiFi，如果你用的是5G或别的频段，是不会工作的；

B: 连接WiFi避免使用中文名称。

3-3 主板一直重启？

3-1 供电不足，请外接电池，特别是电机，大舵机类的一定要另外供电或独立供电（模块上的正负极用外部电池），然后把地线（负极）跟主板并连，主板上的控制线外接（到模块）就好！

3-2 程序有错，触发了重启机制，重新检查或更换程序测试。

3-3 外接传感器电机等有短路情况或负载大于GPIO的电流，逐个去除测试。

3-4 检查复位键是否损坏。

3-4 Arduino上传时提示编译错误？

4-1 编译信息中出现 error: ‘XXX’ was not declared in this scope字样
编译信息中出现其它 error: ’ 字样

解决方案：

程序设计有问题，如没有定义变量，变量名错，函数错，没有库文件，没有初始化等，重新检查程序

4-2 编译不过，出现了“Linking everything together…”后不能上传
解决方案：排除如上的问题，检查硬件，先对COM口，数据线，电脑USB…硬件问题！

3-5 上传程序后，什么都正常，但电机不会转？

5-1 未插电池盒或电源充电器，这是因为电机接口上的电源是独立供电的，通过电池或充电器接口，这时必须打开电源或接上电池才会工作，这是为了更好的保护数据端口的稳定性及保护电脑USB口不因电流过大而烧坏！

5-2 检查更换数据线；

5-3 检查程序逻辑；

5-4 电池电量不足；

3-6 正常上传程序后模块没有反应？

6-1，检查模块电源指示灯有没有亮起，如果无请检查接线端口是否正确，数据线有无断线，换另一根相同的数据线代替测试；

6-2，检查模块跟程序端口的选择是否相同对应；

6-3, 重启主机，有复位键的模块按一下复位（如语音模块，MP3模块）；

6-4，程序运行时间不够导致死机，比如MP3模块，如果给的播放时间太短就会引起死机的情况；

3-7 物联网Blynk常见问题

A: 当只是简单的物联网可以直接用ESP8266或ESP32类主控，IO很多的项目可以用C01(UNO)+ESP8266模块，这样端口更多，同时也有了网络，不足的是UNO的内存及运行资源有限，当过多的运算或拓展传感器时可能引发掉线，但对于简单的项目还是可以运行正常的！

B: 当主要运行为网络项目时，外接只是一两个传感器时，建议采用齐护物联屏IOT(ESP8266), 这样节省了成本，同时网络运行稳定！

C: 当运行的外拓展设备多，同时要求网络内存结构多时采用C02主控（ESP32)板, 功能强大！

如下问题主要是出现在A种用法时，但BC用法也可以参考。

7-1，连接不上服务器：

串口监控出现：AT+CIPSTART=1"TCP",“182.61.28.31”,8080,程序中过多的运算不合规，比如应用到了定时器又用到了延时，或模块的库文件内带时间函数也会影响到运行，程序过于复杂，主机运算不过，比如OLED的显示，舵机的动作过于频繁等，先从一个简单的程序开始调试，再一步步按教程学习分步功能。

如果还不行，检查连接线，wifi密码等，最后可能是服务器故障，联系客服人员，重启服务器。

7-2，连接模块后连不上网：

A:检查设置的用户名，密码，手机APP上项目的授权码，对不对的上！

B:插上模块后一下要断电重启，约等20秒后自动连接。

C:Wi-Fi名称不可以有中文。
D:Wi-Fi是否为2.4GHz，不支持5GHz。
E:Wi-Fi名称密码区分大小写，必须一致。
F:苹果手机分享热点无法连接的，安卓热点可以用。
7-3，连线后容易断线：

A:检查程序内不可以有刷新频率小于1秒的动作，否则Blynk会关闭连接，这是Blynk的规则；

B:程序内如果用了系统定时器，就不可以用在程序中的延时功能，切记！只能二选一。

3-8 蓝牙模块连不上

1，蓝牙模块当拔开USB线后容易断线（主要发生在C01系）：蓝牙模块供电不足，或用一个小电池在USB上供电，像充电宝一样，应急用一下，尽快联系厂家更换！

2，当电脑跟主机互动时，蓝牙模块不能连接到手机，因为蓝牙跟上传USB口是同一个口，同时只能跟一种设备通讯（二选一，优先先插入的）。

9、OLED模块Arduino下常见的问题
1，编译时间长：因为 OLED 用的 U8G的库时处理的数组信息大，所以编译会时间更久，耐心！

2，UNO内存不足：OLED 指令用的多时会占用更多的内存，所以尽量少用，内容能用变量的就用变量，减少块的使用，或换用ESP主控。

3，用汉字时影响其它的串口模块：因库及 Arduino 的内部机制的原因，当用汉化及画图功能块时有时会影响到串口，运行前先测试！

4、更多关于Mixly软件及编程的学习

可以参考在线学习文库：http://wiki.qdprobot.com