AT-Command/at.c

/******************************************************************************
 * @brief        AT<EFBFBD><EFBFBD><EFBFBD><EFBFBD>ͨ<EFBFBD>Ź<EFBFBD><EFBFBD><EFBFBD>(OS<EFBFBD>汾)
 *
 * Copyright (c) 2020, <morro_luo@163.com>
 *
 * SPDX-License-Identifier: Apache-2.0
 *
 * Change Logs: 
 * Date           Author       Notes 
 * 2020-01-02     Morro        Initial version. 
 * 2021-02-01     Morro        ֧<EFBFBD><EFBFBD>URC<EFBFBD>ص<EFBFBD><EFBFBD>н<EFBFBD><EFBFBD><EFBFBD><EFBFBD><EFBFBD><EFBFBD><EFBFBD>.
 * 2021-02-05     Morro        1.<EFBFBD>޸<EFBFBD>struct at_obj,ȥ<EFBFBD><EFBFBD><EFBFBD><EFBFBD><EFBFBD><EFBFBD><EFBFBD><EFBFBD><EFBFBD><EFBFBD><EFBFBD><EFBFBD><EFBFBD><EFBFBD>
 *                             2.ɾ<EFBFBD><EFBFBD> at_obj_destroy<EFBFBD>ӿ<EFBFBD>
 ******************************************************************************/
#include "at/at.h"
#include "misc/comdef.h"
#include <stdarg.h>
#include <string.h>
#include <stdio.h>
#include <stddef.h>

//<2F><>ʱ<EFBFBD>ж<EFBFBD>
#define AT_IS_TIMEOUT(start, time) (at_get_ms() - (start) > (time))

/*
 * @brief    Ĭ<EFBFBD>ϵ<EFBFBD><EFBFBD>Խӿ<EFBFBD>
 */
static void nop_dbg(const char *fmt, ...){}

/*
 * @brief    <EFBFBD><EFBFBD>ȡat<EFBFBD><EFBFBD><EFBFBD><EFBFBD><EFBFBD><EFBFBD>
 */
at_obj_t *get_at_obj(struct at_work_ctx *e)
{
    return container_of(e, at_obj_t, ctx);
}


/*
 * @brief    <EFBFBD><EFBFBD><EFBFBD><EFBFBD><EFBFBD>ַ<EFBFBD><EFBFBD><EFBFBD>
 */
static void put_string(at_obj_t *at, const char *s)
{
    while (*s != '\0')
        at->adap.write(s++, 1);
}


/*
 * @brief    <EFBFBD><EFBFBD><EFBFBD><EFBFBD><EFBFBD>ַ<EFBFBD><EFBFBD><EFBFBD>(<EFBFBD><EFBFBD><EFBFBD><EFBFBD><EFBFBD><EFBFBD>)
 */
static void put_line(at_obj_t *at, const char *s)
{
    put_string(at, s);
    put_string(at, "\r\n");    
    at->adap.debug("->\r\n%s\r\n", s);
}

//<2F><>ӡ<EFBFBD><D3A1><EFBFBD><EFBFBD>
static void at_print(struct at_work_ctx *e, const char *cmd, ...)
{
    va_list args;
    va_start(args, cmd);
    char buf[MAX_AT_CMD_LEN];
    vsnprintf(buf, sizeof(buf), cmd, args);
    put_line(get_at_obj(e), buf);
    va_end(args);	
}

/*
 * @brief   <EFBFBD><EFBFBD><EFBFBD><EFBFBD><EFBFBD><EFBFBD><EFBFBD>ݻ<EFBFBD><EFBFBD><EFBFBD><EFBFBD><EFBFBD>
 */
static void recvbuf_clr(struct at_work_ctx *e)
{
    get_at_obj(e)->rcv_cnt = 0;
}

//<2F>ȴ<EFBFBD>AT<41><54><EFBFBD><EFBFBD><EFBFBD><EFBFBD>Ӧ
static at_return wait_resp(at_obj_t *at, at_respond_t *r)
{    
    at->resp  = r;
    at->ret   = AT_RET_TIMEOUT;
    at->resp_timer = at_get_ms();    
    at->rcv_cnt = 0;                   //<2F><><EFBFBD>ս<EFBFBD><D5BD>ջ<EFBFBD><D5BB><EFBFBD>
    at_sem_wait(at->completed, r->timeout);
    at->adap.debug("<-\r\n%s\r\n", r->recvbuf);
    at->resp = NULL;
    return at->ret;
}

/*
 * @brief       ͬ<EFBFBD><EFBFBD><EFBFBD><EFBFBD>ӦAT<EFBFBD><EFBFBD>Ӧ
 * @param[in]   resp    - <EFBFBD>ȴ<EFBFBD><EFBFBD><EFBFBD><EFBFBD>մ<EFBFBD>(<EFBFBD><EFBFBD>"OK",">")
 * @param[in]   timeout - <EFBFBD>ȴ<EFBFBD><EFBFBD><EFBFBD>ʱʱ<EFBFBD><EFBFBD>
 */
at_return wait_resp_sync(struct at_work_ctx *e, const char *resp, 
                         unsigned int timeout)
{
    char buf[64];
    int cnt = 0, len;
    at_obj_t *at = get_at_obj(e);
    
    at_return ret = AT_RET_TIMEOUT;
    unsigned int timer = at_get_ms();
    while (at_get_ms() - timer < timeout) {
        len = at->adap.read(buf, sizeof(buf) - cnt);
        cnt += len;
        buf[cnt] = '\0';
        if (strstr(buf, resp)) {
            ret =  AT_RET_OK;
            break;
        } else if (strstr(buf, "ERROR")) {
            ret =  AT_RET_ERROR;
            break;
        }
        at_delay(10);
    }
    at->adap.debug("%s\r\n", buf);
    return ret;
}


/*
 * @brief       <EFBFBD><EFBFBD><EFBFBD><EFBFBD>AT<EFBFBD><EFBFBD><EFBFBD><EFBFBD><EFBFBD><EFBFBD>
 */
void at_obj_create(at_obj_t *at, const at_adapter_t *adap)
{
    at_work_ctx_t *ctx;
    at->adap    = *adap;
    at->rcv_cnt = 0;
    
    at->cmd_lock = ril_sem_new(1);
    at->completed = ril_sem_new(0);
    ctx          = &at->ctx;    
    ctx->printf  = at_print;
    ctx->recvclr = recvbuf_clr;
    ctx->read    = adap->read;
    ctx->write   = adap->write;
    ctx->wait_resp = wait_resp_sync;
    
    if (at->adap.debug == NULL)
        at->adap.debug = nop_dbg;
    
}

/*
 * @brief       ִ<EFBFBD><EFBFBD><EFBFBD><EFBFBD><EFBFBD><EFBFBD>
 * @param[in]   fmt    - <EFBFBD><EFBFBD>ʽ<EFBFBD><EFBFBD><EFBFBD><EFBFBD><EFBFBD><EFBFBD>
 * @param[in]   r      - <EFBFBD><EFBFBD>Ӧ<EFBFBD><EFBFBD><EFBFBD><EFBFBD>,<EFBFBD><EFBFBD><EFBFBD><EFBFBD><EFBFBD><EFBFBD>NULL, Ĭ<EFBFBD>Ϸ<EFBFBD><EFBFBD><EFBFBD>OK<EFBFBD><EFBFBD>ʾ<EFBFBD>ɹ<EFBFBD>,<EFBFBD>ȴ<EFBFBD>5s
 * @param[in]   args   - <EFBFBD><EFBFBD><EFBFBD><EFBFBD><EFBFBD><EFBFBD><EFBFBD><EFBFBD><EFBFBD>б<EFBFBD>
 */
at_return at_do_cmd(at_obj_t *at, at_respond_t *r, const char *cmd)
{
    at_return ret;
    char      defbuf[64];
    at_respond_t  default_resp = {"OK", defbuf, sizeof(defbuf), 5000};
    if (r == NULL) {
        r = &default_resp;                 //Ĭ<><C4AC><EFBFBD><EFBFBD>Ӧ      
    }
    if (!at_sem_wait(at->cmd_lock, r->timeout)) {
        return AT_RET_TIMEOUT;    
    }
    at->busy  = true;
    
    while (at->urc_cnt) {
        at_delay(10);
    }
    put_line(at, cmd);
    ret = wait_resp(at, r); 
    at_sem_post(at->cmd_lock);
    at->busy  = false;
    return ret;    
}

/*
 * @brief       ִ<EFBFBD><EFBFBD>AT<EFBFBD><EFBFBD>ҵ
 * @param[in]   urc
 * @return      none
 */
at_return at_do_work(at_obj_t *at, at_work work, void *params)
{
    at_return ret;
    if (!at_sem_wait(at->cmd_lock, 150 * 1000)) {
        return AT_RET_TIMEOUT;
    }
    at->busy  = true;
    while (at->urc_cnt) {                            //<2F>ȴ<EFBFBD>URC<52><43><EFBFBD><EFBFBD><EFBFBD><EFBFBD><EFBFBD><EFBFBD>
        at_delay(1);
    }
    at->ctx.params = params;
    at->dowork  = true;
    at->rcv_cnt = 0;
    ret = work(&at->ctx);
    at->dowork = false;
    at_sem_post(at->cmd_lock);
    at->busy  = false;
    return ret;
}

/*
 * @brief       <EFBFBD>ָ<EFBFBD><EFBFBD><EFBFBD>Ӧ<EFBFBD><EFBFBD>
 * @param[in]   recvbuf  - <EFBFBD><EFBFBD><EFBFBD>ջ<EFBFBD><EFBFBD><EFBFBD><EFBFBD><EFBFBD> 
 * @param[out]  lines    - <EFBFBD><EFBFBD>Ӧ<EFBFBD><EFBFBD><EFBFBD><EFBFBD><EFBFBD><EFBFBD>
 * @param[in]   separator- <EFBFBD>ָ<EFBFBD><EFBFBD><EFBFBD>(, \n)
 * @return      <EFBFBD><EFBFBD><EFBFBD><EFBFBD>
 */
int at_split_respond_lines(char *recvbuf, char *lines[], int count, char separator)
{
    char *s = recvbuf;
    size_t i = 0;      
    if (s == NULL || lines == NULL) 
        return 0;     
        
    lines[i++] = s;    
    while(*s && i < count) {       
        if (*s == ',') {
            *s = '\0';                                       
            lines[i++] = s + 1;                           /*ָ<><D6B8><EFBFBD><EFBFBD>һ<EFBFBD><D2BB><EFBFBD>Ӵ<EFBFBD>*/
        }
        s++;        
    }    
    return i;
}

/*
 * @brief       urc <EFBFBD><EFBFBD><EFBFBD><EFBFBD><EFBFBD><EFBFBD><EFBFBD><EFBFBD><EFBFBD><EFBFBD>
 * @param[in]   urcline - URC<EFBFBD><EFBFBD>
 * @return      true - <EFBFBD><EFBFBD><EFBFBD><EFBFBD>ʶ<EFBFBD>𲢴<EFBFBD><EFBFBD><EFBFBD>, false - δʶ<EFBFBD><EFBFBD>URC
 */
static bool urc_handler_entry(at_obj_t *at, char *urcline, unsigned int size)
{
    int i;
    int ch = urcline[size - 1];
    at_urc_ctx_t context = {at->adap.read, urcline, at->adap.urc_bufsize, size};
    
    const utc_item_t *tbl = at->adap.utc_tbl;
    
    if (tbl == NULL)
        return true;
    
    for (i = 0; i < at->adap.urc_tbl_count; i++) {
        if (strstr(urcline, tbl->prefix)) {               /* ƥ<><C6A5>ǰ׺*/
            
            if (tbl->end_mark) {                          /* ƥ<><C6A5><EFBFBD><EFBFBD><EFBFBD><EFBFBD><EFBFBD><EFBFBD><EFBFBD><EFBFBD>*/
                if (!strchr(tbl->end_mark, ch))
                    return false;
            } else if (!(ch == '\r' || ch == '\n'|| ch == '\0'))
                return false;
            
            at->adap.debug("<=\r\n%s\r\n", urcline);
            
            tbl->handler(&context);                       /* <20>ݽ<EFBFBD><DDBD><EFBFBD><EFBFBD>ϲ㴦<CFB2><E3B4A6> */
            return true;
        }    
        tbl++;
    }
    return false;        
}

/*
 * @brief       urc <EFBFBD><EFBFBD><EFBFBD>մ<EFBFBD><EFBFBD><EFBFBD>
 * @param[in]   ch  - <EFBFBD><EFBFBD><EFBFBD><EFBFBD><EFBFBD>ַ<EFBFBD>
 * @return      none
 */
static void urc_recv_process(at_obj_t *at, const char *buf, unsigned int size)
{
    register char *urc_buf;	
    int ch;
    urc_buf  = at->adap.urc_buf;
    
    //<2F><><EFBFBD>ճ<EFBFBD>ʱ<EFBFBD><CAB1><EFBFBD><EFBFBD>,Ĭ<><C4AC>MAX_URC_RECV_TIMEOUT
    if (at->urc_cnt > 0 && AT_IS_TIMEOUT(at->urc_timer, MAX_URC_RECV_TIMEOUT)) {
        urc_buf[at->urc_cnt] = '\0';
        at->urc_cnt = 0;
        at->adap.debug("urc recv timeout=>%s\r\n", urc_buf);
    } 
    
    while (size--) {
        at->urc_timer = at_get_ms();
        ch =  *buf++;
        urc_buf[at->urc_cnt++] = ch;
        
        if (strchr(SPEC_URC_END_MARKS, ch) || ch == '\0') {      //<2F><><EFBFBD><EFBFBD><EFBFBD><EFBFBD><EFBFBD><EFBFBD>
            urc_buf[at->urc_cnt] = '\0';
            
            if (ch == '\r' || ch == '\n'|| ch == '\0') {         //<2F><><EFBFBD>⵽1<E2B5BD><31>URC        
                if (at->urc_cnt > 2) {
                    if (!urc_handler_entry(at, urc_buf, at->urc_cnt) && !at->busy)   
                        at->adap.debug("%s\r\n", urc_buf);       //δʶ<CEB4>𵽵<EFBFBD>URC
                }
                at->urc_cnt = 0;
            } else if (urc_handler_entry(at, urc_buf, at->urc_cnt)) {
                at->urc_cnt = 0;
            }
        } else if (at->urc_cnt >= at->adap.urc_bufsize)          //<2F><><EFBFBD><EFBFBD><EFBFBD><EFBFBD><EFBFBD><EFBFBD>
                at->urc_cnt = 0;
    }
}

/*
 * @brief       <EFBFBD><EFBFBD><EFBFBD><EFBFBD><EFBFBD><EFBFBD>Ӧ֪ͨ
 * @return      none
 */
static void resp_notification(at_obj_t *at, at_return ret)
{
    at->ret = ret;
    at_sem_post(at->completed);
}

/*
 * @brief       ָ<EFBFBD><EFBFBD><EFBFBD><EFBFBD>Ӧ<EFBFBD><EFBFBD><EFBFBD>մ<EFBFBD><EFBFBD><EFBFBD>
 * @param[in]   buf  - <EFBFBD><EFBFBD><EFBFBD>ջ<EFBFBD><EFBFBD><EFBFBD><EFBFBD><EFBFBD>
 * @param[in]   size - <EFBFBD><EFBFBD><EFBFBD><EFBFBD><EFBFBD><EFBFBD><EFBFBD><EFBFBD><EFBFBD>ݳ<EFBFBD><EFBFBD><EFBFBD>
 * @return      none
 */
static void resp_recv_process(at_obj_t *at, const char *buf, unsigned int size)
{
    char *rcv_buf;
    unsigned short rcv_size;	
    at_respond_t *resp = at->resp;
    
    if (resp == NULL)                                    //<2F><><EFBFBD><EFBFBD><EFBFBD><EFBFBD><EFBFBD><EFBFBD><EFBFBD><EFBFBD>
        return;
    
    if (size) {
        rcv_buf  = (char *)resp->recvbuf;
        rcv_size = resp->bufsize;

        if (at->rcv_cnt + size >= rcv_size) {             //<2F><><EFBFBD><EFBFBD><EFBFBD><EFBFBD><EFBFBD><EFBFBD>
            at->rcv_cnt = 0;
            at->adap.debug("Receive overflow:%s", rcv_buf);
        }
        /*<2A><><EFBFBD><EFBFBD><EFBFBD>յ<EFBFBD><D5B5><EFBFBD><EFBFBD><EFBFBD><EFBFBD>ݷ<EFBFBD><DDB7><EFBFBD>rcv_buf<75><66> ---------------------------------------------*/
        memcpy(rcv_buf + at->rcv_cnt, buf, size);
        at->rcv_cnt += size;
        rcv_buf[at->rcv_cnt] = '\0';
        
        if (strstr(rcv_buf, resp->matcher)) {            //<2F><><EFBFBD><EFBFBD>ƥ<EFBFBD><C6A5>
            resp_notification(at, AT_RET_OK);
        } else if (strstr(rcv_buf, "ERROR")) {
            resp_notification(at, AT_RET_ERROR);
        }
    } 
    
    if (AT_IS_TIMEOUT(at->resp_timer, resp->timeout))    //<2F><><EFBFBD>ճ<EFBFBD>ʱ
        resp_notification(at, AT_RET_TIMEOUT);		
    else if (at->suspend)                                //ǿ<><C7BF><EFBFBD><EFBFBD>ֹ
        resp_notification(at, AT_RET_ABORT);

}

/*
 * @brief       ATæ<EFBFBD>ж<EFBFBD>
 * @return      true - <EFBFBD><EFBFBD>ATָ<EFBFBD><EFBFBD><EFBFBD><EFBFBD><EFBFBD><EFBFBD><EFBFBD><EFBFBD><EFBFBD><EFBFBD><EFBFBD><EFBFBD><EFBFBD><EFBFBD>ִ<EFBFBD><EFBFBD><EFBFBD><EFBFBD>
 */
bool at_obj_busy(at_obj_t *at)
{
    return !at->busy && AT_IS_TIMEOUT(at->urc_timer, 2000);
}

/*
 * @brief       <EFBFBD><EFBFBD><EFBFBD><EFBFBD>AT<EFBFBD><EFBFBD>ҵ
 * @return      none
 */
void at_suspend(at_obj_t *at)
{
    at->suspend = 1;
}

/*
 * @brief       <EFBFBD>ָ<EFBFBD>AT<EFBFBD><EFBFBD>ҵ
 * @return      none
 */
void at_resume(at_obj_t *at)
{
    at->suspend = 0;
}

/*
 * @brief       AT<EFBFBD><EFBFBD><EFBFBD><EFBFBD>
 * @return      none
 */
void at_process(at_obj_t *at)
{
    char c;
    unsigned int len;
    if (at->dowork)      /* <20>Զ<EFBFBD><D4B6><EFBFBD><EFBFBD><EFBFBD><EFBFBD><EFBFBD><EEB4A6> */
        return;
    do {
        len = at->adap.read(&c, 1);
        urc_recv_process(at, &c,len);
        resp_recv_process(at, &c, len);
    } while (len);
}