at.h

Go to the documentation of this file.

/*
 * Copyright (C) 2017 Kaspar Schleiser <kaspar@schleiser.de>
 *
 * This file is subject to the terms and conditions of the GNU Lesser
 * General Public License v2.1. See the file LICENSE in the top level
 * directory for more details.
 */
 
#ifndef AT_H
#define AT_H
 
#include <stdint.h>
#include <unistd.h>
#include <stdbool.h>
 
#include "isrpipe.h"
#include "periph/uart.h"
#include "clist.h"
#include "kernel_defines.h"
 
#include "event.h"
 
#ifdef __cplusplus
extern "C" {
#endif
 
#if IS_ACTIVE(CONFIG_AT_SEND_EOL_WINDOWS)
#define CONFIG_AT_SEND_EOL   "\r\n"
#elif IS_ACTIVE(CONFIG_AT_SEND_EOL_UNIX)
#define CONFIG_AT_SEND_EOL   "\n"
#elif IS_ACTIVE(CONFIG_AT_SEND_EOL_MAC)
#define CONFIG_AT_SEND_EOL   "\r"
#endif
 
#ifndef CONFIG_AT_SEND_EOL
#define CONFIG_AT_SEND_EOL "\r"
#endif
 
#ifdef DOXYGEN
#define CONFIG_AT_SEND_SKIP_ECHO
#endif
 
#ifndef AT_SEND_ECHO
#if IS_ACTIVE(CONFIG_AT_SEND_SKIP_ECHO)
#define AT_SEND_ECHO 0
#else
#define AT_SEND_ECHO 1
#endif
#endif
 
#ifndef AT_RECV_EOL_1
#define AT_RECV_EOL_1   "\r"
#endif
 
#ifndef AT_RECV_EOL_2
#define AT_RECV_EOL_2   "\n"
#endif
 
#ifndef CONFIG_AT_RECV_OK
#define CONFIG_AT_RECV_OK "OK"
#endif
 
#ifndef CONFIG_AT_RECV_ERROR
#define CONFIG_AT_RECV_ERROR "ERROR"
#endif
 
#if defined(MODULE_AT_URC) || DOXYGEN
 
#ifndef CONFIG_AT_BUF_SIZE_EXP
#define CONFIG_AT_BUF_SIZE_EXP (7U)
#endif
 
#ifndef AT_BUF_SIZE
#define AT_BUF_SIZE   (1 << CONFIG_AT_BUF_SIZE_EXP)
#endif
 
typedef void (*at_urc_cb_t)(void *arg, const char *code);
 
typedef struct {
    clist_node_t list_node; 
    at_urc_cb_t cb;         
    const char *code;       
    void *arg;              
} at_urc_t;
 
#endif /* MODULE_AT_URC */
 
#define AT_SEND_EOL_LEN  (sizeof(CONFIG_AT_SEND_EOL) - 1)
 
typedef struct {
    isrpipe_t isrpipe;      
    uart_t uart;            
#ifdef MODULE_AT_URC
    clist_node_t urc_list;  
#ifdef MODULE_AT_URC_ISR
    bool awaiting_response; 
    event_t event;          
#endif
#endif
} at_dev_t;
 
int at_dev_init(at_dev_t *dev, uart_t uart, uint32_t baudrate, char *buf, size_t bufsize);
 
int at_send_cmd_wait_ok(at_dev_t *dev, const char *command, uint32_t timeout);
 
int at_send_cmd_wait_prompt(at_dev_t *dev, const char *command, uint32_t timeout);
 
ssize_t at_send_cmd_get_resp(at_dev_t *dev, const char *command, char *resp_buf, size_t len, uint32_t timeout);
 
ssize_t at_send_cmd_get_lines(at_dev_t *dev, const char *command, char *resp_buf,
                              size_t len, bool keep_eol, uint32_t timeout);
 
int at_expect_bytes(at_dev_t *dev, const char *bytes, uint32_t timeout);
 
int at_recv_bytes_until_string(at_dev_t *dev, const char *string,
                               char *bytes, size_t *bytes_len,
                               uint32_t timeout);
 
void at_send_bytes(at_dev_t *dev, const char *bytes, size_t len);
 
ssize_t at_recv_bytes(at_dev_t *dev, char *bytes, size_t len, uint32_t timeout);
 
int at_send_cmd(at_dev_t *dev, const char *command, uint32_t timeout);
 
ssize_t at_readline(at_dev_t *dev, char *resp_buf, size_t len, bool keep_eol, uint32_t timeout);
 
void at_drain(at_dev_t *dev);
 
void at_dev_poweron(at_dev_t *dev);
 
void at_dev_poweroff(at_dev_t *dev);
 
#if defined(MODULE_AT_URC) || DOXYGEN
 
void at_add_urc(at_dev_t *dev, at_urc_t *urc);
 
void at_remove_urc(at_dev_t *dev, at_urc_t *urc);
 
void at_process_urc(at_dev_t *dev, uint32_t timeout);
#endif
 
#ifdef __cplusplus
}
#endif
 
#endif /* AT_H */