116 lines
5.5 KiB
ReStructuredText
116 lines
5.5 KiB
ReStructuredText
.. _linux_cmd:
|
||
|
||
Build with Linux or WSL
|
||
================================
|
||
|
||
本节主要介绍如何在 Linux 或者 WSL 下使用 **命令行** 进行开发。Windows 下如何安装 WSL 请自行百度。
|
||
|
||
环境搭建
|
||
-----------------
|
||
|
||
- 首先打开 linux 终端，并安装依赖工具
|
||
|
||
.. code-block:: bash
|
||
:linenos:
|
||
:emphasize-lines: 1
|
||
|
||
$ cd ~
|
||
$ sudo apt install git make ninja-build -y
|
||
|
||
- 其次使用 git 下载 RISC-V 工具链
|
||
|
||
.. code-block:: bash
|
||
:linenos:
|
||
:emphasize-lines: 4-5
|
||
|
||
$ cd ~
|
||
$ git clone git@gitee.com:bouffalolab/toolchain_gcc_t-head_linux.git
|
||
$ sudo cp -rf toolchain_gcc_t-head_linux/ /usr/bin
|
||
$ echo "export PATH=\"$PATH:/usr/bin/toolchain_gcc_t-head_linux/bin\"" >> ~/.bashrc
|
||
$ source ~/.bashrc
|
||
|
||
- 完成上述步骤以后，需要检查是否真的安装成功，输入下列命令：
|
||
|
||
.. code-block:: bash
|
||
:linenos:
|
||
|
||
$ make -v
|
||
|
||
此时应该显示如下内容表示安装成功：
|
||
|
||
.. code-block:: bash
|
||
:linenos:
|
||
|
||
GNU Make 4.1
|
||
Built for x86_64-pc-linux-gnu
|
||
Copyright (C) 1988-2014 Free Software Foundation, Inc.
|
||
License GPLv3+: GNU GPL version 3 or later <http://gnu.org/licenses/gpl.html>
|
||
This is free software: you are free to change and redistribute it.
|
||
There is NO WARRANTY, to the extent permitted by law.
|
||
|
||
.. code-block:: bash
|
||
:linenos:
|
||
|
||
$ riscv64-unknown-elf-gcc -v
|
||
|
||
此时应该显示如下内容表示安装成功：
|
||
|
||
.. code-block:: bash
|
||
:linenos:
|
||
|
||
Using built-in specs.
|
||
COLLECT_GCC=riscv64-unknown-elf-gcc
|
||
COLLECT_LTO_WRAPPER=/mnt/d/EmbeddedSoftware/Xuantie-900-gcc-elf-newlib-x86_64-V2.2.5/bin/../libexec/gcc/riscv64-unknown-elf/10.2.0/lto-wrapper
|
||
Target: riscv64-unknown-elf
|
||
Configured with: /lhome/software/toolsbuild/slave2/workspace/Toolchain/build-gnu-riscv_4/./source/riscv/riscv-gcc/configure --target=riscv64-unknown-elf --with-gmp=/lhome/software/toolsbuild/slave2/workspace/Toolchain/build-gnu-riscv_4/build-riscv-gcc-riscv64-unknown-elf/build-Xuantie-900-gcc-elf-newlib-x86_64-V2.2.5/lib-for-gcc-x86_64-linux --with-mpfr=/lhome/software/toolsbuild/slave2/workspace/Toolchain/build-gnu-riscv_4/build-riscv-gcc-riscv64-unknown-elf/build-Xuantie-900-gcc-elf-newlib-x86_64-V2.2.5/lib-for-gcc-x86_64-linux --with-mpc=/lhome/software/toolsbuild/slave2/workspace/Toolchain/build-gnu-riscv_4/build-riscv-gcc-riscv64-unknown-elf/build-Xuantie-900-gcc-elf-newlib-x86_64-V2.2.5/lib-for-gcc-x86_64-linux --with-libexpat-prefix=/lhome/software/toolsbuild/slave2/workspace/Toolchain/build-gnu-riscv_4/build-riscv-gcc-riscv64-unknown-elf/build-Xuantie-900-gcc-elf-newlib-x86_64-V2.2.5/lib-for-gcc-x86_64-linux --with-libmpfr-prefix=/lhome/software/toolsbuild/slave2/workspace/Toolchain/build-gnu-riscv_4/build-riscv-gcc-riscv64-unknown-elf/build-Xuantie-900-gcc-elf-newlib-x86_64-V2.2.5/lib-for-gcc-x86_64-linux --with-pkgversion='Xuantie-900 elf newlib gcc Toolchain V2.2.5 B-20220323' CXXFLAGS='-g -O2 -DTHEAD_VERSION_NUMBER=2.2.5' --enable-libgcctf --prefix=/lhome/software/toolsbuild/slave2/workspace/Toolchain/build-gnu-riscv_4/build-riscv-gcc-riscv64-unknown-elf/Xuantie-900-gcc-elf-newlib-x86_64-V2.2.5 --disable-shared --disable-threads --enable-languages=c,c++ --with-system-zlib --enable-tls --with-newlib --with-sysroot=/lhome/software/toolsbuild/slave2/workspace/Toolchain/build-gnu-riscv_4/build-riscv-gcc-riscv64-unknown-elf/Xuantie-900-gcc-elf-newlib-x86_64-V2.2.5/riscv64-unknown-elf --with-native-system-header-dir=/include --disable-libmudflap --disable-libssp --disable-libquadmath --disable-libgomp --disable-nls --disable-tm-clone-registry --src=/lhome/software/toolsbuild/slave2/workspace/Toolchain/build-gnu-riscv_4/./source/riscv/riscv-gcc --enable-multilib --with-abi=lp64d --with-arch=rv64gcxthead 'CFLAGS_FOR_TARGET=-Os -mcmodel=medany' 'CXXFLAGS_FOR_TARGET=-Os -mcmodel=medany'
|
||
Thread model: single
|
||
Supported LTO compression algorithms: zlib
|
||
gcc version 10.2.0 (Xuantie-900 elf newlib gcc Toolchain V2.2.5 B-20220323)
|
||
|
||
|
||
- 在 linux 中，有严格的权限限制，通常一个用户对应一个权限，所以如果提示下面信息，表示需要设置权限。因此，我们将使用到的工具都设置好权限即可
|
||
|
||
.. figure:: img/cmake_error.png
|
||
:align: center
|
||
|
||
进入 sdk 根目录，输入:
|
||
|
||
.. code-block:: bash
|
||
:linenos:
|
||
|
||
$ cd bouffalo_sdk
|
||
$ chmod 777 +x tools/cmake/bin/cmake
|
||
$ chmod 777 +x tools/bflb_tools/bflb_fw_post_proc/bflb_fw_post_proc
|
||
$ chmod 777 +x tools/bflb_tools/bouffalo_flash_cube/BLFlashCommand
|
||
|
||
编译
|
||
-------------
|
||
|
||
打开 linux 终端，进入 **examples** ，选择你想要编译的 case，且该 case 下必须有 **Makefile** 文件。使用下面命令编译，生成的 bin 文件会输出到 `build/build_out` 目录下。
|
||
|
||
- 使用 make 编译
|
||
|
||
.. code-block:: bash
|
||
:linenos:
|
||
|
||
$ cd examples/helloworld
|
||
$ make CHIP=chip_name BOARD=board_name ## chip_name 为芯片型号，可以填写 bl602、bl702、bl616、bl808、bl606p, board_name 为开发板名称，详见 bsp/board 目录
|
||
|
||
- 使用 ninja 编译
|
||
|
||
.. code-block:: bash
|
||
:linenos:
|
||
|
||
$ cd examples/helloworld
|
||
$ make ninja CHIP=chip_name BOARD=board_name ## chip_name 为芯片型号，可以填写 bl602、bl702、bl616、bl808、bl606p, board_name 为开发板名称，详见 bsp/board 目录
|
||
|
||
.. note :: 如果使用 BL808 或者 BL606P，需要在上面基础上添加 CPU_ID=id ,id 可以为 m0 或者 d0
|
||
|
||
- 烧录
|
||
|
||
.. code-block:: bash
|
||
:linenos:
|
||
|
||
$ cd examples/helloworld
|
||
$ make flash CHIP=chip_name COMX=port_name ## port_name 为串口号名称，比如 linux 中/dev/ttyACMx，wsl 中对应使用 /dev/ttySx
|