diff --git a/README.en.md b/README.en.md index 608d0986f92402f77b961c8a17208671c9f6a7f3..63fe04c3dd86d27a0d8493459ac155b99958e57d 100644 --- a/README.en.md +++ b/README.en.md @@ -6,6 +6,7 @@ This repository provides scripts for building openEuler image for Raspberry Pi a * [Script for building openEuler image for Raspberry Pi](build_img.sh) * [Building openEuler image for Raspberry Pi](documents/openEuler镜像的构建.md) +* [Cross-compile the kernel](documents/交叉编译内核.md) * [Install openEuler on a SD card](documents/树莓派刷机.md) * [How to use Raspberry Pi](documents/树莓派使用.md) diff --git a/README.md b/README.md index 92afd32268e3f743662bcbf684779f843c13146d..14bbff290ed3a9a4792f741c8e0f6059b97f61ca 100644 --- a/README.md +++ b/README.md @@ -2,10 +2,11 @@ #### 介绍 -本仓库提供适用于树莓派的openEuler镜像的构建脚本和相关文档： +本仓库提供适用于树莓派的 openEuler 镜像的构建脚本和相关文档： -* [适用于树莓派的openEuler镜像构建脚本](build_img.sh) -* [openEuler镜像的构建](documents/openEuler镜像的构建.md) +* [适用于树莓派的 openEuler 镜像构建脚本](build_img.sh) +* [openEuler 镜像的构建](documents/openEuler镜像的构建.md) +* [交叉编译内核](documents/交叉编译内核.md) * [树莓派刷机](documents/树莓派刷机.md) * [树莓派使用](documents/树莓派使用.md) @@ -23,9 +24,9 @@ ##### 构建镜像 -详细过程参见 [openEuler镜像的构建](documents/openEuler镜像的构建.md)。 +详细过程参见 [openEuler 镜像的构建](documents/openEuler镜像的构建.md)。 -构建脚本 build_img.sh，其后可设置0/5/7个参数。 +构建脚本 build_img.sh，其后可设置 0/5/7 个参数。 1. 使用脚本默认参数构建 @@ -41,13 +42,13 @@ 其中，各个参数意义： -- KERNEL_URL：内核源码的项目地址，默认为`git@gitee.com:openeuler/raspberrypi-kernel.git`。 -- KERNEL_BRANCH：内核源码的对应分支，默认为`openEuler-1.0-LTS-raspi`。 -- KERNEL_DEFCONFIG：内核编译使用的配置文件名称，默认为`openeuler-raspi_defconfig`，在本目录的 config 目录下或内核源码的目录 arch/arm64/configs 下。如果该文件不存在则使用配置文件 DEFAULT_DEFCONFIG。 -- DEFAULT_DEFCONFIG：内核默认配置文件名称，默认为`openeuler-raspi_defconfig`，在内核源码的目录 arch/arm64/configs 下。如果 KERNEL_DEFCONFIG 和该文件均不存在则退出镜像构建过程。 -- REPO_FILE：openEuler 开发源的 repo 文件的 URL 或者文件名称， 默认为`openEuler-20.03-LTS.repo`。注意，如果 REPO_FILE 为文件名称，需要保证该文件在脚本 build_img.sh 所在目录的 config 文件夹下。 +- KERNEL_URL：内核源码的项目地址，默认为 `git@gitee.com:openeuler/raspberrypi-kernel.git`。 +- KERNEL_BRANCH：内核源码的对应分支，默认为 `openEuler-1.0-LTS-raspi`。 +- KERNEL_DEFCONFIG：内核编译使用的配置文件名称，默认为 `openeuler-raspi_defconfig`，在本目录的 config 目录下或内核源码的目录 arch/arm64/configs 下。如果该文件不存在则使用配置文件 DEFAULT_DEFCONFIG。 +- DEFAULT_DEFCONFIG：内核默认配置文件名称，默认为 `openeuler-raspi_defconfig`，在内核源码的目录 arch/arm64/configs 下。如果 KERNEL_DEFCONFIG 和该文件均不存在则退出镜像构建过程。 +- REPO_FILE：openEuler 开发源的 repo 文件的 URL 或者文件名称， 默认为 `openEuler-20.03-LTS.repo`。注意，如果 REPO_FILE 为文件名称，需要保证该文件在脚本 build_img.sh 所在目录的 config 文件夹下。 - --cores：其后跟参数 MAKE_CORES。 -- MAKE_CORES：并行编译的数量，根据运行脚本的服务器CPU实际数目设定，默认为18。 +- MAKE_CORES：并行编译的数量，根据运行脚本的服务器CPU实际数目设定，默认为 18。 #### 镜像使用 diff --git "a/documents/openEuler\351\225\234\345\203\217\347\232\204\346\236\204\345\273\272.md" "b/documents/openEuler\351\225\234\345\203\217\347\232\204\346\236\204\345\273\272.md" index 4a05ba61b7ea72fbc2d19f605de814353c55caae..cccaa096babe5f95d1169a68c6d6a62806ed37eb 100644 --- "a/documents/openEuler\351\225\234\345\203\217\347\232\204\346\236\204\345\273\272.md" +++ "b/documents/openEuler\351\225\234\345\203\217\347\232\204\346\236\204\345\273\272.md" @@ -2,8 +2,8 @@ - 操作系统：openEuler 或 Centos 7/8； - 架构：AArch64； -- 硬盘存储不低于50G； -- 内存不低于2G； +- 硬盘存储不低于 50G； +- 内存不低于 2G； - 可访问外网。 可以通过以下方式获取 AArch64 架构的运行环境： @@ -28,7 +28,7 @@ `git clone git@gitee.com:openeuler/raspberrypi-kernel.git` -得到文件${WORKDIR}/raspberrypi-kernel。 +得到文件 ${WORKDIR}/raspberrypi-kernel。 ### 进入内核目录 @@ -36,7 +36,7 @@ ### 切换分支 -这里适用于树莓派的 openEuler-1.0-LTS 内核源码的分支为 openEuler-1.0-LTS-raspi， +这里适用于树莓派的 openEuler-1.0-LTS 内核源码的分支为 openEuler-1.0-LTS-raspi。 `git checkout -b openEuler-1.0-LTS-raspi origin/openEuler-1.0-LTS-raspi` @@ -313,7 +313,7 @@ DEVICE=eth0 `du -sh --block-size=1MiB ${WORKDIR}/rootfs` `du -sh --block-size=1MiB ${WORKDIR}/firmware/boot` -得到总大小略加1100MiB即可，将该大小记为 SIZE。 +得到总大小略加 1100MiB 即可，将该大小记为 `SIZE`。 ### 创建空镜像 @@ -321,7 +321,7 @@ DEVICE=eth0 `dd if=/dev/zero of=openEuler_raspi.img bs=1M count=SIZE` -其中 SIZE 为前面计算得到的计算镜像大小，最终生成空的镜像文件 ${WORKDIR}/openEuler_raspi.img。 +其中 `SIZE` 为前面计算得到的计算镜像大小，最终生成空的镜像文件 ${WORKDIR}/openEuler_raspi.img。 ### 使用 losetup 将磁盘镜像文件虚拟成快设备 @@ -340,7 +340,7 @@ add map loop0p2 ... add map loop0p3 ... ``` -运行`ls /dev/mapper/loop0p*`可以看到分区分别对应刚才为openEuler_raspi.img做的三个分区： +运行 `ls /dev/mapper/loop0p*` 可以看到分区分别对应刚才为 openEuler_raspi.img 做的三个分区： ``` /dev/mapper/loop0p1 /dev/mapper/loop0p2 /dev/mapper/loop0p3 @@ -428,6 +428,6 @@ UUID=a451bee4-4384-48a2-8d5a-d09c2dd9a1a swap swap defaults,noatime 0 0 `losetup -d /dev/loop0` -这样，最终就生成了需要的openEuler_raspi.img镜像文件。 +这样，最终就生成了需要的 openEuler_raspi.img 镜像文件。 之后就可以使用镜像刷写 SD 卡并使用树莓派了，详见 [树莓派刷机](./树莓派刷机.md) 和 [树莓派使用](./树莓派使用.md)。 \ No newline at end of file diff --git "a/documents/\344\272\244\345\217\211\347\274\226\350\257\221\345\206\205\346\240\270.md" "b/documents/\344\272\244\345\217\211\347\274\226\350\257\221\345\206\205\346\240\270.md" index 5285f2b96e81d318e59c4887281b507b16dcf830..8c95c06abe35d28c978dcef38e1b422ea64cb286 100644 --- "a/documents/\344\272\244\345\217\211\347\274\226\350\257\221\345\206\205\346\240\270.md" +++ "b/documents/\344\272\244\345\217\211\347\274\226\350\257\221\345\206\205\346\240\270.md" @@ -21,7 +21,7 @@ `git clone git@gitee.com:openeuler/raspberrypi-kernel.git` -得到文件${WORKDIR}/raspberrypi-kernel。 +得到文件 ${WORKDIR}/raspberrypi-kernel。 ## 进入内核源码 diff --git "a/documents/\346\240\221\350\216\223\346\264\276\344\275\277\347\224\250.md" "b/documents/\346\240\221\350\216\223\346\264\276\344\275\277\347\224\250.md" index b23d6ff67e6bfa83c93f6ff42274a5e02de4ccce..00b2c6c2de92b321c519f5e1b8114e9eddebd52a 100644 --- "a/documents/\346\240\221\350\216\223\346\264\276\344\275\277\347\224\250.md" +++ "b/documents/\346\240\221\350\216\223\346\264\276\344\275\277\347\224\250.md" @@ -10,13 +10,13 @@ 有以下两种方式： -1. 如果树莓派连接已知路由器，可登陆路由器管理，新增的IP即为树莓派IP： +1. 如果树莓派连接已知路由器，可登录路由器管理，新增的 IP 即为树莓派 IP： ![](images/获取IP.jpg) 2. 将树莓派连接显示器，需注意，树莓派视频输出接口为 Micro HDMI -连接显示器后，直接用户名/密码登陆，登陆成功后，树莓派即显示本机相关信息，包括本机 IP。如下图（ssh登陆也显示这些信息）： +连接显示器后，直接用户名/密码登录，登录成功后，树莓派即显示本机相关信息，包括本机 IP。如下图（ssh 登录也显示这些信息）： ![](images/登录树莓派.jpg) @@ -29,7 +29,7 @@ `fdisk -l` -获取 SD 卡磁盘信息，例如 SD 卡对应磁盘为 /dev/mmcblk0。openEuler 镜像包括3个分区，分别为 +获取 SD 卡磁盘信息，例如 SD 卡对应磁盘为 /dev/mmcblk0。openEuler 镜像包括 3 个分区，分别为 - 引导分区 /dev/mmcblk0p1 - 交换分区 /dev/mmcblk0p2 @@ -55,7 +55,7 @@ ### 选择要删除的分区序号 -回车（默认为3）或 输入`3` +回车（默认为 3）或 输入 `3` ### 创建新的分区 @@ -63,11 +63,11 @@ ### 选择创建分区类型 -回车（默认为 p）或 输入`p` +回车（默认为 p）或 输入 `p` ### 选择要创建的分区序号 -回车（默认为3）或 输入`3` +回车（默认为 3）或 输入 `3` ### 输入新分区的起始扇区号 @@ -91,16 +91,16 @@ `wq` -该操作结束后，使用 `fdisk -l` 命令可以看到 /dev/mmcblk0p3大小已经扩展。但是通过 `df -lh`可以看到根目录大小没有变化。 +该操作结束后，使用 `fdisk -l` 命令可以看到 /dev/mmcblk0p3 大小已经扩展。但是通过 `df -lh` 可以看到根目录大小没有变化。 ### 增大未加载的文件系统大小 `resize2fs /dev/mmcblk0p3` -如果该命令失败，可通过命令 `reboot`重启树莓派之后再执行`resize2fs /dev/mmcblk0p3`。 +如果该命令失败，可通过命令 `reboot` 重启树莓派之后再执行 `resize2fs /dev/mmcblk0p3`。 -该操作结束后，通过 `df -lh`可以看到根目录大小已经扩展。 +该操作结束后，通过 `df -lh` 可以看到根目录大小已经扩展。 至此，根目录分区扩容结束。扩容过程见下图： diff --git "a/documents/\346\240\221\350\216\223\346\264\276\345\210\267\346\234\272.md" "b/documents/\346\240\221\350\216\223\346\264\276\345\210\267\346\234\272.md" index 2218ea5b50d3b9e166e8188c2ce1d6864baabc41..1e98624293e5b6fee33ef0808b5b0ee26bff38c0 100644 --- "a/documents/\346\240\221\350\216\223\346\264\276\345\210\267\346\234\272.md" +++ "b/documents/\346\240\221\350\216\223\346\264\276\345\210\267\346\234\272.md" @@ -9,7 +9,7 @@ ## 获取树莓派 img 镜像 -下载适配树莓派的最新openEuler镜像，下面以XXX.img表示该镜像。 +下载适配树莓派的最新 openEuler 镜像，下面以 `XXX.img` 表示该镜像。 ## 刷机操作 @@ -46,7 +46,6 @@ ![](images/盘符.jpg) -使用时的系统大小为 boot 盘的大小，根据使用需求，可用 gparted 工具为 boot 盘扩容。 ### Linux 环境 @@ -71,7 +70,7 @@ #### 写入 SD 卡 -将下载的镜像 XXX.img 刷入 SD 卡。 +将下载的镜像 `XXX.img` 刷入 SD 卡。 `dd bs=4M if=XXX.img of=/dev/sdb` @@ -99,7 +98,7 @@ #### 写入 SD 卡 -将下载的镜像 XXX.img 刷入 SD 卡。 +将下载的镜像 `XXX.img` 刷入 SD 卡。 `dd bs=4m if=XXX.img of=/dev/sdb`