# 智能中控屏简介 ### 一. 概述 本Demo是基于Hi3516开发板,使用开源OpenHarmony开发的应用。通过控制面板可以控制同一局域网内的空调,窗帘,灯等智能家居设备。 当前支持的配套L0设备只有[智能灯](../smart_cenctrl_lamp/README.md),如需添加新的设备,可以参考[指导文档](./add_new_dev.md)。 #### 1. 应用运行效果图: ​ 1234 #### 2. 智能中控与L0设备间交互示意图 ![20211125162945](./resource/20211125162945.png) 如上图所示,我可以通过智能中控面板操作对同一局域网内的L0设备进行对应的控制。 ### 二. 快速上手 #### 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虚拟机,没有安装的话,应用签名打包时会报如下错误: image-20211102154559940 如果不涉及到应用的签名打包,可以不用安装此环境。 ##### 源码下载&&编译准备 环境搭完后,就该准备代码了。 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_cenctrl_board) 通过git命令下载(方便后期代码上传管理,建议先将仓库fork到自己账号目录,然后再下载): ``` git clone git@gitee.com:xxxxxxx/knowledge_demo_smart_home.git 其中xxxxxxx为fork后相关账号名字。 ``` ###### 代码拷贝 a. 在OpenHarmony的vendor目录下新建一个team_x的目录: ``` mkdir vendor/team_x ``` ![image-20211027100624579](./resource/mkdir_teamx.png) b. 将下载的智能中控屏代码的代码拷贝到新建的team_x下面: ``` cp -rf ../knowledge_demo_smart_home/dev/team_x/smart_cenctrl_board/ vendor/team_x/ ``` ![image-20211027100215688](./resource/demo_src_path.png) ![image-20211027100524644](./resource/demo_des_path.png) 到此,代码就准备完成,可以进行编译了。 #### 2. 代码编译 ##### 代码目录结构 ​ 在编译代码前,可以先了解一下代码目录结构: ``` |—— BUILD.gn // 编译脚本 |—— res // 资源文件 |—— config.json // 安装包所需要的json文件 |—— include | |—— cenctrl_ability.h // 入口类的头文件 | |—— cenctrl_ability_slice.h // 中控面板主页面的头文件 | |—— camera_ability_slice.h // 相机页面类定义的头文件 | |—— camera_manager.h // 相机功能封装类的头文件 | |—— cenctrl_log.h // 调试相关接口的头文件 | |—— event_listener.h // 监听事件类的头文件 | |—— item_list_ctrl.h // item模块类的头文件 | |—— native_base.h // native基类的头文件 | |—— socket_service.h // ssocket 服务相关接口的头文件 | |—— socket_udp.h // socket UDP通讯相关接口的头文件 | |—— ui_config.h // UI相关宏定义 | |__ ui_config_camera.h // 相机UI相关宏定义的头文件 | |__ src |—— cenctrl_ability.cpp |—— cenctrl_ability_slice.cpp // 中控面板主页面相关实现 |—— camera_ability_slice.cpp // 相机页面相关实现 |—— camera_manager.cpp // 相机功能封装类的实现 |—— item_list_ctrl.cpp // item模块类的实现 |—— socket_service.c // socket 服务相关接口的实现 |__ socket_udp.c // socket UDP通讯相关接口的实现 ``` ##### 代码编译 ​ 源码和环境准备完后,接下来就是编译,编译涉及的指令有2条,hb set和hb build -f 。 ​ hb set -- 设置工程目录和选择对应的目标,通过键盘的上下键来选择。 ​ ![hb_set](./resource/hb_set.png) ​ hb build -f -- 开始全量编译。(hb build 为增量编译) ​ image-20211021094537615 ​ 编译完后会生成对应整个系统固件(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/: ![](./resource/uboot.png) OHOS_Image.bin, rootfs_vfat.img,以及userfs_vfat.img在out目录下: firmware ![image-20211021100111880](./resource/libso.png) 以下表格为所有生成的固件及对应的位置: | 生产固件及应用文件的名称 | 对应文件路径 | 文件说明 | | ------------------------ | ---------------------------------------------------------- | ------------------------ | | u-boot-hi3516dv300.bin | device/hisilicon/hispark_taurus/sdk_liteos/uboot/out/boot/ | 系统启动引导程序 | | OHOS_Image.bin | out/hispark_taurus/smart_cenctrl_board/ | 系统内核固件 | | rootfs_vfat.img | out/hispark_taurus/smart_cenctrl_board/ | 文件系统 | | userfs_vfat.img | out/hispark_taurus/smart_cenctrl_board/ | 用户数据分区 | | libcenctrl.so | out/hispark_taurus/smart_cenctrl_board/libs/usr/ | 智能中控面板应用的库文件 | #### 3. 固件烧录 ##### 烧录工具选择 ​ 固件编译完后,是需要烧录到单板的。这里我们用的是HiTool工具烧录的。(HiTool工具下载地址:[HiHope官网](http://www.hihope.org/download/download.aspx?mtt=33)) ##### 烧录步骤 ​ 打开HiTool工具,如下图: ![burn](./resource/burn.png) 烧写步骤按照图中标注即可。点击烧入后,烧录工具会提示重新上电,此时重启单板即可。 ![image-20211025145909110](./resource/image-20211025145909110.png) ##### 烧录结果 烧录成功后,会弹出如下提示,单板也会自行启动。 ![image-20211025150056806](./resource/image-20211025150056806.png) 烧录失败的话需要根据失败提示查找一下原因。一般情况需要检查一下串口是否连接正常,网线是否正确插入,IP是否选择正常等。 查看IP的方法:当单板上电后并正确插入网线后,点击工具上刷新按钮,此时单板IP会自动添加到服务器IP列表中。 ![image-20211026193320738](./resource/image-20211026193320738.png) ##### 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界面: ![image-20211025151231429](./resource/image-20211025151231429.png) 我们需要输入以下指令: ``` 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 ``` ![image-20211025151457708](./resource/image-20211025151457708.png) ​ 到此,烧录已经完成,设备也正常启动。 #### 4. 应用安装 ##### 打包应用 ​ 本demo是以安装包的形式安装到系统中启动运行的。因此,在安装应用前,需要将应用打包成安装包。 ​ 将编译好的libcenctrl.so文件与工程目录下的res以及config.json文件通过压缩打包成zip格式(三个文件直接压缩,不能压缩文件夹),并将后缀名改为hap(cenctrl.hap)。 ​ ![image-20211021100447617](./resource/hap.png) ##### 挂载NFS ​ 应用打包后,我们是通过NFS方式将单板挂载到本地,通过相关的指令来安装的,NFS挂载方法参照社区文章:[Hi3516通过NFS挂载方式与Windows共享文件](https://harmonyos.51cto.com/posts/3078)。 ​ ![image-20211021101010264](./resource/mount_nfs.png) ##### 安装 ​ 通过nfs是单板连接到本地电脑后,我们可以通过bm安装指令进行安装。bm 安装工具在系统编译完后会自动生成,路径在: ``` out/hispark_taurus/smart_cenctrl_board/dev_tools/bin/ ``` ​ ![image-20211021101228821](./resource/bm.png) ​ 由于bm默认安装的应用为已经签名的应用,所以我们在安装前需要先将签名去掉。 ``` bm set -s disable // 去签名 bm install -p filename // 安装应用filename, filename需要指定路径 ``` ​ ![image-20211021101736915](./resource/bm_install.png) ​ 安装完后桌面会显示对应应用的ICON,直接点击ICON即可以启动油烟机的应用。 ​ image-20211021102146214 #### 5. 使用指南 ![大屏6](./resource/opration.gif) 1. 由于本demo涉及到摄像头的读写,故申请了相关的权限。在使用本demo前需要在setting中打开对应的权限。具体操作: 点击 setting-->应用-->cenctrl,然后将所有应用打开。 2. 本demo最主要的功能是可以接收手机端发送的图片和视频,所以设备必须和手机在同一局域网内。网络配置可以通过setting应用来进行。 点击setting-->WiFi,然后选择对应的ssid,弹出密码输入框,输完密码后点击回车即可连接网络。 3. demo主要控制其他无屏的智能设备: a. 智能灯的开关,亮度调节等窗帘。 b. 智能空调的开关,模式,温度调节以及风速等。 c. 智能窗帘的开关等。