設(shè)備碰一碰配置指南

一、簡介

碰一碰是HarmonyOS具備的多終端業(yè)務(wù)協(xié)同技術(shù)。其依托NFC短距通信協(xié)議，通過碰一碰的交互方式，將手機和全場景設(shè)備連接起來。然后通過手機端的原子化服務(wù)能力，快速完成配網(wǎng)、遠程控制的能力，解決了應(yīng)用與設(shè)備之間接續(xù)慢、配網(wǎng)復(fù)雜、傳輸難的問題，為用戶帶來無縫切換的流暢體驗。

二、碰一碰配置

前提

• 已安裝數(shù)字管家應(yīng)用。
• 準備已經(jīng)升級至HarmonyOS 2系統(tǒng)的華為Mate系列或P系列手機，系統(tǒng)版本號為2.0.0.168及以上。
• 在華為應(yīng)用市場，下載并安裝“應(yīng)用調(diào)測助手”APP，用于寫NFC標簽。
• 若開發(fā)板不包含NFC模塊，則需準備1個NFC標簽，可以用手機觸碰NFC標簽，提前確保NFC功能可用。
• 打開手機 設(shè)置 > 應(yīng)用和服務(wù) > 應(yīng)用管理 ，搜索“智慧生活基礎(chǔ)服務(wù)”，檢測智慧生活基礎(chǔ)服務(wù)的版本是否為12.0.2.306及以上。如果不是，請打開華為手機的“智慧生活”APP，點擊“ 我的 > 設(shè)置 > 檢查應(yīng)用更新 ”，更新“智慧生活基礎(chǔ)服務(wù)”。

智慧服務(wù)配置

申請Product ID

注：本節(jié)中Product ID是碰一碰拉起標識，而非IoTDA平臺的設(shè)備產(chǎn)品ID。

登陸[華為開發(fā)者聯(lián)盟]

登陸華為開發(fā)者聯(lián)盟，主頁右上角管理中心按鈕，進入管理中心。

創(chuàng)建智慧

在管理中心頁面中依次點擊智慧服務(wù)->HarmonyOS服務(wù)開放平臺進入智慧服務(wù)平臺。

點擊右上角創(chuàng)建服務(wù)按鈕。

選擇HarmonyOS測試服務(wù)，填寫服務(wù)相關(guān)信息，點擊創(chuàng)建按鈕完成服務(wù)模型的創(chuàng)建。

錄入服務(wù)信息

在服務(wù)信息欄下的基本信息頁面完善服務(wù)模型基本信息后，點擊右上角保存按鈕，保存服務(wù)基本信息。

進入服務(wù)呈現(xiàn)信息頁面完善相關(guān)信息（星標項目必填，其它項目視需要進行填寫），可下載批量導(dǎo)入模板并填寫，進行批量導(dǎo)入。點擊右上角保存按鈕，保存服務(wù)呈現(xiàn)信息。

錄入服務(wù)配置信息

點擊配置欄，進行配置信息的填寫。 HarmonyOS標簽頁面如下圖，其中產(chǎn)品型號填寫在應(yīng)用調(diào)測助手中申請的Product ID ，產(chǎn)品子型號填寫00。

FA信息頁面填寫信息如下圖，其中App包名、服務(wù)名分別為FA開發(fā)中對應(yīng)的IoT應(yīng)用的包名，以及開發(fā)者期望通過NFC喚起的IoT應(yīng)用的服務(wù)名（本項目喚起的服務(wù)為設(shè)備配網(wǎng)）。

錄入服務(wù)測試信息

點擊測試欄，進入智慧服務(wù)測試頁面，進行測試相關(guān)信息的填寫。 點擊創(chuàng)建進入創(chuàng)建真機測試名單窗口。

填寫手機號碼與描述。

點擊確定可以看到該手機已經(jīng)錄入名單中。

到此，應(yīng)用功能喚起信息申請和配置完成。

設(shè)備信息的準備

鴻蒙開發(fā)應(yīng)用知識參考[gitee.com/li-shizhen-skin/harmony-os/blob/master/README.md]前往。

設(shè)備信息簡介

設(shè)備信息內(nèi)容包括：華為IoTDA平臺的Product ID、NodeID、配網(wǎng)方式以及對應(yīng)的參數(shù)信息，如下列表格；所有信息需要寫入到調(diào)測助手的自定義數(shù)據(jù)之中，然后通過NFC拉起應(yīng)用時，數(shù)字管家FA可通過Intent中的91字段進行讀取NFC數(shù)據(jù)，從而可獲取到板子相關(guān)的信息。

存儲格式

設(shè)備信息采用TLV格式，即數(shù)據(jù)字段使用T+L+V進行表示。

T:標簽，1字節(jié)

L:T信息長度，2字節(jié)

V:T對應(yīng)的詳細信息

標簽分配

注：DeviceID由FA讀取NFC之后，使用華為IoTDA平臺設(shè)備產(chǎn)品ID+‘’_“+"NodeID"拼接而成，如華為IoTDA平臺設(shè)備產(chǎn)品ID為6128c7b60ad1ed0286680f19，NodeID為Lamp01,則生成的設(shè)備ID為”6128c7b60ad1ed0286680f19_Lamp01“

根據(jù)以上規(guī)則可編寫TLV數(shù)據(jù)如下：

生成配網(wǎng)信息

1. 使用[NFC信息生成器]生成配網(wǎng)信息
2. 手動輸入生成： 生成實際配網(wǎng)數(shù)據(jù)虛須基于[profile設(shè)備模型] 進行編寫，如以設(shè)備id為6128c7b60ad1ed0286680f19_Lamp01（華為IoTDA平臺設(shè)備產(chǎn)品ID+‘’_“+"NodeID"）的臺燈配網(wǎng)信息如下：

三、NFC數(shù)據(jù)寫入

審核編輯 黃宇