mirror of
https://github.com/LuckfoxTECH/luckfox-pico.git
synced 2026-01-17 19:22:15 +01:00
e2b0ffa22e
* project : Merge the board configurations of Luckfox Pico Mini A and Luckfox Pico Mini B; Merge the board configurations of Luckfox Pico Pro and Luckfox pico Max Signed-off-by: eng29 <eng29@luckfox.com> * sysdrv/source/kernel/arch/arm/boot/dts : Merge the device tree configurations of Luckfox Pico Mini A and Luckfox Mini B; Merge the device tree configurations of Luckfox Pico Pro and Luckfox Pico Max Signed-off-by: eng29 <eng29@luckfox.com> * sysdrv/source/uboot : uboot add support for automatically executing custom commands defined by Luckfox Signed-off-by: eng29 <eng29@luckfox.com> * sysdrv/source/kernel : The Luckfox Pico series dynamically loads the BLACKLIGHT_PWM driver, which hides display abnormalities that occur during the screen initialization process Signed-off-by: eng29 <eng29@luckfox.com> * project/cfg/BoardConfig_IPC : Update the BoardConfig file and overlay file of the Luckfox Pico model that supports RGB, so that the BLACKLIGHT_PWM driver will be automatically loaded Signed-off-by: eng29 <eng29@luckfox.com> * project/cfg/BoardConfig_IPC : Add rtl8723bs module support for Luckfox Pico Mini / Luckfox Pico Plus / Luckfox Pico WebBee / Luckfox Pico Pro Max Signed-off-by: eng29 <eng29@luckfox.com> * sysdrv/drv_ko/wifi/insmod_wifi.sh : Add support for identifying rtl8723bs Signed-off-by: eng29 <eng29@luckfox.com> * sysdrv/source/kernel/arch/arm/configs/luckfox_rv1106_linux_defconfig : Add usb_audio, ch343 and rtl8723bs support Signed-off-by: eng29 <eng29@luckfox.com> * sysdrv/tools/board/buildroot : Enable the pcre2 package by default on startup Signed-off-by: eng29 <eng29@luckfox.com> * project/app/rkipc/rkipc/common/network/network.c : Fix missing DNS issue when bringing up Wi-Fi interface Signed-off-by: eng29 <eng29@luckfox.com> * README.md : Update description README_CN.md : Update description Signed-off-by: eng29 <eng29@luckfox.com> * project/cfg/BoardConfig_IPC/overlay/overlay-luckfox-config/usr/bin/luckfox-config : Disable UART2_M1 pinmux configuration Signed-off-by: eng29 <eng29@luckfox.com> * project/cfg/BoardConfig_IPC/overlay/overlay-luckfox-config/etc/init.d/S99luckfoxconfigload : Remove the function of pressing the boot button to switch the screen model Signed-off-by: eng29 <eng29@luckfox.com> * sysdrv/source/kernel/arch/arm/boot/dts : Standardize the writing format of the dst files Signed-off-by: eng29 <eng29@luckfox.com> --------- Signed-off-by: eng29 <eng29@luckfox.com>
354 lines
16 KiB
Markdown
Executable File
354 lines
16 KiB
Markdown
Executable File
|
||
# Luckfox Pico SDK
|
||
[English Version](./README.md)
|
||
* 本SDK基于RK官方提供的SDK修改而来
|
||
* 专为Luckfox Pico系列开发板提供客制化的SDK
|
||
* 旨在为开发者提供更好的编程体验
|
||
## SDK 更新日志
|
||
+ 当前版本 V1.4
|
||
1. 更新uboot，提供rv1106使用spi_nand和emmc快速启动的支持
|
||
2. 优化了uboot对SD卡的兼容性，减少识别SD卡失败的概率
|
||
3. 更新内核版本为5.10.160，提高rv1106g3的npu频率
|
||
4. 更新buildroot的镜像源，使软件包下载更加稳定
|
||
5. 添加了自定义文件系统的支持
|
||
6. 部分bug修复
|
||
## SDK 使用说明
|
||
* 推荐SDK使用系统环境为Ubuntu 22.04
|
||
### 安装依赖
|
||
```shell
|
||
sudo apt-get install repo git ssh make gcc gcc-multilib g++-multilib module-assistant expect g++ gawk texinfo libssl-dev bison flex fakeroot cmake unzip gperf autoconf device-tree-compiler libncurses5-dev pkg-config bc python-is-python3 passwd openssl openssh-server openssh-client vim file cpio rsync
|
||
```
|
||
### 获取SDK
|
||
* github
|
||
```
|
||
git clone https://github.com/LuckfoxTECH/luckfox-pico.git
|
||
```
|
||
* gitee
|
||
```
|
||
git clone https://gitee.com/LuckfoxTECH/luckfox-pico.git
|
||
```
|
||
### 环境变量
|
||
* 需要将交叉编译工具链设置
|
||
```
|
||
cd {SDK_PATH}/tools/linux/toolchain/arm-rockchip830-linux-uclibcgnueabihf/
|
||
source env_install_toolchain.sh
|
||
```
|
||
### build.sh使用说明
|
||
* SDK使用build.sh脚本实现自动编译，大部分编译操作均可以通过build.sh自动完成.
|
||
#### build.sh全部可用选项
|
||
```shell
|
||
Usage: build.sh [OPTIONS]
|
||
Available options:
|
||
lunch -Select Board Configure
|
||
env -build env
|
||
meta -build meta (optional)
|
||
uboot -build uboot
|
||
kernel -build kernel
|
||
rootfs -build rootfs
|
||
driver -build kernel's drivers
|
||
sysdrv -build uboot, kernel, rootfs
|
||
media -build rockchip media libraries
|
||
app -build app
|
||
recovery -build recovery
|
||
tool -build tool
|
||
updateimg -build update image
|
||
unpackimg -unpack update image
|
||
factory -build factory image
|
||
all -build uboot, kernel, rootfs, recovery image
|
||
allsave -build all & firmware & save
|
||
|
||
clean -clean all
|
||
clean uboot -clean uboot
|
||
clean kernel -clean kernel
|
||
clean driver -clean driver
|
||
clean rootfs -clean rootfs
|
||
clean sysdrv -clean uboot/kernel/rootfs
|
||
clean media -clean rockchip media libraries
|
||
clean app -clean app
|
||
clean recovery -clean recovery
|
||
|
||
firmware -pack all the image we need to boot up system
|
||
ota -pack update_ota.tar
|
||
save -save images, patches, commands used to debug
|
||
check -check the environment of building
|
||
info -see the current board building information
|
||
|
||
buildrootconfig -config buildroot and save defconfig"
|
||
kernelconfig -config kernel and save defconfig"
|
||
```
|
||
#### 选择参考的板级配置
|
||
```shell
|
||
./build.sh lunch
|
||
```
|
||
+ 输出对应的Luckfox-pico硬件型号,输入对应编号后进入存储介质选项（直接回车选择序号[0]选项）
|
||
```shell
|
||
You're building on Linux
|
||
Lunch menu...pick the Luckfox Pico hardware version:
|
||
选择 Luckfox Pico 硬件版本:
|
||
[0] RV1103_Luckfox_Pico
|
||
[1] RV1103_Luckfox_Pico_Mini
|
||
[2] RV1103_Luckfox_Pico_Plus
|
||
[3] RV1103_Luckfox_Pico_WebBee
|
||
[4] RV1106_Luckfox_Pico_Pro_Max
|
||
[5] RV1106_Luckfox_Pico_Ultra
|
||
[6] RV1106_Luckfox_Pico_Ultra_W
|
||
[7] RV1106_Luckfox_Pico_Pi
|
||
[8] RV1106_Luckfox_Pico_Pi_W
|
||
[9] RV1106_Luckfox_Pico_86Panel
|
||
[10] RV1106_Luckfox_Pico_86Panel_W
|
||
[11] custom
|
||
Which would you like? [0~11][default:0]:
|
||
```
|
||
+ 输出对应的Luckfox-pico硬件型号支持的存储介质,输入对应编号后进入根文件系统选项（直接回车选择序号[0]选项）
|
||
以Luckfox Pico Plus为例
|
||
```shell
|
||
Lunch menu...pick the boot medium:
|
||
选择启动媒介:
|
||
[0] SD_CARD
|
||
[1] SPI_NAND
|
||
|
||
Which would you like? [0~1][default:0]:
|
||
```
|
||
+ 输出对应的Luckfox-pico硬件型号支持的根文件系统类型,输入对应编号后完成配置(直接回车选择序号[0]选项)
|
||
```shell
|
||
Lunch menu...pick the system version:
|
||
选择系统版本:
|
||
[0] Buildroot(Support Rockchip official features)
|
||
|
||
Which would you like? [0~1][default:0]:
|
||
```
|
||
+ 如果需要使用旧的配置方式或者使用自定义的板级支持文件，在配置Luckfox-pico硬件型号时，选择“custom”选项
|
||
```shell
|
||
You're building on Linux
|
||
Lunch menu...pick the Luckfox Pico hardware version:
|
||
选择 Luckfox Pico 硬件版本:
|
||
[0] RV1103_Luckfox_Pico
|
||
[1] RV1103_Luckfox_Pico_Mini
|
||
[2] RV1103_Luckfox_Pico_Plus
|
||
[3] RV1103_Luckfox_Pico_WebBee
|
||
[4] RV1106_Luckfox_Pico_Pro_Max
|
||
[5] RV1106_Luckfox_Pico_Ultra
|
||
[6] RV1106_Luckfox_Pico_Ultra_W
|
||
[7] RV1106_Luckfox_Pico_Pi
|
||
[8] RV1106_Luckfox_Pico_Pi_W
|
||
[9] RV1106_Luckfox_Pico_86Panel
|
||
[10] RV1106_Luckfox_Pico_86Panel_W
|
||
[11] custom
|
||
Which would you like? [0~11][default:0]: 11
|
||
----------------------------------------------------------------
|
||
0. BoardConfig_IPC/BoardConfig-EMMC-Buildroot-RV1106_Luckfox_Pico_86Panel-IPC.mk
|
||
boot medium(启动介质): EMMC
|
||
system version(系统版本): Buildroot
|
||
hardware version(硬件版本): RV1106_Luckfox_Pico_86Panel
|
||
application(应用场景): IPC
|
||
----------------------------------------------------------------
|
||
|
||
----------------------------------------------------------------
|
||
1. BoardConfig_IPC/BoardConfig-EMMC-Buildroot-RV1106_Luckfox_Pico_86Panel_W-IPC.mk
|
||
boot medium(启动介质): EMMC
|
||
system version(系统版本): Buildroot
|
||
hardware version(硬件版本): RV1106_Luckfox_Pico_86Panel_W
|
||
application(应用场景): IPC
|
||
----------------------------------------------------------------
|
||
|
||
----------------------------------------------------------------
|
||
2. BoardConfig_IPC/BoardConfig-EMMC-Buildroot-RV1106_Luckfox_Pico_Pi-IPC.mk
|
||
boot medium(启动介质): EMMC
|
||
system version(系统版本): Buildroot
|
||
hardware version(硬件版本): RV1106_Luckfox_Pico_Pi
|
||
application(应用场景): IPC
|
||
----------------------------------------------------------------
|
||
|
||
----------------------------------------------------------------
|
||
3. BoardConfig_IPC/BoardConfig-EMMC-Buildroot-RV1106_Luckfox_Pico_Pi_W-IPC.mk
|
||
boot medium(启动介质): EMMC
|
||
system version(系统版本): Buildroot
|
||
hardware version(硬件版本): RV1106_Luckfox_Pico_Pi_W
|
||
application(应用场景): IPC
|
||
----------------------------------------------------------------
|
||
|
||
----------------------------------------------------------------
|
||
4. BoardConfig_IPC/BoardConfig-EMMC-Buildroot-RV1106_Luckfox_Pico_Ultra-IPC.mk
|
||
boot medium(启动介质): EMMC
|
||
system version(系统版本): Buildroot
|
||
hardware version(硬件版本): RV1106_Luckfox_Pico_Ultra
|
||
application(应用场景): IPC
|
||
----------------------------------------------------------------
|
||
|
||
----------------------------------------------------------------
|
||
5. BoardConfig_IPC/BoardConfig-EMMC-Buildroot-RV1106_Luckfox_Pico_Ultra_W-IPC.mk
|
||
boot medium(启动介质): EMMC
|
||
system version(系统版本): Buildroot
|
||
hardware version(硬件版本): RV1106_Luckfox_Pico_Ultra_W
|
||
application(应用场景): IPC
|
||
----------------------------------------------------------------
|
||
|
||
----------------------------------------------------------------
|
||
6. BoardConfig_IPC/BoardConfig-EMMC-Busybox-RV1106_Luckfox_Pico_Ultra-IPC_FASTBOOT.mk
|
||
boot medium(启动介质): EMMC
|
||
system version(系统版本): Busybox
|
||
hardware version(硬件版本): RV1106_Luckfox_Pico_Ultra
|
||
application(应用场景): IPC_FASTBOOT
|
||
----------------------------------------------------------------
|
||
|
||
----------------------------------------------------------------
|
||
7. BoardConfig_IPC/BoardConfig-SD_CARD-Buildroot-RV1103_Luckfox_Pico-IPC.mk
|
||
boot medium(启动介质): SD_CARD
|
||
system version(系统版本): Buildroot
|
||
hardware version(硬件版本): RV1103_Luckfox_Pico
|
||
application(应用场景): IPC
|
||
----------------------------------------------------------------
|
||
|
||
----------------------------------------------------------------
|
||
8. BoardConfig_IPC/BoardConfig-SD_CARD-Buildroot-RV1103_Luckfox_Pico_Mini-IPC.mk
|
||
boot medium(启动介质): SD_CARD
|
||
system version(系统版本): Buildroot
|
||
hardware version(硬件版本): RV1103_Luckfox_Pico_Mini
|
||
application(应用场景): IPC
|
||
----------------------------------------------------------------
|
||
|
||
----------------------------------------------------------------
|
||
9. BoardConfig_IPC/BoardConfig-SD_CARD-Buildroot-RV1103_Luckfox_Pico_Plus-IPC.mk
|
||
boot medium(启动介质): SD_CARD
|
||
system version(系统版本): Buildroot
|
||
hardware version(硬件版本): RV1103_Luckfox_Pico_Plus
|
||
application(应用场景): IPC
|
||
----------------------------------------------------------------
|
||
|
||
----------------------------------------------------------------
|
||
10. BoardConfig_IPC/BoardConfig-SD_CARD-Buildroot-RV1103_Luckfox_Pico_WebBee-IPC.mk
|
||
boot medium(启动介质): SD_CARD
|
||
system version(系统版本): Buildroot
|
||
hardware version(硬件版本): RV1103_Luckfox_Pico_WebBee
|
||
application(应用场景): IPC
|
||
----------------------------------------------------------------
|
||
|
||
----------------------------------------------------------------
|
||
11. BoardConfig_IPC/BoardConfig-SD_CARD-Buildroot-RV1106_Luckfox_Pico_Pro_Max-IPC.mk
|
||
boot medium(启动介质): SD_CARD
|
||
system version(系统版本): Buildroot
|
||
hardware version(硬件版本): RV1106_Luckfox_Pico_Pro_Max
|
||
application(应用场景): IPC
|
||
----------------------------------------------------------------
|
||
|
||
----------------------------------------------------------------
|
||
12. BoardConfig_IPC/BoardConfig-SPI_NAND-Buildroot-RV1103_Luckfox_Pico_Mini-IPC.mk
|
||
boot medium(启动介质): SPI_NAND
|
||
system version(系统版本): Buildroot
|
||
hardware version(硬件版本): RV1103_Luckfox_Pico_Mini
|
||
application(应用场景): IPC
|
||
----------------------------------------------------------------
|
||
|
||
----------------------------------------------------------------
|
||
13. BoardConfig_IPC/BoardConfig-SPI_NAND-Buildroot-RV1103_Luckfox_Pico_Plus-IPC.mk
|
||
boot medium(启动介质): SPI_NAND
|
||
system version(系统版本): Buildroot
|
||
hardware version(硬件版本): RV1103_Luckfox_Pico_Plus
|
||
application(应用场景): IPC
|
||
----------------------------------------------------------------
|
||
|
||
----------------------------------------------------------------
|
||
14. BoardConfig_IPC/BoardConfig-SPI_NAND-Buildroot-RV1103_Luckfox_Pico_WebBee-IPC.mk
|
||
boot medium(启动介质): SPI_NAND
|
||
system version(系统版本): Buildroot
|
||
hardware version(硬件版本): RV1103_Luckfox_Pico_WebBee
|
||
application(应用场景): IPC
|
||
----------------------------------------------------------------
|
||
|
||
----------------------------------------------------------------
|
||
15. BoardConfig_IPC/BoardConfig-SPI_NAND-Buildroot-RV1106_Luckfox_Pico_Pro_Max-IPC.mk
|
||
boot medium(启动介质): SPI_NAND
|
||
system version(系统版本): Buildroot
|
||
hardware version(硬件版本): RV1106_Luckfox_Pico_Pro_Max
|
||
application(应用场景): IPC
|
||
----------------------------------------------------------------
|
||
|
||
----------------------------------------------------------------
|
||
16. BoardConfig_IPC/BoardConfig-SPI_NAND-Busybox-RV1106_Luckfox_Pico_Pro_Max-IPC_FASTBOOT.mk
|
||
boot medium(启动介质): SPI_NAND
|
||
system version(系统版本): Busybox
|
||
hardware version(硬件版本): RV1106_Luckfox_Pico_Pro_Max
|
||
application(应用场景): IPC_FASTBOOT
|
||
----------------------------------------------------------------
|
||
```
|
||
输入对应的板级支持文件序号完成配置
|
||
#### 设置 Buildroot 系统默认 WIFI 配置
|
||
* 进入板级配置存放目录
|
||
```shell
|
||
cd {SDK_PATH}/project/cfg/BoardConfig_IPC/
|
||
```
|
||
* 打开对应的板级配置文件
|
||
* 修改参数LF_WIFI_PASSWD和LF_WIFI_SSID
|
||
```shell
|
||
export LF_WIFI_SSID="Your wifi ssid"
|
||
export LF_WIFI_PSK="Your wifi password"
|
||
```
|
||
#### 一键自动编译
|
||
* 编译busybox/buildroot
|
||
```shell
|
||
./build.sh lunch # 选择参考板级
|
||
./build.sh # 一键自动编译
|
||
```
|
||
#### 单独编译U-Boot
|
||
```shell
|
||
./build.sh clean uboot
|
||
./build.sh uboot
|
||
```
|
||
生成镜像文件：
|
||
output/image/MiniLoaderAll.bin
|
||
output/image/uboot.img
|
||
|
||
#### 单独编译kernel
|
||
```shell
|
||
./build.sh clean kernel
|
||
./build.sh kernel
|
||
```
|
||
生成镜像文件：
|
||
output/image/boot.img
|
||
|
||
#### 单独编译rootfs
|
||
```shell
|
||
./build.sh clean rootfs
|
||
./build.sh rootfs
|
||
```
|
||
* 注：编译后需使用`./build.sh firmware`命令重新打包
|
||
|
||
#### 单独编译media
|
||
```shell
|
||
./build.sh clean media
|
||
./build.sh media
|
||
```
|
||
生成文件的存放目录：
|
||
```
|
||
output/out/media_out
|
||
```
|
||
* 注：编译后需使用`./build.sh firmware`命令重新打包
|
||
#### 单独编译参考应用
|
||
```shell
|
||
./build.sh clean app
|
||
./build.sh app
|
||
```
|
||
* 注1：app依赖media
|
||
* 注2：编译后需使用`./build.sh firmware`命令重新打包
|
||
#### 固件打包
|
||
```shell
|
||
./build.sh firmware
|
||
```
|
||
生成文件的存放目录：
|
||
output/image
|
||
#### 内核设置
|
||
``` shell
|
||
./build.sh kernelconfig
|
||
```
|
||
打开 kernel 的 menuconfig 界面
|
||
#### buildroot 设置
|
||
```shell
|
||
./build.sh buildrootconfig
|
||
```
|
||
打开 buildroot 的 menuconfig 界面
|
||
* 注：仅在选择 buildroot 作为 rootfs 时才能正常运行
|
||
|
||
### 注意事项
|
||
在windows下复制源码包时，linux下的可执行文件可能变为非可执行文件，或者软连接失效导致无法编译使用。
|
||
因此使用时请注意不要在windows下复制源代码包。
|