# 智能油烟机简介
### 一. 概述
本Demo是基于Hi3516开发板，使用开源OpenHarmony开发的应用。本应用主要功能有：
1）可以搜索本地指定目录的图片和视频文件，并可进行点击播放。
2）可以通过wifi接收来自手机的美食图片以及菜谱视频，让我们对美食可以边学边做（需要手机端应用配合）。
3）可以查实时看门外监控(当有人按门铃时方便查看)以及客厅或卧室的情况(在厨房时方便实时注意孩子的动向)。
#### 1. 应用运行效果图：
#### 2. 设备与手机间交互示意图
如上图所示，手机可以将图片或者视频发到设备测，设备可以播放接受到的图片和视频。
### 二. 快速上手
#### 1. 开发环境准备
##### 硬件准备
1）预装windows系统的PC机
2）Hi3516DV300 IoT Camera开发板
3）USB转串口线、网线（Windows工作台通过USB转串口线、网线与Hi3516DV300 开发板连接）
其中Hi3516开发板介绍参照文档：[Hi3516开发板介绍](https://gitee.com/openharmony/docs/blob/OpenHarmony_1.0.1_release/zh-cn/device-dev/quick-start/Hi3516%E5%BC%80%E5%8F%91%E6%9D%BF%E4%BB%8B%E7%BB%8D.md)
##### Linux编译服务器基础环境准备
开发基础环境由windows 工作台和Linux 编译服务器组成。windows 工作台可以通过samba 服务或ssh 方式访问Linux编译服务器。其中windows 工作台用来烧录和代码编辑，Linux编译服务器用来编译OpenHarmony代码，为了简化步骤，Linux编译服务器推荐安装Ubuntu20.04。
###### 安装和配置Python
1) 打开Linux终端。
2) 输入如下命令，查看python版本号，需要使用python3.7以上版本,否则参考 [系统基础环境搭建](https://gitee.com/openharmony/docs/blob/OpenHarmony_1.0.1_release/zh-cn/device-dev/quick-start/搭建系统基础环境.md)。
```
python3 --version
```
3) 安装并升级Python包管理工具（pip3）。
```
sudo apt-get install python3-setuptools python3-pip -y
sudo pip3 install --upgrade pip
```
###### 安装LLVM
1. [下载LLVM工具](https://gitee.com/link?target=https%3A%2F%2Frepo.huaweicloud.com%2Fharmonyos%2Fcompiler%2Fclang%2F9.0.0-36191%2Flinux%2Fllvm-linux-9.0.0-36191.tar)。
2. 解压LLVM安装包至~/llvm路径下。
```
tar -zxvf llvm.tar -C ~/
```
3. 设置环境变量。
```
vim ~/.bashrc
```
将以下命令拷贝到.bashrc文件的最后一行，保存并退出。
```
export PATH=~/llvm/bin:$PATH
```
4. 使环境变量生效。
```
source ~/.bashrc
```
###### 安装hb
1. 运行如下命令安装hb。
```
python3 -m pip install --user ohos-build
```
2. 设置环境变量。
```
vim ~/.bashrc
```
将以下命令拷贝到.bashrc文件的最后一行，保存并退出。
```
export PATH=~/.local/bin:$PATH
```
执行如下命令更新环境变量。
```
source ~/.bashrc
```
3. 执行"hb -h"，有打印以下信息即表示安装成功。
```
usage: hb
OHOS build system
positional arguments:
{build,set,env,clean}
build Build source code
set OHOS build settings
env Show OHOS build env
clean Clean output
optional arguments:
-h, --help show this help message and exit
```
##### Hi3516开发环境准备
###### 将Linux shell改为bash
查看shell是否为bash，在终端运行如下命令
```
ls -l /bin/sh
```
如果显示为“/bin/sh -> bash”则为正常，否则请按以下方式修改：
```
sudo rm -rf /bin/sh
sudo ln -s /bin/bash /bin/sh
```
###### 安装编译依赖基础软件（仅Ubuntu 20+需要）
```
sudo apt-get install build-essential && sudo apt-get install gcc && sudo apt-get install g++ && sudo apt-get install make && sudo apt-get install zlib* && sudo apt-get install libffi-dev
```
###### 安装文件打包工具
1. 打开Linux编译服务器终端。
2. 运行如下命令，安装dosfstools。
```
sudo apt-get install dosfstools
```
3. 运行如下命令，安装mtools。
```
sudo apt-get install mtools
```
4. 运行如下命令，安装mtd-utils。
```
sudo apt-get install mtd-utils
```
###### 安装hc-gen
1. 打开Linux编译服务器终端。
2. 下载hc-gen工具。点击[下载地址](https://repo.huaweicloud.com/harmonyos/compiler/hc-gen/0.65/linux/hc-gen-0.65-linux.tar)下载。
3. 解压hc-gen安装包到Linux服务器~/hc-gen路径下。
```
tar -xvf hc-gen-0.65-linux.tar -C ~/
```
4. 设置环境变量。
```
vim ~/.bashrc
```
将以下命令拷贝到.bashrc文件的最后一行，保存并退出。
```
export PATH=~/hc-gen:$PATH
```
5. 使环境变量生效。
```
source ~/.bashrc
```
###### 安装Java 虚拟机环境
1. 打开Linux编译服务器终端。
2. 安装Java运行时环境（JRE）。
```
sudo apt-get install default-jre
```
3. 安装Java sdk开发工具包。
```
sudo apt-get install default-jdk
```
PS:
java虚拟机是应用签名打包时才会用到的，SDK中默认的3个系统应用是需要签名打包，所以需要安装java虚拟机，没有安装的话，应用签名打包时会报如下错误：
如果不涉及到应用的签名打包，可以不用安装此环境。
##### 源码下载&&编译准备
环境搭完后，就该准备代码了。
OpenHarmony源码下载方法多种多样，本文重点介绍linux + repo方式下载。
###### 下载repo
```
#curl https://gitee.com/oschina/repo/raw/fork_flow/repo-py3 > /usr/local/bin/repo
#chmod a+x /usr/local/bin/repo
#pip3 install -i https://pypi.tuna.tsinghua.edu.cn/simple requests
```
###### 下载OpenHarmony源码
```
#特别注意：请下载OpenHarmony 1.0.1 版本，后续会更新支持OpenHarmony其他版本
#repo init -u git@gitee.com:openharmony/manifest.git -b OpenHarmony_1.0.1_release --no-repo-verify
#repo sync -c
#repo forall -c 'git lfs pull'
```
###### 下载智能油烟机代码
具体仓库地址: [knowledge_demo_smart_home](../../team_x/smart_hoods)
通过git命令下载(方便后期代码上传管理，建议先将仓库fork到自己账号目录，然后再下载)：
```
git clone git@gitee.com:xxxxxxx/knowledge_demo_smart_home.git
其中xxxxxxx为fork后相关账号名字。
```
###### 代码拷贝
a. 在OpenHarmony的vendor目录下新建一个team_x的目录：
```
mkdir vendor/team_x
```
b. 将下载的智能油烟机代码的代码拷贝到新建的team_x下面：
```
cp -rf ../knowledge_demo_smart_home/dev/team_x/smart_hoods/ vendor/team_x/
```
到此，代码就准备完成，可以进行编译了。
#### 2. 代码编译
##### 代码目录结构
在编译代码前，可以先了解一下代码目录结构：
```
|—— BUILD.gn // 编译脚本
|—— res // 资源文件
|—— config.json // 安装包所需要的json文件
|—— include
| |—— hoods_ability.h // 入口类的头文件
| |—— hoods_ability_slice.h // 主页面的头文件
| |—— camera_ability_slice.h // 相机页面类定义的头文件
| |—— filelist_ability_slice.h // 文件列表页面类的头文件
| |—— picture_ability_slice.h // 图片显示页面类的头文件
| |—— player_ability_slice.h // 视频播放页面类的头文件
| |—— screensaver_ability_slice.h // 屏保页面类的头文件
| |—— camera_manager.h // 相机功能封装类的头文件
| |—— define.h // 部分公共宏定义的头文件
| |—— event_listener.h // 监听事件类的头文件
| |—— file_server.h // 文件传输服务的头文件
| |—— gallery_config.h // 图片和视频播放相关宏定义的头文件
| |—— list_view.h // 自定义列表类的头文件
| |—— popup_dialog.h // 弹出窗口类的头文件
| |—— ui_config.h // UI相关宏定义
| |__ week_date.h // 获取星期字串类的头文件
|
|__ src
|—— hoods_ability.cpp
|—— hoods_ability_slice.cpp // 油烟机主页面相关实现
|—— camera_ability_slice.cpp // 相机页面相关实现
|—— filelist_ability_slice.cpp // 文件列表页面相关实现
|—— picture_ability_slice.cpp // 图片播放页面相关实现
|—— player_ability_slice.cpp // 视频播放页面相关实现
|—— screensaver_ability_slice.cpp // 油烟机屏保页面相关实现
|—— camera_manager.cpp // 相机功能封装类的实现
|—— file_server.cpp // 文件传输服务的实现
|—— list_view.cpp // 自定义列表类的实现
|__ popup_dialog.cpp // 弹出窗口类的实现
```
##### 代码编译
源码和环境准备完后，接下来就是编译，编译涉及的指令有2条，hb set和hb build -f 。
hb set -- 设置工程目录和选择对应的目标，通过键盘的上下键来选择。
hb build -f -- 开始全量编译。（hb build 为增量编译）
编译完后会生成对应整个系统固件(u-boot-hi3516dv300.bin,OHOS_Image.bin, rootfs_vfat.img, userfs_vfat.img)以及我们应用对应的so文件。
其中u-boot-hi3516dv300.bin在device/hisilicon/hispark_taurus/sdk_liteos/uboot/out/boot/：
OHOS_Image.bin, rootfs_vfat.img,以及userfs_vfat.img在out目录下：
以下表格为所有生成的固件及对应的位置：
| 生产固件及应用文件的名称 | 对应文件路径 | 文件说明 |
| ------------------------ | ---------------------------------------------------------- | ---------------------- |
| u-boot-hi3516dv300.bin | device/hisilicon/hispark_taurus/sdk_liteos/uboot/out/boot/ | 系统启动引导程序 |
| OHOS_Image.bin | out/hispark_taurus/smart_hoods/ | 系统内核固件 |
| rootfs_vfat.img | out/hispark_taurus/smart_hoods/ | 文件系统 |
| userfs_vfat.img | out/hispark_taurus/smart_hoods/ | 用户数据分区 |
| libhoods.so | out/hispark_taurus/smart_hoods/libs/usr/ | 智能油烟机应用的库文件 |
#### 3. 固件烧录
##### 烧录工具选择
固件编译完后，是需要烧录到单板的。这里我们用的是HiTool工具烧录的。(HiTool工具下载地址:[HiHope官网](http://www.hihope.org/download/download.aspx?mtt=33))
##### 烧录步骤
打开HiTool工具，如下图：
烧写步骤按照图中标注即可。点击烧入后，烧录工具会提示重新上电，此时重启单板即可。
##### 烧录结果
烧录成功后，会弹出如下提示，单板也会自行启动。
烧录失败的话需要根据失败提示查找一下原因。一般情况需要检查一下串口是否连接正常，网线是否正确插入，IP是否选择正常等。
查看IP的方法：当单板上电后并正确插入网线后，点击工具上刷新按钮，此时单板IP会自动添加到服务器IP列表中。
##### IDE烧录
另外，OpenHarmony官网有提供一种通过IDE来烧录的，具体烧录步骤请参考文档：[3516上快速运行Hello OHOS](https://gitee.com/openharmony/docs/blob/master/zh-cn/device-dev/quick-start/quickstart-lite-steps-hi3516-running.md)。
##### 特别说明
如果是第一次烧录程序的话，单板在启动的时候需要设置bootargs，否则不能正常启动。单板第一次启动会停在hisilicon界面：
我们需要输入以下指令：
```
setenv bootcmd "mmc read 0x0 0x80000000 0x800 0x4800; go 0x80000000";
setenv bootargs "console=ttyAMA0,115200n8 root=emmc fstype=vfat rootaddr=10M rootsize=20M rw";
saveenv
reset
```
到此，烧录已经完成，设备也正常启动。
#### 4. 应用安装
##### 打包应用
本demo是以安装包的形式安装到系统中启动运行的。因此，在安装应用前，需要将应用打包成安装包。
将编译好的libhoods.so文件与工程目录下的res以及config.json文件通过压缩打包成zip格式(三个文件直接压缩，不能压缩文件夹)，并将后缀名改为hap(hood.hap)。
##### 挂载NFS
应用打包后，我们是通过NFS方式将单板挂载到本地，通过相关的指令来安装的，NFS挂载方法参照社区文章：[Hi3516通过NFS挂载方式与Windows共享文件](https://harmonyos.51cto.com/posts/3078)。
##### 安装
通过nfs是单板连接到本地电脑后，我们可以通过bm安装指令进行安装。bm 安装工具在系统编译完后会自动生成，路径在:
```
out/hispark_taurus/smart_hoods/dev_tools/bin/
```
由于bm默认安装的应用为已经签名的应用，所以我们在安装前需要先将签名去掉。
```
bm set -s disable // 去签名
bm install -p filename // 安装应用filename， filename需要指定路径
```
安装完后桌面会显示对应应用的ICON，直接点击ICON即可以启动油烟机的应用。
#### 5. 使用指南
1. 由于本demo涉及到摄像头的读写，故申请了相关的权限。在使用本demo前需要在setting中打开对应的权限。具体操作：
点击 setting-->应用-->Hoods，然后将所有应用打开。
2. 本demo最主要的功能是可以接收手机端发送的图片和视频，所以设备必须和手机在同一局域网内。网络配置可以通过setting应用来进行。
点击setting-->WiFi,然后选择对应的ssid，弹出密码输入框，输完密码后点击回车即可连接网络。
3. demo可以扫描规定目录下的图片与视频，用户只需将需要播放的图片放在sdcard的image目录下(暂只支持jpg图片格式)，视频文件放在sdcard的video目录下(暂只支持mp4视频格式)，然后将sdcard插入到开发板，重新上电开机并运行本demo，本demo可以自动将这些文件扫描并显示出来，用户可以通过文件列表点播文件。
3. demo中的视频和图片可以通过手机发送过来的，这个时候需要手机端应用配合，通过简易的RTP协议进行文件传输，具体传输协议可参照[代码](../../team_x/smart_hoods/demo_hoods/src/file_server.cpp)中相关定义。
3. demo中的监控1和2分别对应门铃以及客厅的摄像头，该功能待完善，目前监控1对应的是设备本身的demo，监控2暂未实现。