移远 LTE 模块 OuecOpen 开发指导
移远 LTE 模块 QUECOPEN 开发指导
LTE 系列
版本:v0.6
上海移远通信技术股份有限公司
移远 LTE 模块 OuecOpen 开发指导
移远公司始终以为客户提供最及时、最全面的服务为宗旨,如需任何帮助,请随时联系我司
上海总部,联系方式如下:
上海移远通信技术股份有限公司
上海市徐汇区虹梅路 1801 号宏业大厦 7 楼 电话:+86 021-51086236
邮箱:info@quectel.com
或联系我司当地办事处,详情请登录:
http://www.quectel.com/support/salesupport.aspx
如需技术支持或反馈我司技术文档中的问题,可随时登陆如下网址:
http://www.quectel.com/support/techsupport.aspx
或发送邮件至:Support@quectel.com
前言
移远公司提供该文档内容用以支持其客户的产品设计。客户须按照文档中提供的规范,参数
来设计其产品。由于客户操作不当而造成的人身伤害或财产损失,本公司不承担任何责任。
在未声明前,移远公司有权对该文档规范进行更新。
版权申明
本文档手册版权属于移远公司,任何人未经我公司允许复制转载该文档将承担法律责任。
版权所有 ©上海移远通信技术股份有限公司 2018,保留一切权利。
Copyright © Quectel Wireless Solutions Co., Ltd. 2018.
上海移远通信技术股份有限公司
移远 LTE 模块 OuecOpen 开发指导
关于本文
本文介绍移远 LTE 模块 Openlinux 方案的操作指导和常用技巧。
本文说提及的文档,都可在资料包里面找到。若无资料包,可向移远申请。
在此约定:文中绿色加底的文字皆为资料包内文件名称的关键字
修改历史
版本
时间
作者
2018-08-23
Golden
备注
初稿
0.5
0.6
2018-08-28
Golden
添加 FOTA 功能,修改驱动 Makefile
上海移远通信技术股份有限公司
移远 LTE 模块 OuecOpen 开发指导
目录
移远 LTE 模块 QUECOPEN 开发指导 ....................................................................................... 1
关于本文 ................................................................................................................................... 3
修改历史 ................................................................................................................................... 3
1 模块开发的准备工作 ....................................................................................................... 7
1.1 安装 LTE 模块 ................................................................................................................ 7
1.2 模块内部资源 ................................................................................................................ 8
2 开发环境安装 ................................................................................................................... 9
2.1 Windows 的环境安装 ................................................................................................... 9
2.1.1 安装 Quectel USB driver 驱动 ................................................................................... 9
2.1.2 安装 ADB 驱动 ......................................................................................................... 10
2.2
Linux 下的环境安装 .................................................................................................... 11
2.2.1 安装 adb 工具 .......................................................................................................... 11
2.2.2 添加 Quectel USB driver 到 ubuntu 系统上 ........................................................... 11
2.2.3
Ubuntu 安装工具 .................................................................................................... 14
3 下载和功能测试 ............................................................................................................. 14
3.1 升级 OCPU 版本 .......................................................................................................... 15
3.1.1 Windows 下升级版本 .............................................................................................. 15
3.1.2
Linux 下升级版本 .................................................................................................... 16
3.2
SDK 编译 ...................................................................................................................... 17
3.2.1 解压 SDK 开发包 ..................................................................................................... 17
3.2.2 编译内核和 rootfs ................................................................................................... 17
3.3 功能测试...................................................................................................................... 17
3.3.1
AT 命令测试............................................................................................................. 17
3.3.2 日志打印测试 .......................................................................................................... 18
3.3.3
Codec 功能测试 ....................................................................................................... 19
3.3.4 WIFI/以太网功能测试 ............................................................................................. 20
3.3.5
GPS 功能测试 .......................................................................................................... 23
4 主要功能的自定义开发 ................................................................................................. 25
4.1
UART............................................................................................................................. 25
4.2
SPI ................................................................................................................................. 25
上海移远通信技术股份有限公司
移远 LTE 模块 OuecOpen 开发指导
4.3
I2C ................................................................................................................................ 26
4.4
GPIO ............................................................................................................................. 26
4.5
Codec /PCM/I2S ........................................................................................................... 26
4.6 Wifi ............................................................................................................................... 26
4.7
SGMII/Ethernet ............................................................................................................ 26
4.8
4.9
eMMC、SD/TF 卡 ........................................................................................................ 27
USB 网络 ...................................................................................................................... 28
4.9.1 移远 LTE 模块支持的 USB 网卡类型 ...................................................................... 28
4.9.2
GobiNet/QMI_wwan 网卡模式 ............................................................................... 29
4.9.2.1 qmi_wwan 驱动 ....................................................................................................... 29
4.9.2.2 GobiNet 驱动 ........................................................................................................... 30
4.9.2.3 数据拨号 Quectel-CM ......................................................................................... 32
4.9.3
RNDIS 驱动的补充 ................................................................................................... 33
4.10 模块内部拨号与 APN 配置 ..................................................................................... 33
4.10.1 数据拨号 .................................................................................................................. 33
4.10.2 APN 设置 .................................................................................................................. 34
4.11 模块+MCU:低功耗模式 ........................................................................................ 35
4.12 FOTA 升级 .................................................................................................................... 37
4.12.1 DFOTA 升级 .............................................................................................................. 37
4.12.2 全量 FOTA 升级 ....................................................................................................... 40
5 开发技巧和常见问题 ..................................................................................................... 41
5.1 window 下 adb shell 执行 ls 乱码的解决方法 ........................................................... 41
5.2 模块变砖的解救方法 .................................................................................................. 41
5.3
5.4
DEBUG COM 显示 kernel log 的修改方法 .................................................................. 44
SDK 编译内核出错的原因 .......................................................................................... 44
5.5 不能注网的排查方法 .................................................................................................. 45
5.6 抓取 kernel/modem log 以及 modem dump 的方法 ............................................... 47
USB 不能识别的排除方法 .......................................................................................... 52
Adb 无法识别的可能原因 ......................................................................................... 53
5.7
5.8
上海移远通信技术股份有限公司
移远 LTE 模块 OuecOpen 开发指导
上海移远通信技术股份有限公司
移远 LTE 模块 OuecOpen 开发指导
1 模块开发的准备工作
1.1 安装 LTE 模块
移远的 LTE Open EVB 开发板用于 LTE 模块功能开发测试,适用的 LTE 模块包含
EC20,AG35 等系列的。
模块安装到 EVB 开发板的示意图如下,除了 LTE 模块之外,EVB 还可以安装移远的
“WIFI+以太网 PHY”模块和“Codec”音频模块。
EVB 板上的几个波码开关,测试时根据实际需要来设置。比如,
左侧中间的波码 。测试 Codec 时,需要拨到右侧;BT 接口时,拨到左侧。
上海移远通信技术股份有限公司
移远 LTE 模块 OuecOpen 开发指导
右上角的两个波码开关,分别在测试 WIFI,EMMC 时需要拨到右侧,测试 SD/TF
卡时,下面的开关拨到左侧。
EVB 开发板上,在 LTE 模块两侧各有一组排针,如下图示意,模块左侧的右一列排针和
右侧的中间一列分别直连到 LTE 模块的 PIN 上。默认这些 PIN 是悬空,用跳线帽与左右
边的排针连接,如 PCB 丝印说明,外接到 EVB 的外围电路。
模块的开机键和复位键。上电后,需要按下 Pwrkey 持续 0.5 秒以上,模块会启动; 模
块启动后,按下 Pwrkey 持续 0.65 秒以上,模块进入关机。
EVB 的使用,详情可以见 PDF 文档 Quectel_LTE_OPEN_EVB_User_Guide_V1.0
1.2 模块内部资源
以下是模块的内部结构框图。 模块支持 SPI,UART,I2C,USB,WIFI,SGMII 等接口,内置
NAND FLASH + SDRAM。支持 MIMO 技术,有主副两路 LTE 天线接口;以及 GNSS 定
位天线接口。
上海移远通信技术股份有限公司