OpenHarmony中AT模塊的代碼理解之三
??51CTO和華為官方合作共建的鴻蒙技術(shù)社區(qū)??
現(xiàn)在開啟第三篇，核心內(nèi)容是AT命令的注冊。
1、AT命令結(jié)構(gòu)體
typedef struct {
hi_char *at_cmd_name;
hi_s8 at_cmd_len;
at_call_back_func at_test_cmd;
at_call_back_func at_query_cmd;
at_call_back_func at_setup_cmd;
at_call_back_func at_exe_cmd;
} at_cmd_func;
hi_char *at_cmd_name;為命令字符串，不包含“AT”字符。
hi_s8 at_cmd_len;為字符串長度。
后面的四個回調(diào)函數(shù)，分別對應(yīng)AT命令的四種類似：測試命令，查詢命令，設(shè)置命令和執(zhí)行命令。
如：{“+RST”, 4, HI_NULL, HI_NULL, (at_call_back_func)at_setup_reset_cmd, (at_call_back_func)at_exe_reset_cmd}。
2、注冊函數(shù)
hi_at_sys_cmd_register()這個函數(shù)中包含了很多注冊的函數(shù)。每個函數(shù)又包含了一類的AT命令。
hi_void hi_at_sys_cmd_register(hi_void)
{
hi_at_general_cmd_register();
#ifndef CONFIG_FACTORY_TEST_MODE
hi_at_sta_cmd_register();
hi_at_softap_cmd_register();
#endif
hi_at_hipriv_cmd_register();
#ifndef CONFIG_FACTORY_TEST_MODE
#ifdef LOSCFG_APP_MESH
hi_at_mesh_cmd_register();
#endif
hi_at_lowpower_cmd_register();
#endif
hi_at_general_factory_test_cmd_register();
hi_at_sta_factory_test_cmd_register();
hi_at_hipriv_factory_test_cmd_register();
hi_at_io_cmd_register();
}
只取其中的一個，進(jìn)行進(jìn)一步的說明，拿這個函數(shù)hi_at_general_cmd_register()舉例。函數(shù)中引用了AT命令的注冊函數(shù)。
hi_at_register_cmd(g_at_general_func_tbl, AT_GENERAL_FUNC_NUM);
函數(shù)的參數(shù)有兩個：結(jié)構(gòu)體數(shù)組和結(jié)構(gòu)體數(shù)組的長度。結(jié)構(gòu)體數(shù)組就是第一部分中介紹的AT命令結(jié)構(gòu)體。
const at_cmd_func g_at_general_func_tbl[] = {
{"", 0, HI_NULL, HI_NULL, HI_NULL, (at_call_back_func)at_exe_at_cmd},
{"+RST", 4, HI_NULL, HI_NULL, (at_call_back_func)at_setup_reset_cmd, (at_call_back_func)at_exe_reset_cmd},
{"+MAC", 4, HI_NULL, (at_call_back_func)cmd_get_macaddr, (at_call_back_func)cmd_set_macaddr, HI_NULL},
{"+HELP", 5, HI_NULL, HI_NULL, HI_NULL, (at_call_back_func)at_exe_help_cmd},
}；
下面對注冊函數(shù)的實(shí)現(xiàn)進(jìn)行說明。
hi_u32 hi_at_register_cmd(HI_CONST at_cmd_func *cmd_tbl, hi_u16 cmd_num)
{
hi_u32 ret = HI_ERR_FAILURE;
hi_u8 i;
if (cmd_tbl == HI_NULL || cmd_num == 0) {
return HI_ERR_FAILURE;
}
ret = check_cmd_tbl(cmd_tbl, cmd_num);
if (ret != HI_ERR_SUCCESS) {
return ret;
}
at_cmd_func_list *cmd_list = at_get_list();
for (i = 0; i < AT_CMD_LIST_NUM; i++) {
if ((cmd_list->at_cmd_list[i] == HI_NULL) || (cmd_list->at_cmd_num[i] == 0)) {
cmd_list->at_cmd_list[i] = cmd_tbl;
cmd_list->at_cmd_num[i] = cmd_num;
ret = HI_ERR_SUCCESS;
break;
}
ret = check_name_and_callback(cmd_list, i, cmd_tbl, cmd_num);
if (ret != HI_ERR_SUCCESS) {
break;
}
}
return ret;
}
其中幾個核心函數(shù)的說明：
（1）check_cmd_tbl(cmd_tbl, cmd_num)。
確認(rèn)需要注冊的AT命令結(jié)構(gòu)體中沒有重復(fù)的指令。
（2）at_get_list()。
獲取全局變量HI_PRV at_cmd_func_list g_at_cmd_list = { 0 }的指針。這個結(jié)構(gòu)體數(shù)據(jù)中存儲著已經(jīng)注冊的AT命令。
（3）check_name_and_callback(cmd_list, i, cmd_tbl, cmd_num)。
為檢查要注冊的AT命令是否有重復(fù)，避免重復(fù)注冊。
（4）for (i = 0; i < AT_CMD_LIST_NUM; i++) {}去遍歷g_at_cmd_list中已經(jīng)存儲到了第幾個位置。如果遍歷到空位置，則將要注冊的AT命令結(jié)構(gòu)體的指針進(jìn)行存儲。
cmd_list->at_cmd_list[i] = cmd_tbl;
cmd_list->at_cmd_num[i] = cmd_num;
3、總結(jié)
注冊部分功能，就是將AT命令的添加到g_at_cmd_list的數(shù)組中。等到通過串口接收到的指令進(jìn)行解析的時候，還會遍歷存儲在g_at_cmd_list中的指令的。所有這個結(jié)構(gòu)體數(shù)組，后續(xù)還會用到。
如果想要自己添加AT命令?？梢苑抡战o出的通用規(guī)則，自己添加即可。這里不展開說明。
這篇文章，就先介紹到這里。
??51CTO和華為官方合作共建的鴻蒙技術(shù)社區(qū)??
