openloongarch-buildroot-2021.02/board/loongson

下面将是广东龙芯针对buildroot做出的修改而修订的README内容

此份buildroot源码包括以下功能的修改/新增：

• 添加广东龙芯系列板卡的文件系统编译配置
• 添加对LoongArch64的架构的支持
• 添加部分源码包的编译(minigui环境支持、lvgl环境支持等)
• 添加龙芯嵌入式测试软件的包
• 添加龙芯SSD下的文件系统部署所用到的ramdisk编译支持

本源码需要在x86上的linux环境下编译 推荐编译条件为:

环境	推荐
操作系统	ubuntu 18.04
交叉编译工具链	loongarch64: toolchain-loongarch64-linux-gnu-gcc8-host-x86_64-2022-07-18 mips64el:mips64el-linux-gcc-8.x 部署于/opt下，可从资料包中获取
硬盘容量	需要预留20G或以上的空间给buildroot存放编译中间文件
运行机器	x86 机器，建议为多核，推荐在服务器上编译，个人电脑编译时间较长且占用大量空间

关于依赖环境，可以参考下面的命令进行安装，如果还是存在不能编译的情况，还请按照实际情况进行依赖环境的准备。

sudo apt -y install make git gcc g++ bison flex libncurses5-dev libssl-dev libelf-dev
sudo apt -y install cmake tree build-essential tcl-dev automake libtool

通过上述的官方说明可以清楚编译的流程是：

1. 生效要编译的配置(make XXX_defconfig)
2. make -j24 (-j24 指调用多少cpu核进行编译，根据实际的cpu核数而定，也可以只是make)
3. 前往./output/image 文件夹得到产出的文件系统进行文件

编译产出的文件为文件系统的镜像文件 可用的是rootfs.tar.gz 和 rootfs.ubi

文件	说明
rootfs.tar.gz	ssd要用的文件系统镜像
rootfs.ubi	nand要用的文件系统镜像，根据龙芯板卡的烧录规则，还需要改名为rootfs-ubifs-ze.img

关于如何定制buildroot的内容本处不再赘述，可以查看用户手册的 12.2.1.1. buildroot简述 一节，当然还推荐直接查阅官方手册。

编译产出的系统分为以下几种

系统类型	说明
全量系统	和用户手册中说的busybox系统是一个概念，集成了相当部分的软件包
小型系统	只保留部分软件包，例如可用于外围电路测试软件，网络测试软件的系统，可用于验证板卡功能
ramdisk	和广东龙芯板卡相关的SSD中系统的安装引导系统的构建 本质是一个busybox系统启动时运行安装系统的程序
快速启动系统	和全量系统一致，但是改为busybox启动，同时第一次启动之后的启动都会不启动其他服务 为了加快从内核到文件系统的速度 实测在ls2k500，如果busybox启动下，全部服务启动则需要4s，禁用服务之后，只需要1.8s 如果想恢复服务，那么请把/root/init.d-bak里面的内容复制到/etc/init.d即可

全量系统的编译配置

板卡配置名	对应适用板卡
loongson2k1000_jinlong_defconfig	ls2k1000mips版本的金龙板卡 或者其他ls2k1000mips版本的板卡 通用配置（以后可能改名）
loongson2k1000la_jinlong_defconfig	ls2k1000LA版本的金龙板卡 或者其他ls2k1000LA版本的板卡 通用配置（以后可能改名）
loongson2k500_defconfig	ls2k500的板卡 通用配置（串口2作为调试串口）
loongson2k500_mini_dp_defconfig	ls2k500的mini开发板卡 通用配置（串口2作为调试串口）

小型系统的编译配置

板卡配置名	对应适用板卡
loongson2k1000_jinlong_mini_defconfig	ls2k1000mips版本的金龙板卡 或者其他ls2k1000mips版本的板卡 小型系统通用配置（以后可能改名）
loongson2k1000la_jinlong_mini_defconfig	ls2k1000LA版本的金龙板卡 或者其他ls2k1000LA版本的板卡 小型系统通用配置（以后可能改名）
loongson2k500_mini_defconfig	ls2k500的板卡 小型系统通用配置（串口2作为调试串口）
loongson2k500_mini_dp_mini_defconfig	ls2k500的mini开发板卡 小型系统通用配置（串口2作为调试串口）

ramdisk的编译配置

板卡配置名	对应适用板卡
loongson2k1000la_jinlong_ramdisk_defconfig	ls2k1000LA版本的金龙板卡 或者其他ls2k1000LA版本的板卡 ramdisk编译通用配置（以后可能改名）
loongson2k500_ramdisk_defconfig	ls2k500的板卡 ramdisk编译通用配置（串口2作为调试串口）

快速启动系统的编译配置

板卡配置名	对应适用板卡
loongson2k1000la_jinlong_fastboot_defconfig	ls2k1000LA版本的金龙板卡 或者其他ls2k1000LA版本的板卡 快速启动系统通用配置（以后可能改名）
loongson2k500_fastboot_defconfig	ls2k500的板卡 快速启动系统通用配置（串口2作为调试串口）
loongson2k500_mini_dp_fastboot_defconfig	ls2k500的mini开发板卡 快速启动系统通用配置（串口2作为调试串口）