發布時間: 2018-03-05 10:58:32
鑒權(Auth)?
Application訂閱平臺數據
?
注冊直連設備的通知
Profile簡介
開發者使用華為IoT平臺集成設備時需要準備此設備的能力描述文件,既設備的Profile文件。
設備的Profile文件是用來描述一款設備“是什么”、“能做什么”以及“如何控制該設備”的文件。該文件會被上傳到華為IoT平臺。
Profile命名規范l 對設備類型、服務類型、服務標識采用首字母大寫的命名法,
如:MultiSensor、Switch;
參數使用首字母小寫,其余單詞的首字母大寫的駝峰式命名法,
如:paraName、dataType;
命令使用所有字母大寫,單詞之間用下劃線連接的格式,
如:DISCOVERY,CHANGE_COLOR;
設備能力描述json文件,
固定命名devicetype-capability.json;
服務能力描述json文件,
固定命名servicetype-capability.json;
Profile命名規范注意點
廠商標識、型號唯一標示一個設備類型,故這兩者不能與其他類型設備同時重復。僅支持英文。
設備類型和廠商標識之間不要使用下劃線,平臺是根據下劃線從左到右依次區分設備類型、廠商標識和設備型號的。 Profile設計規范l 要注重名稱的通用性,簡潔性;對于服務能力描述,還要考慮其功能性。
如:對于多傳感器設備,就可以命名為Multi(多)Sensor(傳感器);對于某設備具有顯示電量的服務,就可以命名為Battery。
Profile文件打包結構Profile寫作完成后,需要按如下表格形式打包。
下面以附錄四中WaterMeter_Huawei_NBIoTDevice.zip為例介紹。
關于上圖有幾點說明:
① Profile文件的目錄層級結構必須如圖所示,不能增刪;
比如第二層級必須只有“profile”和“service”兩個文件夾,每個服務下面必須包含“profile”等。
② 圖中橙色的命名不能改動;
③ 整個Profile以zip形式壓縮;
④ Profile文件的命名必須按照deviceType_manufacturerId_model的格式命名,其中的deviceType、manufacturerId、model必須與devicetype-capability.json中的對應字段的定義一致,例如,本例中的devicetype-capability.json的主要字段如下:
{
"devices": [
{
"manufacturerId": "Huawei",
"manufacturerName": "Huawei",
"model": "NBIoTDevice",
"protocolType": "CoAP",
"deviceType": "WaterMeter",
"serviceTypeCapabilities": ****
}
]
}
⑤ 圖中的Brightness、Electricity、Temperature都是devicetype-capability.json中定義的服務。
⑥ Profile文件中的文檔格式都是json,在編輯完成后可以在互聯網上查找一些格式校驗網站,檢查json的合法性。?