Bendi新闻
>
推荐一个开源的AT命令解析模块

推荐一个开源的AT命令解析模块

10月前

来源:https://toscode.gitee.com/smtian/AT-Command

介绍

一种AT命令通信解析模块,支持裸机(at_chat)和OS版本(at)。适用于modem、WIFI模块、蓝牙通信。

软件架构

  • • at_chat.c at_chat.h list.h

用于无OS版本,使用链式队列及异步回调方式处理AT命令收发,支持URC处理、自定义命令发送与解析作业。

  • • at.c at.h at_util.h comdef.h

用于OS版本, 使用前需要根据at_util.h规定的操作系统相关的接口进行移植,如提供信号量操作、任务延时等操作。

使用说明

at_chat 模块(无OS)

基本概念

at_chat 模块使用链式队列进行管理,包含2条链表,空闲链表和就绪链表。它们的每一个基本工作单元称为一个作业项,对于将要执行的命令都会放到就绪链表中,命令执行完成之后由空闲链表来进行回收,作业项的定义如下:

/*AT作业项*/
typedef struct {
    unsigned int  state : 3;
    unsigned int  type  : 3;                                 /* 作业类型*/
    unsigned int  abort : 1
    void          *param;                                    /* 通用参数*/
    void          *info;                                     /* 通用信息指针*/
    struct list_head node;                                   /* 链表结点*/
}at_item_t;

作业是AT控制器定义时固定分配的,没有使用动态内存,默认支持10个作业项,即同时可以允许10个AT命令排队等待处理。

基本接口与描述

  • • at_send_singlline, 发送单行命令,默认等待OK响应,超时3S

  • • at_send_multiline, 多行命令,默认等待OK响应,超时3S

  • • at_do_cmd,支持自定义发送格式与接收匹配串

  • • at_do_work,支持自定义发送与接收解析

效果演示

详细使用可以参考Demo程序wifi_task.c模块

m169 wifi模组通信效果图

使用步骤

1.定义AT控制器及通信适配器接口

/* 
 * @brief   定义AT控制器
 */

static at_obj_t at;

const at_adapter_t adap = {  //AT适配器接口
    //适配GPRS模块的串口读写接口
    .write       = uart_write,
    .read        = uart_read
    ...
};
  1. 1. 初始化AT控制器并放入任务中轮询(考虑到处理实时性,建议20ms以下)

/* 
 * @brief    wifi初始化
 */

void wifi_init(void)
{
    at_obj_init(&at, &adap);
    /*...*/
}driver_init("wifi", wifi_init); 

/* 
 * @brief    wifi任务(10ms 轮询1次)
 */

void wifi_task(void)
{
    at_poll_task(&at);
}task_register("wifi", wifi_task, 10);

例子演示

//WIFI IO配置命令
=> AT+GPIO_TEST_EN=1\r\n

<= OK\r\n
/**
 * @brief AT执行回调处理程序
 */

static void test_gpio_callback(at_response_t *r)
{
    if (r->ret == AT_RET_OK ) {
        printf("Execute successfully\r\n");
    } else {
        printf("Execute failure\r\n");
    }
}
at_send_singlline(&at, test_gpio_callback, "AT+GPIO_TEST_EN=1");

at 模块(OS版本)

由于AT命令通信是一个比较复杂的过程,对于没有OS的环境下处理难度比较大,也很绕,对于不允许阻塞程序,除了使用状态与+回调没有其它更好的办法,所以推荐使用这个模块

基本接口与描述

  • • at_do_cmd,执行AT命令,可以通过这个接口进一步封装出一常用的单行命令、多行命令。

  • • at_split_respond_lines,命令响应分割器。

  • • at_do_work,适用于发送组合命令,如GPRS模组发送短信或者发送socket数据需要等待"<"或者"CONNECT"提示符,可以通过这个接口自定义收发。

使用步骤

1.定义AT控制器、通信适配器接口(包含URC回调函数表,接口缓冲区URC)

static at_obj_t at;          //定义AT控制器对象

static char urc_buf[128];    //URC主动上报缓冲区

utc_item_t utc_tbl[] = {     //定义URC表
    "+CSQ: ", csq_updated_handler
}

const at_adapter_t adap = {  //AT适配器接口
    .urc_buf     = urc_buf,
    .urc_bufsize = sizeof(urc_buf),
    .utc_tbl     = utc_tbl,
    .urc_tbl_count = sizeof(utc_tbl) / sizeof(utc_item_t), 
    //debug调试接口
    .debug       = at_debug, 
    //适配GPRS模块的串口读写接口
    .write       = uart_write,
    .read        = uart_read
};

2.创建AT控制器并创建轮询处理线程

void at_thread(void)
{
    at_obj_create(&at, &adap);
    while (1) {        
        at_process(&at);
    }
}

例子演示

例子1(查询无线模组信号质量)

/** at_do_cmd 接口使用演示
    查询GPRS模组信号质量命令
    => AT+CSQ
    
    <= +CSQ: 24, 0
    <= OK
*/


/* 
 * @brief    获取csq值
 */
 
bool read_csq_value(at_obj_t *at, int *rssi, int *error_rate)
{
    //接收缓冲区
    unsigned char recvbuf[32];
    //AT应答
    at_respond_t r = {"OK", recvbuf, sizeof(recvbuf), 3000};
    //
    if (at_do_cmd(at, &r, "AT+CSQ") != AT_RET_OK)
        return false;
    //提取出响应数据
    return (sscanf(recv, "%*[^+]+CSQ: %d,%d", rssi, error_rate) == 2);

}

例子2(发送TCP数据)

/** at_do_work 接口使用演示
    参考自hl8518模组Socket 数据发送命令
    => AT+KTCPSND=<session_id>,<ndata>
    
    <= CONNECT
    
    => <data>
    
    <= OK
*/


/*
 * @brief       数据发送处理
 * @retval      none
 */

static bool socket_send_handler(at_work_ctx_t *e)
{
    struct socket_info *i = (struct socket_info *)e->params;
    struct ril_sock *s    = i->s;
    
    if (s->type == SOCK_TYPE_TCP)
        e->printf(e, "AT+KTCPSND=%d,%d", s->session, i->bufsize);
    else
        e->printf(e, "AT+KUDPSND=%d,%s,%d,%d",s->session, s->host, 
        s->port, i->bufsize);        

    if (e->wait_resp(e, "CONNECT"5000) != AT_RET_OK) {      //等待提示符
       goto Error;
    }         
    e->write(i->buf, i->bufsize);                             //发送数据
    
    e->write("--EOF--Pattern--"strlen("--EOF--Pattern--")); //发送结束符

    if (e->wait_resp(e, "OK"5000) == AT_RET_OK)
        return true;
    else {   
Error:
        e->write("--EOF--Pattern--"strlen("--EOF--Pattern--"));
        return false;
    }
}

/**
 * @brief       socket 数据发送
 * @param[in]   s   - socket
 * @param[in]   buf - 数据缓冲区
 * @param[in]   len - 缓冲区长度
 */

static bool hl8518_sock_send(ril_obj_t *r, struct ril_sock *s, const void *buf, 
                       unsigned int len)
{
    struct socket_info info = {s, (unsigned char *)buf, len, 0};
    if (len == 0)
        return false;       
    return at_do_work(&r->at, (at_work)socket_send_handler, &info);
}
推荐阅读  点击标题可跳转

1、什么是国密算法?

2、Linux内核PCIE

3、16张动图讲透网络原理

微信扫码关注该文公众号作者

来源:Linux爱好者

相关新闻

一个巨大的内存模块快手开源 I2V-Adapter,即插即用、轻量级模块让静态图像秒变动态视频模块化重构LLaVA,替换组件只需添加1-2个文件,开源TinyLLaVA Factory来了太牛了!20mins完成SCI初稿!中科院博士整理的模块化写作法!套用即可出稿……AI网络中GPU与光模块的比例和需求分析3块钱一个的“蔬菜之王”!水灵清甜还低卡,随手一蒸嘎嘎鲜数十万字秒读,2分钟出PPT!李开复推荐的「万知」AI助手,小程序免费用五光十色的多模态大模型:浅探视觉-语言大模型的关键模块设计超级好用的Python模块——glob模块更快的PCIe 6.0,更快的1.6T光模块推荐5款国产开源工作流引擎,轻松搞定复杂审批流程Node.js 22发布,增强了对ESM模块和Web API的支持《国家地理》推荐的这些地方,每一个都值得去一趟Python最常用的15个内置模块总结。。。推荐一个全球学生都在用的练口语利器淘宝绝对不会给你推荐的年货零食,9块9的那个太香了!究竟什么是“天赋”?推荐一个界定、鉴别孩子天赋的框架一篇看懂北美老师推荐的阅写神器A3000:一个学年蓝思提高一倍SIGIR 2024 | 共现关系还是细粒度偏好?ID和模态信息解耦的会话推荐时尚圈最火的“玻璃手提包”,2w块一个!一摔就碎,却风靡全球...网友:到底是谁在买啊!?Costco开市客20款值得推荐的高人气美好商品聊一个我很喜欢,但很难推荐的笔记本功能小扎宣布进军AGI!Meta正在训练Llama 3,目标是60万块H100!模型仍会开源Delphi:模块化借贷是 DeFi 货币市场的下一阶段
logo
联系我们隐私协议©2024 bendi.news
Bendi新闻
Bendi.news刊载任何文章,不代表同意其说法或描述,仅为提供更多信息,也不构成任何建议。文章信息的合法性及真实性由其作者负责,与Bendi.news及其运营公司无关。欢迎投稿,如发现稿件侵权,或作者不愿在本网发表文章,请版权拥有者通知本网处理。