# luckfox-pico **Repository Path**: LuckfoxTECH/luckfox-pico ## Basic Information - **Project Name**: luckfox-pico - **Description**: No description available - **Primary Language**: Unknown - **License**: Not specified - **Default Branch**: main - **Homepage**: None - **GVP Project**: No ## Statistics - **Stars**: 85 - **Forks**: 95 - **Created**: 2023-11-15 - **Last Updated**: 2025-11-28 ## Categories & Tags **Categories**: Uncategorized **Tags**: None ## README ![luckfox](https://github.com/LuckfoxTECH/luckfox-pico/assets/144299491/cec5c4a5-22b9-4a9a-abb1-704b11651e88) # 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 ``` * Gitee ``` git clone ``` ### 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.