104 lines
3.1 KiB
C
104 lines
3.1 KiB
C
|
|
|
|
#ifndef _H_SHELL_LEX_
|
|
#define _H_SHELL_LEX_
|
|
|
|
|
|
#include <stdint.h>
|
|
|
|
|
|
typedef uint8_t HShellLenType;
|
|
#define HSHELL_ERROR_INDEX (0xff)
|
|
|
|
///< 可配置最多可注册回调多少个
|
|
#ifndef HSHELL_CALL_MAX
|
|
#define HSHELL_CALL_MAX 5
|
|
#endif
|
|
|
|
///< 命令行缓存长度
|
|
#ifndef HSHELL_CMD_LINE_BUFFER
|
|
#define HSHELL_CMD_LINE_BUFFER 32
|
|
#endif
|
|
|
|
///< 解析token参数的最大个数
|
|
#ifndef HSHELL_CMD_TOKEN_MAX
|
|
#define HSHELL_CMD_TOKEN_MAX 5
|
|
#endif
|
|
|
|
///< 使用专门接口避免日志系统关闭日志打印导致命令不输出的问题
|
|
#define HSHELL_PRINTF(format, ...) printf(format, ##__VA_ARGS__)
|
|
|
|
|
|
///< 处理命令行token
|
|
typedef struct __attribute__ ((__packed__)) HShellCmdToken
|
|
{
|
|
const uint8_t* str; ///< 指向每项数据开头, 如 echo 123 会有2个token, 一个str指向echo, 一个str指向123
|
|
uint8_t len; ///< 数据长度
|
|
} HShellCmdToken;
|
|
|
|
// 匹配映射表初始化每项的辅助宏
|
|
#define HSHELL_MATCH_ITEM(token, str) {token, sizeof(str) - 1, (const uint8_t *)str}
|
|
|
|
///< 匹配映射表
|
|
typedef struct __attribute__ ((__packed__)) HShellMatch
|
|
{
|
|
HShellLenType token; ///< 匹配后对应的映射值
|
|
uint8_t matchLen; ///< 需要匹配的字符串长度
|
|
const uint8_t *match; ///< 需要匹配的字符串
|
|
} HShellMatch;
|
|
|
|
|
|
/**
|
|
* @brief 命令行解析回调
|
|
* @param key 命令行解析的首个token
|
|
* @param tokens 原始token, 可自行处理后续命令的所需的参数
|
|
* @param tokensLen 原始token个数
|
|
**/
|
|
typedef void (*shellCall)(HShellLenType key, const HShellCmdToken *tokens, int tokensLen);
|
|
|
|
/**
|
|
* @brief 解析命令行数据, 将解析后的数据写入tokens, 内存还是str, tokens是指向tokens的指针
|
|
* @brief str 命令行数据
|
|
* @brief strLen 命令行数据长度
|
|
* @brief tokens 命令行解析后写入的token
|
|
* @brief tokensLen toknes长度
|
|
* @return 返回token个数
|
|
**/
|
|
uint8_t HShellLex(const uint8_t *str, int strLen, HShellCmdToken *tokens, int tokensLen);
|
|
|
|
/**
|
|
* @brief 查找token匹配对应token枚举值, 判断是否忽略大小写
|
|
* @param token 命令行解析的token
|
|
* @param matches 匹配映射表
|
|
* @param matchLen 匹配映射表个数
|
|
* @param ignoreCase 是否忽略大小写
|
|
* @return 返回对应token映射值, 如果不存在返回 HSHELL_ERROR_INDEX
|
|
**/
|
|
HShellLenType HShellMatchToken(const HShellCmdToken *token, const HShellMatch *matches, int matchLen, uint8_t ignoreCase);
|
|
|
|
/**
|
|
* @brief 注册命令行解析回调, 如果存在匹配映射表则覆盖原有映射
|
|
* @param matches 匹配映射表
|
|
* @param matchLen 匹配映射表个数
|
|
* @param call 命令行解析回调
|
|
* @param ignoreCase 是否忽略大小写
|
|
* @return 返回注册的索引, 错误返回 -1
|
|
**/
|
|
int16_t HSHellRegister(const HShellMatch *matches, int matchLen, shellCall call, uint8_t ignoreCase);
|
|
|
|
/**
|
|
* @brief 注销命令行解析回调
|
|
* @param index 注销的索引
|
|
**/
|
|
void HSHellUnregister(int16_t index);
|
|
|
|
/**
|
|
* @brief 添加命令行数据, 直到换行'\n'才处理
|
|
* @param str 命令行数据
|
|
* @param strLen 命令行数据长度
|
|
**/
|
|
void HShellAddCmdData(uint8_t data);
|
|
void HSHellAddCmdDatas(uint8_t *data, int len);
|
|
|
|
#endif // _H_SHELL_LEX_
|