設備碰一碰配置指南

一、簡介

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

二、碰一碰配置

前提

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

智慧服務配置

申請Product ID

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

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

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

創(chuàng)建智慧

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

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

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

錄入服務信息

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

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

錄入服務配置信息

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

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

錄入服務測試信息

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

填寫手機號碼與描述。

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

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

設備信息的準備

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

設備信息簡介

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

存儲格式

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

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

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

V:T對應的詳細信息

標簽分配

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

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

生成配網(wǎng)信息

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

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

審核編輯 黃宇