diff --git a/README.en.md b/README.en.md index 2b70107982758767787f89ca2702f80a600dcb92..642eb699988dc512d663325ca8ce8a2cf806b290 100644 --- a/README.en.md +++ b/README.en.md @@ -26,7 +26,7 @@ You can get introduction of openEuler RaspberryPi SIG from [sig-RaspberryPi](htt - [documents](./documents/): - [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) - [ChangeLog](documents/changelog.en.md) @@ -43,11 +43,11 @@ Basic information of the above image: - Kernel version: 4.19.90-2003.4.0.0036 - Firmware source: [firmware](https://github.com/raspberrypi/firmware), [bluez-firmware](https://github.com/RPi-Distro/bluez-firmware), [firmware-nonfree](https://github.com/RPi-Distro/firmware-nonfree) - Repository of rootfs: [openEuler-20.03-LTS](http://repo.openeuler.org/openEuler-20.03-LTS/everything/aarch64/) -- Repository inside the image: [openEuler 20.03 LTS repository](https://gitee.com/openeuler/raspberrypi/blob/master/config/openEuler-20.03-LTS.repo) +- Repository inside the image: [openEuler 20.03 LTS repository](https://gitee.com/openeuler/raspberrypi/blob/master/scripts/config/openEuler-20.03-LTS.repo) ## How to Use image -Refer to [Install openEuler on a SD card](documents/树莓派刷机.md) and [How to use Raspberry Pi](documents/树莓派使用.md) for details about how to use the image on Raspberry Pi. +Refer to [Install openEuler on a SD card](documents/刷写镜像.md) and [How to use Raspberry Pi](documents/树莓派使用.md) for details about how to use the image on Raspberry Pi. ## How to build image locally diff --git a/README.md b/README.md index bb48c6446908d0a5d24a8c2b341ff4ea7a27d0f3..cb7a5f4ec4255c33f263c2183286b1df225f290d 100644 --- a/README.md +++ b/README.md @@ -24,7 +24,7 @@ SIG 组基本信息位于 [sig-RaspberryPi](https://gitee.com/jianminw/community - [documents](./documents/): 使用文档 - [openEuler 镜像的构建](documents/openEuler镜像的构建.md) - [交叉编译内核](documents/交叉编译内核.md) - - [树莓派刷机](documents/树莓派刷机.md) + - [刷写镜像](documents/刷写镜像.md) - [树莓派使用](documents/树莓派使用.md) - [更新日志](documents/changelog.md) @@ -42,13 +42,13 @@ openEuler 20.03 LTS 的内测版本镜像，[下载](https://isrc.iscas.ac.cn/Eu - 内核版本：4.19.90-2003.4.0.0036 - 固件来源：[firmware](https://github.com/raspberrypi/firmware)、[bluez-firmware](https://github.com/RPi-Distro/bluez-firmware)、[firmware-nonfree](https://github.com/RPi-Distro/firmware-nonfree) - 构建文件系统的源仓库：[openEuler-20.03-LTS](http://repo.openeuler.org/openEuler-20.03-LTS/everything/aarch64/) -- 镜像内置源仓库：[openEuler 20.03 LTS 源仓库](https://gitee.com/openeuler/raspberrypi/blob/master/config/openEuler-20.03-LTS.repo) +- 镜像内置源仓库：[openEuler 20.03 LTS 源仓库](https://gitee.com/openeuler/raspberrypi/blob/master/scripts/config/openEuler-20.03-LTS.repo) ## 使用镜像 镜像刷写 SD 卡并使用树莓派，详见以下文档： -- [树莓派刷机](documents/树莓派刷机.md) +- [刷写镜像](documents/刷写镜像.md) - [树莓派使用](documents/树莓派使用.md) ## 镜像构建 diff --git a/documents/changelog.en.md b/documents/changelog.en.md index 819def32545d111120efd8e9021160215310e273..0cffe429a6d4c8138cea1fba7457fce8332aada1 100644 --- a/documents/changelog.en.md +++ b/documents/changelog.en.md @@ -12,7 +12,7 @@ English | [简体中文](./changelog.md) - Kernel version: 4.19.90-2003.4.0.0036 - Firmware source: [firmware](https://github.com/raspberrypi/firmware), [bluez-firmware](https://github.com/RPi-Distro/bluez-firmware), [firmware-nonfree](https://github.com/RPi-Distro/firmware-nonfree) - Repository of rootfs: [openEuler-20.03-LTS](http://repo.openeuler.org/openEuler-20.03-LTS/everything/aarch64/) -- Repository inside the image: [openEuler 20.03 LTS repository](https://gitee.com/openeuler/raspberrypi/blob/master/config/openEuler-20.03-LTS.repo) +- Repository inside the image: [openEuler 20.03 LTS repository](https://gitee.com/openeuler/raspberrypi/blob/master/scripts/config/openEuler-20.03-LTS.repo) #### Updates @@ -30,7 +30,7 @@ Start related services of bluetooth and bind Bluetooth devices by default. - Kernel version: 4.19.90-2003.4.0.0036 - Firmware source: [firmware](https://github.com/raspberrypi/firmware), [bluez-firmware](https://github.com/RPi-Distro/bluez-firmware), [firmware-nonfree](https://github.com/RPi-Distro/firmware-nonfree) - Repository of rootfs: [openEuler-20.03-LTS](http://repo.openeuler.org/openEuler-20.03-LTS/everything/aarch64/) -- Repository inside the image: [openEuler 20.03 LTS repository](https://gitee.com/openeuler/raspberrypi/blob/master/config/openEuler-20.03-LTS.repo) +- Repository inside the image: [openEuler 20.03 LTS repository](https://gitee.com/openeuler/raspberrypi/blob/master/scripts/config/openEuler-20.03-LTS.repo) #### Updates @@ -60,4 +60,4 @@ Set CONFIG_SERIAL_DEV_CTRL_TTYPORT and CONFIG_BT_HCIUART_BCM as 'y' to compile s - Kernel version: 4.19.90-2003.4.0.0036 - Firmware source: [firmware](https://github.com/raspberrypi/firmware), [bluez-firmware](https://github.com/RPi-Distro/bluez-firmware), [firmware-nonfree](https://github.com/RPi-Distro/firmware-nonfree) - Repository of rootfs: [openEuler-20.03-LTS](http://repo.openeuler.org/openEuler-20.03-LTS/everything/aarch64/) -- Repository inside the image: [openEuler 20.03 LTS repository](https://gitee.com/openeuler/raspberrypi/blob/master/config/openEuler-20.03-LTS.repo) \ No newline at end of file +- Repository inside the image: [openEuler 20.03 LTS repository](https://gitee.com/openeuler/raspberrypi/blob/master/scripts/config/openEuler-20.03-LTS.repo) \ No newline at end of file diff --git a/documents/changelog.md b/documents/changelog.md index f924d68e287d316c671b39120a63b3038deafe53..cff5c7444ed0161fcd32eab4ac0f791ba386a42b 100644 --- a/documents/changelog.md +++ b/documents/changelog.md @@ -12,7 +12,7 @@ - 内核版本：4.19.90-2003.4.0.0036 - 固件来源：[firmware](https://github.com/raspberrypi/firmware)、[bluez-firmware](https://github.com/RPi-Distro/bluez-firmware)、[firmware-nonfree](https://github.com/RPi-Distro/firmware-nonfree) - 构建文件系统的源仓库：[openEuler-20.03-LTS](http://repo.openeuler.org/openEuler-20.03-LTS/everything/aarch64/) -- 镜像内置源仓库：[openEuler 20.03 LTS 源仓库](https://gitee.com/openeuler/raspberrypi/blob/master/config/openEuler-20.03-LTS.repo) +- 镜像内置源仓库：[openEuler 20.03 LTS 源仓库](https://gitee.com/openeuler/raspberrypi/blob/master/scripts/config/openEuler-20.03-LTS.repo) #### 更新说明 @@ -30,7 +30,7 @@ - 内核版本：4.19.90-2003.4.0.0036 - 固件来源：[firmware](https://github.com/raspberrypi/firmware)、[bluez-firmware](https://github.com/RPi-Distro/bluez-firmware)、[firmware-nonfree](https://github.com/RPi-Distro/firmware-nonfree) - 构建文件系统的源仓库：[openEuler-20.03-LTS](http://repo.openeuler.org/openEuler-20.03-LTS/everything/aarch64/) -- 镜像内置源仓库：[openEuler 20.03 LTS 源仓库](https://gitee.com/openeuler/raspberrypi/blob/master/config/openEuler-20.03-LTS.repo) +- 镜像内置源仓库：[openEuler 20.03 LTS 源仓库](https://gitee.com/openeuler/raspberrypi/blob/master/scripts/config/openEuler-20.03-LTS.repo) #### 更新说明 @@ -60,4 +60,4 @@ - 内核版本：4.19.90-2003.4.0.0036 - 固件来源：[firmware](https://github.com/raspberrypi/firmware)、[bluez-firmware](https://github.com/RPi-Distro/bluez-firmware)、[firmware-nonfree](https://github.com/RPi-Distro/firmware-nonfree) - 构建文件系统的源仓库：[openEuler-20.03-LTS](http://repo.openeuler.org/openEuler-20.03-LTS/everything/aarch64/) -- 镜像内置源仓库：[openEuler 20.03 LTS 源仓库](https://gitee.com/openeuler/raspberrypi/blob/master/config/openEuler-20.03-LTS.repo) \ No newline at end of file +- 镜像内置源仓库：[openEuler 20.03 LTS 源仓库](https://gitee.com/openeuler/raspberrypi/blob/master/scripts/config/openEuler-20.03-LTS.repo) \ No newline at end of file diff --git "a/documents/images/GPIO\351\222\210\350\204\232.png" "b/documents/images/GPIO\351\222\210\350\204\232.png" new file mode 100644 index 0000000000000000000000000000000000000000..24238cc23d89f18fca2bc5daa5e3f62abc4c4390 Binary files /dev/null and "b/documents/images/GPIO\351\222\210\350\204\232.png" differ diff --git "a/documents/images/UART\350\277\236\346\216\245.png" "b/documents/images/UART\350\277\236\346\216\245.png" new file mode 100644 index 0000000000000000000000000000000000000000..22c85494d6fab9b8223a50af8f278c988519e0a1 Binary files /dev/null and "b/documents/images/UART\350\277\236\346\216\245.png" differ diff --git "a/documents/images/UART\350\277\236\346\216\245PC.png" "b/documents/images/UART\350\277\236\346\216\245PC.png" new file mode 100644 index 0000000000000000000000000000000000000000..59698f1858af01a9a33ab930990bb34c86fc12a8 Binary files /dev/null and "b/documents/images/UART\350\277\236\346\216\245PC.png" differ diff --git "a/documents/images/\344\270\262\345\217\243\350\276\223\345\207\272.jpg" "b/documents/images/\344\270\262\345\217\243\350\276\223\345\207\272.jpg" new file mode 100644 index 0000000000000000000000000000000000000000..7d92539445fc36c83fd1f75c9c858fe22fb2f400 Binary files /dev/null and "b/documents/images/\344\270\262\345\217\243\350\276\223\345\207\272.jpg" differ diff --git "a/documents/images/\345\210\206\345\214\272\346\211\251\345\256\271.jpg" "b/documents/images/\345\210\206\345\214\272\346\211\251\345\256\271.jpg" index c80c16ad1ccce9b2d62c97cc9176a1ab55128ef6..a21a70aca08d2d6535b4af35d4869468718b831c 100644 Binary files "a/documents/images/\345\210\206\345\214\272\346\211\251\345\256\271.jpg" and "b/documents/images/\345\210\206\345\214\272\346\211\251\345\256\271.jpg" differ diff --git "a/documents/images/\347\231\273\345\275\225\346\240\221\350\216\223\346\264\276.jpg" "b/documents/images/\347\231\273\345\275\225\346\240\221\350\216\223\346\264\276.jpg" index 2d69a11243600972a833cdd42153f9b8b4d71d4a..26cfc716449353128998013b59827538e27a030f 100644 Binary files "a/documents/images/\347\231\273\345\275\225\346\240\221\350\216\223\346\264\276.jpg" and "b/documents/images/\347\231\273\345\275\225\346\240\221\350\216\223\346\264\276.jpg" differ diff --git "a/documents/images/\351\252\214\350\257\201\345\206\205\346\240\270.jpg" "b/documents/images/\351\252\214\350\257\201\345\206\205\346\240\270.jpg" index 5c16305c7b5b55a3bdebd21409f58dd0f13913a9..80a78e39b389a77357d4771d4c21de7afb332c0b 100644 Binary files "a/documents/images/\351\252\214\350\257\201\345\206\205\346\240\270.jpg" and "b/documents/images/\351\252\214\350\257\201\345\206\205\346\240\270.jpg" differ 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 c1dfe4873862185ff828325ed7458f250868a5ab..7364c7c694cfd16844f8f170fc0d30f15453ef58 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" @@ -1,3 +1,61 @@ + + +- [环境需求](#环境需求) +- [树莓派相关](#树莓派相关) + - [编译内核](#编译内核) + - [准备环境](#准备环境) + - [下载源码](#下载源码) + - [进入内核目录](#进入内核目录) + - [切换分支](#切换分支) + - [载入默认配置](#载入默认配置) + - [编译](#编译) + - [创建编译内核模块目录](#创建编译内核模块目录) + - [编译内核模块](#编译内核模块) + - [收集编译结果](#收集编译结果) + - [配置引导](#配置引导) + - [下载引导](#下载引导) + - [进入引导目录](#进入引导目录) + - [删除没有必要的文件](#删除没有必要的文件) + - [添加cmdline.txt](#添加cmdlinetxt) + - [boot 内容完善](#boot-内容完善) + - [将内核放进引导](#将内核放进引导) + - [将设备树文件放进引导](#将设备树文件放进引导) + - [树莓派固件和应用](#树莓派固件和应用) + - [下载固件和应用](#下载固件和应用) +- [制作 openEuler 的 rootfs](#制作-openeuler-的-rootfs) + - [创建 RPM 数据库](#创建-rpm-数据库) + - [下载安装 openEuler 发布包](#下载安装-openeuler-发布包) + - [安装 yum](#安装-yum) + - [添加 yum 源](#添加-yum-源) + - [安装 dnf](#安装-dnf) + - [安装必要软件](#安装必要软件) + - [添加配置文件](#添加配置文件) + - [添加 hosts](#添加-hosts) + - [网络相关](#网络相关) + - [rootfs 内容完善](#rootfs-内容完善) + - [将固件放进 rootfs](#将固件放进-rootfs) + - [将内核模块放进rootfs](#将内核模块放进rootfs) + - [rootfs设置](#rootfs设置) +- [制作镜像](#制作镜像) + - [生成镜像并分区挂载](#生成镜像并分区挂载) + - [计算镜像大小](#计算镜像大小) + - [创建空镜像](#创建空镜像) + - [使用 losetup 将磁盘镜像文件虚拟成块设备](#使用-losetup-将磁盘镜像文件虚拟成块设备) + - [使用 kpartx 创建分区表 /dev/loop0 的设备映射](#使用-kpartx-创建分区表-devloop0-的设备映射) + - [格式化分区](#格式化分区) + - [创建要挂载的根目录和 boot 分区路径](#创建要挂载的根目录和-boot-分区路径) + - [挂载根目录和 boot 分区](#挂载根目录和-boot-分区) + - [获取生成的 img 镜像的 blkid](#获取生成的-img-镜像的-blkid) + - [修改 fstab](#修改-fstab) + - [rootfs 拷贝到镜像](#rootfs-拷贝到镜像) + - [boot 引导拷贝到镜像](#boot-引导拷贝到镜像) + - [卸载镜像](#卸载镜像) + - [同步到盘](#同步到盘) + - [卸载](#卸载) + - [卸载镜像文件虚拟的块设备](#卸载镜像文件虚拟的块设备) + + + # 环境需求 - 操作系统：openEuler 或 Centos 7/8； @@ -22,7 +80,7 @@ - 操作系统：openEuler 或 Centos 7/8 - 架构：AArch64 -除了使用 AArch64 架构的运行环境，也可以采用交叉编译的方式编译内核，文档详见 [交叉编译内核](./交叉编译内核.md)。这里，我们在 AArch64 架构的服务器上编译内核。 +除了使用 AArch64 架构的 openEuler 或 Centos 7/8 运行环境，也可以采用交叉编译的方式编译内核，文档详见 [交叉编译内核](./交叉编译内核.md)。这里，我们在 AArch64 架构的服务器上编译内核。 ### 下载源码 @@ -36,9 +94,9 @@ ### 切换分支 -这里适用于树莓派的 openEuler-1.0-LTS 内核源码的分支有两个。其中，master 分支为开发分支，openEuler-1.0-LTS-raspi 为稳定分支。根据需要选择对应分支，下载源码后默认为 master 分支，如果需要选择 openEuler-1.0-LTS-raspi 分支，执行下面的命令： +这里适用于树莓派的 openEuler-20.03-LTS-raspi 内核源码的分支有两个。其中，master 分支为开发分支，openEuler-20.03-LTS-raspi 为稳定分支。根据需要选择对应分支，下载源码后默认为 master 分支，如果需要选择 openEuler-20.03-LTS-raspi 分支，执行下面的命令： -`git checkout -b openEuler-1.0-LTS-raspi origin/openEuler-1.0-LTS-raspi` +`git checkout -b openEuler-20.03-LTS-raspi origin/openEuler-20.03-LTS-raspi` 下面编译时可能还需要 bison、flex、build-essential 等，根据提示安装即可。 @@ -117,7 +175,7 @@ `cp ${WORKDIR}/output/overlays/* ${WORKDIR}/firmware/boot/overlays/` -## 树莓派固件 +## 树莓派固件和应用 ### 下载固件和应用 @@ -343,7 +401,7 @@ mv ${WORKDIR}/rootfs/lib/firmware/BCM4345C0.hcd ${WORKDIR}/rootfs/lib/firmware/b 其中 `SIZE` 为前面计算得到的计算镜像大小，最终生成空的镜像文件 ${WORKDIR}/openEuler_raspi.img。 -### 使用 losetup 将磁盘镜像文件虚拟成快设备 +### 使用 losetup 将磁盘镜像文件虚拟成块设备 `losetup -f --show openEuler_raspi.img` @@ -442,7 +500,7 @@ UUID=a451bee4-4384-48a2-8d5a-d09c2dd9a1a swap swap defaults,noatime 0 0 `umount ${WORKDIR}/boot` -### 卸载 loop0 挂载 +### 卸载镜像文件虚拟的块设备 `kpartx -d /dev/loop0` @@ -450,4 +508,4 @@ UUID=a451bee4-4384-48a2-8d5a-d09c2dd9a1a swap swap defaults,noatime 0 0 这样，最终就生成了需要的 openEuler_raspi.img 镜像文件。 -之后就可以使用镜像刷写 SD 卡并使用树莓派了，详见 [树莓派刷机](./树莓派刷机.md) 和 [树莓派使用](./树莓派使用.md)。 \ No newline at end of file +之后就可以使用镜像刷写 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 e58300aa8c4c24527ba380f94a24df24e8fba610..b0e8499113078fb0fe74fb3e84f5cbb7d7889272 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" @@ -1,3 +1,27 @@ + + +- [介绍](#介绍) +- [实验环境](#实验环境) +- [安装依赖软件](#安装依赖软件) +- [编译](#编译) + - [下载内核源码](#下载内核源码) + - [进入内核源码](#进入内核源码) + - [切换分支](#切换分支) + - [设置环境变量](#设置环境变量) + - [载入默认配置](#载入默认配置) + - [编译内核](#编译内核) + - [创建编译内核模块目录](#创建编译内核模块目录) + - [编译内核模块](#编译内核模块) + - [收集编译结果](#收集编译结果) + - [内核](#内核) + - [设备树文件等](#设备树文件等) +- [验证内核可用性](#验证内核可用性) + - [将内核模块放进rootfs](#将内核模块放进rootfs) + - [将内核放进引导](#将内核放进引导) + - [将设备树文件放进引导](#将设备树文件放进引导) + + + # 介绍 目前 openEuler 树莓派版本只支持 AArch64 架构。 @@ -29,9 +53,9 @@ ## 切换分支 -这里适用于树莓派的 openEuler-1.0-LTS 内核源码的分支有两个。其中，master 分支为 开发分支，openEuler-1.0-LTS-raspi 为稳定分支。根据需要选择对应分支，下载源码后默认为 master 分支，如果需要选择 openEuler-1.0-LTS-raspi 分支，执行下面的命令： +这里适用于树莓派的 openEuler-20.03-LTS-raspi 内核源码的分支有两个。其中，master 分支为 开发分支，openEuler-20.03-LTS-raspi 为稳定分支。根据需要选择对应分支，下载源码后默认为 master 分支，如果需要选择 openEuler-20.03-LTS-raspi 分支，执行下面的命令： -`git checkout -b openEuler-1.0-LTS-raspi origin/openEuler-1.0-LTS-raspi` +`git checkout -b openEuler-20.03-LTS-raspi origin/openEuler-20.03-LTS-raspi` ## 设置环境变量 @@ -76,19 +100,19 @@ 至此，所有内核及内核模块相关内容都在 ${WORKDIR}/output 下了。 -## 验证内核可用性 +# 验证内核可用性 使用一个之前刷好 openEuler 树莓派镜像的 SD 卡，直接插到 Linux 主机上，SD 会默认挂载其 boot 分区和 根目录分区。这里其挂载路径分别表示为 ${boot} 和 ${rootfs}，将上面编译好的内核放置到SD卡对应分区。 -### 将内核模块放进rootfs +## 将内核模块放进rootfs `cp -r ${WORKDIR}/output/lib/modules ${rootfs}/lib/` -### 将内核放进引导 +## 将内核放进引导 `cp ${WORKDIR}/output/Image ${boot}/kernel8.img` -### 将设备树文件放进引导 +## 将设备树文件放进引导 `cp ${WORKDIR}/output/*.dtb ${boot}/` diff --git "a/documents/\346\240\221\350\216\223\346\264\276\345\210\267\346\234\272.md" "b/documents/\345\210\267\345\206\231\351\225\234\345\203\217.md" similarity index 57% rename from "documents/\346\240\221\350\216\223\346\264\276\345\210\267\346\234\272.md" rename to "documents/\345\210\267\345\206\231\351\225\234\345\203\217.md" index 1e98624293e5b6fee33ef0808b5b0ee26bff38c0..3f82d0754681a1a5802550eab24c89e6507d56ea 100644 --- "a/documents/\346\240\221\350\216\223\346\264\276\345\210\267\346\234\272.md" +++ "b/documents/\345\210\267\345\206\231\351\225\234\345\203\217.md" @@ -1,23 +1,40 @@ -# 树莓派刷机 - -## 实验环境 + + +- [实验环境](#实验环境) +- [获取树莓派 img 镜像](#获取树莓派-img-镜像) +- [刷写 SD 卡](#刷写-sd-卡) + - [Windows 环境](#windows-环境) + - [格式化 SD 卡](#格式化-sd-卡) + - [写入 SD 卡](#写入-sd-卡) + - [Linux 环境](#linux-环境) + - [查看磁盘分区信息](#查看磁盘分区信息) + - [卸载 SD 卡挂载点](#卸载-sd-卡挂载点) + - [写入 SD 卡](#写入-sd-卡-1) + - [Mac 环境](#mac-环境) + - [查看磁盘分区信息](#查看磁盘分区信息-1) + - [卸载 SD 卡挂载点](#卸载-sd-卡挂载点-1) + - [写入 SD 卡](#写入-sd-卡-2) +- [树莓派使用](#树莓派使用) + + + +# 实验环境 - Windows10/Linux/Mac - 树莓派 3B/3B+/4B - 16G 以上的 Micro SD 卡 - -## 获取树莓派 img 镜像 +# 获取树莓派 img 镜像 下载适配树莓派的最新 openEuler 镜像，下面以 `XXX.img` 表示该镜像。 -## 刷机操作 +# 刷写 SD 卡 下面分别介绍 Windows、Linux、Mac 下的刷机步骤。 -### Windows 环境 +## Windows 环境 -#### 格式化 SD 卡 +### 格式化 SD 卡 下载应用：SDFormater，用于格式化 SD 卡。 @@ -33,10 +50,11 @@ ![](images/格式化后盘.jpg) -#### 写入 SD 卡 +### 写入 SD 卡 -- 下载应用：Win32 Disk Imager。 -- 右键选择“以管理员身份运行”，打开 Win32 Disk Imager，选择镜像 img 文件和待写入的 SD 卡，点击【写入/Write】。 +下载应用：Win32 Disk Imager。 + +右键选择“以管理员身份运行”，打开 Win32 Disk Imager，选择镜像 img 文件和待写入的 SD 卡，点击【写入/Write】。 ![](images/写入SD.jpg) @@ -46,16 +64,15 @@ ![](images/盘符.jpg) +## Linux 环境 -### Linux 环境 - -#### 查看磁盘分区信息 +### 查看磁盘分区信息 `fdisk -l` 获取 SD 卡磁盘信息，例如 SD 卡对应磁盘为 /dev/sdb。 -#### 卸载 SD 卡挂载点 +### 卸载 SD 卡挂载点 查看当前已挂在的卷 @@ -68,22 +85,21 @@ `umount /dev/sdb3` -#### 写入 SD 卡 +### 写入 SD 卡 将下载的镜像 `XXX.img` 刷入 SD 卡。 - `dd bs=4M if=XXX.img of=/dev/sdb` -### Mac 环境 +## Mac 环境 -#### 查看磁盘分区信息 +### 查看磁盘分区信息 `diskutil list` 获取 SD 卡磁盘信息，例如 SD 卡对应磁盘为 /dev/disk3。 -#### 卸载 SD 卡挂载点 +### 卸载 SD 卡挂载点 查看当前已挂在的卷 @@ -96,14 +112,12 @@ `diskutil umount /dev/sdb3` -#### 写入 SD 卡 +### 写入 SD 卡 将下载的镜像 `XXX.img` 刷入 SD 卡。 - `dd bs=4m if=XXX.img of=/dev/sdb` - -## 树莓派使用 +# 树莓派使用 SD 卡刷好镜像之后，就可以使用树莓派了，详见 [树莓派使用](./树莓派使用.md)。 \ No newline at end of file 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 fa14e7cf7b2624c35cfc1e216b8175761bcca091..c87d6107f026f160bb51960f612bbca4d2d40900 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" @@ -1,3 +1,76 @@ + + +- [启用树莓派](#启用树莓派) +- [根目录分区扩展](#根目录分区扩展) + - [查看磁盘分区信息](#查看磁盘分区信息) + - [分区扩容](#分区扩容) + - [操作磁盘 /dev/mmcblk0](#操作磁盘-devmmcblk0) + - [查看当前分区情况](#查看当前分区情况) + - [删除分区 /dev/mmcblk0p3](#删除分区-devmmcblk0p3) + - [选择要删除的分区序号](#选择要删除的分区序号) + - [创建新的分区](#创建新的分区) + - [选择创建分区类型](#选择创建分区类型) + - [选择要创建的分区序号](#选择要创建的分区序号) + - [输入新分区的起始扇区号](#输入新分区的起始扇区号) + - [输入新分区的终止扇区号](#输入新分区的终止扇区号) + - [是否修改扇区标记](#是否修改扇区标记) + - [保存并退出](#保存并退出) + - [增大未加载的文件系统大小](#增大未加载的文件系统大小) +- [wifi 连接](#wifi-连接) + - [查看 IP 和网卡信息](#查看-ip-和网卡信息) + - [扫描可以连接的 wifi 信息](#扫描可以连接的-wifi-信息) + - [连接 wifi](#连接-wifi) + - [查看 IP 和无线网卡信息](#查看-ip-和无线网卡信息) +- [音频](#音频) + - [开启音频](#开启音频) + - [安装音频播放软件](#安装音频播放软件) + - [播放音频](#播放音频) + - [音频输出配置](#音频输出配置) + - [HDMI](#hdmi) + - [耳机插孔](#耳机插孔) + - [自动（默认）](#自动默认) +- [蓝牙](#蓝牙) + - [开启蓝牙](#开启蓝牙) + - [查看蓝牙设备](#查看蓝牙设备) + - [连接蓝牙](#连接蓝牙) + - [进入交互命令](#进入交互命令) + - [开启控制器电源](#开启控制器电源) + - [启用代理](#启用代理) + - [设置代理为默认代理](#设置代理为默认代理) + - [扫描](#扫描) + - [配对](#配对) + - [添加信任](#添加信任) + - [连接](#连接) + - [播放音乐](#播放音乐) + - [文件传输](#文件传输) + - [下载软件 obexftp](#下载软件-obexftp) + - [安装 obexftp](#安装-obexftp) + - [查看文件传输的 channel](#查看文件传输的-channel) + - [传输文件](#传输文件) +- [GPIO](#gpio) + - [简介](#简介) + - [UART](#uart) + - [UART 连线](#uart-连线) + - [串口通信](#串口通信) + - [蓝牙使用 PL011 UART，禁用串口](#蓝牙使用-pl011-uart禁用串口) + - [蓝牙使用 PL011 UART，串口使用 mini UART](#蓝牙使用-pl011-uart串口使用-mini-uart) + - [编辑配置文件](#编辑配置文件) + - [设置 hciuart 服务开机启动（默认已设置）](#设置-hciuart-服务开机启动默认已设置) + - [重启树莓派](#重启树莓派) + - [查看结果](#查看结果) + - [禁用蓝牙，串口使用 PL011 UART](#禁用蓝牙串口使用-pl011-uart) + - [编辑配置文件](#编辑配置文件-1) + - [取消 hciuart 服务开机启动](#取消-hciuart-服务开机启动) + - [重启树莓派](#重启树莓派-1) + - [查看结果](#查看结果-1) + - [蓝牙使用 mini UART，串口使用 PL011 UART](#蓝牙使用-mini-uart串口使用-pl011-uart) + - [编辑配置文件](#编辑配置文件-2) + - [设置 hciuart 服务开机启动（默认已设置）](#设置-hciuart-服务开机启动默认已设置-1) + - [重启树莓派](#重启树莓派-2) + - [查看结果](#查看结果-2) + + + # 启用树莓派 版本要求：树莓派 3B/3B+/4B。 @@ -10,16 +83,22 @@ 有以下两种方式： -1. 如果树莓派连接已知路由器，可登录路由器管理，新增的 IP 即为树莓派 IP： - -![](images/获取IP.jpg) +1. 本地登录 -2. 将树莓派连接显示器，需注意，树莓派视频输出接口为 Micro HDMI +将树莓派连接显示器（树莓派视频输出接口为 Micro HDMI）、键盘、鼠标后，启动树莓派，可以看到树莓派启动日志输出到显示器上。待树莓派启动成功，输入用户名（root）和密码（openeuler）登录。目前，openEuler 系统无桌面环境，添加桌面支持相关进度可关注 [期望增加桌面支持](https://gitee.com/openeuler/raspberrypi/issues/I1F21F)，欢迎大家参与。 -连接显示器后，直接用户名/密码登录，登录成功后，树莓派即显示本机相关信息，包括本机 IP。如下图（ssh 登录也显示这些信息）： +登录成功后，树莓派即显示本机相关信息，包括本机 IP。如下图（下面 ssh 远程登录也显示这些信息）： ![](images/登录树莓派.jpg) +2. ssh 远程登录 + +如果树莓派连接已知路由器，可登录路由器管理，新增的 IP 即为树莓派 IP： + +![](images/获取IP.jpg) + +从上图看到，树莓派对应 IP 为：192.168.1.102，使用命令 `ssh root@192.168.1.102` 后输入密码 `openeuler`，即可远程登录树莓派。 + # 根目录分区扩展 默认根目录分区空间比较小，在使用之前，需要对分区进行扩容。 @@ -98,7 +177,6 @@ `resize2fs /dev/mmcblk0p3` - 如果该命令失败，可通过命令 `reboot` 重启树莓派之后再执行 `resize2fs /dev/mmcblk0p3`。 该操作结束后，通过 `df -lh` 可以看到根目录大小已经扩展。 @@ -136,7 +214,7 @@ `nmcli dev wifi` -## 连 接wifi +## 连接 wifi `nmcli dev wifi connect SSID password PWD` @@ -195,10 +273,11 @@ dtparam=audio=on dnf install mpg123 ``` -### 播放音频 +## 播放音频 + `mpg123 xxx.mp3` -### 音频输出配置 +## 音频输出配置 详细信息可参考[树莓派官方文档](https://www.raspberrypi.org/documentation/)，如：[audio-config](https://www.raspberrypi.org/documentation/configuration/audio-config.md)。 @@ -208,15 +287,15 @@ dnf install mpg123 可以通过输入命令将音频输出切换到对应模式。 -#### HDMI +### HDMI `amixer cset numid=3 2` -#### 耳机插孔 +### 耳机插孔 `amixer cset numid=3 1` -#### 自动（默认） +### 自动（默认） `amixer cset numid=3 0` @@ -303,6 +382,8 @@ pulseaudio --start ### 下载软件 obexftp +需要下载三个包：lib64obexftp、lib64openobex、obexftp，可在 [地址](https://rpmfind.net/linux/mageia/distrib/cauldron/aarch64/media/core/release/) 下载其最新版本。以我们下载时对应版本为例： + ``` wget https://rpmfind.net/linux/mageia/distrib/cauldron/aarch64/media/core/release/lib64obexftp0-0.24-17.mga8.aarch64.rpm wget https://rpmfind.net/linux/mageia/distrib/cauldron/aarch64/media/core/release/lib64openobex1-1.7.2-3.mga8.aarch64.rpm @@ -316,9 +397,7 @@ rpm -i lib64openobex1-1.7.2-3.mga8.aarch64.rpm rpm -i obexftp-0.24-17.mga8.aarch64.rpm ``` -### 文件传输 - -#### 查看文件传输的 channel +### 查看文件传输的 channel `sdptool browse target-MAC` @@ -357,10 +436,172 @@ Profile Descriptor List: ``` 看到其中 `Service Name: OBEX Object Push` 下的 ` Channel: 12`。 -#### 传输文件 + +### 传输文件 文件路径记为 `file-path`。 `obexftp -b target-MAC -B 12 -U NONE -p file-path` -之后就可以在`target-MAC` 对应的设备上选择接收文件，进行文件传输。 \ No newline at end of file +之后就可以在`target-MAC` 对应的设备上选择接收文件，进行文件传输。 + +# GPIO + +## 简介 + +树莓派的一个强大特性是沿着板的上边缘有一排 GPIO（通用输入/输出）管脚。在所有当前的树莓派板上都可以找到一个 40 针 GPIO 引脚（在树莓派 Zero 和 Pi Zero W 上未填充）。在树莓派 1B+（2014年）之前，电路板包含较短的 26 针引脚。以树莓派 4B 为例，其 40 针脚见下图： + +![](images/GPIO针脚.png) + +GPIO 是个比较重要的概念。用户可以通过 GPIO 口和硬件进行数据交互（如 UART），控制硬件工作（如 LED、蜂鸣器等），读取硬件的工作状态信号（如中断信号）等。GPIO 口的使用非常广泛。举例来说，40 个针脚中，有固定输出的 5V（2、4号PIN）、3.3V（1、17号PIN）和地线（Ground，6、9、14、20、25、30、34、39）。如果一个电路两端接在 5V 和地线之间，该电路就会获得 5V 的电压输入，相当于给树莓派通电，注意此时就不可以再通过树莓派提供的电源同时通电。有一些针脚除了 GPIO 功能外，还提供了高级端口功能。例如，GPIO14 和 GPIO15 就可以充当 UART 端口。下面，我们以使用 UART（GPIO14 和 GPIO15）进行串口通信为例介绍如何使用树莓派 GPIO。 + +## UART + +通用异步收发传输器（Universal Asynchronous Receiver/Transmitter)，通常称作 UART，是一种串行通信协议，其中数据是串行传输的，一次传输一个字节的数据，即逐位传输。作为把并行输入信号转成串行输出信号的芯片，UART 通常被集成于其他通讯接口的连结上。 + +树莓派有两个内置 UART。一个是硬件串口（PL011 UART，可以独立调整串口的速率和模式），在操作系统中对应文件 /dev/ttyAMA0；一个是迷你串口（mini UART），在操作系统中对应文件 /dev/ttyS0。在树莓派 2B/2B+ 等这些老版的树莓派上，PL011 UART 作为主 UART 用于 Linux 控制台，可用于外部的 UART 通信，因此可以独立调整串口的速率和模式；而在树莓派 Zero W、树莓派 3 及 3 以上版本，PL011 UART 作为辅助 UART 分配给了新增的板载蓝牙模块，mini UART 作为主 UART 用于 Linux 控制台进行串口通信。这里提到的主 UART 是分配给 Linux 控制台的 UART，在操作系统中对应文件 /dev/serial0（如果启用）；另一个 UART 则被称为辅助 UART，在操作系统中对应文件/dev/serial1（如果启用）。 + +mini UART 没有时钟源，必须由内核提供时钟参考源，它使用与 GPU 核心频率相关的频率。因此，随着 GPU 核心频率的变化，mini UART 的频率也会发生变化，从而改变 UART 的波特率。这使得 mini UART 不稳定，可能导致数据丢失或损坏。要使 mini UART 稳定，需要修复核心频率。此外，mini UART 没有奇偶校验支持。而 PL011 UART 是一款稳定的高性能 UART，比 mini UART 更高的吞吐量。因此，虽然 mini UART 也可以用于串口通信或者板载蓝牙，我们建议选择树莓派的 PL011 UART。 + +下面以树莓派 4B 为例，介绍不同配置下的串口通信以及板载蓝牙的使用情况。 + +### UART 连线 + +为了和树莓派串口通信，我们将树莓派的 UART 针脚连接到个人电脑（下面简称 PC）上。 + +UART 的端口至少有 RX、TX 和地线三个针脚。RX 负责读取，TX 负责输出。如果有两个 UART 端口，它们的连接方式如下： + +![](images/UART连接.png) + +在树莓派 4B 等设备中，TX 和 RX 就是 GPIO14 和 GPIO15 针脚。因此，我们把树莓派的针脚和外接设备（这里，我们使用 PC）按照上图的方式连接起来，就可以实现在树莓派和外接设备之间的串口通信。 + +一般的 PC 都没有暴露在外的 UART 针脚。为了通过 UART 来连接树莓派和 PC，需要一个 USB 和 UART 的转换器。这个转换器的一端是 USB 接口，插入 PC 的 USB 口；另一端是 UART 的针脚，可以按照 上图的方式连接到树莓派的 UART 针脚。连线示意图如下： + +![](images/UART连接PC.png) + +注意！！！如果你连接树莓派 UART 针脚所使用的杜邦线不止有三个接口，不要连接树莓派的 5V 或 3.3V 的针脚。如果一个电路两端接在 5V 和地线之间，该电路就会获得 5V 的电压输入，相当于给树莓派通电。此时，如果同时接通树莓派电源设备，会烧坏树莓派！ + +连接好之后，就可以实现树莓派和 PC 通信。Windows 中可以利用串口通信的图形化软件来和树莓派进行串口通信。注意，根据树莓派配置文件 boot/config.txt 中形如 `console=serial0,115200` 的配置项，串口通信的图形化软件中选择对应串口的波特率应设置为 115200。 + +### 串口通信 + +由于树莓派 4B 中，默认情况下，PL011 UART 分配给了新增的板载蓝牙模块，mini UART 用于 Linux 控制台进行串口通信。为了实现串口通信，我们可以使用 mini UART，也可以占用 PL011 UART。如果串口通信占用 PL011 UART，板载蓝牙就需要禁用或者使用 mini UART。 + +注意树莓派的配置文件 /boot/config.txt 中 `enable_uart` 这个配置项。`enable_uart` 的默认值取决于 UART 的实际角色。如果将 ttyAMA0 分配给蓝牙模块（默认），则 `enable_uart` 默认为 0，即不启用 GPIO 串口；如果将 mini UART 分配给蓝牙模块（`dtoverlay=pi3-miniuart-bt`），则 `enable_uart` 默认值为 1，即启用 GPIO 串口（使用 PL011 UART）；如果禁用蓝牙（`dtoverlay=pi3-disable-bt`），则默认将 ttyAMA0 分配给串口通信模块（使用 PL011 UART）。 + +下面我们总结一下不同情况下的配置。 + +#### 蓝牙使用 PL011 UART，禁用串口 + +默认情况下，PL011 UART 作为辅助 UART 分配给了新增的板载蓝牙模块，在操作系统中对应文件 /dev/ttyAMA0（/dev/serial1）；mini UART 作为主 UART 分配给 Linux 控制台进行串口通信，该配置由 `enable_uart` 决定，默认为 0，表示不启用，即默认禁用串口通信。 + +命令 `ls -l /dev/serial*`，可以看到如下信息： + +``` +lrwxrwxrwx 1 root root 7 Sep 3 2019 /dev/serial1 -> ttyAMA0 +``` + +#### 蓝牙使用 PL011 UART，串口使用 mini UART + +PL011 UART 作为辅助 UART 分配给新增的板载蓝牙模块，在操作系统中对应文件 /dev/ttyAMA0（/dev/serial1）；mini UART 作为主 UART 分配给 Linux 控制台进行串口通信，在操作系统中对应文件 /dev/ttyS0（/dev/serial0）。 + +##### 编辑配置文件 + +`vim /boot/config.txt` + +添加： + +``` +enable_uart=1 +``` + +该配置项会同时将核心频率固定到 250MHz，无需设置 core_freq。 + +##### 设置 hciuart 服务开机启动（默认已设置） + +`systemctl enable hciuart` + +##### 重启树莓派 + +`reboot` + +##### 查看结果 + +命令 `ls -l /dev/serial*`，可以看到如下信息： + +``` +lrwxrwxrwx 1 root root 5 Sep 3 2019 /dev/serial0 -> ttyS0 +lrwxrwxrwx 1 root root 7 Sep 3 2019 /dev/serial1 -> ttyAMA0 +``` + +在 PC 的串口通信图形化软件上，可以看到树莓派的开机日志以及树莓派上通过命令 `echo "hello" > /dev/serial0` 向串口输出的信息。见下图： + +![](images/串口输出.jpg) + +#### 禁用蓝牙，串口使用 PL011 UART + +PL011 UART 作为主 UART 分配给 Linux 控制台用于串口通信，在操作系统中对应文件 /dev/ttyAMA0（/dev/serial0）。 + +##### 编辑配置文件 + +`vim /boot/config.txt` + +添加： + +``` +dtoverlay=pi3-disable-bt +``` + +##### 取消 hciuart 服务开机启动 + +`systemctl disable hciuart` + +否则, hciuart 服务会默认开机启动，且启动失败。 + +##### 重启树莓派 + +`reboot` + +##### 查看结果 + +命令 `ls -l /dev/serial*`，可以看到如下信息： +``` +lrwxrwxrwx 1 root root 7 Sep 3 2019 /dev/serial0 -> ttyAMA0 +lrwxrwxrwx 1 root root 5 Sep 3 2019 /dev/serial1 -> ttyS0 +``` + +在 PC 的串口通信图形化软件上，可以看到树莓派的开机日志以及树莓派上通过命令 `echo "hello" > /dev/serial0` 向串口输出的信息。 + +#### 蓝牙使用 mini UART，串口使用 PL011 UART + +PL011 UART 作为主 UART 分配给 Linux 控制台用于串口通信，在操作系统中对应文件 /dev/ttyAMA0（/dev/serial0）；mini UART 作为辅助 UART 分配给新增的板载蓝牙模块，在操作系统中对应文件 /dev/ttyS0（/dev/serial1）。 + +##### 编辑配置文件 +`vim /boot/config.txt` + +添加： + +``` +core_freq=250 +dtoverlay=pi3-miniuart-bt +``` + +注意，这里需要设置 core_freq=250。 + +##### 设置 hciuart 服务开机启动（默认已设置） + +`systemctl enable hciuart` + +##### 重启树莓派 + +`reboot` + +##### 查看结果 + +命令 `ls -l /dev/serial*`，可以看到如下信息： +``` +lrwxrwxrwx 1 root root 7 Sep 3 2019 /dev/serial0 -> ttyAMA0 +lrwxrwxrwx 1 root root 5 Sep 3 2019 /dev/serial1 -> ttyS0 +``` + +在 PC 的串口通信图形化软件上，可以看到树莓派的开机日志以及树莓派上通过命令 `echo "hello" > /dev/serial0` 向串口输出的信息。 \ No newline at end of file diff --git a/scripts/build-img.sh b/scripts/build-img.sh index 4498ffdc480243329185ec132294e69d79c655fa..eeaf36a8aa316a833003bbd631482aadef4a64d7 100644 --- a/scripts/build-img.sh +++ b/scripts/build-img.sh @@ -449,7 +449,7 @@ make_img(){ pushd ${boot_mnt}/ rm -f *.dtb cmdline.txt kernel.img kernel7.img kernel7l.img cp ${cur_dir}/config/config.txt ./ - echo "console=ttyAMA0,115200 console=tty1 root=/dev/mmcblk0p3 rootfstype=ext4 elevator=deadline rootwait" > cmdline.txt + echo "console=serial0,115200 console=tty1 root=/dev/mmcblk0p3 rootfstype=ext4 elevator=deadline rootwait" > cmdline.txt popd cp --preserve=mode,timestamps --no-preserve=ownership ${output_dir}/Image ${boot_mnt}/kernel8.img cp --preserve=mode,timestamps --no-preserve=ownership ${output_dir}/*.dtb ${boot_mnt}/ diff --git a/scripts/config/openEuler-20.03-LTS.repo b/scripts/config/openEuler-20.03-LTS.repo index 558c4c09ca6ccbb1afd59881220a86fd669a771b..04032b76a3cf6871d75b30952a13be9415d93dbd 100644 --- a/scripts/config/openEuler-20.03-LTS.repo +++ b/scripts/config/openEuler-20.03-LTS.repo @@ -1,17 +1,17 @@ -[basiclocal] -name=basiclocal +[openEuler] +name=openEuler 20.03 LTS baseurl=http://repo.openeuler.org/openEuler-20.03-LTS/OS/aarch64/ enabled=1 gpgcheck=0 -[srclocal] -name=srclocal +[openEuler-source] +name=openEuler 20.03 LTS - Source baseurl=http://repo.openeuler.org/openEuler-20.03-LTS/source/ enabled=1 gpgcheck=0 -[everythinglocal] -name=everythinglocal +[openEuler-everything] +name=openEuler 20.03 LTS - Everything baseurl=http://repo.openeuler.org/openEuler-20.03-LTS/everything/aarch64/ enabled=1 gpgcheck=0 \ No newline at end of file