https://harmonyos.51cto.com
1.环境搭建要求
1.1.计算机要求
- Windows版本：Windows 10，64位
- 内存：4GB以上
- 硬盘：256GB以上
1.2.工具介绍
本次软件开发环境搭建所需工具如下：
以上工具获取地址：
https://gitee.com/isoftstone-hos/Isoftstone_WIFI_IOT/tree/master/docs/tool
请下载好工具后，进行以下操作。
温馨提醒：
工具准备好的前提下，软件环境搭建预计需要 1.5小时 左右。
2.安装虚拟机VMware Workstation Pro
前提条件
- 已下载VMware-workstation-full-15.5.0-14665864.exe
操作步骤
第1步:双击VMware-workstation-full-15.5.0-14665864.exe进入安装界面。
第2步:点击“下一步”进入用户许可条款。
第3步:点击“下一步”进入自定义安装界面，并选中勾选框。
第4步:点击“更改”，修改VMware安装位置，点击“下一步”进入用户体验设置。
第5步:点击“下一步”进入添加快捷方式页面。
第6步:点击“下一步”进入开始安装界面。
第7步:点击“安装”，开始安装VMware。
第8步:等待几分钟，VMware安装完成。
第9步:点击“完成”，桌面出现VMware Workstation Pro的图标。
第10步:双击VMware Workstation Pro的图标，弹出输入许可证页面，如果有许可证号，选择我有许可证号，并输入自己的许可证号，如果无许可证号，选择试用15天，点击继续按钮。
虚拟机安装完成!
3.安装Linux系统
3.1.配置虚拟机
前提条件
- 已完成VMware Workstation Pro虚拟机安装
- 已下载ubuntu-21.04-desktop-amd64.iso
操作步骤
第1步:打开虚拟机后，界面如下:
第2步:在主页中，点击“创建新的虚拟机”。
第3步:进入安装向导，选择 “典型”方式，点击“下一步”。
第4步:点击“稍后安装操作系统(S)”，暂时不添加操作系统。
第5步:选择操作系统类型为“Linux”，下拉菜单中版本选择“Ubuntu 64位”，点击“下一步”。
第6步:设置虚拟机名称，选择虚拟机安装位置：
1)虚拟机名称，如：
① 英文名称：Ubuntu-21.04;
② 中英文名称：Ubuntu-20.04.1-鸿蒙环境;
2)位置：安装位置剩余磁盘空间大小必须大于20GB;
3)配置完成后，点击“下一步”。
第7步:设置虚拟机磁盘大小20GB或以上，选择“虚拟磁盘拆分成多个文件”，点击“下一步”。
第8步:点击“自定义硬件©…”, 配置虚拟机硬件资源。
第9步:根据个人电脑情况，进行虚拟机硬件配置：
1)内存：2GB或以上(建议值2GB);
2)处理器：处理器数量1或以上，每个处理器的内核数量1(建议设置处理器数量1，每个处理器的内核数量1);
3)网络适配器：网络连接选择NAT模式;
4)新CD/DVD(SATA)：使用ISO映像文件，点击“浏览”，选择文件ubuntu-21.04-desktop-amd64.iso;
5)配置完毕后，点击“关闭”。
第10步:配置好硬件资源后，点击“完成”。
配置虚拟机完成!
3.2.安装Ubuntu
前提条件
已完成配置虚拟机
操作步骤
第1步:点击“开启此虚拟机”，开始安装Ubuntu。
第2步:进入如下页面，按下回车键开始安装Ubuntu。
第3步:选择语言，点击“安装Ubuntu”，进入“键盘布局”界面。
第4步:选择键盘布局，点击“继续”，进入到“更新和其他软件”界面。
第5步:选择“正常安装”，根据需要选择是否需要安装更新，点击“继续”，进入到“安装类型”界面。
第6步:在“安装类型”界面中，选择“清除整个磁盘并安装Ubuntu”，点击“现在安装(I)”和“继续”，进入到“选择城市”界面。
第7步:在选择城市界面中，选择所在城市，点击“继续”进入到设置个人信息界面。
第8步:在设置个人信息界面中，设置计算机名、用户名、密码：
1)计算机名、用户名：建议使用英文，不要使用中文(如：drcess);
2)密码：使用简单的6个数字即可;
3)配置完成后，点击“继续”。
第9步:在“安装”界面中，等待安装完成;
第10步:安装完成后，点击“现在重启”，重启Ubuntu。
第11步:重启Ubuntu后，进入登录页面，输入之前设置的密码进入系统。
安装Ubuntu完成!
3.3.进入Ubuntu
前提条件
已完成Ubuntu安装
操作步骤
第1步:单击右键，在弹窗中选择“打开终端”。
第2步:进入终端，可以输入命令。
3.4.安装辅助应用
前提条件
已进入Ubuntu
计算机连接Internet
操作步骤
第1步:执行如下命令，更新镜像源。
sudo apt update
第2步:命令行中输入“ifconfig”查看虚拟机IP。如果IP查询不了(显示“ifconfig”未找到)，可以执行如下命令：
sudo apt install net-tools
第3步:再次执行如下命令：查询虚拟机IP。
ifconfig
第4步:执行如下命令，安装ssh，主要用于ssh的连接：
sudo apt-get install openssh-server
第5步:执行如下命令，安装vim，主要用于后面编辑文件：
sudo apt install vim
安装辅助应用完成!
4.搭建编译环境
前提条件
- 已完成VMware Workstation Pro虚拟机安装
- 已完成Linux系统安装
- Python版本：Python 3.9.5
- 计算机连接Internet
- 已下载gcc_riscv32-linux-7.3.0.tar.gz，并上传至Ubuntu
- 已下载llvm-linux-9.0.0-36191.tar，并上传至Ubuntu
操作目的
本章节主要是安装软件代码编译所需的工具。
操作说明
搭建编译环境按照本章节顺序依次往下执行。
4.1.编译依赖基础软件
执行以下命令进行安装编译依赖基础软件：
sudo apt-get install build-essential gcc g++ make zlib* libffi-dev
4.2.安装并升级Python包管理工具(pip3)
操作步骤
第1步:执行以下命令进行安装：
sudo apt-get install python3-setuptools python3-pip
sudo pip3 install --upgrade pip
第2步:执行如下命令查看安装版本，查询到版本表示安装成功:
==pip -V ==
第3步:查询Python版本:
python --version
4.3.安装scons
操作步骤
第1步:执行如下命令，安装scons安装包。
python3 -m pip install scons
**【注意】如果上面步骤安装后，无法查看版本scons的版本，可以再次进行安装，运行以下命令: **
== sudo apt install scons==
第2步:执行如下命令，查看是否安装成功。如果安装成功，查询结果下图所示。
scons -v
4.4.安装python模块
操作步骤
执行如下命令，安装python模块setuptools。
pip3 install setuptools
第1步:安装GUI menuconfig工具(Kconfiglib)，建议安装Kconfiglib 13.2.0+版本。
【注意】添加sudo会提示WARNING，只要提示Successfully就可以。
第2步:安装pycryptodome，安装升级文件签名依赖的Python组件包，包括：pycryptodome、six、ecdsa。安装ecdsa依赖six，请先安装six，再安装ecdsa。
sudo pip3 install pycryptodome
4.5.安装six
sudo pip3 install six --upgrade --ignore-installed six
4.6.安装ecdsa
sudo pip3 install ecdsa
4.7.安装gcc_riscv32
操作步骤
第1步:执行安装命令：
sudo apt-get install gcc && sudo apt-get install g++ && sudo apt-get install flex bison && sudo apt-get install texinfo
第2步:上传gcc_riscv32-linux-7.3.0.tar.gz到Ubuntu。
第3步:解压软件包中的gcc_riscv32 安装包。
tar -xvf gcc_riscv32-linux-7.3.0.tar.gz -C ~/
第4步:设置环境变量：
vim ~/.bashrc
第5步:将以下命令拷贝到.bashrc文件的最后一行，保存并退出。
export PATH=~/gcc_riscv32/bin:$PATH
第6步:生效环境变量
source ~/.bashrc
第7步:Shell命令行中输入如下命令，如果能正确显示编译器版本号，表明编译器安装成功。
riscv32-unknown-elf-gcc -v
4.8.安装gn
sudo apt-get install gn
4.9.安装ninja
sudo apt-get install ninja-build
4.10.安装llvm
操作步骤
第1步:解压llwm安装包至~/llvm路径下。
tar -xvf llvm-linux-9.0.0-36191.tar -C ~/
第2步:设置环境变量。
vim ~/.bashrc
第3步:将以下命令拷贝到.bashrc文件的最后一行，保存并退出。
==export PATH=~/llvm/bin:$PATH ==
第4步:生效环境变量。
source ~/.bashrc
第5步:查看llvm版本。
llvm-as --version
4.11.安装hb
操作步骤
第1步:运行如下命令安装hb
python3 -m pip install --user ohos-build
第2步:设置环境变量
vim ~/.bashrc
第3步:将以下命令拷贝到.bashrc文件的最后一行，保存并退出。
export PATH=~/.local/bin:$PATH
第4步:执行如下命令更新环境变量。
source ~/.bashrc
第5步:执行"hb -h"，有打印以下信息即表示安装成功。
5.代码拉取
前提条件
- 已完成VMware Workstation Pro虚拟机安装
- 已完成Linux系统安装
- 计算机连接Internet
操作步骤
第1步:安装git工具，用于代码下载：
sudo apt install git
第2步:查询git版本，如果返回版本，表示安装成功：
git --version
第3步:代码拉取：
git clone https://gitee.com/isoftstone-hos/Isoftstone_WIFI_IOT.git
6.代码编译
前提条件
- 已完成代码拉取
- 已完成搭建编译环境
操作步骤
第1步:代码拉取完毕进入source目录：
Isoftstone_WIFI_IOT/ source/ isoftstone_wifi_iot_board3861
第2步:运行以下命令，进行代码编译设置：
hb set
1) [OHOS INFO] Input code path:后输入“.”
2)选择isoftstone_wifiiot_hi3861v100后回车;
3)设置完成后，会在source目录下生成文件ohos_config,ison。
第3步:运行以下命令，进行代码编译：
hb build -f
第4步:等待编译成功;
第5步:编译成功之后会在目录:
“isoftstone_wifi_iot_board3861_113/out/isoftstone_wifiiot/isoftstone_wifiiot_hi3861v100”下生成烧录文件：Hi3861_wifiiot_app_allinone.bin。
代码编译完成!
7.程序下载
前提条件
- 已完成代码编译
- 已下载烧录程序Hi3861_wifiiot_app_allinone.bin
- 已下载CH341SER.EXE
- 已下载HiBurn.exe
操作步骤
第1步:点击安装包USB转串口驱动程序CH341SER.EXE，驱动安装完成后，重新插拔USB接口，串口信息显示如下图所示。
第2步:双击HiBurn.exe打开烧录页面。
第3步:设置波特率，点击Setting–Com settings。
第4步:程序烧写配置，按照下图顺序进行配置和烧录，配置操作顺序说明：
1.COM：选择串口号
2.Select file：添加烧录文件Hi3861_wifiiot_app_allinone.bin
3.Auto burn：选择自动烧录
4.点击connect连接开发板
5.按下开发板上的RST按钮开始烧录。
第5步:烧录完成后，点击Disconnect，按下RST程序开始运行。
程序下载操作完成!
8.常见问题处理
问题1：利用Python指令时提示找不到
问题现象
利用Python指令进行相关操作时，提示找不到Python，如以下指令：
python build.py wifiiot
处理方法
将Python3生成软链接添加至环境变量，操作方法如下：
ln -s /usr/bin/python3 /usr/bin/python
问题2：安装gcc_riscv32后编译时报异常
问题现象
进行代码编译过程，出现提示:No option ‘riscv32-unknown-elf-gcc_path’ in section: ‘ndk’,无法进行编译。
处理方法
1、查看环境变量：vim ~/.bashrc。
2、查看是否有：export PATH=~/gcc_riscv32/bin:$PATH;
1)如果没有：就将其加入到环境变量最后一行，然后执行一下生成环境变量：source ~/.bashrc;
2)如果有：执行一下生成环境变量：source ~/.bashrc。
https://harmonyos.51cto.com
