From 6f802653d0a4bfcec7c4f075d60f595d69fa98cf Mon Sep 17 00:00:00 2001
From: guowenxue <guowenxue@gmail.com>
Date: Mon, 24 Jul 2023 20:36:15 +0800
Subject: [PATCH] Update README.md
---
README.md | 204 ++++++++++++++++++++++++++++++++++++++++++++++++++
1 files changed, 203 insertions(+), 1 deletions(-)
diff --git a/README.md b/README.md
index 1e1b9e8..af4082d 100644
--- a/README.md
+++ b/README.md
@@ -1,4 +1,206 @@
-## bsp-imx
+# 1. 编译系统介绍
+从实验室 git 仓库下载相应版本的 BSP(Board Support Package) 文件.
+
+```
+guowenxue@ubuntu22:~$ git clone -b lf-5.15.71-2.2.0 http://guowenxue@main.iot-yun.club:8088/r/bsp-imx.git igkboard-imx6ull
+
+guowenxue@ubuntu22:~$ cd igkboard-imx6ull && ls
+bootloader config.json images kernel tools yocto
+```
+
+
+
+下面是这些文件的说明.
+
+```
+guowenxue@ubuntu22:~/igkboard-imx6ull$ tree
+.
+├── bootloader Bootloader源码编译的工作目录
+│ ├── build.sh Bootloader的一键编译脚本
+│ └── patches Bootloader补丁文件存放目录
+│ ├── gen_patch.sh 生成补丁文件的Shell脚本
+│ └── igkboard-6ull IGKBoard-6ULL开发板补丁文件存放目录
+├── config.json 编译系统配置文件
+├── images 制作系统镜像的工作目录
+│ └── build.sh 系统镜像一键编译脚本
+├── kernel Linux内核源码编译的工作目录
+│ ├── build.sh Linux内核源码的一键编译脚本
+│ └── patches Linux内核补丁文件存放目录
+│ ├── gen_patch.sh 生成补丁文件的Shell脚本
+│ └── igkboard-6ull IGKBoard-6ULL开发板补丁文件存放目录
+├── tools 编译系统工具脚本存放目录
+ ├── imgmnt 挂载系统镜像的工具脚本
+ └── setup_tools.sh 编译环境安装的脚本
+```
+
+
+
+本系统在Ubuntu 22.04上测试通过。
+
+```
+guowenxue@ubuntu22:~$ lsb_release -a
+No LSB modules are available.
+Distributor ID: Ubuntu
+Description: Ubuntu 22.04.2 LTS
+Release: 22.04
+Codename: jammy
+```
+
+
+
+# 2. BSP源码编译
+
+
+
+## 2.1 编译环境安装
+
+
+
+进入到 tools 目录下，并以 sudo 权限运行该脚本，它将会自动安装编译BSP源码所需要的系统软件和交叉编译器。
+
+```
+guowenxue@ubuntu22:~/igkboard-imx6ull$ cd tools/
+guowenxue@ubuntu22:~/igkboard-imx6ull/tools$ sudo ./setup_tools.sh
+
+ --I-- start apt install system tools(commands)
+... ...
+ --I-- start apt install devlopment tools(commands)
+... ...
+ --I-- start download AArch32 cross compiler from ARM Developer
+... ...
+ --I-- AArch32 cross compiler installed to "/opt/gcc-aarch32-10.3-2021.07" successfully
+... ...
+ --I-- start download buildroot cross compiler from LingYun IoT studio file server
+... ...
+ --I-- Buildroot cross compiler installed to "/opt/buildroot//gcc-10.4-aarch32-v2023.02/" successfully
+```
+
+
+
+
+
+## 2.2 修改配置文件
+
+
+
+根据自己的开发板和实际需求，修改下面的开发板、BSP版本以及系统镜像的相关配置。
+
+```
+guowenxue@ubuntu22:~/igkboard-imx6ull$ vim config.json
+{
+ "bsp":
+ {
+ "board":"IGKBoard-6ULL",
+ "version":"lf-5.15.71-2.2.0",
+ "download":"http://main.iot-yun.club:2211/imx/",
+ "crosstool":"/opt/gcc-aarch32-10.3-2021.07/bin/arm-none-linux-gnueabihf-"
+ },
+ "system":
+ {
+ "distro":"yocto",
+ "version":"kirkstone",
+ "imgsize":"2048",
+ "bootsize":"100"
+ }
+}
+```
+
+
+
+下面是配置文件中 **bsp配置选项** 的说明，该选项将影响 BSP 源码的编译：
+
+* **board** 指定目标开发板，当前支持 ***igkboard-6ull 和 igkboard-8mp***;
+* **version** 指定编译的BSP版本，如 ***lf-5.15.71-2.2.0***。具体支持哪些版本，请使用 **`git branch -r`**查看；
+* **download** 指定BSP源码压缩包或其他相关文件的下载服务器；
+* **crosstool** 指定Bootloader和Linux内核的交叉编译器，前面的编译环境搭建中已安装；
+
+
+
+下面是配置文件中 **system配置选项** 的说明，该选项将影响烧到eMMC/TF卡上的系统镜像文件。
+
+* **distro** 指定Linux系统发行版本，当前支持 ***buildroot、yocto 和 debian***;
+* **version** 指定相应发行版本的版本，具体支持见下表；
+* **imgsize** 指定制作生成的系统镜像大小；
+* **bootsize** 指定生成的系统镜像的BOOT(FAT32)分区大小；
+
+
+
+下面是当前各发行版本支持的版本：
+
+| 发行版本(distro) | 版本号(version) |
+| ---------------- | ------------------------------ |
+| yocto | hardknott、honister、kirkstone |
+| buildroot | v2023.02 |
+| debian | |
+
+
+
+## 3.3 编译Bootloader
+
+
+
+到 **bootloader** 文件夹下执行 ***build.sh*** 脚本，它将会自动下载源码文件、打补丁、编译，并将编译生成的相关文件拷贝到 **install** 文件夹下。
+
+```
+guowenxue@ubuntu22:~/igkboard-imx6ull$ cd bootloader/
+guowenxue@ubuntu22:~/igkboard-imx6ull/bootloader$ ls
+build.sh patches
+
+guowenxue@ubuntu22:~/igkboard-imx6ull/bootloader$ ./build.sh
+ start build bootloader for igkboard-6ull
+ start fetch uboot-imx source code
+ ... ...
+bootloader installed to '/home/guowenxue/igkboard-imx6ull/bootloader/install'
+u-boot-igkboard-6ull.imx
+```
+
+
+
+## 3.4 编译Linux内核
+
+
+
+到 **kernel** 文件夹下执行 ***build.sh*** 脚本，它将会自动下载源码文件、打补丁、编译，并将编译生成的相关文件拷贝到 **install** 文件夹下。
+
+```
+guowenxue@ubuntu22:~/igkboard-imx6ull$ cd kernel/
+guowenxue@ubuntu22:~/igkboard-imx6ull/kernel$ ls
+build.sh patches
+
+guowenxue@ubuntu22:~/igkboard-imx6ull/kernel$ ./build.sh
+ start build linux kernel for igkboard-6ull
+ start fetch linux-imx source code
+ ... ...
+linux kernel installed to '/home/guowenxue/igkboard-imx6ull/kernel/install'
+igkboard-6ull.dtb lib overlays zImage
+```
+
+
+
+## 3.5 制作系统镜像
+
+
+
+到 **images** 文件夹下执行 ***build.sh*** 脚本，它将会自动下载相应发行版本的根文件系统源码，并将编译生成的镜像文件拷贝到 **install** 文件夹下。需要注意的是，该脚本必须以 root 权限来执行。
+
+```
+guowenxue@ubuntu22:~/igkboard-imx6ull$ cd images/
+guowenxue@ubuntu22:~/igkboard-imx6ull/images$ ls
+build.sh
+
+guowenxue@ubuntu22:~/igkboard-imx6ull/images$ sudo ./build.sh
+ start build yocto-kirkstone for igkboard-6ull
+ start fetch rootfs-yocto-kirkstone source code
+... ...
+system images installed to '/home/guowenxue/igkboard-imx6ull/images/install'
+igkboard-6ull-yocto-kirkstone-lf-5.15.71-2.2.0.img u-boot-igkboard-6ull.imx
+... ...
+```
+
+
+
+# 3. Yocto源码编译
+
--
Gitblit v1.9.1