目前共有3篇帖子。 字體大小:較小 - 100% (默認)▼  內容轉換:不轉換▼
 
點擊 回復
14 2
移远EC200A模块使用说明
一派掌門 二十級
1樓 發表于:2025-12-26 15:24
EC200A和EC200M两个型号的区别:
EC200ACNV1-CAT4模块3孔转板QTMHXB0036QD cat4:下行速率:150Mbps,上行速率:50Mbps
EC200MCNLF-CAT1模块3孔转板QTMHXB0037QD cat1:下行速率:10Mbps,上行速率:5Mbps
只有速率上有区别。EC200A速率比EC200M快,价格更贵。

移远EC200A模块linux usb驱动包下载地址:
https://www.quectel.com/download-zone/?_sft_downloads-type=usb-drivers
Quectel_LTE&5G_Linux_USB_Driver_V1.0 ZIP 5.37 MB
https://www.quectel.com/content/uploads/2024/02/Quectel_LTE5G_Linux_USB_Driver_V1.0-5.zip
下载下来后,要修改c文件,把EC200A的usb设备id添加到数组里面,还要修改makefile里面的内核和交叉编译器的路径。

编译Quectel_Linux_USB_Serial_Option_Driver_V1.0/v5.3.1前需要开启的内核选项(./build.sh kernel-config):
Device Drivers  --->  [*] USB support  --->  <*>   USB Serial Converter support

编译Quectel_LinuxAndroid_QMI_WWAN_Driver_V1.1前需要开启的内核选项:
Device Drivers  --->  [*] USB support  --->  <*>   USB Wireless Device Management support

在4个文件夹中分别执行make命令编译驱动,生成下面5个ko模块和2个用户态程序。
Quectel_Linux_USB_Serial_Option_Driver_V1.0/v5.3.1/drivers/usb/serial/usb_wwan.ko
Quectel_Linux_USB_Serial_Option_Driver_V1.0/v5.3.1/drivers/usb/serial/option.ko
Quectel_Linux_USB_Serial_Option_Driver_V1.0/v5.3.1/drivers/usb/serial/qcserial.ko
Quectel_LinuxAndroid_GobiNet_Driver_V1.6/GobiNet.ko
Quectel_LinuxAndroid_QMI_WWAN_Driver_V1.1/qmi_wwan_q.ko
QConnectManager_Linux_V1.5/quectel-CM/quectel-CM
QConnectManager_Linux_V1.5/quectel-CM/quectel-qmi-proxy
其中,usb_wwan.ko是qcserial.ko和option.ko的依赖项。

EC200A这个USB设备上面有0-4这五个接口(interface),五个接口的名字分别为:
root@rk3308b-buildroot:/# cat /sys/bus/usb/devices/2-1/2-1:1.0/interface
Mobile RNDIS Network Adapter
root@rk3308b-buildroot:/# cat /sys/bus/usb/devices/2-1/2-1:1.1/interface
Mobile RNDIS Network Adapter
root@rk3308b-buildroot:/# cat /sys/bus/usb/devices/2-1/2-1:1.2/interface
Mobile Diag Interface
root@rk3308b-buildroot:/# cat /sys/bus/usb/devices/2-1/2-1:1.3/interface
Mobile AT Interface
root@rk3308b-buildroot:/# cat /sys/bus/usb/devices/2-1/2-1:1.4/interface
Mobile MODEM Interface
root@rk3308b-buildroot:/#

接口0和接口1(Mobile RNDIS Network Adapter)用的是linux内核自带的RNDIS驱动(Luckfox_Nova_SDK_250430/kernel/drivers/net/usb/rndis_host.c),在AT+QCFG="usbnet",3模式下,板子开机后会自动产生usb0网络接口。
接口2(Mobile Diag Interface)和接口3(Mobile AT Interface)用的是option.ko或qcserial.ko驱动模块(两个都可以用,二选一,一个模块同时占用两个接口),插入模块前需要事先插入依赖项usb_wwan.ko。插入模块后,会出现/dev/ttyUSB0和/dev/ttyUSB1两个串口设备,分别属于接口2和接口3。AT指令是在接口3(/dev/ttyUSB1)上收发的。
接口4(Mobile MODEM Interface)用的是GobiNet.ko或qmi_wwan_q.ko驱动模块。两个模块只能二选一,如果同时插入,只有先插入的那个模块起作用。插入GobiNet.ko模块后会产生/dev/qcqmi1设备文件和usb1网络接口,插入qmi_wwan_q.ko模块后会产生/dev/cdc-wdm0设备文件和wwan0网络接口。

用下面的命令可以看到每个接口匹配的是哪个驱动模块。
root@rk3308b-buildroot:/root# ls -l /sys/bus/usb/devices/2-1/2-1:1.0/driver
lrwxrwxrwx 1 root root 0 Jan  1 00:00 /sys/bus/usb/devices/2-1/2-1:1.0/driver -> ../../../../../../bus/usb/drivers/rndis_host
root@rk3308b-buildroot:/root# ls -l /sys/bus/usb/devices/2-1/2-1:1.1/driver
lrwxrwxrwx 1 root root 0 Jan  1 00:01 /sys/bus/usb/devices/2-1/2-1:1.1/driver -> ../../../../../../bus/usb/drivers/rndis_host
root@rk3308b-buildroot:/root# ls -l /sys/bus/usb/devices/2-1/2-1:1.2/driver
lrwxrwxrwx 1 root root 0 Dec 25 05:18 /sys/bus/usb/devices/2-1/2-1:1.2/driver -> ../../../../../../bus/usb/drivers/qcserial
root@rk3308b-buildroot:/root# ls -l /sys/bus/usb/devices/2-1/2-1:1.3/driver
lrwxrwxrwx 1 root root 0 Dec 25 05:18 /sys/bus/usb/devices/2-1/2-1:1.3/driver -> ../../../../../../bus/usb/drivers/qcserial
root@rk3308b-buildroot:/root# ls -l /sys/bus/usb/devices/2-1/2-1:1.4/driver
lrwxrwxrwx 1 root root 0 Jan  1 00:06 /sys/bus/usb/devices/2-1/2-1:1.4/driver -> ../../../../../../bus/usb/drivers/GobiNet
root@rk3308b-buildroot:/root#

如果提示No such file or directory,说明该接口没有匹配上驱动模块。
root@rk3308b-buildroot:/root# ls -l /sys/bus/usb/devices/2-1/2-1:1.2/driver
ls: cannot access '/sys/bus/usb/devices/2-1/2-1:1.2/driver': No such file or directory
root@rk3308b-buildroot:/root# ls -l /sys/bus/usb/devices/2-1/2-1:1.3/driver
ls: cannot access '/sys/bus/usb/devices/2-1/2-1:1.3/driver': No such file or directory
root@rk3308b-buildroot:/root#

板子每次开机后,需运行startup.sh开机脚本检查是否已联网。
联网成功后,系统会自动同步网络时间到本地,可以用date命令看到本地时间是正确的。
root@rk3308b-buildroot:/root# date
Thu Dec 25 11:00:17 UTC 2025
root@rk3308b-buildroot:/root#
可以ping通百度:
root@rk3308b-buildroot:/root# ping www.baidu.com -c 4
PING www.baidu.com (39.156.70.239): 56 data bytes
64 bytes from 39.156.70.239: seq=0 ttl=52 time=33.304 ms
64 bytes from 39.156.70.239: seq=1 ttl=52 time=42.224 ms
64 bytes from 39.156.70.239: seq=2 ttl=52 time=36.970 ms
64 bytes from 39.156.70.239: seq=3 ttl=52 time=41.630 ms

--- www.baidu.com ping statistics ---
4 packets transmitted, 4 packets received, 0% packet loss
round-trip min/avg/max = 33.304/38.532/42.224 ms
root@rk3308b-buildroot:/root#

一派掌門 二十級
2樓 發表于:2025-12-26 15:24
驱动的具体改法见:https://zh.purasbar.com/post.php?t=34246
 
一派掌門 二十級
3樓 發表于:2025-12-26 15:26
配置脚本:
【startup.sh】
#!/bin/sh
insmod usb_wwan.ko
insmod qcserial.ko
./startup

【startup.c】
/**
 * @file startup.c
 * EC200M 4G模块开机初始化程序
 */
#include <fcntl.h>
#include <stdio.h>
#include <string.h>
#include <sys/uio.h>
#include <termios.h>
#include <time.h>
#include <unistd.h>

#define RESTART (-2) ///< 模块正在重启

/** AT命令回应 */
struct response
{
    char buffer[1024]; ///< 存放多个字符串的缓冲区
    char *lines[20]; ///< 收到的回应的每一行的内容(不含换行符)
    int line_count; ///< 收到的回应的行数
};

int verbose = 0; ///< 是否在控制台打印详细日志

/**
 * 解析命令行参数。
 *
 * @param argc 参数个数。
 * @param argv 参数列表。
 * @retval 0 解析成功。
 * @retval -1 解析失败,命令行参数有误。
 */
int parse_arguments(int argc, char *argv[])
{
    int i;
    
    for (i = 1; i < argc; i++)
    {
        if (strcmp(argv[i], "-v") == 0)
            verbose = 1;
        else
        {
            printf("unknown argument: %s\n", argv[i]);
            return -1;
        }
    }
    return 0;
}

/**
 * 配置串口参数。
 *
 * @param fd 串口的文件描述符。
 * @param baudrate 串口波特率。
 * @retval 0 配置成功。
 * @retval -1 配置失败。
 */
int configure_uart(int fd, int baudrate)
{
    int ret;
    struct termios attr;
    
    ret = tcgetattr(fd, &attr);
    if (ret == -1)
    {
        perror("tcgetattr() failed");
        return -1;
    }
    
    cfsetspeed(&attr, baudrate);
    attr.c_cflag = (attr.c_cflag & ~CSIZE) | CS8; // 8位数据
    attr.c_cflag &= ~PARENB; // 无奇偶校验
    attr.c_cflag &= ~CSTOPB; // 1位停止位
    attr.c_cflag &= ~CRTSCTS; // 禁用硬件流控
    attr.c_cflag |= CREAD | CLOCAL; // 启用接收
    attr.c_lflag &= ~(ICANON | ECHO | ECHOE | ISIG); // 原始输入
    attr.c_oflag &= ~OPOST; // 原始输出
    
    // 立即返回读取结果
    attr.c_cc[VMIN] = 0;
    attr.c_cc[VTIME] = 10; // 1秒超时
    
    ret = tcsetattr(fd, TCSANOW, &attr);
    if (ret == -1)
    {
        perror("tcsetattr() failed");
        return -1;
    }
    return 0;
}

/**
 * 发送AT命令并接收命令回应。
 *
 * @param fd 串口的文件描述符。
 * @param cmd 要发送的AT命令字符串,末尾不用加换行符。
 * @param resp 接收AT命令回应用的结构体。
 * @param timeout 超时时间。填0表示采用默认的超时时间。
 * @retval 1 命令回应接收成功,回应内容表示AT命令执行成功(OK)。
 * @retval 0 命令回应接收成功,回应内容表示AT命令执行失败(ERROR)。
 * @retval -1 命令回应接收超时。
 * @attention 串口回显字符和非当前命令的回应(异步通知消息)会被忽略,不会保存到resp结构体当中。
 */
int send_command(int fd, const char *cmd, struct response *resp, int timeout)
{
    char name[50] = "";
    char *p;
    int curr, i, namelen, ret;
    struct iovec iov[2];
    time_t start, now;
    
    memset(resp, 0, sizeof(struct response));
    if (timeout == 0) // 0表示采用默认的超时时间
        timeout = 1000;
    
    // 发送命令
    iov[0].iov_base = (void *)cmd;
    iov[0].iov_len = strlen(cmd);
    iov[1].iov_base = "\r\n";
    iov[1].iov_len = 2;
    ret = writev(fd, iov, 2);
    if (ret == -1)
    {
        printf("%s: writev() failed\n", __func__);
        return -1;
    }
       
    // 提取命令名称
    if (cmd[2] == '+')
    {
        for (i = 3; cmd[i] != '\0' && cmd[i] != '=' && cmd[i] != '?'; i++)
        {
            if (i - 3 == sizeof(name) - 1)
                break;
            name[i - 3] = cmd[i];
        }
        name[i - 3] = '\0';
    }
    namelen = strlen(name);
    
    // 接收回应
    time(&start);
    i = 0;
    do
    {
        curr = sizeof(resp->buffer) - i - 1;
        ret = read(fd, resp->buffer + i, curr);
        if (ret == -1)
        {
            printf("%s: read() failed\n", __func__);
            return -1;
        }
        i += ret;
        resp->buffer[i] = '\0';
       
        if (strstr(resp->buffer, "OK") != NULL)
            ret = 1;
        else if (strstr(resp->buffer, "ERROR") != NULL)
            ret = 0;
        else
            ret = -1; // 回应未接收完毕
       
        time(&now);
    } while (ret == -1 && now - start < timeout / 1000);
    
    // 拆分成字符串数组
    for (p = strtok(resp->buffer, "\r\n"); p != NULL; p = strtok(NULL, "\r\n"))
    {
        if (resp->line_count == 0 && strcmp(p, cmd) == 0)
            continue; // 忽略回显字符
        if (p[0] == '+' && (strncmp(p + 1, name, namelen) != 0 || p[1 + namelen] != ':'))
        {
            printf("%s\n", p);
            continue; // 忽略非当前命令的回应
        }

        resp->lines[resp->line_count] = p;
        resp->line_count++;
        if (resp->line_count == sizeof(resp->lines) / sizeof(resp->lines[0]))
            break;
    }
    
    // 打印回应内容
    if (verbose)
    {
        printf("[Command] %s\n", cmd);
        for (i = 0; i < resp->line_count; i++)
            printf("%d: %s\n", i, resp->lines[i]);
    }
    else
    {
        if (ret == 0)
            printf("[Command] %s (error)\n", cmd);
        else if (ret == -1)
            printf("[Command] %s (timeout)\n", cmd);
    }
    return ret;
}

/**
 * 测试指定串口是否能正确响应AT命令。
 *
 * @param fd 串口的文件描述符。
 * @retval 1 串口能正确响应AT命令。
 * @retval 0 串口不能正确响应AT命令。
 */
int is_device_ready(int fd)
{
    int ret;
    struct response resp;
    
    ret = send_command(fd, "AT", &resp, 0);
    if (ret == 0) // 如果返回了ERROR
        ret = send_command(fd, "AT", &resp, 0); // 重试
    return ret == 1; // 返回是否成功
}

/**
 * 重启设备。
 *
 * @param fd 串口的文件描述符。
 * @retval -1 设备未响应重启命令。
 * @retval RESTART 设备已响应重启命令。
 * @attention 设备重启时,/dev/ttyUSB1设备文件会消失,导致文件描述符fd失效。\n
 *            调用本函数成功后,请立即关闭文件描述符fd。
 */
int restart_device(int fd)
{
    int ret;
    struct response resp;
    
    ret = send_command(fd, "AT+CFUN=1,1", &resp, 0);
    if (ret != 1)
    {
        printf("failed to restart the device\n");
        return -1;
    }
    return RESTART;
}

/**
 * 切换到RNDIS模式(usbnet 3号模式)。
 *
 * @param fd 串口的文件描述符。
 * @retval 0 已处于RNDIS模式,无需切换。
 * @retval -1 切换失败。
 * @retval RESTART 设备已响应切换命令并且正在重启。
 * @note 切换成功并重启模块后会出现usb0网络接口。\n
 *       EC200M模块的USB interface 0和1(Mobile RNDIS Network Adapter)用的是linux内核自带的RNDIS驱动。\n
 *       在usbnet 3号模式下,板子开机后不需要insmod任何驱动模块,就能自动产生usb0网络接口。
 * @attention 设备重启时,/dev/ttyUSB1设备文件会消失,导致文件描述符fd失效,请立即关闭文件描述符fd。
 */
int enable_rndis_mode(int fd)
{
    int mode, ret;
    struct response resp;
    
    ret = send_command(fd, "AT+QCFG=\"usbnet\"", &resp, 0);
    if (ret != 1)
        return -1;
    
    ret = sscanf(resp.lines[0], "+QCFG: \"usbnet\",%d", &mode);
    if (ret != 1)
    {
        printf("%s: sscanf() ret=%d\n", __func__, ret);
        return -1;
    }
    printf("usbnet mode: %d\n", mode);
    if (mode == 3)
        return 0;
    
    ret = send_command(fd, "AT+QCFG=\"usbnet\",3", &resp, 0);
    if (ret != 1)
        return -1;
    return restart_device(fd);
}

/**
 * 激活网络。
 *
 * @param fd 串口的文件描述符。
 * @param apn 接入点名称(Access Point Name)。一般和SIM卡的运营商有关。
 * @retval 0 激活网络成功。
 * @retval -1 激活网络失败。
 * @note 激活网络成功后,linux系统里面就可以上网了,可以ping通百度。
 */
int activate_network(int fd, const char *apn)
{
    char cmd[100];
    char *p, *q;
    int connect_type, id, ret;
    struct response resp;
    
    // 检查场景是否已激活
    ret = send_command(fd, "AT+QIACT?", &resp, 0);
    if (ret != 1)
        return -1; // 检查失败
    if (strcmp(resp.lines[0], "OK") == 0)
    {
        // 只返回了OK,表示场景未激活, 需要激活场景
        snprintf(cmd, sizeof(cmd), "AT+QICSGP=1,1,\"%s\","","",1", apn);
        ret = send_command(fd, cmd, &resp, 0);
        if (ret != 1)
            return -1;
       
        // 受网络状态影响,执行AT+QIACT后,等待返回结果OK或者ERROR的最大时间为150秒,在结果尚未返回之前,无法执行任何AT命令。
        ret = send_command(fd, "AT+QIACT=1", &resp, 150);
        if (ret != 1)
            return -1; // 激活失败
       
        ret = send_command(fd, "AT+QIACT?", &resp, 0);
        if (ret != 1)
            return -1;
    }
    
    // 显示PDP场景编号
    ret = sscanf(resp.lines[0], "+QIACT:%d", &id);
    if (ret != 1)
    {
        printf("%s: sscanf() ret=%d\n", __func__, ret);
        return -1;
    }
    printf("PDP Context ID: %d\n", id);
    
    // 显示IP地址
    p = strchr(resp.lines[0], '"');
    if (p == NULL)
    {
        printf("IP address: unknown\n");
        return -1;
    }
    p++;
    q = strrchr(p, '"');
    if (q != NULL)
        *q = '\0';
    printf("IP address: %s\n", p);
    
    // 允许网络数据包传递到linux内核
    ret = send_command(fd, "AT+QNETDEVCTL?", &resp, 0);
    if (ret != 1)
        return -1;
    ret = sscanf(resp.lines[0], "+QNETDEVCTL: %d\n", &connect_type);
    if (ret != 1)
    {
        printf("%s: sscanf() ret=%d\n", __func__, ret);
        return -1;
    }
    if (connect_type != 3)
    {
        ret = send_command(fd, "AT+QNETDEVCTL=3,1,1", &resp, 0);
        if (ret != 1)
            return -1;
       
        ret = send_command(fd, "AT+QNETDEVCTL?", &resp, 0);
        if (ret != 1)
            return -1;
        ret = sscanf(resp.lines[0], "+QNETDEVCTL: %d\n", &connect_type);
        if (ret != 1)
        {
            printf("%s: sscanf() ret=%d\n", __func__, ret);
            return -1;
        }
        if (connect_type != 3)
        {
            printf("%s: connect_type=%d\n", __func__, connect_type);
            return -1;
        }
    }
    return 0;
}

/**
 * 主函数。
 *
 * @param argc 参数个数。
 * @param argv 参数列表。
 * @retval 0 程序运行成功。
 * @retval -1 程序运行出错。
 */
int main(int argc, char *argv[])
{
    int fd = -1;
    int ret;
    
    ret = parse_arguments(argc, argv);
    if (ret == -1)
        return -1;
    
restart:
    if (fd != -1)
    {
        close(fd);
        fd = -1;
        do
        {
            sleep(10);
        } while (access("/dev/ttyUSB1", 0) == -1);
        printf("device restarted\n");
    }
    
    fd = open("/dev/ttyUSB1", O_RDWR);
    if (fd == -1)
    {
        perror("open() failed");
        return -1;
    }
    
    ret = configure_uart(fd, 115200);
    if (ret == -1)
        goto end;
    
    if (!is_device_ready(fd))
    {
        printf("device is not ready\n");
        ret = -1;
        goto end;
    }
    
    ret = enable_rndis_mode(fd);
    if (ret == -1)
    {
        printf("failed to enable RNDIS mode\n");
        goto end;
    }
    else if (ret == RESTART)
        goto restart;
    
    ret = activate_network(fd, "cmnet");
    if (ret == -1)
    {
        printf("failed to activate network\n");
        goto end;
    }
    
    ret = 0;
end:
    close(fd);
    return ret;
}
 

回復帖子

內容:
用戶名: 您目前是匿名發表
驗證碼:
(快捷鍵:Ctrl+Enter)
 

本帖信息

點擊數:14 回複數:2
評論數: ?
作者:巨大八爪鱼
最後回復:巨大八爪鱼
最後回復時間:2025-12-26 15:26
 
©2010-2025 Purasbar Ver2.0
除非另有聲明,本站採用創用CC姓名標示-相同方式分享 3.0 Unported許可協議進行許可。