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>
366 lines
16 KiB
Markdown
Executable File
366 lines
16 KiB
Markdown
Executable File
|
||
# Luckfox Pico SDK
|
||
[中文版](./README_CN.md)
|
||
* This SDK is modified based on the SDK provided by Rockchip
|
||
* It provides a customized SDK specifically for Luckfox Pico series development boards
|
||
* Aimed at providing developers with a better programming experience
|
||
## SDK Updatelog
|
||
+ Current Version: V1.4
|
||
1. Updated U-Boot to support fast boot for RV1106 using SPI NAND and eMMC.
|
||
2. Optimized U-Boot compatibility with SD cards, reducing the likelihood of SD card recognition failures.
|
||
3. Updated the kernel version to 5.10.160, increasing the NPU frequency for RV1106G3.
|
||
4. Updated the Buildroot mirror source for more stable package downloads.
|
||
5. Added support for custom file systems.
|
||
6. Partial bug fixes
|
||
## SDK Usage Instructions
|
||
* recommended operating system : Ubuntu 22.04
|
||
### Installing Dependencies
|
||
```shell
|
||
sudo apt-get install -y 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
|
||
```
|
||
### Get SDK
|
||
```
|
||
git clone https://github.com/LuckfoxTECH/luckfox-pico.git
|
||
```
|
||
### Environment Variables
|
||
* The cross-compilation toolchain needs to be set Environment Variables
|
||
```
|
||
cd {SDK_PATH}/tools/linux/toolchain/arm-rockchip830-linux-uclibcgnueabihf/
|
||
source env_install_toolchain.sh
|
||
```
|
||
### Get the SDK
|
||
* GitHub
|
||
```
|
||
git clone <https://github.com/LuckfoxTECH/luckfox-pico.git>
|
||
```
|
||
* Gitee
|
||
```
|
||
git clone <https://gitee.com/LuckfoxTECH/luckfox-pico.git>
|
||
```
|
||
### Instructions for build.sh
|
||
* The build.sh script is used to automate the compilation process.
|
||
* Most of the compilation operations can be completed automatically through build.sh.
|
||
#### Options for 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"
|
||
```
|
||
#### Select the referenced board configuration
|
||
```shell
|
||
./build.sh lunch
|
||
```
|
||
+ Output the corresponding Luckfox-pico hardware model. Enter the corresponding number to proceed to the storage media options (press Enter to select option [0] directly).
|
||
```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]:
|
||
```
|
||
+ Output the supported storage media for the corresponding Luckfox-pico hardware model. Enter the corresponding number to proceed to the root filesystem options (press Enter to select option [0] directly).For example, Luckfox Pico Plus.
|
||
```shell
|
||
Lunch menu...pick the boot medium:
|
||
选择启动媒介:
|
||
[0] SD_CARD
|
||
[1] SPI_NAND
|
||
|
||
Which would you like? [0~1][default:0]:
|
||
```
|
||
+ Output the supported root filesystem types for the corresponding Luckfox-pico hardware model. Enter the corresponding number to complete the configuration (press Enter to select option [0] directly).
|
||
```shell
|
||
Lunch menu...pick the system version:
|
||
选择系统版本:
|
||
[0] Buildroot(Support Rockchip official features)
|
||
|
||
Which would you like? [0~1][default:0]:
|
||
```
|
||
+ If you need to use the old configuration method or a custom board support file, select the "[7]custom" option when configuring the Luckfox-pico hardware model.
|
||
```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
|
||
----------------------------------------------------------------
|
||
```
|
||
Enter the corresponding board support file number to complete the configuration.
|
||
#### Set Buildroot System Default WIFI Configuration
|
||
* Navigate to the board-level configuration directory
|
||
```shell
|
||
cd {SDK_PATH}/project/cfg/BoardConfig_IPC/
|
||
```
|
||
* Open the corresponding board-level configuration file
|
||
* Modify the parameters LF_WIFI_PASSWD and LF_WIFI_SSID
|
||
```shell
|
||
export LF_WIFI_SSID="Your wifi ssid"
|
||
export LF_WIFI_PSK="Your wifi password"
|
||
```
|
||
#### One-click Automatic Compilation
|
||
```shell
|
||
./build.sh lunch # Select the reference board configuration
|
||
./build.sh # One-click automatic compilation
|
||
```
|
||
* Compile busybox/buildroot
|
||
```
|
||
./build.sh lunch # Select the reference board
|
||
./build.sh # One-click automatic compilation
|
||
```
|
||
#### Build U-Boot
|
||
```shell
|
||
./build.sh clean uboot
|
||
./build.sh uboot
|
||
```
|
||
The path of the generated files:
|
||
```
|
||
output/image/MiniLoaderAll.bin
|
||
output/image/uboot.img
|
||
```
|
||
#### Build kernel
|
||
```shell
|
||
./build.sh clean kernel
|
||
./build.sh kernel
|
||
```
|
||
The path of the generated files:
|
||
```
|
||
output/image/boot.img
|
||
```
|
||
#### Build rootfs
|
||
```shell
|
||
./build.sh clean rootfs
|
||
./build.sh rootfs
|
||
```
|
||
* Note : After compilation, use the command ./build.sh firmware to repackage.
|
||
|
||
#### Build media
|
||
```shell
|
||
./build.sh clean media
|
||
./build.sh media
|
||
```
|
||
The path of the generated files:
|
||
```
|
||
output/out/media_out
|
||
```
|
||
* Note : After compilation, use the command ./build.sh firmware to repackage.
|
||
#### Build Reference Applications
|
||
```shell
|
||
./build.sh clean app
|
||
./build.sh app
|
||
```
|
||
* Note 1: The app depends on media.
|
||
* Note 2: After compilation, use the command ./build.sh firmware to repackage.
|
||
#### Firmware Packaging
|
||
```shell
|
||
./build.sh firmware
|
||
```
|
||
The path of the generated files:
|
||
```
|
||
output/image
|
||
```
|
||
#### Kernel Config
|
||
```shell
|
||
./build.sh kernelconfig
|
||
```
|
||
Open the menuconfig interface for the kernel.
|
||
#### Buildroot Config
|
||
```shell
|
||
./build.sh buildrootconfig
|
||
```
|
||
Open the menuconfig interface for buildroot.
|
||
* Note: This is only applicable when selecting buildroot as the root file system.
|
||
|
||
## Notices
|
||
When copying the source code package under Windows, the executable file under Linux may become a non-executable file, or the soft link fails and cannot be compiled and used.
|
||
Therefore, please be careful not to copy the source code package under Windows.
|