安装开发板环境

About 8 min

安装开发板环境

Hi3861工具要求

硬件要求

  • Linux工作台
  • Hi3861开发板
  • USB Type-C线(Linux工作台通过USB与Hi3861开发板连接)

软件要求

须知: 本节描述采用安装包方式安装相关工具的操作步骤。如果使用Docker方式安装,无需安装表1中的相关工具,请直接从新建应用程序开始操作。

Hi3861开发板需要的工具如下表所示。

表 1 Hi3861开发板需要安装的工具

开发工具

用途

编译基础软件包(仅ubuntu 20+需要)

编译依赖的基础软件包

SCons3.0.4+

编译构建工具

python模块:setuptools、kconfiglib、pycryptodome、six、ecdsa

编译构建工具

gcc riscv32

编译构建工具

安装Linux编译工具

安装编译依赖基础软件(仅Ubuntu 20+需要)

执行以下命令进行安装:

sudo apt-get install build-essential gcc g++ make zlib* libffi-dev
1

安装Scons

  1. 运行如下命令,安装SCons安装包。

    python3 -m pip install scons
    
    1
  2. 运行如下命令,查看是否安装成功。如果安装成功,查询结果下图所示。

    scons -v
    
    1

    图 1 SCons安装成功界面,版本要求3.0.4以上

安装python模块

  1. 运行如下命令,安装python模块setuptools。

    pip3 install setuptools
    
    1
  2. 安装GUI menuconfig工具(Kconfiglib),建议安装Kconfiglib 13.2.0+版本,任选如下一种方式。

    • 命令行方式:

      sudo pip3 install kconfiglib
      
      1
    • 安装包方式:

      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
        
        1
  3. 安装pycryptodome,任选如下一种方式。

    安装升级文件签名依赖的Python组件包,包括:pycryptodome、six、ecdsa。安装ecdsa依赖six,请先安装six,再安装ecdsa。

    • 命令行方式:

      sudo pip3 install pycryptodome
      
      1
    • 安装包方式:

      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
        
        1
  4. 安装six,任选如下一种方式。

    • 命令行方式:

      sudo pip3 install six --upgrade --ignore-installed six
      
      1
    • 安装包方式:

      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
        
        1
  5. 安装ecdsa,任选如下一种方式。

    • 命令行方式:

      sudo pip3 install ecdsa
      
      1
    • 安装包方式:

      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
        
        1

安装gcc_riscv32(WLAN模组类编译工具链)

须知:

  • Hi3861开发板平台仅支持使用libgcc运行时库的静态链接,不建议开发者使用libgcc运行时库的动态链接,以免产品需遵从GPLV3许可证。
  • 通过下述步骤2-15,我们编译好了gcc_riscv32 镜像,提供给开发者直接下载使用。直接下载 gcc_riscv32 镜像的开发者可省略下述2-15步。
  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
    
    1
  3. 下载riscv-gnu-toolchain交叉编译工具链。

    git clone --recursive https://gitee.com/mirrors/riscv-gnu-toolchain.git
    
    1
  4. 打开文件夹riscv-gnu-toolchain,先删除空文件夹,以防止下载newlib,binutils,gcc时冲突。

    cd riscv-gnu-toolchain && rm -rf riscv-newlib && rm -rf riscv-binutils && rm -rf riscv-gcc
    
    1
  5. 下载riscv-newlib-3.0.0。

    git clone -b riscv-newlib-3.0.0 https://github.com/riscv/riscv-newlib.git
    
    1
  6. 下载riscv-binutils-2.31.1。

    git clone -b riscv-binutils-2.31.1 https://github.com/riscv/riscv-binutils-gdb.git
    
    1
  7. 下载riscv-gcc-7.3.0。

    git clone -b riscv-gcc-7.3.0 https://github.com/riscv/riscv-gcc
    
    1
  8. 添加riscv-gcc-7.3.0补丁。

    访问gcc官方补丁链接8941186724,按照补丁链接中要求的修改,手动将变更添加到对应的.c和.h文件中,注意由于patch版本与下载的gcc版本有所偏差,行数有可能对应不上,请自行查找patch中的关键字定位到对应行。

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

    tar -xvf gmp-6.1.2.tar.bz2 && mkdir build_gmp && cd build_gmp && ../gmp-6.1.2/configure --prefix=/usr/local/gmp-6.1.2 --disable-shared --enable-cxx && make && make install
    
    1
  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
    
    1
  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
    
    1
  12. 打开文件夹riscv-gnu-toolchain,新建工具链输出目录。

    cd /opt && mkdir gcc_riscv32
    
    1
  13. 编译binutils。

    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 && cd ..
    
    1
  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 && cd ..
    
    1
  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
    
    1
  16. 设置环境变量。

    说明: 如果直接采用编译好的riscv32 gcc包,请先执行以下命令将压缩包解压到根目录:

    tar -xvf gcc_riscv32-linux-7.3.0.tar.gz -C ~
    
    1
    vim ~/.bashrc
    
    1

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

    export PATH=~/gcc_riscv32/bin:$PATH
    
    1
  17. 生效环境变量。

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

    riscv32-unknown-elf-gcc -v
    
    1