Hi3861搭建环境

• 环境要求

  • 软件系统要求
  • Linux构建工具要求
  • Windows开发工具要求

• 安装Linux编译环境（方法一：Docker方式）

• 安装Linux编译环境（方法二：安装包方式）

  • 连接Linux服务器
  • 将Linux shell改为bash
  • 安装Python环境
  • 安装Scons
  • 安装gn
  • 安装ninja
  • 安装gcc_riscv32（WLAN模组类编译工具链）

• 安装Windows开发环境

环境要求

软件系统要求

表 1 Hi3861 WLAN模組开发平台要求

Linux构建工具要求

Linux服务器通用环境配置需要的工具及其获取途径如下表所示。

表 2 Linux服务器开发工具及获取途径

Windows开发工具要求

表 3 Windows工作台开发工具及获取途径

安装Linux编译环境（方法一：Docker方式）

Linux编译环境可以通过Docker方式快速安装，具体请参见Docker方式获取编译环境的“搭建Docker环境”。

安装Linux编译环境（方法二：安装包方式）

须知：

• 如果后续通过“HPM组件方式”或“HPM包管理器命令行工具方式”获取源码，不需要安装gn、ninja、gcc_riscv32编译工具。
• （推荐）如果后续通过“镜像站点方式”或“代码仓库方式”获取源码，需要安装gn、ninja、gcc_riscv32编译工具。 安装gn、ninja、gcc_riscv32编译工具时，请确保编译工具的环境变量路径唯一。

连接Linux服务器

使用Windows远程登录Linux，以PUTTY工具为例：

1. 打开PuTTY工具，输入Linux服务器IP地址，后点击“open”，打开连接。

   图 1 PuTTY界面示例图
   

2. 弹框告警选择“是(Y)”。

3. 弹出界面中输入帐号并按回车键，继续输入密码并回车键。

   图 2 登录界面图
   

4. 登录成功。

   图 3 登录成功界面
   

将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.7版本，不建议直接升级，请按照如下步骤重新安装。以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安装包，将其放至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.8。

   python --version

   如果回显不是python 3.8.5，则运行如下命令，查看python3.8所在目录：

   which python3.8

   将以下命令中的 "python3.8-path" 替换为 "which python3.8" 命令执行后的回显路径

   cd /usr/bin && sudo rm python && sudo rm python3 && sudo ln -s python3.8-path python && sudo ln -s python3.8-path python3 && python3 --version && 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”

     2. 运行如下命令，安装.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.9.9-cp38-cp38-manylinux1_x86_64.whl）。

        下载路径：“https://pypi.org/project/pycryptodome/#files”。

     2. 运行如下命令，安装.whl文件。

        sudo pip3 install pycryptodome-3.9.9-cp38-cp38-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”

     2. 运行如下命令，安装.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”

     2. 运行如下命令，安装.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 ”，推荐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

   图 4 SCons安装成功界面
   

安装gn

1. 打开Linux编译服务器终端。

2. 下载gn工具。

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工具。

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模组类编译工具链）

须知： Hi3861平台仅支持使用libgcc运行时库的静态链接，不建议开发者使用libgcc运行时库的动态链接，会导致商业分发时被GPL V3污染。

1. 打开Linux编译服务器终端。

2. 环境准备，请安装"gcc, g++, bison, flex, makeinfo"软件，确保工具链能正确编译。

   sudo apt-get install gcc && sudo apt-get install g++ && sudo apt-get install flex bison && sudo apt-get install texinfo

3. 下载riscv-gnu-toolchain交叉编译工具链。

   git clone --recursive https://github.com/riscv/riscv-gnu-toolchain

4. 打开文件夹riscv-gnu-toolchain，先删除空文件夹，以防止下载newlib，binutils，gcc时冲突。

   cd riscv-gnu-toolchain && rm -rf riscv-newlib && rm -rf riscv-binutils && rm -rf riscv-gcc

5. 下载riscv-newlib-3.0.0。

   git clone -b riscv-newlib-3.0.0 https://github.com/riscv/riscv-newlib.git

6. 下载riscv-binutils-2.31.1。

   git clone -b riscv-binutils-2.31.1 https://github.com/riscv/riscv-binutils-gdb.git

7. 下载riscv-gcc-7.3.0。

   git clone -b riscv-gcc-7.3.0 https://github.com/riscv/riscv-gcc

8. 下载riscv-gcc-7.3.0补丁。

   拷贝gcc官方89411.patch，拷贝gcc官方86724.patch，并对应代码做一定的行数号修改，将两个patch放入 riscv-gcc目录

   cd riscv-gcc && patch -p1 < 89411.patch && patch -p1 < 86724.patch

   patch过程中如遇到Hunk #1 FAILED等问题，请对应到相应.c文件，修改patch代码所在行数

9. 下载GMP 6.1.2，并解压安装。

   tar -xvf mpfr-4.0.2.tar.gz && mkdir build_mpfr && cd build_mpfr && ../mpfr-4.0.2/configure --prefix=/usr/local/mpfr-4.0.2 --with-gmp=/usr/local/gmp-6.1.2 --disable-shared && make && make install

10. 下载mpfr-4.0.2 ，并解压安装。

    tar -xvf mpfr-4.0.2.tar.gz && mkdir build_mpfr && cd build_mpfr && ../mpfr-4.0.2/configure --prefix=/usr/local/mpfr-4.0.2 --with-gmp=/usr/local/gmp-6.1.2 --disable-shared && make && make install

11. 下载mpc-1.1.0 ，并解压安装。

    tar -xvf mpc-1.1.0.tar.gz && mkdir build_mpc && cd build_mpc && ../mpc-1.1.0/configure --prefix=/usr/local/mpc-1.1.0 --with-gmp=/usr/local/gmp-6.1.2 --with-mpfr=/usr/local/mpfr-4.0.2 --disable-shared && make && make install

12. 打开文件夹riscv-gnu-toolchain，新建工具链输出目录。

    cd /opt && mkdir gcc_riscv32

13. 编译bintutils。

    mkdir build_binutils && cd build_binutils && ../riscv-binutils-gdb/configure --prefix=/opt/gcc_riscv32 --target=riscv32-unknown-elf --with-arch=rv32imc --with-abi=ilp32 --disable-__cxa_atexit --disable-libgomp --disable-libmudflap --enable-libssp --disable-libstdcxx-pch --disable-nls --disable-shared --disable-threads --disable-multilib --enable-poison-system-directories --enable-languages=c,c++ --with-gnu-as --with-gnu-ld --with-newlib --with-system-zlib CFLAGS="-fstack-protector-strong -O2 -D_FORTIFY_SOURCE=2 -Wl,-z,relro,-z,now,-z,noexecstack -fPIE" CXXFLAGS="-fstack-protector-strong -O2 -D_FORTIFY_SOURCE=2 -Wl,-z,relro,-z,now,-z,noexecstack -fPIE" CXXFLAGS_FOR_TARGET="-Os -mcmodel=medlow -Wall -fstack-protector-strong -Wl,-z,relro,-z,now,-z,noexecstack -Wtrampolines -fno-short-enums -fno-short-wchar" CFLAGS_FOR_TARGET="-Os -mcmodel=medlow -Wall -fstack-protector-strong -Wl,-z,relro,-z,now,-z,noexecstack -Wtrampolines -fno-short-enums -fno-short-wchar" --bindir=/opt/gcc_riscv32/bin --libexecdir=/opt/gcc_riscv32/riscv32 --libdir=/opt/gcc_riscv32 --includedir=/opt/gcc_riscv32 && make -j16 && make install

14. 编译newlib。

    mkdir build_newlib && cd build_newlib && ../riscv-newlib/configure --prefix=/opt/gcc_riscv32 --target=riscv32-unknown-elf --with-arch=rv32imc --with-abi=ilp32 --disable-__cxa_atexit --disable-libgomp --disable-libmudflap --enable-libssp --disable-libstdcxx-pch --disable-nls --disable-shared --disable-threads --disable-multilib --enable-poison-system-directories --enable-languages=c,c++ --with-gnu-as --with-gnu-ld --with-newlib --with-system-zlib CFLAGS="-fstack-protector-strong -O2 -D_FORTIFY_SOURCE=2 -Wl,-z,relro,-z,now,-z,noexecstack -fPIE" CXXFLAGS="-fstack-protector-strong -O2 -D_FORTIFY_SOURCE=2 -Wl,-z,relro,-z,now,-z,noexecstack -fPIE" \CXXFLAGS_FOR_TARGET="-Os -mcmodel=medlow -Wall -fstack-protector-strong -Wl,-z,relro,-z,now,-z,noexecstack -Wtrampolines -fno-short-enums -fno-short-wchar" CFLAGS_FOR_TARGET="-Os -mcmodel=medlow -Wall -fstack-protector-strong -Wl,-z,relro,-z,now,-z,noexecstack -Wtrampolines -fno-short-enums -fno-short-wchar" --bindir=/opt/gcc_riscv32/bin --libexecdir=/opt/gcc_riscv32 --libdir=/opt/gcc_riscv32 --includedir=/opt/gcc_riscv32 && make -j16 && make install

15. 编译gcc。

    mkdir build_gcc && cd build_gcc && ../riscv-gcc/configure --prefix=/opt/gcc_riscv32 --target=riscv32-unknown-elf --with-arch=rv32imc --with-abi=ilp32 --disable-__cxa_atexit --disable-libgomp --disable-libmudflap --enable-libssp --disable-libstdcxx-pch --disable-nls --disable-shared --disable-threads --disable-multilib --enable-poison-system-directories --enable-languages=c,c++ --with-gnu-as --with-gnu-ld --with-newlib --with-system-zlib CFLAGS="-fstack-protector-strong -O2 -D_FORTIFY_SOURCE=2 -Wl,-z,relro,-z,now,-z,noexecstack -fPIE" CXXFLAGS="-fstack-protector-strong -O2 -D_FORTIFY_SOURCE=2 -Wl,-z,relro,-z,now,-z,noexecstack -fPIE" LDFLAGS="-Wl,-z,relro,-z,now,-z,noexecstack" CXXFLAGS_FOR_TARGET="-Os -mcmodel=medlow -Wall -fstack-protector-strong -Wl,-z,relro,-z,now,-z,noexecstack -Wtrampolines -fno-short-enums -fno-short-wchar" CFLAGS_FOR_TARGET="-Os -mcmodel=medlow -Wall -fstack-protector-strong -Wl,-z,relro,-z,now,-z,noexecstack -Wtrampolines -fno-short-enums -fno-short-wchar" --with-headers="/opt/gcc-riscv32/riscv32-unknown-elf/include" --with-mpc=/usr/local/mpc-1.1.0 --with-gmp=/usr/local/gmp-6.1.2 --with-mpfr=/usr/local/mpfr-4.0.2 && make -j16 && make install

16. 设置环境变量。

    vim ~/.bashrc

    将以下命令拷贝到.bashrc文件的最后一行，保存并退出。

    export PATH=/opt/gcc_riscv32/bin:$PATH

17. 生效环境变量。

    source ~/.bashrc

18. Shell命令行中输入如下命令，如果能正确显示编译器版本号，表明编译器安装成功。

    riscv32-unknown-elf-gcc -v

安装Windows开发环境

OpenHarmony IDE工具DevEco Device Tool集成了终端工具的能力，工具的安装步骤请参考DevEco Device Tool环境搭建、导入和配置工程完成。