設備碰一碰配置指南

一、簡介

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

二、碰一碰配置

前提

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

智慧服務配置

申請Product ID

注：本節中Product ID是碰一碰拉起標識，而非IoTDA平臺的設備產品ID。

登陸[華為開發者聯盟]

登陸華為開發者聯盟，主頁右上角管理中心按鈕，進入管理中心。

創建智慧

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

點擊右上角創建服務按鈕。

選擇HarmonyOS測試服務，填寫服務相關信息，點擊創建按鈕完成服務模型的創建。

錄入服務信息

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

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

錄入服務配置信息

點擊配置欄，進行配置信息的填寫。 HarmonyOS標簽頁面如下圖，其中產品型號填寫在應用調測助手中申請的Product ID ，產品子型號填寫00。

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

錄入服務測試信息

點擊測試欄，進入智慧服務測試頁面，進行測試相關信息的填寫。 點擊創建進入創建真機測試名單窗口。

填寫手機號碼與描述。

點擊確定可以看到該手機已經錄入名單中。

到此，應用功能喚起信息申請和配置完成。

設備信息的準備

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

設備信息簡介

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

存儲格式

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

T:標簽，1字節

L:T信息長度，2字節

V:T對應的詳細信息

標簽分配

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

根據以上規則可編寫TLV數據如下：

生成配網信息

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

三、NFC數據寫入

審核編輯 黃宇