一、有线连接特性问题

1. 插入数据线后连接编程掌机，作品上显示“未检测到硬件设备”，如图：

解决方法：
a. 请检查掌机是否已开机；
b. 如果掌机已开机，请更换USB口尝试；
c. 如果掌机已开机，请更换数据线尝试；
d. 如果使用的拓展坞，请更换拓展坞或直接使用电脑的USB口尝试；
e. 如果以上操作无法解决请反馈到知音楼群“编程硬件技术支持群”。

2. 插上掌机后，作品上提示未启动助手or检查电脑是否启动编程助手

解决方法：
a. 检查电脑上是否启动了编程助手
windows系统 ，检查任务栏右下角：

mac系统，检查任务栏：

b. windows系统检查是否关闭了防火墙，如图为已经关闭防火墙

关闭windows防火墙的方法：
百度链接：https://jingyan.baidu.com/article/17bd8e52083ce685ab2bb839.html

3. 提示电脑系统版本过低，需安装驱动

解决方法：
a. 保持数据线连接着掌机、电脑，掌机开机状态，点击下载安装，根据提示进行安装
b. 如果安装失败，重新插拔数据线，再次安装
c. 如果仍失败，提供截图，反馈到“编程硬件技术支持群“，技术老师远程解决。

4. 提示硬件升级，此项为要更新掌机固件

解决方法：
a. 保持数据线连接掌机、电脑，掌机开机状态，点击立即更新，根据引导进行更新；
b. 如果出现更新失败、进度一直显示为0、掌机白屏



b.1 固件刷新失败，点击重试再次尝试更新；
b.2 如果仍失败，重新插拔数据线、掌机关机—重新开启， 再次固件更新；
b.3 如果仍失败，更换电脑上的USB口再次更新；
b.4 如果仍失败，更换数据线重新连接后再次更新；
b.5 如果连接着拓展坞，更换拓展坞或直接插电脑上的USB口再次更新；
b.6 如果以上方法都不行，提供截图+操作系统版本，反馈到知音楼群“编程硬件技术支持群”，技术老师远程解决。

5. 作品页面上掌机icon上显示存在红点

此状态为掌机正在处理资源，请保持掌机静置，需等待红点变为绿点后再操作作品、掌机

6. 连接编程掌机时，提示一直处于连接状态

解决方法：
a. 等待6s左右，观察是否连接成功；
b. 如果未连接上，重启掌机、重启编程助手，再次点击连接编程掌机按钮；
c. 如果未连接上，重新插拔数据线或更换一个USB口，再次点击连接编程掌机按钮；
d.以上步骤都不行，截图发到知音楼群“编程硬件技术支持群”，技术老师远程解决；

7. 掌机非小程序二维码页面，掌机显示文件上传中 or main.py上传中，掌机未运行代码，显示小程序二维码页面

解决方法：
a. 在文件上传、代码上传过程中确认不要触碰掌机的rst键；
b. 掌机按rst+B格式化掌机，格式化完成后重新连接掌机、运行代码；

二、无线连接特性问题

1. 小程序未找到编程掌机

解决方法：
a. 确认掌机已开机，且已经位于小程序二维码页面；
b. 确认手机开启了蓝牙，且对小程序进行了蓝牙授权，安卓手机需确认对小程序也开启了定位授权；

2. 小程序中不显示我家的wifi

解决方法：
a. 确认家里的路由器开启了2.4G频段，掌机支持2.4G频段和融合网络（2.4G/5G），只开启5G频段，掌机不支持。
a.1 可以尝试手机开热点配网（运行小程序的手机开热点即可，先开热点，再操作掌机进入小程序二维码页面，然后小程序往下走流程即可）
a.2 如果手机热点可以成功，则说明之前的wifi是5G频段，需要去路由器设置页面更改设置，百度链接：https://jingyan.baidu.com/article/9113f81b366a946a3314c722.html

b. 掌机移到离路由器近的地方；

3. 掌机连接wifi时，提示如图

解决方法：
a. 移动掌机到距离路由器近的地方，使用小程序重新帮掌机连接wifi，确认输入的是正确wifi密码。

4. 掌机连接wifi时异常信息、报错

解决方法：
a. 按rst+右键，使掌机重新连接wifi；
b. 如果仍失败，移动掌机到路由器近的地方，按rst+B格式化掌机后，使用小程序重新帮掌机连接wifi。

5. 作品页面上掌机icon上显示存在红点

此状态为掌机正在处理资源，请保持掌机静置，需等待红点变为绿点后再操作作品、掌机。

6. 掌机文件下载过程中（即作品页面上点击运行代码提示”图片资源正在上传中“）异常信息、报错

解决方法：
a. 按rst+右键，使掌机重新连接wifi，成功后刷新作品
b. 如果仍失败，按rst+B格式化完成后，移动掌机到路由器近的地方，使用小程序重新帮掌机连接wifi。

三、有线连接、无线连接 通性问题

1. 作品页面上提示文件添加失败 （有线、wifi均有）

解决方法：
a. 刷新作品，重连成功后观察；
b. 按掌机上的rst，刷新作品，重连成功后观察；
c. 如果仍提示失败掌机上按rst+B格式化掌机，格式化完成后刷新作品，重连成功后观察；

2. 运行代码后，掌机屏幕上显示程序写错了（有线、wifi均有）

此提示是代码中遇到语法错误、逻辑错误等的正常提示，需要去检查代码中是否存在错误。

3. 提示 释放编程掌机空间

解决方法：
a. 静置掌机，点击知道了，在掌机上显示复位状态、文件同步时，不要操作作品、掌机。

4. 作品页面提示请重启掌机，再次尝试连接（有线、wifi均有）

解决方法：
a. 按照提示，掌机关机—再开机，作品和掌机重新连接。

5. 运行代码，掌机黑屏 （有线、wifi均有）

解决方法：
a. 检查是否已经上传代码；
b. 检查是否是显示图片代码没有生效；
b.1 检查代码书写是否正确；
b.2 刷新作品，重新运行作品；

6. rst+B 操作中，掌机连接上作品，掌机上不下载文件、运行不了代码 （有线、wifi均有）

解决方法：
a. 掌机按rst+B后，不要操作作品、掌机，等待掌机格式化完成后，重新连接作品;