基本信息

硬件信息

硬件平台：T507 (Android 10 Linux 4.9)

模组型号：EC200U-CN（Cat1）（展讯芯片）

相关文件

代理提供

longan/kernel/linux-4.9/drivers/net/usb/qmi_wwan_q.c
android/vendor/aw/public/prebuild/lib/librild/lib/lib32/libquectel-ril.so
android/vendor/aw/public/prebuild/lib/librild/lib/lib64/libquectel-ril.so

内核驱动

longan/kernel/linux-4.9/drivers/net/usb/Makefile
longan/kernel/linux-4.9/drivers/net/usb/qmi_wwan_q.c
longan/kernel/linux-4.9/drivers/usb/serial/option.c
longan/kernel/linux-4.9/drivers/usb/serial/usb_wwan.c

系统适配

android/hardware/ril/rild/rild.rc
android/hardware/ril/rild/radio.xml
android/device/softwinner/common/sepolicy/vendor/rild.te
android/vendor/aw/public/prebuild/lib/librild/radio_common.mk
android/vendor/aw/public/prebuild/lib/librild/lib/lib32/libquectel-ril.so
android/vendor/aw/public/prebuild/lib/librild/lib/lib64/libquectel-ril.so

驱动类型

  • GobiNet Driver

    会生成 /dev/qcqmiX 设备节点和虚拟的 ethX 网卡（2.6.39 以下版本为 usbX）。

    内核配置 驱动文件
    CONFIG_USB_NET_DRIVERS
    CONFIG_USB_USBNET    		 linux-4.9/drivers/net/usb/GobiNet/GobiUSBNet.c
    linux-4.9/drivers/net/usb/GobiNet/QMIDevice.c
    linux-4.9/drivers/net/usb/GobiNet/QMI.c

  • qmi_wwan_q Driver

    会生成 /dev/cdc-wdmX 设备节点和虚拟的 wwanX 网卡。

    内核配置 驱动文件
    CONFIG_USB_NET_DRIVERS
    CONFIG_USB_USBNET
    CONFIG_USB_NET_QMI_WWAN
    CONFIG_USB_WDM    		 linux-4.9/drivers/net/usb/qmi_wwan.c
    linux-4.9/drivers/net/usb/qmi_wwan_q.c

  • ACM/ECM/RNDIS/NCM/MBIM Driver

    会生成 /dev/ttyUSB0 ~ /dev/ttyUSB6 和虚拟的 usbX 网卡。

    驱动类型 内核配置 驱动文件
    ACM CONFIG_USB_ACM linux-4.9/drivers/usb/serial/option.c
    linux-4.9/drivers/usb/serial/usb_wwan.c
    linux-4.9/drivers/net/usb/cdc-acm.c
    ECM CONFIG_USB_NET_DRIVERS
    CONFIG_USB_USBNET
    CONFIG_USB_NET_CDCETHER    		 linux-4.9/drivers/usb/serial/option.c
    linux-4.9/drivers/usb/serial/usb_wwan.c
    linux-4.9/drivers/net/usb/cdc-ether.c
    RNDIS CONFIG_USB_NET_DRIVERS
    CONFIG_USB_USBNET
    CONFIG_USB_NET_CDCETHER    		 linux-4.9/drivers/usb/serial/option.c
    linux-4.9/drivers/usb/serial/usb_wwan.c
    linux-4.9/drivers/net/usb/rndis_host.c
    NCM CONFIG_USB_NET_DRIVERS
    CONFIG_USB_USBNET
    CONFIG_USB_NET_CDCETHER    		 linux-4.9/drivers/usb/serial/option.c
    linux-4.9/drivers/usb/serial/usb_wwan.c
    linux-4.9/drivers/net/usb/cdc_ncm.c
    MBIM CONFIG_USB_NET_DRIVERS
    CONFIG_USB_USBNET
    CONFIG_USB_NET_CDCETHER    		 linux-4.9/drivers/usb/serial/option.c
    linux-4.9/drivers/usb/serial/usb_wwan.c
    linux-4.9/drivers/net/usb/cdc_mbim.c

驱动适配

这里使用 ECM 的驱动方式，参考《Quectel_UMTS_LTE_5G_Linux_USB_Driver_User_Guide_V3.0.pdf》

驱动移植

未涉及到电源控制，调试时使用的是开发板，手动给模组开机，因此下列会缺少电源控制的步骤。

  • 涉及文件列表

    // 需要修改的内核配置
longan/kernel/linux-4.9/.config

// 需要修改的驱动文件
longan/kernel/linux-4.9/drivers/usb/serial/option.c
longan/kernel/linux-4.9/drivers/usb/serial/usb_wwan.c

// 需要用到的驱动文件
longan/kernel/linux-4.9/drivers/net/usb/cdc-acm.c
longan/kernel/linux-4.9/drivers/net/usb/cdc-ether.c

  • 在 option_ids 列表内增加 EC200U-CN 的 PID\VID， 这样才能识别到该 USB 设备为串口设备，文档内可查。

    // linux-4.9/drivers/usb/serial/option.c
static const struct usb_device_id option_ids[] = {
#ifdef SUPPORT_QUECTEL
	{ USB_DEVICE(0x2C7C, 0x0901) }, // support EC200U/EG915U
#endif
    ......
}

  • 一个 USB 设备可以有多个功能不同的接口，在 option_ids 添加该设备的 PID\VID 后，会导致该设备的所有接口都会绑定到 USB Serial Option 驱动上，导致 USBNet 驱动接口无法正常工作，因此需要在 option_probe 中根据类码、接口索引、端点数量、子类码将 USBNet 的接口排除出来。

    // linux-4.9/drivers/usb/serial/option.c
static int option_probe(struct usb_serial *serial, const struct usb_device_id *id)
{
	......	
#ifdef SUPPORT_QUECTEL 
	if (serial->dev->descriptor.idVendor == cpu_to_le16(0x2C7C)) {
		__u16 idProduct = le16_to_cpu(serial->dev->descriptor.idProduct);
		struct usb_interface_descriptor *intf = &serial->interface->cur_altsetting->desc;
		if (intf->bInterfaceClass != 0xFF || intf->bInterfaceSubClass == 0x42) {
			//ECM, RNDIS, NCM, MBIM, ACM, UAC, ADB
			return -ENODEV;
		}
		if ((idProduct&0xF000) == 0x0000) {
			//MDM interface 4 is QMI
			if (intf->bInterfaceNumber == 4 && intf->bNumEndpoints == 3 && intf->bInterfaceSubClass == 0xFF && intf->bInterfaceProtocol == 0xFF)
				return -ENODEV;
		}
	}
	#ifdef SUPPORT_QUECTEL_AUTO_SUSPEND
	//For USB Auto Suspend
	if (serial->dev->descriptor.idVendor == cpu_to_le16(0x2C7C)) {
		pm_runtime_set_autosuspend_delay(&serial->dev->dev, 3000);
		usb_enable_autosuspend(serial->dev);
	}
	#endif 
	#ifdef SUPPORT_QUECTEL_REMOTE_WAKEUP
	//For USB Remote Wakeup
	if (serial->dev->descriptor.idVendor == cpu_to_le16(0x2C7C)) {
		device_init_wakeup(&serial->dev->dev, 1); //usb remote wakeup
	}
	#endif
#endif
	/* Store the device flags so we can use them during attach. */
	usb_set_serial_data(serial, (void *)device_flags);
	return 0;
}

  • 根据USB协议的要求，在批量输出传输期间，通过设置 URB_ZERO_PACKET 标志来添加处理零数据包的机制。

    diff --git a/longan/kernel/linux-4.9/drivers/usb/serial/usb_wwan.c b/longan/kernel/linux-4.9/drivers/usb/serial/usb_wwan.c
old mode 100644
new mode 100755
index 3dfdfc8..e56b275
--- a/longan/kernel/linux-4.9/drivers/usb/serial/usb_wwan.c
+++ b/longan/kernel/linux-4.9/drivers/usb/serial/usb_wwan.c
@@ -36,6 +36,8 @@
 #include <linux/serial.h>
 #include "usb-wwan.h"
 
+#define SUPPORT_QUECTEL 1
+
 /*
  * Generate DTR/RTS signals on the port using the SET_CONTROL_LINE_STATE request
  * in CDC ACM.
@@ -504,6 +506,14 @@ static struct urb *usb_wwan_setup_urb(struct usb_serial_port *port,
        usb_fill_bulk_urb(urb, serial->dev,
                          usb_sndbulkpipe(serial->dev, endpoint) | dir,
                          buf, len, callback, ctx);
+       
+#ifdef SUPPORT_QUECTEL 
+       if (dir == USB_DIR_OUT) {
+               struct usb_device_descriptor *desc = &serial->dev->descriptor;
+               if (desc->idVendor == cpu_to_le16(0x2C7C))
+                       urb->transfer_flags |= URB_ZERO_PACKET;
+       }
+#endif
 
        return urb;
 }

  • 增加 USB 控制器复位后恢复操作

    // linux-4.9/drivers/usb/serial/option.c
static struct usb_serial_driver option_1port_device = {
	......
#ifdef SUPPORT_QUECTEL
	.reset_resume      = usb_wwan_resume,
#endif
};

  • 在内核中启用 USB SERIAL 配置

    CONFIG_USB_SERIAL=y
CONFIG_USB_SERIAL_WWAN=y
CONFIG_USB_SERIAL_OPTION=y
CONFIG_USB_ACM=y
CONFIG_USB_NET_DRIVERS=y
CONFIG_USB_USBNET=y
CONFIG_USB_NET_CDCETHER=y

完成标志

  • 内核日志

    [    6.254850] usb 2-1: not running at top speed; connect to a high speed hub
[    6.284643] cdc_ether 2-1:1.0 usb0: register 'cdc_ether' at usb-sunxi-ohci-1, CDC Ethernet Device, 02:4b:b3:b9:eb:e5
[    6.293812] vdc: Waited 0ms for vold
[    6.304202] option 2-1:1.2: GSM modem (1-port) converter detected
[    6.311813] usb 2-1: GSM modem (1-port) converter now attached to ttyUSB0
[    6.321412] option 2-1:1.3: GSM modem (1-port) converter detected
[    6.328994] usb 2-1: GSM modem (1-port) converter now attached to ttyUSB1
[    6.338217] option 2-1:1.4: GSM modem (1-port) converter detected
[    6.345935] usb 2-1: GSM modem (1-port) converter now attached to ttyUSB2
[    6.355219] option 2-1:1.5: GSM modem (1-port) converter detected
[    6.362914] usb 2-1: GSM modem (1-port) converter now attached to ttyUSB3
[    6.372287] option 2-1:1.6: GSM modem (1-port) converter detected
[    6.379951] usb 2-1: GSM modem (1-port) converter now attached to ttyUSB4
[    6.389179] option 2-1:1.7: GSM modem (1-port) converter detected
[    6.396772] usb 2-1: GSM modem (1-port) converter now attached to ttyUSB5
[    6.406217] option 2-1:1.8: GSM modem (1-port) converter detected
[    6.413736] usb 2-1: GSM modem (1-port) converter now attached to ttyUSB6

  • 虚拟串口

    mercury-demo:/ # ls -l /dev/ttyU*                                                   
crwxrwxrwx 1 system system 188,   0 2022-12-30 21:00 /dev/ttyUSB0
crwxrwxrwx 1 system system 188,   1 2022-12-30 21:00 /dev/ttyUSB1
crwxrwxrwx 1 system system 188,   2 2022-12-30 21:00 /dev/ttyUSB2
crwxrwxrwx 1 system system 188,   3 2022-12-30 21:00 /dev/ttyUSB3
crw------- 1 root   root   188,   4 2022-12-30 21:00 /dev/ttyUSB4
crw------- 1 root   root   188,   5 2022-12-30 21:00 /dev/ttyUSB5
crw------- 1 root   root   188,   6 2022-12-30 21:00 /dev/ttyUSB6

  • 虚拟网卡

    mercury-demo:/ # ifconfig -a                                                        
......
usb0      Link encap:Ethernet  HWaddr 02:4b:b3:b9:eb:e5  Driver cdc_ether
          BROADCAST MULTICAST  MTU:1500  Metric:1
          RX packets:0 errors:0 dropped:0 overruns:0 frame:0 
          TX packets:0 errors:0 dropped:0 overruns:0 carrier:0 
          collisions:0 txqueuelen:1000 
          RX bytes:0 TX bytes:0 
......

系统适配

主要是修改 ril 库相关的文件，实现拨号和衔接数据通路。

ril 库移植

  • 涉及文件列表

    android/hardware/ril/rild/radio.xml
android/hardware/ril/rild/rild.rc
android/device/softwinner/common/sepolicy/vendor/rild.te
android/vendor/aw/public/prebuild/lib/librild/radio_common.mk
android/vendor/aw/public/prebuild/lib/librild/lib/lib32/libquectel-ril.so
android/vendor/aw/public/prebuild/lib/librild/lib/lib64/libquectel-ril.so

  • 构建文件拷贝脚本，将移远的 ril 库以及 apns-conf.xml、ql-ril.conf 文件更新到系统指定目录下

    android/vendor/aw/public/prebuild/lib/librild/lib/lib32/libquectel-ril.so
android/vendor/aw/public/prebuild/lib/librild/lib/lib64/libquectel-ril.so

  • 修改 ril-daemon 服务启动参数

    diff --git a/android/hardware/ril/rild/rild.rc b/android/hardware/ril/rild/rild.rc
old mode 100644
new mode 100755
index f6beb54..d259206
--- a/android/hardware/ril/rild/rild.rc
+++ b/android/hardware/ril/rild/rild.rc
@@ -1,5 +1,5 @@
 service vendor.ril-daemon /vendor/bin/hw/rild
     class main
-    user radio
-    group radio cache inet misc audio log readproc wakelock
+    user root
+    group radio cache inet misc audio sdcard_rw log
     capabilities BLOCK_SUSPEND NET_ADMIN NET_RAW

  • 选择编译 android.hardware.radio@1.0

    diff --git a/android/vendor/aw/public/prebuild/lib/librild/radio_common.mk b/android/vendor/aw/public/prebuild/lib/librild/radio_common.mk
old mode 100644
new mode 100755
index a7206b6..8ef8bd0
--- a/android/vendor/aw/public/prebuild/lib/librild/radio_common.mk
+++ b/android/vendor/aw/public/prebuild/lib/librild/radio_common.mk
@@ -5,7 +5,7 @@ RIL_LIB_BASENAME ?= libsoftwinner-ril-$(RIL_LIB_VERSION)
 
 # 3G Data Card Packages
 PRODUCT_PACKAGES += \
-       android.hardware.radio@1.4 \
+       android.hardware.radio@1.0 \
        android.hardware.radio.config@1.1-service \
        android.hardware.radio.config@1.1 \
        pppd_vendor \

  • 修改 hidl 使用 radio 1.0 版本

    diff --git a/android/hardware/ril/rild/radio.xml b/android/hardware/ril/rild/radio.xml
old mode 100644
new mode 100755
index 866b401..885b150
--- a/android/hardware/ril/rild/radio.xml
+++ b/android/hardware/ril/rild/radio.xml
@@ -1,12 +1,11 @@
 <manifest version="1.0" type="device" target-level="4">
-    <hal format="hidl">
-        <name>android.hardware.radio</name>
-        <transport>hwbinder</transport>
-        <version>1.4</version>
-        <interface>
-            <name>IRadio</name>
-            <instance>slot1</instance>
-        </interface>
-        <fqname>@1.2::ISap/slot1</fqname>
-    </hal>
+       <hal format="hidl">
+               <name>android.hardware.radio</name>
+               <transport>hwbinder</transport>
+               <version>1.0</version>
+               <interface>
+                       <name>IRadio</name>
+                       <instance>slot1</instance>
+               </interface>
+       </hal>
 </manifest>

  • 修改 SELinux 权限

    diff --git a/android/device/softwinner/common/sepolicy/vendor/rild.te b/android/device/softwinner/common/sepolicy/vendor/rild.te
index 8fdddc5..d29b4a2 100755
--- a/android/device/softwinner/common/sepolicy/vendor/rild.te
+++ b/android/device/softwinner/common/sepolicy/vendor/rild.te
@@ -5,6 +5,7 @@ allow rild vendor_file:file execute_no_trans;
 allow rild vendor_ril_prop:file { read getattr open };
 allow rild vendor_ril_prop:property_service set;
 allow rild vendor_default_prop:file {open read getattr};
+allow rild rild:packet_socket create_socket_perms_no_ioctl;
 
 allow rild vendor_toolbox_exec:file execute_no_trans;
 allow rild vendor_shell_exec:file execute_no_trans;

完成标志

  • 查看系统属性

    mercury-demo:/ # getprop | grep ril
getprop | grep ril
[gsm.version.ril-impl]: [Quectel_Android_RIL_Driver_V3.5.0]
[init.svc.vendor.ril-daemon]: [running]
[ro.boottime.vendor.ril-daemon]: [9918673186]
[ro.radio.noril]: [false]
[vendor.rild.libargs]: [-d/dev/ttyUSB2]
[vendor.rild.libpath]: [/vendor/lib64/libquectel-ril.so]

  • 查看 raido log 信息：logcat -b radio -v time

    D/RILD    ( 1917): **RIL Daemon Started**
D/RILD    ( 1917): **RILd param count=3**
D/RILD    ( 1917): RIL_Init argc = 4 clientId = 0
D/RILC    ( 1917): Quectel RIL Version: Quectel_Android_RIL_Driver_V3.5.0
D/RILC    ( 1917): libquectel-ril build info: On branch master Your branch is up to date with 'origin/master'. e1552af97d835442b8f39f69118082650eb33081 09/27/22_14:42:59 
D/RILC    ( 1917): t-prop_value is 2
D/RILC    ( 1917): before_dot is 10
D/RILC    ( 1917): [ro.build.version.release]: [10.0]
D/RILC    ( 1917): Android Version: 100, RIL_VERSION: 12 / 12
E/RILC    ( 1917): '/vendor/manifest.xml' not exist.
D/RILC    ( 1917): 1.1</version>
D/RILC    ( 1917): IRadioVersion 1.1
D/RILC    ( 1917): IRadioConfigVersion 1.-1
......
D/SubscriptionController( 2450): [getPhoneId] asked for default subId=1
D/SubscriptionController( 2450): [getPhoneId] asked for default subId=1
D/SETUP_DATA_CALL( 1917): do_dhcp_request ipaddr=10.192.252.55, prefixLength=24
D/SETUP_DATA_CALL( 1917): ql_set_data_call_info pdp=1, ifname=usb0, iptype=4, ipaddr=10.192.252.55
E/SETUP_DATA_CALL( 1917): ifc_add_address() = -22
D/SETUP_DATA_CALL( 1917): deactivateManually is 0
D/SETUP_DATA_CALL( 1917): usb0 IPv4 Address: 10.192.252.55
D/SETUP_DATA_CALL( 1917): usb0 IPv6 Address: 0:0:fe80::4b:b3ff
D/SETUP_DATA_CALL( 1917): usb0 IP Address: 10.192.252.55
D/SETUP_DATA_CALL( 1917): get_local_ip: 10.192.252.55, cost 4 sec

测试验证

  • 查看网卡是否出现 usb0 网卡，也检查是否有获取到 ip 地址：

    mercury-demo:/ # ifconfig
ifconfig
eth1      Link encap:Ethernet  HWaddr 36:c9:e3:f1:b8:05  Driver sunxi-gmac
          UP BROADCAST MULTICAST  MTU:1500  Metric:1
          RX packets:0 errors:0 dropped:0 overruns:0 frame:0
          TX packets:5 errors:0 dropped:0 overruns:0 carrier:0
          collisions:0 txqueuelen:1000
          RX bytes:0 TX bytes:418
          Interrupt:66

lo        Link encap:Local Loopback
          inet addr:127.0.0.1  Mask:255.0.0.0
          inet6 addr: ::1/128 Scope: Host
          UP LOOPBACK RUNNING  MTU:65536  Metric:1
          RX packets:16 errors:0 dropped:0 overruns:0 frame:0
          TX packets:16 errors:0 dropped:0 overruns:0 carrier:0
          collisions:0 txqueuelen:1
          RX bytes:1920 TX bytes:1920

eth0      Link encap:Ethernet  HWaddr 36:c9:e3:f1:b8:05  Driver sunxi-gmac
          UP BROADCAST MULTICAST  MTU:1500  Metric:1
          RX packets:0 errors:0 dropped:0 overruns:0 frame:0
          TX packets:2 errors:0 dropped:0 overruns:0 carrier:0
          collisions:0 txqueuelen:1000
          RX bytes:0 TX bytes:168
          Interrupt:65

usb0      Link encap:Ethernet  HWaddr 02:4b:b3:b9:eb:e5  Driver cdc_ether
          inet addr:10.209.124.163  Bcast:10.209.124.255  Mask:255.255.255.0
          inet6 addr: fe80::4b:b3ff:feb9:ebe5/64 Scope: Link
          UP BROADCAST RUNNING MULTICAST  MTU:1500  Metric:1
          RX packets:123 errors:0 dropped:0 overruns:0 frame:0
          TX packets:175 errors:0 dropped:0 overruns:0 carrier:0
          collisions:0 txqueuelen:1000
          RX bytes:20877 TX bytes:23570

  • 查看是否能正常 ping 通外网：

    mercury-demo:/ # ping www.qq.com
ping www.qq.com
PING ins-r23tsuuf.ias.tencent-cloud.net (101.91.22.57) 56(84) bytes of data.
64 bytes from 101.91.22.57: icmp_seq=1 ttl=48 time=63.5 ms
64 bytes from 101.91.22.57: icmp_seq=2 ttl=48 time=55.8 ms
64 bytes from 101.91.22.57: icmp_seq=3 ttl=48 time=55.1 ms
64 bytes from 101.91.22.57: icmp_seq=4 ttl=48 time=55.8 ms
64 bytes from 101.91.22.57: icmp_seq=5 ttl=48 time=54.9 ms
64 bytes from 101.91.22.57: icmp_seq=6 ttl=48 time=62.9 ms
64 bytes from 101.91.22.57: icmp_seq=7 ttl=48 time=54.8 ms
64 bytes from 101.91.22.57: icmp_seq=8 ttl=48 time=55.4 ms
64 bytes from 101.91.22.57: icmp_seq=9 ttl=48 time=54.8 ms

调试技巧

模组测试

可以先将模组接到 PC 端，使用串口手动下发 AT 指令测试，确定模组可以正常使用。

AT +CPIN?
CPIN: READY

OK
AT+QNWINFO
+QNWINFO:"FDD LTE"，"46011","LTE BAND 1",100

OK
AT+COPS?
+COPS: 0,0,"CHN-CT",7

OK
AT+QIACT=1
OK
AT+QIACT?
+QIACT: 1,1,1,"10.193.145.135"

OK
AT+QPING=1,"www.baidu.com"
OK
+QPING: 0,"101.91.22.57",32,78,255
+QPING: 0,"101.91.22.57",32,83,255
+QPING: 0,"101.91.22.57",32,80,255

日志提取

启动日志保存，在 data 目录下创建 quectel_debug_log 目录，libquectel-ril.so 会自动生成日志文件。

mkdir /data/quectel_debug_log

mercury-demo:/data/quectel_debug_log $ ls -l
-rw-r--r-- 1 Administrator 197121 788266 12月 30 22:10 1229_144251_logcat.txt
-rw-r--r-- 1 Administrator 197121  37788 12月 30 22:10 1229_144251_radio.txt
-rw-r--r-- 1 Administrator 197121  87888 12月 30 22:10 1229_144251_usbmonlog.txt
-rw-r--r-- 1 Administrator 197121  77156 12月 30 22:10 1229_144316_dmesg_mainLoop.txt