匠芯创Luban/Luban lite开发环境搭建

一、开发环境1、获取源码1.1、下载源码另外记得设置权限sudochown-R$USER:$USERxxx1.1.1、Luban官方地址gitclone https://gitee.com/artinchip/d211.gitgitclone gitgitee:artinchip/d211.git工程结构├── dl -- 第三方源码的压缩包保存目录 ├── output -- 默认的编译输出目录 ├── package -- 各编译源码包/组件的配置 │ ├── Config.in -- menuconfig 配置的顶层入口 │ ├── artinchip -- ArtInChip 开发的组件配置 │ ├── linux -- 内核的配置 │ ├── opensbi -- OpenSBI 的配置 │ ├── uboot -- UBoot 的配置 │ ├── third-party -- 其它开源软件包的配置 │ ├── ... │ ├── prebuilt -- 预编译二进制包的保存目录 ├── source -- 源码保存目录 │ ├── artinchip -- ArtInChip 开发的组件源码目录 不会删除 │ ├── linux-5.10 -- 内核的源码目录 不会删除 │ ├── opensbi -- OpenSBI 的源码目录 不会删除 │ ├── uboot-2021.10 -- U-Boot 的源码目录 不会删除 │ └── third-party -- 其它开源软件包解压后的源码目录 make distclean 会删除 │ ├── target -- 芯片和具体板子的配置 │ └── configs -- 存放项目的配置文件 │ ├── d211_initramfs_defconfig │ ├── d211_per1_mmc_defconfig │ ├── d211_per2_spinand_defconfig │ ├── d211_per2_spinor_defconfig │ ├── d211_fpga_mmc_defconfig │ ├── configs_busybox - ../../package/third-party/busybox/configs/ │ ├── configs_linux_arm - ../../source/linux-5.10/arch/arm/configs/ │ └── configs_uboot - ../../source/uboot-2021.10/configs/ │ ├── tools -- 辅助脚本和工具 │── toolchain -- 编译所使用的 gcc 工具链保存目录 └── Makefile -- SDK 的顶层 Makefile1.1.2、Luban lite官方地址gitclone https://gitee.com/artinchip/luban-lite.gitgitclone gitgitee:artinchip/luban-lite.git工程结构├── application // 存放 APP 入口helloword 应用的 main 函数 │ ├── baremetal │ ├── freertos │ ├── Kconfig │ └── rt-thread ├── bsp // 存放 BSP 代码和 RT-Thread 原生的 bsp 目录功能相同 │ ├── artinchip // ArtInChip SoC 内部的 driver、hal 以及最小系统 sys 代码 │ ├── common // 公共头文件 │ ├── peripheral // 一些外设模块的驱动 │ ├── examples_bare // 各模块使用 HAL 层 API 的示例代码 │ └── examples // 各模块使用 RT-Thread 应用层 API 的示例代码 │ ├── test-alarm │ ├── test-audio │ ├── test-can │ ├── test-dma │ ├── test-qspi │ ├── test-touch │ └── test-uart ├── doc // Luban-Lite SDK 的介绍文档 ├── win_env.bat // 启动 RT-Thread 的 env 工具用于 Windows 环境的开发 ├── win_cmd.bat // 启动 CMD.exe用于 Windows 环境的开发 ├── kernel // 存放各种 RTOS 内核 │ ├── baremetal │ ├── common │ ├── freertos │ └── rt-thread ├── output // SDK 的编译输出 ├── packages // 组件包 │ ├── artinchip // ArtInChip 开发的组件包 │ └── third-party // 第三方的组件包 ├── target // 方案 板级的代码和配置 │ ├── configs // 整个方案的 SDK 配置文件 │ ├── d12x //D12x 开发板配置 │ │ ├── common │ │ ├── demo68-nand │ │ ├── demo68-nor │ │ └── hmi-nor │ ├── d13x //D13x 开发板配置 │ │ ├── common │ │ ├── demo88-nand │ │ ├── demo88-nor │ │ └── kunlunpi88-nor │ ├── d21x //D21x 开发板配置 │ │ ├── common │ │ └── demo128-nand │ └── g73x //G73x 开发板配置 │ ├── common │ ├── scan //扫码头开发板 │ └── demo100-nor ├── toolchain // 解压后的工具链存放目录 └── tools // 一些工具 ├── onestep.sh // ArtInChip 开发的 OneStep 命令行增强工具 └── toolchain // 工具链的压缩包2、自建仓库管理放到GitHubGitHub免费版对个人开发和小团队已经比较友好尤其比Gitee免费版对Git LFS支持更好。1、Luban最合理的长期维护方案GitHub Repo - 源码 GitHub Release - dl/prebuilt/toolchain1、管理架构d211/ ├── source/ ├── package/ ├── target/ ├── tools/ ├── README.md └── prepare_sdk.shGit仓库只保留这些。而大文件放到ReleaseRelease v1.0 ├── dl.tar.zst ├── prebuilt.tar.zst └── toolchain.tar.zst2、操作步骤环境工具sudoaptinstall-ygit-lfs zstd完整上传步骤打包大文件dltar--zstd-cfdl.tar.zst dlprebuilttar--zstd-cfprebuilt.tar.zst prebuilttoolchaintar--zstd-cfprebuilt.tar.zst prebuilt创建GitHub仓库并上传源码别忘记修改.gitignore# 注意修改此文件后请运行命令 git ls-files -i --exclude-standard 以检查是否有任何原本处于跟踪状态的文件在修改后被忽略了。 output/ target/d211/Config.in.old source/third-party/ source/uboot-2021.10/arch/riscv/dts/d211-ddr.dtsi source/uboot-2021.10/arch/riscv/dts/d211-ddr2-512Mb.dtsi source/uboot-2021.10/arch/riscv/dts/d211-ddr3-2Gb.dtsi source/uboot-2021.10/arch/riscv/dts/d211-pinctrl.dtsi source/uboot-2021.10/arch/riscv/dts/d211-qemu.dtsi source/uboot-2021.10/arch/riscv/dts/d211.dtsi tools/scripts/pinmux_check.pyc source/uboot-2021.10/include/dt-bindings/clock/artinchip,aic-cmu.h source/uboot-2021.10/include/dt-bindings/display/artinchip,aic-disp.h source/uboot-2021.10/include/dt-bindings/reset/artinchip,aic-reset.h dl/ dl.tar.zst prebuilt/ prebuilt.tar.zst toolchain/ toolchain.tar.zst上传gitadd.gitcommit-mfirst commitgitpush-uorigin master创建Release进入仓库点击Create a new releaseTag(Create a new Tag)v1.0.0TitleD211 SDK v1.0.0自动下载脚本prepare_sdk.sh#!/bin/bashset-eVERSIONv1.0.0BASE_URLhttps://github.com/username/artinchip-sdk-Luban/releases/download/${VERSION}download_if_missing(){FILE$1if[!-f$FILE];thenechoDownloading$FILE...wget${BASE_URL}/${FILE}fi}download_if_missing dl.tar.zst download_if_missing prebuilt.tar.zst download_if_missing toolchain.tar.zsttar--zstd-xfdl.tar.zsttar--zstd-xfprebuilt.tar.zsttar--zstd-xftoolchain.tar.zstechoSDK ready.拉取gitclone gitgithub.com:username/artinchip-sdk-Luban.gitcdartinchip-sdk-Luban ./prepare_sdk.sh2、Luban lite1、LFS安装并初始化LFSsudoaptinstallgit-lfsgitlfsinstall设置追踪规则在仓库根目录下执行以下命令让 LFS 接管该文件夹下的所有文件gitlfs tracktoolchain/**gitlfs tracktools/toolchain/**提交配置gitadd.gitattributesgitcommit-mchore: 配置指定文件夹和文件使用 Git LFS迁移历史如果大文件之前已经被提交过必须把历史记录也转换过来才可以gitlfs migrateimport--includetoolchain/**--everything2、忽略指定文件编辑.gitignore文件在项目根目录找到或新建.gitignore文件在最后添加规则*.pyc .config .config.old .defconfig .dirlist cconfig.h rtconfig.h partition_table.h .sconsign.dblite .Kconfig.prj *.bak .log/ .cscope/ output/ /toolchain/ build/ !bsp/peripheral/wireless/aic8800/build/ tools/toolchain/Xuantie-900-gcc-elf-newlib-x86_64 tools/toolchain/Xuantie-900-gcc-elf-newlib-mingw tools/env/tools/qemu/qemu-win tools/env/tools/qemu/qemu-linux packages/packages.dbsqlite packages/pkgs_error.json packages/pkgs.json .clang-format .commit .editorconfig .gitattributes /docs-user/test-app/__pycache__/ /docs-user/**/*.log /docs-user/**/*.mp4 /docs-user/**/*.png /docs-user/**/*.jpg /application/rt-thread/**/*.o清理已经被Git跟踪的文件如果这些文件之前已经被误提交了光写.gitignore是没用的需要先从Git缓存中删除gitrm-r--cacheddocs-user/test-app/__pycache__/gitrm-r--cacheddocs-user/**/*.loggitrm-r--cacheddocs-user/**/*.mp4gitrm-r--cacheddocs-user/**/*.pnggitrm-r--cacheddocs-user/**/*.jpggitrm-r--cachedapplication/rt-thread/**/*.ogitcommit-mchore: 移除被误提交的文件3、使用上传gitpush# 有过没有失败但是下载时没有拉到lfs的内容有做以下操作gitlfs push--allorigin master确认LFS状态正常gitlfsenvgitlfs ls-files重新下载时gitclone gitgithub.com:username/artinchip-sdk-LubanLite.gitcdartinchip-sdk-LubanLitegitlfs pull2、环境工具安装官方脚本的工具sudo./tools/scripts/oneclick.sh安装必要工具sudoaptinstall-ygitvimnanoscons git-lfs samba zstd3、共享文件夹目标是Linux上编译/运行Windows上编辑代码两边实时同步像本地磁盘一样访问步骤安装工具sudoaptupdatesudoaptinstallsamba-y创建共享目录mkdir-p/home/mo/my-project/project-sdkchmod777/home/mo/my-project/project-sdk配置编译sudo nano /etc/samba/smb.conf[project] path /home/mo/my-project/project-sdk/gitee/project browseable yes read only no valid users username create mask 0775 directory mask 0775创建用户sudosmbpasswd-amo开启# 开启sudosystemctl restart smbdsudosystemctlenablesmbd# 检查systemctl status smbd连接此电脑-映射网络驱动器-\\ip\project