Prechádzať zdrojové kódy

[bsp][readme] 增加scons --exec-path=xxx 命令的使用说明

Meco Man 2 rokov pred
rodič
commit
8b0610fc34

+ 2 - 0
bsp/amebaz/README.md

@@ -112,6 +112,8 @@ amebaz 配套的驱动库以 package 形式提供,故需先下载对应的 pac
     scons
 ```
 
+或者通过 `scons --exec-path="GCC工具链路径"` 命令,在指定工具链位置的同时直接编译。
+
 出现下列信息即为编译成功
 
 ```bash

+ 3 - 1
bsp/ck802/README.md

@@ -34,7 +34,7 @@ Linux:
 RTT_EXEC_PATH=r'/opt/csky-abiv2-elf-tools-x86_64-minilibc-20161211/bin'
 ```
 
-
+或者通过`scons --exec-path="GCC工具链路径"`命令,在指定工具链位置的同时直接编译,推荐使用该方法。
 
 ## BSP使用
 
@@ -53,6 +53,8 @@ RTT_EXEC_PATH=r'/opt/csky-abiv2-elf-tools-x86_64-minilibc-20161211/bin'
 scons
 ```
 
+或者通过 `scons --exec-path="GCC工具链路径"` 命令,在指定工具链位置的同时直接编译。
+
 #### 仿真
 
 Windows平台打开CSkyDebugServer.exe,该软件会连接到仿真器并且提供一个gdb server。使用DebugServerConsole.exe在命令行下进行调试。

+ 2 - 2
bsp/gd32/risc-v/docs/GD32_RISC-V系列BSP制作教程.md

@@ -150,8 +150,8 @@ else:
     print('Please make sure your toolchains is GNU GCC!')
     exit(0)
 
-#if os.getenv('RTT_EXEC_PATH'):
-#    EXEC_PATH = os.getenv('RTT_EXEC_PATH')
+if os.getenv('RTT_EXEC_PATH'):
+    EXEC_PATH = os.getenv('RTT_EXEC_PATH')
 
 CORE = 'risc-v'
 BUILD = 'debug'

+ 2 - 0
bsp/hifive1/README.md

@@ -44,6 +44,8 @@ Freedom Studio 是 SiFive 公司推出的一个集成开发环境,用来编写
 set RTT_EXEC_PATH=F:\FreedomStudio\SiFive\riscv64-unknown-elf-gcc-20171231-x86_64-w64-mingw32\bin
 ```
 
+或者通过`scons --exec-path="GCC工具链路径"`命令,在指定工具链位置的同时直接编译。
+
 ### 添加环境变量
 
 将 **工具链**和**编译工具**的路径 添加到环境变量里,输入命令如下

+ 6 - 1
bsp/k210/README.md

@@ -72,10 +72,15 @@ Windows下推荐使用[env工具][1],然后在console下进入bsp/k210目录
 
 然后执行scons编译:  
 
+```
     set RTT_EXEC_PATH=C:\Users\xxxx\Downloads\xpack-riscv-none-embed-gcc-10.2.0-1.2\bin
     scons
+```
+来编译这个板级支持包。
+
+或者通过 `scons --exec-path="GCC工具链路径"` 命令,在指定工具链位置的同时直接编译。
 
-来编译这个板级支持包。如果编译正确无误,会产生rtthread.elf、rtthread.bin文件。其中rtthread.bin需要烧写到设备中进行运行。  
+如果编译正确无误,会产生rtthread.elf、rtthread.bin文件。其中rtthread.bin需要烧写到设备中进行运行。  
 注:如果初次使用编译报错,可能是使用的SDK过老,使用`menuconfig`命令,在→ RT-Thread online packages → peripheral libraries 
 and drivers → the kendryte-sdk package for rt-thread中将SDK改为latest版本即可。
 ## 3. 烧写及执行

+ 7 - 1
bsp/loongson/ls1cdev/README.md

@@ -25,11 +25,17 @@ Windows平台推荐使用[env工具][1]。龙芯1C的LS232处理器核是一款M
 
 安装好工具链后,假设工具链安装在`D:\mgc\embedded\codebench`目录下。使用env工具,打开console后,进入到命令行环境中,需要手动设置工具链的环境变量`RTT_EXEC_PATH`:
 
+```
     set RTT_EXEC_PATH=D:\mgc\embedded\codebench\bin
-	
+```
+
 使用env工具,可以在console下进入到`bsp/ls1cdev`目录中,运行以下命令:
 
+```
     scons
+```
+
+或者通过 `scons --exec-path="GCC工具链路径"` 命令,在指定工具链位置的同时直接编译,推荐使用该方法。
 
 来编译这个板级支持包。如果编译正确无误,会产生rtthread.elf、rtthread.bin文件。
 

+ 4 - 0
bsp/loongson/ls2kdev/README.md

@@ -35,7 +35,11 @@ if  CROSS_TOOL == 'gcc':
 
 安装好工具链后,假设工具链安装在`D:\mgc\embedded\codebench`目录下。使用env工具,打开console后,进入到命令行环境中,需要手动设置工具链的环境变量`RTT_EXEC_PATH`:
 
+```
     set RTT_EXEC_PATH=D:\mgc\embedded\codebench\bin
+```
+
+或者通过 `scons --exec-path="GCC工具链路径"` 命令,在指定工具链位置的同时直接编译。
 
 使用env工具,可以在console下进入到`bsp/ls2kdev`目录中,然后在控制台输入`scons`即可,可以生成`rtthread.elf`、`rtthread.bin`文件,其中`rtthread.elf`是下载到开发板上的程序。
 

+ 3 - 1
bsp/lpc55sxx/Libraries/template/lpc55s6xxxx/README.md

@@ -97,7 +97,7 @@ LPC55S69 是由恩智浦NXP半导体推出的基于Cortex-M33内核的高性能
 使用以下指令设置gcc路径
 
 ```bash
-    SET RTT_EXEC_PATH=[GCC路径]
+    set RTT_EXEC_PATH=[GCC路径]
 ```
 
 (Linux/Mac arm-none-eabi-gcc)
@@ -113,6 +113,8 @@ LPC55S69 是由恩智浦NXP半导体推出的基于Cortex-M33内核的高性能
     scons -j4
 ```
 
+或者通过 `scons --exec-path="GCC工具链路径"` 命令,在指定工具链位置的同时直接编译。
+
 出现下列信息即为编译成功
 
 ```bash

+ 2 - 0
bsp/lpc55sxx/lpc55s69_nxp_evk/README.md

@@ -113,6 +113,8 @@ LPC55S69 是由恩智浦NXP半导体推出的基于Cortex-M33内核的高性能
     scons -j4
 ```
 
+或者通过 `scons --exec-path="GCC工具链路径"` 命令,在指定工具链位置的同时直接编译。
+
 出现下列信息即为编译成功
 
 ```bash

+ 2 - 0
bsp/qemu-virt64-aarch64/README_zh.md

@@ -20,6 +20,8 @@ scons
 ```
 可以看到正常生成`rtthread.elf`与`rtthread.bin`文件。
 
+或者通过 `scons --exec-path="GCC工具链路径"` 命令,在指定工具链位置的同时直接编译。
+
 ## 3. 执行
 
 本工程执行环境为`qemu-system-aarch64`模拟器,工程可配置为使用`Cortex-A53/A57/A72`等芯片,GIC支持`V2/V3`版本,其中`V2`最多可配置8个处理器。

+ 2 - 0
bsp/qemu-virt64-riscv/README_ZH.md

@@ -28,6 +28,8 @@ scons
 ```
 可以看到正常生成`rtthread.elf`与`rtthread.bin`文件。
 
+或者通过 `scons --exec-path="GCC工具链路径"` 命令,在指定工具链位置的同时直接编译。
+
 ## 3. 执行
 
 本工程提供了riscv64的两种可配置运行模式,默认运行在M-Mode下。

+ 2 - 0
bsp/rockchip/rk3568/README_zh.md

@@ -22,6 +22,8 @@ scons
 ```
 可以看到正常生成`rtthread.elf`与`rtthread.bin`文件。
 
+或者通过 `scons --exec-path="GCC工具链路径"` 命令,在指定工具链位置的同时直接编译。
+
 ## 3. 执行
 
 RK3568 根据不同的开发板实现有不同的 Kernel 烧写方式,推荐烧录进 SD 卡:([官方板](https://wiki.t-firefly.com/zh_CN/ROC-RK3568-PC/hardware_doc.html)|[RADXA ROCK 3A](https://wiki.radxa.com/Rock3/install/microSD))。

+ 2 - 0
bsp/sparkfun-redv/README.md

@@ -64,6 +64,8 @@ set RTT_EXEC_PATH=C:\FreedomStudio-2019-08-1-win64\SiFive\riscv64-unknown-elf-gc
 set path=%path%;C:\FreedomStudio-2019-08-1-win64\SiFive\riscv64-unknown-elf-gcc-8.3.0-2019.08.0\bin
 ```
 
+或者通过 `scons --exec-path="GCC工具链路径"` 命令,在指定工具链位置的同时直接编译。
+
 ### 2.4 从 Env 工具打开 IDE
 
 在 Env 中使用 cd 命令切换到 FreedomStudio 解压后的目录中,再执行 `FreedomStudio.exe` 文件启动 IDE。例如:

+ 2 - 0
bsp/wch/risc-v/ch32v307v-r1/README.md

@@ -50,6 +50,8 @@ CH32V307V-R1 是 WCH 推出的一款基于 RISC-V 内核的开发板,最高主
 set RTT_EXEC_PATH=D:\RT-ThreadStudio\repo\Extract\ToolChain_Support_Packages\WCH\RISC-V-GCC-WCH\8.2.0\bin
 ```
 
+或者通过 `scons --exec-path="GCC工具链路径"` 命令,在指定工具链位置的同时直接编译。
+
 > 注意:如果使用第二种方法,第一种方法设置的路劲将会失效。
 
 #### 2、生成dist文件夹