## 智能垃圾桶

### 样例简介

智能垃圾桶可以通过数字管家应用来监测垃圾桶当前可用容量，提醒主人及时处理垃圾；通过日程管家可以实现和其他智能设备联动。

| 核心组件   | 位置                 | 功能                             |
| ---------- | -------------------- | -------------------------------- |
| 距离传感器 | 置于垃圾桶盖内侧     | 感应垃圾量                       |
| 红外传感器 | 置于垃圾桶前端       | 感应是否有人靠近                 |
| 光敏电阻   | 开发板上固定         | 感应照明情况                     |
| LED灯      | 开发板上固定         | 模拟晚上照明灯，和红外传感器联动 |
| 舵机       | 垃圾桶盖下方合适位置 | 通过转动，控制垃圾桶盖的开关     |

#### 运行效果

当设备应用启动之后，操作效果如下:

 ![运行效果](media/run.gif)

#### 样例原理

 ![原理示意图](./media/principle.png)

如上图所示，智能垃圾桶整体方案原理图可以大致分成：智能垃圾桶设备、数字管家应用、云平台三部分。智能垃圾桶通过MQTT协议连接华为IOT物联网平台，从而实现命令的接收和属性上报。 关于智能设备接入华为云IoT平台的详细细节可以参考 [连接IOT云平台指南](../iot_huawei/README.md)；智能设备同数字管家应用之间的设备模型定义可以参考[profile](../DistShedule_Profile/智能垃圾桶profile定义.md) .

#### 工程版本

+ 系统版本/API版本：OpenHarmony 1.0.1 release
+ IDE版本：DevEco Device Tool Release 3.0.0.401

### 快速上手

#### 准备硬件环境

+ BearPi-HM Nano套件一套

+ 预装HarmonyOS手机一台   

  **注：HarmonyOS是华为基于开源项目OpenHarmony开发的面向多种全场景智能设备的商用版本**

#### 准备开发环境

开发环境安装配置参照文档：[DevEco Device Tool 环境搭建](../南向IDE环境搭建/README.md)

#### 准备工程

本用例采DevEco Device Tool工具进行开发，当配置完开发环境后，我们可以在IDE上进行工程的配置下载。

- 打开DevEco Device Tool，连接远程linux服务器：[DevEco Device Tool 环境搭建](../南向IDE环境搭建/README.md)

- 点击左下角DevEco插件图标，然后点击左边框出现的主页，弹出主页界面，主页中选择新建项目，如下图：

 ![main_config](media/main_config.png)

- 配置下载工程

 ![config && download](media/config_download.png)

  如上图所示，填写对应样例工程的名称，选择对应的样例组件和样例工程存放路径后，点击创建即可进行样例工程的下载。下载界面如下：

 ![download](media/download.png)

当三个进度条都为100%即下载完成。

#### 准备工具链

- 在Projects中，点击Settings按钮，进入cleaner配置界面。

   ![进入工程配置页面](media/config_toolchain1.png)

- 在toolchain页签中，DevEco Device Tool会自动检测依赖的编译工具链是否完备，如果提示部分工具缺失，可点击SetUp按钮，自动安装所需工具链。

- 如果出现安装pip组件失败，可参考[修改Python源的方法](https://gitee.com/link?target=http%3A%2F%2Fdevice.harmonyos.com%2Fcn%2Fdocs%2Fdocumentation%2Fguide%2Fide-set-python-source-0000001227639986)进行修改，完成尝试重新安装。

   ![工具链配置界面](media/config_toolchain2.png)

- 工具链自动安装完成后如下图所示。

   ![工具链配置成功](media/config_toolchain3.png)

#### 编译

样例代码下载完成后，DevEco Device Tool会重新要求连接远程服务器，输入密码连接后会进入对应的代码编辑界面，此时点击左下角DevEco插件图标，选择PROJECT TASKS可以查看到对应的样例工程，点击build选项进行编译，并可在终端查看对应的编译结果。

 ![build ok](media/build_ok.png)

固件生成在对应工程目录的out/bearpi_hm_nano/smart_trashcan/目录下。

 ![](./media/firm.png)

#### 烧录/安装

编译完成后可以通过DevEco Device Tool进行烧录，在烧录前需要做一些烧录的配置:

##### 配置准备

在配置烧录前需要先查看DevEco Device Tool是否可以正常识别串口。

- 点击左边栏"REMOTE DEVELOPMENT"，找到 并点击” Local PC “ 选项。

- 查看 Local PC右边图标

  如若图标为![方型图标](media/zhengfang_icon.png),则代表DevEco Device Tool已连接本地，可以正常识别串口。

  如若图标为![箭头图标](media/sanjiao_icon.png),则代表DevEco Device Tool未连接本地，不能识别串口，此时需要点击该绿色图标进行连接，连接成功后图标会变为![方型图标](media/zhengfang_icon.png)。

 ![check local pc](media/check_local_pc.png)

- 点击主页，在主页选择对应工程，点击配置工程进入到配置页面

 ![config project](media/config_project.png)

##### 配置串口

配置页面选择的板级配置页面，在该页面查找到烧录选项，配置烧录选项中的upload_port和upload_protocol，upload_port选择开发板对应的串口号，upload_protocol默认选择hiburn-serial，最后点击右上角的保存按钮进行保存。

 ![config serail port](media/config_serial.png)

##### 烧录

当配置完串口以及固件后，直接点击左边栏工程管理中的upload即可，此时下方终端会出现对应烧录的信息，当终端出现BootromDownloadBoot字样，按下开发板的 “RESET” 键复位开发板即可。

 ![burn](media/burn.png)

#### 操作体验

##### 设备配网

+ 在设备上电前需准备好安装了数字管家应用的HarmonyOS手机，详情见[数字管家应用开发](../digital_housekeeper_application/README_zh.md), 并在设置中开启手机的NFC功能；

+ 写设备NFC标签，详细操作见设备[NFC标签指导文档](https://gitee.com/openharmony-sig/knowledge_demo_smart_home/blob/master/dev/docs/NFC_label_definition/README.md);

+ 烧录完成后，上电。开发者在观察开发板上状态LED灯以８Hz的频率闪烁时，将手机上半部靠近开发板NFC标签处；

+ 无需任何操作手机将自动拉起数字管家应用并进入配网状态，配网过程中无需输入热点账号密码。 具体无感配网相关流程参考 [无感配网指南](../net_config/README.md)

无感配网操作如下图所示：

 ![](./media/nan_net.gif)



### 参考资料

+ [DevEco Device Tool 环境搭建](../南向IDE环境搭建/README.md)
+ [无感配网指南](../net_config/README.md)
+ [连接华为IoT云](../iot_huawei/README.md)
+ [NFC标签指导文档](../NFC_label_definition/README.md)
+ [数字管家应用开发](../digital_housekeeper_application/README_zh.md)
+ [知识体系](https://gitee.com/openharmony-sig/knowledge)