diff --git a/zh/NPU.md b/zh/NPU.md new file mode 100644 index 00000000..5a13e4d6 --- /dev/null +++ b/zh/NPU.md @@ -0,0 +1,342 @@ +--- +title: NPU +description: 使用 BredOS 在Rockchip SOC上设置和使用神经处理股 +published: false +date: 2026-03-10T10:38:00.698Z +tags: npu, rk3588, ai, 机器学习 +editor: markdown +dateCreated: 2026-02-18T09:54:15.539Z +--- + +# 2. 介绍信息 + +一些Rockchip SoC公司包括一个专用神经处理股（“NPU”），以加快机器学习推断。 `RK3588`集成了6个TOPS NPU，拥有3个核心，能够运行定量的神经网络模型比CPU本身快得多。 + +RK3588NPU有**两个单独的软件堆栈**，每个堆栈都有不同的内核要求： + +| 堆栈... | 内核数 | 许可协议 | 能力 | +| ----------------------------------------------------- | ------------------------------ | --------- | --------------------------------------------------------------- | +| **火箭+Teflon** (开源) | Mainline 6.18+ | GPL / MIT | TFLite quantized CNN inference (limited ops) | +| **RKNN Toolkit2** (专有) | 仅限供货商 BSP | 专有性 | 全部推论：YOLO、LLM、演讲、多式联赛 | +| {.dense} | | | | + +> BredOS 提供两个内核轨迹：**剪切边** (主线) 和 **Legacy** (Rockchip BSP)。 开源火箭+Teflon堆栈用于剪切边缘内核6.18及以后的工作。 专有的 RKNN Toolkit2 需要 **BSP 内核** 并在 BredOS **Legacy** 图像上工作。 请注意，切割边缘(主线)图像目前仅适用于少数看板——大多数看板默认带有旧图像。 见第条[第7条] Proprietary Stack (RKNN-Toolkit2)](#h-7-proprietary-stack-rknn-toolkit2) 了解详情。 +> {.is-info} + +# 3. 支持的硬件 + +- 下表显示哪些Rockchip SoC包括一个由开放源码火箭驱动器支持的NPU： + +| SoC | NPU Cores | 业绩 | 内核支持 | +| ------------------------ | --------- | ----- | --------------------- | +| RK3588 / RK3588S | 3 | 6 个主题 | 6.18+ | +| {.dense} | | | | + +> 火箭驱动器目前只能支撑`RK3588`家庭。 正在计划向上游提供更多的Rockchip SOC(RK3576，RK3566/RK3568)。 +> {.is-info} + +所有带有`RK3588`或`RK3588S`的蓝牙支持板可以使用NPU。 This includes the Rock 5B, Rock 5B Plus, Orange Pi 5 series, and others listed on the [supported devices](/en/table-of-supported-devices) page. + +# 4. 软件堆栈(开放源代码) + +开源NPU堆栈有两个组件： + +## 3.1 内核驱动程序(Rocket) + +`Rocket`驱动程序是一个加速器驱动程序(`grav`子系统')，用于管理NPU硬件：启动/关闭，分配内存缓冲器和提交工作。 它暴露在`/dev/grad/redded0`上。 + +驱动程序是由 [Tomeu Vizoso](https://blog.tomeuvizoso.net/)开发的，并合并到 Linux `6.18` 主线。 BredOS 内核`6.18`，然后默认包括它。 + +## 3.2 用户空间(Mesa Teflon) + +`Teflon`是包括在Mesa中的使用田间流利特的外部代表。 它通过火箭加里姆驱动程序将TFLite模型操作转换为NPU工作。 + +BredOS 飞船Mesa 使用 Teflon 内置支持。 委托书库位于`/usr/lib/libteflon.so`。 + +# 5. 设置 + +## 4.1 验证 Kernel 支持 + +- 检查`Rocket`模块是否已加载： + +``` +lsomd | grep 导弹 +``` + +你应该在输出中看到`rocket`。 如果模块未加载，手动加载： + +- 加载火箭模块： + +``` +Sudo modprobe导弹 +``` + +- 验证 NPU 设备节点存在： + +``` +ls -l /dev/accel/accel0 +``` + +> 如果`/dev/grad/redded0`不存在，您的内核可能会超过`6.18`或缺少`CONFIG_DRM_ACCEL_ROCKET` 选项。 更新到最近的 BredOS 内核。 +> {.is-info} + +## 4.2 安装用户空间包 + +NPU推断堆栈需要 Python 3.11`、`tflite-runtime`和`numpy`。 BredOS 目前将 Python `3.14` 作为系统默认值，但`tflite-runtime`仅提供最多为 Python`3.11\`的轮子。 + +- 安装 Python 3.11 和管道： + +``` +sudo pacman -S python311 +``` + +- 安装 TFLite Runtime 和 Nump： + +``` +python3.11 -m pip install --user "numpy<2" tflite-runtime +``` + +> 需要`numpy<2` 约束，因为`tflite-runtime 2.14` 不兼容 NumPy 2.x。 +> {.is-info} + +- 可选，为图像预处理安装Pillow + +``` +python3.11 -m pip安装--user Pillow +``` + +## 4.3 验证Teflon 代表 + +- 确认`libteflon.so`是可用的： + +``` +ls /usr/lib/libteflon.so +``` + +如果文件丢失，更新Mesa： + +- 将网格更新为带有Teflon 支持的版本： + +``` +sudo pacman -Syu mesa +``` + +# 4. 正在运行推文 + +本节展示在NPU上使用 MobileNet V1 进行图像分类。 + +## 5.1 下载模型和标签 + +- 下载数量化的移动网络V1模型和标签： + +``` +wget https://storage.googleapis.com/download.tensorflow.org/models/mobilenet_v1_2018_08_02/mobilenet_v1_1.0_224_quant.tgz +tar xzf mobilenet_v1_1.0_224_quant.tgz +wget storage.googleapis.com/download.tensorflow.org/models/mobilenet_v1_1.0_quant_and_labels.zip +unzip mobilenet_v1_1.0_224_quant_and_labels.zip +``` + +## 5.2 将图像分类 + +- 创建一个名为 `clasfy.py`的脚本： + +```python +从 PIL 导入图像 A format@@1 导入np +为np + 。 nterpreter as tflite + +# Load Teflon 代表 for NPU size +representation = tflite. oad_delegate("/usr/lib/libteflon.so") +interpreter = tflite.Interpreter( + model_path="mobilenet_v1_1. _224_quant.tflite", + experimental_delegates=[delegate] + +解释器。 llocate_tensors() + +# 预处理图像 +img = Image.open("your_image.jpg").重新大小(224, 224)) +input_data = np.extend_dims(np. rray(img, dtype=np.uint8), axis=0) + +# 运行inference +interpretter.set_tensor(interpretter.get_input_details()[0]["index"], input_data) +interpretter.invoicke() +output = inter.get_tensor(interpretter. et_output_details()[0]["index"]) + +# 显示顶级结果 +打开("labels_mobilenet_quant_v1_224.txt") 为f: + labels = f.read(). plitlines() +top = np.argmax(output[0]) +print(f"预测：{labels[top]} ({output[0][top] / 255:.1%})") +``` + +- 使用 Python 3.11运行脚本 + +``` +python3.11 classify.py +``` + +## 5.3 CPU 与 NPU 比较 + +要验证实际正在使用NPU，您可以在没有授权的情况下运行推断。 + +- 没有代表 (CPU 仅限) ，将翻译初始化更改为: + +```python +解释器 = tflite.Interpreter(mel_path="mobilenet_v1_1.0_224_quant.tflite") +``` + +- 典型的 RK3588 和 MobileNet V1 量化比较： + +| 方法 | 触发时间 | +| ---------------------------------------- | ---------------------- | +| CPU (Cortex-A76) | ~48 毫秒 | +| NPU (Teflon delegate) | ~13毫秒 | +| {.dense} | | + +NPU为这一模型提供了大约3-4倍的加速。 + +# 🔄 3. 能力和限制 + +## 6.1 开放源码应用支持什么 + +火箭+Teflon堆栈支持在NPU上的下列TFLite操作： + +- Convolutions (most configurs) +- 租户添加 +- ReLU 激活 (与Convolume一起使用) +- 定量化(`uint8`) 模型 + +已成功测试的模型包括“MobileNetV1”、“MobileNetV2”和“MobileDet”。 + +## 6.2 开放源码头目前的限制 + +- **仅限定数量的模型** - NPU硬件使用固定点算术。 浮点型号完全在 CPU 上运行。 +- **有限操作** - 只有潜入、添加和引爆的RELU卸载到NPU。 不支持的操作自动返回CPU。 +- **没有高级活动** - 像SiLU (在YOLOv8中使用)这样的操作尚未实现。 +- **单核执行** — 虽然RK3588拥有3个NPU核心，但当前驱动程序每次只使用一个核心。 +- **CNN焦点** — 堆栈优化用于复杂神经网络。 基于转换的模型不会加速。 +- **早期性能** - 开源堆栈在通过时与专有的 RKNN 驱动程序不匹配。 + +> 对于不支持的操作，Teflon 代表自动返回CPU，所以混合操作的模型仍将正确运行，只要部分加速。 +> {.is-info} + +# 9. 专有堆栈(RKNN-Toolkit2) + +## 7.1 概览 + +Rockchip 提供 `RKNN-Toolkit2` ，一个NPU 内推的专有的 SDK 支持比当前开源堆栈高得多的操作和性能。 它包括模型转换工具 (ONX, TensorFlow, PyTorch, TFLite to RKNN 格式), C/C++ 运行时库和 Python 绑定。 + +## 7.2 所需经费 + +RKNN-Toolkit2 需要： + +- 一个 **BSP 内核** 和专有的 `rknpu.ko` 驱动程序（如：`linux-rockchip-rkr3` 或 `linux-rockchip-rkr6` 包在 BredOS Legacy上） +- The `rknpu2` userspace library from [rockchip-linux/rknpu2](https://github.com/rockchip-linux/rknpu2) + +> 在 BredOS, 专有的 `rknpu.ko` 驱动程序在 **Legacy** (BSP) 图像上可用。 如果您正在运行一个 **剪切边** (主线) 图像，则使用开源火箭驱动程序，RKNN Toolkit2 将无法工作。 使用"uname -r"检查您的内核轨迹-BSP 内核显示类似于"6.1.x-rkrX-bredos"的版本，而主内核则显示"6.19.x-bredos"或"7.x"。 +> {.is-info} + +## 7.3 具体使用案件 + +专有的 RKNN 堆栈比开源堆放更广泛的 AI 工作负荷。 以下是使用软件的具体实例： + +### 对象检测 + +| 项目 | 模型 | 业绩 | 链接 | +| -------------------------------------------------------- | --------------------- | ------------------------------------ | ------------------------------------------------------------------------------------------------------------------------- | +| rknn_model_zoo | YOLOv5, v8, v10, v11 | 50+ FPS (YOLOV8n) | [airockchip/rknn_model_zoo](https://github.com/airockchip/rknn_model_zoo) | +| rknn-cpp-yolo | YOLOv11 + RGA preproc | 25 FPS (YOLOv11s) | [yuunnn-w/rknn-cpp-yolo](https://github.com/yuunnn-w/rknn-cpp-yolo) | +| YoloV5-NPU | YOLOv5/v6/v7/v8 | 53 FPS (YOLOv8n) | [Qengineering/YoloV5-NPU](https://github.com/Qengineering/YoloV5-NPU) | +| ros_rknn_yolo | YOLO 作为ROS节点 | 实际时间 | [BluewhaleRobot/ros_rknn_yolo](https://github.com/BluewhaleRobot/ros_rknn_yolo) | +| {.dense} | | | | + +### LLM and Multimodal Inference + +Rockchip 提供 [rknn-llm](https://github.com/airockchip/rknn-llm，一个用于在NPU上运行大型语言模型和视觉语言模型的专用工具包： + +- **Qwen2-VL**：完全在NPU上运行的多式联运视觉语言模型 +- **DeepSeek-R1-Distill-Qwen-1.5B**：精炼推理模型 +- **rkllm_server**：LLM 内嵌本地API服务器 +- **多式对话**：交互式文本+图像对话 + +### 语音和音频 + +[rknn_model_zoo](https://github.com/airockchip/rknn_model_zoo): + +- **Whisper**: speeching to text translation +- **Zipformer**：流媒体语音识别 +- **MMS-TTS**：文本到语音合成。 +- **Wav2Vec**：语音演示学习 +- **YamNet**：音频事件分类 + +### 其他视觉任务 + +- **RetinaFace**：面部检测(243 FPS 带有mobile320 模式) +- **MobileSAM**：边缘设备上的任何片段 +- **CLIP**：图像文本匹配和零截图分类 +- **PPOCR**：文本检测和识别 (OCR) +- **YOLOv8-pose**：人类的估计值 +- **YOLOv8-OBB**：定向边界框检测 + +## 7.4 何时使用哪个应用 + +| 使用大小写 | 推荐应用 | BredOS 图像 | +| ----------------------------------------- | ----------------------------------- | --------------------------- | +| 简单的 CNN 分类 (MobileNet) | 火箭+Teflon (开源) | 剪切边缘(主线) | +| 对象检测 (YOLO) | RKNN-工具包2 | 传统(BSP) | +| NPU上的 LLM 推文 | RKNN-LLM | 传统(BSP) | +| 语音识别 | RKNN-工具包2 | 传统(BSP) | +| 长期主线支持 | 火箭+Teflon (改进上游) | 剪切边缘(主线) | +| {.dense} | | | + +> 如果您需要最大的NPU性能或对复杂模型的支持(YOLO, LLMs, 变压器) 带有供应商BSP 内核的 RKNN-Toolkit2 目前是更具能力的选项。 开源火箭+Teflon堆栈正在积极改进，是主线内核用户推荐的长期路径。 +> {.is-info} + +# 4. 🤝 贡献 + +## 8.1 no /dev/grad/grading 0 + +- 在内核中验证火箭模块可用： + +``` +zgrep CONFIG_DRM_ACCEL_ROCKET /proc/config.gz +``` + +输出应显示 `CONFIG_DRM_ACCEL_ROCKET=m` 或 `CONFIG_DRM_ACCEL_ROCKET=y`。 如果不是，你需要一个内核`6.18`，或此选项已启用。 + +## 8.2 Teflon 代表加载失败 + +- 检查使用Teflon 支持构建梅萨： + +``` +pacman -Ql mesa | grep teflon +``` + +如果`libteflon.so`未列出, 已安装的Mesa版本可能不包括 Teflon。 更新网格或检查 BredOS 仓库的更新包。 + +## 8.3 tfrete-runtime 安装失败 + +如果“pip install tflite-runtime”失败，则使用“no match distribution”错误，请验证您正在使用 `Python 3.11`： + +- 检查您的 Python 版本： + +``` +python3.11 --version +``` + +`tflite-runtime`软件包没有为所有Python版本提供轮子。 Python `3.11`是最新版本，并且已确认支持。 + +## 8.4 RKNN-Toolkit2 不工作 + +RKNN-Toolkit2 需要专有的 `rknpu.ko` 驱动器，这只能在 BSP 内核中使用。 如果您正在运行 BredOS **剪切边** (主线) 图像，请切换到 **Legacy** (BSP) 图像或使用开源火箭+Teflon 堆栈。 See [section 7.2](#h-72-requirements). + +# 10. 参考 + +- [Rockchip NPU 更新 6: 我们是主线！](https://blog.tomeuvizoso.net/2025/07/rockchip-npu-update-6-we-are-in-mainline.html) - Tomeu Vizoso +- [grand/row火箭内核文档](https://docs.kernel.org/accel/rocket/index.html) - kernel.org +- [RKNN-Toolkit2](https://github.com/airockchip/rknn-toolkit2) - Rockchip/Airockchip +- [RKNN-LLM](https://github.com/airockchip/rknn-llm) - Rockchip/Airockchip (LLM inference on NPU) +- [RKNN 模型动物园](https://github.com/airockchip/rknn_model_zoo) - Rockchip/Airockchip (官方演示和基准) +- [rknpu2 用户空间库](https://github.com/rockchip-linux/rknpu2) - Rockchip +- [Collabora RK3588 mainline status](https://gitlab.collabora.com/hardware-enablement/rockchip-3588/notes-for-rockchip-3588/-/blob/main/mainline-status.md) - Collabora +- [在 Rockchip上运行主线Linux : 一年审查](https://www.collabora.com/news-and-blog/blog/2026/03/02/running-mainline-linux-u-boot-and-mesa-on-rockchip-a-year-in-review/) - Collabora (FOSDEM 2026) \ No newline at end of file diff --git a/zh/NPU/RKNN.md b/zh/NPU/RKNN.md new file mode 100644 index 00000000..2dc46c71 --- /dev/null +++ b/zh/NPU/RKNN.md @@ -0,0 +1,13 @@ +--- +title: RKNN 驱动程序(BSP Kernel) +description: +published: false +date: 2026-02-24T09:28:20.286Z +tags: +editor: markdown +dateCreated: 2026-02-24T09:28:20.286Z +--- + +# 标题 + +您在这里的内容 \ No newline at end of file diff --git a/zh/NPU/rocket.md b/zh/NPU/rocket.md new file mode 100644 index 00000000..ff139356 --- /dev/null +++ b/zh/NPU/rocket.md @@ -0,0 +1,274 @@ +--- +title: 火箭驱动程序(主线Kernel) +description: 使用 BredOS 在Rockchip SOC上设置和使用神经处理股 +published: false +date: 2026-02-24T09:48:17.978Z +tags: +editor: markdown +dateCreated: 2026-02-24T09：27：47.353Z +--- + +# 2. 介绍信息 + +一些Rockchip SoC公司包括一个专用神经处理股（“NPU”），以加快机器学习推断。 `RK3588`集成了6个TOPS NPU，拥有3个核心，能够运行定量的神经网络模型比CPU本身快得多。 + +由于内核`6.18`，Linux包含RK3588NPU的开源`Rocket`驱动程序。 在用户空间一侧，Mesa提供`Teflon`，TensorFlow Lite委托，向NPU硬件发送兼容的操作。 这两者结合在一起，允许在 BredOS 上运行 AI 推断，没有任何专利软件。 + +> 本指南涵盖完全开源堆栈(Rocket + Teflon)。 关于来自Rockchip的专有RKNN-Toolkit2，见部分[7。 所有权替代(RKN)](#h-7-proprietary-alternative-rknn)。 +> {.is-info} + +# 3. 支持的硬件 + +- 下表显示哪些Rockchip SoC包括一个由开放源码火箭驱动器支持的NPU： + +| SoC | NPU Cores | 业绩 | 内核支持 | +| ------------------------ | --------- | ----- | --------------------- | +| RK3588 / RK3588S | 3 | 6 个主题 | 6.18+ | +| {.dense} | | | | + +> 火箭驱动器目前只能支撑`RK3588`家庭。 计划向上游提供更多的Rockchip SOC支助。 +> {.is-info} + +所有带有`RK3588`或`RK3588S`的蓝牙支持板可以使用NPU。 This includes the Rock 5B, Rock 5B Plus, Orange Pi 5 series, and others listed on the [supported devices](/en/table-of-supported-devices) page. + +# 4. 软件应用 + +开源NPU堆栈有两个组件： + +## 3.1 内核驱动程序(Rocket) + +`Rocket`驱动程序是一个加速器驱动程序(`grav`子系统')，用于管理NPU硬件：启动/关闭，分配内存缓冲器和提交工作。 它暴露在`/dev/grad/redded0`上。 + +驱动程序是由Tomeu Vizoso开发的，并并入Linux `6.18`的主线。 BredOS 内核`6.18`，然后默认包括它。 + +## 3.2 用户空间(Mesa Teflon) + +`Teflon`是包括在Mesa中的使用田间流利特的外部代表。 它通过火箭加里姆驱动程序将TFLite模型操作转换为NPU工作。 + +BredOS 飞船Mesa 使用 Teflon 内置支持。 委托书库位于`/usr/lib/libteflon.so`。 + +# 5. 设置 + +## 4.1 验证 Kernel 支持 + +- 检查`Rocket`模块是否已加载： + +``` +lsomd | grep 导弹 +``` + +你应该在输出中看到`rocket`。 如果模块未加载，手动加载： + +- 加载火箭模块： + +``` +Sudo modprobe导弹 +``` + +- 验证 NPU 设备节点存在： + +``` +ls -l /dev/accel/accel0 +``` + +> 如果`/dev/grad/redded0`不存在，您的内核可能会超过`6.18`或缺少`CONFIG_DRM_ACCEL_ROCKET` 选项。 更新到最近的 BredOS 内核。 +> {.is-info} + +## 4.2 安装用户空间包 + +NPU推断堆栈需要 Python 3.11`、`tflite-runtime`和`numpy`。 BredOS 目前将 Python `3.14` 作为系统默认值，但`tflite-runtime`仅提供最多为 Python`3.11\`的轮子。 + +- 安装 Python 3.11 和管道： + +``` +sudo pacman -S python311 +``` + +- 安装 TFLite Runtime 和 Nump： + +``` +python3.11 -m pip install --user "numpy<2" tflite-runtime +``` + +> 需要`numpy<2` 约束，因为`tflite-runtime 2.14` 不兼容 NumPy 2.x。 +> {.is-info} + +- 可选，为图像预处理安装Pillow + +``` +python3.11 -m pip安装--user Pillow +``` + +## 4.3 验证Teflon 代表 + +- 确认`libteflon.so`是可用的： + +``` +ls /usr/lib/libteflon.so +``` + +如果文件丢失，更新Mesa： + +- 将网格更新为带有Teflon 支持的版本： + +``` +sudo pacman -Syu mesa +``` + +# 4. 正在运行推文 + +本节展示在NPU上使用 MobileNet V1 进行图像分类。 + +## 5.1 下载模型和标签 + +- 下载数量化的移动网络V1模型和标签： + +``` +wget https://storage.googleapis.com/download.tensorflow.org/models/mobilenet_v1_2018_08_02/mobilenet_v1_1.0_224_quant.tgz +tar xzf mobilenet_v1_1.0_224_quant.tgz +wget storage.googleapis.com/download.tensorflow.org/models/mobilenet_v1_1.0_quant_and_labels.zip +unzip mobilenet_v1_1.0_224_quant_and_labels.zip +``` + +## 5.2 将图像分类 + +- 创建一个名为 `clasfy.py`的脚本： + +```python +从 PIL 导入图像 A format@@1 导入np +为np + 。 nterpreter as tflite + +# Load Teflon 代表 for NPU size +representation = tflite. oad_delegate("/usr/lib/libteflon.so") +interpreter = tflite.Interpreter( + model_path="mobilenet_v1_1. _224_quant.tflite", + experimental_delegates=[delegate] + +解释器。 llocate_tensors() + +# 预处理图像 +img = Image.open("your_image.jpg").重新大小(224, 224)) +input_data = np.extend_dims(np. rray(img, dtype=np.uint8), axis=0) + +# 运行inference +interpretter.set_tensor(interpretter.get_input_details()[0]["index"], input_data) +interpretter.invoicke() +output = inter.get_tensor(interpretter. et_output_details()[0]["index"]) + +# 显示顶级结果 +打开("labels_mobilenet_quant_v1_224.txt") 为f: + labels = f.read(). plitlines() +top = np.argmax(output[0]) +print(f"预测：{labels[top]} ({output[0][top] / 255:.1%})") +``` + +- 使用 Python 3.11运行脚本 + +``` +python3.11 classify.py +``` + +## 5.3 CPU 与 NPU 比较 + +要验证实际正在使用NPU，您可以在没有授权的情况下运行推断。 + +- 没有代表 (CPU 仅限) ，将翻译初始化更改为: + +```python +解释器 = tflite.Interpreter(mel_path="mobilenet_v1_1.0_224_quant.tflite") +``` + +- 典型的 RK3588 和 MobileNet V1 量化比较： + +| 方法 | 触发时间 | +| ---------------------------------------- | ---------------------- | +| CPU (Cortex-A76) | ~48 毫秒 | +| NPU (Teflon delegate) | ~13毫秒 | +| {.dense} | | + +NPU为这一模型提供了大约3-4倍的加速。 + +# 🔄 3. 能力和限制 + +## 6.1 什么是有效的 + +开源堆栈支持NPU上的以下TFLite操作： + +- Convolutions (most configurs) +- 租户添加 +- ReLU 激活 (与Convolume一起使用) +- 定量化(`uint8`) 模型 + +已成功测试的模型包括“MobileNetV1”、“MobileNetV2”和“MobileDet”。 + +## 6.2 目前的限制 + +- 🔸 **数量化的模型** - NPU 硬件在固定点数学上运行。 浮点型号完全在 CPU 上运行。 +- 🔸 **有限操作** - 只有翻转、添加和融合的ReLU被卸载到NPU。 不支持的操作自动返回CPU。 +- 🔸 **没有高级活动** - 像SiLU (在 YOLOv8中使用) 这样的操作尚未实现。 +- 🔸 **Single-core execution** - 虽然RK3588拥有3个NPU核心，但当前驱动程序每次只使用一个核心。 +- 🔸 **CNN-focused** - 这个堆栈被优化用于复杂神经网络。 基于转换的模型不会加速。 +- 🔸 **早期阶段性能** - 开源堆栈在通过时与专有的 RKNN 驱动程序不匹配。 + +> 对于不支持的操作，Teflon 代表自动返回CPU，所以混合操作的模型仍将正确运行，只要部分加速。 +> {.is-info} + +# 9. 所有权替代品(RKNN) + +Rockchip 提供 `RKNN-Toolkit2` ，一个NPU 内推的专有的 SDK 支持比当前开源堆栈更多的操作和更高的性能。 它包括模型转换工具 (ONX, TensorFlow, PyTorch 到 RKNN 格式)和运行时库。 + +然而，RKNN-工具包2： + +- 需要供应商内核(`linux-rockchip-rkr3`) +- 不是开源 +- 使用专有的二进制驱动 + +> 如果您需要最大的NPU性能或对复杂型号的支持 (YOLO, 变压器)，包含供应商内核的RKNN-Toolkit2 目前是更加能量化的选项。 开源堆栈正在积极改进，并且是推荐的长期路径。 +> {.is-info} + +The RKNN-Toolkit2 repository is available at [github.com/airockchip/rknn-toolkit2](https://github.com/airockchip/rknn-toolkit2). + +> 欲了解更多信息的外观 [here](/NPU/RKNN)。 +> {.is-info} + +# 4. 🤝 贡献 + +## 8.1 no /dev/grad/grading 0 + +- 在内核中验证火箭模块可用： + +``` +zgrep CONFIG_DRM_ACCEL_ROCKET /proc/config.gz +``` + +输出应显示 `CONFIG_DRM_ACCEL_ROCKET=m` 或 `CONFIG_DRM_ACCEL_ROCKET=y`。 如果不是，你需要一个内核`6.18`，或此选项已启用。 + +## 8.2 Teflon 代表加载失败 + +- 检查使用Teflon 支持构建梅萨： + +``` +pacman -Ql mesa | grep teflon +``` + +如果`libteflon.so`未列出, 已安装的Mesa版本可能不包括 Teflon。 更新网格或检查 BredOS 仓库的更新包。 + +## 8.3 tfrete-runtime 安装失败 + +如果“pip install tflite-runtime”失败，则使用“no match distribution”错误，请验证您正在使用 `Python 3.11`： + +- 检查您的 Python 版本： + +``` +python3.11 --version +``` + +`tflite-runtime`软件包没有为所有Python版本提供轮子。 Python `3.11`是最新版本，并且已确认支持。 + +# 10. 参考 + +- [Rockchip NPU 更新 6: 我们是主线！](https://blog.tomeuvizoso.net/2025/07/rockchip-npu-update-6-we-are-in-mainline.html) - Tomeu Vizoso +- [grand/row火箭内核文档](https://docs.kernel.org/accel/rocket/index.html) - kernel.org +- [RKNN-Toolkit2](https://github.com/airockchip/rknn-toolkit2) - Rockchip/Airockchip +- [Collabora RK3588 mainline status](https://gitlab.collabora.com/hardware-enablement/rockchip-3588/notes-for-rockchip-3588/-/blob/main/mainline-status.md) - Collabora \ No newline at end of file diff --git a/zh/Tools.md b/zh/Tools.md index eeceb9e2..a64a549a 100644 --- a/zh/Tools.md +++ b/zh/Tools.md @@ -10,9 +10,7 @@ dateCreated: 2025-05-07T18:27:16.781Z # 1. 介绍信息 -这将作为`breddos-tools`，与任何系统架构兼容，发送到`BredOS-any`存储库中。 -它是BredOS的组成部分。 “bredos-tools”应默认安装。 -它是BredOS的组成部分。 “bredos-tools”应默认安装。 +这将作为`bredos-tools`，与任何系统架构兼容，发送到`BredOS-any`存储库中。 它是BredOS的组成部分。 “bredos-tools”应默认安装。 它是BredOS的组成部分。 “bredos-tools”应默认安装。 @@ -60,27 +58,9 @@ sudo grub-password -d > 修改`/etc/grub.d/10_linux`，请不要手动恢复。 > 配置保存在 `/etc/grub.d/99-bredos-grub-password` 中。 > 脚本通过 `grub-mkconfig` 自动重新生成 GRUB 配置。 -> 修改 `/etc/grub.d/10_linux`，请不要手动恢复。 -> 配置保存在/etc/grub.d/99-bredos-grub-密码中。 -> 脚本通过 grub-mkconfig自动重新生成 GRUB配置。 -> 修改`/etc/grub.d/10_linux`，请不要手动恢复。 -> 配置保存在 `/etc/grub.d/99-bredos-grub-password` 中。 -> 脚本通过 `grub-mkconfig` 自动重新生成 GRUB 配置。 -> 修改 `/etc/grub.d/10_linux`，请不要手动恢复。 -> 配置保存在/etc/grub.d/99-bredos-grub-密码中。 -> 脚本通过 grub-mkconfig自动重新生成 GRUB配置。 -> 修改`/etc/grub.d/10_linux`，请不要手动恢复。 -> 配置保存在 `/etc/grub.d/99-bredos-grub-password` 中。 -> 脚本通过 `grub-mkconfig` 自动重新生成 GRUB 配置。 -> 修改 `/etc/grub.d/10_linux`，请不要手动恢复。 -> 配置保存在/etc/grub.d/99-bredos-grub-密码中。 -> 脚本通过 grub-mkconfig自动重新生成 GRUB配置。 -> 修改`/etc/grub.d/10_linux`，请不要手动恢复。 > 这修改了 `/etc/grub.d/10_linux` ，不要手动还原它！ > {.is-info} > {.is-info} -> {.is-info} -> {.is-info} # 3. DTSC 助手脚本 @@ -105,6 +85,8 @@ yay -S dtc > {.is-warning} > 小心，执行备份并确保一个紧急计划。 > {.is-warning} +> 小心，执行备份并确保一个紧急计划。 +> {.is-warning} ## 3.1 用法 @@ -127,7 +109,7 @@ yay -S dtc 示例：dtsc my_device_tree.dts -o output.dtbo ``` -## 输入 +## 3.2 输入 脚本需要输入 `.dts` 文件。如果没有指定输出，它生成匹配名称的 `.dtb` 文件。 输出文件名可以用 `-o` 参数设置。 脚本需要输入 `.dts` 文件。如果没有指定输出，它生成匹配名称的 `.dtb` 文件。 diff --git a/zh/bredos-config.md b/zh/bredos-config.md index 00a2d56e..0c008678 100644 --- a/zh/bredos-config.md +++ b/zh/bredos-config.md @@ -19,6 +19,7 @@ dateCreated: 2025-09-21T09:27:04.136Z > {.is-info} > {.is-info} > {.is-info} +> {.is-info} - 如果您删除了它或想要重新安装它，请运行： diff --git a/zh/bredos-migrate.md b/zh/bredos-migrate.md new file mode 100644 index 00000000..e632945d --- /dev/null +++ b/zh/bredos-migrate.md @@ -0,0 +1,74 @@ +--- +title: BredOS-迁移 +description: 迁移您的 BredOS 安装的脚本 +published: false +date: 2025-12-14T11:34:10.351Z +tags: +editor: markdown +dateCreated: 2025-12-14T11:34:10.351Z +--- + +# 2. 介绍信息 + +工具`bredos-migrate`是一个将BredOS安装迁移到不同引导媒体的脚本。 要迁移的来源可以是您当前启动的 BredOS 安装， 在已连接的存储设备上或直接从图像文件中安装 BredOS 。 +脚本处理UUID中的更改，刷入正确的引导器，并从源复制所有需要的文件。 + +> 此脚本几乎没有测试。 只有在你被明确建议这样做时才使用！ +> {.is-danger} + +# 3. 用法 + +## 2.1 迁移您启动的安装 + +- 要迁移您当前启动的安装，请运行： + +``` +bredos-migration --destination-drive +``` + +- 产出应如下： + +``` +正在检测图像类型... +源第一部分信息： vfat +源第二部分信息： btrfs +源驱动器： +目标驱动器： +检测到的引导器： + +如果您继续所有数据将在驱动器 上删除！ +您确定要继续吗？[/N] y +在 上创建分区表。 . +正在形成分区... +正在创建子卷... +挂载驱动器... +复制操作系统文件... +修改引导器配置 。. +更改文件系统表... +正在卸载驱动器... +Flash bootloader to ... +已完成！ + +``` + +## 2.2 从.img文件迁移 + +- 要从图像文件迁移，请运行： + +``` +bredos-migration --destination-drive --img +``` + +## 2.3 从附加存储媒体迁移 + +- 要从附加存储媒体迁移，请运行： + +``` +bredos-migration --destination-drive --source-drich +``` + +## 2.4 高级选项 + +使用 "--hostname" 选项将为新迁移的安装设置给定的主机名。 +使用 "--skip-home" 选项，不会复制主文件夹。 用它来加速进程，或如果您的目标存储媒体太小，无法保存来自您来源的所有数据。 请注意，您需要在迁移后创建具有正确权限的主文件夹； 否则您将无法以该用户的身份登录。 然而，根登录应该能够正常工作，没有问题。 +选项`--debug` 允许将所有命令输出直接打印到标准输出(stdout)，而不是创建一个名为“logfile”的日志文件。 当前文件夹中的 xt\`。 \ No newline at end of file diff --git a/zh/campaigns/mainline-campaign.md b/zh/campaigns/mainline-campaign.md index 18e2935f..56b090ec 100644 --- a/zh/campaigns/mainline-campaign.md +++ b/zh/campaigns/mainline-campaign.md @@ -2,7 +2,7 @@ title: 主线活动 description: published: true -date: 2025-09-23T15：45：54.131Z +date: 2025-12-22T06:56:27.168Z tags: editor: markdown dateCreated: 2025-09-22T19:14:24.174Z @@ -35,6 +35,7 @@ dateCreated: 2025-09-22T19:14:24.174Z > {.is-info} > {.is-info} > {.is-info} +> {.is-info} ## 我们为什么要这样做？ @@ -46,7 +47,7 @@ dateCreated: 2025-09-22T19:14:24.174Z - 许多Wi-Fi驱动程序无法正常工作 - 偏差特定优化不适用于通用主线补丁 -在 BredOS 中，我们希望RK3588 设备为 **实用并为真正的用户抛光**。 这意味着： 这意味着： 这意味着： 这意味着： +在 BredOS 中，我们希望RK3588 设备为 **实用并为真正的用户抛光**。 这意味着： 这意味着： 这意味着： 这意味着： 这意味着： - 可靠的 Wi-Fi 和网络 - 优化风扇配置文件 (空闲时冷却，加载时) @@ -106,6 +107,13 @@ dateCreated: 2025-09-22T19:14:24.174Z 我们可以支配的预算越多，我们可以用更多的时间专用于布雷得奥斯。 -### **[现在支持 RK3588 主行里程碑](https://ko-fi.com/Z8Z3I4J0P)** +_**[现在支持 RK3588 主行里程碑](https://ko-fi.com/Z8Z3I4J0P)**_ + +## 赞助商 + +我们要真诚感谢我们的提案国的慷慨支持。 我们确实感谢你们的合作。 + +[![sponsor-gold-tier-opi.png](/sponsors/sponsor-gold-tier-opi.png){.align-center}](http://www.orangepi.org) +[![sponsor-silver-tier-ameridroid.png](/sponsors/sponsor-silver-tier-ameridroid.png){.align-center}](https://ameridroid.com) --- \ No newline at end of file diff --git a/zh/contributors.md b/zh/contributors.md index 520493c7..dd99d639 100644 --- a/zh/contributors.md +++ b/zh/contributors.md @@ -2,7 +2,7 @@ title: 贡献者 description: 感谢为BredOS wiki贡献力量的所有人！ published: true -date: 2025-09-12T10:43、44.656Z +date: 2026-02-24T11:05:41.028Z tags: editor: markdown dateCreated: 2025-09-12T10:43、44.656Z @@ -13,4 +13,5 @@ dateCreated: 2025-09-12T10:43、44.656Z - Panda - - 账单88t (台阶) - - DroidMaster - [YouTube](https://www.youtube.com/@LinuxDroidMaster) -- NoDiskNoFun - [Github](https://github.com/nodisknofun) \ No newline at end of file +- NoDiskNoFun - [Github](https://github.com/nodisknofun) +- Sav (充满热情的计算机文盲) - [Github](https://github.com/dongioia) \ No newline at end of file diff --git a/zh/customizations/news.md b/zh/customizations/news.md index 688a1e38..c89b0a9d 100644 --- a/zh/customizations/news.md +++ b/zh/customizations/news.md @@ -2,7 +2,7 @@ title: BredOS 新闻 description: 自定义这个非常复杂的软件。 published: true -date: 2025-10-06T07:18:15.049Z +date: 2025-10-05T12:26:26.876Z tags: editor: markdown dateCreated: 2025-10-04T21:13:09.732 Z @@ -10,7 +10,7 @@ dateCreated: 2025-10-04T21:13:09.732 Z # 2. 简介 -默认情况下，"bredos-news" 每次打开外壳时都会触发。 默认情况下，"bredos-news" 每次打开外壳时都会触发。 这是由 `~/.bashrc` 中的 `bredos-news|| true` 行和`/etc/profile.d/99-bredos-news.sh` 行设置的。 +默认情况下，"bredos-news" 每次打开外壳时都会触发。 默认情况下，"bredos-news" 每次打开外壳时都会触发。 默认情况下，"bredos-news" 每次打开外壳时都会触发。 这是由 `~/.bashrc` 中的 `bredos-news|| true` 行和`/etc/profile.d/99-bredos-news.sh` 行设置的。 每一个 ' bredos-news' 副本都可以个性化，这意味着你可以完全配置你想要的特征以及它的主题。 @@ -22,12 +22,7 @@ Permenant (per user) 配置可以在 "~/.newsrc" 中完成。 一个permenant ( - 默认配置文件看起来像这样： ``` -""" -BredOS-News Configuration - -Refer to `https://wiki.bredos.org/customizations/news`, -for detailed instructions on how to configure. -""" +# BredOS-News Configuration # Accent = "\033[38;5;129m" # Accent_Secondary = "\033[38;5;104m" @@ -39,32 +34,17 @@ for detailed instructions on how to configure. # Time_Refresh = 0.25 # Onetime = False -""" -Shortcuts configuration - -Shell commands, using $SHELL, and python functions are fully supported. -Only alphanumeric and symbol keys can be captured, no key combinations. -Capital keys work and can be bound to seperate shortcuts from lowercase. -""" - -def shortcuts_help() -> None: - print("Configured shortcuts:") - for i in shortcuts.keys(): - shortcut = shortcuts[i] - if is_function(shortcut): - print(f" - {i}: Function {shortcut.__name__}") - else: - print(f' - {i}: "{shortcuts[i]}"') - print("\n") - -shortcuts["1"] = "bredos-config" -shortcuts["0"] = "sudo sys-report" -shortcuts["?"] = shortcuts_help +# Shortcuts configuration + +# shortcuts = { +# "1": "bredos-config", +# } ``` > 要激活此配置文件中的参数，请在行开始处删除 #。 > {.is-info} > {.is-info} +> {.is-info} ## 2.1 设置音量(颜色) @@ -73,15 +53,16 @@ shortcuts["?"] = shortcuts_help > 关于ANSI逃避序列和示例的更多信息，请点击[此链接](https://gist.github.com/fnky/458719343aabd01cfb17a3a4f7296797)。 > {.is-info} > {.is-info} +> {.is-info} 常用样式： -| 颜色 | 代码 | -| ----- | ----------------------------------------------------------------------------------------- | -| 完美的紫色 | \\`Accent = "\033[38;5;129m"" | -| | \\`Accent_Second = "\033[38;5;104m"" | -| 粗体 | \\`Accent = "\033[1m\033[38;5;124m"" | -| | \\`Accent_Second = "\033[38;5;160m"" | +| 颜色 | 代码 | +| ----- | ------------------------------------------------------------------------------------------- | +| 完美的紫色 | \\\`Accent = "\033[38;5;129m"" | +| | \\\`Accent_Second = "\033[38;5;104m"" | +| 粗体 | \\\`Accent = "\033[1m\033[38;5;124m"" | +| | \\\`Accent_Second = "\033[38;5;160m"" | ## 禁用功能 @@ -109,6 +90,9 @@ shortcuts["?"] = shortcuts_help 设置快捷键，如在示例中的显示方式，允许运行命令或python函数。 对于上面给出的示例，按下 1 将会启动工具“bredos-config”。 设置键像它在示例中显示的那样，允许运行命令或python函数。 完全支持 Shell 操作，如更改目录和/或管道。 当前不支持特殊键和组合。 +支持符号。 对于上面给出的示例，按下 1 将会启动工具“bredos-config”。 设置键像它在示例中显示的那样，允许运行命令或python函数。 +完全支持 Shell 操作，如更改目录和/或管道。 +当前不支持特殊键和组合。 支持符号。 # 🚀 4. 环境覆盖 diff --git a/zh/customizations/switching-kernel.md b/zh/customizations/switching-kernel.md index 2a53c1de..944efb09 100644 --- a/zh/customizations/switching-kernel.md +++ b/zh/customizations/switching-kernel.md @@ -46,6 +46,7 @@ local/util-linux-libs 240.2-1 要安装另一个内核，请先移除已安装的内核及其头部。 要安装另一个内核，请先移除已安装的内核及其头部。 要安装另一个内核，请先移除已安装的内核及其头部。 +要安装另一个内核，请先移除已安装的内核及其头部。 # 2. 继续安装新内核。 @@ -128,7 +129,7 @@ dracut[I]: *** Moving image file '/boot/initramfs-linux-rockchip-rkr3.img.tmp' t dracut[I]: *** Moving image file '/boot/initramfs-linux-rockchip-rkr3.img.tmp' to '/boot/initramfs-linux-rockchip-rkr3.img' done *** ``` -`linux-rockchip-rkr3`内核生成了 `/boot/initramfs-linux-rockchip-rkr3.img` drachut 图像。 其它内核会生成不同的文件名。 其它内核会生成不同的文件名。 其它内核会生成不同的文件名。 其它内核会生成不同的文件名。 其它内核会生成不同的文件名。 +`linux-rockchip-rkr3`内核生成了 `/boot/initramfs-linux-rockchip-rkr3.img` drachut 图像。 其它内核会生成不同的文件名。 其它内核会生成不同的文件名。 其它内核会生成不同的文件名。 其它内核会生成不同的文件名。 其它内核会生成不同的文件名。 其它内核会生成不同的文件名。 ## 3. 更新引导程序配置 @@ -137,6 +138,7 @@ dracut[I]: *** Moving image file '/boot/initramfs-linux-rockchip-rkr3.img.tmp' t > {.is-warning} > {.is-warning} > {.is-warning} +> {.is-warning} ### 3.1 U-启动 @@ -164,6 +166,7 @@ label BredOS ARM 您还需要编辑内核行才能匹配。 您还需要编辑内核行才能匹配。 您还需要编辑内核行才能匹配。 +您还需要编辑内核行才能匹配。 - 要验证文件名正确，您可以列出`/boot/`的内容： diff --git a/zh/development.md b/zh/development.md index 9126d15b..08f2f47c 100644 --- a/zh/development.md +++ b/zh/development.md @@ -2,7 +2,7 @@ title: 开发 description: published: true -date: 2024-11-11T11:48:32.189Z +date: 2025-11T07：14：17.731Z tags: editor: markdown dateCreated: 2024-11-11T11:48:32.189Z @@ -14,6 +14,6 @@ BredOS 完全开源，每一部分都可以自由修改和重新分发。 ## 指南： -- 修改内核 -- 在设备树上工作 -- 修改 UEFI \ No newline at end of file +- [修改内核](/development/kernel) +- [在设备树上工作](/development/device-trees) +- [Moding UEFI](/development/uefi) \ No newline at end of file diff --git a/zh/development/device-trees.md b/zh/development/device-trees.md index 0bd65af7..52141746 100644 --- a/zh/development/device-trees.md +++ b/zh/development/device-trees.md @@ -2,7 +2,7 @@ title: 设备树 description: published: true -date: 2025-05-15T12:51:43.781Z +date: 2025-11-17T11：11：01.559Z tags: editor: markdown dateCreated: 2024-11T11:50:39.940Z @@ -11,8 +11,8 @@ dateCreated: 2024-11T11:50:39.940Z # 1. 简介 设备树是一种描述ARM和RISC-V系统通常使用的硬件的机制。 允许内核在不改变内核驱动程序代码的情况下发现和配置硬件设备。 -与x86系统不同的是，ACPI表格使得自动硬件发现和配置成为可能。 大多数ARM 系统需要修改设备树才能声明硬件更改。 -与x86系统不同的是，ACPI表格使得自动硬件发现和配置成为可能。 大多数ARM 系统需要修改设备树才能声明硬件更改。 +与x86系统不同的是，ACPI表格使得自动硬件发现和配置成为可能。 大多数ARM 系统需要修改设备树才能声明硬件更改。 它们分成两种设备树类型，基础和叠加层。 虽然设备树基础描述了您的SBC的全部硬件，并且叠加层仅用于改变它的特定部分。 +与x86系统不同的是，ACPI表格使得自动硬件发现和配置成为可能。 大多数自动取款机和RISC-V系统需要修改设备树才能声明硬件变更。 # 2. 设备树 @@ -44,19 +44,169 @@ sudo grub-mkconfig -o /boot/grub/grub.cfg > {.is-info} > {.is-info} > {.is-info} +> {.is-info} ## Updating Device Trees in U-Boot systems with extlinux -- 编辑 extlinux 配置文件 `/boot/extlinux/extlinux.conf` 。 使用 fdt\`, 例如: 使用 fdt`, 例如: 使用 fdt\`, 例如: 使用 fdt`, 例如: +- 编辑 extlinux 配置文件 `/boot/extlinux/extlinux.conf` 。 使用 fdt\`, 例如: 使用 fdt`, 例如: 使用 fdt\`, 例如: 使用 fdt`, 例如: 使用 fdt\`, 例如: ```bash fdt /dtbs/rockchip/xxx.dtb ``` -然后编辑以匹配您的设备树路径。 保存并重启您的系统。 保存并重启您的系统。 保存并重启您的系统。 保存并重启您的系统。 +然后编辑以匹配您的设备树路径。 保存并重启您的系统。 保存并重启您的系统。 保存并重启您的系统。 保存并重启您的系统。 保存并重启您的系统。 > 只能指定一个 DTB > {.is-info} > {.is-info} > {.is-info} > {.is-info} +> {.is-info} + +# 4. 从头创建设备树叠加 + +> 在继续本篇文章之前，请考虑审查[如何启用 DTBOs](/how-to/how-to-enable-dtbos)。 +> {.is-info} + +在这个示例中，我们生成一个叠加层，使两个GPIO-Pins 上的 I2C 能够与一个 BMP280 传感器进行通信。 + +- 创建叠加层源文件： + +``` +nano rk3588-bmp280.dts +``` + +- 并将你的 dt 源的内容放入其中。 我们使用 BMP280的示例代码： + +```c +/dts-v1/; // Specifies the version of the Device Tree Source (DTS) format being used +/plugin/; // Marks this file as a Device Tree overlay plugin + +/ { + metadata { // Metadata block containing information about this overlay + title = "Enable BMP280 on I2C8-M2"; // Human-readable title for this overlay + compatible = "rockchip,rk3588"; // Specifies the SoC this overlay is compatible with + category = "misc"; // Categorizes the type of overlay + exclusive = "GPIO1_D6", "GPIO1_D7"; // Pins that this overlay exclusively uses + description = "Enable BMP280 on I2C8-M2. Pin 3 and 5"; // Detailed description of what this overlay does + }; +}; + +&i2c8 { // Reference to the I2C8 controller node in the base device tree + status = "okay"; // Enable this I2C controller + pinctrl-names = "default"; // Name of the pin control configuration to use + pinctrl-0 = <&i2c8m2_xfer>; // Reference to the pin configuration for this I2C bus + clock-frequency = <400000>; // Set I2C clock frequency to 400 kHz (fast mode) + #address-cells = <1>; // Number of cells to represent child node addresses + #size-cells = <0>; // Number of cells to represent size of child nodes (0 for I2C devices) + + bmp280: bmp280@76 { // Define a child device node for the BMP280 sensor at I2C address 0x76 + compatible = "bosch,bmp280"; // Device compatible string for BMP280 driver + reg = <0x76>; // I2C address of the BMP280 device + status = "okay"; // Enable this device + }; +}; + +``` + +- 将DT源编译为二进制格式： + +``` +dtsc rk3588-bmp280.dts +``` + +> 要了解更多关于 dtsc 助手脚本的外观 [here](/Tools#h-3-dtsc-helper-script)。 +> {.is-info} + +- 然后移动二进制文件到您的叠加层文件夹： + +``` +mv rk3588-Bmp280.dtbo /boot/dtbs/rockchip/overlay/ +``` + +> 要启用设备树叠加层 [编辑 extlinux 配置] (/how-to/how-to-enable-dtbos#h-4-1-edit-the-extlinux-configuration) for u-booted based systems 或 [配置 UEFI] (/how-to/how-to-enable-dtbos#h-3-4-configure-uefi) 用于基于 UEFI 的系统。 +> {.is-info} + +## 3.1 验证设备树叠加层已按预期加载 + +- 检查内核模块是否加载： + +``` +lsmod | grep bmp280 +``` + +- 输出应该列出模块。 + +``` +bmp280_spi 16384 0 +bmp280_i2c 16384 0 +bmp280 28672 2 bmp280_i2c,bmp280_spi +``` + +> 请注意，i2c和spi两种支持都显示可用，这是因为bmp280传感器同时支持SPI和i2c接口。 然而，就这个例子而言，只适用i2c支持。 +> {.is-info} + +- 检查是否可以在 I2C 界面检测到 BMP280 。 + +``` +i2csection -y 8 +``` + +``` + 0 1 2 3 4 5 6 7 8 9 a b c d e f +00: -- -- -- -- -- -- -- -- +10: -- -- -- -- -- -- -- -- -- -- -- -- -- -- -- -- +20: -- -- -- -- -- -- -- -- -- -- -- -- -- -- -- -- +30: -- -- -- -- -- -- -- -- -- -- -- -- -- -- -- -- +40: -- -- -- -- -- -- -- -- -- -- -- -- -- -- -- -- +50: -- -- -- -- -- -- -- -- -- -- -- -- -- -- -- -- +60: -- -- -- -- -- -- -- -- -- -- -- -- -- -- -- -- +70: -- -- -- -- -- -- UU -- +``` + +> 请注意，i2c8大客车上地址0x76的值已经从'76'改为'UU'，这是预期和想要的； 它表明本机内核mp280 支持已经取得了传感器的所有权。 +> {.is-info} + +- 检查内核日志是否显示设备： + +``` +dmesg | grep bmp280 +``` + +``` +[ 11.513718] bmp280 8-0076: Looking up vddd-supply from device tree +[ 11.513728] bmp280 8-0076: Looking up vddd-supply property in node /i2c@feca0000/bmp280@76 failed +[ 11.513757] bmp280 8-0076: supply vddd not found, using dummy regulator +[ 11.513830] bmp280 8-0076: Looking up vdda-supply from device tree +[ 11.513836] bmp280 8-0076: Looking up vdda-supply property in node /i2c@feca0000/bmp280@76 failed +[ 11.513847] bmp280 8-0076: supply vdda not found, using dummy regulator +[ 11.694189] SPI driver bmp280 has no spi_device_id for bosch,bmp085 +``` + +- 从 BMP280 传感器查询温度： + +``` +cat /sys/devices/platform/feca00.i2c/i2c-8/8-0076/iio:device1/in_temp_input +``` + +``` +输出：30630 + +温度 30.630 摄氏度 +``` + +- 从 BMP280 传感器查询压力： + +``` +cat /sys/devices/platform/feca0000.i2c/i2c-8/8-0076/iio:device1/in_presence_input +``` + +``` +输出：100.292183593 + +返回的压力以千帕为单位。 +``` + +\*[DT]: Device Tree +\*[DTB]: Device Tree Blob +\*[DTBO]: Device Tree Blob Overlay diff --git a/zh/development/kernel.md b/zh/development/kernel.md index d74e9b96..001c3468 100644 --- a/zh/development/kernel.md +++ b/zh/development/kernel.md @@ -2,7 +2,7 @@ title: 内核moding description: published: true -date: 2025-09-13T10:54:24.895Z +date: 2025-11-17T12:42:37.621Z tags: editor: markdown dateCreated: 2024-11T11:49:44.206Z @@ -10,49 +10,140 @@ dateCreated: 2024-11T11:49:44.206Z # 4. 重要目录 -本指南主要侧重于RK3588和`linux-rockchip-rkr3`内核。 -但本指南大多应传送到其他内核。 -但本指南大多应传送到其他内核。 +本指南主要侧重于RK3588 和 linux-rockchip-rkr3 内核； 然而，一般进程和许多概念也应适用于其他内核和装置。 您是否正在开发自定义固件，有助于上游内核支持。 或只是设法了解Linux内核是如何为硬件构建的，本条旨在提供一个明确和实际的出发点。 # 2. BredOS kernel PKGBUILD ## BredOS 内核仓库 -BredOS stores it's `linux-rockchip` kernel fork at: -https://github.com/BredOS/linux-bredos +BredOS 在 [https://github.com/BredOS/linux-bredos](https://github.com/BredOS/linux-bredos) 存储它的 `linux-rockchip` 内核叉。 -用于rkr3内核的分支是 `rk6.1-rkr3` 。 -主线变量转为“rk-mainline”。 -主线变量转为“rk-mainline”。 +用于rkr3内核的分支是 `rk6.1-rkr3`，主线变量则在 `rk-mainline` 处。 -## 2.2 BredOS kernel PKGBUILD +> 查看[branches的表格](#h-211-table-of-branches) 来找出您设备要使用的分支。 +> {.is-info} + +### 2.1.1 分行表 + +| 分支 | 目标结构 | Target SBCs | 源代码基础 | PKGBUILD 名称 | +| -------------------------------------------------------------------------------------------------- | ----------------------------------- | -------------------- | --------------------------------- | -------------------------------------------------------------------------------------------------------------------- | +| [rk6.1-rkr3](https://github.com/BredOS/linux-bredos/tree/rk6.1-rkr3) | ARM64 | 所有基于 RK35xx 的 SBC | rkr3 Rockchip 6.1 | [linux-rockchip-rkr3](https://github.com/BredOS/sbc-pkgbuilds/tree/main/linux-rockchip-rkr3) | +| [rk-mainline](https://github.com/BredOS/linux-bredos/tree/rk-mainline) | ARM64 | 所有基于 RK35xx 的 SBC | 下一个 linux | [linux-rockchip-mainline](https://github.com/BredOS/sbc-pkgbuilds/tree/main/linux-rockchip-mainline) | +| [k1-6.17.y](https://github.com/BredOS/linux-bredos/tree/k1-6.17.y) | RISC-V | 所有空格 K1/M1 基于 SBC | linux-6.17 | [linux-spacemit-k1](https://github.com/BredOS/sbc-pkgbuilds/tree/main/linux-spacemit-k1) | +| [k1-6.15.y](https://github.com/BredOS/linux-bredos/tree/k1-6.15.y) | RISC-V | 所有空格 K1/M1 基于 SBC | linux-6.15 | [linux-spacemit-k1](https://github.com/BredOS/sbc-pkgbuilds/tree/main/linux-spacemit-k1) (需要编辑分支) | +| [6.18.y](https://github.com/BredOS/linux-bredos/tree/6.18.y) | x86_64 / ARM64 | 所有基于 UEFI 的设备 | 下一个 linux | [linux](https://github.com/BredOS/sbc-pkgbuilds/tree/main/linux) | +| [6.17.y](https://github.com/BredOS/linux-bredos/tree/6.17.y) | x86_64 / ARM64 | 所有基于 UEFI 的设备 | linux-6.17 | [linux](https://github.com/BredOS/sbc-pkgbuilds/tree/main/linux) (需要编辑分支) | +| [6.6.y-cix](https://github.com/BredOS/linux-bredos/tree/6.6.y-cix) | ARM64 | 所有 CIX CD81xx 基于 SBC | cix 6.6 | 无 | +| [cix-acpi](https://github.com/BredOS/linux-bredos/tree/cix-acpi) | ARM64 | 所有 CIX CD81xx 基于 SBC | 下一个 linux | 无 | + +## 2.2 Building BredOS 内核 + +就像任何自定义的 BredOS PKGBUILD一样，内核也可以在 [https://github.com/BredOS/sbc-pkgbuilds](https://github.com/BredOS/sbc-pkgbuilds)找到。 在这个示例中，我们生成rkr3内核，但本指南适用于我们仓库中发现的所有Linux内核PKGBUILD。 + +- 复制资源库： -内核是用PKGBUILD构建的： -https://github.com/BredOS/sbc-pkgbuild来构建和软件包 +``` +git clone https://github.com/BredOS/sbc-pkgbuilding +``` + +这将创建一个名为`sbc-pkgbuilds`的文件夹，在当前目录中保存我们仓库中的任何自定义包，包括内核PKGBUILD。 -## 2.3 建造内核 +- 更改内核PKGBUILD目录： + +``` +cd sbc-pkgbuils +cd linux-rockchip-rkr3 +``` -- 在 ARM 系统下，仅： +- 该文件夹的内容应如下： -```bash -make -j$(nproc) +``` +PKGBUILD +bredos-update-dtbs +config +dtb-update.hook +linux.preset ``` -- 在 x86 系统下，我们需要交叉编译内核： +- 要编译和打包内核，请运行： -```bash -make ARCH=arm64 CROSS_COMPILE=aarch64-linux-gnu- -j$(nproc) ``` +毫克-西文 +``` + +> 虽然参数 `-s` 会自动安装所有必要的依赖关系，但参数 `-i` 会在编译成功后安装包。 +> {.is-info} + +## 2.3 用补丁构建内核。 + +要用补丁构建内核，我们需要实现补丁到PKGBUILD。 Follow the section [2.2 Building BredOS Kernel](/en/development/kernel#h-2-2-building-bredos-kernel) but dont run the command `makepkg -si` yet. -您应该在 `arch/arm64/boot/` 目录中看到图像。 +- 这是补丁的示例代码： -> 在 `sbc-pkgbuilds` 里有一个名为`linux-rockchip-rkr3`的文件夹。 -> 在构建过程中，它应作为当前的工作目录。 -> 在构建过程中，它应作为当前的工作目录。 +``` +diff --git a/init/version-timestamp.c b/init/version-timestamp.c +index 1111111111..2222222222 100644 +--- a/init/version-timestamp.c ++++ b/init/version-timestamp.c +@@ -29,8 +29,10 @@ + + /* FIXED STRINGS! Don't touch! */ + const char linux_banner[] = +- "Linux version " UTS_RELEASE " (" LINUX_COMPILE_BY "@" +- LINUX_COMPILE_HOST ") (" LINUX_COMPILER ") " UTS_VERSION "\n"; ++ "Linux version this-is-a-private-kernel-dont-touch "; + +-- +``` + +> 这个示例补丁设置了一个固定的名称，而不是生成给您编译的内核。 > {.is-info} +保存您的补丁到文件`PKGBUILD`旁边的.patch文件。 在这个示例中，我们将以上代码保存为 `example.patch` 。 + +- 要实现补丁到PKGBUILD，请运行： + +``` +nano PKGBUILD +``` + +- 查看 "Prepare" 部分。 看起来像这样： + +``` +prepare() { + cd linux-bredos + + cp ${srcdir}/config .config +} +``` + +- 并在“cd linux-bredos”之后添加您的补丁： + +``` +prepare() { + cd linux-bredos + + git apply ../../example.patch + + cp ${srcdir}/config .config +} +``` + +> 工具`makepkg` 下载源代码到 `./src/linux-bredos` 。 既然我们已经在PKGBUILD旁存储了补丁文件，我们的补丁文件路径必须包含 "../../"。 +> {.is-info} + +使用 CTRL + X保存并关闭，然后使用 Y 保存。 + +- 要编译和打包内核，请运行： + +``` +毫克-西文 +``` + # 3. 编译设备树和叠加 使用`dtsc`、BredOS工具编译DTB和DTBO的完整指南现已可供使用。 -点击 [here]/Tools#dtsc-helper-script) 查看它。 -Click [here](/Tools#dtsc-helper-script) to view it. \ No newline at end of file +点击 [here]/Tools#dtsc-helper-script) 查看它。 Click [here](/Tools#dtsc-helper-script) to view it. + + + diff --git a/zh/fydetab-duo.md b/zh/fydetab-duo.md index e0c89f0c..af285c07 100644 --- a/zh/fydetab-duo.md +++ b/zh/fydetab-duo.md @@ -2,7 +2,7 @@ title: FydetabDuo description: published: true -date: 2025-09-17T10：16：17.074Z +date: 2025-11-18T06:36.359Z tags: editor: markdown dateCreated: 2024-11-10T19:37:43.624Z @@ -10,13 +10,13 @@ dateCreated: 2024-11-10T19:37:43.624Z # 1. 简介 -FydetabDuo是由Fyde Innovations开发的一张2hinncrow1平板电脑。 FydeOS - 基于 ChromiumhyOS 的系统 (Linuxroderived) 的制造商也可以运行 Android 应用程序。 它的设计是可以用作平板电脑，或用可防腐键盘/大小写+样式来运行更像一个小笔记本电脑。 它的设计是可以用作平板电脑，或用可防腐键盘/大小写+样式来运行更像一个小笔记本电脑。 它的设计是可以用作平板电脑，或用可防腐键盘/大小写+样式来运行更像一个小笔记本电脑。 它的设计是可以用作平板电脑，或用可防腐键盘/大小写+样式来运行更像一个小笔记本电脑。 +FydetabDuo是由Fyde Innovations开发的一张2hinncrow1平板电脑。 FydeOS - 基于 ChromiumhyOS 的系统 (Linuxroderived) 的制造商也可以运行 Android 应用程序。 它的设计是可以用作平板电脑，或用可防腐键盘/大小写+样式来运行更像一个小笔记本电脑。 它的设计是可以用作平板电脑，或用可防腐键盘/大小写+样式来运行更像一个小笔记本电脑。 它的设计是可以用作平板电脑，或用可防腐键盘/大小写+样式来运行更像一个小笔记本电脑。 它的设计是可以用作平板电脑，或用可防腐键盘/大小写+样式来运行更像一个小笔记本电脑。 它的设计是可以用作平板电脑，或用可防腐键盘/大小写+样式来运行更像一个小笔记本电脑。 主要规格： - 显示：12.35点正在呈现IPS面板，分辨率~2560×1600，亮度~500牛顿。 - 处理器： ARMcrosschip RK3588S SOC。 -- 内存和存储︰ 8 GB LPDDR4X RAM；存储率为128 GB eMC。 可通过微型SD扩展。 可通过微型SD扩展。 内存和存储︰ 8 GB LPDDR4X RAM；存储率为128 GB eMC。 可通过微型SD扩展。 可通过微型SD扩展。 可通过微型SD扩展。 +- 内存和存储︰ 8 GB LPDDR4X RAM；存储率为128 GB eMC。 可通过微型SD扩展。 可通过微型SD扩展。 内存和存储︰ 8 GB LPDDR4X RAM；存储率为128 GB eMC。 可通过微型SD扩展。 可通过微型SD扩展。 可通过微型SD扩展。 内存和存储︰ 8 GB LPDDR4X RAM；存储率为128 GB eMC。 可通过微型SD扩展。 可通过微型SD扩展。 可通过微型SD扩展。 - 电池：约42小时电池寿命估计高达~10小时。 - 其他功能：Wifi 6，蓝牙 4.2，指纹传感器，立体声器，5MP 前置摄像头，样式表支持。 @@ -25,6 +25,7 @@ FydetabDuo是由Fyde Innovations开发的一张2hinncrow1平板电脑。 FydeOS > {.is-info} > {.is-info} > {.is-info} +> {.is-info} # 2. 下载 @@ -44,6 +45,17 @@ sudo rkdeveloptool wl 0 ~/Downloads/BredOS.img 详细说明请参阅 [📦 如何安装到 eMMC](https://wiki.fydetabduo.com/os-release-board/BredOS/BredOS-intro) +# 4. 可选的 LTE模块 + +Fyde提供一个可选的LTE模块，即Quectel EM05，该模块通过NVMe连接并通过 USB 通信。 任何其它LTE模块只要通过 USB 通信并被 Linux 内核支持，就应该工作。 For installing a LTE module, [follow this guide](https://wiki.fydetabduo.com/Hacking-the-Fydetab-Duo/lte/). + +- 安装模块后，运行： + +``` +yay -S 调制解调器管理 +sudo systemctl 启用 --now 调制解调器管理器 +``` + # 4. 有用的链接 - [🐾 如何在 Mali GPU 上设置 Panthor (RK3588)](/how-to/how-to-setup-panthor) diff --git a/zh/hacks/pipewire-cpu.md b/zh/hacks/pipewire-cpu.md index a4b5a1cb..09d3485a 100644 --- a/zh/hacks/pipewire-cpu.md +++ b/zh/hacks/pipewire-cpu.md @@ -74,6 +74,7 @@ systemctl --user 守护进程重新加载 > {.is-warning} > {.is-warning} > {.is-warning} +> {.is-warning} 这个哈克不应影响您的音频。 如果你想让它有更多的回旋余地, 更改行`CPUQuota`的百分比。 \ No newline at end of file diff --git a/zh/home.md b/zh/home.md index ca9fbb55..64c1c63f 100644 --- a/zh/home.md +++ b/zh/home.md @@ -2,7 +2,7 @@ title: 主页 description: published: true -date: 2025-10-06T09:38:43.497Z +date: 2025-10-06T05:45:30.312Z tags: editor: markdown dateCreated: 2024-07-19T14:28:40.812Z @@ -32,7 +32,7 @@ dateCreated: 2024-07-19T14:28:40.812Z - Bakery - [your guide to your own Bred](/install/first-setup)! - Bred-News - [the news channel about your Bred](/customizations/news)! - Bred-Tools - [你手上的swiss knife](/Tools)！ -- Bed-配置 - [就像皮-config，但是有更好的标记](/bredos-config) ！ +- Bed-配置 - [就像皮-config，但是有更好的味道！](/bredos-config) - Govctl - [控制您的 CPU](/how-to/govctl) ！ # 🔁 3. 🛠️ 系统要求 @@ -44,13 +44,13 @@ dateCreated: 2024-07-19T14:28:40.812Z - **🧠 最小内存**：2 GB - **💾 存储**：16 GB 或更大的 microSD 卡 -# 🚀 4. 刷入 +# 5. 刷入 -我们的朋友[**DroidMaster**](https://www.youtube.com/@LinuxDroidMaster) 制作了一个关于BredOS的YouTube视频。 在这里查看： 在这里查看： 在这里查看： 在这里查看： +我们的朋友[**DroidMaster**](https://www.youtube.com/@LinuxDroidMaster) 制作了一个关于BredOS的YouTube视频。 在这里查看： 在这里查看： 在这里查看： 在这里查看： 在这里查看： -# 🔄 3. 安装 +# 🔄 3. 刷入 您可以在我们的 [website](https://bredos.org/download.html) 中找到图像的下载链接！ @@ -91,7 +91,7 @@ If your device isn’t listed on our [download site](https://bredos.org/download # 10. 主播活动 -BredOS 是一个开源项目，欢迎贡献！您可以通过以下方式做出贡献： 您可以通过以下方式做出贡献： 您可以通过以下方式做出贡献： 您可以通过以下方式做出贡献： 您可以通过以下方式做出贡献： +BredOS 是一个开源项目，欢迎贡献！您可以通过以下方式做出贡献： 您可以通过以下方式做出贡献： 您可以通过以下方式做出贡献： 您可以通过以下方式做出贡献： 您可以通过以下方式做出贡献： 您可以通过以下方式做出贡献： - 🐛 报告错误和问题 - 💻 提交补丁和改进 diff --git a/zh/how-to.md b/zh/how-to.md index eddfad69..5d476740 100644 --- a/zh/how-to.md +++ b/zh/how-to.md @@ -2,7 +2,7 @@ title: 如何发送到！ description: 关于如何在 BredOS 中安装或使用某些功能的指南、教程和提示 published: true -date: 2025-10-24T05:45:33.133Z +date: 2025-12-13T21：40：48.601Z tags: editor: markdown dateCreated: 2024-08-27T06:01:06.954Z @@ -50,6 +50,11 @@ dateCreated: 2024-08-27T06:01:06.954Z - [如何启用 DTBOs](/en/how-to/how-to-enable-dtbos) +- [如何让你的 SBC 获得电源](/en/how-to/psu-charger-and-cables) + +- [如何保持MicroSD卡](/en/how-to/sdcard-maint) + > ✨ 探索这些指南以获得最佳的 BredOS 体验！ > {.is-info} > {.is-info} +> {.is-info} diff --git a/zh/how-to/Browser_Setup.md b/zh/how-to/Browser_Setup.md new file mode 100644 index 00000000..2a045f36 --- /dev/null +++ b/zh/how-to/Browser_Setup.md @@ -0,0 +1,232 @@ +--- +title: 浏览器设置 +description: 在 ARM64 板上使用 BredOS 设置一个GPU加速浏览器 +published: true +date: 2026-03-07T16：35：11.784Z +tags: 浏览器、 铬、 gpu、 wayland、 arm64 +editor: markdown +dateCreated: 2026-03-07T16：08：59.754Z +--- + +# 2. 介绍信息 + +运行BredOS 的ARM64 板通过 Panfrost (OpenGL ES3.1) 和 PanVK (Vulkan 1.4) Mesa 驱动程序具有完全的 GPU 加速功能。 然而，并非所有浏览器都能平等地利用这种机会。 本指南包括通过 Flatpak设置 `Ungoogled Chromium` ，最优化的 GPU 旗帜，用于平稳浏览体验。 + +> 目前没有任何浏览器通过 V4L2 无条件的 API 支持硬件视频解码。 关于硬件加速的视频播放，见部分 [5。 YouTube硬件解码](#h-5-youtube-with-hardware-decode)。 +> {.is-info} + +# 3. 浏览器比较 + +- 下表比较了ARM64上的主要浏览器选项和 BredOS： + +| 功能 | 未oged Chromium (Flatpak) | Firefox / LibreWolf | +| ------------------------ | :-------------------------------------------------------------: | :--------------------------------------------: | +| GPU 组成 | 全(ANGLE + Panfrost GLES 3.1) | partial(WebRender, 较少优化ARM) | +| GPU 光栅化 | 所有页面 | 限量的 | +| WebGL | 硬件加速了 | 硬件加速了 | +| WebGPU | 硬件加速了 | 不支持 | +| 零拷贝组成 | 支持的 | 不支持 | +| 视频解码 | 仅软件 | 仅软件 | +| Wayland | 本机(臭氧) | 原生的 | +| 平板可用性 | 可用 | 可用 | +| {.dense} | | | + +Chromium的非通用后端映射到Panfrost的 OpenGL ES3.1，提供了完整的硬件加速页面渲染、合成和WebGL/WebGPU。 适用于 ARM Mali GPU 的 Firefox WebRender 的优化程度较低。 + +> **Flatpak中的 GPU 堆栈**：Flatpak 运行时间包括Panthor DRI + PanVK (Vulkan 1.4) + Panfrost (GLES 3.1). 使用 `devices=all` 和 `sockets=wayland` 权限，沙盒可以完全访问 GPU 。 +> {.is-info} + +# 4. 安装 rkdeveloptool + +## 3.1 Install Flatpak + +- 安装 Flatpak 并添加 Flathub 仓库： + +``` +sudo pacman -S flatpak +sudo flatpak remote-added --if-not-exists flathuthub https://dl.flathub.org/repo/flathub.flatpakrepo +sudo flatpak 更新 --appstream +``` + +## 3.2 安装 Ungoogled Chromium + +- 从Flathub安装浏览器： + +``` +sudo flatpak install -y flathub io.github.ungoogled_software.ungoogled_chromium +``` + +# 5. GPU 加速设置 + +## 4.1 带GPU标志的桌面输入 + +若要在Wayland上以完全GPU加速度启动 Chromium ，请创建自定义桌面条目。 + +- 创建桌面项： + +``` +mkdir -p ~/.local/share/applications +cat > ~/.local/share/applications/ungoogled-chromium-gpu。 esktop <'EOF' +[桌面条目] +Type=Application +名称=Ungoogled Chromium (GPU) +Comment=Web Browser 与 Wayland + Vulkan GPU 加速 +Exec=flatpak 运行 io.github.ungoogled_software。 ngoogled_chromium --ignore-gpu-blocklist --enable-Nuclear copy --ozo platform=wayland --use-gl=egl --enable-features=Vulkan,Vulkan,Vulkan,FromANGE,DefaultANGLEVulkan,WaylandWindowDecorations +Icon=io.github.ungoogled_software.ungoogled_chromium +Categories=Network;WebBrowser; +Startupnotefy=true +EOF +update-desktop data ~/.local/share/applications/ +``` + +## 4.2 旗帜参考 + +- 每个国旗都有一个特定的目的： + +| 标志 | 目的 | +| ------------------------------------------- | -------------------------------------- | +| `--ozone-platform=wayland` | 本土的瓦地-避免XWayland的间接费用 | +| `--use-gl=egl` | 直接使用EGL (Wayland需要) | +| `--ignore-gpu-blocklist` | 允许ARM GPU加速度 | +| `--enable-零拷贝` | GPU 和合成器之间零复制缓冲区共享 | +| `Vulkan,VulkanFromANGLE,DefaultANGLEVulkan` | 透过PanVK Vulkan 1.4渲染 | +| `WaylandWindowDecorations` | Wayland下的本机窗口装饰 | +| {.dense} | | + +> **备份**：如果Vulkan在你的板上造成崩溃，则从`--enable-features`中移除3个Vulkan特征，并且只保留`--use-gl=egl`。 这可以通过Panfrost返回OpenGL ES, 而后者仍然是硬件加速。 +> {.is-info} + +## 4.3 验证 GPU 加速 + +使用 GPU 标志启动 Chromium 后： + +- 在地址栏中打开 `chrome://gpu` 。 + +您应该看到： + +- **GL_RENDER**: `Mali-G610` / `panfrost` / `panvk` (不是 `SwiftShader` 或 `lvmpipe`) +- **Canvas**: 硬件加速了 +- **组合**：硬件加速了 +- **Rasterization**：硬件加速了 +- **WebGL**：硬件加速 +- **WebGPU**：硬件加速 + +> 如果`GL_RENDER`显示`SwiftShader`或`llvmpipe`，GPU加速则未激活。 Check that Flatpak has `devices=all` permission: `flatpak info --show-permissions io.github.ungoogled_software.ungoogled_chromium` +> {.is-warning} + +# 4. Youtube 硬件解码器 + +ARM64 上没有浏览器支持 V4L2 无国籍解码，这是在主线RK3588 内核上使用的硬件视频解码方法。 若要以硬件加速播放YouTube视频，请使用 `mpv` + `yt-dlp`。 + +## 5.1 安装mpv 和 yt-dlp + +- 安装必需的软件包： + +``` +sudo pacman -S mpv yt-dlp +``` + +## 5.2 从终端播放 + +- 用硬件解码播放YouTube视频： + +``` +mpv 'https://youtube.com/watch?v=VIDEO_ID' +``` + +`mpv` 自动使用 `yt-dlp` 方法解压视频 URL 和 RKVDEC2 来解码硬件。 + +## 5.3 从浏览器播放(书签) + +您可以直接从 Chromium 创建一个书签来打开当前页面。 + +- Create a protocol handler script: + +``` +mkdir -p ~/.local/bin +cat > ~/.local/bin/mpv-handler.sh << 'SCRIPT' +#!/bin/sh +url=$(echo "$1" | sed 's|^mpv://||') +exec mpv "$url" +SCRIPT +chmod +x ~/.local/bin/mpv-handler.sh +``` + +- 为 'mpv://' 协议创建桌面条目： + +``` +cat > ~/.local/share/applications/mpv-handler.desktop << 'EOF' +[Desktop Entry] +Type=Application +Name=mpv URL Handler +Exec=/home/$USER/.local/bin/mpv-handler.sh %u +MimeType=x-scheme-handler/mpv; +NoDisplay=true +EOF +xdg-mime default mpv-handler.desktop x-scheme-handler/mpv +``` + +- 将此书签添加到您的浏览器书签栏： + +``` +javascript:void(window.open('mpv://'+location.href)) +``` + +点击任意YouTube页面上的书签，用硬件加速解码来打开它。 + +# 🔄 3. 🤝 贡献 + +## 6.1 Chromium 显示软件渲染器 + +如果`chrome://gpu`显示软件渲染： + +- 验证 Flatpak GPU 权限： + +``` +flatpak info --show-permissionio.github.ungoogled_software.ungoogled_chromium +``` + +输出应该包含 `devices=all` 和 `sockets=wayland` 。 如果不是: + +- 手动覆盖权限： + +``` +flatpak override --user --device=all io.github.ungoogled_software.ungoogled_chromium +flatpak override --user --socket=wayland io.github.ungoogled_software.ungoogled_chromium +``` + +## 6.2 Chromium 撞击了Vulkan 旗帜。 + +有些板块或网格版本可能与 PanVK 有问题。 删除Vulkan功能。 + +- 使用这个更简单的旗帜设定： + +``` +flatpak 运行 io.github.ungoogled_software.ungoogled_chromium --ignore-gpu-blocklist --enable-Non-copy --ozone platform=wayland --use-gl=egl --enable-features=WaylandWindowDecorations +``` + +这仍然是通过 Panfrost (OpenGL ES) 使用 GPU 加速，而无需使用 Vulkan 路径。 + +## 6.3mpv 不使用硬件解码 + +- 验证 RKVDEC2 可用： + +``` +ls /dev/video-dec0 +``` + +如果设备节点丢失，请检查内核模块是否已加载： + +- 检查 RKVDEC2 模块： + +``` +lsmod | grep rockchip_vdec +``` + +# 9. 参考 + +- [Chromium GPU Acceleration docs](https://chromium.googlesource.com/chromium/src/+/main/docs/gpu/gpu_testing.md) - Chromium Project +- [Mesa Panfrost 驱动器](https://docs.mesa3d.org/drivers/panfrost.html) - Mesa +- [Mesa PanVK driver](https://docs.mesa3d.org/drivers/panvk.html) - Mesa +- [Flatpak 文档](https://docs.flatpak.org/) - Flatpak +- [mpv manual](https://mpv.io/manual/stable/) - mpv \ No newline at end of file diff --git a/zh/how-to/Cinammon_Wayland.md b/zh/how-to/Cinammon_Wayland.md new file mode 100644 index 00000000..2a6e8a01 --- /dev/null +++ b/zh/how-to/Cinammon_Wayland.md @@ -0,0 +1,532 @@ +--- +title: Cinnamon Wayland 与 GPU 加速 RK3588 +description: 用 RK3588 板上的硬件加速渲染从 X11 切换到Wayland +published: true +date: 2026-03-09T11：58：25.761Z +tags: 电影院, 航行, gpu, panthor, rk3588 +editor: markdown +dateCreated: 2026-03-07T16：06：02.388Z +--- + +# 2. 介绍信息 + +Cinnamon 支持 Wayland 会话，从版本 `6.4`开始。 在 RK3588 板上 从 X11 切换到 Wayland 需要额外配置，因为SoC 会显示两个单独的 DRM 设备：一个用于显示输出, 一个用于GPU 渲染。 没有正确的设置，Cinnamon的合成器 (`Muffin`) 返回到`llvmpipe` 软件渲染，导致桌面性能不佳。 + +本指南通过开启完全GPU-加速的 Cinnamon Wayland 会话在BredOS上游。 + +> **已知限制 (Muffin 6.6.x)：** Muffin 尚不支持上游Mutter的 `mutter-device-chered-primarary` udev标签。 合成器本身正确使用 GPU 来构造桌面通过 GBM, 但Wayland EGL 客户端(GTK OpenGL 应用程序) 可能仍然会回到“llvmpipe”。 Vulkan 应用程序 (mpv, browsers, vkmark) 不受影响。 这一点已经在Rock 5B+ 和 Orange Pi 5 Plus上得到确认。 关于详细信息和工作情况，请参阅[第 7.8节](#h-78-wayland-egl-clients-use-llvmpipe-known-muffin-limitation节)。 其他Wayland作曲家(GNOME, KDE)在同一个硬件上正确处理多GPU。 +> {.is-info} + +# 3. 创建热点 + +## 2.1 所需软件包 + +- 验证所有必需的软件包已安装： + +``` +sudo pacman -S --need cinnamon muffin wayland xorg-xwayland libink pipewire mesa libdrm +``` + +## 2.2 内核和 GPU 驱动程序 + +本指南假设您已经启用了Panthor GPU驱动程序。 如果您仍在使用 Panfork (RK35xx) 的 BredOS 上默认值， 请先按照[安装马里的Panthor GPU with RK3588](/en/how-to/how-to-setup-panthor)指南，然后返回这里。 + +- 验证 panthor\` 模块已加载： + +``` +lsmod | grep panthor +``` + +你应该在输出中看到了 panthor\`。 如果不是，手动加载： + +- 加载模块： + +``` +sudo modprobe panthor +``` + +> Panthor 需要 BredOS BSP 内核6.1-rkr3 或主线内核“6.12” 或更高版本。 如果模块不可用，请更新内核。 +> {.is-info} + +## 2.3 用户权限 + +您的用户必须属于“渲染”和“视频”组才能访问 GPU 渲染节点。 没有这些权限，应用程序就会静默地回到软件渲染上。 + +- 检查您当前的组： + +``` +组 +``` + +如果输出缺少`render` 或 `video` ，请将您的用户添加到两个组： + +``` +sudo usermod -aG render,video $USER +``` + +**注销并重新登录以使群组更改生效。** + +- 验证 GPU 渲染节点存在并可访问： + +``` +ls -la /dev/dri/ +``` + +你应该至少看到`card0`、`card1`和`renderD128`。 `renderD128` 设备应该被`render` 组所拥有，并且必须有`crw-rw----`的权限。 + +> 如果`/dev/dri/renderD128` 完全缺失，Panthor 驱动无法初始化。 请检查`dmesg | grep -i panthor` 以了解错误。 +> {.is-info} + +# 4. 理解双GPU设置 + +在 RK3588 板上，内核暴露了两个DRI 卡设备。 这是Cinnamon Wayland大多数GPU加速问题的根源。 + +- 下表显示每个设备的角色： + +| 设备 | 驱动程序 | 作用 | +| ------------------------ | -------------- | ---------------------------------------------------------------- | +| `/dev/dri/card0` | `rockchip-drm` | 显示控制器 (HDMI/DP 输出). 没有 3D 渲染。 | +| `/dev/dri/card1` | `panthor` | GPU (Mali-G610). 处理所有3D渲染。 | +| `/dev/dri/renderD128` | `panthor` | GPU 渲染节点(3D) | +| {.dense} | | | + +问题: `Muffin` (Cinnamon's compositor, a fork of GNOME's Mutter) 尝试使用 `card0` 作为默认渲染。 因为`rockchip-drm`没有3D功能，它回落到`llvmpipe`(CPU软件渲染)。 + +解决方法：告诉Muffin使用 panthor` 渲染节点以加速GPU ，同时保持`rockchip-drm\` 以显示输出。 + +- 验证您的设备布局： + +``` +ls -l /dev/dri/ +``` + +- 检查每张卡背面的驱动程序： + +``` +udevadm info -q property -n /dev/dri/card0 | grep DRIVER +udevadm info -q property -n /dev/dri/card1 | grep DRIVER +``` + +# 5. 配置 GPU 选择 + +## 4.1 创建 Udev 规则 + +最可靠的方法是 `udev` 规则，它告诉Muffin 设备更喜欢渲染。 + +- 创建 udev 规则文件： + +``` +sudo nano /etc/udev/rules.d/61-mutter-mutpanthor.rules +``` + +- 增加以下内容： + +``` +# RK3588: 将Panthor 渲染节点标记为Mutter/Muffin +SUBSYSTEM=="drm", KERNEL=="card1", DRIVERS=="panthor", TAG+="mutter-device-heaved-primarary" +``` + +- 重新加载udev规则： + +``` +sudo udevadm control --reload +sudo udevadm trigger +``` + +- 验证标签是否已应用： + +``` +udevadm info -q all -n /dev/dri/card1 | grep mutter +``` + +你应该在输出中看到`mutter-device-chered-primary`。 + +## 4.2 设置环境变量 + +除了udev规则外，设置环境变量，帮助Muffin和Mesa选择正确的 GPU。 + +- 创建环境配置文件： + +``` +sudo nano /etc/environment.d/90-rk3588-gpu.conf +``` + +- 增加以下内容： + +``` +# Mutter/Muffin Wayland +MUTTER_ALLOW_HYBRID_GPUS=1 + +# 启用 OpenGL 3.3 (Panfrost definition to 3.1, some applications request 3.3+) +PAN_MESA_DEBUG=gl3 +``` + +`PAN_MESA_DEBUG=gl3`变量允许在Mali-G610 GPU上进行实验性OpenGL 3.3支持。 没有它，Panfrost只能暴露OpenGL 3.1，它会阻止像`kitty`这样的应用程序启动. 如果特定应用程序显示渲染伪影，请在没有标志的情况下启动它： + +``` +PAN_MESA_DEBUG=应用程序名称 +``` + +> 不设置 `WLR_DRM_DEVICES` - 变量适用于wlroot-based composator(Sway, Hyprland)，而不适用于Muffin。 设置它对 Cinnamon 没有影响。 +> {.is-info} + +## 4.3 删除不正确的配置 + +如果你先前创建了一个 `/etc/environment.d/gpu-wayland.conf` 等变量，如`WLR_DRM_DEVICES`, `MESA_LOADER_DRIVER_OVERRIDE`, 或 `MUTTER_DEBUG_FORCE_EGL_STREAM`, 移除或重命名它。 这些变量不适用于Muffin，可能导致意外行为。 + +- 检查旧配置： + +``` +ls /etc/environment.d/ +``` + +- 删除任何不正确的文件： + +``` +sudo rm /etc/environment.d/gpu-wayland.conf +``` + +# 4. 选择航道会话 + +## 5.1 来自登录屏幕 + +大多数显示管理器 (LightDM, GDM 允许从登录屏幕中选择会话类型。 + +- 在登录屏幕上寻找一个装备图标或会话选择器 +- 选择 `Cinnamon (Wayland)` 而不是 `Cinnamon` +- 正常登录 + +## 5.2 验证会话类型 + +登录后： + +- 确认您正在运行一个航道会话： + +``` +echo $XDG_SESSION_TYPE +``` + +产出应为“wayland”。 + +# 🔄 3. 配置硬件视频回放的 mpv + +在 RK3588, `mpv` 可以使用 V4L2 请求API 进行硬件视频解码，Vulkan 进行渲染输出。 这完全绕过了Wayland EGL 的路径，确保播放顺利，不管导言中描述的Muffin 限制。 + +- 安装 mpv 和 yt-dlp： + +``` +sudo pacman -S --needed mpv yt-dlp +``` + +- 创建或编辑 mpv 配置文件： + +``` +nano ~/.config/mpv/mpv.conf +``` + +- 增加以下内容： + +``` +hwdec=v4l2request +vo=gpu-next ,gpu +gpu-api=vulkan +gpu-context=waylandvk +ytdl-格式=bestvideo[height<=?1080]+bestaudio +``` + +| 选项 | 目的 | +| ------------------------ | ------------------------------------------------------ | +| `hwdec=v4l2request` | 通过 V4L2 无条件API 解码硬件视频 (零复制 DMA-BUF) | +| `vo=gpu-next,gpu` | 通过 libplesbo 输出视频(如果需要，所有视频返回gpu ) | +| `gpu-api=vulkan` | 使用 PanVK Vulkan 驱动程序(工作正确，绕过EGL) | +| `gpu-context=waylandvk` | Wayland Vulkan WSI(无XWayland) | +| `ytdl格式=...` | 限制YouTube 到 1080p 以避免过多加载硬件解码器 | +| {.dense} | | + +- 测试播放： + +``` +mpv --fs https://www.youtube.com/watch?v=LXb3EKWsInQ +``` + +您应该在输出中看到`使用硬件解码 (v4l2request)` 和 `VO: [gpu-next]` 。 视频应在不放置帧的情况下顺利播放。 + +> 没有Vulkan 配置，mpv 默认为通过 Wayland EGL 路径的 OpenGL ，这个路径返回到 Cinnamon 的 `llvmpipe` 软件渲染。 这就造成了严重的框架滴（每分钟数百帧）。 总是使用上面的 Vulkan 配置。 +> {.is-info} + +# 9. 验证 GPU 加速 + +## 7.1 检查渲染器 + +在Wayland，您必须使用 `eglinfo` 来检查GPU 加速。 `glxinfo`命令通过 XWayland 即使在合成器加速时也会显示 `llvmpipe` (见[第8.1节](#h-81-glxinfo-still-shows-llvmpipe))。 + +- 安装`eglinfo` 如果不存在： + +``` +sudo pacman -S --needmesa-utils +``` + +- 检查 GBM 和设备渲染器： + +``` +eglinfo -B 2>/dev/null | grep -A5 "GBM 平台" +``` + +``` +eglinfo -B 2>/dev/null | grep -A10 "设备 #0" +``` + +你应该在两项产出中看到`Mali-G610 MC4 (Panfrost)`，而不是`llvmpipe`。 渲染器名称 `Panfrost` 正确，即使使用了 `panthor` 内核驱动程序 — Mesa's OpenGL 驱动程序被命名为全马里Valhall GPU的 Panfrost。 + +- 检查Wayland平台： + +``` +eglinfo -B 2>/dev/null | grep -A10 "Wayland 平台" +``` + +> 由于导入中描述的 Muffin 限制，Wayland 平台可能会显示`llvmpipe`，即使合成器正在使用 GPU。 这是一个众所周知的问题。 使用上面的 GBM 和设备平台检查来验证 GPU 加速。 +> {.is-info} + +- 检查 Vulkan (应该始终工作)： + +``` +vulkaninfo --summary 2>/dev/null | grep -A3 "GPU" +``` + +你应该看到`panvk`驱动程序`Mali-G610 MC4`。 + +## 7.2 检查合成状态 + +- 打开 Cinnamon的系统设置，导航到 `General` 并检查是否启用 `Compositing` +- 或者，从终端中检查： + +``` +dconf read /org/cinnamon/muffin/compositing-manager +``` + +输出应为“true”。 + +# 4. 🤝 贡献 + +- 如果您遇到问题，首先生成完整的系统报告。 这将在一次枪口中收集所有硬件和软件信息，并且可以很容易地在 [BredOS Discord] (https://discord.gg/beSUnWGVH2 上获得帮助： + +``` +sudo sys-report +``` + +- 此上传报表到 `termbin.com` 并打印您可以分享的 URL。 要保存本地版本： + +``` +sudo syss-report -l +``` + +## 8.1 glxinfo Still Shows llvmpipe + +预期在韦兰会有这种情况。 `glxinfo`命令使用通过 XWayland 的 GLX 协议。 即使有完全GPU-加速的Wayland会话，`glxinfo`也可能会报告`llvmpipe`，因为XWayland可能无法访问 GPU 渲染节点。 + +- 使用 `eglinfo` 来验证 Wayland 渲染器(参见[第7.1节](#h-71-check-the-renderer) 和 [第8.8节](#h-88-wayland-egl-clients-use-llvmpipe-known-muffin-limitation)) +- 要修复在 XWayland 下运行的 X11 应用程序的 "glxinfo" ，请尝试： + +``` +DRI_PRIME=1 glxinfo -B +``` + +## 8.2 Panthor loaded but no GPU Rendering + +如果`lsomd | grep panthor` 显示该模块已加载，但应用程序仍然使用 `llvmpipe`，通过这些检查： + +**检查1：渲染节点存在** + +``` +ls -la /dev/dri/ +``` + +- 如果 `renderD128` 丢失，Panthor 无法初始化。 检查内核日志： + +``` +dmesg | grep -i panthor +``` + +共同原因： + +- 缺少固件：检查 `dmesg | grep -i 固件| grep -i mali` 。 必须安装 `mali-G610-firmware` 包，固件文件必须在 `/lib/firmware/arm/mali/arch10.8/` 中。 +- 未启用设备树叠加层：如果您在内核6.1-rkr3中，请按照[设置面板](/en/how-to/how-to-setup-panthor]指南启用`rockchip-rk3588-panthor-gpu`DTBO'。 + +**检查 2: 用户权限** + +``` +ls -la /dev/dri/renderD128 +组 +``` + +如果存在`renderD128` 但您的用户不在`render` 组中，请参阅[2.3](#h-23-user-permissions)。 + +**勾选3： 网格检测到 GPU** + +``` +eglinfo -B 2>/dev/null | grep -A5 "设备平台" +``` + +- 如果输出显示空设备或只有`llvmpipe`, Mesa没有找到Panthor驱动器。 验证您使用的是标准的`mesa`软件包(不是 `mesa-panfork-git`)： + +``` +pacman -Q mesa +``` + +- 如果它显示 `mesa-panfork-git`, 替换它： + +``` +sudo pacman -S mesa +``` + +**勾选4： 没有冲突的 libMali** + +``` +pacman -Q | grep -i mali +``` + +- 你只能看到`mali-G610-firmware'。 如果安装了任何`libmali-valhall-g610\`软件包，它与Mesa的开源驱动程序冲突： + +``` +sudo pacman -R libmali-valhall-g610 +``` + +**检查5：环境变量覆盖** + +- 旧或不正确的环境变量可以强制Mesa使用错误的驱动： + +``` +env | grep -iE "mesa|gallium|dri|gpu|libgl|egl" +``` + +如果设置了任何`MESA_LOADER_DRIVER_OVERRIDE`, `LIBGL_ALWAYS_SOFTWARE`, `GALLIUM_DRIVER`, 或 `__GLX_VENDOR_LIBRARY_NAME` ，将其从您的环境配置文件中删除或将其设定。 + +## 8.3 Vulkan 错误(VK_ERROR_INCOMPATIBLE_DRIVER) + +如果你在运行图形应用程序时看到像`ZINK: vkCreateInstance 失败 (VK_ERROR_INCOMPATIBLE_DRIVER)` 错误： + +- 这意味着Mesa正在尝试使用 Zink 驱动程序(OpenGL-overVulkan)，但没有可用的 Vulkan 驱动程序。 安装 Vulkan 软件包： + +``` +sudo pacman -S --need vulkan-icd-loader vulkan-panfrost +``` + +- 验证检测到 PanVK ： + +``` +vulkaninfo --summary 2>/dev/null | grep -A3 "GPU" +``` + +你应该在输出中看到`Mali-G610`或`panvk`。 + +> 此错误不会阻止GPU加速OpenGL 正常工作。 如果Panthor设置正确，Mesa会使用 OpenGL 的本机Gallium 驱动程序，而不要穿过Zink/Vulkan。 然而，建议为需要Vulkan的应用程序安装 PanVK 。 +> {.is-info} + +## 8.4 Cinnamon Falls 返回软件渲染中 + +如果您确认Panthor正常(检查[第8.2节](#h-82-panthor-loaded-but-no-gpu-rendering) 所有通过)，但Cinnamon的合成器仍然使用软件渲染： + +- 验证 udev 规则已经应用(见[4.1节] (#h-41-create-a-udev-rule): + +``` +udevadm info -q all -n /dev/dri/card1 | grep mutter +``` + +- Check that `MUTTER_ALLOW_HYBRID_GPUS=1` is set (see [section 4.2](#h-42-set-environment-variables)) + +- 查看 Muffin的日志错误： + +``` +journalctl --user -b | grep -i muffin +``` + +- 请确保合成未禁用： + +``` +dconf read /org/cinnamon/muffin/compositing-manager +``` + +- 如果输出为 'false' 或 '空白' ，则启用它： + +``` +dconf write /org/cinnamon/muffin/compositing-manager true +``` + +## 8.5 黑屏或登录循环 + +如果Wayland会话未能开始： + +- 使用 `Ctrl+Alt+F2` 切换到TTY 并登录 +- 检查会话日志： + +``` +journalctl --user -b -u cinnamon-session +``` + +- 作为一个工作区，从登录界面回到X11会话并验证您的配置 + +## 8.6 屏幕窃听或性能差 + +如果会话开始，但性能很差： + +- Verify compositing is enabled (see [section 7.2](#h-72-check-compositing-status)) +- 检查系统会话是否覆盖了 Flatpak 或 Snap 版本 +- 如果你看到渲染伪影，请尝试将 `CLUTTER_PAINT=disable-culling` 添加到 `/etc/environment.d/90-rk3588-gpu.conf` + +## 8.7 恢复到X11 + +如果Wayland工作不正确， 您总是可以通过选择 `Cinnamon` 会话切换回X11 (没有"航行"标签)。 + +## 8.8 Wayland EGL 客户使用llvmpipe (Known Muffin Limitation) + +如果`eglinfo`中的GBM和设备平台正确显示`Mali-G610 MC4(Panfrost)`，但Wayland平台却显示 `llvmpipe`， 这是Muffin `6中已知的限制。 .x`。 + +**解释：** Muffin 正确地使用 GPU 进行自己的桌面构造(通过 GBM)。 然而，它通过“wl_drm”协议向Wayland客户端发布错误的DRM设备。 它宣布`card0` (rockchip-drm, 显示没有3D能力的控制器)，而不是`card1`/`renderD128` (Panthor, GPU)。 所有Wayland EGL 客户端继承这个错误的设备并退回到\`llvmpipe'。 + +GNOME 的 Mutter 通过[`meta_is_udev_dev_device_hered_primarary()`](https://gitlab.gnome.org/GNOME/mutter/-/blob/main/src/backends/meta-udev.c) 函数解决了这个问题，该函数读取了 `mutter-device-heaved-primarary` udev 标签。 Muffin 尚未从上游Mutter移过此函数。 [第4节]的udev规则。 ](#h-41-create-a-udev-rule) 仍然被推荐(其他作曲家和未来的 Muffin 版本将使用它)，但它对当前的 Muffin 版本没有影响。 + +- 通过检查 DRM 设备 Muffin 是否打开来验证限制： + +``` +ls -la /proc/$(pgrep -f 'cinnamon --reples' -o)/fd 2>/dev/null | grep dri +``` + +你应该看到`card0`和`renderD128`打开，确认Muffin使用GPU进行复制。 + +**尽管有这种限制，什么还能起作用:** + +| 组件 | 状态 | 原因 | +| ---------------------------------------------------- | -------------------------------- | --------------- | +| 桌面组成 | GPU加速 | Muffin 直接使用 GBM | +| Vulkan 应用 (mpv, vkmark, browsers) | GPU加速 | PanVK 完全旁路 EGL | +| Wayland EGL 应用 (GTK OpenGL) | 软件 (llvmpipe) | 错误的 DRM 设备广告 | +| {.dense} | | | + +**正常工作：** + +- Use Vulkan rendering where possible (see [section 6](#h-6-configure-mpv-for-hardware-video-playback) for mpv) +- 使用 GNOME 或 KDE Wayland 代替，在相同的硬件上正确处理 multiGPU +- 跟踪上游问题: [linuxmin/muffin](https://github.com/linuxmint/muffin/issues) + +# 10. Summary + +- 下表汇总了所需的变化： + +| 什么 | 文件 | 内容 | +| ------------------------ | ------------------------------------------- | --------------------------------------------------- | +| Udev 规则 | `/etc/udev/rules.d/61-mutter-Panthor.rules` | 标记`card1`为`突变设备-首选原始` | +| 环境 | `/etc/environment.d/90-rk3588-gpu.conf` | `MUTTER_ALLOW_HYBRID_GPUS=1` 和 `PAN_MESA_DEBUG=gl3` | +| mpv 配置 | `~/.conf/mpv/mpv.conf` | Vulkan 渲染 + V4L2 硬件解码 | +| 会议 | 登录屏幕 | 选择 `Cinnamon (Wayland)` | +| {.dense} | | | + +# 10. 参考 + +- [Muffin 源代码](https://github.com/linuxmint/muffin) - Linux Mint +- [完全多GPU支持](https://gitlab.gnome.org/GNOME/mutter) - GNOME +- [Mutter `meta_is_udev_device_chered_primary` 实现](https://gitlab.gnome.org/GNOME/mutter/-/blob/main/src/backends/meta-udev.c) - GNOME (在Muffin中失踪) +- [Mesa Panfrost 驱动文档](https://docs.mesa3d.org/drivers/panfrost.html) - Mesa +- [设置马里的Panthor 与 RK3588](https://wiki.bredos.org/en/how-to/how-to-setup-panthor) - BredOS Wiki +- [BredOS 系统报告](https://github.com/BredOS/sys-report) - 系统诊断工具 +- [kitty OpenGL 3.3 workaround](https://github.com/kovidgoyal/kitty/issues/2790#issuecomment-969195133) - PAN_MESA_DEBUG=gl3 +- [Armbian RK3588 GPU 加速讨论](https://forum.armbian.com/topic/56374-expected-default-graphics-acceleration-for-rk3588/) - Armbian Forum \ No newline at end of file diff --git a/zh/how-to/bredos-chroot.md b/zh/how-to/bredos-chroot.md index 490c86d7..d3eaf31c 100644 --- a/zh/how-to/bredos-chroot.md +++ b/zh/how-to/bredos-chroot.md @@ -45,5 +45,6 @@ sudo bredos-chroot /dev/sdb3 /dev/sdb2 > {.is-info} > {.is-info} > {.is-info} +> {.is-info} - 这将获得一个根外壳进入破损的系统，便于维修。 这将获得一个根外壳进入破损的系统，便于维修。 一旦修理完成，您只需输入 `exit` 或 Ctrl + D 键就可以关闭外壳，附加的文件系统将被卸载。 这将获得一个根外壳进入破损的系统，便于维修。 一旦修理完成，您只需输入 `exit` 或 Ctrl + D 键就可以关闭外壳，附加的文件系统将被卸载。 这将获得一个根外壳进入破损的系统，便于维修。 一旦修理完成，您只需输入 `exit` 或 Ctrl + D 键就可以关闭外壳，附加的文件系统将被卸载。 \ No newline at end of file diff --git a/zh/how-to/change-default-boot-order-rk3588.md b/zh/how-to/change-default-boot-order-rk3588.md index 838b2d92..8b8d3fbb 100644 --- a/zh/how-to/change-default-boot-order-rk3588.md +++ b/zh/how-to/change-default-boot-order-rk3588.md @@ -2,7 +2,7 @@ title: 如何更改RK3588 上的默认启动顺序 description: 学习如何使用 UEFI 固件设置更改基于RK3588的设备上的默认启动订单 published: true -date: 2025-09-15T11：15：39.364Z +date: 2026-01-08T17：55：29.490Z tags: editor: markdown dateCreated: 2025-02-23T15:45:23.760Z @@ -19,34 +19,71 @@ dateCreated: 2025-02-23T15:45:23.760Z - 打开您的设备并等待 BredOS 标志在启动时出现。 - 在徽标显示时按一下`ESC`键进入UEFI菜单。 -![bredos_boot1.jpg](/boot_images/bredos_boot1.jpg) +
+屏幕截图 + +![uefi-boot-screen.png](/boot_images/uefi-boot-screen.png) + +
## 2.2 导航到启动订单设置 - 使用箭头键(`ODS` 和 `did `) 选择`启动维护管理器` 并按 `Enter`。\ ![bredos_boot2.jpg](/boot_images/bredos_boot2.jpg) -![bredos_boot2.jpg](/boot_images/bredos_boot2.jpg) +
+屏幕截图 + +![options-main.png](/boot_images/options-main.png) + +
- 在下一个屏幕上，选择 `Boot Options` 并按 `Enter` 键。 -![bredos_boot3.jpg](/boot_images/bredos_boot3.jpg) +
+屏幕截图 + +![optione-boot-maint-manager.png](/boot_images/optione-boot-maint-manager.png) + +
- 选择 `Change Boot Order` 并按 `Enter` 键。 -![bredos_boot4.jpg](/boot_images/bredos_boot4.jpg) +
+屏幕截图 + +![options-change-boot-order.png](/boot_images/options-change-boot-order.png) + +
## 2.3 修改启动订单 - 在启动订单菜单中，请按 `Enter`。 -![bredos_boot5.jpg](/boot_images/bredos_boot5.jpg) +
+屏幕截图 + +![show-boot-order.png](/boot_images/show-boot-order.png) + +
+ +
+屏幕截图 + +![change-boot-order.png](/boot_images/change-boot-order.png) + +
- 使用下箭头(“ODS”) 滚动到列表底部。 - 选择您想要移动到顶部的条目，然后按下 "+" 键到达顶部。\ ![bredos_boot6.jpg](/boot_images/bredos_boot6.jpg) -![bredos_boot6.jpg](/boot_images/bredos_boot6.jpg) +
+屏幕截图 + +![change-boot-order-finished.png](/boot_images/change-boot-order-finished.png) + +
- 一旦设置了所需的启动订单，请按 `Enter` 键确认。 @@ -54,9 +91,13 @@ dateCreated: 2025-02-23T15:45:23.760Z - 设置启动顺序后，按`Y`保存更改。 -![bredos_boot7.jpg](/boot_images/bredos_boot7.jpg) +
+屏幕截图 + +![change-boot-order-save.png](/boot_images/change-boot-order-save.png) -- 退出菜单并重启设备以应用新的引导顺序。 +
+- Exit the menu and restart the device to apply the new boot order. > 完成！ 完成！ 完成！ 您的设备现在将使用新的订单启动。 > {.is-success} diff --git a/zh/how-to/disk-failure.md b/zh/how-to/disk-failure.md index 790f8b31..076c1bb1 100644 --- a/zh/how-to/disk-failure.md +++ b/zh/how-to/disk-failure.md @@ -20,7 +20,7 @@ dateCreated: 2025-06-01T10:33:55.798Z # 2. 报告失败 -在BredOS, 我们拒绝让任何用户遭受数据丢失。 仔细阅读这篇文章；如果您需要进一步的帮助，请随时在我们的支持频道或通过邮件联系我们。 仔细阅读这篇文章；如果您需要进一步的帮助，请随时在我们的支持频道或通过邮件联系我们。 +在BredOS, 我们拒绝让任何用户遭受数据丢失。 仔细阅读这篇文章；如果您需要进一步的帮助，请随时在我们的支持频道或通过邮件联系我们。 仔细阅读这篇文章；如果您需要进一步的帮助，请随时在我们的支持频道或通过邮件联系我们。 仔细阅读这篇文章；如果您需要进一步的帮助，请随时在我们的支持频道或通过邮件联系我们。 - [📱 Telegram](https://t.me/bredoslinux) - [💬 Discord](https://discord.gg/jwhuyKXaa) @@ -43,6 +43,7 @@ BredOS 新闻服务现在将报告附加的已退化驱动程序。 > 每一个都有自己的部分。 > {.is-info} > {.is-info} +> {.is-info} - 假设硬盘 `/dev/sda`，查看它的 S.M.A.R.T 数据，运行： @@ -246,6 +247,7 @@ No Self-tests Logged > 不要在SD卡上运行此操作，它会崩溃它们。 > 它不会损害他们，但它不会做任何有益的事情。 它不会损害他们，但它不会做任何有益的事情。 > {.is-info} 它不会损害他们，但它不会做任何有益的事情。 +> {.is-info} 它不会损害他们，但它不会做任何有益的事情。 > {.is-info} - 假定`/dev/mmcblk0`，要查看它的控制器数据，请运行： @@ -435,7 +437,7 @@ eMMC Life Time Estimation B [EXT_CSD_DEVICE_LIFE_TIME_EST_TYP_B]: 0x01 如果你使用的 USB，SD卡 ~~或软盘驱动器 ~，很遗憾无法获得正确的报告数据。 -假定它是一个 BredOS 系统驱动器，它是使用 BTRFS 文件系统格式化的。 BTRFS 收集所有错误，可以提交完整的报告。 BTRFS 收集所有错误，可以提交完整的报告。 BTRFS 收集所有错误，可以提交完整的报告。 +假定它是一个 BredOS 系统驱动器，它是使用 BTRFS 文件系统格式化的。 BTRFS 收集所有错误，可以提交完整的报告。 BTRFS 收集所有错误，可以提交完整的报告。 BTRFS 收集所有错误，可以提交完整的报告。 BTRFS 收集所有错误，可以提交完整的报告。 - 假设`/dev/mmcblk0p3`, 为MOUNTED, 运行： diff --git a/zh/how-to/enable-i2c.md b/zh/how-to/enable-i2c.md new file mode 100644 index 00000000..6e9da159 --- /dev/null +++ b/zh/how-to/enable-i2c.md @@ -0,0 +1,152 @@ +--- +title: 启用 I2C 接口 +description: +published: false +date: 2025-11-18T07:56.994Z +tags: +editor: markdown +dateCreated: 2025-11-17T10:52：11.550Z +--- + +# 2. 介绍信息 + +可以按照两项基本战略启用和使用i2c支助。 首先，仅启用i2c接口。 然后使用各种脚本和/或编程语言与传感器通信，使用i2c公共汽车和协议。 第二，如果可用，则使用本机操作系统传感器支持，即： 一个内核级别的驱动程序，通过i2c公共汽车和协议再次与传感器通信。 i2c 协议参考 https://en.wikipedia.org/wiki/I%C2%B2C + +利用i2c接口和通信协议的设备类型包括传感器、显示屏幕、触摸板等。 具体到这个示例，将支持流行的 bmp280 温度和压力组合传感器。 见 https://www.bosch-sensortec.com/products/environmental-sensors/presure-sensors/bmp280/。 + +# 3. 我应该使用哪种类型的支持？ + +有各种图书馆为mp280传感器提供直接支持。 例如，Adafruit提供了python兼容的 bmp280 传感器支持，请参阅https://learn.adafruit.com/welcometo-circuitpython/couritpython库和 https://learn.adafruit.com/adafruit-bmp280-barometric-los-plus-temature-sensor-breakout/cleitpython-test。 支持本机内核。 设备树方法可以用来告诉内核有一个设备，并让它接管它的控制权。 + +> To enable native kernel support we must create a device tree overlay like described in [Creating an device tree overlay from scratch](/development/device-trees#h-3-creating-an-device-tree-overlay-from-scratch) +> {.is-info} + +# 4. Wiring + +- 这是最多的 RK3588 设备 GPIO 布局。 请参阅您特定设备的文档以供引脚布局！| Typical RK3588 GPIO Pin Layout | + | ----------------------------------------------------------------------- | + | ![gpio-pin-layout.png](/enable-i2c/gpio-pin-layout.png) | + +- 要将您的传感器连接到I2C，就像在本图中显示的那样： + +### Tabset {.tabset} + +#### I2C Bus M0 + +\| 传感器Pin| GPIO 功能 | GPIO Pin| 在棋盘上粘贴颜色 | 图表上粘贴颜色 | +\| ---------- | ------------ | ------ | ------ | +\| VCC | 3. v|GPIO Pin 1 | Yellow | Red | +\| GND | GND | 任何地面，例如 GPIO Pin 9 | Blue | +\| SDA | i2c SDA (数据) | GPIO Pin 3 | Blue | Pink | +\| SCL | i2c SCL (时钟) | GPIO Pin 5 | Blue | Pink | + +#### I2C Bus M2 + +\| 传感器Pin| GPIO 功能 | GPIO Pin| 在棋盘上粘贴颜色 | 图表上粘贴颜色 | +\| ---------- | ------------ | ------ | ------ | +\| VCC | 3. v|GPIO Pin 1 | Yellow | Red | +\| GND | GND | 任何地面，例如 GPIO Pin 9 | Blue | +\| SDA | i2c SDA (数据) | GPIO Pin 37 | Blue | Pink | +\| SCL | i2c SCL (时钟) | GPIO Pin 12 | Blue | Pink | + +#### I2C Bus M3 + +\| 传感器Pin| GPIO 功能 | GPIO Pin| 在棋盘上粘贴颜色 | 图表上粘贴颜色 | +\| ---------- | ------------ | ------ | ------ | +\| VCC | 3. v|GPIO Pin 1 | Yellow | Red | +\| GND | GND | 任何地面，例如 GPIO Pin 9 | Blue | +\| SDA | i2c SDA (数据) | GPIO Pin 15 | Blue | Pink | +\| SCL | i2c SCL (时钟) | GPIO Pin 16 | Blue | Pink | + +#### I2C Bus M4 + +\| 传感器Pin| GPIO 功能 | GPIO Pin| 在棋盘上粘贴颜色 | 图表上粘贴颜色 | +\| ---------- | ------------ | ------ | ------ | +\| VCC | 3. v|GPIO Pin 1 | Yellow | Red | +\| GND | GND | 任何地面，例如 GPIO Pin 9 | Blue | +\| SDA | i2c SDA (数据) | GPIO Pin 11 | Blue | Pink | +\| SCL | i2c SCL (时钟) | GPIO Pin 13 | Blue | Pink | + +### + +> 请仔细检查您面板上的引脚布局。 一个错误的有线传感器可能无法正常工作，甚至可能被损坏而无法修复！ +> {.is-info} + +# 5. 检查连接到哪个i2c总线？ + +- 安装 i2c-tools 包。i2c-tools 包提供CLI 命令，列出在 i2c 大客车上找到的传感器。 + +``` +pacman -Sy i2c-tools +``` + +``` +ls -l /dev/i2c* +``` + +请注意，i2c-8大客车默认不存在。 专门适用于 IndieDroid 的 i2c 总线 8 (m2)，默认情况下未启用， 但可在GPIO Board pins 3 and 5, respectively i2c SDA (i). 。数据引导和i2c SCL(即时钟固定)。 + +> 无论使用完整的本机内核支持，还是仅启用适用的 i2c 大客车， 需要使用设备树源文件来验证 i2c 公交功能。 这将确保正确的公共汽车上的 i2c 接口具有功能，传感器可在预期的i2c 地址找到。 +> {.is-info} + +查找设备树源文件以启用 i2c bus 8... 通过 GPIO 头上的 InidedDroid Nova i2c 支持通过 pin 3 和 5, i。 e. i2c SDA (data pin) 和 i2c SCL (count pin), 并且被限定为“m2”变量。 因此，必须修改引导配置以载入编译的 rk3588-i2c8-m2 设备树文件。 + +通过 Secure Shell (SSH) 或桌面(GUI) 打开终端会话并升到根级访问... + +``` +苏文 +``` + +确认 GPIO i2c 8 (m2) 设备树对象文件存在于引导分区... + +``` +查找/boot | grep i2c8 +``` + +输出看起来就像这样了 + +``` +/boot/dtbs/rockchip/overlay/rk3588-i2c8-m2.dtbo +/boot/dtbs/rockchip/overlay/rk3588-i2c8-m4.dtbo +``` + +重启 IndieDroid Nova... + +```bash +reboot +``` + +## 4. 验证 i2c 公共汽车现在可见 + +```bash +ls -l /dev/i2c* | grep i2c-8 +``` + +``` +crw-rw---- 1 root i2c 89, 8 Sep 22 09:44 /dev/i2c-8 +``` + +如果上面的设备目录不存在，那么编译后的设备树文件就没有像预期的那样加载。 验证`extlinux.conf`文件已根据需要更改，以启用i2c 8 bus，使用文件的`m2`变量。 例如... + +``` +fdtoverlays /dtbs/rockchip/overlay/rk3588-i2c8-m2.dtbo +``` + +``` +i2csection -y 8 +``` + +``` + 0 1 2 3 4 5 6 7 8 9 a b c d e f +00: -- -- -- -- -- -- -- -- +10: -- -- -- -- -- -- -- -- -- -- -- -- -- -- -- -- +20: -- -- -- -- -- -- -- -- -- -- -- -- -- -- -- -- +30: -- -- -- -- -- -- -- -- -- -- -- -- -- -- -- -- +40: -- -- -- -- -- -- -- -- -- -- -- -- -- -- -- -- +50: -- -- -- -- -- -- -- -- -- -- -- -- -- -- -- -- +60: -- -- -- -- -- -- -- -- -- -- -- -- -- -- -- -- +70: -- -- -- -- -- -- 76 -- +``` + +> bmp280传感器应出现在i2c总线8上，地址0x76。 如上文70行和6栏中提到的“76”所示。 如果情况不是这样，那么设备树文件会按预期加载，因此传感器不会在 i2c bus 8 上显示。 如果计划仅启用适用的 i2c 公共汽车，即： 8. 除了安装应用程序级库和开发传感器查询适用代码外，不需要采取其他步骤。 如果需要对传感器使用完整的本机内核支持，请完成以下步骤。 +> {.is-info} \ No newline at end of file diff --git a/zh/how-to/free-space-up.md b/zh/how-to/free-space-up.md index 20604da4..bf36b27e 100644 --- a/zh/how-to/free-space-up.md +++ b/zh/how-to/free-space-up.md @@ -14,7 +14,7 @@ dateCreated: 2024-09-20T20：26：57.698Z # 2. 清理用户缓存 🏠 -在安装或更新软件包时，`pacman`将缓存的副本保存在`/var/cache/pacman/pkg/`中，以加快重新安装速度。 然而，这些缓存的软件包可以积累和使用磁盘空间。 然而，这些缓存的软件包可以积累和使用磁盘空间。 然而，这些缓存的软件包可以积累和使用磁盘空间。 然而，这些缓存的软件包可以积累和使用磁盘空间。 +在安装或更新软件包时，`pacman`将缓存的副本保存在`/var/cache/pacman/pkg/`中，以加快重新安装速度。 然而，这些缓存的软件包可以积累和使用磁盘空间。 然而，这些缓存的软件包可以积累和使用磁盘空间。 然而，这些缓存的软件包可以积累和使用磁盘空间。 然而，这些缓存的软件包可以积累和使用磁盘空间。 然而，这些缓存的软件包可以积累和使用磁盘空间。 ## 2.1 检查缓存大小 @@ -84,7 +84,7 @@ sudo journalctl --trainum-time=3d # 4. 使用 BleachBit 🧽 -BleachBit 是一个强大的工具，可以帮助您清理系统垃圾，空闲磁盘空间，并保护您的隐私。 **BleachBit** 是一个强大的工具，可以帮助您清理系统垃圾，空闲磁盘空间，并保护您的隐私。您可以了解更多关于如何使用 BleachBit [here](https://www.bleachbit.org/)。 使用 BleachBit 🧽 使用 BleachBit 🧽 使用 BleachBit 🧽 +BleachBit 是一个强大的工具，可以帮助您清理系统垃圾，空闲磁盘空间，并保护您的隐私。 **BleachBit** 是一个强大的工具，可以帮助您清理系统垃圾，空闲磁盘空间，并保护您的隐私。您可以了解更多关于如何使用 BleachBit [here](https://www.bleachbit.org/)。 使用 BleachBit 🧽 使用 BleachBit 🧽 使用 BleachBit 🧽 使用 BleachBit 🧽 # 5. 清理用户缓存 🏠 @@ -106,7 +106,7 @@ rm -rf ~/.cache/* # 5. 查找大文件和目录 📂 -有时，大型文件可能不必要地占用空间。 以下是您可以用来识别他们的工具： 以下是您可以用来识别他们的工具： 以下是您可以用来识别他们的工具： 以下是您可以用来识别他们的工具： 以下是您可以用来识别他们的工具： 以下是您可以用来识别他们的工具： +有时，大型文件可能不必要地占用空间。 以下是您可以用来识别他们的工具： 以下是您可以用来识别他们的工具： 以下是您可以用来识别他们的工具： 以下是您可以用来识别他们的工具： 以下是您可以用来识别他们的工具： 以下是您可以用来识别他们的工具： 以下是您可以用来识别他们的工具： ## 控制台工具 ⌨️ @@ -154,9 +154,18 @@ rm -rf ~/.cache/* [Website](https://duc.zevv.nl) | AUR: `ducAUR` **duc** - 磁盘使用情况检查器。\ [Website](https://duc.zevv.nl) | AUR: `ducAUR`\ + [Website](https://duc.zevv.nl) | AUR: `ducAUR` + **duc** - 磁盘使用情况检查器。\ + [Website](https://duc.zevv.nl) | AUR: `ducAUR`\ [Website](https://duc.zevv.nl) | AUR: `ducAUR` - 📚 目录 + 📚 目录 + 📚 目录\ + 📚 目录\ + 📚 目录\ + **qdirstat** - 基于Q的目录统计工具。\ + [GitHub](https://github.com/shundhammer/qdirstat) | AUR: `qdirstatAUR` 📚 目录 📚 目录\ 📚 目录\ @@ -171,4 +180,5 @@ rm -rf ~/.cache/* > {.is-success} > {.is-success} > {.is-success} +> {.is-success} diff --git a/zh/how-to/govctl.md b/zh/how-to/govctl.md index 7050d8e4..d43365f8 100644 --- a/zh/how-to/govctl.md +++ b/zh/how-to/govctl.md @@ -15,6 +15,7 @@ dateCreated: 2025-05-07T12:47:49.033Z 它默认启用，并将根据可用电池电量设定性能。 它默认启用，并将根据可用电池电量设定性能。 它默认启用，并将根据可用电池电量设定性能。 +它默认启用，并将根据可用电池电量设定性能。 - 默认情况下应该安装。 如果不是，请安装它 @@ -44,6 +45,7 @@ GovCtl 默认将确保所有附加设备的最大性能，如果没有机载电 > {.is-info} > {.is-info} > {.is-info} +> {.is-info} 如果你不喜欢默认，它们都可以更改。 diff --git a/zh/how-to/how-to-enable-dtbos.md b/zh/how-to/how-to-enable-dtbos.md index 8c992285..0cd633cc 100644 --- a/zh/how-to/how-to-enable-dtbos.md +++ b/zh/how-to/how-to-enable-dtbos.md @@ -2,7 +2,7 @@ title: 如何启用 DTBOs description: published: true -date: 2025-09-16T10:44:14.092Z +date: 2026-01-08T17:34:02.034Z tags: editor: markdown dateCreated: 2024-11-10T18：02：07.427Z @@ -17,7 +17,7 @@ dateCreated: 2024-11-10T18：02：07.427Z # 2. BredOS-配置 -- bredos-config 工具提供了一种简单的方式来启用和禁用 dtbos。 启动工具为 启动工具为 启动工具为 启动工具为 启动工具为 +- bredos-config 工具提供了一种简单的方式来启用和禁用 dtbos。 启动工具为 启动工具为 启动工具为 启动工具为 启动工具为 启动工具为 ``` sudo bredos-config @@ -25,13 +25,14 @@ sudo bredos-config 然后导航到`设备树管理器` -> `启用/禁用叠加层` 并启用 dtb 叠加层以满足您的需要。 工具然后安装基础设备树和选定的叠加层。 重启系统以应用更改。 工具然后安装基础设备树和选定的叠加层。 重启系统以应用更改。 -bredos-config 可以安装 dtbs 并更改grub 配置以便在启动时加载它们。_不能_更改UEFI设置。 此操作必须由用户完成。 用户必须做出的更改，可以在首次安装基础/叠加层dbs时通过面包配置或者使用 “3.4 配置 EFI” 显示。 如果您的设备是 u-boot-based，则不需要进一步更改。 此操作必须由用户完成。 用户必须做出的更改，可以在首次安装基础/叠加层dbs时通过面包配置或者使用 “3.4 配置 EFI” 显示。 如果您的设备是 u-boot-based，则不需要进一步更改。 此操作必须由用户完成。 用户必须做出的更改是在首次安装基础/叠加层数据库时通过bredos-config 显示，或使用 [3.4 UConfig](#h-34-configure-uefi)。 如果您的设备是“u-boot”为基础，不需要进一步修改。 此操作必须由用户完成。 用户必须做出的更改是在首次安装基础/叠加层数据库时通过bredos-config 显示，或使用 [3.4 UConfig](#h-34-configure-uefi)。 如果您的设备是“u-boot”为基础，不需要进一步修改。 +bredos-config 可以安装 dtbs 并更改grub 配置以便在启动时加载它们。_不能_更改UEFI设置。 此操作必须由用户完成。 用户必须做出的更改，可以在首次安装基础/叠加层dbs时通过面包配置或者使用 “3.4 配置 EFI” 显示。 如果您的设备是 u-boot-based，则不需要进一步更改。 此操作必须由用户完成。 用户必须做出的更改，可以在首次安装基础/叠加层dbs时通过面包配置或者使用 “3.4 配置 EFI” 显示。 如果您的设备是 u-boot-based，则不需要进一步更改。 此操作必须由用户完成。 用户必须做出的更改是在首次安装基础/叠加层数据库时通过bredos-config 显示，或使用 [3.4 UConfig](#h-34-configure-uefi)。 如果您的设备是“u-boot”为基础，不需要进一步修改。 此操作必须由用户完成。 用户必须做出的更改是在首次安装基础/叠加层数据库时通过bredos-config 显示，或使用 [3.4 UConfig](#h-34-configure-uefi)。 如果您的设备是“u-boot”为基础，不需要进一步修改。 此操作必须由用户完成。 用户必须做出的更改是在首次安装基础/叠加层数据库时通过bredos-config 显示，或使用 [3.4 UConfig](#h-34-configure-uefi)。 如果您的设备是“u-boot”为基础，不需要进一步修改。 > 如果你在棋盘上看到一个 BredOS 标志，你正在使用 UEFI 。 > {.is-warning} > {.is-warning} > {.is-warning} > {.is-warning} +> {.is-warning} > 这是建议启用/禁用 dtb 叠加层的方式。 如果您使用 `bredos-config` ，下面的步骤将不会有花蜜。 > {.is-success} @@ -58,7 +59,7 @@ sudo mkdir -p /dtb/{base,overlays} ## 🗄️ 2: 复制到基础DTB -- 对于其他基于 RK3588的看板，用您的实际设备名称替换 \\\\\\`rk3588-board.dtb' ： +- 对于其他基于 RK3588的看板，用您的实际设备名称替换 \\\\\\\`rk3588-board.dtb' ： ``` sudo cp /boot/dtbs/rockchip/rk3588-board.dtb /dtb/base/ @@ -100,15 +101,15 @@ sudo grub-mkconfig -o /boot/grub/grub.cfg - **将“配置表模式”设置为“设备树”** -- **更改为 `Enabled`** 支持 DTB 覆盖和叠加层\\\\\\\\` +- **更改为 `Enabled`** 支持 DTB 覆盖和叠加层\\\\\\\\\` -![](/panthor/enable_tree_dtb_in_uefi.jpg) +![bios-dtb-overlays.png](/panthor/bios-dtb-overlays.png) - 按 F10 键保存并重新启动到您的系统。 ## 🔄 5: 复制 DTBO -- 使用 dtbo 替换\\`。 +- 使用 dtbo 替换\\\`。 ``` sudo cp /boot/dtbs/rockchip/overy/my-overlay.dtbo /dtb/overy/ diff --git a/zh/how-to/how-to-install-steam-fex.md b/zh/how-to/how-to-install-steam-fex.md new file mode 100644 index 00000000..12f08da1 --- /dev/null +++ b/zh/how-to/how-to-install-steam-fex.md @@ -0,0 +1,192 @@ +--- +title: 在 BredOS 上安装 STEAM (FEX-Emu) +description: +published: false +date: 2026-02-03T09：17：38.531Z +tags: +editor: markdown +dateCreated: 2026-01-27T09：08：49.245Z +--- + +# 2. 介绍信息 + +欢迎来到关于如何在 BredOS 上安装 **Steam** 的指南！ 跟着这些简单的步骤来让Steam在您的系统上站起来。 跟着这些简单的步骤来让Steam在您的系统上站起来。 跟着这些简单的步骤来让Steam在您的系统上站起来。 跟着这些简单的步骤来让Steam在您的系统上站起来。 + +> 这篇文章是为了基于ARMv9 System-on-Chip而设计的，如Cix Pi 81x0。 ARMv8 SOC支持执行32位代码。 对于ARMv8 SBC，请使用 [box64](/en/how-to/how-to-install-steam) 代替！ +> {.is-info} + +# 3. 安装FEX-Emu + +## 2.1 安装 FEX 二进制文件 + +截至编写本报告时，您需要自己编译FEX-Emu。 我们准备了一个PKGBUILD文件来简化这一过程。 + +- 克隆我们的 FEX-仓库： + +``` +git clone https://github.com/BredOS/BredOS-FEX-Emu.git +``` + +- 要构建最新版本的 FEX，您需要修改PKGBUILD 文件： + +``` +cd BredOS-FEX-Emu/BredOS +nano PKGBUILD +``` + +- 文件看起来像这样： + +``` +pkgname=bredos-fex-emu +pkgver=2509.1 +pkgrel=2 +pkgdesc='快速用户模式 x86 和 x86-64 模拟器for Arm64 - BredOS Edition' +url=https://BredOS。 rg +arch=(aarch64) +license=(GPL3) + +[等于...] +``` + +- 访问 https://github.com/FEX-Emu/FEX 并寻找一个有效的标签。 截至撰写本报告之时，最近一次释放是从2026年1月开始。 与此版本关联的标签是 2601。 相应编辑 pkgver\` + +``` +pkgver=2601 +``` + +关闭并使用 CTRL + X, 然后 Y + +- 使用 FEX 构建并安装 FEX + +``` +毫克-西文 +``` + +## 2.2 安装 x86_64 根文件系统 + +为了简化一个 BredOS x86_64 根文件系统的安装，我们开发了我们自己的 `fex-config` 工具。 + +- 要获取rootfs，请运行： + +``` +sudo fex-config -c +``` + +这将下载并安装 BredOS 到 "~/.fex-emu/RooTFS/bredos-chroot" + +# 4. Steam安装 + +## 3.1 启用多lib + +您可能需要添加 **BredOS Multilib** 仓库来安装 Steam 和必要的翻译层。 要做到这一点，请遵循以下步骤： 要做到这一点，请遵循以下步骤： 要做到这一点，请遵循以下步骤： 要做到这一点，请遵循以下步骤： + +- 安装 `bredos-mullib` 包 + +``` + sudo pacman -S bredos-multilib +``` + +- 运行时更新软件包数据库： + +``` + sudo pacman -Sy +``` + +## 3.2 Steam安装 + +- 运行以下命令来安装 Steam： + +``` + sudo pacman -Sdd steam +``` + +# 5. GPU 加速 + +## 4.1 英特尔和AMD + +Intel 和 AMD 图形卡应该用盒子运行，只要您的主机系统启用了图形加速。 + +> 这只用AMD卡进行过测试。 如果您有英特尔卡，请随时在我们的 Discord 或 Telegram 频道分享您的体验。 +> {.is-info} + +## 4.2 NVidia + +确保您已经在您的主机系统上安装了专有的 NVIDIA 驱动程序。 开源的 Nouveau 驱动程序将无法工作。 只要我们的 `fex-config` 工具能够检测到 NVIDIA 驱动程序，它就会自动为您安装x86_64 驱动程序。 + +> 请参阅 [here](https://github.com/MitchellAugustin/fex_autoinstall/blob/main/fex_autoinstall_poc.sh)，了解如何安装驱动程序。 +> {.is-info} + +## 4.3 任何其他GPU + +如果您想要使用您单一看板电脑的内部图形卡，您需要启用导星。 Thunk图书馆充当翻译GPU呼叫的中介。 + +> 在 FEX-Emu 上启用小块使得FEX 极难稳定！ +> {.is-info} + +- 编辑 FEX的 Config.json + +``` +nano $HOME/.fex-emu/Config.json +``` + +- 定位配置文件中的Thunks部分： + +``` + "ThunksDB": own + "fex_thunk_test": 0, + "asound": 0, + "drm": 0, + "Vulkan": 0, + "WaylandClient": 0, + "GL": 0 +} +``` + +- 并编辑它以启用 `Vulkan`, `WaylandClient` 和 `GL`： + +``` + "ThunksDB": own + "fex_thunk_test": 0, + "asound": 0, + "drm": 0, + "Vulkan": 1, + "WaylandClient": 1, + "GL": 1 +} +``` + +# 4. 启动Steam + +- 安装完成后，您可以通过在应用程序菜单中搜索或运行来启动Steam： + +``` +steam +``` + +> 快乐游戏！ +> {.is-success} +> 快乐游戏！ +> {.is-success} +> {.is-success} + +# 🔄 3. 🤝 贡献 + +## 6.1 Steam启动时挂起 + +- 如果Steam没有为您启动，但挂在： + +``` +steam.sh[7285]: 在 bredos 滚动64位 +steam 上运行Steam h[7285]: STEAM_RUNTIME 已被用户 +设置。setup.sh[7328]: Steam运行环境最新版本！ +``` + +- 打开新控制台并执行： + +``` +取消所有 FEXServer +``` + +然后，Steam将继续正常加载。 + +\*[SBCs]: 单一板电脑 diff --git a/zh/how-to/how-to-install-steam.md b/zh/how-to/how-to-install-steam.md index 019d628e..fc0ce99d 100644 --- a/zh/how-to/how-to-install-steam.md +++ b/zh/how-to/how-to-install-steam.md @@ -1,8 +1,8 @@ --- -title: 如何在 BredOS 上安装 STEAM +title: 在 BredOS 上安装 STEAM (box64) description: 一个在BredOS上安装Steam的简单指南，并对Panthorable和非Panthor的配置进行分步说明。 published: true -date: 2025-09-15T11:13:24.812Z +date: 2026-01-28T08:23:29.693Z tags: editor: markdown dateCreated: 2024-09-08T09:55:58.661Z @@ -12,6 +12,9 @@ dateCreated: 2024-09-08T09:55:58.661Z 欢迎来到关于如何在 BredOS 上安装 **Steam** 的指南！ 跟着这些简单的步骤来让Steam在您的系统上站起来。 跟着这些简单的步骤来让Steam在您的系统上站起来。 跟着这些简单的步骤来让Steam在您的系统上站起来。 跟着这些简单的步骤来让Steam在您的系统上站起来。 +> 本文针对的是以ARMv8 System-on-Chip (SoC)为基础的单一板电脑，例如RK3588。 ARMv9 SOC不支持执行32位代码。 对于ARMv9 SBC，请使用 [FEX-Emu](/en/how-to/how-to-install-steam-fex) 代替！ +> {.is-info} + # 📥 2. 必备条件 > 这是指Rockchip RK35xx 设备使用的操作！ @@ -19,6 +22,7 @@ dateCreated: 2024-09-08T09:55:58.661Z > {.is-info} > {.is-info} > {.is-info} +> {.is-info} - 您需要安装 **BredOS** 并运行。 - 可选，您可以启用 [**Panthor** ](/how-to/how-to-setup-panthor)，但不需要它。 @@ -27,7 +31,7 @@ dateCreated: 2024-09-08T09:55:58.661Z ## 🤖 2.1 自动使用 -- 工具“bredos-config”提供了一个简单的方法来安装蒸汽和合适的蒸汽-libs。 启动工具为 启动工具为 启动工具为 启动工具为 启动工具为 +- 工具“bredos-config”提供了一个简单的方法来安装蒸汽和合适的蒸汽-libs。 启动工具为 启动工具为 启动工具为 启动工具为 启动工具为 启动工具为 ``` sudo bredos-config @@ -53,7 +57,7 @@ sudo bredos-config sudo pacman -Sy ``` -### :desktop_compute: 2.2.2 Steam 安装: +### 3.2.2 Steam安装 - 运行以下命令来安装 Steam： diff --git a/zh/how-to/how-to-setup-panthor.md b/zh/how-to/how-to-setup-panthor.md index ec90c2bc..da7d8732 100644 --- a/zh/how-to/how-to-setup-panthor.md +++ b/zh/how-to/how-to-setup-panthor.md @@ -2,7 +2,7 @@ title: 如何在马里安装Panthor GPU with RK3588 description: published: true -date: 2025-10-27T17：58：06.243Z +date: 2026-01-20T10:04:59.437Z tags: editor: markdown dateCreated: 2024-08-31T15:03:26.994Z @@ -12,11 +12,29 @@ dateCreated: 2024-08-31T15:03:26.994Z 这个指南使你走过让马里的Panthor GPU 存在于RK3588 chipset的板上。 -# 🔄 2. 启用Panthor DTBO +## 1.1 Panthor和Panfork之间的差别是什么？ -## 🤖 1.1 自动使用 +Panthor 是马里G\*\*\* gpus开发者开发的 linux 内核的一个新驱动程序。 潘福克是邦弗斯特的一个分叉，其目的是支持马里610集团获释后的工作。 即使如此，邦福克比潘索表现更好，潘托尔也是继续支持邦福克的道路。 -- bredos-config 工具提供了一种简单的方式来启用和禁用 dtbos。 启动工具为 启动工具： 启动工具： 启动工具： 启动工具： +- Panthor的性能概述： + +``` +> EGL (2D acceleration) performance ~-40% (not measured, answering from day to day feel). +> OpenGL (3D acceleration) performance -16%. +> Vulkan is now almost fully supported. +> You also see a bit more cpu usage (~5%) on heavy gpu usage. +``` + +> RK35xx 设备的 BredOS 默认启用了Panfork ！ +> {.is-info} + +# 🔄 2. Install Panthor + +## 2.1 启用 DTBO + +### 2.1.1 自动使用 + +- bredos-config 工具提供了一种简单的方式来启用和禁用 dtbos。 启动工具为 启动工具： 启动工具： 启动工具： 启动工具： 启动工具： ``` sudo bredos-config @@ -27,27 +45,25 @@ sudo bredos-config > Do not reboot your system after the installation of the dtb overlay! > {.is-warning} -bredos-config 能够安装 dtbs 并更改grub 配置以便在启动时加载它_不能_ 更改uefi 设置。 此操作必须由用户完成。 用户必须做出的更改通过基本/叠加层数据库首次安装时的面包配置来显示。 更改也可以在 [设备树叠加层指南](/how-to/how-to-enable-dtbos) 中找到。 此操作必须由用户完成。 用户必须做出的更改通过基本/叠加层数据库首次安装时的面包配置来显示。 更改也可以在 [设备树叠加层指南](/how-to/how-to-enable-dtbos) 中找到。 此操作必须由用户完成。 用户必须做出的更改通过基本/叠加层数据库首次安装时的面包配置来显示。 更改也可以在 [设备树叠加层指南](/how-to/how-to-enable-dtbos) 中找到。 此操作必须由用户完成。 用户必须做出的更改通过基本/叠加层数据库首次安装时的面包配置来显示。 更改也可以在 [设备树叠加层指南](/how-to/how-to-enable-dtbos) 中找到。 此操作必须由用户完成。 用户必须做出的更改通过基本/叠加层数据库首次安装时的面包配置显示。 更改也可以在 [设备树叠加层指南](/how-to/how-to-enable-dtbos) 中找到。 +bredos-config 能够安装 dtbs 并更改grub 配置以便在启动时加载它_不能_ 更改uefi 设置。 此操作必须由用户完成。 用户必须做出的更改通过基本/叠加层数据库首次安装时的面包配置来显示。 更改也可以在 [设备树叠加层指南](/how-to/how-to-enable-dtbos) 中找到。 此操作必须由用户完成。 用户必须做出的更改通过基本/叠加层数据库首次安装时的面包配置来显示。 更改也可以在 [设备树叠加层指南](/how-to/how-to-enable-dtbos) 中找到。 此操作必须由用户完成。 用户必须做出的更改通过基本/叠加层数据库首次安装时的面包配置来显示。 更改也可以在 [设备树叠加层指南](/how-to/how-to-enable-dtbos) 中找到。 此操作必须由用户完成。 用户必须做出的更改通过基本/叠加层数据库首次安装时的面包配置来显示。 更改也可以在 [设备树叠加层指南](/how-to/how-to-enable-dtbos) 中找到。 此操作必须由用户完成。 用户必须做出的更改通过基本/叠加层数据库首次安装时的面包配置显示。 更改也可以在 [设备树叠加层指南](/how-to/how-to-enable-dtbos) 中找到。 此操作必须由用户完成。 用户必须做出的更改通过基本/叠加层数据库首次安装时的面包配置显示。 更改也可以在 [设备树叠加层指南](/how-to/how-to-enable-dtbos) 中找到。 > 不要在安装dtb 覆盖后重启系统！ > {.is-warning} > {.is-warning} -> 继续使用 \`3。 替换Panfork 图形。 -> {.is-warning} +> 继续使用`2.2 替换面板图形`。 +> {.is-info} -## 🦶 1.2 Manual +### 2.1.2 手动的 -按照[设备树叠加层指南](/how-to/how-to-enable-dtbos)启用 -`/boot/dtbs/rockchip/overy/rockchip-rk3588-panthor-gpu.dtbo` -**复制DTBO后，不要重启系统！** +按照[设备树叠加层指南](/how-to/how-to-enable-dtbos)启用`/boot/dtbs/rockchip/overy/rockchip-rk3588-panthor-gpu.dtbo`。 > 不要在安装dtb 覆盖后重启系统！ > {.is-warning} > {.is-warning} -> 继续使用 \`3。 替换Panfork 图形。 +> 继续使用`2.2 替换面板图形`。 > {.is-warning} -# 🔁 3. 替换面板图形 +## 2.2 替换面板图形 - 用标准的`mesa`软件包替换`mesa-panfork-git`软件包： @@ -55,7 +71,7 @@ bredos-config 能够安装 dtbs 并更改grub 配置以便在启动时加载它_ sudo pacman -S mesa ``` -# 🔁 4. 重启您的系统 +## 2.3 Vulkan 启用 - 安装vulkan加载器和驱动器： @@ -63,11 +79,47 @@ sudo pacman -S mesa sudo pacman -S vulkan-icd-loader vulkan-panfrost ``` -# 5. 重启您的系统 +## 2.4 重新启动您的系统 + +- 重启系统以应用更改。 + +## 2.5 验证安装 + +- 如果您想要验证您的图形，您可以运行以下操作： + +``` +lsomd | grep pan +``` + +上面命令的输出应表明`panthor`模块已加载。 如果您仍然看到列出的 panfrost\` 模块，您可能想要检查您是否已经完成了该文章描述的所有步骤。 + +# 🔁 3. 还原到Panfrost + +- 若要恢复到`Panfork`，请运行以下命令： + +### Tabset {.tabset} + +#### 基于UEFI的系统 + +``` +sudo pacman -S mesa-panfork-git +rm /boot/efi/dtb/overys/rockchip-rk3588-panthor-gpu.dtbo +sudo reboot +``` -- 重启系统以应用更改。 如果您想要验证您的图形，您可以运行以下操作： +#### U-机器人系统 ``` -sudo pacman -S inxi mesa-utils -inxi -G -``` \ No newline at end of file +sudo pacman -S mesa-panfork-git +sudo nano /boot/extlinux/extlinux.conf +``` + +删除线“fdtovery/boot/dtbs/rockchip/overy/rockchip-rk3588-panthor-gpu.dtbo”。 +然后保存并关闭。 + +- 重启系统以应用您的更改： + +``` +sudo reboot +``` + diff --git a/zh/how-to/how-to-use-your-device-as-ap.md b/zh/how-to/how-to-use-your-device-as-ap.md index f361d489..1e42f3f7 100644 --- a/zh/how-to/how-to-use-your-device-as-ap.md +++ b/zh/how-to/how-to-use-your-device-as-ap.md @@ -72,6 +72,7 @@ Hint: "nmcli dev wifi show-password" shows the Wi-Fi name and password. > 如果你得到以下错误，请用sudo再次运行命令。 > 如果你得到以下错误，请用sudo再次运行命令。 > 如果你得到以下错误，请用sudo再次运行命令。 +> 如果你得到以下错误，请用sudo再次运行命令。 > `Error: Failed to setup a Wi-Fi hotspot: Not authorized to control networking.` > {.is-info} diff --git a/zh/how-to/manage-services.md b/zh/how-to/manage-services.md index 84736f41..ae114892 100644 --- a/zh/how-to/manage-services.md +++ b/zh/how-to/manage-services.md @@ -2,7 +2,7 @@ title: 如何管理服务 description: published: true -date: 2025-10T06:09:36.168Z +date: 2025-10-01T11:35:53.087Z tags: editor: markdown dateCreated: 2025-09-30T10:31:51.284Z @@ -22,7 +22,7 @@ dateCreated: 2025-09-30T10:31:51.284Z 在输出结束时，您可以读取文本“系统正常运行”。 这意味着本应在启动时启动的所有服务已经启动，没有任何错误。 在输出结束时，您可以读取文本“系统正常运行”。 这意味着本应在启动时启动的所有服务已经启动，没有任何错误。 如果您刚刚启动了您的设备，它可能会显示警告“**X** 服务报告状态激活”。这是正常的， 许多服务可以平行启动，这可能导致在启动时出现延误。 这种警告将在几分钟后消失。 这种警告将在几分钟后消失。 -如果您看到错误消息，"**X** 服务失败"一个或多个服务启动失败。 +如果您看到错误消息，"**X** 服务报告状态失败"一个或多个服务启动失败。 为了确定该处的问题并可能予以解决，继续第3节。 ## 2.2 使用 `systemctl` @@ -40,13 +40,13 @@ systemctl list-units --type=service --user 此输出服务列表。 使用箭头键导航，或使用 空间 向下转一页。 Leave it with the Q key. -服务可以有不同的状态，如“SUB”行所示。 它们可以是 `running`, `exited`, 或 `failed`。 它们可以是 `running`, `exited`, 或 `failed`。 +服务可以有不同的状态，如“SUB”行所示。 它们可以是 `running`, `exited`, 或 `failed`。 服务可以有不同的状态，如“SUB”行所示。 它们可以是 `running`, `exited`, 或 `failed`。 它们可以是 `running`, `exited`, 或 `failed`。 - 一个 `running' 服务为您执行背景任务。 一个很好的例子是网络管理员。 此服务管理您的网络连接。 既然你总是可以在以太网电缆中插入，程序需要连续运行以管理您的网络。 这是通过 `running\` 服务实现的。 -- An `exited` service is one that runs at boot, performs its task, and then terminates cleanly. 一个很好的例子是系统-tmpfiles-setup 服务。 它从启动开始，建立一个斜杆，把它挂到/tmp，然后退出。 +- An `exited` service is one that runs at boot, performs its task, and then terminates cleanly. 一个很好的例子是系统-tmpfiles-setup 服务。 它从启动开始，建立一个斜杆，把它挂到/tmp，然后退出。 它从启动开始，建立一个斜杆，把它挂到/tmp，然后退出。 -- “失败”服务在运行时未正确启动或遇到问题，并以错误代码停止。 这并不意味着你的系统已经崩溃，而是可能仍然需要修复它。 这并不意味着你的系统已经崩溃，而是可能仍然需要修复它。 +- “失败”服务在运行时未正确启动或遇到问题，并以错误代码停止。 这并不意味着你的系统已经崩溃，而是可能仍然需要修复它。 这并不意味着你的系统已经崩溃，而是可能仍然需要修复它。 这并不意味着你的系统已经崩溃，而是可能仍然需要修复它。 还可以检查给定服务的状态，如果它失败，它提供了更多的输出，包括错误消息。 @@ -77,11 +77,11 @@ Sep 26 12:53:13 bredos systemd[1]: nordvpnd ervice: Main process exist, code=exe Sep 26 12:53:13 bredos systemd[1]: nordvpnd.service: failed with result 'exit-code'。 ``` -在上面给定的示例中，Nordvpnd 服务由于缺少库 libxml2.so.2 而无法启动。 有了这种信息，就很容易修复。 有了这种信息，就很容易修复。 +在上面给定的示例中，Nordvpnd 服务由于缺少库 libxml2.so.2 而无法启动。 有了这种信息，就很容易修复。 有了这种信息，就很容易修复。 有了这种信息，就很容易修复。 # 4. 管理服务 -服务可以手动启动和/或停止，也可以在启动时停止。 管理一个服务的行为做以下事情。 管理一个服务的行为做以下事情。 +服务可以手动启动和/或停止，也可以在启动时停止。 管理一个服务的行为做以下事情。 管理一个服务的行为做以下事情。 管理一个服务的行为做以下事情。 - 手动启动服务，运行： @@ -95,7 +95,7 @@ sudo systemctl start sudo systemctl stop ``` -启动时激活和停用服务的逻辑仍在继续。 启动时激活和停用服务的逻辑仍在继续。 使用 `systemctl enable` 来启动它们，或者 `systemctl disable` 来阻止它们在启动时启动。 使用参数 `--now `，您可以同时启动并激活它们。 使用参数 `--now `，您可以同时启动并激活它们。 +启动时激活和停用服务的逻辑仍在继续。 启动时激活和停用服务的逻辑仍在继续。 使用 `systemctl enable` 来启动它们，或者 `systemctl disable` 来阻止它们在启动时启动。 使用参数 `--now `，您可以同时启动并激活它们。 使用参数 `--now `，您可以同时启动并激活它们。 启动时激活和停用服务的逻辑仍在继续。 使用 `systemctl enable` 来启动它们，或者 `systemctl disable` 来阻止它们在启动时启动。 使用参数 `--now `，您可以同时启动并激活它们。 使用参数 `--now `，您可以同时启动并激活它们。 - 例如，如果你想要在启动时激活 nordvpnd 并用相同的命令启动它，请运行： @@ -105,7 +105,7 @@ sudo systemctl 启用 --now nordvpnd # 🚀 4. 编辑和创建服务 -它也可以根据您的喜好编辑或创建服务。 它也可以根据您的喜好编辑或创建服务。 全系统服务文件通常存储在`/usr/lib/systemd/system`或`/etc/systemd/system`中，而全用户范围的服务文件则存储在`~/.config/systemd/user`或`/etc/systemd/user`中。 +它也可以根据您的喜好编辑或创建服务。 它也可以根据您的喜好编辑或创建服务。 它也可以根据您的喜好编辑或创建服务。 全系统服务文件通常存储在`/usr/lib/systemd/system`或`/etc/systemd/system`中，而全用户范围的服务文件则存储在`~/.config/systemd/user`或`/etc/systemd/user`中。 - 要创建全系统服务文件，请运行： @@ -113,7 +113,7 @@ sudo systemctl 启用 --now nordvpnd sudo nano /etc/systemd/system/.service ``` -- 然后用一些信息填写新创建的文件。 例如： 例如： +- 然后用一些信息填写新创建的文件。 例如： 例如： 例如： ``` [Unit] @@ -140,6 +140,7 @@ WantedBy=multi-user.target > 请注意编辑服务文件 **可以** 危险！ > {.is-danger} > {.is-danger} +> {.is-danger} - 在您编辑服务文件后，您需要重新加载系统系统： @@ -149,4 +150,4 @@ WantedBy=multi-user.target # 🔄 3. 作弊表 -许多linux disruubiutions 发布系统的作弊单。 许多linux disruubiutions 发布系统的作弊单。 由于它们基本上是一样的，所以我们提供了一个链接到[Red Hat's Cheat Sheet for system](https://access.redhat.com/sites/default/files/attachments/12052018_systemd_6.pdf)。 +许多linux disruubiutions 发布系统的作弊单。 许多linux disruubiutions 发布系统的作弊单。 由于它们基本上是一样的，所以我们提供了一个链接到[Red Hat's Cheat Sheet for system](https://access.redhat.com/sites/default/files/attachments/12052018_systemd_6.pdf)。 许多linux disruubiutions 发布系统的作弊单。 由于它们基本上是一样的，所以我们提供了一个链接到[Red Hat's Cheat Sheet for system](https://access.redhat.com/sites/default/files/attachments/12052018_systemd_6.pdf)。 diff --git a/zh/how-to/open-vswitch.md b/zh/how-to/open-vswitch.md index 697f2bb4..6bc069bf 100644 --- a/zh/how-to/open-vswitch.md +++ b/zh/how-to/open-vswitch.md @@ -10,7 +10,7 @@ dateCreated: 2025-09-24T11：30：44.331Z # 2. 介绍信息 -Open vSwitch (OVS) 是一个开源、多层虚拟开关，旨在启用高级网络自动化，同时支持标准管理接口和协议。 它主要用于虚拟环境，以便利虚拟机之间以及虚拟机与物理网络之间的通信。 它主要用于虚拟环境，以便利虚拟机之间以及虚拟机与物理网络之间的通信。 +Open vSwitch (OVS) 是一个开源、多层虚拟开关，旨在启用高级网络自动化，同时支持标准管理接口和协议。 它主要用于虚拟环境，以便利虚拟机之间以及虚拟机与物理网络之间的通信。 它主要用于虚拟环境，以便利虚拟机之间以及虚拟机与物理网络之间的通信。 它主要用于虚拟环境，以便利虚拟机之间以及虚拟机与物理网络之间的通信。 # 1. 安装 @@ -42,7 +42,7 @@ sudo ovs-vsctl add-br ## 4.1 手动的 -虚拟网络设备可以通过您的超访问器或通过容器手动创建。 它们将出现并发挥物理网络设备的功能。 它们将出现并发挥物理网络设备的功能。 +虚拟网络设备可以通过您的超访问器或通过容器手动创建。 它们将出现并发挥物理网络设备的功能。 它们将出现并发挥物理网络设备的功能。 它们将出现并发挥物理网络设备的功能。 - 要列出所有网络设备运行： @@ -89,9 +89,9 @@ sudo ovs-vsctl 附加端口 ve-databaselCjq 标签= ve-databaselCjq 标签= 请注意，使用过的网络设备必须**没有**指定IP地址！ > {.is-info} > {.is-info} +> {.is-info} - 若要从上面的示例输出添加 `enp49s0` ，请运行： @@ -133,11 +134,11 @@ sudo ovs-vsctl 附加端口 ve-databaselCjq 标签= enp49s0 ``` -如果您只有一个物理网络设备和/或想要将它用于您的主机网络， 您必须将 IP 地址分配给vSwitch 而不是物理网络设备。 这可以使用任何工具，例如网络管理员的图形界面或通过系统进行。 这可以使用任何工具，例如网络管理员的图形界面或通过系统进行。 +如果您只有一个物理网络设备和/或想要将它用于您的主机网络， 您必须将 IP 地址分配给vSwitch 而不是物理网络设备。 这可以使用任何工具，例如网络管理员的图形界面或通过系统进行。 这可以使用任何工具，例如网络管理员的图形界面或通过系统进行。 这可以使用任何工具，例如网络管理员的图形界面或通过系统进行。 # 🔄 3. 将 vSwitch 连接到物理网络 -如果您在互联网上有两个通过 VPN 连接的设备，可以连接他们的 vSwitch。 这使得这些vSwitch上的设备可以不再配置地相互通信。 如果您的 vSwitch 已连接到物理开关，甚至可以通过互联网连接到物理设备。 这对许多目的都是有用的。 这使得这些vSwitch上的设备可以不再配置地相互通信。 如果您的 vSwitch 已连接到物理开关，甚至可以通过互联网连接到物理设备。 这对许多目的都是有用的。 +如果您在互联网上有两个通过 VPN 连接的设备，可以连接他们的 vSwitch。 这使得这些vSwitch上的设备可以不再配置地相互通信。 如果您的 vSwitch 已连接到物理开关，甚至可以通过互联网连接到物理设备。 这对许多目的都是有用的。 这使得这些vSwitch上的设备可以不再配置地相互通信。 如果您的 vSwitch 已连接到物理开关，甚至可以通过互联网连接到物理设备。 这对许多目的都是有用的。 这使得这些vSwitch上的设备可以不再配置地相互通信。 如果您的 vSwitch 已连接到物理开关，甚至可以通过互联网连接到物理设备。 这对许多目的都是有用的。 - 在两个主机上运行以下内容： @@ -150,6 +151,7 @@ As always, replace `` with the name of your switch, and ` > 如果您的客户端能够相互控制，但是进一步的通信不起作用，这可能是一个MTU问题。 > {.is-danger} > {.is-danger} +> {.is-danger} ## 6.1 解决MTU问题 diff --git a/zh/how-to/package-management.md b/zh/how-to/package-management.md index 67f925bf..63c35ae4 100644 --- a/zh/how-to/package-management.md +++ b/zh/how-to/package-management.md @@ -2,7 +2,7 @@ title: 软件包管理指南 description: 欢迎使用 BredOS 软件包管理员指南！🚀 在这里，你会学习如何安装和管理应用程序。准备好控制您的系统应用！ 💻 在这里，您将学习如何安装和管理应用程序 published: true -date: 2025-09-15T09:53:59.847Z +date: 2025-12-22T06:22:03.605Z tags: editor: markdown dateCreated: 2024-09-20T20：08：39.778Z @@ -72,11 +72,29 @@ pacman -Q sudo pacman -Sc ``` +## 2.7 Reset TrustDB + +如果您安装任何软件包有问题，因为错误：“错误：键盘：来自“的签名”是未知可信度， 重置包含签名密钥的数据库并重建它，修复它。 + +- 要删除旧数据库，请运行： + +``` +sudo rm -rf /etc/pacman.d/gnupg +``` + +- 然后通过以下方式重建您的数据库： + +``` +sudo pacman-key --init +sudo pacman-key --populate +``` + > Pacman是管理您的 BredOS 系统的重要工具——迅速、高效和强大！ > {.is-success} > {.is-success} > {.is-success} > {.is-success} +> {.is-success} # 3. 平面板 @@ -123,6 +141,7 @@ sudo flatpak 卸载 > {.is-info} > {.is-info} > {.is-info} +> {.is-info} # 4. AppImage diff --git a/zh/how-to/proton-run.md b/zh/how-to/proton-run.md index 7fc91189..384f99a7 100644 --- a/zh/how-to/proton-run.md +++ b/zh/how-to/proton-run.md @@ -15,7 +15,7 @@ dateCreated: 2025-05-07T14：44：47.710Z # 1. B. 所需经费 - An RK3588 system running BredOS. -- Steam。 Steam。 Steam。 Steam。 Steam。 Steam。 ([Guide here](/how-to/how-to-install-steam)) +- Steam。 Steam。 Steam。 Steam。 Steam。 Steam。 Steam。 ([Guide here](/how-to/how-to-install-steam)) # 3. 安装 diff --git a/zh/how-to/psu-charger-and-cables.md b/zh/how-to/psu-charger-and-cables.md new file mode 100644 index 00000000..d9fcd595 --- /dev/null +++ b/zh/how-to/psu-charger-and-cables.md @@ -0,0 +1,168 @@ +--- +title: 如何赋予您的SBC 权力 +description: +published: true +date: 2025-12-13T21：16：38.859Z +tags: +editor: markdown +dateCreated: 2025-11-24T08:13:30.345Z +--- + +# 2. 介绍信息 + +为单一委员会计算机提供可靠的动力是朝着建立稳定有效的嵌入系统迈出的重要一步。 然而，新来者往往感到吃惊的是，有多少因素影响到“提供权力”这种简单的东西。 该条概述了选择正确电源的基本概念，澄清了常常被误解的专用电源和专用电源之间的区别， 并探索电缆设计和USB/USB-C标准如何影响电压稳定性和电流投射。 通过了解这些基本元素，用户可以避免常见的陷井，确保性能一致，并延长其SBC硬件的寿命。 + +# 1. 我何时必须考虑这一点？ + +当您有随机重启时出现问题时，内核恐慌， 和/或不起作用的外围设备(尤其是饥饿的电源设备，如硬盘驱动器)，您应该做的第一件事就是检查您的电源。 如果你的棋盘有足够和可靠的能量，我们提供的操作系统是岩石坚固的。 + +> 如果您在这里发送，请仔细阅读这篇文章！ +> {.is-info} + +# 4. PSU 或充电？ 难道不同吗？ + +这些电源砖之间的区别在于它们的预定用途。 充电器的设计是为了充电，因此它不需要处理浏览器。 当您家中掉落的交流电压可能由于各种原因而发生浏览。 例如，制冷器需要相当大的能量才能启动其压缩机。 当压缩机激活时， 它可以从你的墙套接字中抽取太多的电力，使你整个家中的电压暂时降到低于你国家的标准额定电压。 这种情况可能导致充电器暂时停止供电。 然而，当使用充电器向电池驱动设备充电时，这不是问题，因为设备有自己的电池可以运行。 另一方面，单一委员会计算机完全依靠这一权力，可能在浏览时崩溃。 + +- 这是边缘电压。 You can tell when it did turn on by looking at the voltage drop: + ![voltage.png](/psu-charger/voltage.png) + +为了管理这种情况，已经建立了一个PSU（电力供应股）。 它含有像小型电池这样起作用的电容器，以弥补电压中的短暂滴，为您的SBC提供稳定的电源。 + +## 3.1 我如何找出什么样的动力砖？ + +不幸的是，无法可靠地确定你拥有哪种类型的电源砖。 然而，你可以作出一些假设来确定它。 一般来说，由于PSU需要更多的组件，它们往往更加沉重和更加昂贵。 这并不意味着昂贵的电源砖必然是一个PSU, 但你可以假设一个廉价或免费的电源砖(例如带着你的手机的电源)可能是充电器。 + +
Recommended Power Supplies + +> 这些链接仅供示范使用。 我们没有因将其列入而得到任何补偿，我们也没有认可任何具体的采购来源。 +> {.is-info} + +我们建议使用 [橙色Pi PD100W](http://www.orangepi.org/html/hardWare/powerSuppliesAndCables/details/PD100W-EU.html)，这是一个100W USB-C PD 兼容的供电。 它告诉我们它是如何建造和处理电力供应的。 + +另一个很好的选项是购买[Lenovo USB-C 65W 笔记本电脑供电](https://www.lenovo.com/gb/en/p/accessories-and-software/chargers-and-batteries/chargers/4x20m26276)。 在使用过的市场上常常能够以合理的价格找到这些技术，并且与我们支持的附属机构非常有效。 + +第三个选项是苹果Macbook的PSU，只要您选择它的 USB-C版本。 +[35 Watts 版本](https://www.apple.com/shop/product/mw2h3am/a/35w-dual-usb-c-port-compact-power-adapter) +[70 Watts 版本](https://www.apple.com/shop/product/mxn53am/a/70W%20USB-C%20Power%20Adapter) +[140 Watts 版本](https://www.apple.com/shop/product/mw2m3am/a/140w-usb-c-power-adapter) + +包含在FydeTab Duo的PSU也很好；但是，不能单独购买。 + +[This UGREEN brick](https://eu.ugreen.com/products/ugreen-65w-usb-c-pd-charger-4-ports) is also a good option, as long as you take care of [3.4 What about multi-port chargers](#h-34-what-about-multi-port-chargers) + +
+ +## 3.2 如何确定我积木的功率输出？ + +虽然大多数充电器和供电器都为其最大功率输出作广告，但对于它们所支持的所有电压来说却不是这样。 如果我们检查Orange Pi PD100W，它的规格就会在它们的产品页面和电源砖本身上列出。 要确定手表中的电源输出, 你需要用安培乘坐电压。 + +
+ +$Voltage \* Ampere = Watt$ + +
+ +
+ +
+ +| 电压 | Ampere | 瓦特 | +| -------- | --------- | ------ | +| 5 Volts | 3 Amperes | 15 瓦特 | +| 9 Volts | 3 Amperes | 27 瓦特 | +| 12 Volts | 3 Amperes | 36 瓦特 | +| 15 Volts | 3 Amperes | 45 瓦特 | +| 20 Volts | 5 Amperes | 100 瓦特 | + +从这个列表中，我们可以确定这个砖块能够为橙色Pi 6 Plus提供动力， 因为它要求从积木中获得20V，最多提供100瓦供使用。 它的前身Orange Pi 5 Plus从砖块中请求5V，并且只获得这种电力供应的15W。 这笔钱几乎不足以使这个SBC获得电力，因为它的芯片(RK3588)可以自己拿15W。 此外，Orange Pi 5 Plus的产品页将其电力要求定为5V/4A或20W。 + +
+ + + +
+ +## 3.3 USB-C输送电力是什么，为什么它很重要？ + +如上表所示，遵守USB-C PD标准的充电器和PSU可以提供多个输出电流。 如果您的电源砖，SBC和电缆(更多电缆)都支持PD, 您的设备能够通过USB-C电缆进行通信，以确定电砖和SBC的可接受电压和安培。 这种沟通使他们能够选择最好的组合。 并非所有设备都正确支持或实现此功能。 例如，Orange Pi 5 Plus不支持USB-C PD，尽管使用USB-C端口为棋盘供电。 相比之下，Radxa Rock 5/5B在9V/2A、12V/2A、15V/2A和20V/2A支持USB-C PD。 + +由于USB-C电源配送是USB-C特性的一部分，它不被USB-A支持。 如果没有 USB-C PD 通信，你的电源积木的输出电压将为 5 伏。 + +> USB-C PD 通信应总是在5伏特发生，但有些电源积木不正确地实现了这一功能。 这些电源积木可能会在最后一个已知的电流中尝试PD通讯，从而潜在地破坏你的SBC。 这种积木很少，但确实存在。 +> {.is-info} + +## 3.4 多端口收费是什么？ + +某些USB电源带有多个端口，不管是USB-A，还是USB-C。 如果积木支持任何形式的快速充电，USB电源送电，二次充电或任何类似的设备， PSU 必须处理任何和所有已连接设备的电源配置。 + +大多数这样的 PSUs 通过完全重置自己来实现这个功能，立即切断所有端口的电源，只要**任何**设备都已插入或断开。 +这意味着你的SBC会短暂地断电。 + +因此，如果您计划使用多端口积木，请在棋盘处于活动状态时避免插件或卸载设备。 + +# 5. 电缆；它们也不是所有的 + +正如你们可能已经猜到的那样，如果所有电缆都是一样的，本章将不存在。 USB电缆在两个插件之间的铜线线路上有所不同，但不是插件本身。 下表显示了不同铜线路支持的USB标准。 + +\| USB standard | VCC & GND | Data Plus / Minus | SSTX+ / SSTX− & SSRX+ / SSRX− | CC1 / CC2 | SBU1 / SBU2 | TX1+ / TX1− & RX1+ / RX1− | TX2+ / TX2− & RX2+ / RX2− | GND_DRAIN / Shield | Supported Power | +\| ------- | ------- | ------ | ------- | ------- | ------ | ------- | ------- | ------ | +\| USB 1.1 & 2.0 | X | X | | | | | | | 2.5 Watts | +\| USB 3.x | X | X | X | | | | | X | 15 Watts | +\| USB-C minimal | X | X | | X | X | | | | 60 Watts | +\| USB-C full | X | X | | X | X | X | | X | 240 Watts | +\| USB-C Thunderbolt | X | X | | X | X | X | X | X | 240 Watts | + +虽然该表区分了三类美国广播公司电缆，但最终取决于制造商在电缆中使用多少铜。 由于铜是昂贵的，正如你们可能猜到的那样，许多制造商降低了这些电缆的成本。 此外，仅仅因为USB电缆在两端都有USB-C插件，不意味着它支持任何 USB-C标准。 您可以简单地使用 USB -C插件制造一个 USB 2.0兼容的电缆，然后低价出售它们。 这些类型的电缆通常在加油站、机场或杂货店销售。 它们通常在包装上没有任何评级，通常只提供2.5瓦，类似于“普通”USB 2.0 电缆。 + +> 不要购买这种电缆！ 他们很慢，很有可能抓到火力！ +> {.is-info} + +需要考虑的另一个方面是存在着所谓的“电子标记”芯片。 此chips 拥有关于您有线电视的功能的信息。 没有这个芯片，电缆可以最大输送60瓦。 通过30个特设工作组铜的连接，运送60瓦可能具有潜在的危险；但是，电源砖和BBC都不会发现这个问题。 如有必要，委员会可继续绘制60瓦，直到电缆发生火灾。 大多数国家都禁止有抓获火力的电缆，但这并不阻止任何人出售电缆。 + +## 4.1 电缆长度是否重要？ + +在一个理想的世界中，USB-C电缆应能完美地运行3米长； 然而，正如前一章所表明的那样，我们生活在这样一个完美的世界中。 + +较长的电缆遇到两个主要问题。 第一，如果屏蔽不当，任何电缆都可以起天线的作用。 具有讽刺意味的是，把捕获的信号转向地面，以此保护自己就像天线一样行事，因此这些信号不会影响任何内部线路。 电缆越长，它就越有效地发挥天线的作用，这对内部电缆配对和整个电缆都是必不可少的。 + +第二个问题产生于铜连接的内部抵抗力。 如前所述，制造商往往省去一些铜的连接，从而降低成本。 另一项节省开支的措施是削弱这些联系，从而增加了它们内部的抵制。 这就产生了两个问题：第一，通过薄电缆不断提取高能量产生热量。 如果这种热不能消散——例如，如果你的电缆被隐藏在管道里——它最终可能导致火灾。 第二个更常见的问题是，增强抗性会影响电压水平。 假定廉价电缆具有0.25欧亚的抗性，我们的SBC在5V/2A上运行，计算结果如下： + +$2 A × 0.25 C = 0.5V$ + +这导致电压下降0.5伏。 因此，虽然电砖输出5伏，但只有4.5伏达到您的SBC。 + +缩略图规则是你的电缆越长，它的构造就就越好。 它最好使用尽可能短的电缆进行设置，但不超过1.5米的电缆长度。 + +如果您确实需要超过1.5米，我们建议使用[Apple USB-C电缆](https://www.apple.com/shop/product/myqt3am/a/240w-usb-c-charge-cable-2-m)。 + +## 4.2 如何确定有哪种电缆i ？ + +除了USB-A电缆之外，如果它们支持 USB 3 和任何其他的 USB 1颜色，它们有蓝色插拔。 或 2.0，只有两种方法来确定如何构建它们。 + +最简单但又具有破坏性的方法是把车厢的护盾绑起来，并计算两端之间的铜联系。 如果仔细操作，电缆可能在以后仍然可以使用；然而，由于USB-C是为高速和高频应用设计的，这种操作无法保证。 + +另一种方法是使用电缆测试器。 在像AliExpress这样的平台上可以找到这些成本低廉的东西。 典型的情况是，你将电缆两端插入测试器。 其LED灯能点燃以显示电缆中存在的任何铜连接。 + +这两种方法都不能在店内或在网上购买。 作为缩略图的规则，请检查软件包或产品页面的评分。 此外，当在当地商店购买电缆时，你可以通过感受它们的强度来测量它们的质量。 一般而言，更加严格的情况表明电缆内有更好的防护和更多的铜连接。 至少避免购买现有最便宜的电缆或您将感到失望。 + +> The Youtube channel "GreatScott!" has made a great two part series about USB-C cables found [here (Part one)](https://www.youtube.com/watch?v=ZikvlsVDiQY) and [here (Part two)](https://www.youtube.com/watch?v=LOIVrVVYBfA). +> {.is-info} + +# 4. 如何处理所有这些信息？ + +在阅读了所有这些之后，你可能会得出这样的结论，即这种情况相当复杂。 你是正确的！ 如果您遇到了“2”部分描述的问题。 什么时候我需要考虑这个？"，请检查您的SBC、电源积木和电缆的产品页面。 如果您找不到任何关于评分的信息，请停止使用那个电源积木或电缆。 + +如果您在购买PSU之前阅读了这篇文章, 请考虑如何使用您的看板。 例如，如果你想要使用一个 Orange Pi 5 Plus, 带有两个旋转硬盘, 各为 5V/1A 级, 只需添加这些值: + +20W+5W+5W=30W$ + +然后确保你的电砖不会负担过重， 计算它应提供多少功率以使其正常使用约80%： + +30 W / 0.8 =37.5W$ + +在这种情况下，我们建议至少给予37.5瓦的PSU等级。 + +> TL;DR 获取规格，执行数学，不使用廉价的电缆！ +> 快乐游戏！ +> {.is-success} +> {.is-success} diff --git a/zh/how-to/run-vms.md b/zh/how-to/run-vms.md index e487ac3c..e8a3bc66 100644 --- a/zh/how-to/run-vms.md +++ b/zh/how-to/run-vms.md @@ -35,6 +35,7 @@ sudo pacman -S virt-manager virt-viewer qemu-Base qemu-system-aarch64 edk2-aarch > {.is-info} > {.is-info} > {.is-info} +> {.is-info} ## 第 2 步：启用并启动 Libvirt 服务 @@ -67,7 +68,7 @@ sudo usermod -aG libvirt $(whoami) ## 3.4 配置网络 -- `virt-manager` 使用 `dnsmasq` 进行网络管理。 `virt-manager` 使用 `dnsmasq` 进行网络管理。 您可能想要确保使用 "libvirt" 的默认网络设置： `virt-manager` 使用 `dnsmasq` 进行网络管理。 您可能想要确保使用 "libvirt" 的默认网络设置： `virt-manager` 使用 `dnsmasq` 进行网络管理。 您可能想要确保使用 "libvirt" 的默认网络设置： `virt-manager` 使用 `dnsmasq` 进行网络管理。 您可能想要确保使用 "libvirt" 的默认网络设置： `virt-manager` 使用 `dnsmasq` 进行网络管理。 您可能想要确保使用 "libvirt" 的默认网络设置： `virt-manager` 使用 `dnsmasq` 进行网络管理。 您可能想要确保使用 "libvirt" 的默认网络设置： +- `virt-manager` 使用 `dnsmasq` 进行网络管理。 `virt-manager` 使用 `dnsmasq` 进行网络管理。 您可能想要确保使用 "libvirt" 的默认网络设置： `virt-manager` 使用 `dnsmasq` 进行网络管理。 您可能想要确保使用 "libvirt" 的默认网络设置： `virt-manager` 使用 `dnsmasq` 进行网络管理。 您可能想要确保使用 "libvirt" 的默认网络设置： `virt-manager` 使用 `dnsmasq` 进行网络管理。 您可能想要确保使用 "libvirt" 的默认网络设置： `virt-manager` 使用 `dnsmasq` 进行网络管理。 您可能想要确保使用 "libvirt" 的默认网络设置： `virt-manager` 使用 `dnsmasq` 进行网络管理。 您可能想要确保使用 "libvirt" 的默认网络设置： `virt-manager` 使用 `dnsmasq` 进行网络管理。 您可能想要确保使用 "libvirt" 的默认网络设置： ```bash sudo virsh net-start 默认 @@ -92,10 +93,11 @@ sudo virsh net-autostart > {.is-info} > {.is-info} > {.is-info} +> {.is-info} ## 步骤6：启用 XML 编辑 -- 要启用 XML 编辑 (需要稍后) ，您需要打开 `virt-manager` ，然后导航到 `Edit` 然后导航到 `Preferences` 和 \\\\`启用 XML 编辑'。 +- 要启用 XML 编辑 (需要稍后) ，您需要打开 `virt-manager` ，然后导航到 `Edit` 然后导航到 `Preferences` 和 \\\\\`启用 XML 编辑'。 # 4. 3.7 创建虚拟机 @@ -112,6 +114,7 @@ sudo virsh net-autostart > {.is-warning} > {.is-warning} > {.is-warning} +> {.is-warning} - On CPUs with the little.big architecture like the RK3588 you need to check "Customize configuration before install" and edit the xml responsible for allocating cpu cores ![finalstep.jpg](/vms/finalstep.jpg) diff --git a/zh/how-to/sdcard-maint.md b/zh/how-to/sdcard-maint.md new file mode 100644 index 00000000..d16783b9 --- /dev/null +++ b/zh/how-to/sdcard-maint.md @@ -0,0 +1,31 @@ +--- +title: MicroSD 卡维护 +description: 你喜欢iowash +published: true +date: 2025-12-13T22：34：16.374Z +tags: +editor: markdown +dateCreated: 2025-12-13T22：34：16.374Z +--- + +# 2. 基本MicroSD Trivia + +您是否注意到，随着卡片的老化，并且有越来越多的插入，它只是停止可靠的联系？ + +SDCard接触粉丝是用非常薄的金和镍电镀制成的，不幸的是，这种电镀很快就消失了。 一旦黄金消失，镍很乐意与空气氧化，从而产生了一种远不那么导电的化合物。 +不同于USB，它们的平坦表面不允许端口自动去除氧化物。 + +# 3. 清理卡片 + +IPA（IsoPropyl Alcochol）是这样做的极好材料。 +典型的急救投资促进机构(70%的纯度)足以满足这一需要。 但任何较高的纯度变异（和伏特卡）也起作用，有效地消除了一层氧化物。 + +要清理卡片，建议您不要直接将IPA拖到卡片上， 由于空隙很小，可能会让它沉入卡内。 相反，建议在一种微纤维衣服上使用投资促进机构的痕量数量，并将卡片加在湿部分上。 微纤维只是温和的，因为你对它们施加压力。 它建议在循环模式中使用可怕的废墟。 + +如果你做得恰当，这只需要5秒钟的橡皮才能将卡片恢复到可靠的操作。 + +# 4. 清理后 + +不要立即将卡片插入设备。 确保投资促进机构有足够的时间完全消失。 它具有很强的导向性，读者和卡片都可能被损坏。 + +牢记，现在金层已经破旧，卡片将需要更频繁的清洁。 然而，虽然它已经插入了插电，但是接触区域不应氧化起来。 设备可能会无限期地读取卡。 \ No newline at end of file diff --git a/zh/how-to/switch-desktop-environments.md b/zh/how-to/switch-desktop-environments.md index aec5b6de..03c0e85d 100644 --- a/zh/how-to/switch-desktop-environments.md +++ b/zh/how-to/switch-desktop-environments.md @@ -45,6 +45,7 @@ sudo systemctl enable gdm > {.is-warning} > {.is-warning} > {.is-warning} +> {.is-warning} ## 输入 **屏幕旋转** @@ -81,6 +82,7 @@ sudo pacman -S extension-manager 若要将此设置为水平工作，请按照这些步骤进行操作。 若要将此设置为水平工作，请按照这些步骤进行操作。 若要将此设置为水平工作，请按照这些步骤进行操作。 +若要将此设置为水平工作，请按照这些步骤进行操作。 ### 1.4.1 编辑udev规则 diff --git a/zh/how-to/systemd-nspawn.md b/zh/how-to/systemd-nspawn.md index 4911670e..cf581102 100644 --- a/zh/how-to/systemd-nspawn.md +++ b/zh/how-to/systemd-nspawn.md @@ -41,6 +41,7 @@ mkdir 模板 > 任何需要在容器内运行的命令，如果您不使用 BredOS，则必须根据您的发行版变量进行调整。 > {.is-info} > {.is-info} +> {.is-info} - [Ubuntu-base](https://cdimage.ubuntu.com/ubuntu-base/releases/) 查找您选择的版本，然后下载 .tar.gz 为您的 CPU 架构。 - [Debian genericcloud](https://cloud.debian.org/images/cloud/) 向下滚动并点击您想要下载的版本，然后为您的 CPU 架构下载.tar.gz。 @@ -49,12 +50,14 @@ mkdir 模板 - [Arch Linux ARM](https://archlinuxarm.org/os/) 用 `latest` 和 `arch64` 或 `armv7` 标签下载.tar.gz文件。 {.links-list} {.links-list} + {.links-list} > BredOS rootfs 即将可用！ > {.is-warning} > {.is-warning} +> {.is-warning} -下载您选中的 rootfs 沥青后，需要提取。 在此示例中，我们下载了Arch Linux ARM tarball并将其转换为BredOS。 当你下载了你的rootfs tarball后，我们需要提取它。 在此示例中，我们下载了Arch Linux ARM tarball并将其转换为BredOS。 +下载您选中的 rootfs 沥青后，需要提取。 在此示例中，我们下载了Arch Linux ARM tarball并将其转换为BredOS。 当你下载了你的rootfs tarball后，我们需要提取它。 在此示例中，我们下载了Arch Linux ARM tarball并将其转换为BredOS。 当你下载了你的rootfs tarball后，我们需要提取它。 在此示例中，我们下载了Arch Linux ARM tarball并将其转换为BredOS。 - 仍然作为根提取tarball到 `/var/lib/orges/template`： @@ -75,7 +78,7 @@ bin boot dev etc home lib mnt lease proc root runs sbin srv sys tmp usr var systemd-nspawn --machine="Template" --directory=/var/lib/organes/template ``` -参数`--machine`定义容器的名称，而`--directory`指向容器的位置。 离开容器， 使用 Ctrl + D 或输入 Ctrl + ] 在一秒内使用三次。 参数`--machine`定义容器的名称，而`--directory`指向容器的位置。 To exit the container, use either Ctrl + D or type Ctrl + ] three times within one second. +参数`--machine`定义容器的名称，而`--directory`指向容器的位置。 离开容器， 使用 Ctrl + D 或输入 Ctrl + ] 在一秒内使用三次。 参数`--machine`定义容器的名称，而`--directory`指向容器的位置。 To exit the container, use either Ctrl + D or type Ctrl + ] three times within one second. 参数`--machine`定义容器的名称，而`--directory`指向容器的位置。 To exit the container, use either Ctrl + D or type Ctrl + ] three times within one second. 我们想要在容器内做的第一件事是初始化我们的包管理器并更新系统。 @@ -146,7 +149,8 @@ mkdir /var/lib/miles/template-veth rsync -avP /var/lib/miles/template/* /var/lib/meches/template-veth/ ``` -> 为了简化本指南，我们将继续使用在 [2] 创建的模板。 为了简化本指南，我们将继续使用在 [2] 创建的模板。 创建容器模板](#h-3-create-container-template)。 +> 为了简化本指南，我们将继续使用在 [2] 创建的模板。 为了简化本指南，我们将继续使用在 [2] 创建的模板。 为了简化本指南，我们将继续使用在 [2] 创建的模板。 创建容器模板](#h-3-create-container-template)。 +> {.is-info} > {.is-info} > {.is-info} @@ -199,7 +203,8 @@ useradd passwd ``` -> 由于您可能想要使用您的虚拟网络设备进行实际网络连接，需要进行进一步的配置。 由于您可能想要使用您的虚拟网络设备进行实际网络连接，需要进行进一步的配置。 例如使用 [Open vSwitch](/how-to/open-vswitch) 或一个简单的桥接设备将虚拟网络设备连接到某些东西。 +> 由于您可能想要使用您的虚拟网络设备进行实际网络连接，需要进行进一步的配置。 由于您可能想要使用您的虚拟网络设备进行实际网络连接，需要进行进一步的配置。 由于您可能想要使用您的虚拟网络设备进行实际网络连接，需要进行进一步的配置。 例如使用 [Open vSwitch](/how-to/open-vswitch) 或一个简单的桥接设备将虚拟网络设备连接到某些东西。 +> {.is-info} > {.is-info} > {.is-info} @@ -238,7 +243,7 @@ WantedBy=multi-user。 arget ``` -如果你想要在你的容器上使用虚拟网络设备，`ExecStart=/usr/...`--network\\`。 +如果你想要在你的容器上使用虚拟网络设备，`ExecStart=/usr/...`--network\\\`。 - 然后你可以开始容器： @@ -266,7 +271,7 @@ sudo 机 # 🔄 3. 从容器内存访问主机上的文件/文件夹 -如名称所示，容器通常无法访问您的主机系统。 如名称所示，容器通常无法访问您的主机系统。 这可以被修改，以允许容器访问您主机系统上的特定文件或文件夹； 例如，提供额外的存储空间或授予您的 GPU 容器访问权限。 +如名称所示，容器通常无法访问您的主机系统。 如名称所示，容器通常无法访问您的主机系统。 这可以被修改，以允许容器访问您主机系统上的特定文件或文件夹； 例如，提供额外的存储空间或授予您的 GPU 容器访问权限。 如名称所示，容器通常无法访问您的主机系统。 这可以被修改，以允许容器访问您主机系统上的特定文件或文件夹； 例如，提供额外的存储空间或授予您的 GPU 容器访问权限。 - 访问文件/文件夹可以通过 "--bind" 参数缓存： @@ -291,4 +296,4 @@ sudo 机 # 5. 附加注释 -`systemd-nspawn`是一个极强大的工具。 What we covered here are just the basics. 我们在这里谈到的只是基本问题。 `systemd-nspawn`是一个极强大的工具。 我们在这里谈到的只是基本问题。 看看他们的 [man page](https://www.freedesktop.org/software/systemd/man/latest/systemd-nspawn.html)，如果你想要惊喜！ \ No newline at end of file +`systemd-nspawn`是一个极强大的工具。 What we covered here are just the basics. 我们在这里谈到的只是基本问题。 我们在这里谈到的只是基本问题。 `systemd-nspawn`是一个极强大的工具。 我们在这里谈到的只是基本问题。 看看他们的 [man page](https://www.freedesktop.org/software/systemd/man/latest/systemd-nspawn.html)，如果你想要惊喜！ \ No newline at end of file diff --git a/zh/how-to/timeshift-system-snapshots-and-rollbacks-on-btrfs.md b/zh/how-to/timeshift-system-snapshots-and-rollbacks-on-btrfs.md index 7ffdfd7e..da2bc677 100644 --- a/zh/how-to/timeshift-system-snapshots-and-rollbacks-on-btrfs.md +++ b/zh/how-to/timeshift-system-snapshots-and-rollbacks-on-btrfs.md @@ -2,7 +2,7 @@ title: 📸🔄 Btrfs Snapshots and Rollback, with Timeshift description: 使用 Timeshift 设置Btrfs 快照和系统回滚的综合指南 published: true -date: 2025-10-01T09:05:40.858Z +date: 2025-11-15T07：35：56.043Z tags: editor: markdown dateCreated: 2024-09-27T19：19：08.209Z @@ -91,8 +91,7 @@ sudo systemctl 启用 --now grub-btrfs.path yay -S tift-autosnap ``` -> `timeeshift-autosnap` 可能要求您在设备正常运行之前重新启动。 -> {.is-warning} +> `timeeshift-autosnap` 可能要求您在设备正常工作之前重新启动。 > {.is-warning} ## 3.2：防止重复 GRUB 更新 @@ -112,4 +111,5 @@ updateGrub=true > 拥有一个强大的快照系统可以在更新或系统更改过程中发生错误时节省您的日子。 > {.is-success} > {.is-success} +> {.is-success} diff --git a/zh/how-to/update-uefi-rk3588.md b/zh/how-to/update-uefi-rk3588.md index b64aa6d9..b5fb07d2 100644 --- a/zh/how-to/update-uefi-rk3588.md +++ b/zh/how-to/update-uefi-rk3588.md @@ -2,7 +2,7 @@ title: 如何在 RK3588 上更新 UEFI description: 学习如何更新基于RK3588的运行 BredOS 设备的 UEFI 固件 published: true -date: 2025-10-23T06:14:10.399Z +date: 2025-12-19T08:40:59.856Z tags: editor: markdown dateCreated: 2025-02-23T15：28：48.131Z @@ -76,6 +76,6 @@ sudo dd if=/usr/share/edk2//_UEFI_Release_vX.XX.X.img sudo dd if=/usr/share/edk2/fydetab-duo/fydetab-duo_UEFI_Release_v0.12.3.img of=/dev/mmcblk0 bs=512 skip=64 search=64 conv=notrunc ``` -> ✅ **完成！** 您的设备的 UEFI 固件现在已更新。 🚀 +> **完成！** 您的设备的 UEFI 固件现在已更新。 > {.is-success} diff --git a/zh/how-to/waydroid.md b/zh/how-to/waydroid.md index 0c64bcb8..4cc0c2e0 100644 --- a/zh/how-to/waydroid.md +++ b/zh/how-to/waydroid.md @@ -10,7 +10,7 @@ dateCreated: 2025-09-21T08：40：19.752Z # 1. 简介 -Waydroid 是基于 Wayland 在 Linux / GNU 上运行 Android 的一个基于容器的解决方案。 本指南将带你走上安装它的必要步骤。 本指南将带你走上安装它的必要步骤。 本指南将带你走上安装它的必要步骤。 本指南将带你走上安装它的必要步骤。 +Waydroid 是基于 Wayland 在 Linux / GNU 上运行 Android 的一个基于容器的解决方案。 本指南将带你走上安装它的必要步骤。 本指南将带你走上安装它的必要步骤。 本指南将带你走上安装它的必要步骤。 本指南将带你走上安装它的必要步骤。 本指南将带你走上安装它的必要步骤。 # 2. 安装 diff --git a/zh/how-to/widevine-watch-drm-content.md b/zh/how-to/widevine-watch-drm-content.md index 4321ba47..68dc70cb 100644 --- a/zh/how-to/widevine-watch-drm-content.md +++ b/zh/how-to/widevine-watch-drm-content.md @@ -28,7 +28,7 @@ sudo pacman -S widevine-aarch64 ## 2.3 为Netflix 设置 -- 要观看Netflix，您需要弄乱您的用户代理。 使用以下用户代理字符串： 使用以下用户代理字符串： 使用以下用户代理字符串： 使用以下用户代理字符串： +- 要观看Netflix，您需要弄乱您的用户代理。 使用以下用户代理字符串： 使用以下用户代理字符串： 使用以下用户代理字符串： 使用以下用户代理字符串： 使用以下用户代理字符串： ``` Mozilla/5.0 (X11; CrOS aarch64 15236.80.0.0) AppleWebKit/537.36 (KHTML, such Gecko) Chrome/109.0.5414.125 Safari/537.36 diff --git a/zh/img-types.md b/zh/img-types.md index 3e356947..a6a53823 100644 --- a/zh/img-types.md +++ b/zh/img-types.md @@ -2,12 +2,48 @@ title: 已解释的图像类型 description: published: false -date: 2025-10-30T06:45:01.591Z +date: 2025-11T07:44:16.266Z tags: editor: markdown dateCreated: 2025-10-25T18：12：07.047Z --- -# 标题 +# 2. 介绍信息 -您在这里的内容 \ No newline at end of file +此页解释了为我们的平台提供的可用图像类型之间的差异。 每个图像类型都是使用不同的Linux内核基础构建的，或者是以影响硬件支持、稳定性和更新频率的方式设计的。 理解这些差异将有助于您选择最适合您开发或生产需要的图像。 + +# 1. 设备图像 + +我们提供了所谓的“设备图像”。 想想像树莓派的树莓操作系统这样的图像。 必须刷入SD卡的 mg 文件 — 设备图像基本上是那些，但不是树莓派的图像。 这些图像主要是基于SOC制造商制作的参考内核。 确保最佳硬件支持，同时依靠维护不良的内核。 通常情况下，这些内核在释放时运行良好，但随着时间的推移，随着新功能被添加到内核并被软件所需要而恶化。 + +当然，我们尽力解决内心退化问题，但可以做的工作是有限的。 + +> 我们想要为我们目前只运送设备图像的几个设备提供主线支持。 +> [Click here](/en/campaigns/mainline-campaign) for more info. +> {.is-info} + +## 2.1 遗产(稳定) + +这些图像基于您的棋盘制造商和/或SOC制造的引用（也称为BSP）。 如上所述，这些图像支持您的SBC的大多数功能。 + +## 2.2 切割边缘 + +这些ISO 图像基于主线内核的下一个分支。 虽然硬件支持可能不是最佳的，但它们确实包含Linux内核的最新和最先进的功能。 要了解此内核上哪些功能不受支持，请参阅您在这里左侧导航栏中找到的看板的设备页面。 + +# 4. ISO 图像 + +如果您已经在您的PC上安装了 Ubuntu 或 Arch Linux，您应该熟悉ISO 图像。 这些是您基于 UEFI 的系统可以启动的虚拟CD图像。 将它们刻录在磁盘或 USB 棍棒上，您的固件应该拿起它。 + +## 3.1 BSP 图像 + +对于一些基于 ARM64 的设备，我们提供一个 ISO 图像与参考内核捆绑在一起。 这些图像包括文件名中的SBC名称。 例如，Radxa Orion O6的图像名叫BredOS-ORION-O6-[Date]-aarch64.iso。 + +## 3.2 主线图像 + +此图像类型与Linux主线内核捆绑在一起，与 x86_64 和 ARM64基础上的板块兼容。 像剪切边缘图像一样，并不支持基于 ARM64 的棋盘的所有功能。 要查明在这个内核上哪些功能不受支持， 在导航栏中找到的设备页面指向左侧。 对于以x86_64为基础的看板，任何其他Linux发行版都支持所有功能。 + +# 5. 我应该使用什么图像？ + +此决定取决于您的董事会和您想要使用它的环境。 如果您打算使用您的版面作为桌面，我们通常建议使用旧版(也称为BSP)的图像。 如果你正在使用你的棋盘作为一个服务器，我们建议选择尖端(基于主线的)图像， 因为它们提供了更强大的安全和更多的错误修复。 + +如果您不确定您需要的功能是否支持主线内核， 查看您的看板的设备特定页面。 对于我们运输一个主线内核的每个棋盘，都有一个关于支持功能的表。 \ No newline at end of file diff --git a/zh/install/Installation-of-UEFI.md b/zh/install/Installation-of-UEFI.md index fbb0f152..100e66f0 100644 --- a/zh/install/Installation-of-UEFI.md +++ b/zh/install/Installation-of-UEFI.md @@ -2,7 +2,7 @@ title: 安装UEFI(RK3588) description: published: true -date: 2025-10-23T06:14:27.097Z +date: 2025-10-22T08:32:15.492Z tags: editor: markdown dateCreated: 2025-09-16T11:29:43.061Z @@ -10,78 +10,78 @@ dateCreated: 2025-09-16T11:29:43.061Z # 1. 简介 -我们支持的许多设备确实为“UEFI”提供支持，这是一个启动硬件并启动操作系统的现代固件接口。 我们支持的许多设备确实为“UEFI”提供支持，这是一个启动硬件并启动操作系统的现代固件接口。 在`UEFI`的帮助下，您的设备能够启动 。 这样文件 (写入 USB-Stick 或烧毁到 DVD) 以及直接从NVMe 驱动器或通过 PXE 在网络上启动您的操作系统。 +我们支持的许多设备确实为“UEFI”提供支持，这是一个启动硬件并启动操作系统的现代固件接口。 我们支持的许多设备确实为"UEFI"提供支持，这是一个启动硬件并启动操作系统的现代固件接口。 在`UEFI`的帮助下，您的设备能够启动 .iso 文件（写入 USB 存储设备或烧录到 DVD）以及直接从 NVMe 驱动器或通过 PXE 在网络上启动您的操作系统。 > UEFI 的多个安装在保存您的 UEFI 设置时可能造成问题。 > {.is-warning} > {.is-warning} > {.is-warning} > {.is-warning} +> {.is-warning} # 2. 检查您的设备 -不幸的是，我们所支持的并非所有设备都支持启动 \\\\`UEFI'。 而且，并非每个设备都安装了SPI 芯片。 而且，并非每个设备都安装了SPI 芯片。 而且，并非每个设备都安装了SPI 芯片。 而且，并非每个设备都安装了SPI 芯片。 +不幸的是，我们所支持的并非所有设备都支持启动 `UEFI`。 而且，并非每个设备都安装了 SPI 芯片。 而且，并非每个设备都安装了SPI 芯片。 -- To determine what your device is capable of, check [this table](/en/table-of-supported-devices). +- 要确定您的设备支持什么功能，请查看[此表格](/en/table-of-supported-devices)。 # 3. 安装 -- 下载我们的 UEFI 版本的 [here](https://github.com/BredOS/edk2-rk3588/releases)。 +- 从[这里](https://github.com/BredOS/edk2-rk3588/releases)下载我们的 UEFI 版本。 ## 3.1 SD 卡安装 -下载与您的设备匹配的最新版本，向您的写作者输入任何大小的 SD 卡并使用您预感刷入工具。 我们建议使用： 我们建议使用： 我们建议使用： 我们建议使用： +下载与您的设备匹配的最新版本，准备任何大小的 SD 卡并使用您喜欢的刷入工具。 我们建议使用： 我们建议使用： - [BalenaEtcher](https://etcher.balena.io/) - [Raspberry Pi Imager](https://github.com/raspberrypi/rpi-imager) -> 将SD卡插入SBC，您很好！ -> {.is-success} +> 将 SD 卡插入 SBC，您就完成了！ > {.is-success} > {.is-success} -## 3.2 安装SPI设备 +## 3.2 安装到 SPI 芯片 > 如果您跳过了3.1，请回来。 需要这个步骤来刷入SPI芯片！ > 您可以在此后移除SD卡。 > {.is-info} -按照下面的步骤安装`UEFI`到你的SPI 芯片。 +按照下面的步骤安装`UEFI`到您的 SPI 芯片。 -- 将我们的`UEFI`的最新版本复制到FAT32格式的 USB-Stick 并连接到您的 SBC。 -- 从你的SD卡上启动你的棋盘到`UEFI`。 如果您在访问 UEFI 设置时遇到问题，请检查 [本指南] (/en/how-to/change-default-boot-order-rk3588#2.1-Accessing-the-Boot-Menu)。 如果您在访问 UEFI 设置时遇到问题，请检查 [本指南] (/en/how-to/change-default-boot-order-rk3588#2.1-Accessing-the-Boot-Menu)。 +- 将我们的`UEFI`的最新版本复制到 FAT32 格式的 USB 存储设备并连接到您的 SBC。 +- 从您的 SD 卡上启动您的板子到`UEFI`。 如果您在访问 UEFI 设置时遇到问题，请查看[本指南](/en/how-to/change-default-boot-order-rk3588#2.1-Accessing-the-Boot-Menu)。 If your board is booted into BredOS, it is possible to install UEFI on your SPI by following [this guide](/en/how-to/update-uefi-rk3588). - 浏览至`Boot Manager` -> `UEFI Shell` 以进入命令行接口。 -- 列出使用`map`命令的所有可读分区。 列出使用`map`命令的所有可读分区。 列出使用`map`命令的所有可读分区。 此命令列出所有分区与 fs0:`, fs1:`... 列出使用`map`命令的所有可读分区。 列出使用`map`命令的所有可读分区。 此命令列出所有分区与 fs0:`, fs1:`... -- 输入文件系统名称并按 `Enter` 键将目录更改为包含固件图像的 USB-Stick 。 如果您不确定要使用哪个文件系统，请运行以下列出其内容： 如果您不确定要使用哪个文件系统，请运行以下列出其内容： 如果您不确定要使用哪个文件系统，请运行以下列出其内容： 如果您不确定要使用哪个文件系统，请运行以下列出其内容： +- 列出使用`map`命令的所有可读分区。 列出使用`map`命令的所有可读分区。 列出使用`map`命令的所有可读分区。 此命令列出所有分区与 fs0:`, fs1:`... 使用`map`命令列出所有可读分区。 此命令列出所有分区，如 `fs0:`、`fs1:` 等。 +- 输入文件系统名称并按 `Enter` 键将目录更改为包含固件镜像的 USB 存储设备。 如果您不确定要使用哪个文件系统，请运行以下命令列出其内容： 如果您不确定要使用哪个文件系统，请运行以下列出其内容： ``` ls fs: ``` -- 用命令刷入 `UEFI` 到 SPI 芯片： +- 用以下命令将 `UEFI` 刷入 SPI 芯片： ``` -sf 更新文件 0x0 +sf update 0x0 ``` -- 请关闭您的SBC并移除SD卡。 +- 请关闭您的 SBC 并移除 SD 卡。 -## 3.3 从 BredOS 内部安装 SPI +## 3.3 从 BredOS 内部安装到 SPI -- 如果你的棋盘已经启动到 BredOS，可以通过运行以下命令在你的SPI 上安装UEFI： +- 如果您的板子已经启动到 BredOS，可以通过运行以下命令在您的 SPI 上安装 UEFI： ``` -sudo dd if=/path/to/downloaded/uefi/_UEFI_Release_vX.XX.X.img of=/dev/mtd0 +sudo dd if=/path/to/downloaded/uefi/_UEFI_Release_vX.XX.X.img of=/dev/mtdblock0 ``` -> 我们建议接下来的章节[3。 Flashing the UEFI Firmware](/en/how-to/update-uefi-rk3588#h-3-flashing-the-uefi-firmware) to learn more. +> 我们建议阅读下一章节 [3. Flashing the UEFI Firmware](/en/how-to/update-uefi-rk3588#h-3-flashing-the-uefi-firmware) 以了解更多信息。 +> {.is-info} > {.is-info} -- 请关闭您的SBC并移除SD卡。 +- 请关闭您的 SBC 并移除 SD 卡。 -> 现在你的设备能够获得所有好的 UEFI 谷物！ -> {.is-success} -> {.is-success} +> 现在您的设备能够享受所有 UEFI 的好处了！ +> 祝您使用愉快！ > {.is-success} > 快乐游戏！ > {.is-success} diff --git a/zh/install/Installation-with-ISO.md b/zh/install/Installation-with-ISO.md index 5ad22bc1..550f2c69 100644 --- a/zh/install/Installation-with-ISO.md +++ b/zh/install/Installation-with-ISO.md @@ -10,19 +10,19 @@ dateCreated: 2025-09-17T11:07:04.117Z # 1. 简介 -欢迎来到Baker，它是混合物、 knead和只是你的 BredOS 最优质原料的地方， 随着面包，你将在整个过程中被引导，从挑选正确的面粉到最好的撞击技术到它需要增加的确切时间。 所以让我们开始吧！ 随着面包，你将在整个过程中被引导，从挑选正确的面粉到最好的撞击技术到它需要增加的确切时间。 所以让我们开始吧！ 随着面包，你将在整个过程中被引导，从挑选正确的面粉到最好的撞击技术到它需要增加的确切时间。 所以让我们开始吧！ 随着面包，你将在整个过程中被引导，从挑选正确的面粉到最好的撞击技术到它需要增加的确切时间。 所以让我们开始吧！ +欢迎来到Baker，它是混合物、揉捏和烘焙您的 BredOS 最优质原料的地方。 随着面包的制作，您将在整个过程中被引导，从挑选正确的面粉到最好的揉捏技术到它需要发酵的确切时间。 所以让我们开始吧！ 随着面包，你将在整个过程中被引导，从挑选正确的面粉到最好的撞击技术到它需要增加的确切时间。 所以让我们开始吧！ -# 2. 燃烧图像 +# 2. 烧录镜像 -下载完毕。 这样从我们的 [Github 页面] (https://github.com/BredOS/bredos-iso/releases/latest) 烧它到 USB Stick, 例如和 Rufus 一起燃烧，或者烧毁一个 DVD 。 将您的安装媒体插入您的电脑并启动您的电脑。 将您的安装媒体插入您的电脑并启动您的电脑。 将您的安装媒体插入您的电脑并启动您的电脑。 将您的安装媒体插入您的电脑并启动您的电脑。 +下载完成后，从我们的 [Github 页面](https://github.com/BredOS/bredos-iso/releases/latest) 将其烧录到 USB 存储设备，例如使用 Rufus 烧录，或者烧录到 DVD。 将您的安装媒体插入您的电脑并启动您的电脑。 将您的安装媒体插入您的电脑并启动您的电脑。 # 3. 面包机 -## 3.1 Welcome +## 3.1 欢迎 -- 面包在启动时自动启动，但也有一个桌面快捷键来启动它而不需要重启。 要开始安装，请选择在线安装或离线安装。 要开始安装，请选择在线安装或离线安装。 要开始安装，请选择在线安装或离线安装。 要开始安装，请选择在线安装或离线安装。 +- 面包机在启动时自动启动，但也有一个桌面快捷键来启动它而不需要重启。 要开始安装，请选择在线安装或离线安装。 要开始安装，请选择在线安装或离线安装。 -> 正在构建在线安装。 请使用离线安装。 +> 在线安装正在构建中。 请使用离线安装。 > {.is-info} 请使用离线安装。 > {.is-info} @@ -33,39 +33,34 @@ dateCreated: 2025-09-17T11:07:04.117Z - 在我们开始旅程之前，我们需要就如何进行最佳沟通达成一致。 您所说的语言是什么？ 您使用什么时间格式？ 你熟悉的货币是什么？ ![2-scaled.png](/first-setup/2-scaled.png) -Look up your prefered language and click on it. 然后一个窗口将弹出您可以选择您的区域的位置。 时间和日期格式以及您的货币应自动填写。 请在继续之前检查它们，并随时根据您的偏好调整它们。 +查找您喜欢的语言并点击它。 然后一个窗口将弹出，您可以选择您的区域位置。 时间和日期格式以及您的货币应自动填写。 请在继续之前检查它们，并随时根据您的偏好调整它们。 然后一个窗口将弹出您可以选择您的区域的位置。 时间和日期格式以及您的货币应自动填写。 请在继续之前检查它们，并随时根据您的偏好调整它们。 -## 3.3 关于膝上型技术 +## 3.3 关于键盘布局 让我们谈谈膝盖。 每个人都是不同的，因此没有单一的“true”膝盖技术。 为了适应这个问题，你可以根据你的国家选择你的技术。 -让我们谈论敲打。 所有人都是不同的，因此没有“true”撞击技术器。 在我们的说明中，您可以根据您的国家选择您的技术。 ![6-scaled.png](/first-setup/6-scaled.png) -After you clicked on your country you can choose your layout. 名称表示“正常”是最常用的布局。 如果您不确定，请使用它。 如果您有一个不寻常的键盘，就像那些由 Apple 出售的键盘一样，选择相应的布局。 如果您不确定，请使用它。 如果您有一个不寻常的键盘，就像那些由 Apple 出售的键盘一样，选择相应的布局。 如果您不确定，请使用它。 名称表示“正常”是最常用的布局。 如果您不确定，请使用它。 如果您有一个不寻常的键盘，就像那些由 Apple 出售的键盘一样，选择相应的布局。 如果您不确定，请使用它。 如果您有一个不寻常的键盘，就像那些由 Apple 出售的键盘一样，选择相应的布局。 如果您不确定，请使用它。 名称表示“正常”是最常用的布局。 如果您不确定，请使用它。 如果您有一个不寻常的键盘，就像那些由 Apple 出售的键盘一样，选择相应的布局。 如果您不确定，请使用它。 如果您有一个不寻常的键盘，就像那些由 Apple 出售的键盘一样，选择相应的布局。 如果您不确定，请使用它。 如果您有一个不寻常的键盘，就像那些由 Apple 出售的键盘一样，选择相应的布局。 +在您点击您的国家后，您可以选择您的布局。 名称标示"正常"是最常用的布局。 如果您不确定，请使用它。 如果您有一个不寻常的键盘，就像那些由 Apple 出售的键盘一样，请选择相应的布局。 名称表示“正常”是最常用的布局。 如果您不确定，请使用它。 如果您有一个不寻常的键盘，就像那些由 Apple 出售的键盘一样，选择相应的布局。 如果您不确定，请使用它。 如果您有一个不寻常的键盘，就像那些由 Apple 出售的键盘一样，选择相应的布局。 如果您不确定，请使用它。 名称表示“正常”是最常用的布局。 如果您不确定，请使用它。 如果您有一个不寻常的键盘，就像那些由 Apple 出售的键盘一样，选择相应的布局。 如果您不确定，请使用它。 如果您有一个不寻常的键盘，就像那些由 Apple 出售的键盘一样，选择相应的布局。 如果您不确定，请使用它。 名称表示“正常”是最常用的布局。 如果您不确定，请使用它。 如果您有一个不寻常的键盘，就像那些由 Apple 出售的键盘一样，选择相应的布局。 如果您不确定，请使用它。 如果您有一个不寻常的键盘，就像那些由 Apple 出售的键盘一样，选择相应的布局。 如果您不确定，请使用它。 名称表示“正常”是最常用的布局。 如果您不确定，请使用它。 如果您有一个不寻常的键盘，就像那些由 Apple 出售的键盘一样，选择相应的布局。 如果您不确定，请使用它。 如果您有一个不寻常的键盘，就像那些由 Apple 出售的键盘一样，选择相应的布局。 如果您不确定，请使用它。 如果您有一个不寻常的键盘，就像那些由 Apple 出售的键盘一样，选择相应的布局。 > 使用文本栏测试您的布局。 当您必须输入密码时，这很重要！ > {.is-info} -## 3.4 上升的过程 +## 3.4 时区设置 - 在这里的Bakery，我们怀着爱情工作。 我们完全承认，布赖德需要时间才能成为我们大家都熟悉的可爱产品。 为此，我们需要知道您的时区。 -在这里的Bakery，我们怀着爱情工作。 我们完全承认，布赖德需要时间才能成为我们大家都熟悉的可爱产品。 为此，我们需要知道您的时区。 ![9-scaled.png](/first-setup/9-scaled.png) -Select your Region and Zone using the dropdown menus. 您当前的时间应该在下方显示，以确保时间设置正确。 +使用下拉菜单选择您的地区和时区。 您当前的时间应该在下方显示，以确保时间设置正确。 您当前的时间应该在下方显示，以确保时间设置正确。 ## 3.5 在我们等待时，我们可以相互了解 - 既然我们的苦力已经被拳打脚踢，我们知道它还需要多长时间。 我们有一些时间能够更好地相互了解。 告诉我，你有什么名字？ 您是否有昵称？ 如果我要问的话，你会给你的骨牌什么名字？ -！[10-scaled.png](/first-setup/10-scaled.png) -请填写您的姓名、用户名和主机名。 主机名将用作您网络上的友好名称。 然后输入两次密码。 您可以使用眼睛图标显示或隐藏您的密码。 主机名将用作您网络上的友好名称。 然后输入两次密码。 您可以使用眼睛图标显示或隐藏您的密码。 主机名将用作您网络上的友好名称。 然后输入两次密码。 您可以使用眼睛图标显示或隐藏您的密码。 +![10-scaled.png](/first-setup/10-scaled.png) +请填写您的姓名、用户名和主机名。 主机名将用作您网络上的友好名称。 然后输入两次密码。 您可以使用眼睛图标显示或隐藏您的密码。 主机名将用作您网络上的友好名称。 然后输入两次密码。 您可以使用眼睛图标显示或隐藏您的密码。 -如果您想要禁用密码保护为 sudo 和 polkit, 请切换相应切换。 +如果您想要禁用 sudo 和 polkit 的密码保护，请切换相应开关。 -> 请注意，禁用密码保护允许在无密码的根级运行程序！ 此 \*\*can \*\* 是危险的 ！ -> {.is-danger} 此 \*\*can \*\* 是危险的 ！ -> {.is-danger} 此 \*\*can \*\* 是危险的 ！ -> {.is-danger} 此 \*\*can \*\* 是危险的 ！ +> 请注意，禁用密码保护允许在无密码的情况下以 root 权限运行程序！ 这**可能**是危险的！ > {.is-danger} 此 \*\*can \*\* 是危险的 ！ > {.is-danger} @@ -73,42 +68,41 @@ Select your Region and Zone using the dropdown menus. 您当前的时间应该 如果您想要跳过LightDM登录屏幕并在没有密码的情况下登录到您的系统，请切换开关。 -## 3.6 共享是关爱的 +## 3.6 分区设置 - 由于你可能想要与其他东西分享你的存储，我们现在准备将它分成几个部分。 还是你想用蓝色填满它？ 描述我们将如何选择，但我们尊重你的选择。 ![partition.png](/first-setup/partition.png) -选择您想要安装 BredOS 的存储设备。 选择您想要安装 BredOS 的存储设备。 如果你喜欢将BredOS 安装在整个磁盘上，选择"擦除盘"，然后点击"下一步"。 选择您想要安装 BredOS 的存储设备。 如果你喜欢将BredOS 安装在整个磁盘上，选择"擦除盘"，然后点击"下一步"。 选择您想要安装 BredOS 的存储设备。 如果你喜欢将BredOS 安装在整个磁盘上，选择"擦除盘"，然后点击"下一步"。 +选择您想要安装 BredOS 的存储设备。 选择您想要安装 BredOS 的存储设备。 如果你喜欢将BredOS 安装在整个磁盘上，选择"擦除盘"，然后点击"下一步"。 选择您想要安装 BredOS 的存储设备。 如果你喜欢将BredOS 安装在整个磁盘上，选择"擦除盘"，然后点击"下一步"。 选择您想要安装 BredOS 的存储设备。 如果你喜欢将BredOS 安装在整个磁盘上，选择"擦除盘"，然后点击"下一步"。 选择您想要安装 BredOS 的存储设备。 如果您喜欢将 BredOS 安装在整个磁盘上，选择"擦除磁盘"，然后点击"下一步"。 > 这将删除磁盘上的任何数据！ > {.is-danger} > {.is-danger} > {.is-danger} > {.is-danger} +> {.is-danger} -如果您在您想要保存的磁盘上有数据，请单击"Open GParted"以根据需要调整现有分区的大小。 然后创建两个新的分区：一个FAT32格式的引导分区，另一个格式的分区格式化的 Btrfs 或 ext4。 然后创建两个新的分区：一个FAT32格式的引导分区，另一个格式的分区格式化的 Btrfs 或 ext4。 然后创建两个新的分区：一个FAT32格式的引导分区，另一个格式的分区格式化的 Btrfs 或 ext4。 然后创建两个新的分区：一个FAT32格式的引导分区，另一个格式的分区格式化的 Btrfs 或 ext4。 +如果您在您想要保存的磁盘上有数据，请单击"Open GParted"以根据需要调整现有分区的大小。 然后创建两个新的分区：一个 FAT32 格式的引导分区，另一个格式化为 Btrfs 或 ext4 的根分区。 然后创建两个新的分区：一个FAT32格式的引导分区，另一个格式的分区格式化的 Btrfs 或 ext4。 -> 要安装 BredOS ，您需要一个 512MB 启动分区和至少 8GB 根分区。 -> {.is-info} -> {.is-info} +> 要安装 BredOS，您需要一个 512MB 启动分区和至少 8GB 根分区。 > {.is-info} > {.is-info} ## 3.7 卵子加热（Summary） -- 既然坚韧不拔，疲劳很热，我们就停下来检查我们没有忘记任何东西。 幸运的是，贝克公司为我们自动创建了一个核对表。 +- 既然坚韧不拔，疲劳很热，我们就停下来检查我们没有忘记任何东西。 既然面团已经发好，温度很热，我们就停下来检查我们没有忘记任何东西。 幸运的是，Baker 为我们自动创建了一个核对清单。 -！[11-scaled.png](/first-setup/11-scaled.png) -请检查所有内容是否包含面粉、水、盐和青水。 膝盖是否做得适当？ 难道我们让艰难的崛起足够长的时间吗？ 如果一切都可以，请点击“安装”。 膝盖是否做得适当？ 难道我们让艰难的崛起足够长的时间吗？ 如果一切都可以，请点击“安装”。 +![11-scaled.png](/first-setup/11-scaled.png) +请检查所有内容是否正确：面粉、水、盐和酵母。 揉捏是否做得适当？ 我们让面团发酵足够长的时间了吗？ 如果一切都可以，请点击"安装"。 膝盖是否做得适当？ 难道我们让艰难的崛起足够长的时间吗？ 如果一切都可以，请点击“安装”。 -## 3.8 最好的气味莫过新鲜的贝雷德。 +## 3.8 最好的气味莫过于新鲜的 Bred - 现在抓取一杯咖啡或茶叶，然后一定时间拖入橄榄。 现在抓取一杯咖啡或茶叶，然后一定时间拖入橄榄。 思考你在面包里学到的东西，同时又有令人愉快的口味你的鼻子。 在你的Bred 完成面包时，享受这个等候时间热切期待。 在你的Bred 完成面包时，享受这个等候时间热切期待。 ![13-scaled.png](/first-setup/13-scaled.png) -## 3.9 享受你的红包 +## 3.9 享受您的 Bred - 不管你喜欢什么样的布赖特服务——平原，用奶酪和马马拉德服务， 一个慷慨的sriracha sauce,或带着一种新鲜的小鸡蛋。 我们知道，可以无数的方式享受红牌，我们热爱他们。 diff --git a/zh/install/check-sha.md b/zh/install/check-sha.md new file mode 100644 index 00000000..ccb96bcd --- /dev/null +++ b/zh/install/check-sha.md @@ -0,0 +1,53 @@ +--- +title: 关于校验和 +description: +published: true +date: 2025-12-03T08：18：57.403Z +tags: +editor: markdown +dateCreated: 2025-12-01T10：08：42.952Z +--- + +# 2. 介绍信息 + +校验和是用来确认数据没有改变的精密数字指纹。 诸如SHA家庭等现代散列功能（如SHA-256）可靠和安全地产生这些指纹。 通过比较文件已发布的校验和您自己计算的校验和，您可以快速验证其完整性和真实性。 这篇文章概述了支票和SHA散列是如何运作的，并解释了支票的基本步骤。 + +# 1. 什么是指纹/校验和？ + +指纹或校验和是一个用算法从文件生成的数字和字母的字符串。 此字符串是给定文件的唯一字符串；任何其他文件或甚至对文件的最细微改动都会导致不同的指纹。 在这方面有许多用处。 例如，许多控制台制造商在执行前使用指纹验证文件的完整性。 这样，就不可能在这种设备上运行像homebrew一样的文件，有效地确保只有制造商批准的文件才能执行。 + +# 4. 如何比较指纹？ + +要比较我们的SHA指纹和您下载的文件， 您需要获取我们在我们网站上提供的指纹，并从您下载的文件中生成一个新指纹。 + +- 要从您下载的文件生成SHA指纹，请运行： + +``` +sha256sum +``` + +- 这将输出文件的指纹： + +``` +2a6d1e524766e82ad36aeaafc41d6511f628ec0ee39fa3d14a42f5ead1f62c87 +``` + +- 将此值与我们下载部分中发现的指纹进行比较： + +![sha.png](/sha/sha.png) + +- 您可以手动比较这两个值或一步做到： + +``` +[ "$(sha256sum | cut -d' ' ' -f1)" = "" && echo OK || echo FAIL +``` + +> 我们发布的指纹是通过 .img.xz 文件生成的。 不要在验证指纹前解压缩文件。 +> {.is-info} + +# 5. 我为什么要这样做？ + +通过比较指纹和文件来验证其完整性。 因此，如果您的指纹匹配，您可以确定文件已经被正确下载。 今天的网络设备和堆栈相当坚固， 但在某些情况下，下载的文件与服务器上的文件不相同。 如果您的网络连接不好，硬件故障，或者您有点翻转，您的网络堆栈未更正， 您收到的字节可能不同于服务器发送的字节。 将文件与已发布的指纹进行比较是一种简单而快速的方法，以确保文件的有效性。 + +> 如果您已将我们的图像刷入到您的存储介质上，它没有启动，可能是验证指纹的好主意。 +> {.is-info} diff --git a/zh/install/device-specific-image.md b/zh/install/device-specific-image.md index 475eaad9..44815c98 100644 --- a/zh/install/device-specific-image.md +++ b/zh/install/device-specific-image.md @@ -2,7 +2,7 @@ title: 安装设备特定图像 description: published: true -date: 2025-10-22T08:35:52.202Z +date: 2025-09-28T08:24:20.184Z tags: editor: markdown dateCreated: 2025-09-15T12:36.362Z @@ -10,7 +10,7 @@ dateCreated: 2025-09-15T12:36.362Z # 1. 简介 -为了安装 BredOS ，我们提供了特定的设备图像，用于在其特定设备的箱子中解锁。 这将这些图像与通过ISO图像进行的安装区分开来。 通过 ISO 镜像安装更通用，但我们提供的设备支持之外的设备。 这将这些图像与通过ISO图像进行的安装区分开来。 通过 ISO 镜像安装更通用，但我们提供的设备支持之外的设备。 这将这些图像与通过ISO图像进行的安装区分开来。 通过 ISO 镜像安装更通用，但我们提供的设备支持之外的设备。 这将这些图像与通过ISO图像进行的安装区分开来。 通过 ISO 镜像安装更通用，但我们提供的设备支持之外的设备。 +为了安装 BredOS，我们提供了特定的设备镜像，用于在其特定设备上开箱即用。 这将这些镜像与通过 ISO 镜像进行的安装区分开来。 通过 ISO 镜像安装更通用，适用于我们提供设备支持之外的设备。 这将这些图像与通过ISO图像进行的安装区分开来。 通过 ISO 镜像安装更通用，但我们提供的设备支持之外的设备。 > 如果你熟悉刷新树莓操作系统，不需要进一步阅读。 只需抓取您的 SD 卡或 eMMC，您的设备特定的 BredOS 图像并用您的首选工具闪烁。 > {.is-info} Just grab your SD-Card or eMMC, your device specific image and flash with your preferred Tool. @@ -20,42 +20,43 @@ dateCreated: 2025-09-15T12:36.362Z 您可以在我们的 [Github](https://github.com/BredOS/images/releases/latest) 中找到镜像的下载链接 -# 3. 启动设备 +# 3. 安装 -- 选择您想要安装 BredOS 的存储设备： +- 安装方式因设备而异，您想要安装 BredOS 的介质。 在本指南中，我们将涵盖安装到 在本指南中，我们将涵盖安装到 在本指南中，我们将涵盖安装到 在本指南中，我们将涵盖安装到 ### Tabset {.tabset} #### SD 卡 -
有SD卡适配器 +
`3.2 可移动eMMC 和 SD Card` -将 SD 卡插入您的 PC 的 SD 卡读卡器并继续 [**4.1 与存储适配器**](#h-41-with-storage-adapter) +将 SD 卡插入您的 PC 的 SD 卡读卡器并继续 [**4.1 使用存储适配器**](#h-41-with-storage-adapter)
-
没有SD卡适配器 +
有无数工具刷入sd 卡或 eMMC。 我们建议使用 `BalenaEtcher` 或 `Raspberry Pi Imager` 。 这两个工具都支持 Linux、macOS 和 Microsoft Windows。 我们建议使用 `BalenaEtcher` 或 `Raspberry Pi Imager` 。 这两个工具都支持 Linux、macOS 和 Microsoft Windows。 我们建议使用 `BalenaEtcher` 或 `Raspberry Pi Imager` 。 这两个工具都支持 Linux、macOS 和 Microsoft Windows。 我们建议使用 `BalenaEtcher` 或 `Raspberry Pi Imager` 。 这两个工具都支持 Linux、macOS 和 Microsoft Windows。 -将您的 SD 卡插入您的 SBC 并根据您的 PC OS 在部分 [**4.2 与 RKdeveloped tool**](#h-4-2-with-rkdeveloptool)中找到的指南继续。 +将您的 SD 卡插入您的 SBC 并根据您的 PC 操作系统在 [**4.2 使用 RKDevelopTool**](#h-4-2-with-rkdeveloptool) 中找到的指南继续。 -> 在刷入之前，您必须将目标设备设置为“sd card”。 To do so have a look at [4.2 Changing flash target](/install/device-specific-image/Flashing-the-eMMC-with-Linux-or-macOS#h-42-changing-flash-target). +> 在刷入之前，您必须将目标设备设置为“sd card”。 在刷写之前，您必须将目标设备设置为"sd card"。 要这样做，请查看 [4.2 更改刷写目标](/install/device-specific-image/Flashing-the-eMMC-with-Linux-or-macOS#h-42-changing-flash-target)。 +> {.is-info} > {.is-info}
#### 不可移除的 eMMC -
使用 RKdeveloped 工具 +
使用 RKDevelopTool -根据您在 [**4.2 与 RKdevelopttool**](#h-4-2-with-rkdeveloptool) 中找到的 PCOS 继续使用指南 +根据您的 PC 操作系统，在 [**4.2 使用 RKDevelopTool**](#h-4-2-with-rkdeveloptool) 中找到指南继续
#### 可移动eMMC -
With eMMC to USB Adapter +
使用 eMMC 到 USB 适配器 -由于几乎所有已知的 USB Sticks 都是基于eMC 存储设备，在那里有 USB 到 eMMC 适配器，这些适配器是 USB-Stics ，但是可以移除eMMC 存储设备。 这些也可以用于闪烁BredOS。 这些也可以用于闪烁BredOS。 这些也可以用于闪烁BredOS。 这些也可以用于闪烁BredOS。 如下面屏幕截图所示，将eMMC连接到您的适配器。 +由于几乎所有已知的 USB 存储设备都是基于 eMMC 存储设备，因此有 USB 到 eMMC 适配器，这些适配器类似于 USB 存储设备，但可以移除 eMMC 存储模块。 这些也可以用于刷写 BredOS。 如下面屏幕截图所示，将 eMMC 连接到您的适配器。 这些也可以用于闪烁BredOS。 如下面屏幕截图所示，将eMMC连接到您的适配器。
USB 到 eMMC 适配器 @@ -63,69 +64,69 @@ dateCreated: 2025-09-15T12:36.362Z
-Then continue with [**4.1 with Storage Adapter**](#h-41-with-storage-adapter). +然后继续 [**4.1 使用存储适配器**](#h-41-with-storage-adapter)。
-
有uSD 适配器 -eMMC 基本上是一个 SD 卡，它是硬线到 SBC 的 (大多) SD卡，有适配器可以连接您的 eMC 将它们转换为 SD 卡。 +
eMMC 基本上是一个硬连接到 SBC 的 SD 卡。（大多数）SD 卡有适配器可以连接您的 eMMC 将它们转换为 SD 卡。 -
uSD Adpater and eMMC +
uSD 适配器和 eMMC ![usd-emmc-cut.png](/installation-dsi/usd-emmc-cut.png)
Firmly press the connector of the eMMC onto the uSD Adapter and connect them to your SD Card Reader. -
uSD 适配器连接到阅读器 +
uSD 适配器连接到读卡器 ![usd-connected-cut.png](/installation-dsi/usd-connected-cut.png)
-Then continue with [**4.1 with Storage Adapter**](#h-41-with-storage-adapter). +然后继续 [**4.1 使用存储适配器**](#h-41-with-storage-adapter)。
-
没有适配器 +
下面我们描述如何用适配器刷入eMMC。 下面我们描述如何用适配器刷入eMMC。 下面我们描述如何用适配器刷入eMMC。 下面我们描述如何用适配器刷入eMMC。 If you do not own a suitable adapter leave the eMMC connected to your SBC and follow [3.1 non-removable eMMC](#h-31-non-removable-emmc). -将您的 eMMC 连接到您的 SBC 并根据您在 [**4.2 与 RKdevelopttool**](#h-4-2-with-rkdeveloptool)中发现的PC操作系统继续使用指南。 +将您的 eMMC 连接到您的 SBC 并根据您的 PC 操作系统在 [**4.2 使用 RKDevelopTool**](#h-4-2-with-rkdeveloptool) 中发现的指南继续。
#### NVME -> 由于我们的设备不支持直接从NVMe驱动器启动，我们需要将UEFI安装到另一个介质。 在 UEFI 启动后，您可以直接从 nVME 驱动器启动。 To install UEFI to your SPI or SD Card follow this guide. 在 UEFI 启动后，您可以直接从 NVMe 驱动器启动。 在 UEFI 启动后，您可以直接从 nVME 驱动器启动。 To install UEFI to your SPI or SD Card follow this guide. -> {.is-warning} +> 由于我们的设备不支持直接从 NVMe 驱动器启动，我们需要将 UEFI 安装到另一个介质。 在 UEFI 启动后，您可以直接从 NVMe 驱动器启动。 要将 UEFI 安装到您的 SPI 或 SD 卡，请遵循此指南。 +> {.is-warning} 在 UEFI 启动后，您可以直接从 NVMe 驱动器启动。 在 UEFI 启动后，您可以直接从 nVME 驱动器启动。 To install UEFI to your SPI or SD Card follow this guide. 在 UEFI 启动后，您可以直接从 nVME 驱动器启动。 To install UEFI to your SPI or SD Card follow this guide. +> {.is-info} -
使用 USB 适配器 +
3.2.1.1 使用 uSD 适配器 -通过 USB 适配器将驱动器连接到您的电脑并继续 [**4.1 与存储适配器**](#h-41-with-storage-adapter)。 直接或通过 USB 适配器将驱动器连接到您的电脑。 After flashing connect the drive to the nVME port of your SBC. +通过 USB 适配器将驱动器连接到您的电脑并继续 [**4.1 与存储适配器**](#h-41-with-storage-adapter)。 通过 USB 适配器将驱动器连接到您的电脑并继续 [**4.1 使用存储适配器**](#h-41-with-storage-adapter)。 刷写后将驱动器连接到您的 SBC 的 NVMe 端口。
-
没有适配器 +
3.1 不可移动eMMC -将您的 NVMe 驱动器直接连接到您的 PC 并继续 [**4.1 与存储适配器**](#h-41-with-storage-adapter)。 您可能必须强制您的刷入工具写入硬盘。 +将您的 NVMe 驱动器直接连接到您的 PC 并继续 [**4.1 使用存储适配器**](#h-41-with-storage-adapter)。 您可能必须强制您的刷写工具写入硬盘。 您可能必须强制您的刷入工具写入硬盘。
-# 🚀 4. 刷入 +# 🚀 4. 刷写 -> 我们提供了压缩为.xz文件的图像。 请确保你在刷入之前解压他们！ +> 我们提供了压缩为 .xz 文件的镜像。 请确保您在刷写之前解压它们！ > {.is-warning} 请确保你在刷入之前解压他们！ > {.is-warning} -## 4.1 与存储适配器 +## 4.1 使用存储适配器 -有无数工具刷入sd 卡或 eMMC。 我们建议使用 `BalenaEtcher` 或 `Raspberry Pi Imager` 。 这两个工具都支持 Linux、macOS 和 Microsoft Windows。 我们建议使用 `BalenaEtcher` 或 `Raspberry Pi Imager` 。 这两个工具都支持 Linux、macOS 和 Microsoft Windows。 我们建议使用 `BalenaEtcher` 或 `Raspberry Pi Imager` 。 这两个工具都支持 Linux、macOS 和 Microsoft Windows。 我们建议使用 `BalenaEtcher` 或 `Raspberry Pi Imager` 。 这两个工具都支持 Linux、macOS 和 Microsoft Windows。 +有无数工具可以刷写 SD 卡或 eMMC。 我们建议使用 `BalenaEtcher` 或 `Raspberry Pi Imager`。 这两个工具都支持 Linux、macOS 和 Microsoft Windows。 我们建议使用 `BalenaEtcher` 或 `Raspberry Pi Imager` 。 这两个工具都支持 Linux、macOS 和 Microsoft Windows。 - [BalenaEtcher](https://etcher.balena.io/) - [Raspberry Pi Imager](https://github.com/raspberrypi/rpi-imager) -## 4.2 使用 RKdeveloped 工具 +## 4.2 使用 RKDevelopTool -为了涵盖您可以为此使用的操作系统，我们决定将安装分成这两个指南： +为了覆盖您可以使用的操作系统的多样性，我们决定将安装分成不可移除的 eMMC 到这两个指南： -- [在 Linux 或 macOS下与 RKDevelop 一起刷新](/en/install/device-specific-image/Flashing-the-eMMC-with-Linux-or-macOS) -- [Flashing with RKDevelop under Microsoft Windows](/en/install/device-specific-image/Flashing-the-eMMC-with-Microsoft-Windows) +- [在 Linux 或 macOS 下使用 RKDevelopTool 刷写](/en/install/device-specific-image/Flashing-the-eMMC-with-Linux-or-macOS) +- [在 Microsoft Windows 下使用 RKDevelopTool 刷写](/en/install/device-specific-image/Flashing-the-eMMC-with-Microsoft-Windows) diff --git a/zh/install/device-specific-image/Flashing-the-eMMC-with-Linux-or-macOS.md b/zh/install/device-specific-image/Flashing-the-eMMC-with-Linux-or-macOS.md index 5232d94c..e8f0811b 100644 --- a/zh/install/device-specific-image/Flashing-the-eMMC-with-Linux-or-macOS.md +++ b/zh/install/device-specific-image/Flashing-the-eMMC-with-Linux-or-macOS.md @@ -10,11 +10,11 @@ dateCreated: 2025-09-16T06:29:26.865Z # 1. 简介 -本指南描述如何使用 rkdeveloped tool\\\\` 工具刷入eMC。 它可以在 Linux 仓库中找到，也可以在 macOS 上运行。 它可以在 Linux 仓库中找到，也可以在 macOS 上运行。 它可以在 Linux 仓库中找到，也可以在 macOS 上运行。 它可以在 Linux 仓库中找到，也可以在 macOS 上运行。 +本指南描述如何使用 `rkdeveloptool` 工具刷写 eMMC。 它可以在 Linux 仓库中找到，也可以在 macOS 上运行。 它可以在 Linux 仓库中找到，也可以在 macOS 上运行。 -要安装BredOS，需要三件事： +要安装 BredOS，需要三件事： -1. SPL 加载文件，例如 RK3588: [[`rk3588_spl_loader_v1.15.113.bin`](https://dl.radxa.com/rock5/sw/images/loader/rk3588_spl_loader_v1.15.113.bin) +1. SPL 加载文件，例如 RK3588: [`rk3588_spl_loader_v1.15.113.bin`](https://dl.radxa.com/rock5/sw/images/loader/rk3588_spl_loader_v1.15.113.bin) ### Tabset {.tabset} @@ -28,32 +28,32 @@ dateCreated: 2025-09-16T06:29:26.865Z ### -2. 来自我们[官方网站]的设备特定图像(https://bredos.org/download.html) +2. 来自我们[官方网站](https://bredos.org/download.html)的设备特定镜像 3. `rkdevelopmenttool` -> 我们以压缩文件提供我们的图像。 我们以压缩文件提供我们的图像。 您需要在刷入之前提取包含.img的文件！ +> 我们以压缩文件提供我们的图像。 我们以压缩文件提供我们的镜像。 您需要在刷写之前提取包含 .img 的文件！ > {.is-warning} > {.is-warning} -# 3. 刷入 +# 3. 安装 rkdeveloptool -可以通过以下步骤安装 `rkdeveloptool` 。 +可以通过以下步骤安装 `rkdeveloptool`。 ## 2.1 Linux -- 如果您正在使用基于归档的分布 +- 如果您正在使用基于 Arch 的发行版 ``` sudo pacman -S rkdeveloptool ``` -- 如果您正在使用基于 Debian的分布 +- 如果您正在使用基于 Debian 的发行版 ``` sudo apt install rkdeveloped tools ``` -- 如果您正在使用红帽子分布 +- 如果您正在使用 Red Hat 发行版 ``` sudo dnf install rkdeveloped tools @@ -63,9 +63,9 @@ sudo dnf install rkdeveloped tools ### 2.2.1 前提条件 -由于没有用于 macOS 的 "rkdeveloped tool" 的二进制包，我们需要自己编译它。 为了做到这一点，我们需要通过 [Brew](https://brew.sh/)安装一些软件包。 为了做到这一点，我们需要通过 [Brew](https://brew.sh/)安装一些软件包。 为了做到这一点，我们需要通过 [Brew](https://brew.sh/)安装一些软件包。 为了做到这一点，我们需要通过 [Brew](https://brew.sh/)安装一些软件包。 +由于没有用于 macOS 的 `rkdeveloptool` 的二进制包，我们需要自己编译它。 为了做到这一点，我们需要通过 [Brew](https://brew.sh/) 安装一些软件包。 为了做到这一点，我们需要通过 [Brew](https://brew.sh/)安装一些软件包。 -- 安装`autocake`、`autocconf`、`libbus`、`pkg-config`、`git`和\`wget\`\\\\` ，具有以下命令： +- 使用以下命令安装 `automake`、`autoconf`、`libusb`、`pkg-config`、`git` 和 `wget`： ``` brew install automake autoconf libusb pkg-config git wget @@ -81,7 +81,7 @@ git clone https://github.com/rockchip-linux/rkdevelopmenttools ### 2.2.3 编译为二进制文件 -- 现在更改到包含源代码的目录并遵守它： +- 现在更改到包含源代码的目录并编译它： ``` cd rkdeveloptool @@ -90,7 +90,7 @@ autoreconf -i make -j $(nproc) ``` -- 在进程 `make` 完成后没有任何错误，在您当前的文件夹中有文件 `rkdevelopmenttool` ： +- 在 `make` 进程完成后没有任何错误，在您当前的文件夹中会有文件 `rkdeveloptool`： ``` ls | grep rkdeveloping 工具 @@ -102,19 +102,19 @@ ls | grep rkdeveloping 工具 rkdeveloped 工具 ``` -### 2.2.4 使其运行 +### 2.2.4 使其可运行 -- 最后复制它到`opt`文件夹，然后从任何地方运行它： +- 最后复制它到 `opt` 文件夹，然后从任何地方运行它： ``` cp rkdevelopmenttool/opt/homebrew/bin/ ``` -# 3. 刷入 +# 3. 刷写 -## 3.1 输入掩码 +## 3.1 进入 Maskrom 模式 -要使SBC 在USB上显示为易燃设备，它需要设置为 \\\\`maskrom 模式'。 这可以根据您正在使用的设备来实现。 有些SBC有一个按钮，另一些则需要您短短两个粉。 请参阅贵国制造商的文件。 这可以根据您正在使用的设备来实现。 有些SBC有一个按钮，另一些则需要您短短两个粉。 请参阅贵国制造商的文件。 这可以根据您正在使用的设备来实现。 有些SBC有一个按钮，另一些则需要您短短两个粉。 请参阅贵国制造商的文件。 这可以根据您正在使用的设备来实现。 有些SBC有一个按钮，另一些则需要您短短两个粉。 请参阅贵国制造商的文件。 +要使 SBC 在 USB 上显示为可刷写设备，它需要设置为 `maskrom 模式`。 这可以根据您正在使用的设备来实现。 有些 SBC 有一个按钮，另一些则需要您短接两个引脚。 请参阅您设备制造商的文档。 这可以根据您正在使用的设备来实现。 有些SBC有一个按钮，另一些则需要您短短两个粉。 请参阅贵国制造商的文件。 - 通过谷歌搜索可以轻松地找到此信息： @@ -122,19 +122,19 @@ cp rkdevelopmenttool/opt/homebrew/bin/ 遮罩模式 ``` -- 为了验证您的设备是否处于`maskrom mode`并且您的 PC 运行正确地发现了： +- 为了验证您的设备是否处于 `maskrom mode` 并且您的 PC 正确地发现了它： ``` sudo rkdeveloped toold ``` -- 如果你看到以下情况，你很好了 (输出相似，但不是相同): +- 如果您看到以下情况，就说明成功了（输出相似，但不完全相同）： ``` DevNo=1 Vid=0x2207, Pid=0x350b,LocationID=801 Maskrom ``` -> Maskrom 按钮应该在电源插入棋盘时按住 \*\*。 +> Maskrom 按钮应该在电源插入板子时按住。 > {.is-info} > {.is-info} @@ -144,17 +144,17 @@ DevNo=1 Vid=0x2207, Pid=0x350b,LocationID=801 Maskrom > {.is-warning} > {.is-warning} -## 3.2 FlashBredOS +## 3.2 刷写 BredOS -现在我们能够使用 "rkdeveloped tool" 发送命令到设备中，让我们使用 BredOS SBC 来制作。 +现在我们能够使用 `rkdeveloptool` 发送命令到设备中，让我们使用 BredOS 来刷写 SBC。 -- 向 SBC 发送SPI 加载文件： +- 向 SBC 发送 SPL 加载文件： ``` -sudo rkdeveloped tools db +sudo rkdeveloptool db ``` -- 然后将 BredOS 设备特定图像写入到 eMMC 中： +- 然后将 BredOS 设备特定镜像写入到 eMMC 中： ``` sudo rkdeveloped tools wl 0 @@ -166,40 +166,38 @@ sudo rkdeveloped tools wl 0 sudo rkdevelopmenttoold ``` -> 在刷入成功后，继续进行 [**First Setup**](/en/install/first-setup)。 -> {.is-success} -> {.is-success} +> 在刷写成功后，继续进行 [**首次设置**](/en/install/first-setup)。 > {.is-success} > {.is-success} # 🚀 4. 附加信息 -好吧，你只是想要更多进度条在你的生活中，对吗？ 我们已经覆盖了你，不要担心。 我们已经覆盖了你，不要担心。 +好吧，您只是想要更多进度条在您的生活中，对吗？ 我们已经为您准备好了，不要担心。 我们已经覆盖了你，不要担心。 -## 4.1 读取选定的闪光介质信息 +## 4.1 读取选定的闪存介质信息 -命令`sudo rkdeveloptools rfi`将向您显示所选闪光介质的详细信息。 +命令 `sudo rkdeveloptool rfi` 将向您显示所选闪存介质的详细信息。 - 默认情况下，这通常是 eMMC，除非它不可用。 ``` -闪光信息： - 制造商：SAMSUNG， value=00 +Flash Info： + Manufacturer: SAMSUNG, value=00 Flash Size: 14910 MB Flash Size: 30535680 Sectors Block Size: 512 KB - 页面大小: 2 KB + Page Size: 2 KB ECC Bits: 0 - 访问时间: 40 + Access Time: 40 Flash CS: Flash<0> ``` -## 4.2 改变闪光目标 +## 4.2 更改闪存目标 -想要刷入/转储不是eMC，而是一个不同的东西？ +想要刷写/转储不是 eMMC，而是其他存储设备？ -- `sudo rkdeveloped tools cs 2` 用于选择SD卡。 -- `sudo rkdeveloped tools cs 9` 用于选择SPINOR芯片。 -- `sudo rkdeveloped tools cs 1`再次选择 eMMC 。 +- `sudo rkdeveloptool cs 2` 用于选择 SD 卡。 +- `sudo rkdeveloptool cs 9` 用于选择 SPI NOR 芯片。 +- `sudo rkdeveloptool cs 1` 再次选择 eMMC。 -更改将反映在`sudo rkdeveloptool rfi`中。 \ No newline at end of file +更改将反映在 `sudo rkdeveloptool rfi` 中。 \ No newline at end of file diff --git a/zh/install/device-specific-image/Flashing-the-eMMC-with-Microsoft-Windows.md b/zh/install/device-specific-image/Flashing-the-eMMC-with-Microsoft-Windows.md index 17eeee33..ec914c3e 100644 --- a/zh/install/device-specific-image/Flashing-the-eMMC-with-Microsoft-Windows.md +++ b/zh/install/device-specific-image/Flashing-the-eMMC-with-Microsoft-Windows.md @@ -12,13 +12,11 @@ dateCreated: 2025-09-16T09:55:34.272Z 首先，我们很抱歉听到您必须使用Windows。 但恐惧不是——我们还是看到了你了。 -首先，我们很抱歉听到您必须使用Windows。 -但恐惧不是——我们还是看到了你了。 -首先，我们很抱歉听到您必须使用Windows。 -但恐惧不是——我们还是看到了你了。 -这篇文章引导您安装`RKDevTool` 和必要的`RockChip Maskrom drivers` 。 +首先，我们很抱歉听到您必须使用 Windows。 +但不要害怕——我们仍然会帮助您。 +这篇文章引导您安装 `RKDevTool` 和必要的 `RockChip Maskrom 驱动程序`。 -要安装BredOS，需要四件事： +要安装 BredOS，需要四件事： 1. SPL 加载器文件： @@ -34,42 +32,38 @@ dateCreated: 2025-09-16T09:55:34.272Z ### -2. 来自我们[官方网站]的设备特定图像(https://bredos.org/download.html) -3. [RockChip Maskrom drivers](https://dl.radxa.com/tools/windows/) +2. 来自我们[官方网站](https://bredos.org/download.html)的设备特定镜像 +3. [RockChip Maskrom 驱动程序](https://dl.radxa.com/tools/windows/) 4. [RKDevTool](https://docs.radxa.com/en/compute-module/cm5/radxa-os/low-level-dev/rkdevtool), [替代链接 1](https://dl.radxa.com/tools/windows/) -> 我们以压缩文件提供我们的图像。 我们以压缩文件提供我们的图像。 您需要在刷入之前提取包含.img的文件！ +> 我们以压缩文件提供我们的图像。 我们以压缩文件提供我们的镜像。 您需要在刷写之前提取包含 .img 的文件！ > {.is-warning} > {.is-warning} -# 2. 2. 驱动程序 +# 2. 安装驱动程序 -我们从安装 [Rockchip 驱动器] (https://dl.radxa.com/tools/windows/DriverAssitant_v5.0.zip )开始。 在你下载了那个.zip文件后，将其提取到你的预置位置。 -你会在其中找到工具`DriverInstall.exe`。 使用更高的权限执行它。 在你下载了那个.zip文件后，将其提取到你的预置位置。 -你会在其中找到工具`DriverInstall.exe`。 使用更高的权限执行它。 在你下载了那个.zip文件后，将其提取到你的预置位置。 -你会在其中找到工具`DriverInstall.exe`。 使用更高的权限执行它。 在你下载了那个.zip文件后，将其提取到你的预置位置。 +我们从安装 [Rockchip 驱动程序](https://dl.radxa.com/tools/windows/DriverAssitant_v5.0.zip)开始。 在您下载了那个 .zip 文件后，将其解压到您的首选位置。 +您会在其中找到工具 `DriverInstall.exe`。 使用管理员权限执行它。 在你下载了那个.zip文件后，将其提取到你的预置位置。 你会在其中找到工具`DriverInstall.exe`。 使用更高的权限执行它。 -> 如果您被问到：“您想要允许此应用更改您的设备吗？” ，点击“是”。 -> {.is-info} -> {.is-info} +> 如果您被问到："您想要允许此应用更改您的设备吗？"，点击"是"。 > {.is-info} > {.is-info} -接着，一个窗口将响亮。 点击“安装驱动程序”。 然后将在您的系统上安装驱动程序。 +接着，一个窗口将响亮。 点击“安装驱动程序”。 接着，一个窗口将弹出。 点击"安装驱动程序"。 然后驱动程序将在您的系统上安装。 -# 3. 使用 RKDevTool 闪烁BredOS +# 3. 使用 RKDevTool 刷写 BredOS -有了驱动程序，我们可以继续使用 [RKDevTool](https://docs.radxa.com/en/compute-module/cm5/radxa-os/low-level-dev/rkdevtool)。 解压缩.zip文件并执行 `RKDevTool.exe`。 解压缩.zip文件并执行 `RKDevTool.exe`。 解压缩.zip文件并执行 `RKDevTool.exe`。 解压缩.zip文件并执行 `RKDevTool.exe`。 +有了驱动程序，我们可以继续使用 [RKDevTool](https://docs.radxa.com/en/compute-module/cm5/radxa-os/low-level-dev/rkdevtool)。 解压缩 .zip 文件并执行 `RKDevTool.exe`。 解压缩.zip文件并执行 `RKDevTool.exe`。 -在 `RKDevTool` 中，设置了以下配置并点击`RUN`： +在 `RKDevTool` 中，设置以下配置并点击 `RUN`： -- 选择与您的 SoC 对应的 SPI 加载文件 -- 为您的 SBC 选择 BredOS 图像 (.img) +- 选择与您的 SoC 对应的 SPL 加载文件 +- 为您的 SBC 选择 BredOS 镜像 (.img) - 勾选 "Write by Address" - 点击 `RUN`，等待进程完成 -> Maskrom 按钮应该在电源插入棋盘时按住 \*\*。 +> Maskrom 按钮应该在电源插入板子时按住。 > {.is-info} > {.is-info} @@ -81,8 +75,6 @@ dateCreated: 2025-09-16T09:55:34.272Z 等待它完成刷入过程，你很好。 -> 在刷入成功后，继续进行 [**First Setup**](/en/install/first-setup)。 -> {.is-success} -> {.is-success} +> 在刷写成功后，继续进行 [**首次设置**](/en/install/first-setup)。 > {.is-success} > {.is-success} \ No newline at end of file diff --git a/zh/install/first-setup.md b/zh/install/first-setup.md index 712a9ea3..2a1f5784 100644 --- a/zh/install/first-setup.md +++ b/zh/install/first-setup.md @@ -10,59 +10,53 @@ dateCreated: 2025-04-09T20:05:01.867Z # 1. 简介 -欢迎来到Baker，它是混合物、 knead和只是你的 BredOS 最优质原料的地方， 随着面包，你将在整个过程中被引导，从挑选正确的面粉到最好的撞击技术到它需要增加的确切时间。 所以让我们开始吧！ 随着面包，你将在整个过程中被引导，从挑选正确的面粉到最好的撞击技术到它需要增加的确切时间。 所以让我们开始吧！ 随着面包，你将在整个过程中被引导，从挑选正确的面粉到最好的撞击技术到它需要增加的确切时间。 所以让我们开始吧！ 随着面包，你将在整个过程中被引导，从挑选正确的面粉到最好的撞击技术到它需要增加的确切时间。 所以让我们开始吧！ +欢迎来到Baker，它是混合、揉捏和烘焙您的 BredOS 最优质原料的地方。 随着面包的制作，您将在整个过程中被引导，从挑选正确的面粉到最好的揉捏技术到它需要发酵的确切时间。 所以让我们开始吧！ 随着面包，你将在整个过程中被引导，从挑选正确的面粉到最好的撞击技术到它需要增加的确切时间。 所以让我们开始吧！ # 2. 面包机 -## 2.1 Warm Welcome +## 2.1 热烈欢迎 -- 只要安装程序尚未完成，面包就会在启动时自动启动。 还有一个桌面快捷键来启动它而不重启。 要开始安装，请选择在线安装或离线安装。 还有一个桌面快捷键来启动它而不重启。 要开始安装，请选择在线安装或离线安装。 +- 只要安装程序尚未完成，面包机就会在启动时自动启动。 还有一个桌面快捷键来启动它而不需要重启。 要开始安装，请选择在线安装或离线安装。 还有一个桌面快捷键来启动它而不重启。 要开始安装，请选择在线安装或离线安装。 -> 正在构建在线安装。 请使用离线安装。 +> 在线安装正在构建中。 请使用离线安装。 > {.is-info} 请使用离线安装。 > {.is-info} ![1-scaled.png](/first-setup/1-scaled.png) -## 2.2 在世界各地都能享受祝福。 +## 2.2 在世界各地都能享受 Bred - 在我们开始旅程之前，我们需要就如何进行最佳沟通达成一致。 您所说的语言是什么？ 您使用什么时间格式？ 你熟悉的货币是什么？ ![2-scaled.png](/first-setup/2-scaled.png) -Look up your prefered language and click on it. 然后一个窗口将弹出您可以选择您的区域的位置。 时间和日期格式以及您的货币应自动填写。 请在继续之前检查它们，并随时根据您的偏好调整它们。 +查找您喜欢的语言并点击它。 然后一个窗口将弹出，您可以选择您的区域位置。 时间和日期格式以及您的货币应自动填写。 请在继续之前检查它们，并随时根据您的偏好调整它们。 然后一个窗口将弹出您可以选择您的区域的位置。 时间和日期格式以及您的货币应自动填写。 请在继续之前检查它们，并随时根据您的偏好调整它们。 -## 2.3 关于膝盖技术 +## 2.3 关于键盘布局 让我们谈谈膝盖。 每个人都是不同的，因此没有单一的“true”膝盖技术。 为了适应这个问题，你可以根据你的国家选择你的技术。 -让我们谈论敲打。 所有人都是不同的，因此没有“true”撞击技术器。 在我们的说明中，您可以根据您的国家选择您的技术。 ![6-scaled.png](/first-setup/6-scaled.png) -After you clicked on your country you can choose your layout. 名称表示“正常”是最常用的布局。 如果您不确定，请使用它。 如果您有一个不寻常的键盘，就像那些由 Apple 出售的键盘一样，选择相应的布局。 如果您不确定，请使用它。 如果您有一个不寻常的键盘，就像那些由 Apple 出售的键盘一样，选择相应的布局。 如果您不确定，请使用它。 名称表示“正常”是最常用的布局。 如果您不确定，请使用它。 如果您有一个不寻常的键盘，就像那些由 Apple 出售的键盘一样，选择相应的布局。 如果您不确定，请使用它。 如果您有一个不寻常的键盘，就像那些由 Apple 出售的键盘一样，选择相应的布局。 如果您不确定，请使用它。 名称表示“正常”是最常用的布局。 如果您不确定，请使用它。 如果您有一个不寻常的键盘，就像那些由 Apple 出售的键盘一样，选择相应的布局。 如果您不确定，请使用它。 如果您有一个不寻常的键盘，就像那些由 Apple 出售的键盘一样，选择相应的布局。 如果您不确定，请使用它。 如果您有一个不寻常的键盘，就像那些由 Apple 出售的键盘一样，选择相应的布局。 +在您点击您的国家后，您可以选择您的布局。 名称标示"正常"是最常用的布局。 如果您不确定，请使用它。 如果您有一个不寻常的键盘，就像那些由 Apple 出售的键盘一样，请选择相应的布局。 名称表示“正常”是最常用的布局。 如果您不确定，请使用它。 如果您有一个不寻常的键盘，就像那些由 Apple 出售的键盘一样，选择相应的布局。 如果您不确定，请使用它。 如果您有一个不寻常的键盘，就像那些由 Apple 出售的键盘一样，选择相应的布局。 如果您不确定，请使用它。 名称表示“正常”是最常用的布局。 如果您不确定，请使用它。 如果您有一个不寻常的键盘，就像那些由 Apple 出售的键盘一样，选择相应的布局。 如果您不确定，请使用它。 如果您有一个不寻常的键盘，就像那些由 Apple 出售的键盘一样，选择相应的布局。 如果您不确定，请使用它。 名称表示“正常”是最常用的布局。 如果您不确定，请使用它。 如果您有一个不寻常的键盘，就像那些由 Apple 出售的键盘一样，选择相应的布局。 如果您不确定，请使用它。 如果您有一个不寻常的键盘，就像那些由 Apple 出售的键盘一样，选择相应的布局。 如果您不确定，请使用它。 名称表示“正常”是最常用的布局。 如果您不确定，请使用它。 如果您有一个不寻常的键盘，就像那些由 Apple 出售的键盘一样，选择相应的布局。 如果您不确定，请使用它。 如果您有一个不寻常的键盘，就像那些由 Apple 出售的键盘一样，选择相应的布局。 如果您不确定，请使用它。 如果您有一个不寻常的键盘，就像那些由 Apple 出售的键盘一样，选择相应的布局。 > 使用文本栏测试您的布局。 当您必须输入密码时，这很重要！ > {.is-info} -## 2.4 上升的过程 +## 2.4 时区设置 - 在这里的Bakery，我们怀着爱情工作。 我们完全承认，布赖德需要时间才能成为我们大家都熟悉的可爱产品。 为此，我们需要知道您的时区。 -在这里的Bakery，我们怀着爱情工作。 我们完全承认，布赖德需要时间才能成为我们大家都熟悉的可爱产品。 为此，我们需要知道您的时区。 -在这里的Bakery，我们怀着爱情工作。 我们完全承认，布赖德需要时间才能成为我们大家都熟悉的可爱产品。 为此，我们需要知道您的时区。 ![9-scaled.png](/first-setup/9-scaled.png) -Select your Region and Zone using the dropdown menus. 您当前的时间应该在下方显示，以确保时间设置正确。 +使用下拉菜单选择您的地区和时区。 您当前的时间应该在下方显示，以确保时间设置正确。 您当前的时间应该在下方显示，以确保时间设置正确。 ## 2.5 当我们等待时，我们可以相互了解 - 既然我们的苦力已经被拳打脚踢，我们知道它还需要多长时间。 我们有一些时间能够更好地相互了解。 告诉我，你有什么名字？ 您是否有昵称？ 如果我要问的话，你会给你的骨牌什么名字？ -！[10-scaled.png](/first-setup/10-scaled.png) -请填写您的姓名、用户名和主机名。 主机名将用作您网络上的友好名称。 然后输入两次密码。 您可以使用眼睛图标显示或隐藏您的密码。 主机名将用作您网络上的友好名称。 然后输入两次密码。 您可以使用眼睛图标显示或隐藏您的密码。 主机名将用作您网络上的友好名称。 然后输入两次密码。 您可以使用眼睛图标显示或隐藏您的密码。 +![10-scaled.png](/first-setup/10-scaled.png) +请填写您的姓名、用户名和主机名。 主机名将用作您网络上的友好名称。 然后输入两次密码。 您可以使用眼睛图标显示或隐藏您的密码。 主机名将用作您网络上的友好名称。 然后输入两次密码。 您可以使用眼睛图标显示或隐藏您的密码。 -如果您想要禁用密码保护为 sudo 和 polkit, 请切换相应切换。 +如果您想要禁用 sudo 和 polkit 的密码保护，请切换相应开关。 -> 请注意，禁用密码保护允许在无密码的根级运行程序！ 此 \*\*can \*\* 是危险的 ！ -> {.is-danger} 此 \*\*can \*\* 是危险的 ！ -> {.is-danger} 此 \*\*can \*\* 是危险的 ！ -> {.is-danger} 此 \*\*can \*\* 是危险的 ！ +> 请注意，禁用密码保护允许在无密码的情况下以 root 权限运行程序！ 这**可能**是危险的！ > {.is-danger} 此 \*\*can \*\* 是危险的 ！ > {.is-danger} @@ -72,18 +66,18 @@ Select your Region and Zone using the dropdown menus. 您当前的时间应该 ## 2.6 卵子被加热(Summary) -- 既然坚韧不拔，疲劳很热，我们就停下来检查我们没有忘记任何东西。 幸运的是，贝克公司为我们自动创建了一个核对表。 +- 既然坚韧不拔，疲劳很热，我们就停下来检查我们没有忘记任何东西。 既然面团已经发好，温度很热，我们就停下来检查我们没有忘记任何东西。 幸运的是，Baker 为我们自动创建了一个核对清单。 -！[11-scaled.png](/first-setup/11-scaled.png) -请检查所有内容是否包含面粉、水、盐和青水。 膝盖是否做得适当？ 难道我们让艰难的崛起足够长的时间吗？ 如果一切都可以，请点击“安装”。 膝盖是否做得适当？ 难道我们让艰难的崛起足够长的时间吗？ 如果一切都可以，请点击“安装”。 +![11-scaled.png](/first-setup/11-scaled.png) +请检查所有内容是否正确：面粉、水、盐和酵母。 揉捏是否做得适当？ 我们让面团发酵足够长的时间了吗？ 如果一切都可以，请点击"安装"。 膝盖是否做得适当？ 难道我们让艰难的崛起足够长的时间吗？ 如果一切都可以，请点击“安装”。 -## 2.6 最好的气味莫过鲜蓝色的味道了 +## 2.7 最好的气味莫过于新鲜的 Bred - 现在抓取一杯咖啡或茶叶，然后一定时间拖入橄榄。 现在抓取一杯咖啡或茶叶，然后一定时间拖入橄榄。 思考你在面包里学到的东西，同时又有令人愉快的口味你的鼻子。 在你的Bred 完成面包时，享受这个等候时间热切期待。 在你的Bred 完成面包时，享受这个等候时间热切期待。 ![13-scaled.png](/first-setup/13-scaled.png) -## 2.7 享受你的红包 +## 2.8 享受您的 Bred - 不管你喜欢什么样的布赖特服务——平原，用奶酪和马马拉德服务， 一个慷慨的sriracha sauce,或带着一种新鲜的小鸡蛋。 我们知道，可以无数的方式享受红牌，我们热爱他们。 diff --git a/zh/internal-bred-stuff.md b/zh/internal-bred-stuff.md index 7a2d0a02..81eba84a 100644 --- a/zh/internal-bred-stuff.md +++ b/zh/internal-bred-stuff.md @@ -16,10 +16,11 @@ dateCreated: 2025-09-16T08:47:51.442Z Devs可以将注释添加到子文件夹中，后来可以由作者转换成wiki文章。 注可能包含文本或截图。 **dev 笔记没有设计语言要求。** 注可能包含文本或截图。 **dev 笔记没有设计语言要求。** 注可能包含文本或截图。 **dev 笔记没有设计语言要求。** 注可能包含文本或截图。 **dev 笔记没有设计语言要求。** -在每个子文件夹中，您也会找到我们的 wiki 文章 [设计语言](/en/internal-bred-stuff/design-language)。 如果你是一个新的作者，**你需要仔细阅读并严格关注它！** 如果你是一个新的作者，**你需要仔细阅读并严格关注它！** 如果你是一个新的作者，**你需要仔细阅读并严格关注它！** 如果你是一个新的作者，**你需要仔细阅读并严格关注它！** +在每个子文件夹中，您也会找到我们的 wiki 文章 [设计语言](/en/internal-bred-stuff/design-language)。 如果你是一个新的作者，**你需要仔细阅读并严格关注它！** 如果你是一个新的作者，**你需要仔细阅读并严格关注它！** 如果你是一个新的作者，**你需要仔细阅读并严格关注它！** 如果你是一个新的作者，**你需要仔细阅读并严格关注它！** 如果你是一个新的作者，**你需要仔细阅读并严格关注它！** > 总是显示尊重和热情，帮助BredOS成为人类已知的ARM和x86设备基于档案的最佳磁盘！ > {.is-success} > {.is-success} > {.is-success} > {.is-success} +> {.is-success} diff --git a/zh/internal-bred-stuff/design-language.md b/zh/internal-bred-stuff/design-language.md index 4dffa11d..400128ae 100644 --- a/zh/internal-bred-stuff/design-language.md +++ b/zh/internal-bred-stuff/design-language.md @@ -26,11 +26,11 @@ dateCreated: 2025-09-16T09:06:31.497Z # 3. 文本 -- 禁止使用表情符号。 唯一例外是 🔸 emoji。 唯一例外是 🔸 emoji。 禁止使用表情符号。 唯一例外是 🔸 emoji。 唯一例外是 🔸 emoji。 唯一例外是 🔸 emoji。 +- 禁止使用表情符号。 唯一例外是 🔸 emoji。 唯一例外是 🔸 emoji。 禁止使用表情符号。 唯一例外是 🔸 emoji。 唯一例外是 🔸 emoji。 禁止使用表情符号。 唯一例外是 🔸 emoji。 唯一例外是 🔸 emoji。 唯一例外是 🔸 emoji。 -- 文章不能超过一定长度。 文章不能超过一定长度。 如果你需要滚动很多, 请尝试将它的部分拆分成一个单独的指南。 文章不能超过一定长度。 如果你需要滚动很多, 请尝试将它的部分拆分成一个单独的指南。 文章不能超过一定长度。 如果你需要滚动很多, 请尝试将它的部分拆分成一个单独的指南。 +- 文章不能超过一定长度。 文章不能超过一定长度。 如果你需要滚动很多, 请尝试将它的部分拆分成一个单独的指南。 文章不能超过一定长度。 如果你需要滚动很多, 请尝试将它的部分拆分成一个单独的指南。 文章不能超过一定长度。 如果你需要滚动很多, 请尝试将它的部分拆分成一个单独的指南。 文章不能超过一定长度。 如果你需要滚动很多, 请尝试将它的部分拆分成一个单独的指南。 -- 文章不能包含重复内容。 文章不能包含重复内容。 如果文章已经存在，请链接到它！ 文章不能包含重复内容。 如果文章已经存在，请链接到它！ 文章不能包含重复内容。 如果文章已经存在，请链接到它！ +- 文章不能包含重复内容。 文章不能包含重复内容。 如果文章已经存在，请链接到它！ 文章不能包含重复内容。 如果文章已经存在，请链接到它！ 文章不能包含重复内容。 如果文章已经存在，请链接到它！ 文章不能包含重复内容。 如果文章已经存在，请链接到它！ - 如果你正在使用代码块，你必须在代码块上方解释它。 diff --git a/zh/internal-bred-stuff/landing-page.md b/zh/internal-bred-stuff/landing-page.md index 7d4f90b5..aeffa225 100644 --- a/zh/internal-bred-stuff/landing-page.md +++ b/zh/internal-bred-stuff/landing-page.md @@ -14,9 +14,12 @@ dateCreated: 2025-09-19T15：05：44.344Z 本文档将指导您完成 BredOS 的安装、配置和使用。 BredOS 是一个方便用户的基于档案的Linux发行版，专门为ARM和RISC-V设计的单个板电脑(SBC)。 文档将引导您安装、配置和使用 BredOS 。 欢迎来到 BredOS 文档！BredOS 是一个基于 Arch 的用户友好型 Linux 发行版，专门为基于 ARM 的单板计算机（SBC）设计。 本文档将指导您完成 BredOS 的安装、配置和使用。 BredOS 是一个方便用户的基于档案的Linux发行版，专门为ARM和RISC-V设计的单个板电脑(SBC)。 +文档将引导您安装、配置和使用 BredOS 。 欢迎来到 BredOS 文档！BredOS 是一个基于 Arch 的用户友好型 Linux 发行版，专门为基于 ARM 的单板计算机（SBC）设计。 +本文档将指导您完成 BredOS 的安装、配置和使用。 BredOS 是一个方便用户的基于档案的Linux发行版，专门为ARM和RISC-V设计的单个板电脑(SBC)。 文档将引导您安装、配置和使用 BredOS 。 BredOS 是一个方便用户的基于档案的Linux发行版，专门为ARM和RISC-V设计的单个板电脑(SBC)。 文档将引导您安装、配置和使用 BredOS 。 文档将引导您安装、配置和使用 BredOS 。 +文档将引导您安装、配置和使用 BredOS 。 ![](https://github.com/LinuxDroidMaster/Fydetab-Duo-DroidMaster-wiki/raw/main/Images/Linux/BredOS/preview.jpg) @@ -45,13 +48,13 @@ dateCreated: 2025-09-19T15：05：44.344Z # 4. 故障排除 -我们的朋友[**DroidMaster**](https://www.youtube.com/@LinuxDroidMaster) 制作了一个关于BredOS的YouTube视频。 在这里查看： 在这里查看： 在这里查看： 在这里查看： +我们的朋友[**DroidMaster**](https://www.youtube.com/@LinuxDroidMaster) 制作了一个关于BredOS的YouTube视频。 在这里查看： 在这里查看： 在这里查看： 在这里查看： 在这里查看： # 5. 安装 -为了便于您安装，我们为您铺设了一条线路，让您跟随。 🍞 🔸🔸🔸 🍞 🔸🔸🔸 🍞 🔸🔸🔸 🍞 🔸🔸🔸 +为了便于您安装，我们为您铺设了一条线路，让您跟随。 🍞 🔸🔸🔸 🍞 🔸🔸🔸 🍞 🔸🔸🔸 🍞 🔸🔸🔸 🍞 🔸🔸🔸 > 如果你发现面包裹破损：small_orange_diamond：在我们的社区频道上让我们头部跳过。 > {.is-info} @@ -89,7 +92,7 @@ BredOS 是一个开源项目，欢迎贡献！您可以通过以下方式做出 # 9. 贡献 -BredOS 是一个开源项目，欢迎贡献！您可以通过以下方式做出贡献： 您可以通过以下方式做出贡献： 您可以通过以下方式做出贡献： 您可以通过以下方式做出贡献： 您可以通过以下方式做出贡献： +BredOS 是一个开源项目，欢迎贡献！您可以通过以下方式做出贡献： 您可以通过以下方式做出贡献： 您可以通过以下方式做出贡献： 您可以通过以下方式做出贡献： 您可以通过以下方式做出贡献： 您可以通过以下方式做出贡献： - 报告错误和问题 - 提交补丁和改进 diff --git a/zh/internal-bred-stuff/testing.md b/zh/internal-bred-stuff/testing.md index 3c1ac0ce..0d0c2cf1 100644 --- a/zh/internal-bred-stuff/testing.md +++ b/zh/internal-bred-stuff/testing.md @@ -47,7 +47,7 @@ Toptier # 注释 -这里是一个脚注，[^1] 和另一个。\\\\[^长期注] +这里是一个脚注，[^1] 和另一个。\\\\\[^长期注] # 重生： diff --git a/zh/itx-3588j.md b/zh/itx-3588j.md index be599b66..d592e4f8 100644 --- a/zh/itx-3588j.md +++ b/zh/itx-3588j.md @@ -10,13 +10,14 @@ dateCreated: 2025-09-12T08：19：14.440Z # 1. 简介 -与其他RK3588SBC相比，Firefly ITX-3588J是一种不寻常的装置。 此页列出了一些文章提及它的查询以及如何修复或围绕它们工作。 此页列出了一些文章提及它的查询以及如何修复或围绕它们工作。 此页列出了一些文章提及它的查询以及如何修复或围绕它们工作。 此页列出了一些文章提及它的查询以及如何修复或围绕它们工作。 此页列出了一些文章提及它的查询以及如何修复或围绕它们工作。 +与其他RK3588SBC相比，Firefly ITX-3588J是一种不寻常的装置。 此页列出了一些文章提及它的查询以及如何修复或围绕它们工作。 此页列出了一些文章提及它的查询以及如何修复或围绕它们工作。 此页列出了一些文章提及它的查询以及如何修复或围绕它们工作。 此页列出了一些文章提及它的查询以及如何修复或围绕它们工作。 此页列出了一些文章提及它的查询以及如何修复或围绕它们工作。 此页列出了一些文章提及它的查询以及如何修复或围绕它们工作。 > 我们把它命名为“_Frisbee_”，因为它比计算更好！ > {.is-info} > {.is-info} > {.is-info} > {.is-info} +> {.is-info} # 2. 下载 diff --git a/zh/itx-3588j/sata-firmware-fix.md b/zh/itx-3588j/sata-firmware-fix.md index 588e7cd0..2b4f8b91 100644 --- a/zh/itx-3588j/sata-firmware-fix.md +++ b/zh/itx-3588j/sata-firmware-fix.md @@ -2,7 +2,7 @@ title: Sata固件修复 description: published: true -date: 2025-09-19T05:01:28.982Z +date: 2026-01-11T07:04:16198Z tags: editor: markdown dateCreated: 2025-09-12T09：18：06.486Z @@ -15,9 +15,11 @@ dateCreated: 2025-09-12T09：18：06.486Z - 新的固件文件 (从 [here](/wiki-itx3588j-pics/satafw/sata_adapter_en25f40.bin) 下载) - 已安装Linux的另一台设备 (window也应该正常工作，但不在这里覆盖) -这里可以订购一个非常便捷的包，包括烧录机、片段和其他有用的配件： -https://www.aliexpress.com/item/3226327388.html -[spi-flasher.png](/wiki-itx3588j-pics/spi-flasher.png) +这里可以订购一个非常便捷的包，包括烧录机、片段和其他有用的附件： + +| https://www.ali高速公路.com/item/32263275388.html | +| ------------------------------------------------------------------------------------------------------------- | +| ![spi-flasher.png](/wiki-itx3588j-pics/spi-flasher.png) | > 如果链接已过期，请随时在 Discord 或 Telegram 上给我们头部。 @@ -30,10 +32,9 @@ https://www.aliexpress.com/item/3226327388.html 另一方面，如果你有沉浸的经历，要去除和解析SPI芯片的八个粉丝并不是一个困难的任务。 -- SPI 芯片位于SATA 港口附近，紧靠mSATA 槽旁。 SPI 芯片位于SATA 港口附近，紧靠mSATA 槽旁。 SPI 芯片位于SATA 港口附近，紧靠mSATA 槽旁。 寻找标题为“JMB575”的方块芯片——这是SATA控制器。 接下来, 你会找到一个更小的 8 pin 芯片，标签为“W25X40CL”，也就是SPI 芯片。 SPI 芯片上的标签可能难以读取， 但一旦你找到了 SATA 控制器，它应该很容易识别SPI 芯片。 - ![sata-controller-text-scaled.jpg](/wiki-itx3588j-pics/sata-controller-text-scaled.jpg) 接下来, 你会找到一个更小的 8 pin 芯片，标签为“W25X40CL”，也就是SPI 芯片。 SPI 芯片上的标签可能难以读取， 但一旦你找到了 SATA 控制器，它应该很容易识别SPI 芯片。 - ![sata-controller-text-scaled.jpg](/wiki-itx3588j-pics/sata-controller-text-scaled.jpg) 接下来, 你会找到一个更小的 8 pin 芯片，标签为“W25X40CL”，也就是SPI 芯片。 SPI 芯片位于SATA 港口附近，紧靠mSATA 槽旁。 SPI 芯片位于SATA 港口附近，紧靠mSATA 槽旁。 寻找标题为“JMB575”的方块芯片——这是SATA控制器。 接下来, 你会找到一个更小的 8 pin 芯片，标签为“W25X40CL”，也就是SPI 芯片。 SPI 芯片上的标签可能难以读取， 但一旦你找到了 SATA 控制器，它应该很容易识别SPI 芯片。 - ![sata-controller-text-scaled.jpg](/wiki-itx3588j-pics/sata-controller-text-scaled.jpg) 接下来, 你会找到一个更小的 8 pin 芯片，标签为“W25X40CL”，也就是SPI 芯片。 SPI 芯片上的标签可能难以读取， 但一旦你找到了 SATA 控制器，它应该很容易识别SPI 芯片。 +- SPI 芯片位于SATA 港口附近，紧靠mSATA 槽旁。 SPI 芯片位于SATA 港口附近，紧靠mSATA 槽旁。 寻找标题为"JMB575"的方块芯片——这是SATA控制器。 接下来, 你会找到一个更小的 8 pin 芯片，标签为"W25X40CL"，也就是SPI 芯片。 SPI 芯片上的标签可能难以读取， 但一旦你找到了 SATA 控制器，它应该很容易识别SPI 芯片。 + ![sata-controller-text-scaled.jpg](/wiki-itx3588j-pics/sata-controller-text-scaled.jpg) 接下来, 你会找到一个更小的 8 pin 芯片，标签为“W25X40CL”，也就是SPI 芯片。 SPI 芯片位于SATA 港口附近，紧靠mSATA 槽旁。 寻找标题为"JMB575"的方块芯片——这是SATA控制器。 接下来, 你会找到一个更小的 8 pin 芯片，标签为"W25X40CL"，也就是SPI 芯片。 SPI 芯片上的标签可能难以读取， 但一旦你找到了 SATA 控制器，它应该很容易识别SPI 芯片。 + ![sata-controller-text-scaled.jpg](/wiki-itx3588j-pics/sata-controller-text-scaled.jpg)
SATA Controller and SPI Chip @@ -108,12 +109,9 @@ Pin 1在芯片上用一个小点标记，并在平面板或适配器板上贴上 - 如果它报告了上述SPI芯片的名字，你很乐意去做。 ``` -# sudo flashrom -p ch341a_spi --flash-name -flashrom 1.4.0-devel (git:v1.2-1355-g9ccbf1cf) 在 Linux 6.15.7-1-BredOS (x86_64) -flashrom 是免费的软件，获取源代码在 https://flashrom 上。 rg - -使用 clock_gettime 来处理延迟循环 (clk_id: 1, resolution 1ns). -在 ch341a_spi 上发现Winbonds flash chip "W25X40" (512 kB, SPI) +检查所有电缆并确保您的 ITX-3588J 板在使用片段时断电。 +然后连接到您的Linux设备并运行以下命令。 +如果它报告了上述SPI芯片的名字，你很乐意去做。 ``` ``` @@ -133,7 +131,7 @@ flashrom 是免费的软件，获取源代码在 https://flashrom 上。 rg 如果出现任何错误，您将能够使用这个备份恢复它。 如果出现任何错误，您将能够使用这个备份恢复它。 -- 用以下命令转储闪存： +- 用以下命令转_dump_闪存： ``` # sudo flashrom -p ch341a_spi -r firmware_dump-1.bin @@ -147,7 +145,7 @@ flashrom 是免费的软件，获取源代码在 https://flashrom 上。 rg # diff firmware_dump.bin firmware_dump-1.bin ``` -如果“diff”不产生输出, 你就好了。 +如果"diff"不产生输出, 你就好了。 如果确实如此，请检查素材的连接或检查您的焊接工作，并验证所有连接器的方向。 如果确实如此，请检查素材的连接或检查您的焊接工作，并验证所有连接器的方向。 diff --git a/zh/orange-pi-6-plus.md b/zh/orange-pi-6-plus.md new file mode 100644 index 00000000..b481419e --- /dev/null +++ b/zh/orange-pi-6-plus.md @@ -0,0 +1,76 @@ +--- +title: 橙色Pi 6 + +description: +published: true +date: 2026-02-24T09:17:00.321Z +tags: +editor: markdown +dateCreated: 2025-11-24T07：14：51.932Z +--- + +[![sponsor-gold-tier-opi.png](/sponsors/sponsor-gold-tier-opi.png){.align-center}](http://www.orangepi.org) + +# 2. 介绍信息 + +Orange Pi 6 Plus是一个ARM64板，具有很高的规格： + +- SoC：CIX CD8160 +- CPU： 4x A72 @ 2.6GHz + 4x A72 @ 2.4GHz + 4x A52 @ 1.8GHz +- GPU： 不稳定的 G720 MC10 +- NPU： 28.8 Tops +- 网络：2x 5Gbit 以太网 (PCIe 4.0 每个路由) + +PCIe 端口： + +- 2x M.2 M 键 (PCIe 4.0 4x 通道) +- 1x M.2 E 键 (PCIe 4.0 2x 通道) + +> 我们把它命名为“_阿片6plus_”或“_op6p_”。 +> {.is-info} + +# 3. 刷入 + +您可以在我们的 [Github 页面] (https://github.com/BredOS/bredos-iso/releases/latest )中找到无主文件的下载链接！ + +目前我们提供一个基于主线内核的图像。 此版本确实缺少驱动程序。 在主线上工作的概述和whats 找不到[4]。 主线支持](#h-4-mainline-support)。 + +# 4. 安装 rkdeveloptool + +阿片6plus支持来自通用ISO图像的安装，不像我们其他支持的单板计算机（SBCs），后者使用设备特定图像。 安装可以使用 USB 棍棒，甚至使用 USB 光学驱动器。 + +## 3.1 通用ISO 安装 + +通用.iso安装指南可用 [here](/en/install/Installation-with-ISO)。 + +# 5. PCIe + +| `linux` | 状态 | 注释 | +| ----------------------- | --- | ----------------------------------------------------------------------------------- | +| CPU | 工作 | | +| RAM | 工作 | | +| GPU | 断开 | 潜行者 | +| NPU | 断开 | 潜行者 | +| 硬件编码 | 断开 | 潜行者 | +| 硬件编码 | 断开 | 潜行者 | +| HDMI | 部分的 | EFI FB 局部工作 (1080P@60Hz 大部分监视器) / 4K 监视器在UEFI 期间不工作 | +| 潜行者 | 部分的 | 木头很好 | +| USB-C DP | 部分的 | UEFI时没有输出 | +| 存储 | 工作 | M.2 SSD按预期工作 | +| 以太网 | 工作 | | +| 后方USB | 工作 | | +| 前方USB | 工作 | | +| 后端音频 | 断开 | 潜行者 | +| 前置音频 | 断开 | 潜行者 | +| RTC | 工作 | 潜行者 | +| UART | 工作 | 开机时`ttyS2` | +| PCIe 稳定性 | 工作 | 见**5。 PCIe** | +| M.2M 键 | 工作 | | +| M.2 E 键 | 工作 | | +| 风扇控制 | 工作 | 自动粉丝控制，不能控制操作系统 | + +# 4. PCIe 稳定性 + +```某些测试者发现当设备使用 PCIe Gen. 4 速度连接时，系统变得不稳定。 如果你的棋盘不稳定，请考虑更新我们的 UEFI 固件并设置链接速度到 3.\~\~ +``` + +If you are experiencing issues with your PCIe devices, please refer to the [following article](/radxa-orion-o6/fix-pcie-issues). \ No newline at end of file diff --git a/zh/orangepi-5.md b/zh/orangepi-5.md index f31aee47..e72797ed 100644 --- a/zh/orangepi-5.md +++ b/zh/orangepi-5.md @@ -2,22 +2,24 @@ title: Orange Pi 5 系列 description: 此页面包含对 Orange Pi 5 系列设备有用指南/调整的链接 published: true -date: 2025-09-21T09:45:58.585Z +date: 2026-02-07T14:48:31.235Z tags: opi, opi-5 editor: markdown dateCreated: 2024-09-20T15:17:37.567Z --- +[![sponsor-gold-tier-opi.png](/sponsors/sponsor-gold-tier-opi.png){.align-center}](http://www.orangepi.org) + # 1. 支持的 Orange Pi 5 系列设备 | 设备 | UEFI | 支持状态 | 已知问题 | | ----------------- | ---- | ---- | ----------------------------------- | -| Orange Pi 5 | 否 | 否 | SATA M.2 SSD 可能无法工作 | -| Orange Pi 5B | 否 | 否 | 使用 OPI5 镜像，需要 DTBO 才能工作 | -| Orange Pi 5 Plus | 否 | 否 | | +| Orange Pi 5 | 设备 | 否 | SATA M.2 SSD 可能无法工作 | +| Orange Pi 5B | 设备 | 否 | 使用 OPI5 镜像，需要 DTBO 才能工作 | +| Orange Pi 5 Plus | 设备 | 否 | | | Orange Pi 5 Pro | 否 | 否 | | -| Orange Pi 5 Max | 否 | 否 | | -| Orange Pi 5 Ultra | 否 | 否 | | +| Orange Pi 5 Max | 设备 | 否 | | +| Orange Pi 5 Ultra | 设备 | 否 | | | Orange Pi CM5 | 否 | 否 | | > The Orange Pi 5, 5B and 5 Pro use RK3588S, while the 5 Plus and 5 Max use RK3588 (which have more PCIe and mipi lanes available) @@ -27,123 +29,114 @@ dateCreated: 2024-09-20T15:17:37.567Z #### Orange Pi 5 -> 我们把它命名为“_鸦片5_”，因为坦率地说，没有人有时间、耐心， 或者甚至是一丝希望不断地说出或打破可笑的长度， 不必要的是正式的，轻易令人烦恼的名字“Orange Pi 5”——特别是当每个人都确切知道你还有什么意思时。 -> {.is-info} -> {.is-info} +> 我们把它命名为"_鸦片5_"，因为坦率地说，没有人有时间、耐心， 或者甚至是一丝希望不断地说出或打字那可笑的长度， 不必要的正式、轻易令人烦恼的名字"Orange Pi 5"——特别是当每个人都确切知道你在说什么的时候。 > {.is-info} > {.is-info} 规格： -- SoC: Rockchip RK3588S, 8核心(4×CortexcrowA76 @ ~2.4GHz + 4×CorcortexA55 @ ~1.8GHz) +- SoC: Rockchip RK3588S, 8核心(4×Cortex-A76 @ ~2.4GHz + 4×Cortex-A55 @ ~1.8GHz) - RAM： LPDDR4/x, 4/8/16/32 GB -- 存储: microSD slot; M.2 NVMe through PCI; no eMMC socket 默认值(只是SPIcrossflash) -- 视频/显示: HDMI2.1 up to 8K@60Hz; USBcrossC DisplayPort; 双倍MIPI DhocPHY 输出; 多重输出/显示 +- 存储: microSD 插槽; M.2 NVMe 通过 PCIe; 无 eMMC 插槽（仅 SPI flash） +- 视频/显示: HDMI2.1 最高 8K@60Hz; USB-C DisplayPort; 双 MIPI D-PHY 输出; 多输出/显示 - 连接：Gigabit 以太网，可选的 WiFi/BT 通过 M.2 或模块，取决于版本；其他端口等。 -- 能量： 5V/4A -- 板大小 ~100 × 62 毫米. +- 电源： 5V/4A +- 板大小 ~100 × 62 毫米 #### Orange Pi 5B -> 我们把它命名为“_阿片5b_”，因为坦率地说，没有人有时间、耐心， 或者甚至是一丝希望不断地说出或打破可笑的长度， 不必要的是正式的，轻易令人烦恼的名字“橙色Pi 5B”——特别是当每个人都确切知道你还有什么意思时。 -> {.is-info} -> {.is-info} +> 我们把它命名为"_阿片5b_"，因为坦率地说，没有人有时间、耐心， 或者甚至是一丝希望不断地说出或打字那可笑的长度， 不必要的正式、轻易令人烦恼的名字"Orange Pi 5B"——特别是当每个人都确切知道你在说什么的时候。 > {.is-info} > {.is-info} 规格： -- SoC: Rockchip RK3588S, 8核心(4×CortexcrowA76 @ ~2.4GHz + 4×CorcortexA55 @ ~1.8GHz) +- SoC: Rockchip RK3588S, 8核心(4×Cortex-A76 @ ~2.4GHz + 4×Cortex-A55 @ ~1.8GHz) - RAM： LPDDR4/x, 4/8/16/32 GB -- 存储︰ 32GB eMMC 有许多变量；还有MicroSD；在某些模型中NVMe 没有M.2切割键槽？ -- 显示/视频： HDMI2.1 高达8K@60Hz; DisplayPort through USBcroc; MIPI lines等。 -- 连接：在WiFi6 + BT5.0 模块上；Gigabit 以太网等。 -- 能量： 5V/4A -- 板大小 ~100 × 62 毫米. +- 存储︰ 32GB eMMC 有多种选项；还有 MicroSD；某些型号中有 NVMe M.2 Key-M 插槽 +- 显示/视频： HDMI2.1 最高 8K@60Hz; DisplayPort 通过 USB-C; MIPI 接口等。 +- 连接：WiFi6 + BT5.0 模块；Gigabit 以太网等。 +- 电源： 5V/4A +- 板大小 ~100 × 62 毫米 #### Orange Pi 5 Plus -> 我们把它命名为“_阿片5加_”，因为坦率地说，没有人有时间、耐心， 或者甚至是一丝希望不断地说出或打破可笑的长度， 不必要的是正式的，轻易令人烦恼的名字“橙色Pi 5 Plus”——特别是当每个人都确切知道你还有什么意思时。 -> {.is-info} +> 我们把它命名为"_阿片5加_"，因为坦率地说，没有人有时间、耐心， 或者甚至是一丝希望不断地说出或打字那可笑的长度， 不必要的正式、轻易令人烦恼的名字"Orange Pi 5 Plus"——特别是当每个人都确切知道你在说什么的时候。 > {.is-info} > {.is-info} 规格： -- SoC：Rockchip RK3588 (noncrossS)，8colcore (4×CortescyA76 @ ~2.4GHz + 4×CortexcrotyA55 @ ~1.8GHz) +- SoC：Rockchip RK3588 (non-S)，8核心 (4×Cortex-A76 @ ~2.4GHz + 4×Cortex-A55 @ ~1.8GHz) - RAM： LPDDR4/x, 4/8/16/32 GB -- 存储：包括模块、 NVME 等。 -- 视频/显示：高分辨率、多的 HDMI / MIPI 等 -- 连接：2.5 Gbps 以太网(RTL8125BG)，WiFi6E + BT5.3/BLE；USB 3.0/2.0。 +- 存储：包括模块、NVMe 等。 +- 视频/显示：高分辨率、多个 HDMI / MIPI 等 +- 连接：2.5 Gbps 以太网(RTL8125BG)，WiFi6E + BT5.3/BLE；USB 3.0/2.0 #### Orange Pi 5 Pro -> 我们把它命名为“_阿片5pro_”，因为坦率地说，没有人有时间、耐心， 或者甚至是一丝希望不断地说出或打破可笑的长度， 不必要的是正式的，轻易令人烦恼的名字“橙色Pi 5 Pro”——特别是当每个人都确切知道你还有什么意思时。 -> {.is-info} -> {.is-info} +> 我们把它命名为"_阿片5pro_"，因为坦率地说，没有人有时间、耐心， 或者甚至是一丝希望不断地说出或打字那可笑的长度， 不必要的正式、轻易令人烦恼的名字"Orange Pi 5 Pro"——特别是当每个人都确切知道你在说什么的时候。 > {.is-info} > {.is-info} 规格： -- SoC：RK3588S (8nm)，8核心(4×CortexcrowA76 @ ~2.4GHz + 4×CorcortexA55 @ ~1.8GHz) -- RAM: LPDDR5, 选项4/8/16 GB -- 存储: MicroSD, eMMC 套接字或 SPI 烧录; M.2 Mcrotkey for NVMe/SATA 等。 -- 视频：双重HDMI (HDMI2.1 和 HDMI2.0)；最多支持 8K@60Hz；MIPI DSI 等。 -- 连接：Gigabit 以太网；WiFi5 + BT5.0；较小的棋盘(89×56 毫米) 超过普通的5/5B。 -- 电源和其他接口也发生了变化。 +- SoC：RK3588S (8nm)，8核心(4×Cortex-A76 @ ~2.4GHz + 4×Cortex-A55 @ ~1.8GHz) +- RAM: LPDDR5, 可选 4/8/16 GB +- 存储: MicroSD, eMMC 插槽或 SPI 烧录; M.2 Key-M 支持 NVMe/SATA 等。 +- 视频：双 HDMI (HDMI2.1 和 HDMI2.0)；最高支持 8K@60Hz；MIPI DSI 等。 +- 连接：Gigabit 以太网；WiFi5 + BT5.0；较小的板子(89×56 毫米) 相比普通的5/5B。 +- 电源和其他接口也有所变化。 #### Orange Pi 5 Max -> 我们把它命名为“_阿片5max_”，因为坦率地说，没有人有时间、耐心， 或者甚至是一丝希望不断地说出或打破可笑的长度， 不必要的是正式的，轻易令人烦恼的名字“Orange Pi 5 Max”——特别是当每个人都确切知道你还有什么意思时。 -> {.is-info} -> {.is-info} +> 我们把它命名为"_阿片5max_"，因为坦率地说，没有人有时间、耐心， 或者甚至是一丝希望不断地说出或打字那可笑的长度， 不必要的正式、轻易令人烦恼的名字"Orange Pi 5 Max"——特别是当每个人都确切知道你在说什么的时候。 > {.is-info} > {.is-info} 规格： -- SoC：Rockchip RK3588 (noncrossS)，8colcore (4×CortescyA76 @ ~2.4GHz + 4×CortexcrotyA55 @ ~1.8GHz) -- RAM: LPDDR5, 选项4/8/16 GB -- 存储：eMC套接口(32cymC256GB optional), microSD, M.2 NVMe 插槽。 -- 视频：2× HDMI2.1 到 8K@60Hz；MIPI DSI 等。 -- 连接：2.5 Gbps 以太网(RTL8125BG)，WiFi6E + BT5.3/BLE；USB 3.0/2.0。 -- 板大小 ~89×57 毫米。 +- SoC：Rockchip RK3588 (non-S)，8核心 (4×Cortex-A76 @ ~2.4GHz + 4×Cortex-A55 @ ~1.8GHz) +- RAM: LPDDR5, 可选 4/8/16 GB +- 存储：eMMC 插槽(32GB-256GB 可选), microSD, M.2 NVMe 插槽。 +- 视频：2× HDMI2.1 最高 8K@60Hz；MIPI DSI 等。 +- 连接：2.5 Gbps 以太网(RTL8125BG)，WiFi6E + BT5.3/BLE；USB 3.0/2.0 +- 板大小 ~89×57 毫米 + +> 当您想要通过 maskrom 模式刷入设备时，将 USB -A到 USB - A 电缆连接到顶部USB 3.0 (蓝色) 端口。 或者，， 你可以使用 USB-A到 USB-C 电缆，然后在 USB-C 末端将 USB-C 连接到 USB-C 适配器。 +> {.is-info} #### Orange Pi 5 Ultra -> 我们把它命名为“_阿片5超文本_”，因为坦率地说，没有人有时间、耐心， 或者甚至是一丝希望不断地说出或打破可笑的长度， 不必要的是正式的，轻易令人烦恼的名称“橙色Pi 5 Ultra”——特别是当每个人都确切知道你还有什么意思时。 -> {.is-info} -> {.is-info} +> 我们把它命名为"_阿片5超_"，因为坦率地说，没有人有时间、耐心， 或者甚至是一丝希望不断地说出或打字那可笑的长度， 不必要的正式、轻易令人烦恼的名称"Orange Pi 5 Ultra"——特别是当每个人都确切知道你在说什么的时候。 > {.is-info} > {.is-info} 规格： -- SoC：Rockchip RK3588 (noncrossS)，8colcore (4×CortescyA76 @ ~2.4GHz + 4×CortexcrotyA55 @ ~1.8GHz) -- RAM: LPDDR5, 选项4/8/16 GB -- 存储：eMC套接口(32cymC256GB optional), microSD, M.2 NVMe 插槽。 -- 视频：2× HDMI2.1 到 8K@60Hz；MIPI DSI 等。 -- 连接：2.5 Gbps 以太网(RTL8125BG)，WiFi6E + BT5.3/BLE；USB 3.0/2.0。 -- 板大小 ~89×57 毫米。 +- SoC：Rockchip RK3588 (non-S)，8核心 (4×Cortex-A76 @ ~2.4GHz + 4×Cortex-A55 @ ~1.8GHz) +- RAM: LPDDR5, 可选 4/8/16 GB +- 存储：eMMC 插槽(32GB-256GB 可选), microSD, M.2 NVMe 插槽。 +- 视频：2× HDMI2.1 最高 8K@60Hz；MIPI DSI 等。 +- 连接：2.5 Gbps 以太网(RTL8125BG)，WiFi6E + BT5.3/BLE；USB 3.0/2.0 +- 板大小 ~89×57 毫米 #### Orange Pi CM5 -> 我们把它命名为“_opicm5_”，因为它更短。 -> {.is-info} -> {.is-info} +> 我们把它命名为"_opicm5_"，因为它更短。 > {.is-info} > {.is-info} 规格： - SoC：RK3588S (8nm) -- RAM： LPDDR4/4x, 选项： 2/4/8/16 GB -- 存储：eMMC在板上（最多256GB），微SD，可在基础/载体板上通过M.2KeycrotM等方式扩展；根据接口支持SATA或PCIe。 -- 视频：HDMI2.1 或 eDP, MIPI DSI TX，等等；8K 视频支持；多个相机接口。 +- RAM： LPDDR4/4x, 可选： 2/4/8/16 GB +- 存储：板载 eMMC（最多256GB），microSD，可在基板/载板上通过 M.2 Key-M 等方式扩展；根据接口支持 SATA 或 PCIe。 +- 视频：HDMI2.1 或 eDP, MIPI DSI TX 等；8K 视频支持；多个相机接口。 - 连接：WiFi5 + BT5 (AP6256模块)、USB 端口等。 -- 物理：模块表单因子；需要基础板或载体；大小 ~40x55 mm 模块。 +- 物理：模块外形；需要基板或载板；模块大小 ~40x55 mm # 2. 下载 -您可以在我们的 [Github](https://github.com/BredOS/images/releases/latest) 中找到镜像的下载链接 \ No newline at end of file +您可以在我们的 [Github](https://github.com/BredOS/images/releases/latest) 中找到镜像的下载链接 + diff --git a/zh/orangepi-rv.md b/zh/orangepi-rv.md index 2989f114..c5d07d2f 100644 --- a/zh/orangepi-rv.md +++ b/zh/orangepi-rv.md @@ -2,12 +2,14 @@ title: 橙色Pi RV系列 description: 此页面包含用于OPI RV 系列设备的有用指南/调整的链接 published: true -date: 2025-09-13T09:09:59.140Z +date: 2025-12-22T07:23:31.608Z tags: risc-v editor: markdown dateCreated: 2025-06-21T08:33:57.285Z --- +[![sponsor-gold-tier-opi.png](/sponsors/sponsor-gold-tier-opi.png){.align-center}](http://www.orangepi.org) + # 1. 支持的 Orange Pi RV 系列设备 | 设备 | 支持的 | 已知问题 | @@ -18,4 +20,4 @@ dateCreated: 2025-06-21T08:33:57.285Z # 2. 下载 -您可以在我们的 [website](https://bredos.org/download.html) 中找到图像的下载链接！ \ No newline at end of file +您可以在我们的 [网站](https://bredos.org/download.html) 中找到图像的下载链接！ \ No newline at end of file diff --git a/zh/radxa-orion-o6.md b/zh/radxa-orion-o6.md index 2467f090..b00bc566 100644 --- a/zh/radxa-orion-o6.md +++ b/zh/radxa-orion-o6.md @@ -2,7 +2,7 @@ title: Radxa Orion O6 description: published: true -date: 2025-09-20T10：28：27.806Z +date: 2025-12-15T10：04：20.782Z tags: editor: markdown dateCreated: 2025-09-17T06:04:34.142Z @@ -10,25 +10,7 @@ dateCreated: 2025-09-17T06:04:34.142Z # 1. 简介 -Radxa Orion O6是一个小型ITX母板，由Cix P1(CD8180)SOC驱动，它拥有一个 12colcore ARM v9。 CPU 拥有4个大CortexcutA720核心(~2.8GHz)，4个中等A720s (~2.4GHz)，4个小CortexhopA520s (~1.8GHz)。 它包括一个军火不稳定G720 GPU和一个用于大赦国际推断的30个TOPS NPU。 拥有多达64GB LPDDR5，多个显示输出结果，双倍5GbE 网络和PCIe Gen 4扩展， 它针对edge AI, multimedia和开发者工作站应用程序。 - -- SoC：CIX CD8180 -- CPU： 4x A72 @ 2.6GHz + 4x A72 @ 2.4GHz + 4x A52 @ 1.8GHz -- GPU： 不稳定的 G720 MC10 -- NPU： 30 TOPs -- 网络：2x 5Gbit 以太网 (PCIe 4.0 每个路由) - -PCIe 端口： - -- M.2 M 密钥 (PCIe 4.0 4x 通道) -- M.2 E key (PCIe 4.0 2.x 通道) -- 全尺寸的 PCIe x16 槽(PCIe 4.0 8x 长道) - -> 我们因为Pandas打字技能而把它命名为“_普里昂_”。 -> {.is-info} -> {.is-info} -> {.is-info} -> {.is-info} +Orion O6家庭是Radxa根据Cix P1 CD8180 SoC制作的一系列董事会。 这个家庭的板块支持通过 UEFI 启动，让用户能够启动支持ACPI 的任何内核。 # 2. 下载 @@ -37,47 +19,12 @@ PCIe 端口： 我们有两个版本：一个基于Radxa的6.6内核，另一个基于主线。 基于6.6内核的版本包含"ORION"的名称，支持该棋盘的完整功能。 主行内核确实缺少驱动程序。 在主线上工作的概述和whats无法在第4节下找到。 Mainline support\\\\`. -基于6.6内核的版本包含"ORION"的名称，支持该棋盘的完整功能。 -主行内核确实缺少驱动程序。 在主线上工作的概述和whats 找不到[4]。 主线支持](#h-4-mainline-support)。 - -# 3. 安装 - -Prion支持使用通用的 ISO 图像进行安装，不像我们其他支持的单板计算机（SBCs），后者使用设备特定图像。 安装可以使用 USB 棍棒，甚至使用 USB 光学驱动器。 安装可以使用 USB 棍棒，甚至使用 USB 光学驱动器。 安装可以使用 USB 棍棒，甚至使用 USB 光学驱动器。 安装可以使用 USB 棍棒，甚至使用 USB 光学驱动器。 - -## 3.1 通用ISO 安装 - -通用.iso安装指南可用 [here](/en/install/Installation-with-ISO)。 - -## 3.2 UEFI 安装 - -我们已经根据Radxa's source 代码开发了一个自定义 UEFI。 它支持出售棋盘的实际CPU速度， 允许控制 PCIe 链接速度，并且——最好的 - 启动时显示 Bred 徽标。 更新您的 UEFI 的完整功能列表和指南是可用的 [here](/radxa-orion-o6/prion-uefi-installation)。 它支持出售棋盘的实际CPU速度， 允许控制 PCIe 链接速度，并且——最好的 - 启动时显示 Bred 徽标。 更新您的 UEFI 的完整功能列表和指南是可用的 [here](/radxa-orion-o6/prion-uefi-installation)。 -# 4. PCIe +# 3. 支持的看板 -| `linux` | 状态 | 注意 | -| ----------------------- | --- | ----------------------------------------------------------------------------------------------------------------------------- | -| CPU | 工作 | | -| RAM | 工作 | | -| GPU | 断开 | 没有驱动程序 | -| NPU | 断开 | 没有驱动程序 | -| 硬件编码 | 断开 | 没有驱动程序 | -| 硬件编码 | 断开 | 没有驱动程序 | -| HDMI | 部分的 | EFI FB 局部工作 (1080P@60Hz 大部分显示器) | -| 潜行者 | 部分的 | 与上面相同 | -| USB-C DP | 部分的 | 与上面相同 | -| 存储 | 工作 | M.2 SSD按预期工作 | -| 以太网 | 工作 | | -| 后方USB | 工作 | 随机死亡, 需要自定义的 BredOS 派生Radxa bios | -| 前方USB | 工作 | 随机死亡数 | -| 后端音频 | 断开 | 没有驱动程序 | -| 前置音频 | 断开 | 没有驱动程序 | -| RTC | 工作 | 没有驱动程序 | -| UART | 工作 | 开机时`ttyS2` | -| PCIe | 部分的 | 适合大多数设备，但某些GPU无法正常工作。
有时冻结整个系统。 考虑使用我们的偏差。
有时冻结整个系统。 考虑使用我们的偏差。
有时冻结整个系统。 考虑使用我们的偏差。
有时冻结整个系统。 考虑使用我们的偏差。 | -| M.2M 键 | 工作 | | -| M.2 E 键 | 工作 | | -| 风扇控制 | 工作 | 自动粉丝控制，不能控制操作系统 | +| `名称` | 状态 | 注意 | +| ----------------------------------------------- | -- | -------------- | +| [Radxa Orion O6](/radxa-orion-o6/prion) | 工作 | 邮件内核没有GPU驱动程序。 | +| [Radxa O6N](/en/radxa-orion-o6/fun-sized-prion) | 工作 | 邮件内核没有GPU驱动程序。 | -# 5. PCIe -一些测试者发现，当使用PCIe Gen4速度运行的设备连接时，该系统变得不稳定。 一些测试者发现，当使用PCIe Gen4速度运行的设备连接时，该系统变得不稳定。 如果你的棋盘不稳定，请考虑更新到我们的 UEFI 固件并设置链接速度到 3 基因。 一些测试者发现，当使用PCIe Gen4速度运行的设备连接时，该系统变得不稳定。 如果你的棋盘不稳定，请考虑更新到我们的 UEFI 固件并设置链接速度到 3 基因。 一些测试者发现，当使用PCIe Gen4速度运行的设备连接时，该系统变得不稳定。 如果你的棋盘不稳定，请考虑更新到我们的 UEFI 固件并设置链接速度到 3 基因。 \ No newline at end of file diff --git a/zh/radxa-orion-o6/fix-pcie-issues.md b/zh/radxa-orion-o6/fix-pcie-issues.md new file mode 100644 index 00000000..0ed1a50e --- /dev/null +++ b/zh/radxa-orion-o6/fix-pcie-issues.md @@ -0,0 +1,32 @@ +--- +title: 在 Cix P1 SoC 修复PCI问题 +description: +published: true +date: 2026-03-02T08:44.476Z +tags: +editor: markdown +dateCreated: 2026-02-24T09:13:38.317Z +--- + +# 2. 上岗培训 + +不同制造商发布的 Cix P1 81x0 SOC固件在SMMU v3 事件队列中有一个错误， 造成一场打断风暴，表现为各种问题。 这些功能从缺失的功能到崩溃应用程序/桌面和内核恐慌。 [GitHub 上的Eric Dedeoglu对此错误进行了深入分析并找到了一个解决方案](https://github.com/ErcinDedeoglu/orangepi-6plus-cix-sky1-smmu-fix)。 如果您想了解更多信息，我们强烈建议阅读他的文章。 + +# 1. 修复 + +虽然Eric 在他的GitHub 上提供一个安装脚本，但它只适用于基于 Debian的系统。 因为Bred 基于 ArchLinuxARM ，我们打包了所需的文件以方便您。 + +- 安装 `smmu-evtq-fix` + +``` +sudo pacman -Syu smmu-evtq-fix +``` + +> 就是这样。 无需重启(除非您已经将您的 PCIe 速度限制为 3 级固件)。 在这种情况下，您需要重新启动您的机器并恢复此设置)。 +> 快乐游戏！ +> {.is-success} +> {.is-success} + +# 🔁 3. 致谢 + +没有Eric的分析，这个错误本来不会被修复。 非常感谢您的出色工作！ \ No newline at end of file diff --git a/zh/radxa-orion-o6/fun-sized-prion.md b/zh/radxa-orion-o6/fun-sized-prion.md new file mode 100644 index 00000000..312fa6dc --- /dev/null +++ b/zh/radxa-orion-o6/fun-sized-prion.md @@ -0,0 +1,74 @@ +--- +title: Radxa Orion O6N +description: +published: true +date: 2026-02-24T09:16:02.794Z +tags: +editor: markdown +dateCreated: 2025-12-15T09：55：40.646Z +--- + +# 2. 介绍信息 + +Orion O6是一个Nano ITX格式的ARM64牌，具有很高的规格： + +- SoC：CIX CD8180 +- CPU： 4x A72 @ 2.6GHz + 4x A72 @ 2.4GHz + 4x A52 @ 1.8GHz +- GPU： 不稳定的 G720 MC10 +- NPU： 30 TOPs +- 网络：2x 2.5Gbit 以太网 (每条PCIe 4.0 1.x 通道) + +PCIe 端口： + +- 2x M.2 M 键 (PCIe 4.0 4x 通道) +- M.2 E key (PCIe 4.0 2.x 通道) +- M.2 B key (PCIe 4.0 2.x 通道) + +> 我们把它命名为“\*有趣的狮子”，因为它像的 [Prion](/en/radxa-orion-o6/prion)，但很有趣。 +> {.is-info} + +# 3. 刷入 + +您可以在我们的 [Github 页面] (https://github.com/BredOS/bredos-iso/releases/latest )中找到无主文件的下载链接！ + +# 4. 安装 rkdeveloptool + +有趣的 Prion 支持使用通用的 ISO 图像进行安装，不像我们所支持的使用设备特定图像的单板计算机(SBC)。 安装可以使用 USB 棍棒，甚至使用 USB 光学驱动器。 + +## 3.1 通用ISO 安装 + +通用.iso安装指南可用 [here](/en/install/Installation-with-ISO)。 + +# 5. PCIe + +| `linux` | 状态 | 注释 | +| --------------------------------------------------- | --- | --------------------------------------------------------------- | +| CPU | 工作 | | +| RAM | 工作 | | +| GPU | 断开 | 潜行者 | +| NPU | 断开 | 潜行者 | +| 硬件编码 | 断开 | 潜行者 | +| 硬件编码 | 断开 | 潜行者 | +| HDMI | 部分的 | EFI FB 局部工作 (1080P@60Hz 大部分显示器) | +| 潜行者 | 部分的 | 与上面相同 | +| USB-C DP | 部分的 | 与上面相同 | +| 存储 | 工作 | M.2 SSD按预期工作 | +| 以太网 | 工作 | | +| 后方USB | 工作 | 随机死亡, 需要自定义的 BredOS 派生Radxa bios | +| 前方USB | 工作 | 随机死亡数 | +| 后端音频 | 断开 | 潜行者 | +| 前置音频 | 断开 | 潜行者 | +| RTC | 工作 | 潜行者 | +| UART | 工作 | 开机时`ttyS2` | +| PCIe (任何 M.2 端口) | 部分的 | 对大多数设备都很好，但是某些GPU不能按预期运行，并且有时冻结整个系统。 见**5。 PCIe** | +| M.2M 键 | 工作 | | +| M.2 E 键 | 工作 | | +| M.2 B 键 | 工作 | | +| 风扇控制 | 工作 | 自动粉丝控制，不能控制操作系统 | + +# 🔄 3. PCIe 稳定性 + +```某些测试者发现当设备使用 PCIe Gen. 4 速度连接时，系统变得不稳定。 如果你的棋盘不稳定，请考虑设置链接速度到3\~\~ +``` + +If you are experiencing issues with your PCIe devices, please refer to the [following article](/radxa-orion-o6/fix-pcie-issues). \ No newline at end of file diff --git a/zh/radxa-orion-o6/prion-uefi-installation.md b/zh/radxa-orion-o6/prion-uefi-installation.md index d1383c7d..fefaaf6a 100644 --- a/zh/radxa-orion-o6/prion-uefi-installation.md +++ b/zh/radxa-orion-o6/prion-uefi-installation.md @@ -2,7 +2,7 @@ title: 更新Orion O6上的 UEFI description: published: true -date: 2025-10-30T12：49：48.767Z +date: 2025-10-30T06:06:17.716Z tags: editor: markdown dateCreated: 2025-09-17T06:45:47.183Z @@ -28,7 +28,7 @@ dateCreated: 2025-09-17T06:45:47.183Z ## 3.1 前提条件 -- `UEFI`安装.zip 文件找到 [here](/orion/bios.zip)。 +- `UEFI`安装.zip文件在这里找到。 - 对于一个 "3.2 现场更新" -> FAT32 格式化 USB Stick。 - 对于`3.3 通过 flasher` -> 基于 CH341A的刷新器 @@ -65,6 +65,7 @@ VariableInfo.efi > {.is-warning} > {.is-warning} > {.is-warning} +> {.is-warning} ## 3.3 通过粉丝更新 @@ -108,6 +109,7 @@ dd if=/dev/n0 bs=1 count=$(8388608- )) >> ./cix_flash_all.b > {.is-warning} > {.is-warning} > {.is-warning} +> {.is-warning} Prion上的 SPI 芯片被套接以便轻松移除。 套接字位于CPU粉丝头和 GPIO 端口。 套接字位于CPU粉丝头和 GPIO 端口。 要轻松定位芯片，请参阅Radxa [在这里找到](https://radxa.com/orion/o6/marked_orion_o6.webp)的文档。 diff --git a/zh/radxa-orion-o6/prion.md b/zh/radxa-orion-o6/prion.md new file mode 100644 index 00000000..1dfdfd77 --- /dev/null +++ b/zh/radxa-orion-o6/prion.md @@ -0,0 +1,87 @@ +--- +title: Radxa Orion O6 +description: +published: true +date: 2026-02-24T10：18：09.554Z +tags: +editor: markdown +dateCreated: 2025-12-15T09:50:47.997Z +--- + +# 2. 介绍信息 + +Orion O6是一个 Mini ITX-formed ARM64 型号的特色： + +- SoC：CIX CD8180 +- CPU： 4x A72 @ 2.6GHz + 4x A72 @ 2.4GHz + 4x A52 @ 1.8GHz +- GPU： 不稳定的 G720 MC10 +- NPU： 30 TOPs +- 网络：2x 5Gbit 以太网 (PCIe 4.0 每个路由) + +PCIe 端口： + +- M.2 M 密钥 (PCIe 4.0 4x 通道) +- M.2 E key (PCIe 4.0 2.x 通道) +- 全尺寸的 PCIe x16 槽(PCIe 4.0 8x 长道) + +> 我们因为Pandas打字技能而把它命名为“_普里昂_”。 +> {.is-info} +> {.is-info} +> {.is-info} +> {.is-info} +> {.is-info} + +# 3. 刷入 + +您可以在我们的 [Github 页面] (https://github.com/BredOS/bredos-iso/releases/latest )中找到无主文件的下载链接！ + +我们有两个版本：一个基于Radxa的6.6内核，另一个基于主线。 +基于6.6内核的版本包含"ORION"的名称，支持该棋盘的完整功能。 +主行内核确实缺少驱动程序。 在主线上工作的概述和whats无法在第4节下找到。 Mainline support\\\\`. +基于6.6内核的版本包含"ORION"的名称，支持该棋盘的完整功能。 +主行内核确实缺少驱动程序。 在主线上工作的概述和whats 找不到[4]。 主线支持](#h-4-mainline-support)。 + +# 4. 安装 rkdeveloptool + +Prion支持使用通用的 ISO 图像进行安装，不像我们其他支持的单板计算机（SBCs），后者使用设备特定图像。 安装可以使用 USB 棍棒，甚至使用 USB 光学驱动器。 安装可以使用 USB 棍棒，甚至使用 USB 光学驱动器。 安装可以使用 USB 棍棒，甚至使用 USB 光学驱动器。 安装可以使用 USB 棍棒，甚至使用 USB 光学驱动器。 安装可以使用 USB 棍棒，甚至使用 USB 光学驱动器。 + +## 3.1 通用ISO 安装 + +通用.iso安装指南可用 [here](/en/install/Installation-with-ISO)。 + +## 3.2 UEFI 安装 + +我们已经根据Radxa's source 代码开发了一个自定义 UEFI。 它支持出售棋盘的实际CPU速度， 允许控制 PCIe 链接速度，并且——最好的 - 启动时显示 Bred 徽标。 更新您的 UEFI 的完整功能列表和指南是可用的 [here](/radxa-orion-o6/prion-uefi-installation)。 它支持出售棋盘的实际CPU速度， 允许控制 PCIe 链接速度，并且——最好的 - 启动时显示 Bred 徽标。 更新您的 UEFI 的完整功能列表和指南是可用的 [here](/radxa-orion-o6/prion-uefi-installation)。 + +# 5. PCIe + +| `linux` | 状态 | 注释 | +| ----------------------- | --- | --------------------------------------------------------------- | +| CPU | 工作 | | +| RAM | 工作 | | +| GPU | 断开 | 潜行者 | +| NPU | 断开 | 潜行者 | +| 硬件编码 | 断开 | 潜行者 | +| 硬件编码 | 断开 | 潜行者 | +| HDMI | 部分的 | EFI FB 局部工作 (1080P@60Hz 大部分显示器) | +| 潜行者 | 部分的 | 与上面相同 | +| USB-C DP | 部分的 | 与上面相同 | +| 存储 | 工作 | M.2 SSD按预期工作 | +| 以太网 | 工作 | | +| 后方USB | 工作 | 随机死亡, 需要自定义的 BredOS 派生Radxa bios | +| 前方USB | 工作 | 随机死亡数 | +| 后端音频 | 断开 | 潜行者 | +| 前置音频 | 断开 | 潜行者 | +| RTC | 工作 | 潜行者 | +| UART | 工作 | 开机时`ttyS2` | +| PCIe 稳定性 | 部分的 | 查看**5。 PCIe** | +| M.2M 键 | 工作 | | +| M.2 E 键 | 工作 | | +| 风扇控制 | 工作 | 自动粉丝控制，不能控制操作系统 | + +# 4. PCIe 稳定性 + +```某些测试者发现当设备使用 PCIe Gen. 4 速度连接时，系统变得不稳定。 如果你的棋盘不稳定，请考虑更新我们的 UEFI 固件并设置链接速度到 3.\~\~ +``` + +If you are experiencing issues with your PCIe devices, please refer to the [following article](/radxa-orion-o6/fix-pcie-issues). \ No newline at end of file diff --git a/zh/rock-5.md b/zh/rock-5.md index 1e9537d7..0da83aad 100644 --- a/zh/rock-5.md +++ b/zh/rock-5.md @@ -2,7 +2,7 @@ title: Rock 5 系列 description: published: true -date: 2025-09-17T09:37:33.486Z +date: 2026-01-01T10:35:20.365Z tags: editor: markdown dateCreated: 2024-09-21T09:12:56.606Z @@ -18,9 +18,10 @@ dateCreated: 2024-09-21T09:12:56.606Z | Rock 5C | 否 | 否 | Wi-Fi 驱动程序数天后会崩溃 | | Rock 5C Lite | 否 | 否 | Wi-Fi 驱动程序数天后会崩溃 | | Rock 5D | 否 | 否 | Wi-Fi 驱动程序数天后会崩溃 | +| 5T 摇动 | 否 | 否 | | | Rock 5 ITX | 否 | 否 | | | CM5 | 否 | 否 | | -| CM5 Lite | 否 | 否 | | +| CM5 Lite | 指南 | 设备 | | ### Tabset {.tabset} @@ -31,6 +32,7 @@ dateCreated: 2024-09-21T09:12:56.606Z > {.is-info} > {.is-info} > {.is-info} +> {.is-info} #### Rock 5C @@ -39,14 +41,11 @@ dateCreated: 2024-09-21T09:12:56.606Z > {.is-info} > {.is-info} > {.is-info} +> {.is-info} # 2. 下载 您可以在我们的 [website](https://bredos.org/download.html) 中找到图像的下载链接！ -# 3. 有用的链接 - -## 3.1 关于Rock 5B 和 Rock 5B Plus -- [如何从 NVMe 启动 BredOS](/rock-5/how-to-boot-from-nvme) diff --git a/zh/table-of-supported-devices.md b/zh/table-of-supported-devices.md index 9698905d..446f05ef 100644 --- a/zh/table-of-supported-devices.md +++ b/zh/table-of-supported-devices.md @@ -2,7 +2,7 @@ title: 支持的设备表 description: published: true -date: 2025-09-20T18：10：07.765Z +date: 2026-02-07T14：48：11.782Z tags: editor: markdown dateCreated: 2025-09-16T11：31：39.039Z @@ -14,39 +14,41 @@ dateCreated: 2025-09-16T11：31：39.039Z # 2. 带有设备拼写图像的设备列表 -| 设备 | UEFI | SPI 芯片 | 已知问题 | 安装类型 | 指南 | -| ------------------------ | ---- | ------------------------- | ----------------------------------- | ---------------------------------------------------------- | --------------------------------- | -| 酷皮4 模型B | 否 | 指南 | WiFi无法工作 | [device-specific-image](/en/install/device-specific-image) | | -| FydeTab Duo | 否 | 否 | | [device-specific-image](/en/install/device-specific-image) | [FydetabDuo](/en/fydetab-duo) | -| Indiedroid Nova | 否 | 否 | | [device-specific-image](/en/install/device-specific-image) | | -| ITX-3588J | 否 | 否 | 很多人，看看设备页面 | [device-specific-image](/en/install/device-specific-image) | [itx-3588j](/en/itx-3588j) | -| Khadas Edge 2 | 否 | 否 | | [device-specific-image](/en/install/device-specific-image) | | -| Khadas VIM 4 | 否 | 否 | | [device-specific-image](/en/install/device-specific-image) | | -| Metotronics R58S | 否 | 否 | | [device-specific-image](/en/install/device-specific-image) | | -| Mekotronics R58X | 否 | 否 | | [device-specific-image](/en/install/device-specific-image) | | -| Metotronics R58X-4G | ? | 否 | | [device-specific-image](/en/install/device-specific-image) | | -| Mekotronics R58X-Pro | ? | 否 | | [device-specific-image](/en/install/device-specific-image) | | -| Milk V 木卫士 | 否 | 否 | WiFi无法工作 | [device-specific-image](/en/install/device-specific-image) | | -| Orange Pi 5 | 否 | 否 | SATA M.2 SSD 可能无法工作 | [device-specific-image](/en/install/device-specific-image) | [橙色Pi 5 系列](/orangepi-5) | -| Orange Pi 5B | 设备 | 是 (可选) | 使用 OPI5 镜像，需要 DTBO 才能工作 | [device-specific-image](/en/install/device-specific-image) | [橙色Pi 5 系列](/orangepi-5) | -| Orange Pi 5 Max | 否 | 否 | | [device-specific-image](/en/install/device-specific-image) | [橙色Pi 5 系列](/orangepi-5) | -| Orange Pi 5 Plus | 否 | 否 | | [device-specific-image](/en/install/device-specific-image) | [橙色Pi 5 系列](/orangepi-5) | -| Orange Pi 5 Pro | 否 | 否 | | [device-specific-image](/en/install/device-specific-image) | [橙色Pi 5 系列](/orangepi-5) | -| Orange Pi 5 Ultra | 否 | 否 | | [device-specific-image](/en/install/device-specific-image) | [橙色Pi 5 系列](/orangepi-5) | -| Orange Pi CM5 | 否 | 否 | | [device-specific-image](/en/install/device-specific-image) | [橙色Pi 5 系列](/orangepi-5) | -| 橙色Pi RV2 | 否 | 否 | | [device-specific-image](/en/install/device-specific-image) | [橙色Pi RV 系列](/orangepi-rv) | -| Radxa CM5 | 否 | 否 | | [device-specific-image](/en/install/device-specific-image) | [Rock 5 Series](/rock-5) | -| Radxa CM5 DTV 运营商 | 否 | 否 | | [device-specific-image](/en/install/device-specific-image) | [Rock 5 Series](/rock-5) | -| Radxa NX5 套件 | 否 | 否 | | [device-specific-image](/en/install/device-specific-image) | | -| Radxa Rock 4C Plus | 否 | 否 | | [device-specific-image](/en/install/device-specific-image) | | -| Radxa Rock 5 ITX | 否 | 否 | | [device-specific-image](/en/install/device-specific-image) | [Rock 5 Series](/rock-5) | -| Radxa Rock 5A | 否 | 是[^1] | | [device-specific-image](/en/install/device-specific-image) | [Rock 5 Series](/rock-5) | -| Radxa Rock 5B | 否 | 否 | | [device-specific-image](/en/install/device-specific-image) | [Rock 5 Series](/rock-5) | -| Radxa Rock 5B+ | 否 | 否 | | [device-specific-image](/en/install/device-specific-image) | [Rock 5 Series](/rock-5) | -| Radxa Rock 5C | 否 | 是[^1] | | [device-specific-image](/en/install/device-specific-image) | [Rock 5 Series](/rock-5) | -| Radxa Rock 5D | 否 | 否 | | [device-specific-image](/en/install/device-specific-image) | [Rock 5 Series](/rock-5) | -| Radxa Rock 5T | 否 | 否 | | [device-specific-image](/en/install/device-specific-image) | [Rock 5 Series](/rock-5) | -| Radxa Orion O6 | 已知问题 | 是 (可选) | PCIe Gen 4 设备导致棋盘变得不稳定 | [Installation-with-ISO](/en/install/Installation-with-ISO) | [radxa-orion-o6](/radxa-orion-o6) | -| {.dense} | | | | | | +\| Device | UEFI | SPI | Known Issues | Installation type | Device Page | Nickname | +\|-------------------|-------|-----------|--------------|--|--| +\| Cool Pi 4 Model B | No | No | Wifi doesn't work.| [Device specific image](/install/device-specific-image)| | | +|FydeTab Duo| Yes | No | |[Device specific image](/install/device-specific-image)|[Fydetab Duo](/en/fydetab-duo) | "FydeTube", "FDT", or "Duo" | +|Indiedroid Nova| Yes | No | |[Device specific image](/install/device-specific-image)| | | +|ITX-3588J| Yes | No | Many, take a look at the device page |[Device specific image](/install/device-specific-image)|[ITX-3588J](/itx-3588j) | Frisbee | +|Khadas Edge 2| No | Yes | |[Device specific image](/install/device-specific-image)| | | +|Khadas VIM 4| No | Yes | |[Device specific image](/install/device-specific-image)| | | +|Mekotronics R58S| Yes |No| |[Device specific image](/install/device-specific-image)| | | +|Mekotronics R58X|Yes|Yes| |[Device specific image](/install/device-specific-image)| | | +|Mekotronics R58X-4G|?|Yes| |[Device specific image](/install/device-specific-image)| | | +|Mekotronics R58X-Pro|?|Yes| |[Device specific image](/install/device-specific-image)| | | +|Milk V Jupiter|No|Yes| wifi doesn't work|[Device specific image](/install/device-specific-image)| | | +|Orange Pi 5|Yes|Yes| Sata M.2 SSDs may not work |[Device specific image](/install/device-specific-image)|[Orange Pi 5 Series](/orangepi-5) | opi5 | +|Orange Pi 5B|Yes|Yes| Uses OPI5 image and requires DTBO for wifi to work |[Device specific image](/install/device-specific-image)|[Orange Pi 5 Series](/orangepi-5) | opi5b | +|Orange Pi 5 Max|Yes|Yes| |[Device specific image](/install/device-specific-image)|[Orange Pi 5 Series](/orangepi-5) | opi5max | +|Orange Pi 5 Plus| Yes |Yes| |[Device specific image](/install/device-specific-image)|[Orange Pi 5 Series](/orangepi-5) | opi5plus | +|Orange Pi 5 Pro|No|No| |[Device specific image](/install/device-specific-image)|[Orange Pi 5 Series](/orangepi-5) | opi5pro | +|Orange Pi 5 Ultra|Yes|Yes| |[Device specific image](/install/device-specific-image)|[Orange Pi 5 Series](/orangepi-5) | opi5ultra | +|Orange Pi 6 Plus|Yes|Yes| |[Installation with ISO](/install/Installation-with-ISO)|[Orange Pi 6 Plus](/en/orange-pi-6-plus)| opi6plus | +|Orange Pi CM5|No|No| |[Device specific image](/install/device-specific-image)|[Orange Pi 5 Series](/orangepi-5) | opicm5 | +|Orange Pi RV2|No|Yes| |[Device specific image](/install/device-specific-image)|[Orange Pi RV Series](/orangepi-rv) | opirv2 | +|Radxa CM5|No|No| |[Device specific image](/install/device-specific-image)|[Rock 5 Series](/rock-5) | | +|Radxa CM5 DTV carrier|No|No| |[Device specific image](/install/device-specific-image)|[Rock 5 Series](/rock-5) | | +|Radxa NX5 Kit|No|No| |[Device specific image](/install/device-specific-image)| | | +|Radxa Rock 4C Plus|No|No| |[Device specific image](/install/device-specific-image)| | | +|Radxa Rock 5 ITX|Yes|Yes| |[Device specific image](/install/device-specific-image)|[Rock 5 Series](/rock-5) | | +|Radxa Rock 5A|Yes|Yes[^1]| |[Device specific image](/install/device-specific-image)|[Rock 5 Series](/rock-5) | | +|Radxa Rock 5B|Yes|Yes| |[Device specific image](/install/device-specific-image)|[Rock 5 Series](/rock-5) | | +|Radxa Rock 5B+|Yes|Yes| |[Device specific image](/install/device-specific-image)|[Rock 5 Series](/rock-5) | BP | +|Radxa Rock 5C|Yes|Yes[^1]| |[Device specific image](/install/device-specific-image)|[Rock 5 Series](/rock-5) | ICU | +|Radxa Rock 5D|No|No| |[Device specific image](/install/device-specific-image)|[Rock 5 Series](/rock-5) | | +|Radxa Rock 5T|No|Yes | |[Device specific image](/install/device-specific-image)|[Rock 5 Series](/rock-5) | | +\| Radxa Orion O6 | Yes |Yes| PCIe Gen 4 devices cause the board to become unstable|[Installation with ISO](/install/Installation-with-ISO)| [Radxa Orion O6](/radxa-orion-o6/prion)| Prion | +\| Radxa Orion O6 Nano | Yes |Yes| |[Installation with ISO](/install/Installation-with-ISO)| [Radxa Orion O6N](/radxa-orion-o6/fun-sized-prion) | fun sized Prion | +{.dense} [^1]: 需要 [此模块](https://radxa.com/products/accessories/spi-flash-module/)。 \ No newline at end of file