EC20 驱动 移植 Gobinet 拨号
Ubuntu Server 18.04 中 移远EC20 驱动 移植 Gobinet 拨号
某宝买了台mini 工控机，让店家给安装了 移远EC20 的4G网卡; 拿回来装ubuntu，发现没有驱动啊，店家也只有window的驱动，无奈,只给了个移远官方的文件，照着操作吧。
《Quectel_WCDMA<E_Linux_USB_Driver_User_Guide_V1.7.pdf》
《Quectel_WCDMA<E_Linux_USB_Driver_User_Guide_V2.0.pdf》
就这两份呢文件， 折腾了好几天 终于搞好了
怕有什么奇怪的问题，我都是在root 用户下操作的 ，
一、下载 linux 内核
查看内核版本 uname -r
root@thingsbox:/# uname -r
4.15.0-106-generic
查找系统可用的 内核 apt search linux-source
root@thingsbox:/# apt search linux-source
Sorting... Done
Full Text Search... Done
linux-source/bionic-updates,bionic-security,now 4.15.0.106.94 all [installed]
Linux kernel source with Ubuntu patches
linux-source-4.15.0/bionic-updates,bionic-security,now 4.15.0-106.107 all [installed,automatic]
Linux kernel source for version 4.15.0 with Ubuntu patches
linux-source-4.18.0/bionic-updates,bionic-security 4.18.0-25.26~18.04.1 all
Linux kernel source for version 4.18.0 with Ubuntu patches
linux-source-5.0.0/bionic-updates,bionic-security 5.0.0-52.56~18.04.1 all
Linux kernel source for version 5.0.0 with Ubuntu patches
linux-source-5.3.0/bionic-updates,bionic-security 5.3.0-59.53~18.04.1 all
Linux kernel source for version 5.3.0 with Ubuntu patches
选择你和你系统相匹配的 内核版本 然后安装， 命令后面可以带上版本号
root@thingsbox:/# apt install linux-source
下载完成后， 安装的内核 一般在 /usr/src/目录下面
root@thingsbox:/usr/src# cd /usr/src/
root@thingsbox:/usr/src# ls
linux-headers-4.15.0-106 linux-headers-4.15.0-106-generic linux-source-4.15.0 linux-source-4.15.0.tar.bz2
打开 /usr/src/linux-source-4.15.0 目录 解压内核 tar -jxvf linux-source-4.15.0.tar.bz2
root@thingsbox:/usr/src/linux-source-4.15.0# ls
debian debian.master linux-source-4.15.0 linux-source-4.15.0.tar.bz2
root@thingsbox:/usr/src/linux-source-4.15.0# tar -jxvf linux-source-4.15.0.tar.bz2
最终 内核文件的位置为 /usr/src/linux-source-4.15.0/linux-source-4.15.0
root@thingsbox:/usr/src/linux-source-4.15.0/linux-source-4.15.0# pwd
/usr/src/linux-source-4.15.0/linux-source-4.15.0
root@thingsbox:/usr/src/linux-source-4.15.0/linux-source-4.15.0# ls
arch CREDITS dropped.txt init kernel mm scripts tools virt
block crypto firmware ipc lib net security ubuntu
certs Documentation fs Kbuild MAINTAINERS README snapcraft.yaml update-version-dkms
COPYING drivers include Kconfig Makefile samples sound usr
二、USB Serial Driver USB 驱动编辑
参考 《Quectel_WCDMA<E_Linux_USB_Driver_User_Guide_V1.7.pdf》 的3.2 章节，照着一步一操作 ，很easy
If you are using UC15/UC20/EC25/EC21/EC20/EC20 R2.0/EG91/EG95/EG06/EP06/EM06/BG96 and
requiring USB serial driver, please read this section for details. Otherwise, please skip this section.
When a Quectel module is attached to the USB Serial driver, the driver will create device files in directory
“/dev”, named as below:
ttyUSB0/ttyUSB1/ttyUSB2...
如果USB 驱动安装 成功 会在 /dev 目录先看见 ttyUSB0/ttyUSB1/ttyUSB2/ ttyUSB3 这几个设备
3.2.1. Add VID and PID
In order to recognize Quectel module, you should add module VID and PID information as below:
File: [KERNEL]/drivers/usb/serial/option.c
static const struct usb_device_id option_ids[] = {
#if 1 //Added by Quectel
{ USB_DEVICE(0x05C6, 0x9090) }, /* Quectel UC15 */
{ USB_DEVICE(0x05C6, 0x9003) }, /* Quectel UC20 */
{ USB_DEVICE(0x2C7C, 0x0125) }, /* Quectel EC25/EC20 R2.0 */
{ USB_DEVICE(0x2C7C, 0x0121) }, /* Quectel EC21 */
{ USB_DEVICE(0x05C6, 0x9215) }, /* Quectel EC20 */
{ USB_DEVICE(0x2C7C, 0x0191) }, /* Quectel EG91 */
{ USB_DEVICE(0x2C7C, 0x0195) }, /* Quectel EG95 */
{ USB_DEVICE(0x2C7C, 0x0306) }, /* Quectel EG06/EP06/EM06 */
{ USB_DEVICE(0x2C7C, 0x0296) }, /* Quectel BG96 */
#endif
If you are using EC20 and following files and statements exist in your kernel source files, please delete
them, as they will conflict with EC20's USB Drivers
如果你的芯片是 EC20 还要删除这几个冲突的东西，我也不知道是什么
[KERNEL]/drivers/usb/serial/qcserial.c
{USB_DEVICE(0x05c6, 0x9215)}, /* Acer Gobi 2000 Modem device (VP413) */
[KERNEL]/drivers/net/usb/qmi_wwan.c
{QMI_GOBI_DEVICE(0x05c6, 0x9215)}, /* Acer Gobi 2000 Modem device (VP413) */
3.2.2. Add the Zero Packet Mechanism
As required by the USB protocol, you need to add the mechanism for processing zero packets during bulk
out transmission.
添加零包处理机制
File: [KERNEL]/drivers/usb/serial/usb_wwan.c
static struct urb *usb_wwan_setup_urb(struct usb_serial *serial, int endpoint,
int dir, void *ctx, char *buf, int len,void (*callback) (struct urb *))
{
......
usb_fill_bulk_urb(urb, serial->dev,
usb_sndbulkpipe(serial->dev, endpoint) | dir,
buf, len, callback, ctx);
#if 1
//Added by Quectel for Zero Packet
if (dir == USB_DIR_OUT) {
struct usb_device_descriptor *desc = &serial->dev->descriptor;
if (desc->idVendor == cpu_to_le16(0x05C6) && desc->idProduct == cpu_to_le16(0x9090))
urb->transfer_flags |= URB_ZERO_PACKET;
if (desc->idVendor == cpu_to_le16(0x05C6) && desc->idProduct == cpu_to_le16(0x9003))
urb->transfer_flags |= URB_ZERO_PACKET;
if (desc->idVendor == cpu_to_le16(0x05C6) && desc->idProduct == cpu_to_le16(0x9215))
urb->transfer_flags |= URB_ZERO_PACKET;
if (desc->idVendor == cpu_to_le16(0x2C7C))
urb->transfer_flags |= URB_ZERO_PACKET;
}
#endif
return urb;
}
3.2.3. Add Reset Resume
Some USB host controllers/USB hubs will lost power or be reset when MCU entering into suspend/sleep mode, and they cannot resume USB devices when MCU exiting from suspend/sleep mode; instead, they will operate reset-resume. You should add the following statements:
睡眠重启
File: [KERNEL]/drivers/usb/serial/option.c
static struct usb_serial_driver option_1port_device = {
......
#ifdef CONFIG_PM
.suspend
= usb_wwan_suspend,
.resume
= usb_wwan_resume,
#if 1 //Added by Quectel
.reset_resume
= usb_wwan_resume,
#endif
#endif
};
3.2.4. Enlarge Bulk out URBs
For Linux kernel version older than 2.6.29. You need to enlarge bulk out URBs to get faster uplink speed.
老的内核版本 还要添加这个东西 ，我的内核是 4.15 所以没有操作
3.2.5. Use GobiNet or QMI WWAN
If you are using UC20/EC25/EC21/EC20/EC20 R2.0/EG91/EG95/EG06/EP06/EM06/BG96 and requiring GobiNet or QMI WWAN, you must add the following statements to prevent these modules’ interface 4 from being used as USB serial device.
如果要使用 GobiNet 拨号， 还要配置这个
File: [KERNEL]/drivers/usb/serial/option.c
static int option_probe(struct usb_serial *serial, const struct usb_device_id *id) {
struct usb_wwan_intf_private *data;
......
#if 1 //Added by Quectel
//Quectel UC20's interface 4 can be used as USB Network device
if
(serial->dev->descriptor.idVendor
==
cpu_to_le16(0x05C6) &&
serial->dev->descriptor.idProduct == cpu_to_le16(0x9003)
&& serial->interface->cur_altsetting->desc.bInterfaceNumber >= 4)
return -ENODEV;
//Quectel EC20's interface 4 can be used as USB Network device
if
(serial->dev->descriptor.idVendor
==
cpu_to_le16(0x05C6)
&&
serial->dev->descriptor.idProduct == cpu_to_le16(0x9215)
&& serial->interface->cur_altsetting->desc.bInterfaceNumber >= 4)
return -ENODEV;
//Quectel EC25&EC21&EC20 R2.0&EG91&EG95&EG06&EP06&EM06&BG96's interface 4 can be
used as USB Network device
if (serial->dev->descriptor.idVendor == cpu_to_le16(0x2C7C)
&& serial->interface->cur_altsetting->desc.bInterfaceNumber >= 4)
return -ENODEV;
#endif
/* Store device id so we can use it during attach. */
usb_set_serial_data(serial, (void *)id);
return 0;
}
3.2.6. Modify Kernel Configuration
There are several mandatory selected items in kernel configuration; you should follow the steps below to
configure the kernel:
修改内核配置，
这里要注意 我捣鼓了好久 ， 就是捣鼓不对
Step 1: cd <your kernel directory>
这里 **your kernel directory ** 是内核的根目录，比如 我的内核根目录 就是'/usr/src/linux-source-4.15.0/linux-source-4.15.0'
Step 2: Set your environment variables, and import your board's defconfig The following is an example
for Raspeberrypi board
export ARCH=arm
export CROSS_COMPILE=arm-none-linux-gnueabi-
make bcmrpi_defconfig
关于默认的 defconfig 文件， 主要看每个平台的芯片。x86平台在[KERNEL]/arch/x86/configs。正常Arm的配置是在：[KERNEL]/arch/arm/configs
在内核 根目录下 make x86_64_defconfig
Step 3: make menuconfig
Step 4: Enable CONFIG_USB_SERIAL_OPTION
[*] Device Drivers →
[*] USB Support →
[*] USB Serial Converter support →
[*] USB driver for GSM and CDMA modems
按下 Y 键 选中 ，然后 选择 save 后 退出
最后在内核根目录下编译相关项目
3.2.7. Build and Load Driver as Kernel Module for PC in Linux
If you are using Linux on PC, you can follow the steps below to build the driver as Kernel module, and use
modprobe command to load the module.
Step 1:
cd <your kernel directory>
Step 2:
sudo make -C /lib/modules/`uname -r`/build M=`pwd`/drivers/usb/serial obj-m=option.o modules
sudo make -C /lib/modules/`uname -r`/build M=`pwd`/drivers/usb/serial obj-m=usb_wwan.o modules
sudo make -C /lib/modules/`uname -r`/build M=`pwd`/drivers/usb/serial obj-m=qcserial.o modules
Step 3:
sudo cp drivers/usb/serial/option.ko /lib/modules/`uname -r`/kernel/drivers/usb/serial
sudo cp drivers/usb/serial/usb_wwan.ko /lib/modules/`uname -r`/kernel/drivers/usb/serial
sudo cp drivers/usb/serial/qcserial.ko /lib/modules/`uname -r`/kernel/drivers/usb/serial
sudo depmod
sudo reboot
重启后 在 /dev 目录下面 看见这三个设备 就算成功了！
ttyUSB0 ttyUSB1 ttyUSB2 ttyUSB3
二、GobiNet Driver 驱动添加
参考 《Quectel_WCDMA<E_Linux_USB_Driver_User_Guide_V1.7.pdf》 的3.4 章节，照着一步一操作 ，也是很简单的
When a Quectel module is attached to GobiNet driver, the driver will create a network device and a QMI channel. The network device is named as ethX (usbX if the kernel version is 2.6.39 or older), and the QMI channel is named as /dev/qcqmiX. The network device is used for data transmission, and QMI channel is used for QMI message interaction.
如果操作成功 会在 /dev 目录下面 出现 qcqmiX 这个设备
3.4.1. Modify Driver Source Code
The GobiNet driver is provided by Quectel as a form of source file. You should copy the source files to “[KERNEL]/drivers/net/usb/” ([KERNEL]/drivers/usb/net/ if the kernel version is older than 2.6.22)
将 GobiNet 的驱动文件 放在 [KERNEL]/drivers/net/usb/ 目录下面
Step 2: Set your environment variables, and import your board’s defconfig. The following is an example for Raspeberrypi board
在 内核的根目录下面 make x86_64_defconfig
Step 3: make menuconfig
Step 4: Enable CONFIG_USB_USBNET
[*] Device Drivers →
-*- Network device support →
USB Network Adapters →
{*} Multi-purpose USB Networking Framework
按下 Y 键 选中 ，然后 选择 save 后 退出
Step 5: Please add the following statements to file "[KERNEL]/drivers/net/usb/Makefile"
([KERNEL]/drivers/usb/net/Makefile if the kernel version is older than 2.6.22).
obj-y += GobiNet.o
GobiNet-objs := GobiUSBNet.o QMIDevice.o QMI.o
注意 ： 是 Makefile 不是 makefile
然后就可以编译相关配置了
3.4.3. Build and Load Driver as Kernel Module for PC in Linux
If you are using Linux on PC, you can follow the steps below to build the driver as Kernel module, and use modprobe command to load the module.
Step 1: cd <your kernel directory>
Step 2:
sudo make -C /lib/modules/`uname -r`/build M=`pwd`/drivers/net/usb obj-m=GobiNet.o modules
sudo make -C /lib/modules/`uname -r`/build M=`pwd`/drivers/usb/serial obj-m=qcserial.o modules
Step 3:
sudo cp drivers/net/usb/GobiNet.ko /lib/modules/`uname -r`/kernel/drivers/net/usb
sudo cp drivers/usb/serial/qcserial.ko /lib/modules/`uname -r`/kernel/drivers/usb/serial
sudo depmod
sudo reboot
最终
重启后 在 /dev 目录下面 看见这这个通道 就算成功了！
三、Connect Manager 编译配置
参考 《Quectel_WCDMA<E_Linux_USB_Driver_User_Guide_V1.7.pdf》 的5.3 章节，照着一步一操作 ，也能做出来
Step 1: Compile Connect Manager.
把 quectel Connect Manager 文件 quectel-quectel 放到 一个你喜欢的地方
进入文件目录 执行 make 就会出现 可执行的二进制文件 quectel-CM 这就是 最终操作的文件
Step 2: Prepare busybox udhcpc tool.
quectel-CM will call busybox udhpc to obtain IP and NDS, and busybox udhpc will call script file
/usr/share/udhcpc/default.script to set IP/DNS/Routing table for Linux board. You can download this tool's
source code from https://busybox.net/. You should enable CONFIG_UDHCPC in busybox menuconfig and copy the script file [BUSYBOX]/examples/udhcp/simple.script to your Linux board (renamed as
/usr/share/udhcpc/default.script).
从 busybox 官网 https://busybox.net/. 下载 最新的 源码文件。
把 [BUSYBOX]/examples/udhcp/simple.script 文件移动到/usr/share/udhcpc/default.script 。如果没有目录就创建一个
因为 udhcpc 需要需要用到这个 脚本
然后 这个enable CONFIG_UDHCPC in busybox menuconfig 我也没有搞明白怎么操作，
这里编译quectel-CM命令，我直接放到开发板上，直接make就能出来了。不需要busybox
Step 3: Use quectel-CM to setup data call.
最后 执行 ./quectel-CM 就链接成功了
quectel-CM成功连接
最后可以看见网卡已经启动，并设置上了ip
还有一个就是 我执行 quectel-CM 的时候 ，
执行到 Lease of 10.172.27.151 obtained, lease time 7200 就卡住不走了；
研究了好久的udhcp 也没有搞明白。
但是 最后 ip地址和dns也写到了网卡里面，
最后 莫名其妙的成功了； 我也搞不懂。
四、添加开机自启动服务
在/lib/systemd/system 创建 quectel-ec20.service 文件
vim quectel-ec20.service
文件内容 ：
[Unit]
Description=quectel ec20 4g net service
[Service]
Type=simple
ExecStart=/opt/quectel-CM/quectel-CM
ExecReload=/opt/quectel-CM/reload.sh
ExecStop=/opt/quectel-CM/stop.sh
PrivateTmp=true
[Install]
WantedBy=multi-user.target
Alias=quectel-ec20.service
然后 sudo systemctl daemon-reload
然后重启一下
然后就可以使用 systemctl 了
systemctl start quectel-ec20.service
开机启动：
systemctl enable quectel-ec20.service
最后一张图
最后一张图
后记
编译quectel-CM可以直接把源码放到宿主机器上编译。systemd的服务类型要用simple。如果用forking的话，会因为quectel-CM一直没有返回，导致服务被系统杀死的情况。
