justmarvinn/luckfox-pico-sdk
1
0
Fork 0
Code Issues Pull Requests Actions Packages Projects Releases Wiki Activity
ac4c9c0906
luckfox-pico-sdk/README_CN.md
luckfox-eng29 ac4c9c0906 update:README.md and UPDATE_LOG.md
2024-06-07 19:41:38 +08:00

15 KiB
Executable File
Raw Blame History

luckfox

Luckfox Pico SDK

English Version

  • 本SDK基于RK官方提供的SDK修改而来
  • 专为Luckfox Pico系列开发板提供客制化的SDK
  • 旨在为开发者提供更好的编程体验

SDK 更新日志

  • 当前版本 V1.3
  1. 添加Luckfox-pico-Ultra和Luckfox-pico-Ultra-W支持
  2. 优化了板级支持文件的选择操作
  3. 优化了buildroot的软件包下载速度，会根据下载环境选择速度较快的源服务器
  4. 优化了buildroot的包管理操作，build.sh 命令添加了 buildrootconfig 选项可以直接进入buildroot的menuconfig
  5. 优化了rootfs的clean操作，可以保留buildroot已经下载的软件包
  6. 优化了kernel的配置操作，build.sh 命令添加了 kernelconfig 选项可以进入kernel的menuconfig
  7. 添加了 config 配置文件夹，可以快速配置设备树、内核和Buildroot
  8. 优化了系统的根文件系统打包流程，可以在 <Luckfox-pico SDK PATH>/output/out/rootfs_uclibc_rv1106文件夹下对根文件进行客制化修改
  9. 修改了默认设备树的配置，可以在板端系统使用luckfox-config命令配置引脚和接口功能
  10. 部分bug修复

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

获取SDK

  • github 
    git clone https://github.com/LuckfoxTECH/luckfox-pico.git
  • gitee 
    git clone https://gitee.com/LuckfoxTECH/luckfox-pico.git
    • 如果你需要需要编译ubuntu系统，并且使用gitee源
    • 请修改对应的板型mk文件中LF_SUBMODULES_BY改为gitee，如 
      LF_SUBMODULES_BY=gitee

环境变量

  • 需要将交叉编译工具链设置 
    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_A
                [2] RV1103_Luckfox_Pico_Mini_B
                [3] RV1103_Luckfox_Pico_Plus
                [4] RV1106_Luckfox_Pico_Pro_Max
                [5] RV1106_Luckfox_Pico_Ultra
                [6] RV1106_Luckfox_Pico_Ultra_W
                [7] custom
Which would you like? [0~7]:

输出对应的Luckfox-pico硬件型号支持的存储介质,输入对应编号后进入根文件系统选项（直接回车选择序号[0]选项） 以Luckfox Pico Plus为例

  Lunch menu...pick the boot medium:
  选择启动媒介:
                [0] SD_CARD
                [1] SPI_NAND

Which would you like? [0~1]:

输出对应的Luckfox-pico硬件型号支持的根文件系统类型,输入对应编号后完成配置(直接回车选择序号[0]选项)

  Lunch menu...pick the system version:
  选择系统版本:
                [0] Buildroot(Support Rockchip official features)
                [1] Ubuntu(Support for the apt package management tool)

Which would you like? [0~1]:

如果需要使用旧的配置方式或者使用自定义的板级支持文件，在配置Luckfox-pico硬件型号时，选择“[7]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_A
                [2] RV1103_Luckfox_Pico_Mini_B
                [3] RV1103_Luckfox_Pico_Plus
                [4] RV1106_Luckfox_Pico_Pro_Max
                [5] RV1106_Luckfox_Pico_Ultra
                [6] RV1106_Luckfox_Pico_Ultra_W
                [7] custom
Which would you like? [0~7]: 7
----------------------------------------------------------------
0. BoardConfig_IPC/BoardConfig-EMMC-Buildroot-RV1106_Luckfox_Pico_Ultra-IPC.mk
                             boot medium(启动介质): EMMC
                          system version(系统版本): Buildroot
                        hardware version(硬件版本): RV1106_Luckfox_Pico_Ultra
                              applicaton(应用场景): IPC
----------------------------------------------------------------

----------------------------------------------------------------
1. 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
                              applicaton(应用场景): IPC
----------------------------------------------------------------

----------------------------------------------------------------
2. BoardConfig_IPC/BoardConfig-EMMC-Ubuntu-RV1106_Luckfox_Pico_Ultra-IPC.mk
                             boot medium(启动介质): EMMC
                          system version(系统版本): Ubuntu
                        hardware version(硬件版本): RV1106_Luckfox_Pico_Ultra
                              applicaton(应用场景): IPC
----------------------------------------------------------------

----------------------------------------------------------------
3. BoardConfig_IPC/BoardConfig-EMMC-Ubuntu-RV1106_Luckfox_Pico_Ultra_W-IPC.mk
                             boot medium(启动介质): EMMC
                          system version(系统版本): Ubuntu
                        hardware version(硬件版本): RV1106_Luckfox_Pico_Ultra_W
                              applicaton(应用场景): IPC
----------------------------------------------------------------

----------------------------------------------------------------
4. BoardConfig_IPC/BoardConfig-SD_CARD-Buildroot-RV1103_Luckfox_Pico-IPC.mk
                             boot medium(启动介质): SD_CARD
                          system version(系统版本): Buildroot
                        hardware version(硬件版本): RV1103_Luckfox_Pico
                              applicaton(应用场景): IPC
----------------------------------------------------------------

----------------------------------------------------------------
5. BoardConfig_IPC/BoardConfig-SD_CARD-Buildroot-RV1103_Luckfox_Pico_Mini_A-IPC.mk
                             boot medium(启动介质): SD_CARD
                          system version(系统版本): Buildroot
                        hardware version(硬件版本): RV1103_Luckfox_Pico_Mini_A
                              applicaton(应用场景): IPC
----------------------------------------------------------------

----------------------------------------------------------------
6. 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
                              applicaton(应用场景): IPC
----------------------------------------------------------------

----------------------------------------------------------------
7. BoardConfig_IPC/BoardConfig-SD_CARD-Buildroot-RV1106_Luckfox_Pico_Max-IPC.mk
                             boot medium(启动介质): SD_CARD
                          system version(系统版本): Buildroot
                        hardware version(硬件版本): RV1106_Luckfox_Pico_Max
                              applicaton(应用场景): IPC
----------------------------------------------------------------

----------------------------------------------------------------
8. BoardConfig_IPC/BoardConfig-SD_CARD-Ubuntu-RV1103_Luckfox_Pico-IPC.mk
                             boot medium(启动介质): SD_CARD
                          system version(系统版本): Ubuntu
                        hardware version(硬件版本): RV1103_Luckfox_Pico
                              applicaton(应用场景): IPC
----------------------------------------------------------------

----------------------------------------------------------------
9. BoardConfig_IPC/BoardConfig-SD_CARD-Ubuntu-RV1103_Luckfox_Pico_Mini_A-IPC.mk
                             boot medium(启动介质): SD_CARD
                          system version(系统版本): Ubuntu
                        hardware version(硬件版本): RV1103_Luckfox_Pico_Mini_A
                              applicaton(应用场景): IPC
----------------------------------------------------------------

----------------------------------------------------------------
10. BoardConfig_IPC/BoardConfig-SD_CARD-Ubuntu-RV1103_Luckfox_Pico_Plus-IPC.mk
                             boot medium(启动介质): SD_CARD
                          system version(系统版本): Ubuntu
                        hardware version(硬件版本): RV1103_Luckfox_Pico_Plus
                              applicaton(应用场景): IPC
----------------------------------------------------------------

----------------------------------------------------------------
11. BoardConfig_IPC/BoardConfig-SD_CARD-Ubuntu-RV1106_Luckfox_Pico_Pro_Max-IPC.mk
                             boot medium(启动介质): SD_CARD
                          system version(系统版本): Ubuntu
                        hardware version(硬件版本): RV1106_Luckfox_Pico_Pro_Max
                              applicaton(应用场景): IPC
----------------------------------------------------------------

----------------------------------------------------------------
12. BoardConfig_IPC/BoardConfig-SPI_NAND-Buildroot-RV1103_Luckfox_Pico_Mini_B-IPC.mk
                             boot medium(启动介质): SPI_NAND
                          system version(系统版本): Buildroot
                        hardware version(硬件版本): RV1103_Luckfox_Pico_Mini_B
                              applicaton(应用场景): 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
                              applicaton(应用场景): IPC
----------------------------------------------------------------

----------------------------------------------------------------
14. 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
                              applicaton(应用场景): IPC
----------------------------------------------------------------

Which would you like? [0]:

输入对应的板级支持文件序号完成配置

设置 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         # 一键自动编译
  • 编译ubuntu 
    sudo ./build.sh lunch   # 选择参考板级
sudo ./build.sh         # 一键自动编译
    • 注意编译ubuntu时需要注意使用sudo，否则会导致文件系统错误
    • 下文就不一一区分两者指令区别，请自行根据情况选择

单独编译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
  • 注1：app依赖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下复制源代码包。