Skip to content

Commit

Permalink
raspberry-pi/installation:fixed document
Browse files Browse the repository at this point in the history
  • Loading branch information
model-err authored and MingcongBai committed Feb 6, 2025
1 parent 6b732f2 commit 7637e83
Show file tree
Hide file tree
Showing 6 changed files with 28 additions and 887 deletions.
25 changes: 6 additions & 19 deletions content/aosc-os/devices/raspberrypi/4b/installation.md
Original file line number Diff line number Diff line change
Expand Up @@ -28,7 +28,11 @@ Technically all Raspberry Pis equipped with an ARM64 CPU are compatible with mai
- Raspberry Pi 3th gen boards (BCM2837A0/B0)
- Raspberry Pi 3/3B/3B+
- Compute Module 3
- Some BCM2837 based Raspberry Pi 2 boards (2B Rev1.2)

# Known Problems

- Hardware decoding is not working on 64-bit systems, see [here](https://github.com/raspberrypi/userland/blob/9f3f9054a692e53b60fca54221a402414e030335/CMakeLists.txt#L11) and [here](https://www.raspberrypi.org/forums/viewtopic.php?t=232684&start=25)
- The `raspi-config` tool previously available in the AOSC package repository came from [cyanberry-config](https://github.com/AOSC-Archive/cyanberry-config). This project is now archived and no longer recommended to use.

# In this tutorial

Expand Down Expand Up @@ -192,30 +196,13 @@ Then proceed with the [general post installation process][general-postinst] to s
BSP Installation
--------

To get your Pi running, a set of BSPs (Board Support Packages) must be installed upon the installation.

For now no extra manual setup is needed, just install the BSPs directly.
The BSP packages are now present in the main suite, so you don't have to add `bsp-rpi` suite to your `sources.list`. Simply run the following command to install the BSP packages:

Add BSP repository:
```sh
echo "deb https://repo.aosc.io/debs stable bsp-rpi" | tee /etc/apt/sources.list.d/10-bsp-rpi.list
apt update
```

Install kernel (which brings up all necessary BSPs):

```sh
apt install linux+kernel+rpi64
```

Or you would prefer LTS branch:

```
apt install linux+kernel+rpi64+lts
```

Don't worry, we will take care about everything to get your Pi running, including generating `config.txt` and `cmdline.txt`.

# Plugin and run!

If all above are set, you can exit your chroot environment, unmount them, plug it in to your Pi and boot!
Expand Down
28 changes: 8 additions & 20 deletions content/aosc-os/devices/raspberrypi/4b/installation.zh.md
Original file line number Diff line number Diff line change
Expand Up @@ -28,15 +28,19 @@ AOSC OS 对树莓派的支持由社区进行维护,所以你可以轻松地为
- 第三代树莓派系列 (BCM2837A0/B0)
- 树莓派 3/3A/3B/3B+
- 树莓派计算模块 3
- 装备了 BCM2837 的第二代树莓派 (2B 硬件版本 1.2,运行较慢)

# 已知问题

- 64 位系统没有硬件视频解码支持。参见[这里](https://github.com/raspberrypi/userland/blob/9f3f9054a692e53b60fca54221a402414e030335/CMakeLists.txt#L11)[这里](https://www.raspberrypi.org/forums/viewtopic.php?t=232684&start=25)
- AOSC 主源中提供的 `raspi-config` 工具来自 [cyanberry-config](https://github.com/AOSC-Archive/cyanberry-config),但是目前已归档,不再建议使用。

# 教程内容

跟随本教程,你将进行如下步骤:

1. 对目标设备分区及格式化
2. 将 AOSC OS 安装到目标设备
3. 安装 AOSC OS 树莓派支持包
3. 安装支持包
4. 基本设置步骤
5. 开跑!

Expand All @@ -51,7 +55,7 @@ AOSC OS 对树莓派的支持由社区进行维护,所以你可以轻松地为
- 用于安装 AOSC OS 的存储设备。可以是 SD 卡,也可以是装在 USB 硬盘盒的 SSD 或 HDD。
- 如果你使用的是第三代树莓派或更旧的版本,则建议使用 SD 卡,因为它们的 USB 启动支持非常有限。
- 如果你用 SD 卡作为存储设备,确保你的读卡器不会毁坏 SD 卡的数据。
- 一个稳定的因特网连接,用以太网连接
- 一个稳定的因特网连接,推荐使用以太网连接

### 软件依赖

Expand Down Expand Up @@ -187,26 +191,10 @@ genfstab -p -U / | sed -e '/swap/d' >> /etc/fstab
安装树莓派 BSP(单板支持包)
--------

为了让树莓派运行安装的 OS,要在安装过程中安装一系列单板支持包。

到目前为止,这些包不再需要手动配置,直接安装即可。

首先添加 BSP 源:
为了让树莓派运行安装的 AOSC OS,要在安装过程中安装一系列单板支持包,例如内核及引导用固件。您可以执行如下命令安装所需要的支持包:

```sh
echo "deb https://repo.aosc.io/debs stable bsp-rpi" | tee /etc/apt/sources.list.d/10-bsp-rpi.list
apt update
```

然后安装内核包(该包将所有必需 BSP 作为依赖安装):

```sh
apt install linux+kernel+rpi64
```

若更倾向使用 LTS 分支的内核:

```
apt install linux+kernel+rpi64+lts
```

Expand Down
2 changes: 1 addition & 1 deletion content/aosc-os/devices/raspberrypi/4b/troubleshooting.md
Original file line number Diff line number Diff line change
Expand Up @@ -38,7 +38,7 @@ Check your `cmdline.txt` and remove the `quiet` option or you will not see the k

Another possible reason is that the kernel is waiting for the root filesystem to show up. Make sure the root device is correct in your `cmdline.txt`.

## Kernel paniked
## Kernel panicked

The reason behind this varys. Here are some possible symptoms:

Expand Down
Original file line number Diff line number Diff line change
Expand Up @@ -35,7 +35,7 @@ tags = ["sys-installation"]

如果光标依旧在闪动,说明内核依旧在等待根文件系统出现。检查 `cmdline.txt`,确保 `root=` 参数指向了正确的根分区。

## 内核崩溃了 (paniked)
## 内核崩溃了 (panicked)

内核崩溃的原因有很多,具体请观察屏幕提示。以下是几个例子:

Expand Down
Loading

0 comments on commit 7637e83

Please sign in to comment.