配置脚本:
【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;
}