knowledge_demo_smart_home/FA/DistSchedule/docs/学生党上手数字管家

学生党上手数字管家 — — 碰一碰让台灯亮起来！

——以下是学生党个人总结的方法，参考了Gitee中数字管家的Demo文档并进行二次分析和总结，同时分享出来，希望能和大家一起进步。星星之火，点亮鸿蒙！

在开始上手之前，我需要通过架构图带着大家来简单了解一下数字管家，下面为大家放上一张数字管家的结构图，帮助同学们在学习的时候有条不紊的梳理知识点和发现问题。

接下来为大家揭晓上手的关键，关键就在于软件安装、硬件烧录、NFC配置。其中密钥、签名、证书文件的申请及配置和NFC配置是2个小难点，所以在这篇学习心得分享上会着重提到我们遇到的这2个难点以及应对的办法。

大体步骤如下：

难点 · 1 · 密钥文件、签名文件、证书文件的申请及配置流程

注：图中每条路径上均为 〈目的 | 解决路径 方向〉 的排版方式，解决顺序由上往下（黄、蓝、粉）依次进行。

难点 · 2 · NFC配置流程

注：图中路径标签以及解决顺序同上。

需要具备的条件：

1、搭载HarmonyOS的华为手机，并且API版本在6以上，而且还要有NFC功能。（API的查询文档中会有详细说明）

2、小熊派Hi3861开发板以及E53_SC1智慧台灯模块。

[ 温馨提示：建议同学们先看图，看懂了接下来就好办了。]

具体步骤如下：

第一步：代码下载。

下载源：

https://gitee.com/openharmony-sig/knowledge_demo_smart_home

第二步：IDE安装。

下载源：

https://developer.harmonyos.com/cn/develop/deveco-studio

·安装后配置SDK版本为6以上即可

第三步：密钥、签名、证书文件的申请及配置

·首先在AppGallery Connect中创建项目

https://developer.huawei.com/consumer/cn/service/josp/agc/index.html

·点击确认后，添加.JSON文件，请一定记住是放在entry之下。

注：无论是重构添加还是复制添加，请一定放在entry之下。

·分别在三个文件中把bundleName中的包名修改为自己定义的包名。

1.DistSchedule/entry/src/config.json

2.DistSchedule/netconfig/src/main/config.json

3.DistSchedule/netconfig/src/main/js/default/pages/index/index.js

现在我们开始获取三个重要文件：p12、cer、p7b

·获取密钥. csr和签名.p12

·在Build（构建选项栏）中选择Generate Key and CSR选项，New创建新的密钥和签名文件。

将.p12文件放在心仪的文件位置。Password为密码，自定义即可。

·First and last name 这一项必须填写，自定义即可。

·同样将.csr放在自己心仪的文件夹下。

·现在我们的密钥. csr和签名.p12就弄好了。

~注：各种文件存放的位置一定要记住呦！

·获取手机的DUID

·来到手机端，点击版本号6下进入开发者模式，打开USB调试，并将手机和PC端连接。

·来到SDK窗口，复制文件路径。

·来到文件窗口进入toolchains文件夹，全选文件路径并输入cmd，进入命令窗口。

·输入hdc shell bm get -u，就得到了手机的UDID。

~注：UDID获取后记得保存在文本文档里呦！方便后面使用。

如需查看手机的API版本号，则输入hdc shell 再输入getprop hw_sc.build.os.apiversion就可以获取了，手机的API版本号需要6以上的才能打开数字管家APP进行测试呦！

·获取证书.cer文件（这里会用到手机的UDID和.csr文件）

·来到AGC设备管理平台，添加设备。

·之后转到证书管理平台，上传证书。

·下载出来的文件就是.cer。到此，我们的证书.cer也弄好了。

~接下来就剩.p7b文件了。

·获取证书.p7b文件（这里会用到已配置的手机和.cer文件）

·来到HAP平台。

·添加的操作很简便的，所以就不详细讲了。下载之后就可以得到.p7b文件了。

·到这一步，我们获取三个重要文件.p12、cer、p7b就完成了，接下来就是来到IDE中进行配置。

在IDE中进行配置

来到DevEco Studio（先登录），在 File （文件选项栏）> Project Structure > Project >Signing Configs

·自动配置的可以在文件夹.ohos\config中查看。（真机连接的时候才可以自动配置）

第四步：跑起来！

来到运行/调试配置窗口，选择entry并勾选上Deploy Multi Hap Packages

成功之后你将会在手机上看见数字管家的APP。

如果没有成功，请细细品味难点1中的流程图。你品，你细品！

到这一步的小伙伴一定很高兴对吧！我也为你感到高兴。但目前才完成了三分之一，不过离成功就只有简单的三分之二了，加油！

第五步：硬件烧录

·USB串口驱动，下载源：http://www.wch.cn/search?q=ch340g&t=downloads 安装好之后连接开发板，就可以在设备管理器中查看串口号，例如我的是COM3。

·之后安装HiBurn烧录软件，下载源：https://harmonyos.51cto.com/resource/29 安装完毕后，打开HiBurn

Setting->Com settings->Baud —— 波特率设置

COM —— 串口选择

Refresh —— 刷新串口

Select file —— 烧录文件选择

Connect —— 烧录连接

图中COM为串口选择，如果已连接开发板，但软件没有发现就点一下Refresh； Select file为烧录文件位置选择，这里我们选择代码路径下: knowledge_demo_smart_home\dev\docs\quick_start\resource\image\Hi3861_wifiiot_app_allinone.bin 点击Connect之后按一下开发板上的复位件RESET等待进度条跑完，就烧录好了。

第六步：最后一步NFC配置（其中FA信息配置和NFC写入内容尤为重要）

来到华为开发者联盟中的华为快服务智慧平台，创建服务模型。

创建完模型之后，进行信息配置

一、服务信息配置

二、标签配置

三、测试配置

确定之后开启调试即可。

最后一步：手机端碰一碰写入NFC信息

·需要下载应用调测助手APP，申请Product ID，将已有的智慧台灯的标签内容先写入自定义缓存区，再去碰NFC芯片。

·已有的智慧台灯的自定义数据：1246128c7b60ad1ed0286680f19206Lamp01308123456784011512teamX-Lamp01

NFC标签的自定义数据是否按照如下格式。（引用于https://gitee.com/openharmony-sig/knowledge_demo_smart_home/dev/docs/NFC_label_definition/README.md）

标签代号	意义	限制条件	样例
1	IoTDA平台设备产品ID	典型值24字节，小于32字节	6128c7b60a
2	NodeID	典型值8字节，小于64字节	Lamp01
3	DevicePwd	典型值8字节，小于32字节	12345678
4	配网标识	1字节	0：不需要配网设备（如手表平板等自带蜂窝网络的设备）； 1：NAN配网（能自动使用当前网络配网，不需要输入密码）; 2：softAp配网; 3：ble蓝牙配网;
5	ApSSID	设备自己发出的热点名，典型值12字节，小于32字节，NAN配网和softAp配网必须提供；构成一般为前缀teamX + 设备ID模式	teamX-Lamp01
6	ApToken	典型值8字节，小于16字节；WIFI配网下必须提供（可以置空）	12345678
7	BLE-MAC	典型值6字节；BLE配网下必须提供	010203040506

小知识点：NFC标签内容写入技巧（可以拿小本本记下来，有助于接下来的学习）

··当屏幕前的你完成到这一步时。 恭喜你！快去！接通开发板的电源，赶紧碰一碰点亮你的小台灯吧 ^^

图中是两个手机连接一个设备，并且都拥有控制权。感兴趣的小伙伴可以去试试！ 至于怎么弄出来的，嘻嘻，我不说，自己去探索。

个人寄语：

文档当中仍然有很多不足之处，所以我将之定义为“学生党上手数字管家1.0”，分享出来的目的是希望大家能一起将文档更新为2.0、3.0……一直到最后的END版本。我们可以将各自总结的知识点融汇在一起，一起打造一个巨大的笔记本，让这本笔记记录我们的成长，也让我们的努力变得有迹可循！

​