Files
luckfox-pico/README_CN.md
luckfox-eng29 e2b0ffa22e Pullrequest fix backlight (#291)
* 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>
2025-06-11 10:47:51 +08:00

16 KiB
Executable File
Raw Blame History

luckfox

Luckfox Pico SDK

English Version

  • 本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

安装依赖

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全部可用选项

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"

选择参考的板级配置

./build.sh lunch
  • 输出对应的Luckfox-pico硬件型号,输入对应编号后进入存储介质选项(直接回车选择序号[0]选项)
    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为例
      Lunch menu...pick the boot medium:
      选择启动媒介:
                    [0] SD_CARD
                    [1] SPI_NAND
    
    Which would you like? [0~1][default:0]:
    
  • 输出对应的Luckfox-pico硬件型号支持的根文件系统类型,输入对应编号后完成配置(直接回车选择序号[0]选项)
      Lunch menu...pick the system version:
      选择系统版本:
                    [0] Buildroot(Support Rockchip official features)
    
    Which would you like? [0~1][default:0]:
    
  • 如果需要使用旧的配置方式或者使用自定义的板级支持文件在配置Luckfox-pico硬件型号时选择“custom”选项
    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 配置

  • 进入板级配置存放目录
    cd {SDK_PATH}/project/cfg/BoardConfig_IPC/
    
  • 打开对应的板级配置文件
  • 修改参数LF_WIFI_PASSWD和LF_WIFI_SSID
    export LF_WIFI_SSID="Your wifi ssid"
    export LF_WIFI_PSK="Your wifi password"
    

一键自动编译

  • 编译busybox/buildroot
    ./build.sh lunch   # 选择参考板级
    ./build.sh         # 一键自动编译
    

单独编译U-Boot

./build.sh clean uboot
./build.sh uboot

生成镜像文件: output/image/MiniLoaderAll.bin output/image/uboot.img

单独编译kernel

./build.sh clean kernel
./build.sh kernel

生成镜像文件: output/image/boot.img

单独编译rootfs

./build.sh clean rootfs
./build.sh rootfs
  • 注:编译后需使用./build.sh firmware命令重新打包

单独编译media

./build.sh clean media
./build.sh media

生成文件的存放目录:

output/out/media_out
  • 注:编译后需使用./build.sh firmware命令重新打包

单独编译参考应用

./build.sh clean app
./build.sh app
  • 注1app依赖media
  • 注2编译后需使用./build.sh firmware命令重新打包

固件打包

./build.sh firmware

生成文件的存放目录: output/image

内核设置

./build.sh kernelconfig

打开 kernel 的 menuconfig 界面

buildroot 设置

./build.sh buildrootconfig

打开 buildroot 的 menuconfig 界面

  • 注:仅在选择 buildroot 作为 rootfs 时才能正常运行

注意事项

在windows下复制源码包时linux下的可执行文件可能变为非可执行文件或者软连接失效导致无法编译使用。
因此使用时请注意不要在windows下复制源代码包。