QPYcom工具常见问题

2023-08-31

模块连接PC机后，QPYcom不显示COM口

  1. 确保模块已经开机。开发板按PWRKEY按键开机（确认开机可通过模块VDD_EXT引脚是否输出1V8电压判定，有证明已开机）；
  2. 确保模块对应的驱动已安装。不同平台模组驱动不一致，不能确认可咨询FAE；
  3. 检查USB连接线确为4线USB线，可进行数据交互；
  4. 客户绘制PCB请检查USB_VBUS引脚是否有已被拉高。该引脚控制USB识别使能（注：该引脚拉高会导致模块无法进入低功耗模式，建议直连PC_USB电压端）。

QPYcom打开交互口之后显示设备未连接或操作没有任何反应

  1. 确认模块是否已经烧录Python固件。可以通过USB_AT_Port发生ATI命令查询，如果固件名中不包含QPY字样，证明并非Python固件，需重新下载Python固件；
  2. 检查选择的端口是否正确并且已打开；
  3. 确认模块内是否已经存在main.py文件。

上传到模组里面的源码文件安全吗？

上传至模组的文件可以通过特定方式读出（如：HTTP_Post操作），但客户源文件可以保证安全。QPYcom工具有代码混淆加密功能，量产阶段可对代码进行加密，确保用户程序不被直接暴露。详细操作可参考“进阶开发-量产”相关章节进行了解。

各模块驱动是否支持Windows7/WindowsXP系统

不同平台驱动情况不一致，大部分都能支持Windows10/Windows8/Windows7系统，而不支持WindowsXP系统。

QPYcom是否支持Windows7/WindowsXP系统

官网发布的Windows版本为64位机版本，可在64位Windows7/8/10系统上运行。32位机系统暂不支持。

QPYcom工具是否有Mac/Linux系统的

QPYcom已经支持windows系统及Linux系统，Mac系统待开发。

QPYcom下载固件应该选择哪个串口？

QPYcom工具下载固件不需要选择/打开串口，QPYcom工具会自动识别端口。模组的USB驱动枚举出的端口都有唯一固定定的ID，QPYcom会根据ID识别出烧录端口。

用QPYcom下载固件失败怎么排查？

  1. 检查固件版本跟模块型号是否匹配；
  2. 检查下载所选固件文件是否正确；
  3. 进入强制下模式之后烧录固件是否成功。

拖动文件到模组工具提示出现语法错误

  1. 检查''.py''文件是否为UTF-8编码，QuecPython只支持UTF-8编码方式；
  2. 检查“.py”文件缩进是否符合Python语法，Python内缩进类似与C中的“{}”，范围必须明确。

QPYcom工具只能烧录Python固件吗？

QPYcom工具是为调试QuecPython而生，固件下载功能针对python固件，不支持其它固件的烧录。

QPYcom是否能导出模组内部的文件？若能，如何保证脚本安全？

截至2023/07/05，QPYcom暂未开放该功能。模组内部文件可以通过模组的Python交换口读出。

为保障客户脚本安全，建议客户发布产品时对脚本进行加密。并通过system.replSetEnable(flag，**kw_args)接口或system.replChangPswd(old_password,new_password)接口关闭交互口或加密交互口。

QPYcom工具是否支持增/删/改/查模组分区？

截至QPYcom_V3.1.1版本，QPYcom工具已经支持ASR平台全系列模块及RDA8910系列模组的customer分区的调整。主要调整customer_fs分区（usr分区，客户代码存放空间。）与customer_backup_s分区（bak分区，客户备份代码存放空间。）占比，来适用与不同客户需求。

客户也可通过外挂存储设备的方式增加外置分区（ext分区），此分区添加需外扩响应硬件设备。

QuecPython脚本为明文，怎么确保脚本安全？

QPYcom支持脚本加密功能，采用哈希算法，将明文脚本加密为二进制文件。保护脚本安全，防止重要信息外露。

在此基础上QPYcom添加备份还原功能，usr分区（客户脚本存放空间）脚本异常时出发备份区脚本还原功能。防止程序运行中脚本误操作现象。

量产时固件跟脚本代码必须分开烧录吗？

不需要。QPYcom可以将客户脚本合并到固件内部。更有批量烧录工具，可以实现一拖八的下载，大大提升生成速度。具体操作详见 QuecPython官网-文档中心-进阶开发-量产 章节进行了解。

FOTA升级所需的升级包怎么制作？

截至QPYcom_V3.1.1版本，QPYcom工具已经支持ASR_CAT-1/RDA_CAT-1/EC200A的升级包制作。操作流程简单，点击QPYcom工具上的“FOTA升级”按钮，根据不同型号选择不同选项按提示流程进行即可。