mirror of
https://gitee.com/Vancouver2017/luban-lite-t3e-pro.git
synced 2025-12-14 02:18:54 +00:00
110 lines
3.2 KiB
Markdown
110 lines
3.2 KiB
Markdown
|
|
|||
|
|
# 1. 环境安装
|
|||
|
|
|
|||
|
|
Luban-Lite SDK 采用了 `scons` 作为编译框架的基础语言，对开发环境的依赖：
|
|||
|
|
|
|||
|
|
- Python2，需安装插件：
|
|||
|
|
- scons
|
|||
|
|
- Python3，需安装插件：
|
|||
|
|
- pycryptodomex
|
|||
|
|
|
|||
|
|
|
|||
|
|
|
|||
|
|
已验证可用的操作系统环境：
|
|||
|
|
|
|||
|
|
- Ubuntu 20.04
|
|||
|
|
- Windows 10
|
|||
|
|
|
|||
|
|
|
|||
|
|
|
|||
|
|
# 2. 使用方法
|
|||
|
|
|
|||
|
|
## 2.1 方案加载
|
|||
|
|
|
|||
|
|
在编译一个方案之前，首先需要加载方案的现有配置：
|
|||
|
|
|
|||
|
|
```
|
|||
|
|
$ cd luban-lite
|
|||
|
|
$ scons --list-def // 列出当前可选的方案配置
|
|||
|
|
$ scons --apply-def=xxx_defconfig // 应用上述列表其中一条方案配置
|
|||
|
|
$ scons --info // 查看当前方案的基本配置
|
|||
|
|
```
|
|||
|
|
|
|||
|
|
## 2.2 Menuconfig 配置
|
|||
|
|
|
|||
|
|
在加载完方案配置后，可以使用 menuconfig 命令来修改当前配置：
|
|||
|
|
|
|||
|
|
```
|
|||
|
|
$ cd luban-lite
|
|||
|
|
$ scons --menuconfig // Linux 命令行下启动 Menuconfig
|
|||
|
|
$ .... // Menuconfig 配置过程
|
|||
|
|
```
|
|||
|
|
|
|||
|
|
在修改 `Project options` 中的配置时需要注意以下要求：
|
|||
|
|
|
|||
|
|
|
|||
|
|
|
|||
|
|
## 2.3 编译
|
|||
|
|
|
|||
|
|
配置完成后，可以使用以下的命令进行编译：
|
|||
|
|
|
|||
|
|
```
|
|||
|
|
$ cd luban-lite
|
|||
|
|
$ scons // 编译当前方案
|
|||
|
|
$ scons --verbose // 编译当前方案，显示更多详细信息（如GCC命令行参数）
|
|||
|
|
$ scons -c // clean当前方案
|
|||
|
|
$ ls output/$chip_$board_$kernel_$app/images/$soc.elf // 编译生成的目标文件
|
|||
|
|
```
|
|||
|
|
|
|||
|
|
## 2.4 其他命令
|
|||
|
|
|
|||
|
|
```
|
|||
|
|
$ cd luban-lite
|
|||
|
|
$ scons --run-qemu // 运行当前编译出来的qemu目标文件，需要先打开chip->QEMU配置
|
|||
|
|
$ scons --list-size // size 命令列出所有 .o 文件的 text/data/bss 各个 section 大小
|
|||
|
|
$ scons --pkgs-update // 下载选择的在线 packages
|
|||
|
|
```
|
|||
|
|
|
|||
|
|
如果需要 Windows IDE 中编译，首先在命令行下使用命令生成当前方案对应的 IDE 方案文件：
|
|||
|
|
|
|||
|
|
```
|
|||
|
|
$ scons --target=eclipse // 生成当前方案对应的 eclipse 方案文件
|
|||
|
|
```
|
|||
|
|
|
|||
|
|
然后使用 Eclipse IDE 打开方案文件进行调试。
|
|||
|
|
|
|||
|
|
# 3. OneStep 增强命令
|
|||
|
|
|
|||
|
|
Luban-Lite 中对命令行中的scons工具进行了封装，将一些高频命令行操作定义了一组快捷命令，统称为OneStep命令。
|
|||
|
|
|
|||
|
|
OneStep命令的设计目标是：任意目录，只需一步。
|
|||
|
|
|
|||
|
|
使用方法：
|
|||
|
|
|
|||
|
|
- 需要先导入脚本onestep.sh
|
|||
|
|
- 然后在该shell中就可以从任意目录执行以下命令，包括:
|
|||
|
|
- lunch - 选择方案
|
|||
|
|
- m - 编译SDK
|
|||
|
|
- c - clean SDK
|
|||
|
|
- cr - 跳转到SDK根目录等
|
|||
|
|
|
|||
|
|
```
|
|||
|
|
$ cd luban-lite
|
|||
|
|
$ source tools/onestep.sh
|
|||
|
|
$ h
|
|||
|
|
Luban-Lite SDK OneStep commands:
|
|||
|
|
hmm|h : Get this help.
|
|||
|
|
lunch [keyword] : Start with selected defconfig.e.g. lunch mmc
|
|||
|
|
menuconfig|me : Config SDK with menuconfig
|
|||
|
|
m : Build all and generate final image
|
|||
|
|
c : Clean all
|
|||
|
|
croot|cr : cd to SDK root directory.
|
|||
|
|
cout|co : cd to build output directory.
|
|||
|
|
cbuild|cb : cd to build root directory.
|
|||
|
|
ctarget|ct : cd to target board directory.
|
|||
|
|
godir|gd [keyword] : Go/jump to selected directory.
|
|||
|
|
list : List all SDK defconfig.
|
|||
|
|
i : Get current project's information.
|
|||
|
|
```
|
|||
|
|
|