From ebb9566aba643be4fabc8710999d00976c98ac99 Mon Sep 17 00:00:00 2001 From: Ken Date: Wed, 16 Oct 2024 14:22:33 +0800 Subject: [PATCH 1/4] feat: add rock5t zh docs --- docs/common/radxa-os/_autologin.mdx | 17 ++ docs/rock5/products.md | 4 + docs/rock5/rock5t/README.md | 9 + docs/rock5/rock5t/_image.mdx | 43 +++++ docs/rock5/rock5t/app-development/README.md | 9 + docs/rock5/rock5t/app-development/gpiod.md | 10 ++ docs/rock5/rock5t/app-development/hdmi-rx.md | 10 ++ docs/rock5/rock5t/app-development/mraa.md | 8 + docs/rock5/rock5t/app-development/opencv.md | 10 ++ docs/rock5/rock5t/app-development/panfork.md | 10 ++ .../app-development/qt_cross_compile.md | 10 ++ .../rock5t/app-development/rkllm_install.md | 9 + .../rock5t/app-development/rkllm_usage.md | 9 + .../rock5t/app-development/rknn_install.md | 10 ++ .../app-development/rknn_quick_start.md | 9 + .../app-development/rknn_toolkit2_pc.md | 10 ++ .../rknn_toolkit_lite2_yolov5.md | 9 + .../rknn_toolkit_lite2_yolov8.md | 10 ++ .../rock5t/app-development/ros2_humble.md | 9 + docs/rock5/rock5t/app-development/rtsp.md | 10 ++ docs/rock5/rock5t/download.md | 135 ++++++++++++++ docs/rock5/rock5t/faq.md | 89 ++++++++++ docs/rock5/rock5t/getting-started/README.md | 7 + .../getting-started/basic-software-conf.md | 14 ++ .../getting-started/install-os/README.md | 8 + .../install-os/boot_from_sd_card.md | 38 ++++ .../install-os/erase_spi-flash.md | 25 +++ .../rock5t/getting-started/install-os/nvme.md | 13 ++ .../getting-started/interface-usage/README.md | 6 + .../getting-started/interface-usage/fan.md | 9 + .../getting-started/interface-usage/hdmi.md | 11 ++ .../interface-usage/headphone-jack.md | 11 ++ .../interface-usage/mipi-csi.md | 62 +++++++ .../interface-usage/mipi-dsi.md | 48 +++++ .../interface-usage/pcie-m-key.md | 34 ++++ .../interface-usage/pin-40-test.md | 31 ++++ .../getting-started/interface-usage/usb.md | 9 + .../rock5t/getting-started/introduction.md | 127 ++++++++++++++ .../rock5t/getting-started/power-supply.md | 16 ++ .../rock5t/getting-started/quick-start.md | 49 ++++++ docs/rock5/rock5t/hardware-design/README.md | 9 + .../hardware-design/hardware-interface.md | 88 ++++++++++ docs/rock5/rock5t/low-level-dev/README.md | 9 + docs/rock5/rock5t/low-level-dev/kernel.md | 10 ++ .../rock5t/low-level-dev/maskrom/README.md | 7 + .../rock5t/low-level-dev/maskrom/erase.md | 21 +++ .../rock5t/low-level-dev/maskrom/linux.md | 26 +++ .../rock5t/low-level-dev/maskrom/mac-os.md | 26 +++ .../rock5t/low-level-dev/maskrom/windows.md | 26 +++ docs/rock5/rock5t/low-level-dev/overlays.md | 10 ++ docs/rock5/rock5t/low-level-dev/rbuild.md | 10 ++ docs/rock5/rock5t/low-level-dev/u-boot.md | 10 ++ docs/rock5/rock5t/other-os/README.md | 9 + docs/rock5/rock5t/other-os/android/README.md | 9 + .../rock5/rock5t/other-os/android/download.md | 15 ++ .../rock5t/other-os/android/install-os.md | 120 +++++++++++++ .../rock5t/other-os/android/low-level-dev.md | 166 ++++++++++++++++++ .../rock5t/other-os/android/preparation.md | 39 ++++ .../rock5t/other-os/android/remote-login.md | 29 +++ docs/rock5/rock5t/other-os/wor.md | 6 + docs/rock5/rock5t/other-os/yocto.md | 10 ++ docs/rock5/rock5t/radxa-os/README.md | 11 ++ docs/rock5/rock5t/radxa-os/ap.md | 10 ++ docs/rock5/rock5t/radxa-os/autologin.md | 10 ++ docs/rock5/rock5t/radxa-os/backup.md | 10 ++ docs/rock5/rock5t/radxa-os/bootparam.md | 10 ++ docs/rock5/rock5t/radxa-os/display.md | 10 ++ docs/rock5/rock5t/radxa-os/headless.md | 10 ++ docs/rock5/rock5t/radxa-os/mali-gpu.md | 10 ++ docs/rock5/rock5t/radxa-os/media.md | 17 ++ docs/rock5/rock5t/radxa-os/msodbcsql.md | 10 ++ docs/rock5/rock5t/radxa-os/rsetup.md | 10 ++ docs/rock5/rock5t/radxa-os/serial.md | 10 ++ docs/rock5/rock5t/radxa-os/software.md | 34 ++++ docs/rock5/rock5t/radxa-os/usbnet.md | 10 ++ docs/rock5/rock5t/radxa-os/user.md | 10 ++ docs/rock5/rock5t/radxa-os/using-apt.md | 10 ++ static/img/common/debian12-desktop.webp | Bin 0 -> 70878 bytes static/img/rock5t/rock-5t-comic.webp | Bin 0 -> 30060 bytes static/img/rock5t/rock-5t-overview-x1-0.webp | Bin 0 -> 632742 bytes static/img/rock5t/rock-5t-package.webp | Bin 0 -> 265420 bytes static/img/rock5t/rock-5t-typec-maskrom.webp | Bin 0 -> 240416 bytes .../rock5t/rock5t-4k-camera-connected.webp | Bin 0 -> 340208 bytes .../rock5t/rock5t-8m-camera-connected.webp | Bin 0 -> 350372 bytes static/img/rock5t/rock5t-autologin-1.webp | Bin 0 -> 68842 bytes static/img/rock5t/rock5t-autologin-2.webp | Bin 0 -> 119498 bytes .../rock5t/rock5t-display-8hd-connected.webp | Bin 0 -> 299846 bytes static/img/rock5t/rock5t-ethernet.webp | Bin 0 -> 239240 bytes static/img/rock5t/rock5t-hdmi.webp | Bin 0 -> 215568 bytes static/img/rock5t/rock5t-headphone.webp | Bin 0 -> 319042 bytes static/img/rock5t/rock5t-pwr.webp | Bin 0 -> 292402 bytes .../img/rock5t/rock5t-rpi-7inch-display.webp | Bin 0 -> 88492 bytes static/img/rock5t/rock5t-usb.webp | Bin 0 -> 163544 bytes 93 files changed, 1814 insertions(+) create mode 100644 docs/rock5/rock5t/README.md create mode 100644 docs/rock5/rock5t/_image.mdx create mode 100644 docs/rock5/rock5t/app-development/README.md create mode 100644 docs/rock5/rock5t/app-development/gpiod.md create mode 100644 docs/rock5/rock5t/app-development/hdmi-rx.md create mode 100644 docs/rock5/rock5t/app-development/mraa.md create mode 100644 docs/rock5/rock5t/app-development/opencv.md create mode 100644 docs/rock5/rock5t/app-development/panfork.md create mode 100644 docs/rock5/rock5t/app-development/qt_cross_compile.md create mode 100644 docs/rock5/rock5t/app-development/rkllm_install.md create mode 100644 docs/rock5/rock5t/app-development/rkllm_usage.md create mode 100644 docs/rock5/rock5t/app-development/rknn_install.md create mode 100644 docs/rock5/rock5t/app-development/rknn_quick_start.md create mode 100644 docs/rock5/rock5t/app-development/rknn_toolkit2_pc.md create mode 100644 docs/rock5/rock5t/app-development/rknn_toolkit_lite2_yolov5.md create mode 100644 docs/rock5/rock5t/app-development/rknn_toolkit_lite2_yolov8.md create mode 100644 docs/rock5/rock5t/app-development/ros2_humble.md create mode 100644 docs/rock5/rock5t/app-development/rtsp.md create mode 100644 docs/rock5/rock5t/download.md create mode 100644 docs/rock5/rock5t/faq.md create mode 100644 docs/rock5/rock5t/getting-started/README.md create mode 100644 docs/rock5/rock5t/getting-started/basic-software-conf.md create mode 100644 docs/rock5/rock5t/getting-started/install-os/README.md create mode 100644 docs/rock5/rock5t/getting-started/install-os/boot_from_sd_card.md create mode 100644 docs/rock5/rock5t/getting-started/install-os/erase_spi-flash.md create mode 100644 docs/rock5/rock5t/getting-started/install-os/nvme.md create mode 100644 docs/rock5/rock5t/getting-started/interface-usage/README.md create mode 100644 docs/rock5/rock5t/getting-started/interface-usage/fan.md create mode 100644 docs/rock5/rock5t/getting-started/interface-usage/hdmi.md create mode 100644 docs/rock5/rock5t/getting-started/interface-usage/headphone-jack.md create mode 100644 docs/rock5/rock5t/getting-started/interface-usage/mipi-csi.md create mode 100644 docs/rock5/rock5t/getting-started/interface-usage/mipi-dsi.md create mode 100644 docs/rock5/rock5t/getting-started/interface-usage/pcie-m-key.md create mode 100644 docs/rock5/rock5t/getting-started/interface-usage/pin-40-test.md create mode 100644 docs/rock5/rock5t/getting-started/interface-usage/usb.md create mode 100644 docs/rock5/rock5t/getting-started/introduction.md create mode 100644 docs/rock5/rock5t/getting-started/power-supply.md create mode 100644 docs/rock5/rock5t/getting-started/quick-start.md create mode 100644 docs/rock5/rock5t/hardware-design/README.md create mode 100644 docs/rock5/rock5t/hardware-design/hardware-interface.md create mode 100644 docs/rock5/rock5t/low-level-dev/README.md create mode 100644 docs/rock5/rock5t/low-level-dev/kernel.md create mode 100644 docs/rock5/rock5t/low-level-dev/maskrom/README.md create mode 100644 docs/rock5/rock5t/low-level-dev/maskrom/erase.md create mode 100644 docs/rock5/rock5t/low-level-dev/maskrom/linux.md create mode 100644 docs/rock5/rock5t/low-level-dev/maskrom/mac-os.md create mode 100644 docs/rock5/rock5t/low-level-dev/maskrom/windows.md create mode 100644 docs/rock5/rock5t/low-level-dev/overlays.md create mode 100644 docs/rock5/rock5t/low-level-dev/rbuild.md create mode 100644 docs/rock5/rock5t/low-level-dev/u-boot.md create mode 100644 docs/rock5/rock5t/other-os/README.md create mode 100644 docs/rock5/rock5t/other-os/android/README.md create mode 100644 docs/rock5/rock5t/other-os/android/download.md create mode 100644 docs/rock5/rock5t/other-os/android/install-os.md create mode 100644 docs/rock5/rock5t/other-os/android/low-level-dev.md create mode 100644 docs/rock5/rock5t/other-os/android/preparation.md create mode 100644 docs/rock5/rock5t/other-os/android/remote-login.md create mode 100644 docs/rock5/rock5t/other-os/wor.md create mode 100644 docs/rock5/rock5t/other-os/yocto.md create mode 100644 docs/rock5/rock5t/radxa-os/README.md create mode 100644 docs/rock5/rock5t/radxa-os/ap.md create mode 100644 docs/rock5/rock5t/radxa-os/autologin.md create mode 100644 docs/rock5/rock5t/radxa-os/backup.md create mode 100644 docs/rock5/rock5t/radxa-os/bootparam.md create mode 100644 docs/rock5/rock5t/radxa-os/display.md create mode 100644 docs/rock5/rock5t/radxa-os/headless.md create mode 100644 docs/rock5/rock5t/radxa-os/mali-gpu.md create mode 100644 docs/rock5/rock5t/radxa-os/media.md create mode 100644 docs/rock5/rock5t/radxa-os/msodbcsql.md create mode 100644 docs/rock5/rock5t/radxa-os/rsetup.md create mode 100644 docs/rock5/rock5t/radxa-os/serial.md create mode 100644 docs/rock5/rock5t/radxa-os/software.md create mode 100644 docs/rock5/rock5t/radxa-os/usbnet.md create mode 100644 docs/rock5/rock5t/radxa-os/user.md create mode 100644 docs/rock5/rock5t/radxa-os/using-apt.md create mode 100644 static/img/common/debian12-desktop.webp create mode 100644 static/img/rock5t/rock-5t-comic.webp create mode 100644 static/img/rock5t/rock-5t-overview-x1-0.webp create mode 100644 static/img/rock5t/rock-5t-package.webp create mode 100644 static/img/rock5t/rock-5t-typec-maskrom.webp create mode 100644 static/img/rock5t/rock5t-4k-camera-connected.webp create mode 100644 static/img/rock5t/rock5t-8m-camera-connected.webp create mode 100644 static/img/rock5t/rock5t-autologin-1.webp create mode 100644 static/img/rock5t/rock5t-autologin-2.webp create mode 100644 static/img/rock5t/rock5t-display-8hd-connected.webp create mode 100644 static/img/rock5t/rock5t-ethernet.webp create mode 100644 static/img/rock5t/rock5t-hdmi.webp create mode 100644 static/img/rock5t/rock5t-headphone.webp create mode 100644 static/img/rock5t/rock5t-pwr.webp create mode 100644 static/img/rock5t/rock5t-rpi-7inch-display.webp create mode 100644 static/img/rock5t/rock5t-usb.webp diff --git a/docs/common/radxa-os/_autologin.mdx b/docs/common/radxa-os/_autologin.mdx index 4c8a974d3..d5ba0a05d 100644 --- a/docs/common/radxa-os/_autologin.mdx +++ b/docs/common/radxa-os/_autologin.mdx @@ -1,5 +1,7 @@ 您可以将系统配置为自动登录而无需输入密码。 + + 如图，点击系统设置界面，选择`Startup and Shutdown`. ![ROCK5A_Auto_Login](/img/rock5a/rock5a_auto_login_1.webp) @@ -7,3 +9,18 @@ 如图切换到`Advanced`，点击方框选择自动登录的用户，然后点击`Apply`，完成自动登录设置。 现在重新启动计算机将不再需要您输入登录密码。 ![ROCK5A_Auto_Login](/img/rock5a/rock5a_auto_login_2.webp) + + + + +如图，使用` Ctrl + Alt + T` 调出终端, 然后编辑文件`sudo vim /etc/gdm3/daemon.conf` + +![ROCK5T_Auto_Login](/img/rock5t/rock5t-autologin-1.webp) + +按 `i` 进入编辑模式，修改成如下内容，然后按 `Esc` 输入 `:wq` 保存并退出，完成自动登录设置。 现在重新启动计算机将不再需要您输入登录密码。 + +![ROCK5T_Auto_Login](/img/rock5t/rock5t-autologin-2.webp) + + + + diff --git a/docs/rock5/products.md b/docs/rock5/products.md index a1786ecf8..618da7d02 100644 --- a/docs/rock5/products.md +++ b/docs/rock5/products.md @@ -25,6 +25,10 @@ ROCK 5 系列是瑞莎基于 Rockchip 的 RK3588 及 RK3588-S 高端 SoC 解决 | :----------------------------------------------------: | :-------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------- | :-------------------------------------------: | | ![ROCK 5C](/img/rock5c/rock-5c-and-5c-lite-comic.webp) | Radxa ROCK 5C 是一款紧凑型单板计算机（SBC），拥有一系列领先的功能、特性和扩展选项。对于创客、物联网爱好者、业余爱好者、游戏玩家、PC用户以及所有追求卓越性能和可靠性的高规格平台的人来说，ROCK 5C 是理想的选择。ROCK 5C 提供两个版本：标准版（基于RK3588S2）和 Lite 版（基于RK3582）。这两个版本在大部分功能上相同，唯一的区别在于 SoC（片上系统）。在后续的文档中，除非特别说明，"ROCK 5C" 指的是 ROCK 5C 标准版和 5C Lite 版本。 | [ROCK 5C 概览](/rock5/rock5c/getting-started) | +| ROCK 5 Model T | 简介 | 产品详情 | +| :----------------------------------------: | :------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------ | :-------------------------------------------: | +| ![ROCK 5T](/img/rock5t/rock-5t-comic.webp) | Radxa ROCK 5T 是 Radxa ROCK 5B+ 的升级版，这款紧凑型单板计算机（SBC）在性能和功能上都有显著提升，接口更为丰富。它面向制造商、物联网爱好者、业余开发者、游戏玩家和 PC 用户，提供了一个强大的平台，适合需要高性能和高可靠性的应用场景。Radxa ROCK 5T 是一款理想的选择，无论是用于项目开发还是日常应用，都能提供出色的体验。 | [ROCK 5T 概览](/rock5/rock5t/getting-started) | + | ROCK 5 ITX | 简介 | 产品详情 | | :----------------------------------------------: | :------------------------------------------------------------------------------------------------------------------------------------------------------------------ | :------------------------------------------------: | | ![ROCK 5 ITX](/img/rock5itx/rock5itx-comic.webp) | Radxa ROCK 5 ITX 是瑞莎团队全力打造的一款全面兼容 Mini-ITX 规范的单板计算机/主板。搭载高性能Rockchip RK3588 SoC，此款主板标志着开源单板机领域全面迈向 ARM PC 时代。 | [ROCK 5 ITX 概览](/rock5/rock5itx/getting-started) | diff --git a/docs/rock5/rock5t/README.md b/docs/rock5/rock5t/README.md new file mode 100644 index 000000000..1968d5dda --- /dev/null +++ b/docs/rock5/rock5t/README.md @@ -0,0 +1,9 @@ +--- +sidebar_position: 1 +--- + +# ROCK 5T + +一台具有 8K + 4K 双显的优雅单板计算机(SBC)。 + + diff --git a/docs/rock5/rock5t/_image.mdx b/docs/rock5/rock5t/_image.mdx new file mode 100644 index 000000000..b86c5da63 --- /dev/null +++ b/docs/rock5/rock5t/_image.mdx @@ -0,0 +1,43 @@ +import React, { Fragment } from "react"; + + diff --git a/docs/rock5/rock5t/app-development/README.md b/docs/rock5/rock5t/app-development/README.md new file mode 100644 index 000000000..2794a58b0 --- /dev/null +++ b/docs/rock5/rock5t/app-development/README.md @@ -0,0 +1,9 @@ +--- +sidebar_position: 4 +--- + +# 应用开发 + +主要介绍上层应用开发，比如 QT, WiringX, Mraa 等 + + diff --git a/docs/rock5/rock5t/app-development/gpiod.md b/docs/rock5/rock5t/app-development/gpiod.md new file mode 100644 index 000000000..e243ccf55 --- /dev/null +++ b/docs/rock5/rock5t/app-development/gpiod.md @@ -0,0 +1,10 @@ +--- +sidebar_position: 2 +description: "深入了解 GPIOD" +--- + +# GPIOD 使用 + +import GPIOD from '../../../common/dev/\_gpiod.mdx'; + + diff --git a/docs/rock5/rock5t/app-development/hdmi-rx.md b/docs/rock5/rock5t/app-development/hdmi-rx.md new file mode 100644 index 000000000..85a9e2deb --- /dev/null +++ b/docs/rock5/rock5t/app-development/hdmi-rx.md @@ -0,0 +1,10 @@ +--- +sidebar_position: 4 +description: "探索 HDMI RX 功能，体验高清视频与音频的无缝接入与处理" +--- + +import HdmiRX from '../../../common/dev/\_hdmi-rx.mdx'; + +# HDMI RX Usage + + diff --git a/docs/rock5/rock5t/app-development/mraa.md b/docs/rock5/rock5t/app-development/mraa.md new file mode 100644 index 000000000..3fcb85c9a --- /dev/null +++ b/docs/rock5/rock5t/app-development/mraa.md @@ -0,0 +1,8 @@ +--- +sidebar_position: 3 +description: "探索适用于 Linux 的多功能 I/O 通信库 Eclipse Mraa" +--- + +# Mraa 使用（暂未支持） + +import MRAA from '../../../common/dev/\_mraa.mdx'; diff --git a/docs/rock5/rock5t/app-development/opencv.md b/docs/rock5/rock5t/app-development/opencv.md new file mode 100644 index 000000000..4603a4c03 --- /dev/null +++ b/docs/rock5/rock5t/app-development/opencv.md @@ -0,0 +1,10 @@ +--- +sidebar_position: 5 +description: "开启 OpenCV 计算机视觉的大门，让图像与现实世界无缝连接" +--- + +# OpenCV + +import OPENCV from '../../../common/dev/\_opencv.mdx'; + + diff --git a/docs/rock5/rock5t/app-development/panfork.md b/docs/rock5/rock5t/app-development/panfork.md new file mode 100644 index 000000000..a7f0a14e2 --- /dev/null +++ b/docs/rock5/rock5t/app-development/panfork.md @@ -0,0 +1,10 @@ +--- +sidebar_position: 6 +description: "通过 Panfork GPU Driver，享受开源驱动带来的 Linux 图形生态与性能的和谐融合" +--- + +import Panfork from '../../../common/dev/\_panfork.mdx'; + +# Panfork GPU Driver + + diff --git a/docs/rock5/rock5t/app-development/qt_cross_compile.md b/docs/rock5/rock5t/app-development/qt_cross_compile.md new file mode 100644 index 000000000..4f24104f8 --- /dev/null +++ b/docs/rock5/rock5t/app-development/qt_cross_compile.md @@ -0,0 +1,10 @@ +--- +sidebar_position: 7 +description: "通过 QT 交叉编译，享受在 ARM 平台上开发高效、人性化的应用程序的便捷与乐趣" +--- + +# QT 交叉编译 + +import QTCROSSCOMPILE from '../../../common/dev/\_qt-cross-compile.mdx'; + + diff --git a/docs/rock5/rock5t/app-development/rkllm_install.md b/docs/rock5/rock5t/app-development/rkllm_install.md new file mode 100644 index 000000000..ea156f23e --- /dev/null +++ b/docs/rock5/rock5t/app-development/rkllm_install.md @@ -0,0 +1,9 @@ +--- +sidebar_position: 13 +--- + +# RKLLM 安装 + +import Rkllminstall from '../../../common/dev/\_rkllm-install.mdx'; + + diff --git a/docs/rock5/rock5t/app-development/rkllm_usage.md b/docs/rock5/rock5t/app-development/rkllm_usage.md new file mode 100644 index 000000000..a9886a9aa --- /dev/null +++ b/docs/rock5/rock5t/app-development/rkllm_usage.md @@ -0,0 +1,9 @@ +--- +sidebar_position: 14 +--- + +# RKLLM 使用与大语言模型部署 + +import Rkllmusage from '../../../common/dev/\_rkllm-usage.mdx'; + + diff --git a/docs/rock5/rock5t/app-development/rknn_install.md b/docs/rock5/rock5t/app-development/rknn_install.md new file mode 100644 index 000000000..85244393d --- /dev/null +++ b/docs/rock5/rock5t/app-development/rknn_install.md @@ -0,0 +1,10 @@ +--- +sidebar_position: 9 +description: "通过 RKNN 安装，开启 AI 模型在 Rockchip NPU 上的高效推理之旅，感受科技与人文的完美融合" +--- + +# RKNN 安装 + +import RKNNinstall from '../../../common/dev/\_rknn-install.mdx'; + + diff --git a/docs/rock5/rock5t/app-development/rknn_quick_start.md b/docs/rock5/rock5t/app-development/rknn_quick_start.md new file mode 100644 index 000000000..f442f6118 --- /dev/null +++ b/docs/rock5/rock5t/app-development/rknn_quick_start.md @@ -0,0 +1,9 @@ +--- +sidebar_position: 14 +--- + +# RKNN 快速例子 + +import Rknntoolkit2 from '../../../common/dev/\_rknn-toolkit2.mdx'; + + diff --git a/docs/rock5/rock5t/app-development/rknn_toolkit2_pc.md b/docs/rock5/rock5t/app-development/rknn_toolkit2_pc.md new file mode 100644 index 000000000..67c4ff0c0 --- /dev/null +++ b/docs/rock5/rock5t/app-development/rknn_toolkit2_pc.md @@ -0,0 +1,10 @@ +--- +sidebar_position: 10 +description: "利用 RKNN 工具包，探索 AI 模型的模拟推理，体验智能图像分割的高效与精准" +--- + +# 模拟推理 YOLOv5 分割模型 + +import RKNNTOOLKIT2PC from '../../../common/dev/\_rknn-toolkit2-pc.mdx'; + + diff --git a/docs/rock5/rock5t/app-development/rknn_toolkit_lite2_yolov5.md b/docs/rock5/rock5t/app-development/rknn_toolkit_lite2_yolov5.md new file mode 100644 index 000000000..f30a6901e --- /dev/null +++ b/docs/rock5/rock5t/app-development/rknn_toolkit_lite2_yolov5.md @@ -0,0 +1,9 @@ +--- +sidebar_position: 11 +--- + +# 板端部署 YOLOv5 目标检测 + +import RKNNTOOLKITLITE2YOLOV5 from '../../../common/dev/\_rknn-toolkit-lite2-yolov5.mdx'; + + diff --git a/docs/rock5/rock5t/app-development/rknn_toolkit_lite2_yolov8.md b/docs/rock5/rock5t/app-development/rknn_toolkit_lite2_yolov8.md new file mode 100644 index 000000000..b6471e738 --- /dev/null +++ b/docs/rock5/rock5t/app-development/rknn_toolkit_lite2_yolov8.md @@ -0,0 +1,10 @@ +--- +sidebar_position: 12 +description: "通过 RK3588 板端部署 YOLOv8，开启智能目标检测的新时代，让技术与人文关怀在精准识别中完美融合" +--- + +# 板端部署 YOLOv8 目标检测 + +import RKNNTOOLKITLITE2YOLOV8 from '../../../common/dev/\_rknn-toolkit-lite2-yolov8.mdx'; + + diff --git a/docs/rock5/rock5t/app-development/ros2_humble.md b/docs/rock5/rock5t/app-development/ros2_humble.md new file mode 100644 index 000000000..1a34d7d80 --- /dev/null +++ b/docs/rock5/rock5t/app-development/ros2_humble.md @@ -0,0 +1,9 @@ +--- +sidebar_position: 20 +--- + +# 安装 ROS2 HUMBLE + +import ROS2 from '../../../common/dev/\_ros2-humble-compilation.mdx'; + + diff --git a/docs/rock5/rock5t/app-development/rtsp.md b/docs/rock5/rock5t/app-development/rtsp.md new file mode 100644 index 000000000..d63c37543 --- /dev/null +++ b/docs/rock5/rock5t/app-development/rtsp.md @@ -0,0 +1,10 @@ +--- +sidebar_position: 8 +description: "深入挖掘 ROCK 5 系列的 RTSP 推流能力，享受技术与人文的完美融合，让高清视频流如诗般流畅" +--- + +import Rtsp from '../../../common/dev/\_rtsp.mdx'; + +# RTSP 推流 + + diff --git a/docs/rock5/rock5t/download.md b/docs/rock5/rock5t/download.md new file mode 100644 index 000000000..02a51ee82 --- /dev/null +++ b/docs/rock5/rock5t/download.md @@ -0,0 +1,135 @@ +--- +sidebar_position: 2 +--- + +import Images from "./\_image.mdx" + +# 资源下载汇总 + +## 操作系统镜像 + +### 官方镜像 + + + + + +## 硬件设计 + +### X1.0(开发者版) + + + +## 质量认证 + +### CE EMC + +### FCC SDOC diff --git a/docs/rock5/rock5t/faq.md b/docs/rock5/rock5t/faq.md new file mode 100644 index 000000000..b823bc7b2 --- /dev/null +++ b/docs/rock5/rock5t/faq.md @@ -0,0 +1,89 @@ +--- +sidebar_position: 10 +--- + +# FAQ + +## Q1： 联系社区 + +请参考 https://docs.radxa.com/welcome + +## Q2： TF 卡，ROCK 5T 能否从 PCIe M.2 NVME 固态硬盘启动？ + +是的。ROCK 5T 可以从 PCIe M.2 NVME 固态硬盘启动。 +ROCK 5T 配备了一个 16MB 的 SPI Nor Flash 和 PCIe M.2 M-Key 接口。 +SPI Nor Flash 存储引导程序。NVME 固态硬盘存储整个系统映像（至少包括内核和 rootfs）。 +有关映像写入，请参阅本指南。[SPI Nor Flash](./getting-started/install-os/erase_spi-flash) 和 [PCIe NVME SSD](./getting-started/install-os/nvme) 启动。 + +## Q3： 另外，价格中是否包含散热片和风扇？ + +不，默认情况下不包括散热片和风扇。 + +## Q4：我的新 ROCK 5T 无法启动/卡在无限启动循环中 + +ROCK 5T 支持将 USB PD 电源协商至更高的电压，如 9V、12V、15V、20V，以满足系统总功率负载要求（带 WiFi、SSD、USB 外围设备等时约为 30W）。目前 ROCK 5T 有一个专门供电的 TYPE-C 接口，我们提供以下建议： + +- 使用官方电源 - Radxa Power PD 30W。（强烈推荐）Radxa Power PD 30W 已通过 ROCK 5T 的所有条件测试。 +- 使用速度更快的 SD 卡，并禁用引导加载程序/内核串行控制台 +- 使用假的 12V USB C 电源 +- 仔细检查您的电源是否能提供所需的功率，尤其是 5V 电压。许多电源的最大 5V 电压为 3 安培（15W），而其他电压的最大 5V 电压可能更高。 + +## Q5： 我的 ROCK 5T 无法启动，如何检查是否坏了 + +按以下步骤排除 ROCK 5T 故障： + +- 关闭 ROCK 5T 电源，SD 卡、NVMe SSD +- 按住 MASKROOM 按钮 [（标签 32）](./hardware-design/hardware-interface) +- 使用 USB A to C 电缆将 ROCK 5T USB C 接口插入电脑，绿色 LED 灯应亮起 +- 检查电脑 "设备管理器 "中是否有新的 USB 设备，如果有，说明 ROCK 5T 已激活。如果没有，请尝试其他 USB 端口，我们建议将 ROCK 5T 连接到电脑的后面板。 + +## Q6： 我的 ROCK 5T HDMI 不能显示任何内容 + +- 您可以在 /boot/extlinux/extlinux.conf 中手动添加 HDMI 分辨率和帧速率 +- 只需在附加行中添加 video=1920x1080@60（只需将分辨率和帧频改为显示器支持的分辨率即可） + +## Q7： 我通过 RKDevTool 工具烧录 eMMC 成功了，但是上电之后，Led 不闪，屏幕无输出 + +原因确认: + +去掉 MicroSD 及 NVME 设备，短接 DISABLE SPI 并按住 Maskrom 按键上电，然后通过 USB 线连接板子和PC，此时看设备是否进入 [Maskrom 状态](./low-level-dev/maskrom/)， +如果不是MaskRom状态，则大概率是下面的原因: + +在 [通过 USB 烧录系统到eMMC](./low-level-dev/maskrom/) 的时候没有按照说明 按 Maskrom 按键，导致烧录系统到了 [SPI Flash](./low-level-dev/maskrom/erase)中, 而系统启动的时候，先读取SPI的信息，此时出现错误，无法正常启动。 + +解决办法： + +[清空 SPI Flash](./low-level-dev/maskrom/erase), 然后重新按步骤 [通过USB烧录系统到eMMC](./low-level-dev/maskrom/) + +## Q8： Radxa APT 公钥不可用 + +当我尝试运行 apt update 时，得到以下错误信息： + +``` +root@rock-5T:~# apt update +Hit:1 http://security.debian.org/debian-security bookworm-security InRelease +Hit:2 http://httpredir.debian.org/debian bookworm InRelease +Get:3 http://apt.radxa.com/bookworm-stable bookworm InRelease [2362 B] +Hit:4 http://httpredir.debian.org/debian bookworm-updates InRelease +Hit:5 http://httpredir.debian.org/debian bookworm-backports InRelease +Err:3 http://apt.radxa.com/bookworm-stable bookworm InRelease + The following signatures couldn't be verified because the public key is not available: NO_PUBKEY 9B98116C9AA302C7 +Reading package lists... Done +W: GPG error: http://apt.radxa.com/bookworm-stable bookworm InRelease: The following signatures couldn't be verified because the public key is not available: NO_PUBKEY 9B98116C9AA302C7 +E: The repository 'http://apt.radxa.com/bookworm-stable bookworm InRelease' is not signed. +N: Updating from such a repository can't be done securely, and is therefore disabled by default. +N: See apt-secure(8) manpage for repository creation and user configuration details. +``` + +原因是公钥已过期。您可以执行以下命令获取新的可用密钥。 + +``` +sudo apt-get install -y wget +export DISTRO=bookworm-stable +wget -O - apt.radxa.com/$DISTRO/public.key | sudo apt-key add - +sudo apt-get update +``` + +## Q9： 风扇不转动/风扇如何安装 + +请按照[风扇使用教程](./getting-started/interface-usage/fan)。 diff --git a/docs/rock5/rock5t/getting-started/README.md b/docs/rock5/rock5t/getting-started/README.md new file mode 100644 index 000000000..af5bf057e --- /dev/null +++ b/docs/rock5/rock5t/getting-started/README.md @@ -0,0 +1,7 @@ +--- +sidebar_position: 1 +--- + +# 上手指南 + + diff --git a/docs/rock5/rock5t/getting-started/basic-software-conf.md b/docs/rock5/rock5t/getting-started/basic-software-conf.md new file mode 100644 index 000000000..d43a234bf --- /dev/null +++ b/docs/rock5/rock5t/getting-started/basic-software-conf.md @@ -0,0 +1,14 @@ +--- +sidebar_position: 4 +description: "介绍常见设置项，帮助初次使用者快速配置环境并上手操作" +--- + +import BasicSoftWareConf from "../../../common/radxa-os/\_basicSoftwareConf.mdx"; + +# 快速设置 + + + +:::tip +请参考我们的[瑞莎系统](../radxa-os/)章节，了解更多软件配置内容。 +::: diff --git a/docs/rock5/rock5t/getting-started/install-os/README.md b/docs/rock5/rock5t/getting-started/install-os/README.md new file mode 100644 index 000000000..d5220b687 --- /dev/null +++ b/docs/rock5/rock5t/getting-started/install-os/README.md @@ -0,0 +1,8 @@ +--- +sidebar_position: 3 +description: "安装系统的方式" +--- + +# 安装系统 + + diff --git a/docs/rock5/rock5t/getting-started/install-os/boot_from_sd_card.md b/docs/rock5/rock5t/getting-started/install-os/boot_from_sd_card.md new file mode 100644 index 000000000..b4548a710 --- /dev/null +++ b/docs/rock5/rock5t/getting-started/install-os/boot_from_sd_card.md @@ -0,0 +1,38 @@ +--- +sidebar_position: 1 +--- + +import Images from "../../\_image.mdx" +import Etcher from '../../../../common/general/\_etcherV2.mdx'; + +# 安装系统到 MicroSD 卡 + +## 文件下载 + + + +## MicroSD 卡准备 + +将 MicroSD 卡插入到 SD 卡读卡器中，然后将读卡器插入到 PC 的 USB 端口上 + +## 烧录镜像 + + + +## 启动系统 + +按照上述步骤成功烧录 MicroSD Card 后， 将 MicroSD Card 插入到 MicroSD Card 插槽内(如下图所示)，然后上电，电源指示灯显示绿色，系统开始启动，启动正常后，指示灯开始闪烁，一段时间后 HDMI 显示桌面。 + + + +## 登录系统 + +系统启动后，使用 radxa 账号登录，密码为 radxa。 + +:::tip +系统从上电到开机启动，整个过程持续约 40 秒，然后进入系统桌面。 +::: diff --git a/docs/rock5/rock5t/getting-started/install-os/erase_spi-flash.md b/docs/rock5/rock5t/getting-started/install-os/erase_spi-flash.md new file mode 100644 index 000000000..3e48a96b6 --- /dev/null +++ b/docs/rock5/rock5t/getting-started/install-os/erase_spi-flash.md @@ -0,0 +1,25 @@ +--- +sidebar_position: 4 +--- + +# 手动清空 SPI Flash + +## 能启动 Linux + +- 打开终端，执行 rsetup + +- 选择 "System Maintenance" + +main menu + +- 选择 "Erase SPI Bootloader" + +System Maintenance + +- 选择 "OK" 之后，按空格键，选中 "rock-5t"/"rock-5t" + +rsetup rock-5bp + +## 不能启动到系统 + +[请参考通过 USB 线烧录镜像部分](/rock5/rock5t/low-level-dev/maskrom) diff --git a/docs/rock5/rock5t/getting-started/install-os/nvme.md b/docs/rock5/rock5t/getting-started/install-os/nvme.md new file mode 100644 index 000000000..e345fd43d --- /dev/null +++ b/docs/rock5/rock5t/getting-started/install-os/nvme.md @@ -0,0 +1,13 @@ +--- +sidebar_position: 3 +--- + +# 安装系统到 NVME + +import NVME from '../../../../common/dev/\_nvme.mdx'; + + + +:::tip +系统从上电到开机启动，整个过程持续约 53 秒，然后进入系统桌面。 +::: diff --git a/docs/rock5/rock5t/getting-started/interface-usage/README.md b/docs/rock5/rock5t/getting-started/interface-usage/README.md new file mode 100644 index 000000000..6b33f99c8 --- /dev/null +++ b/docs/rock5/rock5t/getting-started/interface-usage/README.md @@ -0,0 +1,6 @@ +--- +sidebar_position: 5 +description: "介绍如何使用 ROCK 5B/5B+ 的一些接口" +--- + +# 接口使用说明 diff --git a/docs/rock5/rock5t/getting-started/interface-usage/fan.md b/docs/rock5/rock5t/getting-started/interface-usage/fan.md new file mode 100644 index 000000000..c512bedb4 --- /dev/null +++ b/docs/rock5/rock5t/getting-started/interface-usage/fan.md @@ -0,0 +1,9 @@ +--- +sidebar_position: 9 +--- + +import FAN from "../../../../common/accessories/\_fan.mdx"; + +# 风扇接口 + +## 接口测试方法 diff --git a/docs/rock5/rock5t/getting-started/interface-usage/hdmi.md b/docs/rock5/rock5t/getting-started/interface-usage/hdmi.md new file mode 100644 index 000000000..a3b56cfd0 --- /dev/null +++ b/docs/rock5/rock5t/getting-started/interface-usage/hdmi.md @@ -0,0 +1,11 @@ +--- +sidebar_position: 2 +--- + +import HDMI from "../../../../common/accessories/\_hdmi.mdx"; + +# HDMI 接口 + +## Interface Test Method + + diff --git a/docs/rock5/rock5t/getting-started/interface-usage/headphone-jack.md b/docs/rock5/rock5t/getting-started/interface-usage/headphone-jack.md new file mode 100644 index 000000000..c93f2b1fa --- /dev/null +++ b/docs/rock5/rock5t/getting-started/interface-usage/headphone-jack.md @@ -0,0 +1,11 @@ +--- +sidebar_position: 4 +--- + +import HEADPHONE from "../../../../common/accessories/\_headphone.mdx"; + +# 耳机接口 + +## 接口测试方法 + + diff --git a/docs/rock5/rock5t/getting-started/interface-usage/mipi-csi.md b/docs/rock5/rock5t/getting-started/interface-usage/mipi-csi.md new file mode 100644 index 000000000..d47f4656a --- /dev/null +++ b/docs/rock5/rock5t/getting-started/interface-usage/mipi-csi.md @@ -0,0 +1,62 @@ +--- +sidebar_position: 7 +--- + +import CAMERA from "../../../../common/accessories/\_camera-usage.mdx"; + +# MIPI CSI 接口 + +## 接口差异 + +- ROCK 5T 配备了两个四通道 MIPI CSI 摄像头连接器。 + +## 支持列表 + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + +
Camera NameSensor 型号分辨率
OKDO 5MP CameraOV5647500 万 像素
Radxa Camera 4KIMX415829 万 像素
Radxa Camera 8MIMX219800 万 像素
Raspberry Pi Camera V2IMX219800 万 像素
Raspberry Pi Camera v1.3OV5647500 万 像素
+ +## 配件的使用 + +:::tip + +以下两个仅作为示例，除了可能的排线和 Overlay 不同外，其他摄像头的操作步骤类似。 + +::: + +### Radxa Camera 4K + + + +### Radxa Camera 8M + + diff --git a/docs/rock5/rock5t/getting-started/interface-usage/mipi-dsi.md b/docs/rock5/rock5t/getting-started/interface-usage/mipi-dsi.md new file mode 100644 index 000000000..32fa27922 --- /dev/null +++ b/docs/rock5/rock5t/getting-started/interface-usage/mipi-dsi.md @@ -0,0 +1,48 @@ +--- +sidebar_position: 8 +--- + +import DISPLAY from "../../../../common/accessories/\_display-usage.mdx"; + +# MIPI DSI 接口 + +## 支持列表 + + + + + + + + + + + + + + + + + + + + + + +
Screen Name分辨率
ALLNET 5 inch DSI Display800 ×3(RGB) ×480 像素
Radxa Display 8 HD1280x800 像素
Radxa Display 10FHD1200x1920 像素
Raspberry Pi 7 inch Touchscreen800 x 480 像素
+ +## 配件使用 + +:::tip + +以下两个仅作为示例，除了可能的排线和 Overlay 不同外，其他屏幕的操作步骤类似。 + +::: + +### 瑞莎 8 寸 HD 高清显示屏 + + + +### 树莓派 7 寸触控显示屏 + + diff --git a/docs/rock5/rock5t/getting-started/interface-usage/pcie-m-key.md b/docs/rock5/rock5t/getting-started/interface-usage/pcie-m-key.md new file mode 100644 index 000000000..0f0ec2664 --- /dev/null +++ b/docs/rock5/rock5t/getting-started/interface-usage/pcie-m-key.md @@ -0,0 +1,34 @@ +--- +sidebar_position: 6 +--- + +import PCIe_M from "../../../../common/accessories/\_pcie-m-key.mdx"; + +# PCIe M Key + + + +## SSD 兼容列表 + +
+ +| 品牌 | 型号 | 容量 | 额定电压电流 | 测试环境 | 兼容性 | 读写速率 | 备注 | +| -------- | ---------------------- | ---------- | ------------ | ---------------- | ------------ | -------------------------------- | -------------------------------------------------- | +| 三星 | 980 EVO | 512GB | 3.3V/1.9A | Radxa OS | 可识别 | Read:1.0GB/s
Write:991MB/s | | +| 三星 | PM9A1 (MZVL2256HCHQ) | 256GB | 3.3V/2.8A | Armbian | 可识别 | Read:14.8MB/s
Write:9.72MB/s | | +| 三星 | 970 EVO Plus | 1TB | 3.3V/1.9A | Radxa OS | 可识别 | | | +| 三星 | PM983a | 1TB | 3.3V/3.9A | | **不可识别** | | | +| 金士顿 | OM8PDP3256B-A01 | 256GB | 3.3V/1A | Radxa OS | 可识别 | | | +| 金士顿 | A2000 (SA2000M8/1000G) | 1TB | 3.3V/3A | Radxa OS/Armbian | 可识别 | Read:980MB/s
Write:888MB/s | | +| 英特尔 | Optane Memory M10 | 32GB | 3.3V/1.2A | Radxa OS | 可识别 | | | +| 英特尔 | Optane Memory M10 | 16GB | 3.3V/1.2A | Radxa OS | 可识别 | | | +| 英特尔 | Optane Memory H10 | 16GB+256GB | 3.3V/2.5A | Radxa OS | 可识别 | Read:910MB/s
Write:170MB/s | 默认配置下仅可识别 16G，PCI-E 分离后可识别全部容量 | +| 影驰 | 黑将Pro | 250GB | 3.3V/1.8A | Radxa OS | 可识别 | Read:2.1GB/s
Write:680MB/s | | +| 西部数据 | SN730 | 512GB | 3.3v/2.8A | Radxa OS | 可识别 | Read:1.4GB/s
Write:670MB/s | | +| 致态 | TiPlus5000 | 512GB | 3.3V/2.5A | Radxa OS | 可识别 | | | +| 致态 | TiPlus5000 | 2TB | 3.3V/2.5A | Radxa OS/Armbian | 可识别 | Read:1.3GB/s
Write:745MB/s | | +| 致态 | TiPlus7100 | 1TB | 3.3V/2.5A | Radxa OS | 可识别 | Read:2.9GB/s
Write:2.2GB/s | | +| 宏碁 | VT500M | 256GB | | Armbian | **不可识别** | | | +| 江波龙 | XP1000 | 1TB | | | 可识别 | Read:2.0GB/s
Write:2.0GB/s | | + +
diff --git a/docs/rock5/rock5t/getting-started/interface-usage/pin-40-test.md b/docs/rock5/rock5t/getting-started/interface-usage/pin-40-test.md new file mode 100644 index 000000000..e0a0fb137 --- /dev/null +++ b/docs/rock5/rock5t/getting-started/interface-usage/pin-40-test.md @@ -0,0 +1,31 @@ +--- +sidebar_position: 10 +--- + +import GPIO from '../../../../common/dev/\_gpio.mdx'; +import I2C from '../../../../common/dev/\_i2c.mdx'; +import PWM from '../../../../common/dev/\_pwm.mdx'; +import SPI from '../../../../common/dev/\_spi.mdx'; +import UART from '../../../../common/dev/\_uart.mdx'; + +# 40-PIN 功能测试 + +## GPIO + + + +## I2C + + + +## PWM + + + +## SPI + + + +## UART + + diff --git a/docs/rock5/rock5t/getting-started/interface-usage/usb.md b/docs/rock5/rock5t/getting-started/interface-usage/usb.md new file mode 100644 index 000000000..1d46a9d8c --- /dev/null +++ b/docs/rock5/rock5t/getting-started/interface-usage/usb.md @@ -0,0 +1,9 @@ +--- +sidebar_position: 1 +--- + +import USB from "../../../../common/accessories/\_usb.mdx"; + +# USB 接口 + + diff --git a/docs/rock5/rock5t/getting-started/introduction.md b/docs/rock5/rock5t/getting-started/introduction.md new file mode 100644 index 000000000..d110485ca --- /dev/null +++ b/docs/rock5/rock5t/getting-started/introduction.md @@ -0,0 +1,127 @@ +--- +sidebar_position: 1 +description: "简单介绍 ROCK 5T" +--- + +# 产品介绍 + +## 主要特性 + +ROCK 5T 是一款基于 RK3588 芯片组的优雅单板计算机 (SBC)。其 110 x 90 mm 的尺寸几乎涵盖了 RK3588 的所有功能，提供卓越的灵活性和可扩展性。ROCK 5T为极客、单板机爱好者、物联网爱好者和高校师生等用户提供了将想法变为现实的坚实基础。它在边缘计算、人工智能、云计算、智能监控和其他领域有着广泛的应用。 + +ROCK 5T 可作为： + +- 个人桌面计算机 +- 个人私有服务器 +- 安卓影音播放器 +- 机器人控制器 +- 区块链节点 + +其他更多使用场景，等你来发掘！ + +### 接口丰富 + +ROCK 5T 提供了丰富的接口，包括多个 USB、以太网、HDMI 接口，便于连接外部设备和扩展功能。详见[参数配置](#参数配置)。 + +### 配件生态丰富 + +ROCK 5T 支持多款摄像头和显示屏。 + +### 强大的多媒体处理能力 + +支持8K视频编解码和复杂图形处理，集成 AI 加速单元，适用于高清智能电视和多媒体应用。 + +### 丰富的操作系统支持 + +支持多种操作系统，包括 Radxa 官方的发行的 Debian 系统和 Android 系统，另外还有一些第三方操作系统，如 Ubuntu/Armbian 等，适用于各类应用场景。 + +### 潜在的开发潜力 + +作为一款强大的开发平台 ROCK 5T 对于人工智能、边缘计算、嵌入式系统等领域具有较大的潜力。 + +### 开源支持 + +ROCK 5T 提供了完整的硬件设计原理图和软件源代码，这一特性使得大多 DIY 设计爱好者和开发者进行个性化修改和功能拓展，吸引了一众开源爱好者活跃在社区，有利于促进知识共享和技术创新。 + +## 主板预览 + + +rock 5t x1.0 + + +## 参数配置 + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + +
型号ROCK 5T
SoCRockchip RK3588
CPU四大核 Cortex‑A76 频率最高达 2.4GHz
四小核 Cortex‑A55 主频最大为 1.8GHz
GPUMali G610MP4 GPU，支持 OpenGLES 1.1/2.0/3.2
OpenCL 1.1/1.2/2.2
Vulkan 1.1 和 1.2
NPUNPU 支持 INT4/INT8/INT16/FP16/BF16 和 TF32 加速，计算能力高达 6TOPs
内存4/8/16/24/32 64 位 LPDDR5
存储板载 eMMC 模块：32/64/128/256 GB
microSD 存储卡
显示可通过两个 HDMI、一个 DP（C 型）和一个 MIPI DSI 提供 4 路显示输出
分辨率高达 3x 4K@60FPS + 1x 1080P@60FPS 或者 1x 8K@60FPS + 1x 4K@60FPS + 1x 1080P@60FPS
1x 标准 HDMI 输入端口，最高支持 4Kp60 显示输入
硬件编解码H.265/H.264/AV1/AVS2 硬件解码高达 8K@60fps
H.265/H.264 硬件编码高达 8K@30fps
以太网10/100/1000/2500M 以太网（支持 POE ）
PoE 需要额外的可选 HAT
板载 WIFI配备板载 WiFi Realtek 8852BE
M.2M.2 B Key 连接器，可提供 USB 信号并支持 4G 模块。通过使用 SIM 卡，可方便地连接移动网络。
M.2 M Key 连接器，共提供两个双通道 PCIe 3.0 接口，标准的 M.2 2280 安装孔，可以安装 M.2 2280 NVMe 固态硬盘。值得注意的是，不支持 M.2 SATA 固态硬盘。
USB2x USB 2 端口
2x USB 3 HOST 端口
1x USB-C 端口
摄像头2 个摄像头端口（2 个四通道 MIPI CSI 或 2 个双通道 MIPI CSI）
PDM1 个PDM接口，支持双通道阵列麦克风
其他40 针扩展座
供电支持 9V/2A、12V/2A、15V/2A 和 20V/2A 的 USB Type-C PD 2.0
USB Type-C 端口上固定电压为 5V 至 20V 的电源适配器
向 GPIO PIN 2 和 4 提供 5V 电源
尺寸110mm x 90 mm
diff --git a/docs/rock5/rock5t/getting-started/power-supply.md b/docs/rock5/rock5t/getting-started/power-supply.md new file mode 100644 index 000000000..58a5939d3 --- /dev/null +++ b/docs/rock5/rock5t/getting-started/power-supply.md @@ -0,0 +1,16 @@ +--- +sidebar_position: 7 +description: "ROCK 5T 的供电详情" +--- + +# 电源选择 + +ROCK 5T 支持多种供电技术，包括智能电源适配器和固定电压： + +- USB Type-C PD 2.0 版，9V/2A、12V/2A、15V/2A 和 20V/2A + +- USB C 接头，直出 5V 到 20V 之间任意固定电压的适配器，功率大于 40W。例如 12V/4A USB C 接头直出的适配器。 + +- 5V 电源应用于 GPIO PIN 2 和 4 + +电源适配器推荐使用官方的 [瑞莎 PD65W 适配器](/accessories/pd_65w)。 diff --git a/docs/rock5/rock5t/getting-started/quick-start.md b/docs/rock5/rock5t/getting-started/quick-start.md new file mode 100644 index 000000000..999add82c --- /dev/null +++ b/docs/rock5/rock5t/getting-started/quick-start.md @@ -0,0 +1,49 @@ +--- +sidebar_position: 2 +description: "快速上手 ROCK 5T，让您能够轻松开始使用和探索其功能。" +--- + +# 快速上手 + +## 包装清单 + +rock 5T overview + +ROCK 5T 标准包装包括以下物品：- ROCK 5T 主板 - Wi-FI 天线 + +要启动 ROCK 5T，您还需要一下设备： + +- 一个充电器(推荐使用 PD 充电器)。ROCK 5T 还支持 PoE 供电。更过供电详情，请参考[电源方案](./power-supply)。 +- 一个 HDMI 线和一个支持 HDMI 的显示器，推荐分辨率为 1080P 或更高，4K / 8K 显示器将提供最佳体验。 +- 一套 USB 鼠标和键盘，常见的 USB 输入设备均支持即插即用。 +- 一根网线，更新系统时需要联网。 + +非必需但可增强 ROCK 5T 基本功能的外设：（待更新） + +- 散热器，参考[散热器选型](./interface-usage/fan)来安装散热器 + +## 安装操作系统 + +参考[安装系统](./install-os/) 部分安装操作系统。 + +## 接线和上电 + +1. 通过 HDMI 线将 ROCK 5T 的任一 HDMI 输出接口连接到 HDMI 显示器。 + +rock5T hdmi + +2. 将 USB 鼠标和键盘连接到 ROCK 5T 的任一 USB 2.0 或 3.0 接口。 + +rock5T usb + +3. 将网线连接到以太网口。 + +rock5T ethernet + +4. 将电源适配器插入 ROCK 5T 的电源接口。设备上电，电源指示灯显示绿色，启动正常后，指示灯开始闪烁。 + +rock5T pwr + +:::tip +系统从上电到开机启动，整个过程持续约 40 秒，然后进入系统桌面。 +::: diff --git a/docs/rock5/rock5t/hardware-design/README.md b/docs/rock5/rock5t/hardware-design/README.md new file mode 100644 index 000000000..4a5ea9d6e --- /dev/null +++ b/docs/rock5/rock5t/hardware-design/README.md @@ -0,0 +1,9 @@ +--- +sidebar_position: 6 +--- + +# 硬件信息 + +介绍 ROCK 5T 硬件信息，例如各种接口说明，板级硬件的资料下载，使用的器件的数据手册等等。 + + diff --git a/docs/rock5/rock5t/hardware-design/hardware-interface.md b/docs/rock5/rock5t/hardware-design/hardware-interface.md new file mode 100644 index 000000000..d2fe596ac --- /dev/null +++ b/docs/rock5/rock5t/hardware-design/hardware-interface.md @@ -0,0 +1,88 @@ +--- +sidebar_position: 1 +description: "详细介绍 ROCK 5T 硬件信息" +--- + +# 硬件接口说明 + +## 芯片框图 + +rk3588 system diagram + +## 实物照片 + +rock 5t overview + +## 接口详情 + +### FAN Header + +### GPIO + +- GPIO 电压 + +| GPIO | 电压 | 最高 | +| ---------- | ---- | ----- | +| 所有的GPIO | 3.3V | 3.63V | +| SARADC_IN4 | 3.3V | 1.8V | + +- GPIO Pinout + + +
+ + | GPIO number | Function8 | Function7 | Function6 | Function5 | Function4 | Function3 | Function2 | Function1 | Pin# | Pin# | Function1 | Function2 | Function3 | Function4 | Function5 | Function6 | Function7 | Function8 | GPIO number | + | :---------: | :---------: | :----------: | :----------: | :---------: | :-----------: | :---------: | :--------: | :-------: | :------------------------------: | :-----------------------------: | :--------: | :--------: | :--------: | :---------------------------------------: | :---------: | :----------: | :----------: | :-------: | :---------: | + | | | | | | | | | +3.3V |
1
|
2
| +5.0V | | | | | | | | | + | 139 | | | I2S1_SDO2_M0 | I2C7_SDA_M3 | UART8_CTSN_M0 | PWM15_IR_M1 | CAN1_TX_M1 | GPIO4_B3 |
3
|
4
| +5.0V | | | | | | | | | + | 138 | | | I2S1_SDO1_M0 | I2C7_SCL_M3 | UART8_RTSN_M0 | PWM14_M1 | CAN1_RX_M1 | GPIO4_B2 |
5
|
6
| GND | | | | | | | | | + | 115 | | SPI1_CS1_M1 | | I2C8_SDA_M4 | UART7_CTSN_M1 | PWM15_IR_M0 | | GPIO3_C3 |
7
|
8
| GPIO0_B5 | | |
UART2_TX_M0
| I2C1_SCL_M0 | I2S1_MCLK_M1 | | | 13 | + | | | | | | | | | GND |
9
|
10
| GPIO0_B6 | | |
UART2_RX_M0
| I2C1_SDA_M0 | I2S1_SCLK_M1 | | | 14 | + | 113 | | SPI1_CLK_M1 | | | UART7_RX_M1 | | | GPIO3_C1 |
11
|
12
| GPIO3_B5 | CAN1_RX_M0 | PWM12_M0 | UART3_TX_M1 | | I2S2_SCLK_M1 | | | 109 | + | 111 | | SPI1_MOSI_M1 | | I2C3_SCL_M1 | | | | GPIO3_B7 |
13
|
14
| GND | | | | | | | | | + | 112 | | SPI1_MISO_M1 | | I2C3_SDA_M1 | UART7_TX_M1 | | | GPIO3_C0 |
15
|
16
| GPIO3_A4 | | | | | | | | 100 | + | | | | | | | | | +3.3V |
17
|
18
| GPIO4_C4 | | PWM5_M2 | | | | SPI3_MISO_M0 | | 148 | + | 42 | | SPI0_MOSI_M2 | | | UART4_RX_M2 | | | GPIO1_B2 |
19
|
20
| GND | | | | | | | | | + | 41 | | SPI0_MISO_M2 | | | | | | GPIO1_B1 |
21
|
22
| SARADC_IN4 | | | | | | | | | + | 43 | | SPI0_CLK_M2 | | | UART4_TX_M2 | | | GPIO1_B3 |
23
|
24
| GPIO1_B4 | | | UART7_RX_M2 | | | SPI0_CS0_M2 | | 44 | + | | | | | | | | | GND |
25
|
26
| GPIO1_B5 | | | UART7_TX_M2 | | | SPI0_CS1_M2 | | 45 | + | 150 | | SPI3_CLK_M0 | | I2C0_SDA_M1 | | PWM7_IR_M3 | | GPIO4_C6 |
27
|
28
| GPIO4_C5 | | PWM6_M2 | | I2C0_SCL_M1 | | SPI3_MOSI_M0 | | 149 | + | 35 | | | | I2C4_SCL_M3 | | PWM1_M2 | | GPIO1_A3 |
29
|
30
| GND | | | | | | | | | + | 34 | | | | I2C4_SDA_M3 | | PWM0_M2 | | GPIO1_A2 |
31
|
32
| GPIO3_C2 | | PWM14_M0 | UART7_RTSN_M1 | I2C8_SCL_M4 | | SPI1_CS0_M1 | | 114 | + | 103 | | | | | | PWM8_M0 | | GPIO3_A7 |
33
|
34
| GND | | | | | | | | | + | 110 | | | I2S2_LRCK_M1 | | UART3_RX_M1 | PWM13_M0 | CAN1_TX_M0 | GPIO3_B6 |
35
|
36
| GPIO3_B1 | | PWM2_M1 | UART2_TX_M2 | | | | | 105 | + | | | | | | | | | GPIO0_A0 |
37
|
38
| GPIO3_B2 | | PWM3_IR_M1 | UART2_RX_M2 | | I2S2_SDI_M1 | | | 106 | + | | | | | | | | | GND |
39
|
40
| GPIO3_B3 | | | UART2_RTSN | | I2S2_SDO_M1 | | | 107 | + +
+ + +### Gigabit Ethernet + +### Maskrom Button + +### MIPI CSI + +### MIPI DSI + +### PCIe + +### POE + +### TF Card Slot + +| Pin# | Name | +| :--: | :----------- | +| 1 | SDMMC0_D2 | +| 2 | SDMMC0_D3 | +| 3 | SDMMC0_CMD | +| 4 | VCC3V3_SYS | +| 5 | SDMMC0_CLK | +| 6 | GND | +| 7 | SDMMC0_D0 | +| 8 | SDMMC0_D1 | +| 9 | SDMMC0_DET_L | +| 10 | GND | +| 11 | GND | +| 12 | GND | +| 13 | GND | diff --git a/docs/rock5/rock5t/low-level-dev/README.md b/docs/rock5/rock5t/low-level-dev/README.md new file mode 100644 index 000000000..817ef793b --- /dev/null +++ b/docs/rock5/rock5t/low-level-dev/README.md @@ -0,0 +1,9 @@ +--- +sidebar_position: 7 +--- + +# 底层开发 + +主要介绍 uboot, kernel, debian os 编译打包等内容 + + diff --git a/docs/rock5/rock5t/low-level-dev/kernel.md b/docs/rock5/rock5t/low-level-dev/kernel.md new file mode 100644 index 000000000..b215aef3b --- /dev/null +++ b/docs/rock5/rock5t/low-level-dev/kernel.md @@ -0,0 +1,10 @@ +--- +sidebar_position: 3 +description: "用 Radxa BSP 工具，轻松构建个性化 Linux 内核，享受定制化硬件开发的乐趣" +--- + +import KERNEL from '../../../common/dev/\_kernel.mdx' + +# Kernel 开发 + + diff --git a/docs/rock5/rock5t/low-level-dev/maskrom/README.md b/docs/rock5/rock5t/low-level-dev/maskrom/README.md new file mode 100644 index 000000000..890785bb5 --- /dev/null +++ b/docs/rock5/rock5t/low-level-dev/maskrom/README.md @@ -0,0 +1,7 @@ +--- +sidebar_position: 1 +--- + +# 通过 USB 刷机 + + diff --git a/docs/rock5/rock5t/low-level-dev/maskrom/erase.md b/docs/rock5/rock5t/low-level-dev/maskrom/erase.md new file mode 100644 index 000000000..3e50b467d --- /dev/null +++ b/docs/rock5/rock5t/low-level-dev/maskrom/erase.md @@ -0,0 +1,21 @@ +--- +sidebar_position: 4 +description: "通过 Maskrom 清除 eMMC 或者 SPI Flash" +--- + +import ERASE from "../../../../common/dev/\_erase-spi-emmc.mdx"; + +# 清除 eMMC 或者 SPI Flash + + + + +
    +
  1. 拔出 microSD 卡和电源线
    2. +
  2. 按住 Maskrom button
    3. +
  3. 将 USB A-C 电缆插入 ROCK 5T 的 Type-C 端口，另一端插入电脑，给 ROCK 5T 上电，此时正常情况下会进入 Maskrom 状态
    4. +
+ rock 5b maskrom wire + + + diff --git a/docs/rock5/rock5t/low-level-dev/maskrom/linux.md b/docs/rock5/rock5t/low-level-dev/maskrom/linux.md new file mode 100644 index 000000000..b9f795fb6 --- /dev/null +++ b/docs/rock5/rock5t/low-level-dev/maskrom/linux.md @@ -0,0 +1,26 @@ +--- +sidebar_position: 1 +description: "Linux 下通过 USB 刷机" +--- + +import Rkdeveloptool from "../../../../common/dev/\_rkdeveloptoolV2.mdx"; +import Images from "../../\_image.mdx" + +# Linux 主机 + +## 文件下载 + + + + + + +
    +
  1. 拔出 microSD 卡和电源线
    2. +
  2. 按住 Maskrom button
    3. +
  3. 将 USB A-C 电缆插入 ROCK 5T 的 Type-C 端口，另一端插入电脑，给 ROCK 5T 上电，此时正常情况下会进入 Maskrom 状态
    4. +
+ rock 5t maskrom wire + + + diff --git a/docs/rock5/rock5t/low-level-dev/maskrom/mac-os.md b/docs/rock5/rock5t/low-level-dev/maskrom/mac-os.md new file mode 100644 index 000000000..f34a7b063 --- /dev/null +++ b/docs/rock5/rock5t/low-level-dev/maskrom/mac-os.md @@ -0,0 +1,26 @@ +--- +sidebar_position: 2 +description: "MacOS 下通过 USB 刷机" +--- + +import Rkdeveloptool from "../../../../common/dev/\_rkdeveloptoolV2.mdx"; +import Images from "../../\_image.mdx" + +# Mac OS 主机 + +## 文件下载 + + + + + + +
    +
  1. 拔出 microSD 卡和电源线
    2. +
  2. 按住 Maskrom button
    3. +
  3. 将 USB A-C 电缆插入 ROCK 5T 的 Type-C 端口，另一端插入电脑，给 ROCK 5T 上电，此时正常情况下会进入 Maskrom 状态
    4. +
+ rock 5t maskrom wire + + + diff --git a/docs/rock5/rock5t/low-level-dev/maskrom/windows.md b/docs/rock5/rock5t/low-level-dev/maskrom/windows.md new file mode 100644 index 000000000..a85e2219f --- /dev/null +++ b/docs/rock5/rock5t/low-level-dev/maskrom/windows.md @@ -0,0 +1,26 @@ +--- +sidebar_position: 3 +description: "Windows 下通过 USB 刷机" +--- + +import Rkdevtool from "../../../../common/dev/\_rkdevtoolV2.mdx"; +import Images from "../../\_image.mdx" + +# Windows 主机 + +## 文件下载 + + + + + + +
    +
  1. 拔出 microSD 卡和电源线
    2. +
  2. 按住 Maskrom button
    3. +
  3. 将 USB A-C 电缆插入 ROCK 5T 的 Type-C 端口，另一端插入电脑，给 ROCK 5T 上电，此时正常情况下会进入 Maskrom 状态
    4. +
+ rock 5t maskrom wire + + + diff --git a/docs/rock5/rock5t/low-level-dev/overlays.md b/docs/rock5/rock5t/low-level-dev/overlays.md new file mode 100644 index 000000000..c89468fc4 --- /dev/null +++ b/docs/rock5/rock5t/low-level-dev/overlays.md @@ -0,0 +1,10 @@ +--- +sidebar_position: 7 +description: "轻松构建个性化 Overlay，享受定制化硬件开发的乐趣" +--- + +import Overlays from '../../../common/dev/\_radxa-overlays.mdx' + +# Overlays 开发 + + diff --git a/docs/rock5/rock5t/low-level-dev/rbuild.md b/docs/rock5/rock5t/low-level-dev/rbuild.md new file mode 100644 index 000000000..d0e34bbf3 --- /dev/null +++ b/docs/rock5/rock5t/low-level-dev/rbuild.md @@ -0,0 +1,10 @@ +--- +sidebar_position: 4 +description: "使用 rbuild 工具定制您的系统" +--- + +import RBUILD from '../../../common/dev/\_rbuild.mdx' + +# 编译 RadxaOS + + diff --git a/docs/rock5/rock5t/low-level-dev/u-boot.md b/docs/rock5/rock5t/low-level-dev/u-boot.md new file mode 100644 index 000000000..bee2f709e --- /dev/null +++ b/docs/rock5/rock5t/low-level-dev/u-boot.md @@ -0,0 +1,10 @@ +--- +sidebar_position: 2 +description: "用 Radxa BSP 工具，轻松构建个性化 U-boot，开启智能硬件的创新之旅" +--- + +import UBOOT from '../../../common/dev/\_u-boot.mdx' + +# U-boot 开发 + + diff --git a/docs/rock5/rock5t/other-os/README.md b/docs/rock5/rock5t/other-os/README.md new file mode 100644 index 000000000..ef1565c51 --- /dev/null +++ b/docs/rock5/rock5t/other-os/README.md @@ -0,0 +1,9 @@ +--- +sidebar_position: 8 +--- + +# 其他系统 + +介绍非 Radxa OS 的其他系统，例如 Android + + diff --git a/docs/rock5/rock5t/other-os/android/README.md b/docs/rock5/rock5t/other-os/android/README.md new file mode 100644 index 000000000..bb914f8ff --- /dev/null +++ b/docs/rock5/rock5t/other-os/android/README.md @@ -0,0 +1,9 @@ +--- +sidebar_position: 7 +--- + +# Android 系统 (待更新) + +主要介绍系统如何使用 + + diff --git a/docs/rock5/rock5t/other-os/android/download.md b/docs/rock5/rock5t/other-os/android/download.md new file mode 100644 index 000000000..eb09d911c --- /dev/null +++ b/docs/rock5/rock5t/other-os/android/download.md @@ -0,0 +1,15 @@ +--- +sidebar_position: 5 +--- + +# 资源下载汇总 + +## 硬件设计 + +## 刷机工具 + +## 操作系统镜像 + +[ROCK 5B Android 12](https://github.com/radxa/manifests/releases/download/Android12_rkr14_20240419/Rock5B_Android12_rkr14_20240419-gpt.zip) + +## 质量认证 diff --git a/docs/rock5/rock5t/other-os/android/install-os.md b/docs/rock5/rock5t/other-os/android/install-os.md new file mode 100644 index 000000000..5899910d7 --- /dev/null +++ b/docs/rock5/rock5t/other-os/android/install-os.md @@ -0,0 +1,120 @@ +--- +sidebar_position: 2 +title: 系统安装 +--- + +import Etcher from '../../../../common/general/\_etcher.mdx' + +本文档将介绍如何把 Android 镜像安装到 ROCK 5B。 + +ROCK 5B 可以从 microSD 卡启动，也可以从 EMMC 启动，基于不同的启动方式，安装系统到不同的介质上. + + + + + +# 安装操作系统 + +## 准备工作 + +- 1x microSD 卡(容量 >=8GB) +- 1x microSD 读卡器 +- 5V 电源适配器 (推荐使用 [Radxa Power PD30W](/accessories/pd_30w)) + +## 镜像下载 + +请到 [资源下载汇总](./download) 下载对应的镜像文件 + +## 安装系统 + + + +## 启动系统 + +- 按照上述步骤成功烧录 microSD 卡后，将 microSD 卡插入 Radxa ROCK 5B 的 MicroSD 插槽内。 +- Radxa ROCK 5B 的供电接口为 [USB 2.0 OTG Type C port](/rock5/rock5b/hardware-design/hardware-interface)，请使用 Type-C 线缆连接供电口和适配器。 + +:::tip +ROCK 5B 支持 9V/2A、12V/2A、15V/2A 和 20V/2A 的 USB Type-C PD 2.0。瑞莎推荐使用 [Radxa Power PD30W](/accessories/pd_30w)。 +::: + +## 参考文档 + + + + + +## 准备工作 + +### 准备安装介质 + +- micro usb 转 typea usb 接口线缆 + +### 镜像下载 + +请到 [资源下载汇总](./download) 下载对应的镜像文件 + +## 系统安装 + +### 系统安装 + +1. 将micro usb 线缆连接到主机 + +2. 进入 maskrom 模式 + +- 断开开发板电源 +- 移除 SD 卡，并插入 eMMC 模块 +- 用 USB A-A 连接 Radxa ROCK 5B 的 USB3.0 口 和 PC 端 +- 短接下面引脚 +- 给开发板上电 +- 摘下右边的黄色跳线帽，保留左边的黄色跳线帽 + +ROCK 5B maskrom + +- 查看是否有 USB 设备 + - Linux/macOS: 检查执行 lsusb 后是否有显示 "Bus 001 Device 112: ID 2207:350a Fuzhou Rockchip Electronics Company" + - Windows: 打开 RKDevTool 您会看到设备处于 "maskrom mode". + ROCK 5B select loader bin + + + + + +#### Linux 系统使用 rkdeveloptool 写入 + +[rkdeveloptool](../../low-level-dev/maskrom/linux) + + + + + +#### Mac 系统使用 rkdeveloptool 写入 + +[rkdeveloptool](../../low-level-dev/maskrom/mac-os) + + + + + +#### Windows 系统使用 rkdevetool 写入 + +[rkdevtool](/rock5/rock5b/low-level-dev/maskrom/windows) + + + + + +## 系统启动 + +### 启动 ROCK 5B + +1. 通过适配器为 ROCK 5B 供电 +2. ROCK 5B 将在绿色电源 LED 亮起的情况下启动 + + + + + +## 常见问题 + +## 参考文档 diff --git a/docs/rock5/rock5t/other-os/android/low-level-dev.md b/docs/rock5/rock5t/other-os/android/low-level-dev.md new file mode 100644 index 000000000..84bf56bd8 --- /dev/null +++ b/docs/rock5/rock5t/other-os/android/low-level-dev.md @@ -0,0 +1,166 @@ +--- +sidebar_position: 4 +--- + +# 底层开发 + +主要介绍 uboot, kernel, aosp 编译打包等内容 + +## 环境配置 + +为了规避 Android 编译过程中因为环境配置出问题，提高开发效率，我们引入了Docker这一工具。 + +### Docker + +Docker是一个开源的应用容器引擎，可以帮助开发者更有效地构建、部署和管理应用程序。 + +Dockerfile 是一个构建 Docker 镜像的文本文件，可以根据以下内容构建编译 Android 所需环境。 + +``` + FROM ubuntu:xenial + + RUN apt-get update -y && apt-get install -y openjdk-8-jdk python git-core gnupg flex bison gperf build-essential \ + zip curl liblz4-tool zlib1g-dev gcc-multilib g++-multilib libc6-dev-i386 \ + lib32ncurses5-dev x11proto-core-dev libx11-dev lib32z-dev ccache \ + libgl1-mesa-dev libxml2-utils xsltproc unzip mtools u-boot-tools \ + htop iotop sysstat iftop pigz bc device-tree-compiler lunzip \ + dosfstools vim-common parted udev libssl-dev python3 python-pip lzop swig + + #### For China + RUN curl https://mirrors.tuna.tsinghua.edu.cn/git/git-repo > /usr/local/bin/repo && \ + chmod +x /usr/local/bin/repo && \ + which repo + ENV REPO_URL='https://mirrors.tuna.tsinghua.edu.cn/git/git-repo/' + #### For China End + + RUN pip install pycrypto + ENV USER=android12-docker + ARG USER_ID=0 + ARG GROUP_ID=0 + RUN groupadd -g ${GROUP_ID} jenkins-docker && useradd -m -g jenkins-docker -u ${USER_ID} android12-docker + + USER android12-docker + +``` + +#### 构建 Docker 镜像 + +```bash + + radxa$ docker build -t android-builder:12.x --build-arg USER_ID=`id -u` --build-arg GROUP_ID=`id -g` $(which-dir-dockerfile-in) + +``` + +### Repo + +Repo 是 Android 开发中用于管理多个 Git 仓库的工具，它是一个Python脚本，方便开发者对多个 Git 库进行版本控制和管理。 + +#### Repo下载 + +```bash + + radxa$ docker build -t android-builder:12.x --build-arg USER_ID=`id -u` --build-arg GROUP_ID=`id -g` $(which-dir-dockerfile-in) + +``` + +## 源码下载 + +```bash + +$ repo init -u https://github.com/radxa/manifests.git -b Android12_Radxa_rk14 -m rockchip-s-release.xml +$ repo sync -d -c -j4 + +``` + +## 镜像编译 + +镜像编译可以使用两种方法 + +### 方法一 (**推荐**) + +使用 SDK 编译脚本方式编译 + +```bash +radxa:rock-android12 $ source build/envsetup.sh +radxa:rock-android12 $ lunch RadxaRock5B-userdebug +radxa:rock-android12 $ ./build.sh -UACKup +# get images from IMAGE directory +``` + +等待编译完成就可以在 IMAGE 目录找到镜像 + +### 方法二 + +可以根据这个方法一步一步编译镜像 + +1. 设置编译项目的环境 + +```bash +radxa:rock-android12 $ export PRODUCT_NAME="RadxaRock5B" +radxa:rock-android12 $ export PRODUCT_UBOOT_CONFIG="rk3588" +radxa:rock-android12 $ export PRODUCT_KERNEL_CONFIG="rockchip_defconfig" +radxa:rock-android12 $ export PRODUCT_KERNEL_DTS="rk3588-rock-5b" +``` + +2. 编译 U-boot + +```bash +android12 $ cd u-boot +android12/u-boot $ make clean +android12/u-boot $ make mrproper +android12/u-boot $ make distclean +android12/u-boot $ ./make.sh ${PRODUCT_UBOOT_CONFIG} +android12 $ cd - +``` + +3. 编译内核 + +```bash +radxa:rock-android12 $ cd kernel-5.10 +radxa:rock-android12/kernel-5.10 $ export PATH=../prebuilts/clang/host/linux-x86/clang-r416183b/bin:$PATH +radxa:rock-android12/kernel-5.10 $ alias msk='make CROSS_COMPILE=aarch64-linux-gnu- LLVM=1 LLVM_IAS=1' +radxa:rock-android12/kernel-5.10 $ msk ARCH=arm64 rockchip_defconfig android-11.config rock5b.config +radxa:rock-android12/kernel-5.10 $ msk ARCH=arm64 BOOT_IMG=../rockdev/Image-RadxaRock5B/boot.img rk3588-rock-5b.img + +radxa:rock-android12 $ cd - +``` + +4. 编译AOSP + +```bash +android12 $ source build/envsetup.sh +android12 $ lunch ${PRODUCT_NAME}-userdebug +android12 $ make -j$(nproc) +``` + +5. 制作 Images + +```bash +android12 $ rm -rf rockdev +android12 $ ln -s RKTools/linux/Linux_Pack_Firmware/rockdev . +android12 $ ./mkimage.sh +``` + +6. 打包 Image + +```bash +android12 $ cd rockdev +android12/rockdev $ rm -rf Image +android12/rockdev $ ln -s Image-${PRODUCT_NAME} Image +``` + +- 打包成 RK update 格式镜像 + +``` +radxa:rock-android12/rockdev $ ./mkupdate.sh rk3588 Image +``` + +在 rockdev/ 目录下生成了 update.img + +- 打包成 GPT 格式镜像 + +``` +android12/rockdev $ ./android-gpt.sh +``` + +## 常见问题 diff --git a/docs/rock5/rock5t/other-os/android/preparation.md b/docs/rock5/rock5t/other-os/android/preparation.md new file mode 100644 index 000000000..e51252a52 --- /dev/null +++ b/docs/rock5/rock5t/other-os/android/preparation.md @@ -0,0 +1,39 @@ +--- +sidebar_position: 1 +--- + +# 准备工作 + +## 开发准备 + +### 供电 + +:::tip +ROCK 5B 支持 9V/2A、12V/2A、15V/2A 和 20V/2A 的 USB Type-C PD 2.0。瑞莎推荐使用 [Radxa Power PD30W](/accessories/pd_30w)。 +::: + +### 存储 + +microSD 卡，容量不小于 8GB, 用于系统启动盘 + +### microSD 读卡器 + +用于制作系统启动盘 + +### 显示 + +### 网络连接 + +### Type-C Hub + +用于 USB 口接口扩展，可外接类似 USB 鼠标, USB 键盘等设备 + +### USB 鼠标 + +### USB 键盘 + +## 常见问题 + +## 注意事项 + +## 参考文档 diff --git a/docs/rock5/rock5t/other-os/android/remote-login.md b/docs/rock5/rock5t/other-os/android/remote-login.md new file mode 100644 index 000000000..d9a8be5bd --- /dev/null +++ b/docs/rock5/rock5t/other-os/android/remote-login.md @@ -0,0 +1,29 @@ +--- +sidebar_position: 3 +--- + +import Serial from "../../../../common/general/\_serial.mdx" + +# 远程登录 + +本章节旨在向需要通过个人电脑（PC）远程访问 SBC 的用户介绍如何通过串口、adb 等方式进行远程登录 + +## 串口登录 + + + +## Adb 登录 + +ADB是一个连接 Android 设备与电脑的桥梁，用于在电脑上对 Android 设备进行全面的操作和管理。 + +### 有线登录 + +#### 要求 + +#### 步骤 + +### 无线登录 + +Android 11 版本以后支持无线 ADB 。 + +#### 要求 diff --git a/docs/rock5/rock5t/other-os/wor.md b/docs/rock5/rock5t/other-os/wor.md new file mode 100644 index 000000000..dcc998c3a --- /dev/null +++ b/docs/rock5/rock5t/other-os/wor.md @@ -0,0 +1,6 @@ +--- +sidebar_position: 10 +description: "带您在 ROCK 5 系列上安装 Windows On Arm" +--- + +# Windows on R （等待支持） diff --git a/docs/rock5/rock5t/other-os/yocto.md b/docs/rock5/rock5t/other-os/yocto.md new file mode 100644 index 000000000..c7ad877b0 --- /dev/null +++ b/docs/rock5/rock5t/other-os/yocto.md @@ -0,0 +1,10 @@ +--- +sidebar_position: 10 +description: "Yocto 构建" +--- + +# Yocto 构建 + +import RKYocto from '../../../common/yocto/\_yocto-rockchip.mdx'; + + diff --git a/docs/rock5/rock5t/radxa-os/README.md b/docs/rock5/rock5t/radxa-os/README.md new file mode 100644 index 000000000..fc15925d5 --- /dev/null +++ b/docs/rock5/rock5t/radxa-os/README.md @@ -0,0 +1,11 @@ +--- +sidebar_position: 3 +--- + +# 瑞莎系统 + +瑞莎系统，即 Radxa OS，是由 Radxa 团队基于 Debian Linux 发行版自主研发的一套开源操作系统。Radxa OS 不仅集成了众多外设和实用的系统软件，能满足日常的办公、学习和娱乐需求，而且 Radxa 团队还自行开发了 [Rsetup](/rock5/rock5a/radxa-os/rsetup) 这款便捷的系统配置工具，进一步简化了用户的操作流程。 + +
+ + diff --git a/docs/rock5/rock5t/radxa-os/ap.md b/docs/rock5/rock5t/radxa-os/ap.md new file mode 100644 index 000000000..048101b55 --- /dev/null +++ b/docs/rock5/rock5t/radxa-os/ap.md @@ -0,0 +1,10 @@ +--- +sidebar_position: 13 +description: "您可以通过连接 WIFI 上网！" +--- + +import AP from "../../../common/radxa-os/\_ap.mdx"; + +# Wi-Fi 热点 + + diff --git a/docs/rock5/rock5t/radxa-os/autologin.md b/docs/rock5/rock5t/radxa-os/autologin.md new file mode 100644 index 000000000..570060b34 --- /dev/null +++ b/docs/rock5/rock5t/radxa-os/autologin.md @@ -0,0 +1,10 @@ +--- +sidebar_position: 1 +description: "您可以将系统配置为无需输入密码即可自动登录！" +--- + +import AutoLogin from "../../../common/radxa-os/\_autologin.mdx"; + +# 自动登录 + + diff --git a/docs/rock5/rock5t/radxa-os/backup.md b/docs/rock5/rock5t/radxa-os/backup.md new file mode 100644 index 000000000..324b33364 --- /dev/null +++ b/docs/rock5/rock5t/radxa-os/backup.md @@ -0,0 +1,10 @@ +--- +sidebar_position: 2 +description: "通过脚本将您的操作系统备份成 .img 格式的镜像" +--- + +import Backup from "../../../common/radxa-os/\_backup-os.mdx"; + +# 备份系统 + + diff --git a/docs/rock5/rock5t/radxa-os/bootparam.md b/docs/rock5/rock5t/radxa-os/bootparam.md new file mode 100644 index 000000000..43185c498 --- /dev/null +++ b/docs/rock5/rock5t/radxa-os/bootparam.md @@ -0,0 +1,10 @@ +--- +sidebar_position: 10 +description: "修改 Linux 内核启动参数" +--- + +import Bootparam from "../../../common/radxa-os/\_bootparam.mdx"; + +# 启动参数 + + diff --git a/docs/rock5/rock5t/radxa-os/display.md b/docs/rock5/rock5t/radxa-os/display.md new file mode 100644 index 000000000..1f87546b9 --- /dev/null +++ b/docs/rock5/rock5t/radxa-os/display.md @@ -0,0 +1,10 @@ +--- +sidebar_position: 3 +description: "在有显示器的情况下进行显示相关设置" +--- + +import Display from "../../../common/radxa-os/\_display.mdx"; + +# 显示设置 + + diff --git a/docs/rock5/rock5t/radxa-os/headless.md b/docs/rock5/rock5t/radxa-os/headless.md new file mode 100644 index 000000000..b6da71514 --- /dev/null +++ b/docs/rock5/rock5t/radxa-os/headless.md @@ -0,0 +1,10 @@ +--- +sidebar_position: 4 +description: "没有键盘或显示器的情况下使用系统" +--- + +import Headless from "../../../common/radxa-os/\_headless.mdx"; + +# 无屏模式 + + diff --git a/docs/rock5/rock5t/radxa-os/mali-gpu.md b/docs/rock5/rock5t/radxa-os/mali-gpu.md new file mode 100644 index 000000000..926b936eb --- /dev/null +++ b/docs/rock5/rock5t/radxa-os/mali-gpu.md @@ -0,0 +1,10 @@ +--- +sidebar_position: 15 +description: "帮助您开启 Mali GPU 驱动" +--- + +import Mali from "../../../common/radxa-os/\_mali-gpu.mdx"; + +# 切换 GPU 驱动 + + diff --git a/docs/rock5/rock5t/radxa-os/media.md b/docs/rock5/rock5t/radxa-os/media.md new file mode 100644 index 000000000..2790644ad --- /dev/null +++ b/docs/rock5/rock5t/radxa-os/media.md @@ -0,0 +1,17 @@ +--- +sidebar_position: 5 +description: "音视频相关设置" +--- + +import Audio from "../../../common/radxa-os/\_audio.mdx"; +import Video from "../../../common/radxa-os/\_video.mdx"; + +# 多媒体 + +## 音频管理 + +