設置 | 登錄 | 註冊

目前共有4篇帖子。

移远EC200A模块使用说明

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;
}
巨大八爪鱼 2026-1-4 15:04
勘误:ret = send_command(fd, "AT+QIACT=1", &resp, 150);写错了,最后一个参数应该是150000。
巨大八爪鱼 2026-1-4 15:11
在usbnet 3号模式下,EC200M模块的USB interface 0和1(Mobile RNDIS Network Adapter)用的是linux内核自带的RNDIS驱动。
如果不是3号模式,而是1号模式的话,那么USB接口的排布是不一样的。
root@rk3308b-buildroot:/root# cat /sys/bus/usb/devices/2-1/2-1:1.0/interface
Mobile ECM Network Adapter
root@rk3308b-buildroot:/root# cat /sys/bus/usb/devices/2-1/2-1:1.1/interface
cat: '/sys/bus/usb/devices/2-1/2-1:1.1/interface': No such file or directory
root@rk3308b-buildroot:/root# cat /sys/bus/usb/devices/2-1/2-1:1.2/interface
Mobile Diag Interface
root@rk3308b-buildroot:/root# cat /sys/bus/usb/devices/2-1/2-1:1.3/interface
Mobile AT Interface
root@rk3308b-buildroot:/root# cat /sys/bus/usb/devices/2-1/2-1:1.4/interface
Mobile AT Interface
root@rk3308b-buildroot:/root#
并且EC200M有6个接口,比EC200A多了一个6号接口。
root@rk3308b-buildroot:/root# cat /sys/bus/usb/devices/2-1/2-1:1.6/interface
Mobile NMEA Interface
root@rk3308b-buildroot:/root#

在usbnet 1号模式下,EC200M模块的USB interface 0(Mobile ECM Network Adapter)和1(无接口名称)用的是linux内核自带的cdc_ether驱动(net/usb/cdc_ether.c)。
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:46 /sys/bus/usb/devices/2-1/2-1:1.0/driver -> ../../../../../../bus/usb/drivers/cdc_ether
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:48 /sys/bus/usb/devices/2-1/2-1:1.1/driver -> ../../../../../../bus/usb/drivers/cdc_ether
root@rk3308b-buildroot:/root# ls -l /sys/bus/usb/devices/2-1/2-1:1.2/driver
lrwxrwxrwx 1 root root 0 Jan  1 00:46 /sys/bus/usb/devices/2-1/2-1:1.2/driver -> ../../../../../../bus/usb/drivers/option
root@rk3308b-buildroot:/root# ls -l /sys/bus/usb/devices/2-1/2-1:1.3/driver
lrwxrwxrwx 1 root root 0 Jan  1 00:46 /sys/bus/usb/devices/2-1/2-1:1.3/driver -> ../../../../../../bus/usb/drivers/option
root@rk3308b-buildroot:/root# ls -l /sys/bus/usb/devices/2-1/2-1:1.4/driver
ls: cannot access '/sys/bus/usb/devices/2-1/2-1:1.4/driver': No such file or directory
root@rk3308b-buildroot:/root# ls -l /sys/bus/usb/devices/2-1/2-1:1.6/driver
ls: cannot access '/sys/bus/usb/devices/2-1/2-1:1.6/driver': No such file or directory
root@rk3308b-buildroot:/root#
巨大八爪鱼 2026-1-4 15:14
在usbnet 1号模式下,usb interface 1无接口名称。但在usbnet 3号模式下,usb insterface 1有接口名称,名称是Mobile RNDIS Network Adapter。

內容轉換:

回覆帖子
內容:
用戶名: 您目前是匿名發表。
驗證碼:
看不清?換一張