提交 c2c1e34b 编写于 作者: Y yafen

排版格式调整

上级 af739a7a
...@@ -6,6 +6,7 @@ This repository provides scripts for building openEuler image for Raspberry Pi a ...@@ -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) * [Script for building openEuler image for Raspberry Pi](build_img.sh)
* [Building openEuler image for Raspberry Pi](documents/openEuler镜像的构建.md) * [Building openEuler image for Raspberry Pi](documents/openEuler镜像的构建.md)
* [Cross-compile the kernel](documents/交叉编译内核.md)
* [Install openEuler on a SD card](documents/树莓派刷机.md) * [Install openEuler on a SD card](documents/树莓派刷机.md)
* [How to use Raspberry Pi](documents/树莓派使用.md) * [How to use Raspberry Pi](documents/树莓派使用.md)
......
...@@ -2,10 +2,11 @@ ...@@ -2,10 +2,11 @@
#### 介绍 #### 介绍
本仓库提供适用于树莓派的openEuler镜像的构建脚本和相关文档: 本仓库提供适用于树莓派的 openEuler 镜像的构建脚本和相关文档:
* [适用于树莓派的openEuler镜像构建脚本](build_img.sh) * [适用于树莓派的 openEuler 镜像构建脚本](build_img.sh)
* [openEuler镜像的构建](documents/openEuler镜像的构建.md) * [openEuler 镜像的构建](documents/openEuler镜像的构建.md)
* [交叉编译内核](documents/交叉编译内核.md)
* [树莓派刷机](documents/树莓派刷机.md) * [树莓派刷机](documents/树莓派刷机.md)
* [树莓派使用](documents/树莓派使用.md) * [树莓派使用](documents/树莓派使用.md)
...@@ -23,9 +24,9 @@ ...@@ -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. 使用脚本默认参数构建 1. 使用脚本默认参数构建
...@@ -41,13 +42,13 @@ ...@@ -41,13 +42,13 @@
其中,各个参数意义: 其中,各个参数意义:
- KERNEL_URL:内核源码的项目地址,默认为`git@gitee.com:openeuler/raspberrypi-kernel.git` - KERNEL_URL:内核源码的项目地址,默认为 `git@gitee.com:openeuler/raspberrypi-kernel.git`
- KERNEL_BRANCH:内核源码的对应分支,默认为`openEuler-1.0-LTS-raspi` - KERNEL_BRANCH:内核源码的对应分支,默认为 `openEuler-1.0-LTS-raspi`
- KERNEL_DEFCONFIG:内核编译使用的配置文件名称,默认为`openeuler-raspi_defconfig`,在本目录的 config 目录下或内核源码的目录 arch/arm64/configs 下。如果该文件不存在则使用配置文件 DEFAULT_DEFCONFIG。 - KERNEL_DEFCONFIG:内核编译使用的配置文件名称,默认为 `openeuler-raspi_defconfig`,在本目录的 config 目录下或内核源码的目录 arch/arm64/configs 下。如果该文件不存在则使用配置文件 DEFAULT_DEFCONFIG。
- DEFAULT_DEFCONFIG:内核默认配置文件名称,默认为`openeuler-raspi_defconfig`,在内核源码的目录 arch/arm64/configs 下。如果 KERNEL_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 文件夹下。 - REPO_FILE:openEuler 开发源的 repo 文件的 URL 或者文件名称, 默认为 `openEuler-20.03-LTS.repo`。注意,如果 REPO_FILE 为文件名称,需要保证该文件在脚本 build_img.sh 所在目录的 config 文件夹下。
- --cores:其后跟参数 MAKE_CORES。 - --cores:其后跟参数 MAKE_CORES。
- MAKE_CORES:并行编译的数量,根据运行脚本的服务器CPU实际数目设定,默认为18。 - MAKE_CORES:并行编译的数量,根据运行脚本的服务器CPU实际数目设定,默认为 18。
#### 镜像使用 #### 镜像使用
......
...@@ -2,8 +2,8 @@ ...@@ -2,8 +2,8 @@
- 操作系统:openEuler 或 Centos 7/8; - 操作系统:openEuler 或 Centos 7/8;
- 架构:AArch64; - 架构:AArch64;
- 硬盘存储不低于50G; - 硬盘存储不低于 50G;
- 内存不低于2G; - 内存不低于 2G;
- 可访问外网。 - 可访问外网。
可以通过以下方式获取 AArch64 架构的运行环境: 可以通过以下方式获取 AArch64 架构的运行环境:
...@@ -28,7 +28,7 @@ ...@@ -28,7 +28,7 @@
`git clone git@gitee.com:openeuler/raspberrypi-kernel.git` `git clone git@gitee.com:openeuler/raspberrypi-kernel.git`
得到文件${WORKDIR}/raspberrypi-kernel。 得到文件 ${WORKDIR}/raspberrypi-kernel。
### 进入内核目录 ### 进入内核目录
...@@ -36,7 +36,7 @@ ...@@ -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` `git checkout -b openEuler-1.0-LTS-raspi origin/openEuler-1.0-LTS-raspi`
...@@ -313,7 +313,7 @@ DEVICE=eth0 ...@@ -313,7 +313,7 @@ DEVICE=eth0
`du -sh --block-size=1MiB ${WORKDIR}/rootfs` `du -sh --block-size=1MiB ${WORKDIR}/rootfs`
`du -sh --block-size=1MiB ${WORKDIR}/firmware/boot` `du -sh --block-size=1MiB ${WORKDIR}/firmware/boot`
得到总大小略加1100MiB即可,将该大小记为 SIZE 得到总大小略加 1100MiB 即可,将该大小记为 `SIZE`
### 创建空镜像 ### 创建空镜像
...@@ -321,7 +321,7 @@ DEVICE=eth0 ...@@ -321,7 +321,7 @@ DEVICE=eth0
`dd if=/dev/zero of=openEuler_raspi.img bs=1M count=SIZE` `dd if=/dev/zero of=openEuler_raspi.img bs=1M count=SIZE`
其中 SIZE 为前面计算得到的计算镜像大小,最终生成空的镜像文件 ${WORKDIR}/openEuler_raspi.img。 其中 `SIZE` 为前面计算得到的计算镜像大小,最终生成空的镜像文件 ${WORKDIR}/openEuler_raspi.img。
### 使用 losetup 将磁盘镜像文件虚拟成快设备 ### 使用 losetup 将磁盘镜像文件虚拟成快设备
...@@ -340,7 +340,7 @@ add map loop0p2 ... ...@@ -340,7 +340,7 @@ add map loop0p2 ...
add map loop0p3 ... 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 /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 ...@@ -428,6 +428,6 @@ UUID=a451bee4-4384-48a2-8d5a-d09c2dd9a1a swap swap defaults,noatime 0 0
`losetup -d /dev/loop0` `losetup -d /dev/loop0`
这样,最终就生成了需要的openEuler_raspi.img镜像文件。 这样,最终就生成了需要的 openEuler_raspi.img 镜像文件。
之后就可以使用镜像刷写 SD 卡并使用树莓派了,详见 [树莓派刷机](./树莓派刷机.md)[树莓派使用](./树莓派使用.md) 之后就可以使用镜像刷写 SD 卡并使用树莓派了,详见 [树莓派刷机](./树莓派刷机.md)[树莓派使用](./树莓派使用.md)
\ No newline at end of file
...@@ -21,7 +21,7 @@ ...@@ -21,7 +21,7 @@
`git clone git@gitee.com:openeuler/raspberrypi-kernel.git` `git clone git@gitee.com:openeuler/raspberrypi-kernel.git`
得到文件${WORKDIR}/raspberrypi-kernel。 得到文件 ${WORKDIR}/raspberrypi-kernel。
## 进入内核源码 ## 进入内核源码
......
...@@ -10,13 +10,13 @@ ...@@ -10,13 +10,13 @@
有以下两种方式: 有以下两种方式:
1. 如果树莓派连接已知路由器,可登陆路由器管理,新增的IP即为树莓派IP: 1. 如果树莓派连接已知路由器,可登录路由器管理,新增的 IP 即为树莓派 IP:
![](images/获取IP.jpg) ![](images/获取IP.jpg)
2. 将树莓派连接显示器,需注意,树莓派视频输出接口为 Micro HDMI 2. 将树莓派连接显示器,需注意,树莓派视频输出接口为 Micro HDMI
连接显示器后,直接用户名/密码登陆,登陆成功后,树莓派即显示本机相关信息,包括本机 IP。如下图(ssh登陆也显示这些信息): 连接显示器后,直接用户名/密码登录,登录成功后,树莓派即显示本机相关信息,包括本机 IP。如下图(ssh 登录也显示这些信息):
![](images/登录树莓派.jpg) ![](images/登录树莓派.jpg)
...@@ -29,7 +29,7 @@ ...@@ -29,7 +29,7 @@
`fdisk -l` `fdisk -l`
获取 SD 卡磁盘信息,例如 SD 卡对应磁盘为 /dev/mmcblk0。openEuler 镜像包括3个分区,分别为 获取 SD 卡磁盘信息,例如 SD 卡对应磁盘为 /dev/mmcblk0。openEuler 镜像包括 3 个分区,分别为
- 引导分区 /dev/mmcblk0p1 - 引导分区 /dev/mmcblk0p1
- 交换分区 /dev/mmcblk0p2 - 交换分区 /dev/mmcblk0p2
...@@ -55,7 +55,7 @@ ...@@ -55,7 +55,7 @@
### 选择要删除的分区序号 ### 选择要删除的分区序号
回车(默认为3)或 输入`3` 回车(默认为 3)或 输入 `3`
### 创建新的分区 ### 创建新的分区
...@@ -63,11 +63,11 @@ ...@@ -63,11 +63,11 @@
### 选择创建分区类型 ### 选择创建分区类型
回车(默认为 p)或 输入`p` 回车(默认为 p)或 输入 `p`
### 选择要创建的分区序号 ### 选择要创建的分区序号
回车(默认为3)或 输入`3` 回车(默认为 3)或 输入 `3`
### 输入新分区的起始扇区号 ### 输入新分区的起始扇区号
...@@ -91,16 +91,16 @@ ...@@ -91,16 +91,16 @@
`wq` `wq`
该操作结束后,使用 `fdisk -l` 命令可以看到 /dev/mmcblk0p3大小已经扩展。但是通过 `df -lh`可以看到根目录大小没有变化。 该操作结束后,使用 `fdisk -l` 命令可以看到 /dev/mmcblk0p3 大小已经扩展。但是通过 `df -lh` 可以看到根目录大小没有变化。
### 增大未加载的文件系统大小 ### 增大未加载的文件系统大小
`resize2fs /dev/mmcblk0p3` `resize2fs /dev/mmcblk0p3`
如果该命令失败,可通过命令 `reboot`重启树莓派之后再执行`resize2fs /dev/mmcblk0p3` 如果该命令失败,可通过命令 `reboot` 重启树莓派之后再执行 `resize2fs /dev/mmcblk0p3`
该操作结束后,通过 `df -lh`可以看到根目录大小已经扩展。 该操作结束后,通过 `df -lh` 可以看到根目录大小已经扩展。
至此,根目录分区扩容结束。扩容过程见下图: 至此,根目录分区扩容结束。扩容过程见下图:
......
...@@ -9,7 +9,7 @@ ...@@ -9,7 +9,7 @@
## 获取树莓派 img 镜像 ## 获取树莓派 img 镜像
下载适配树莓派的最新openEuler镜像,下面以XXX.img表示该镜像。 下载适配树莓派的最新 openEuler 镜像,下面以 `XXX.img` 表示该镜像。
## 刷机操作 ## 刷机操作
...@@ -46,7 +46,6 @@ ...@@ -46,7 +46,6 @@
![](images/盘符.jpg) ![](images/盘符.jpg)
使用时的系统大小为 boot 盘的大小,根据使用需求,可用 gparted 工具为 boot 盘扩容。
### Linux 环境 ### Linux 环境
...@@ -71,7 +70,7 @@ ...@@ -71,7 +70,7 @@
#### 写入 SD 卡 #### 写入 SD 卡
将下载的镜像 XXX.img 刷入 SD 卡。 将下载的镜像 `XXX.img` 刷入 SD 卡。
`dd bs=4M if=XXX.img of=/dev/sdb` `dd bs=4M if=XXX.img of=/dev/sdb`
...@@ -99,7 +98,7 @@ ...@@ -99,7 +98,7 @@
#### 写入 SD 卡 #### 写入 SD 卡
将下载的镜像 XXX.img 刷入 SD 卡。 将下载的镜像 `XXX.img` 刷入 SD 卡。
`dd bs=4m if=XXX.img of=/dev/sdb` `dd bs=4m if=XXX.img of=/dev/sdb`
......
Markdown is supported
0% .
You are about to add 0 people to the discussion. Proceed with caution.
先完成此消息的编辑!
想要评论请 注册