設(shè)備能力描述文件 profile 開(kāi)發(fā)
1)新增產(chǎn)品 設(shè)備的 Profile 文件是用來(lái)描述設(shè)備類型和設(shè)備服務(wù)能力的文件。定義了同一類設(shè)備具備的服務(wù)能力椭坚, 屬性予跌,命令等。
Step 1 登錄開(kāi)發(fā)者 Portal善茎,單擊“Profile 開(kāi)發(fā)>產(chǎn)品”券册,單擊頁(yè)面右上角的“自定義產(chǎn)品”,轉(zhuǎn)至“產(chǎn)品模板”頁(yè)面垂涯。
?您可以使用模板定義您的產(chǎn)品烁焙,單擊產(chǎn)品模板的“立即使用”,這里的參數(shù)需要根據(jù)您的設(shè)備進(jìn)行定義耕赘。
?您也可單擊右上角的“創(chuàng)建全新產(chǎn)品”骄蝇,直接定義您的產(chǎn)品,這里以創(chuàng)建全新產(chǎn)品為例操骡。
Step 3 在產(chǎn)品詳情頁(yè)面單擊“新建服務(wù)”鹦倚,根據(jù)界面提示信息,增加基本信息冀惭,屬性或命令震叙,單擊“保存”掀鹅。
? 新增服務(wù)基本信息,服務(wù)的名稱采用駝峰的命名方式媒楼,這里以 Light 為例乐尊。描述可選,有多個(gè)服務(wù)就新增多條服務(wù)划址。
2)新增屬性
3)新增命令 命令名稱:指示設(shè)備可以執(zhí)行的命令扔嵌。如門磁的 Lock 命令、攝像頭的 VIDEO_RECORD 命令
4)新增命令下發(fā)字段 命令名與參數(shù) 共同構(gòu)成一個(gè)完整的命令夺颤,在頁(yè)面上單擊“新增字段”痢缎。
完成設(shè)備能力描述文件 profile 開(kāi)發(fā)
設(shè)備數(shù)據(jù)編解碼中間件開(kāi)發(fā)(僅適用于與 NB-IoT 場(chǎng)景)
開(kāi)發(fā)完 Profile 文件后,可以在界面上通過(guò)圖形化的方式完成設(shè)備與平臺(tái)之間的消息映射世澜。在平臺(tái)中 預(yù)集成了編解碼插件的模板独旷,可以根據(jù)設(shè)備類型和接入?yún)f(xié)議在插件模板中選擇模板修改開(kāi)發(fā)編解碼插 件。 登錄開(kāi)發(fā)者 Portal寥裂,單擊“插件開(kāi)發(fā)”嵌洼,單擊右上角的“添加插件”,轉(zhuǎn)到“插件模板”頁(yè)簽封恰,單擊“查 看”麻养,您可以查看各個(gè)模板的內(nèi)容。 ? 若您的業(yè)務(wù)和模板中類似俭驮,可使用模板再根據(jù)實(shí)際來(lái)修改回溺。 ? 若您不需要使用模板,則可自己新建插件混萝。下面以新建插件來(lái)說(shuō)明如何開(kāi)發(fā)編解碼插件。使用模 板的類似修改即可萍恕。
-
新建插件
Step 1 單擊上圖右上角的“新建插件”逸嘀,進(jìn)入設(shè)計(jì)插件頁(yè)面,選擇前面做的 Profile
說(shuō)明:您可以單擊右上角的“新手指導(dǎo)”,查看插件的實(shí)現(xiàn)原理允粤。
報(bào))司光。
Step 2 新增數(shù)據(jù)上報(bào)消息崭倘。單擊“新增消息”,輸入消息的名稱类垫、描述和消息類型(這里選數(shù)據(jù)上
Step 3 添加字段。單擊“添加字段”悉患,添加上報(bào)數(shù)據(jù)的字段残家。
Step 4 新增命令下發(fā)消息。單擊“新增消息”售躁,輸入消息的名稱(這里以 Control 為例)坞淮、描述和 消息類型(這里選命令下發(fā))茴晋。
Step 5 添加字段。單擊“添加字段”回窘,添加命令下發(fā)的字段诺擅。 名字:本例以 Switch 例。 數(shù)據(jù)類型:本例為 string 例啡直。 長(zhǎng)度:本例均以長(zhǎng)度為 3 為例烁涌。 默認(rèn)值:該字段在碼流中的參考值。 偏移值:當(dāng)前字段到本條消息碼流起始位置的字節(jié)數(shù)酒觅,比如設(shè)置為 2-3撮执,則這個(gè)字段在碼流中的第 23 位。這個(gè)為插件設(shè)置自動(dòng)分配的
Step 5 建立 profile 屬性阐滩、命令與消息的映射關(guān)系二打。根據(jù)自己定義的 profile,來(lái)設(shè)計(jì)插件中的消 息掂榔。通過(guò)拖拉服務(wù)中的屬性或命令继效,與消息中的字段進(jìn)行關(guān)聯(lián)。屬性對(duì)應(yīng)于數(shù)據(jù)上報(bào)中的字段列表装获。 有多個(gè)服務(wù)就新增多個(gè)消息瑞信。為便于理解,字段名稱建議和屬性名設(shè)置為相同穴豫。
Step 6 完成映射關(guān)系后凡简,單擊頁(yè)面右上角的“部署”,部署成功后精肃,系統(tǒng)會(huì)將您的設(shè)計(jì)結(jié)果自動(dòng)生成編解碼插件包秤涩。
相關(guān)信息
IoT 平臺(tái)提供了設(shè)備模擬器,可以模擬真實(shí)設(shè)備發(fā)上來(lái)的消息碼流司抱,檢查插件包+profile 文件是否開(kāi)發(fā)正確筐眷。
Step 1 注冊(cè)模擬設(shè)備
應(yīng)用新增設(shè)備
開(kāi)發(fā)部署成功后,您可以將您的設(shè)備接入到 IoT 平臺(tái)习柠。
Step 1 登錄開(kāi)發(fā)者 Portal匀谣,單擊“我的設(shè)備”,進(jìn)入設(shè)備列表頁(yè)面资溃。單擊右上角的“注冊(cè)設(shè)備”武翎,轉(zhuǎn)向注冊(cè)設(shè)備頁(yè)面,選擇您需要注冊(cè)設(shè)備的 Profile溶锭。
Step 2 單擊 Profile宝恶,進(jìn)入 Profile 詳情頁(yè)面,在頁(yè)面底部填寫設(shè)備名稱和設(shè)備標(biāo)識(shí)碼,這里的設(shè)備名稱可以自己取卑惜,設(shè)備標(biāo)識(shí)碼為模塊上的 IMEI 號(hào)或者通過(guò) AT+CGSN=1 獲取膏执,單擊“注冊(cè)”,完成設(shè)備的 注冊(cè)露久。
南向設(shè)備開(kāi)發(fā)接入
前置條件
下載基于 LiteOS 的源碼: github.com/iot-club/EVB_M1_LiteOS
相關(guān)信息
設(shè)備接入方式:CoAP 非加密方式
AT 命令使用流程:
模組上電
設(shè)置CDP服務(wù)器地址 AT+NCDP=<ip_addr>[,<port>]
發(fā)送數(shù)據(jù) AT+NMGS=<length>,<data>
檢查是否 入網(wǎng)成功 AT+CGATT?
軟件重啟模組 AT+NRB
YES
NO
返回值等于1
300s后更米,AT+CGATT? 查詢返回值不等于1
相關(guān) API 調(diào)用流程:
初始化內(nèi)核 LOS_KernelInit();
創(chuàng)建傳感器數(shù)據(jù)采集任務(wù) creat_data_collection_task();
創(chuàng)建NB-IoT數(shù)據(jù)上報(bào)任務(wù) creat_data_report_task();
初始化模組 los_nb_init
注冊(cè)下發(fā)命令回調(diào)函數(shù) los_nb_notify
發(fā)送CoAP消息數(shù)據(jù) los_nb_report
采集光照強(qiáng)度數(shù)據(jù) Convert_BH1750
初始化硬件 HardWare_Init();
應(yīng)用開(kāi)發(fā)
串口助手 AT 命令對(duì)接平臺(tái)
這部分內(nèi)容是通過(guò)電腦串口調(diào)試軟件,手動(dòng)發(fā) AT 指令毫痕,直接發(fā)給 NB-IoT 模塊征峦。NB 模塊返回的信息, 直接到電腦串口調(diào)試軟件消请。一步一步動(dòng)手操作栏笆,實(shí)現(xiàn)連接 OceanConnect 平臺(tái)。采用的通訊協(xié)議是CoAP 協(xié)議臊泰。 Step 1 配置對(duì)接平臺(tái)地址
指令:AT+NCDP=<ip_addr>[,<port>] <ip_addr>:填寫平臺(tái)設(shè)備接入地址 <port>:填寫接入方式的端口號(hào)
例:AT+NCDP= 139.159.140.34,5683
Step 2 軟件重啟模組
指令:AT+NRB //配置完配置對(duì)接平臺(tái)地址后需要重啟模塊才能生效
REBOOTING
Step 3 檢查是否入網(wǎng)成功
指令:AT+CGATT?
+CGATT:1 //返回 1 表示入網(wǎng)成功蛉加,返回 0 入網(wǎng)失敗,300s 后依然為 0缸逃,則重啟模組
OK
Step 4 發(fā)送數(shù)據(jù)
指令:AT+NMGS=<length>,<data>
<length>:數(shù)據(jù)長(zhǎng)度 <data>:數(shù)據(jù)(十六進(jìn)制格式)
結(jié)果示例
LiteOS API 方式接入
這部分的通過(guò)單片機(jī)搭載華為 LiteOS 操作系統(tǒng)针饥,并移植了可兼容所有 AT 指令型的 AT 框架程序,調(diào)用 AT 框架的 API 接口實(shí)現(xiàn)快速連接華為 OceanConnect 平臺(tái)需频。并能實(shí)時(shí)接收平臺(tái)下發(fā)的命令丁眼,實(shí)現(xiàn)對(duì)設(shè)備的控 制,以下講解調(diào)用 API 實(shí)現(xiàn)的方式昭殉。
Step 1 分析主程序
int main(void)
{ UINT32 uwRet = LOS_OK;
HardWare_Init();
uwRet = LOS_KernelInit();
if (uwRet != LOS_OK)
{ return LOS_NOK; }
uwRet = creat_data_collection_task();
if (uwRet != LOS_OK)
{ return LOS_NOK; }
uwRet = creat_data_report_task();
if (uwRet != LOS_OK)
{ return LOS_NOK; }
LOS_Start(); }
主程序主要包括初始化硬件外設(shè)苞七、初始化內(nèi)核、創(chuàng)建傳感器數(shù)據(jù)采集任務(wù)挪丢、創(chuàng)建數(shù)據(jù)上報(bào)任務(wù)蹂风,接下來(lái)講
詳細(xì)講解主要部分的實(shí)現(xiàn)方式。
Step 2 初始化硬件
VOID HardWare_Init(VOID) { HAL_Init();
/* Configure the system clock /
SystemClock_Config();
/ Initialize all configured peripherals */
dwt_delay_init(SystemCoreClock);
MX_GPIO_Init();
MX_USART1_UART_Init();
printf("Welcome to IoT-Club, This is EVB-M1 Board.\r\n"); }
首先調(diào)用 HAL_Init() 初始化 HAL 庫(kù)乾蓬;SystemClock_Config()硫眨,用于系統(tǒng)時(shí)鐘的配置;再調(diào)用 MX_GPIO_Init() 初始化相應(yīng)的 GPIO巢块;最后初始化單片機(jī) debug 串口。
Step 3 創(chuàng)建傳感器采集任務(wù)
VOID data_collection_task(VOID)
{ UINT32 uwRet = LOS_OK;
short int Lux;
Init_BH1750();
while (1)
{
printf("This is data_collection_task !\r\n"); Lux=(int)Convert_BH1750();
printf("\r\n******************************BH1750 Value is %d\r\n",Lux);
sprintf(BH1750_send.Lux, "%5d", Lux);
uwRet=LOS_TaskDelay(1000);
if(uwRet !=LOS_OK) return; } }
這部分為傳感器數(shù)據(jù)采集部分巧号,首先是通過(guò) Init_BH1750() 函數(shù)初始化光照傳感器 BH1750 所對(duì)應(yīng)的單片機(jī) 管腳及傳感器族奢。
void Init_BH1750(void) { I2C_InitGPIO();
Cmd_Write_BH1750(0x01); }
通過(guò) Convert_BH1750() 函數(shù)采集傳感器數(shù)據(jù)
float Convert_BH1750(void)
{ Start_BH1750();
LOS_TaskDelay(180);
Read_BH1750();
result=BUF[0];
result=(result<<8)+BUF[1];
result_lx=(float)(result/1.2);
return result_lx; }
最后將傳感器數(shù)據(jù)以字符串的形式存入到數(shù)組中,用于發(fā)送到平臺(tái)上丹鸿。
sprintf(BH1750_send.Lux, "%5d", Lux);
Step 3 創(chuàng)建數(shù)據(jù)上報(bào)任務(wù)
VOID data_report_task(VOID)
{ UINT32 uwRet = LOS_OK;
define AT_DTLS 0
if AT_DTLS
sec_param_s sec;
sec.pskid = "868744031131026";
sec.psk = "d1e1be0c05ac5b8c78ce196412f0cdb0";
endif
printf("\r\nSTEP1: Init NB Module( NB Init )");
if AT_DTLS
los_nb_init((const int8_t)"180.101.147.115",(const int8_t)"5684",&sec); #else
los_nb_init((const int8_t)"180.101.147.115",(const int8_t)"5683",NULL);
los_nb_notify("+NNMI:",strlen("+NNMI:"),nb_cmd_data_ioctl,OC_cmd_match); LOS_TaskDelay(3000);
printf("\r\nSTEP3: Report Data to Server( NB Report )");
while(1) {
if(los_nb_report((const char*)(&BH1750_send),sizeof(BH1750_send))>=0) printf("ocean_send_data OK!\n");
else { printf("ocean_send_data Fail!\n"); }
uwRet=LOS_TaskDelay(1000); if(uwRet !=LOS_OK) return; } }
這部分程序主要包括連接平臺(tái)越走、注冊(cè)下發(fā)命令的回調(diào)函數(shù)以及上報(bào)數(shù)據(jù)到平臺(tái),以下將講解如何實(shí)現(xiàn)這三 部分。 1) 連接平臺(tái) 連接平臺(tái)的方式分為加密和非加密兩種廊敌,通過(guò)#define AT_DTLS 來(lái)實(shí)現(xiàn)連接方式的選擇铜跑,定義為 0 時(shí)為非 加密,此教程以非加密為例講解骡澈,實(shí)現(xiàn)程序如下
define AT_DTLS 0 #if AT_DTLS
sec_param_s sec; sec.pskid = "868744031131026";
sec.psk = "d1e1be0c05ac5b8c78ce196412f0cdb0";
endif printf printf("\r\nSTEP1: Init NB Module( NB Init )");
if AT_DTLS los_nb_init((const int8_t)"139.159.140.34",(const int8_t)"5684",&sec);
else los_nb_init((const int8_t)"139.159.140.34",(const int8_t)"5683",NULL);
此部分通調(diào)用 los_nb_init 函數(shù)初始化模組锅纺,等待連接網(wǎng)絡(luò),設(shè)置平臺(tái)對(duì)接地址實(shí)現(xiàn)對(duì)接平臺(tái)肋殴。三個(gè)參數(shù)分 別為設(shè)備對(duì)接 IP囤锉、設(shè)備對(duì)接端口以及加密的 PSK 碼。
int los_nb_init(const int8_t* host, const int8_t* port, sec_param_s* psk) { int ret; int timecnt = 0; //if(port == NULL) //return -1; at.init();
nb_reboot(); LOS_TaskDelay(2000); if(psk != NULL)//encryption v1.9
{
if(psk->setpsk) nb_send_psk(psk->pskid, psk->psk); else nb_set_no_encrypt(); }
while(1) { ret = nb_hw_detect(); printf("call nb_hw_detect,ret is %d\n",ret); if(ret == AT_OK) break; //LOS_TaskDelay(1000); } //nb_get_auto_connect(); //nb_connect(NULL, NULL, NULL);
while(timecnt < 120) { ret = nb_get_netstat(); nb_check_csq(); if(ret != AT_FAILED) { ret = nb_query_ip(); break; } //LOS_TaskDelay(1000); timecnt++; } if(ret != AT_FAILED) { nb_query_ip(); } ret = nb_set_cdpserver((char *)host, (char *)port); return ret; }
2) 注冊(cè)下發(fā)命令回調(diào)函數(shù) 注冊(cè)下發(fā)命令回調(diào)函數(shù)可實(shí)現(xiàn)對(duì)平臺(tái)下發(fā)命令的快速相應(yīng)并處理
los_nb_notify("+NNMI:",strlen("+NNMI:"),nb_cmd_data_ioctl,OC_cmd_match);
第一個(gè)參數(shù)為要匹配數(shù)據(jù)字段护锤,第二個(gè)參數(shù)為匹配字段的長(zhǎng)度官地、第三個(gè)參數(shù)為命令回調(diào)的執(zhí)行函數(shù)、第 四個(gè)為注冊(cè)字段的匹配函數(shù)烙懦。
int32_t nb_cmd_data_ioctl(void* arg, int8_t * buf, int32_t len) { int readlen = 0; char tmpbuf[1064] = {0}; if (NULL == buf || len <= 0)
{ AT_LOG("param invailed!"); return -1; } sscanf((char )buf,"\r\n+NNMI:%d,%s\r\n",&readlen,tmpbuf); memset(bc95_net_data.net_nmgr, 0, 30); if (readlen > 0) { HexStrToStr(tmpbuf, bc95_net_data.net_nmgr,readlen2); } AT_LOG("cmd is:%s\n",bc95_net_data.net_nmgr); if(strcmp(bc95_net_data.net_nmgr,"ON")==0) { HAL_GPIO_WritePin(Light_GPIO_Port,Light_Pin,GPIO_PIN_RESET); } if(strcmp(bc95_net_data.net_nmgr,"OFF")==0) { HAL_GPIO_WritePin(Light_GPIO_Port,Light_Pin,GPIO_PIN_SET); } /*******************************END**********************************************/ return 0; }
命令回調(diào)處理函數(shù)主要實(shí)現(xiàn)命令的解析以及實(shí)現(xiàn)控制相應(yīng)的設(shè)備驱入,此處以控制 LED 燈為例 int32_t OC_cmd_match(const char buf, char featurestr,int len)
{
if(strstr(buf,featurestr) != NULL) return 0; else return -1;
} 注冊(cè)字段匹配函數(shù)用于驗(yàn)證數(shù)據(jù)是否與注冊(cè)字段匹配/
3) 上報(bào)數(shù)據(jù) while(1)
{
if(los_nb_report((const char)(&BH1750_send),sizeof(BH1750_send))>=0)
printf("ocean_send_data OK!\n");
{ printf("ocean_send_data Fail!\n"); }
uwRet=LOS_TaskDelay(1000);
if(uwRet !=LOS_OK) return; } 上報(bào)數(shù)據(jù)調(diào)用的 API 為 los_nb_report 填入的參數(shù)為數(shù)據(jù)與數(shù)據(jù)長(zhǎng)度,這個(gè)函數(shù)里封裝了發(fā)送 coap 消息 的 AT 指令以及查詢發(fā)送的消息量的 AT 指令 int32_t nb_send_payload(const char buf, int len)
{ char cmd1 = "AT+NMGS="; char cmd2 = "AT+NQMGS\r"; int ret; char str = NULL; int curcnt = 0; int rbuflen; static int sndcnt = 0; if(buf == NULL || len > AT_MAX_PAYLOADLEN) { AT_LOG("payload too long"); return -1; } memset(tmpbuf, 0, AT_DATA_LEN); memset(wbuf, 0, AT_DATA_LEN); str_to_hex(buf, len, tmpbuf); memset(rbuf, 0, AT_DATA_LEN); snprintf(wbuf, AT_DATA_LEN,"%s%d,%s%c",cmd1,(int)len,tmpbuf,'\r'); ret = at.cmd((int8_t)wbuf, strlen(wbuf), "OK", NULL,NULL); if(ret < 0) return -1; ret = at.cmd((int8_t*)cmd2, strlen(cmd2), "SENT=", rbuf,&rbuflen); if(ret < 0) return -1; str = strstr(rbuf,"SENT="); if(str == NULL) return -1; sscanf(str,"SENT=%d,%s",&curcnt,wbuf); if(curcnt == sndcnt) return -1; sndcnt = curcnt; return ret; }
程序編寫完后燒錄程序并打開(kāi)串口助手可看到以下結(jié)果
結(jié)果示例
日志輸出串口波特率為 115200
應(yīng)用平臺(tái)顯示數(shù)據(jù)
命令下發(fā)
? 回到設(shè)備列表氯析,進(jìn)入下發(fā)命令界面
設(shè)置 LED 下發(fā)控制命令亏较。