Ubuntu Server 18.04 中 EC20 驱动移植 Gobinet 拨号

最新推荐文章于 2024-05-02 17:24:50 发布

oliver223

最新推荐文章于 2024-05-02 17:24:50 发布

阅读量6.4k

点赞数 9

分类专栏：移远 EC20 文章标签： ubuntu

本文链接：https://blog.csdn.net/oliver223/article/details/106786370

版权

移远同时被 2 个专栏收录

1 篇文章 1 订阅

订阅专栏

EC20

1 篇文章 0 订阅

订阅专栏

某宝买了台mini 工控机，让店家给安装了移远EC20 的4G网卡; 拿回来装ubuntu，发现没有驱动啊，店家也只有window的驱动，无奈,只给了个移远官方的文件，照着操作吧。

《Quectel_WCDMA&LTE_Linux_USB_Driver_User_Guide_V1.7.pdf》

《Quectel_WCDMA&LTE_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&LTE_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 文件，我是在 File: [KERNEL]/arch/x86/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&LTE_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&LTE_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 我也没有搞明白怎么操作，

有明白的大神指导一下

Step 3: Use quectel-CM to setup data call.

最后执行 ./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=forking

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

最后一张图

oliver223

关注

9
点赞
踩
45

收藏

觉得还不错? 一键收藏
4
评论
Ubuntu Server 18.04 中 EC20 驱动移植 Gobinet 拨号

某宝买了台mini 工控机，让店家给安装了移远EC20 的4G网卡; 拿回来装ubuntu，发现没有驱动啊，店家也只有window的驱动，无奈,只给了个移远官方的文件，照着操作吧。《Quectel_WCDMA&LTE_Linux_USB_Driver_User_Guide_V1.7.pdf》《Quectel_WCDMA&LTE_Linux_USB_Driver_User_Guide_V2.0.pdf》就这两份呢文件，折腾了好几天终于搞好了怕有什么奇怪的问题，我都是..
复制链接

扫一扫