# 搭建环境 - [环境要求](#section466851916410) - [硬件要求](#section07318322310) - [软件系统要求](#section182305581332) - [Linux构建工具要求](#section20374218687) - [Windows开发工具要求](#section11161833102716) - [安装编译基础环境](#section497484245614) - [连接Linux服务器](#section15541530155711) - [将Linux shell改为bash](#section182814544221) - [安装Python环境](#section126831816258) - [安装Scons](#section2462246562) - [安装编译工具环境](#section7227629152013) - [安装gn](#section2024354014506) - [安装ninja](#section182441140185010) - [安装gcc\_riscv32(WLAN模组类编译工具链)](#section2014123416523) - [安装IDE开发工具](#section1995840162515) ## 环境要求 ## 硬件要求 - Linux服务器 - Windows工作台(主机电脑) - Hi3861 WLAN模组 - USB Type-C线(Windows工作台通过USB与Hi3861 WLAN模组连接) 各硬件连接关系如下图所示。 **图 1** 硬件连线图 ![](figures/硬件连线图.png "硬件连线图") ## 软件系统要求 **表 1** Hi3861 WLAN模組开发平台要求

硬件

软件

描述

备注

Linux编译服务器

操作系统

Ubuntu16.04及以上64位系统版本,Shell使用bash

开发人员可以在Windows工作台中进行程序开发,或者远程登录到Linux服务器进行程序开发。

Windows工作台

操作系统

Windows XP/Windows7/Windows10

## Linux构建工具要求 Linux服务器通用环境配置需要的工具及其获取途径如下表所示。 **表 2** Linux服务器开发工具及获取途径

开发工具

用途

获取途径

交叉编译器gcc_riscv32

交叉编译工具

https://repo.huaweicloud.com/harmonyos/compiler/gcc_riscv32/7.3.0/linux/gcc_riscv32-linux-7.3.0.tar.gz

Python3.7+

编译构建工具

https://www.python.org/ftp/python/3.8.5/Python-3.8.5.tgz

SCons3.0.4+

编译构建工具

通过互联网获取

bash

命令处理器

通过互联网获取

build-essential

编译依赖的基础软件包

通过互联网获取

gn

产生ninja编译脚本

https://repo.huaweicloud.com/harmonyos/compiler/gn/1523/linux/gn.1523.tar

ninja

执行ninja编译脚本

https://repo.huaweicloud.com/harmonyos/compiler/ninja/1.9.0/linux/ninja.1.9.0.tar

## Windows开发工具要求 **表 3** Windows工作台开发工具及获取途径

开发工具

用途

获取途径

Visual Studio Code

代码编辑工具。

https://code.visualstudio.com/

HUAWEI DevEco Device Tool

IDE开发工具,支持WLAN模组的代码编写、远程编译、版本烧录、串口调试等功能。

说明:

HUAWEI DevEco Device Tool是OpenHarmony面向智能设备开发者提供的一站式集成开发环境,支持OpenHarmony的组件按需定制,支持C/C++语言,以插件的形式部署在Visual Studio Code上。

https://device.harmonyos.com/cn/ide

PuTTY或其他超级终端(选其一)

远程连接Linux编译服务器,连接模组串口工具。

通过互联网获取(如:https://www.putty.org/

CH341SER.EXE

USB转串口驱动。

http://www.wch.cn/search?q=ch340g&t=downloads

## 安装编译基础环境 ## 连接Linux服务器 使用Windows远程登录Linux,以PUTTY工具为例: 1. 打开[PuTTY工具](https://www.putty.org/),输入Linux服务器IP地址,后点击“open”,打开连接。 **图 2** PuTTY界面示例图 ![](figures/PuTTY界面示例图.png "PuTTY界面示例图") 2. 弹框告警选择“是\(Y\)”。 3. 弹出界面中输入帐号并按回车键,继续输入密码并回车键。 **图 3** 登录界面图 ![](figures/登录界面图.png "登录界面图") 4. 登录成功。 **图 4** 登录成功界面 ![](figures/登录成功界面.png "登录成功界面") ## 将Linux shell改为bash 查看shell是否为bash,在终端运行如下命令 ``` ls -l /bin/sh ``` 如果显示为“/bin/sh -\> bash”则为正常,否则请按以下方式修改: **方法一**:在终端运行如下命令,然后选择 no。 ``` sudo dpkg-reconfigure dash ``` **方法二**:先删除sh,再创建软链接。 ``` sudo rm -rf /bin/sh sudo ln -s /bin/bash /bin/sh ``` ## 安装Python环境 1. 打开Linux编译服务器终端。 2. 输入如下命令,查看python版本号,需使用python3.7以上版本。 ``` python3 --version ``` 以python3.8为例,按照以下步骤安装python。 1. 运行如下命令,查看Ubuntu版本: ``` cat /etc/issue ``` 1. 根据Ubuntu不同版本,安装python。 - 如果Ubuntu 版本为18+,运行如下命令。 ``` sudo apt-get install python3.8 ``` - 如果Ubuntu版本为16,请以下载包的方式安装python。 1. python安装环境依赖\(gcc, g++, make, zlib, libffi\)请运行如下命令: ``` 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. 获取[python3.8.5安装包](https://www.python.org/ftp/python/3.8.5/Python-3.8.5.tgz),将其放至linux服务器中,运行如下命令 : ``` tar -xvzf Python-3.8.5.tgz && cd Python-3.8.5 && sudo ./configure && sudo make && sudo make install ``` 3. 确定python安装好后,将python路径链接到"/usr/bin/python"。 输入如下命令,查看python是否正确软链接到python3 ``` python --version ``` 如果回显不是python 3.8.5,则运行如下命令,查看python3.8所在目录: ``` which python3.8 ``` 将以下命令中的 "python3.8-path" 替换为 "which python3.8" 命令执行后的回显路径 ``` cd /usr/bin && sudo rm python && sudo ln -s python3.8-path python && python --version ``` 4. 安装并升级Python包管理工具(pip3),任选如下一种方式。 - **命令行方式:** ``` sudo apt-get install python3-setuptools python3-pip -y sudo pip3 install --upgrade pip ``` - **安装包方式:** ``` curl https://bootstrap.pypa.io/get-pip.py -o get-pip.py python get-pip.py ``` 5. 运行如下命令,安装python模块setuptools。 ``` pip3 install setuptools ``` 6. 安装GUI menuconfig工具(Kconfiglib),建议安装Kconfiglib 13.2.0+版本,任选如下一种方式。 - **命令行方式:** ``` sudo pip3 install kconfiglib ``` - **安装包方式:** 1. 下载.whl文件(例如:kconfiglib-13.2.0-py2.py3-none-any.whl)。 下载路径:“[https://pypi.org/project/kconfiglib\#files](https://pypi.org/project/kconfiglib#files)” 1. 运行如下命令,安装.whl文件。 ``` sudo pip3 install kconfiglib-13.2.0-py2.py3-none-any.whl ``` 7. 安装pycryptodome,任选如下一种方式。 安装升级文件签名依赖的Python组件包,包括:pycryptodome、six、ecdsa。安装ecdsa依赖six,请先安装six,再安装ecdsa。 - **命令行方式:** ``` sudo pip3 install pycryptodome ``` - **安装包方式:** 1. 下载.whl文件(例如:pycryptodome-3.7.3-cp37-cp37m-manylinux1\_x86\_64.whl)。 下载路径:“[https://pypi.org/project/pycryptodome/\#files](https://pypi.org/project/pycryptodome/#files)”。 1. 运行如下命令,安装.whl文件。 ``` sudo pip3 install pycryptodome-3.7.3-cp37-cp37m-manylinux1_x86_64.whl ``` 8. 安装six,任选如下一种方式。 - **命令行方式:** ``` sudo pip3 install six --upgrade --ignore-installed six ``` - **安装包方式:** 1. 下载.whl文件(例如:six-1.12.0-py2.py3-none-any.whl)。 下载路径:“[https://pypi.org/project/six/\#files](https://pypi.org/project/six/#files)” 1. 运行如下命令,安装.whl文件。 ``` sudo pip3 install six-1.12.0-py2.py3-none-any.whl ``` 9. 安装ecdsa,任选如下一种方式。 - **命令行方式:** ``` sudo pip3 install ecdsa ``` - **安装包方式:** 1. 下载.whl文件(例如:ecdsa-0.14.1-py2.py3-none-any.whl)。 下载路径:“[https://pypi.org/project/ecdsa/\#files](https://pypi.org/project/ecdsa/#files)” 1. 运行如下命令,安装.whl文件。 ``` sudo pip3 install ecdsa-0.14.1-py2.py3-none-any.whl ``` ## 安装Scons 1. 打开Linux编译服务器终端。 2. 运行如下命令,安装SCons安装包。 ``` sudo apt-get install scons -y ``` 如果软件源中无法找到安装包,请按以下步骤处理: 1. 下载源码包(下载路径:“ [https://scons.org/pages/download.html](https://scons.org/pages/download.html) ”,推荐SCons版本是3.0.4+)。 2. 解压源码包到任意目录(以scons-3.1.2为例)。 ``` tar -xvf scons-3.1.2.tar.gz ``` 3. 安装源码包:进入解压目录,运行如下命令: ``` sudo python3 setup.py install ``` 3. 运行如下命令,查看是否安装成功。如果安装成功,查询结果下图所示。 ``` scons -v ``` **图 5** SCons安装成功界面 ![](figures/SCons安装成功界面.png "SCons安装成功界面") ## 安装编译工具环境 >![](public_sys-resources/icon-notice.gif) **须知:** >- 如果后续通过“HPM组件方式”或“HPM包管理器命令行工具方式”获取源码,不需要安装gn、ninja、gcc\_riscv32编译工具。 >- (推荐)如果后续通过“镜像站点方式”或“代码仓库方式”获取源码,需要安装gn、ninja、gcc\_riscv32编译工具。 > 安装gn、ninja、gcc\_riscv32编译工具时,请确保编译工具的环境变量路径唯一。 ## 安装gn 1. 打开Linux编译服务器终端。 2. [下载gn工具](https://repo.huaweicloud.com/harmonyos/compiler/gn/1523/linux/gn.1523.tar)。 3. 解压gn安装包至\~/gn路径下。 ``` tar -xvf gn.1523.tar -C ~/ ``` 4. 设置环境变量。 ``` vim ~/.bashrc ``` 将以下命令拷贝到.bashrc文件的最后一行,保存并退出。 ``` export PATH=~/gn:$PATH ``` 5. 生效环境变量。 ``` source ~/.bashrc ``` ## 安装ninja 1. 打开Linux编译服务器终端。 2. [下载ninja工具](https://repo.huaweicloud.com/harmonyos/compiler/ninja/1.9.0/linux/ninja.1.9.0.tar)。 3. 解压ninja安装包至\~/ninja路径下。 ``` tar -xvf ninja.1.9.0.tar -C ~/ ``` 4. 设置环境变量。 ``` vim ~/.bashrc ``` 将以下命令拷贝到.bashrc文件的最后一行,保存并退出。 ``` export PATH=~/ninja:$PATH ``` 5. 生效环境变量。 ``` source ~/.bashrc ``` ## 安装gcc\_riscv32(WLAN模组类编译工具链) >![](public_sys-resources/icon-notice.gif) **须知:** >Hi3861平台仅支持使用libgcc运行时库的静态链接,**不建议开发者使用libgcc运行时库的动态链接,会导致商业分发时被GPL V3污染。** 1. 打开Linux编译服务器终端。 2. [下载gcc\_riscv32工具](https://repo.huaweicloud.com/harmonyos/compiler/gcc_riscv32/7.3.0/linux/gcc_riscv32-linux-7.3.0.tar.gz)。 3. 解压gcc\_riscv32安装包至\~/gcc\_riscv32路径下。 ``` tar -xvf gcc_riscv32-linux-7.3.0.tar.gz -C ~/ ``` 4. 设置环境变量 ``` vim ~/.bashrc ``` 将以下命令拷贝到.bashrc文件的最后一行,保存并退出。 ``` export PATH=~/gcc_riscv32/bin:$PATH ``` 5. 生效环境变量。 ``` source ~/.bashrc ``` 6. Shell命令行中输入如下命令,如果能正确显示编译器版本号,表明编译器安装成功。 ``` riscv32-unknown-elf-gcc -v ``` ## 安装IDE开发工具 OpenHarmony IDE工具DevEco Device Tool集成了终端工具的能力,工具的安装步骤请参考[DevEco Device Tool环境搭建](https://device.harmonyos.com/cn/docs/ide/user-guides/install_windows-0000001050164976)、[创建新工程](https://device.harmonyos.com/cn/docs/ide/user-guides/create_project-0000001072200151)等完成。