QUECTEL LTE-A 模块系列 带 USB 适配器的模块
产品信息
规格
- 产品系列: EG512R&EM12xR&EM160R 系列
- 模块版本： LTE-A 模块系列版本 1.2
- 日期： 2024-09-25
- 地位： 发布
产品使用说明
入门
在使用产品之前，请确保您已仔细阅读用户手册。
安装
按照用户手册中提供的安装说明正确设置产品。
手术
按照用户手册中概述的指导操作产品以获得最佳性能。
维护
按照用户手册中提供的维护计划定期维护和更新产品。
介绍
- 在移远，我们的目标是为客户提供及时、全面的服务。如果您需要任何帮助，请联系我们的总部：
- 移远无线解决方案有限公司
- 上海市闵行区田林路5号上海商务园三期（B区）1016号楼
- 200233，中国
- 电话: +86 21 5108 6236
- 电子邮件： info@quectel.com
- 或联系我们当地的办事处。如需更多信息，请访问： http://www.quectel.com/support/sales.htm.
- 如需技术支持或报告文档错误，请访问： http://www.quectel.com/support/technical.htm.
- 或者发邮件至： support@quectel.com.
法律声明
我们向您提供信息服务。所提供的信息基于您的要求，我们尽一切努力确保其质量。您同意您有责任在设计预期产品时使用独立分析和评估，我们提供的参考设计仅供说明之用。在使用本文档指导的任何硬件、软件或服务之前，请仔细阅读本声明。尽管我们尽商业上合理的努力提供最佳体验，但您特此承认并同意本文档及其相关服务是在“可用”的基础上向您提供的。我们可自行决定不时修订或重述本文档，而无需事先通知您。
使用和披露限制
许可协议
我们提供的文件和信息应保密，除非获得特别许可。除本文明确规定外，不得出于任何目的访问或使用。
版权
我们和本协议下的第三方产品可能包含受版权保护的材料。未经事先书面同意，不得复印、复制、分发、合并、出版、翻译或修改此类受版权保护的材料。我们和第三方对受版权保护的材料拥有专有权。不得根据任何专利、版权、商标或服务商标权授予或转让任何许可。为了避免歧义，以任何形式购买都不能被视为授予除正常的非独占、免版税使用该材料的许可之外的许可。我们保留对不遵守上述要求、未经授权使用或其他非法或恶意使用该材料采取法律行动的权利。
商标
除本文件另有规定外，本文件中的任何内容均不得解释为授予移远通信或任何第三方在广告、宣传或其他方面使用其任何商标、商号、名称、缩写或假冒产品的权利。
第三方权利
本文件可能涉及一个或多个第三方拥有的硬件、软件和/或文档（“第三方材料”）。此类第三方材料的使用应受所有适用限制和义务的约束。
我们不就第三方材料做任何明示或暗示的保证或陈述，包括但不限于任何暗示或法定的适销性或特定用途适用性、安静使用、系统集成、信息准确性以及不侵犯任何第三方关于许可技术或其使用的知识产权的保证。本文中的任何内容均不构成我们对开发、改进、修改、分发、营销、销售、提供销售或以其他方式维持任何我们的产品或任何其他硬件、软件、设备、工具、信息或产品的生产的陈述或保证。我们不承担因交易过程或贸易惯例而产生的任何保证。
隐私政策
为了实现模块功能，某些设备数据会被上传到移远或第三方服务器，包括运营商、芯片组供应商或客户指定的服务器。移远严格遵守相关法律法规，仅为了执行服务的目的或适用法律允许的目的而保留、使用、披露或以其他方式处理相关数据。在与第三方进行数据交互之前，请了解其隐私和数据安全政策。
免责声明
- 对于因依赖该信息而产生的任何伤害或损害，我们不承担任何责任。
- 对于任何不准确或遗漏，或因使用本文所含信息而导致的责任，我们概不承担。
- 尽管我们已尽一切努力确保正在开发的功能和特性没有错误，但它们仍可能包含错误、不准确和遗漏。除非有效协议另有规定，否则我们不提供任何明示或暗示的保证，并且在法律允许的最大范围内，对于因使用正在开发的特性和特性而遭受的任何损失或损害，无论此类损失或损害是否可预见，我们概不负责。
- 我们对第三方信息、广告、商业报价、产品、服务和材料的可访问性、安全性、准确性、可用性、合法性或完整性不承担任何责任。 web网站和第三方资源。
介绍
- 移远 LTE-A EG512R-EA、EM120R-GL、EM121R-GL、EM160R-GL系列模组支持FOTA（Firmware Over-The-Air）功能，可以升级modem、system、boot、sbl、tz等分区的固件。
- 通过该功能，您（用户）可以将模块固件升级到新版本，也可以将固件恢复到旧版本，固件包中只包含原固件版本与目标固件版本的差异部分，数据传输量大大减少，传输时间也大大缩短。
FOTA 实施和用户责任
- 移远通信遵循行业最佳实践，通过允许用户提供 FOTA 更新来更新其模块的固件。请注意，移远通信无法单方面将更新推送到用户的设备。移远通信将 FOTA 流程的全部控制权交给用户。在此过程中，移远通信仅提供更新的固件，但无法在用户的设备上启动 FOTA 更新。
- 用户可以通过配置用户在其基础设施上托管的更新的相应参数来确定何时使用 FOTA 机制将更新推送到 Quectel 模块。
应用模块
表 1：适用模块
通过 FOTA 进行固件升级过程
下图说明了当固件包存储在 FTP/HTTP(S) 服务器上时通过 FOTA 进行固件升级的过程。
如上图所示，当固件包存储在FTP/HTTP(S)服务器上时，需要执行以下步骤来更新固件：
- 步骤 1：从 Quectel 技术支持获取固件包。
- 步骤 2： 将固件包从主机上传到您的 FTP/HTTP(S) 服务器。
- 步骤 3： 在主机上执行AT+QFOTADL，触发模块自动固件升级。
- 步骤 4：模块通过LTE/WCDMA网络自动从您的FTP/HTTP(S)服务器下载固件包。
- 步骤 5：模块内部运行更新程序，自动升级模块固件。
笔记
您负责提供和管理用于固件升级的 FTP/HTTP(S) 服务器。Quectel 不提供服务器或协助设置。
获取固件包
固件升级前，请先与ATI核对原固件版本名称，确认目标固件版本，然后将两个固件版本发送给Quectel技术支持，以获取相应的固件包。
将固件包上传至 FTP/HTTP(S) 服务器
- 步骤 1： 使用 FOTA 功能前，请先设置 FTP/HTTP(S) 服务器。（移远通信不提供此类服务器。）
- 步骤 2：完成服务器设置后，将固件包上传到您的服务器，并保存存储路径。
执行AT命令升级固件
将固件包上传到FTP/HTTP(S)服务器后，在主机上执行AT+QFOTADL，即可启动模块固件包的自动无线下载和升级。
笔记
该模块支持通过 FTP/HTTP(s) 服务器和本地 file 系统。有关通过本地 file 系统。
FOTA AT 命令说明
AT指令介绍
定义
- 回车符。
- 换行符。
- <…> 参数名称。 尖括号不会出现在命令行上。
- […] 命令的可选参数或 TA 信息响应的可选部分。命令行中不出现方括号。当命令中未给出可选参数时，新值等于其先前的值或默认设置，除非另有规定。
- 强调 参数的默认设置。
AT 命令语法
所有命令行必须以 AT 或 at 开头并以信息响应和结果代码始终以回车符和换行符开始和结束：
. 在本文档中介绍命令和响应的表格中，仅显示命令和响应，并且和被故意省略。
表 2：AT 命令的类型
AT 命令 Ex 声明amp莱斯
AT 命令前amp本文档旨在帮助您了解本文介绍的AT命令的使用。 前任amp但不应将这些文件视为移远通信关于如何设计程序流程或将模块设置为何种状态的推荐或建议。 有时有多个前任amp可以为一个 AT 命令提供文件。 然而，这并不意味着这些前项之间存在相关性。amp文件，或者它们应该按照给定的顺序执行。 URLAT 命令中的域名、IP 地址、用户名/账户和密码（如果有）amp文件仅供说明和解释之用，应进行修改以反映您的实际使用情况和特定需求。
AT+QFOTADL 通过 FOTA 固件升级
该命令开启FOTA自动固件升级功能，执行相应命令后，模块会自动从FTP/HTTP(S)服务器或本地下载或加载固件包。 file 系统升级包下载或加载成功后，模块会自动升级固件并重启。
| 在+ QFOTADL 通过 FOTA 升级固件 | |
| 测试命令
在 + QFOTADL=？ |
回复
OK |
| 最大响应时间 | 300 毫秒 |
在+ QFOTADL =URL> 通过 FTP 服务器升级固件
如果固件包存储在FTP服务器上，执行AT + QFOTADL =URL> 通过FOTA启动自动固件升级，模块会从FTP服务器无线下载固件包，然后自动重启并升级固件。
| 在+ QFOTADL =URL> 通过 FTP 服务器升级固件 | |
| 写命令
在+ QFOTADL =URL> |
回复
OK |
| +QIND：“FOTA”，“FTPSTART”
+QIND：“FOTA”，“FTPEND”， +QIND：“FOTA”，“开始” +QIND：“FOTA”、“正在更新”、 +QIND：“FOTA”、“正在更新”、 … +QIND：“FOTA”，“结束”， |
|
| 最大响应时间 | 300 毫秒 |
| 特征 | – |
范围
- <FTP_URL> 字符串类型。 URL 固件包存储在 FTP 服务器上。
最大长度：512；单位：字节。必须以“ftp://”开头。
例如ample：“ftp:// ： @URL>： /file_path>”。 - 字符串类型，用于认证的用户名。
- 字符串类型，认证密码。
- <serverURL> 字符串类型。您所拥有并运营的FTP服务器的地址。
- 整数类型。FTP 服务器的端口。范围：1–65535。默认值：21。
- <file_路径> 字符串类型。 file FTP 服务器上的名称。
- 整数类型，FTP错误码。
0 成功从 FTP 服务器下载固件包。
其他人无法从 FTP 服务器下载固件包。 - 整数类型，升级进度以百分比表示tage.范围：0–100。
- 整数类型 升级错误码 0 升级固件成功
其他固件升级失败。
Example
- 将固件包存储在FTP服务器上后，即可执行固件升级。
“ftp://测试:test@192.0.2.2:21/Jun/update-v12-to-v13.zip” 用作例子ample URL 以下。（ URL 仅供说明之用。请将其替换为有效的 URL （对应你的FTP服务器和固件包）执行以下命令，启动FOTA自动固件升级，模块自动下载固件包并升级固件。 - AT + QFOTADL =”ftp://测试:test@192.0.2.2:21/Jun/update-v12-to-v13.zip“ 好的
- +QIND：“FOTA”，“FTPSTART”
- +QIND: “FOTA”, “FTPEND”,0 //完成从FTP服务器下载固件包。
- 模组自动重启，重新初始化USB口，若当前端口为USB口，MCU应关闭并重新打开，模组重启后90秒内应上报第一个URC，否则表示未知错误。
- +QIND：“FOTA”，“开始”
- +QIND：“FOTA”，“正在更新”，1
- +QIND：“FOTA”，“正在更新”，20
- +QIND：“FOTA”，“正在更新”，100
- +QIND: “FOTA”, “END”,0 //模块自动重启，完成FOTA升级。
在+ QFOTADL =URL> 通过 HTTP(S) 服务器升级固件
如果固件包存储在HTTP（S）服务器上，请执行AT + QFOTADL =URL> 通过 FOTA 启动自动固件升级。模块将通过无线方式从 HTTP(S) 服务器下载软件包，然后自动重启并升级固件。
| 在+ QFOTADL =URL> 通过 HTTP(S) 服务器升级固件 | |
| 写命令
在+ QFOTADL =URL> |
回复
OK |
| +QIND：“FOTA”，“HTTPSTART”
+QIND：“FOTA”，“HTTPEND”， +QIND：“FOTA”，“开始” +QIND：“FOTA”、“正在更新”、 +QIND：“FOTA”、“正在更新”、 … +QIND：“FOTA”，“结束”， 如果有任何错误： 错误 |
|
| 最大响应时间 | 300 毫秒 |
| 特征 | – |
范围
- <HTTP_U祢 URL 固件包存放在HTTP(S)服务器中，最大长度为512；单位：字节。
它应该以“http(s)://”开头。例如ample：“http（s）://URL>： /file_path>”。 - <HTTP_server_URL> 字符串类型。您所拥有并运营的HTTP(S)服务器的IP地址或域名。
- 整数类型。HTTP(S) 服务器的端口。范围：1–65535。默认值：80。
- <HTTP_file_路径> 字符串类型。 file HTTP(S) 服务器上的名称。
- 整数类型。HTTP(S) 错误代码。
- 0 成功从 HTTP(S) 服务器下载固件包
- 其他的 无法从 HTTP(S) 服务器下载固件包。
- 整数类型，升级进度以百分比表示tage.范围：0–100。
- 整数类型，升级错误码。
- 0 固件升级成功
- 其他的 固件升级失败。
Example
- 将固件包存储在HTTP（S）服务器上后，您就可以执行固件升级。“http://www.example.com:100/update.zip” 用作例子ample URL 以下。（ URL 仅供说明之用。请将其替换为有效的 URL 与您的 HTTP(S) 服务器和固件包相对应的命令。）执行以下命令通过 FOTA 启动自动固件升级。
模块自动下载固件包并升级固件。
AT + QFOTADL =”http://www.example.com:100/update.zip“ 好的- +QIND：“FOTA”，“HTTPSTART”
- +QIND: “FOTA”, “HTTPEND”,0 //完成从HTTP服务器下载固件包。
- 模块自动重启，USB口重新初始化，当前端口为USB口，MCU应关闭并重新打开，模块重启后90秒内应上报第一个URC，否则表示未知错误。
- +QIND：“FOTA”，“开始”
- +QIND：“FOTA”，“正在更新”，1
- +QIND：“FOTA”，“正在更新”，2
- +QIND：“FOTA”，“正在更新”，100
- +QIND: “FOTA”, “END”,0 //模块自动重启，完成FOTA升级。
在+ QFOTADL =file_name> 通过本地升级固件 File 系统
如果固件包已经存储在模块的 file 系统，执行AT+QFOTADL=file_name> 启动 FOTA 自动固件升级，模块会从本地加载软件包 file 系统，然后重启并自动升级固件。
| 在+ QFOTADL =file_name> 通过本地升级固件 File 系统 | |
| 写命令
在+ QFOTADL =file_名字> |
回复
OK |
| +QIND：“FOTA”，“开始”
+QIND：“FOTA”、“正在更新”、 +QIND：“FOTA”、“正在更新”、 … |
|
| 最大响应时间 | 300 毫秒 |
| 特征 | – |
范围
- <file_名字> 字符串类型，固件包路径存储在本地 file 系统。最大长度：512；单位：字节。在UFS中必须以“/cache/ufs/”开头。
- 整数类型，升级进度以百分比表示tage.范围：0–100。
- 整数类型，升级错误码。
- 0 固件升级成功
- 其他的 无法升级固件。
笔记
- 使用该命令前请确保模块中已保存固件包，可以通过AT+QFUPL将固件包上传到模块，AT+QFUPL的详细说明见文档[1]。
- 进行FOTA升级之前请先断开主机的数据通话，因为主机与模组进行数据通话时，会导致模组内部FOTA升级程序无法进行数据通话。
- 第一个 APN 用于 FOT 时的数据呼叫，默认 A 升级。如果第一个 APN 的数据呼叫被模块的某个程序占用，模块不能同时使用该 APN 进行另一个数据呼叫。因此，模块应在程序断开与该 APN 的数据呼叫后或执行 AT+QFOTAPID 切换信道后进行 FOTA 升级。
- 若Verizon认证使用第一个APN进行数据呼叫，建议使用AT+QFOTAPID切换信道进行FOTA升级。
- 有关AT+QFOTAPID的详细信息，请联系移远技术支持。
Example
- 当固件包存储在本地时升级固件 file 系统。
AT+QFOTADL=”/cache/ufs/update-v12-to-v13.zip”
OK - 模块自动重启，USB口重新初始化，当前端口为USB口，MCU需要关闭再重新打开，模块重启后90秒内需要上报第一个URC，否则表示未知错误。
- +QIND：“FOTA”，“开始”
- +QIND：“FOTA”，“正在更新”，1
- +QIND：“FOTA”，“正在更新”，2
- +QIND：“FOTA”，“正在更新”，100
- +QIND: “FOTA”, “END”,0 //模块自动重启，完成FOTA升级。
异常处理及注意事项
异常处理
为了提高升级成功率，模块在开始升级前会设置升级标志，升级过程中报错时模块会自动重启，找到升级标志后模块会继续升级，如果升级失败五次，则升级彻底失败，模块会删除标志，退出，尝试正常启动模块。升级界面如下：
- +QIND：“FOTA”，“开始”
- +QIND：“FOTA”，“正在更新”，20
- +QIND：“FOTA”，“结束”，
…
//模块自动重启
… - +QIND：“FOTA”，“开始”
- +QIND：“FOTA”，“正在更新”，20
- +QIND：“FOTA”，“正在更新”，30
… - +QIND：“FOTA”，“结束”，0
笔记
连续升级次数仅在升级报错时有效，异常断电情况下升级次数不受限制。模块升级过程中若发生异常断电，重启模块后仍可继续升级。升级成功后，升级标志也会被删除。
防范措施
- 执行AT+QFOTADL后主机收到URC +QIND: “FOTA”, “START”表示升级开始，URC +QIND: “FOTA”, “END”,0表示升级完成。升级完成后模块自动重启，进入正常模式。升级过程中请勿断电。
- 如果升级过程中主机4分钟内没有收到任何URC，可以重启模块。
- 建议设置一个标志来标记固件升级任务，并在升级成功完成后将其删除。
笔记
建议FOTA升级过程中不要关闭模块电源。
错误代码汇总
本章介绍移远模块及其他网络相关的错误代码。 ， ， 和如下表所述。
表 3：摘要代码
表 4：摘要代码
表 5：摘要代码
附录参考资料
表 6：相关文件
表 7：术语和缩写
关于本文档
修订历史
常见问题 (FAQ)
- 在哪里可以找到该产品的技术支持？
如需技术支持，请访问 http://www.quectel.com/support/technical.htm 或发送电子邮件 support@quectel.com. - 如何报告文档错误？
要报告文档错误，请访问 http://www.quectel.com/support/technical.htm 或联系 support@quectel.com.
文件/资源
 |
QUECTEL LTE-A 模块系列 带 USB 适配器的模块 [pdf] 用户指南 EG512R、EM12xR、EM160R、LTE-A 模块系列带 USB 适配器的模块、LTE-A 模块系列、带 USB 适配器的模块、带 USB 适配器、USB 适配器 |
