diff --git a/docs/Home.md b/docs/Home.md index 49375eee6..fa9a0824c 100644 --- a/docs/Home.md +++ b/docs/Home.md @@ -119,11 +119,11 @@ sidebar_custom_props: { products_name: "ROCK 4A", products_photo_url: "/home/product-pictures/rock4a.webp", - products_link: "/rock4/rock4ab", + products_link: "/rock4/rock4ab-se", docs: [ { - docs_link: "/rock4/rock4ab", + docs_link: "/rock4/rock4ab-se", docs_photo_type: "Overview", docs_name_en: "Overview", docs_name_zh: "ROCK 4A 概览", @@ -135,11 +135,11 @@ sidebar_custom_props: { products_name: "ROCK 4B", products_photo_url: "/home/product-pictures/rock4b.webp", - products_link: "/rock4/rock4ab", + products_link: "/rock4/rock4ab-se", docs: [ { - docs_link: "/rock4/rock4ab", + docs_link: "/rock4/rock4ab-se", docs_photo_type: "Overview", docs_name_en: "Overview", docs_name_zh: "ROCK 4B 概览", @@ -167,7 +167,7 @@ sidebar_custom_props: { products_name: "ROCK 4SE", products_photo_url: "/home/product-pictures/rock4se.webp", - products_link: "/rock4/rock4se", + products_link: "/rock4/rock4ab-se", docs: [ { diff --git a/docs/common/accessories/_ethernet.mdx b/docs/common/accessories/_ethernet.mdx new file mode 100644 index 000000000..f680ba0e8 --- /dev/null +++ b/docs/common/accessories/_ethernet.mdx @@ -0,0 +1,72 @@ +{props.product} 有 {props.eth_num} 个以太网口, 下面我们来简单测试一下 {props.product} 的以太网接口 + +- 硬件连接 + +ethernet connection + +- 检查连接状态 + +系统启动后,打开终端, 运行以下命令检查以太网是否正常连接,若连接正常,则 {props.product} 会自动获取到 ip 地址 + +```bash + +ip a + +``` + +ip show + +如图所示,以太网自动获取到了 ip 地址, 说明以太网连接正常。 + +- 测试连通性 + +```bash + +ping -c 4 google.com + +``` + +如果有响应,说明连接正常。 + +如果无响应,请检查网络配置。 + +- 测试速度 + + - 主机端和 {props.product} 上,需要先安装 iperf3 + + ```bash + + sudo apt-get install iperf3 + + ``` + + - 主机端作 server + + ```bash + + iperf3 -s + ----------------------------------------------------------- + Server listening on 5201 (test #1) + ----------------------------------------------------------- + + ``` + + - 测试上传速度 + + ```bash + + iperf3 -c 192.168.xx.xx # server_ip + + ``` + + - 测试下载速度 + + ```bash + + iperf3 -c -R 192.168.xx.xx # server_ip + + ``` diff --git a/docs/common/accessories/_headphone-jack-output.mdx b/docs/common/accessories/_headphone-jack-output.mdx new file mode 100644 index 000000000..742206d0a --- /dev/null +++ b/docs/common/accessories/_headphone-jack-output.mdx @@ -0,0 +1,42 @@ +本篇文章介绍如何使用开发板的耳机接口 + +## 测试音频播放 + +- 硬件连接 + +headphone jack + +- 下载音频文件 + +下载 wav 格式的音频文件,并将其重命名为 test.wav + +- 查看可用的音频设备 + +```bash + +$ aplay -l + +**** List of PLAYBACK Hardware Devices **** +card 0: rockchipes8316 [rockchip-es8316], device 0: dailink-multicodecs es8316.1-0011-0 [dailink-multicodecs es8316.1-0011-0] + Subdevices: 1/1 + Subdevice #0: subdevice #0 +card 1: rockchiphdmi0 [rockchip-hdmi0], device 0: rockchip-hdmi0 i2s-hifi-0 [rockchip-hdmi0 i2s-hifi-0] + Subdevices: 1/1 + Subdevice #0: subdevice #0 + +``` + +- 播放音频文件 + +```bash + +$ aplay -D hw:0,0 test.wav +Playing WAVE 'test.wav' : Signed 16 bit Little Endian, Rate 44100 Hz, Stereo + +``` + +这里的 hw:0,0 表示使用 card 0 的 device 0, 执行该命令后能从耳机插孔听到声音,说明耳机插孔正常工作 diff --git a/docs/common/accessories/_poe-hat.mdx b/docs/common/accessories/_poe-hat.mdx new file mode 100644 index 000000000..129998173 --- /dev/null +++ b/docs/common/accessories/_poe-hat.mdx @@ -0,0 +1,61 @@ +## 材料清单 + +- 如图 + +
+ {props.poe_type === "Radxa 23W PoE HAT" ? ( +
+ Radxa 23W PoE HAT +
+ ) : null} + + {props.poe_type === "Radxa 25W PoE HAT" ? ( +
+ Radxa 23W PoE HAT +
+ ) : null} + +
+ +## 安装流程 + +
+ {props.poe_type === "Radxa 23W PoE HAT" ? ( +
+ 请参考 瑞莎 23W 供电模块 +
+ ) : null} + + {props.poe_type === "Radxa 25W PoE HAT" ? ( +
+ 请参考 瑞莎 25W 供电模块 +
+ ) : null} + +
+ +## 风扇调速 + +### 启用 PoE Overlay + +如需要启用温控风扇以及温度传感器,则需要开启对应 Overlay。 + +请参照[设备树配置](../../radxa-os/rsetup#overlays),启用名为 "Enable Radxa {props.pwr_rate}W PoE HAT "的 Overlay。 + +
+  [*] Enable Radxa {props.pwr_rate}W PoE HAT
+
+ +最后,重启设备以加载 Overlay。 + +:::info +如果您无法在 `rsetup` 中找到对应的 Overlay,请参考 [System Update Guide](../../radxa-os/rsetup#system-update) 首先进行系统更新,然后再执行以上操作。 +::: + +### 检查温度传感器读数 + +执行以下命令后,第二行输出`t=XXYYY`即为当前温度(XX.YYY摄氏度): + +```bash +cat /sys/bus/w1/devices/28-*/w1_slave +``` diff --git a/docs/common/android/_low-dev.mdx b/docs/common/android/_low-dev.mdx new file mode 100644 index 000000000..3b3838284 --- /dev/null +++ b/docs/common/android/_low-dev.mdx @@ -0,0 +1,103 @@ +import { PreView } from "@site/src/utils/docs"; + +本篇文章主要介绍如何编译 Android 系统, 其中包括 uboot, kernel, aosp 编译打包等内容 + +## 环境配置 + +### 系统环境 + +```bash + +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 + +``` + +### Repo下载 + +Repo 是 Android 开发中用于管理多个 Git 仓库的工具,它是一个Python脚本,方便开发者对多个 Git 库进行版本控制和管理。 Repo 的下载可以使用以下命令 + +```bash + +wget https://storage.googleapis.com/git-repo-downloads/repo -P ~/bin/ +or +curl https://storage.googleapis.com/git-repo-downloads/repo > ~/bin/repo + +``` + +## 源码下载 + + + {` + $ repo init -u https://github.com/radxa/manifests.git -b #manifest_branch# -m #manifest_name# + $ repo sync -d --no-tags -j4 + `} + + +## 镜像编译 + +镜像编译可以使用两种方法 + +### 方法一 (**推荐**) + +使用 SDK 编译脚本方式编译 + + + {` + $ source build/envsetup.sh + $ lunch #build_variant# + $ ./build.sh -UACKu + `} + + +等待编译完成就可以在 IMAGE 目录找到镜像 + +### 方法二 + +可以根据这个方法一步一步编译镜像 + +- 设置编译项目的环境 + + + {` + $ source build/envsetup.sh + $ lunch #build_variant# + `} + + +- 编译 U-boot + +```bash +$ ./build.sh -U +``` + +- 编译内核 + +```bash +$ ./build.sh -CK +``` + +- 编译AOSP + +```bash +$ ./build.sh -A +``` + +- 制作 Images + +```bash +$ ./build.sh -u +``` + +## 常见问题 + +- Android 11 推荐在 Ubuntu 16.04 的环境下编译,其他版本的 Ubuntu 可能会出现编译错误。 diff --git a/docs/common/armbian/_armbian-build.mdx b/docs/common/armbian/_armbian-build.mdx new file mode 100644 index 000000000..bf95f0ba1 --- /dev/null +++ b/docs/common/armbian/_armbian-build.mdx @@ -0,0 +1,36 @@ +本篇文章主要介绍如何编译构建 Armbian 系统 + +- 环境准备 + + - x86_64 / aarch64 / riscv64 机器 + - 至少 4GB 内存和 ~50GB 磁盘空间,用于虚拟机、容器或裸机安装 + - Armbian / Ubuntu Jammy 22.04.x 用于本地构建,或任何支持 Docker 的 Linux 用于容器化 + - 运行 Armbian / Ubuntu Jammy 22.04.x 的 Windows 10/11,带 WSL2 子系统 + - 超级用户权限(已配置 sudo 或 root 访问权限)。 + - 确保您的系统是最新的!例如,过时的 Docker 二进制文件会造成问题 + +- 下载源码 + +```bash + +git clone --depth=1 --branch=main https://github.com/armbian/build + +cd build + +``` + +- 进入图形界面配置 + +Build Armbian for Radxa Product + +配置好之后会开始编译,编译生成的产物在 output 目录下,其中最终生成的镜像在 output/images/ 目录下 + +- 参考文档 + + - [Github](https://github.com/armbian/build) + + - [Armbian Document](https://docs.armbian.com/Developer-Guide_Build-Preparation/) diff --git a/docs/common/dev/_erase-spi-emmc.mdx b/docs/common/dev/_erase-spi-emmc.mdx index a6a54b505..03e584498 100644 --- a/docs/common/dev/_erase-spi-emmc.mdx +++ b/docs/common/dev/_erase-spi-emmc.mdx @@ -84,7 +84,7 @@ 3. 刷入 Loader
-    sudo rkdeveloptool db  rk3588_spl_loader_v1.15.113.bin 
+    sudo rkdeveloptool db  {props.loader_name} 
     
4. 清空 SPI Flash diff --git a/docs/common/dev/_rockchip-bsp.mdx b/docs/common/dev/_rockchip-bsp.mdx new file mode 100644 index 000000000..9d459be71 --- /dev/null +++ b/docs/common/dev/_rockchip-bsp.mdx @@ -0,0 +1,164 @@ +以下是如何在主机 PC 上构建 {props.product} 镜像的说明 + +## 安装 git + +```bash +sudo apt-get update +sudo apt-get install git +``` + +## 获取源码 + +```bash +git clone -b master https://github.com/radxa/rockchip-bsp.git +cd rockchip-bsp +git submodule init +git submodule update +``` + +更新子模块之后,您将获得 + +```bash +build kernel README.md rkbin rootfs u-boot +``` + +- build: 构建 u-boot、内核和 rootfs 的一些脚本文件和配置文件。 + +- kernel: 内核源代码,当前版本为 4.4 + +- rkbin: 预编译的 Rockchip 二进制文件,包括第一阶段加载器和 ATF(Arm Trustzone 固件)。 + +- rootfs: 启动基于 Debian 的 rootfs,支持架构 armhf 和 arm64,支持 Debian Jessie、Stretch 和 Buster。 + +- u-boot: u-boot 作为第二阶段引导加载程序 + +## 更新源代码 + +rockchip-bsp 将会持续更新,因此您可以在构建系统镜像之前更新源代码 + +```bash +cd rockchip-bsp +git checkout master +git fetch origin +git rebase origin/master +git submodule update +``` + +## 安装 Linaro 工具链 + +```bash +wget https://releases.linaro.org/components/toolchain/binaries/7.3-2018.05/aarch64-linux-gnu/gcc-linaro-7.3.1-2018.05-x86_64_aarch64-linux-gnu.tar.xz +sudo tar xvf gcc-linaro-7.3.1-2018.05-x86_64_aarch64-linux-gnu.tar.xz -C /usr/local/ +export CROSS_COMPILE=/usr/local/gcc-linaro-7.3.1-2018.05-x86_64_aarch64-linux-gnu/bin/aarch64-linux-gnu- +export PATH=/usr/local/gcc-linaro-7.3.1-2018.05-x86_64_aarch64-linux-gnu/bin:$PATH +``` + +检查 Linaro 工具链是否为默认选择: + +```bash +which aarch64-linux-gnu-gcc +/usr/local/gcc-linaro-7.3.1-2018.05-x86_64_aarch64-linux-gnu/bin/aarch64-linux-gnu-gcc +``` + +## 安装其他构建工具 + +```bash +sudo apt-get install gcc-aarch64-linux-gnu device-tree-compiler libncurses5 libncurses5-dev build-essential libssl-dev mtools +sudo apt-get install bc python dosfstools +``` + +如果出现无法安装的情况,您可以尝试以下方法 + +```bash +sudo apt-get install aptitude +sudo aptitude install bc python dosfstools +``` + +## 构建 u-boot + +./build/mk-uboot.sh {props.u - boot_param} #For ROCK Pi 4 Mode B + +生成的镜像将被复制到 out/u-boot 文件夹 + +```bash +ls out/u-boot/ +idbloader.img rk3399_loader_v1.12.112.bin trust.img uboot.img +``` + +## 构建内核 + +使用默认的 rockchip_linux_defconfig 构建内核 + +./build/mk-kernel.sh {[props.kernel_param]} #For ROCK Pi 4 Mode B + +## 修改内核配置 (可选) + +如果您想更改默认内核配置 + + + cd kernel export ARCH=arm64 export CROSS_COMPILE=aarch64-linux-gnu- make + rockchip_linux_defconfig make menuconfig make savedefconfig cp defconfig + arch/arm64/configs/rockchip_linux_defconfig cd .. ./build/mk-kernel.sh{" "} + {[props.kernel_param]} #For ROCK Pi 4 Mode B + + +您将获得内核镜像和 dtb 文件 + +ls out/kernel/ Image {props.kernel_param}.dtb + +## 制作 rootfs 镜像 + +查看 rootfs 源代码。仓库地址为 https://github.com/radxa/rk-rootfs-build.git,分支为 debian。 + +构建 32 位 rootfs: + +```bash +export ARCH=armhf +``` + +构建 64 位 rootfs: + +```bash +export ARCH=arm64 +``` + +- 使用 Ubuntu-build-service 从 Linaro 构建基础 Debian 系统。 + +```bash +cd rootfs +sudo apt-get install binfmt-support qemu-user-static cpio gdisk +sudo dpkg -i ubuntu-build-service/packages/* # ignore the broken dependencies, we will fix it next step +sudo apt-get install -f +RELEASE=buster TARGET=desktop ARCH=arm64 ./mk-base-debian.sh +``` + +这将引导 Debian Buster 镜像,您将获得一个名为 linaro-buster-alip-xxxx.tar.gz 的 rootfs 压缩包。 + +- 构建 rk-debian 根文件系统 + +```bash +RELEASE=buster ARCH=arm64 ./mk-rootfs.sh +``` + +- 创建 ext4 镜像(linaro-rootfs.img): + +```bash +./mk-image.sh +``` + +- 将所有内容合并成一个镜像 + + + build/mk-image.sh -c rk3399 -b {props.kernel_param} -t system -r + rootfs/linaro-rootfs.img + + +将 u-boot、内核和 rootfs 合并成一个镜像并生成 GPT 分区表。输出结果为 + +```bash +out/system.img +``` + +### 烧录镜像 + +请参考 [安装系统](props.install-os_path) 部分安装系统, 系统镜像为上面的 out/system.img。 diff --git a/docs/rock4/hardware/rock4-gpio.md b/docs/rock4/_rock4-gpio.mdx similarity index 81% rename from docs/rock4/hardware/rock4-gpio.md rename to docs/rock4/_rock4-gpio.mdx index 9c9693087..1582ea28c 100644 --- a/docs/rock4/hardware/rock4-gpio.md +++ b/docs/rock4/_rock4-gpio.mdx @@ -1,10 +1,4 @@ ---- -sidebar_position: 50 ---- - -# ROCK 4 系列 GPIO 定义 - -## GPIO 电压 +- GPIO 电压 RK3399 和 OP1 有三种 IO 电压:1.8V/3.0V/3.3V。以下是默认电压: @@ -14,9 +8,10 @@ RK3399 和 OP1 有三种 IO 电压:1.8V/3.0V/3.3V。以下是默认电压: | ADC_IN0 | 1.8V | 1.98V | | Other GPIO | 3.0V | 3.14V | -## GPIO 接口 +- GPIO 接口 + +ROCK 4 系列有一个 40 引脚的扩展针座,每个引脚用颜色区分,且兼容市场上大多数传感器应用。 -ROCK 4 系列有一个 40 引脚的扩展针座。每个引脚用颜色区分。 以下引脚布局适用于 ROCK 4 系列的所有产品。
@@ -50,17 +45,28 @@ ROCK 4 系列有一个 40 引脚的扩展针座。每个引脚用颜色区分。
-## 关于 40 pin 连接座的说明 - -- 标有橙色的功能是该引脚的默认功能。 -- 除电源引脚外,所有引脚都直接连接到 SoC。 -- 对于引脚 3、5、27、28、29 和 31,每个引脚都通过一个 4.7K 上拉电阻与 3.0V 电源相连。 -- 引脚 7 直接连接到板上的 MIPI CSI 引脚。 -- SPI - - 引脚 19、21、23、24 也连接到电路板上的 SPI 闪存引脚。如果 ROCK 4 系列板上焊接了 SPI 闪存,则 GPIO 针座上不提供 SPI 功能。 -- UART - - UART2 默认启用为 U-boot 和 Linux 串行控制台。选中 Rockpi4/dev/serial-console 即可使用。选中 Rockpi4/hardware/devtree_overlays 来禁用 UART2 上的串行控制台。 - - UART2 和 UART4 支持多种波特率。包括但不限于以下波特率:115200bps。500000bps、1500000bps 等。 - - 某些板子的板载 SPI 闪存已焊接,UART4 引脚用于 SPI 功能。 -- 对于 I2C-2 和 I2C-7 - - 我们已经使用 i2c 设备 e2prom 进行测试。我们需要打开 i2c 设备文件,然后进行读或写操作。 +- 关于 40 pin 连接座的说明 + + - 标有橙色的功能是该引脚的默认功能。 + + - 除电源引脚外,所有引脚都直接连接到 SoC。 + + - 对于引脚 3、5、27、28、29 和 31,每个引脚都通过一个 4.7K 上拉电阻与 3.0V 电源相连。 + + - 引脚 7 直接连接到板上的 MIPI CSI 引脚。 + + - SPI + + - 引脚 19、21、23、24 也连接到电路板上的 SPI 闪存引脚。如果 ROCK 4 系列板上焊接了 SPI 闪存,则 GPIO 针座上不提供 SPI 功能。 + + - UART + + - UART2 默认启用为 U-boot 和 Linux 串行控制台。选中 Rockpi4/dev/serial-console 即可使用。选中 Rockpi4/hardware/devtree_overlays 来禁用 UART2 上的串行控制台。 + + - UART2 和 UART4 支持多种波特率。包括但不限于以下波特率:115200bps。500000bps、1500000bps 等。 + + - 某些板子的板载 SPI 闪存已焊接,UART4 引脚用于 SPI 功能。 + + - 对于 I2C-2 和 I2C-7 + + - 我们已经使用 i2c 设备 e2prom 进行测试。我们需要打开 i2c 设备文件,然后进行读或写操作。 diff --git a/docs/rock4/official-images.md b/docs/rock4/official-images.md deleted file mode 100644 index 7eeb77ad7..000000000 --- a/docs/rock4/official-images.md +++ /dev/null @@ -1,68 +0,0 @@ ---- -sidebar_position: 8 ---- - -# ROCK 4 系列官方镜像 - -ROCK 4 官方操作系统镜像可从以下方式下载: - -- **[ROCK 4 镜像发布网址](https://github.com/radxa-build)** - -## 官方镜像下载链接 - - - - -| ![Debian](/img/Debian-logo.webp) | ![Android](/img/Android-Logo.webp) | -| --------------------------------------------------------------------------------- | ----------------------------------------------------------------------------------------------------------------------------------------------------- | -| [Debian 11 Desktop(Linux 5.10)](https://github.com/radxa-build/rock-4se/releases) | [Android 11 (HDMI 4K)](https://github.com/radxa/manifests/releases/download/RockPi-android11-20220819_1707/rock4b-se-android11-20220819-1907-gpt.zip) | - - - - -| ![Debian](/img/Debian-logo.webp) | ![Android](/img/Android-Logo.webp) | -| ------------------------------------------------------------------------------------- | ----------------------------------------------------------------------------------------------------------------------------------------------------------- | -| [Debian 11 Desktop(Linux 5.10)](https://github.com/radxa-build/rock-4c-plus/releases) | [Android 11 HDMI 4K + 2K](https://github.com/radxa/manifests/releases/download/Rock-android11-20220408_1204/Rock4C_Plus_Android11_20220408_1609-gpt.img.xz) | - - - - -| ![Debian](/img/Debian-logo.webp) | ![Android](/img/Android-Logo.webp) | ![Android TV](/img/Android-tv-logo.webp) | -| ------------------------------------------------------------------------- | ----------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------- | ------------------------------------------------------------------------------------------------------------------------------------------- | -| [Debian Desktop](https://github.com/radxa-build/rock-pi-4a-plus/releases) | [Android 7 (DSI 480P)](https://rock.sh/rockpi-android7-dsi-download)
[Android 7 (HDMI 4K)](https://rock.sh/rockpi-android7-download)
[Android 9 (HDMI 4K)](https://rock.sh/rockpi-android9-gpt-download)
[Android 10 (HDMI 4K)](https://rock.sh/rockpi4b-android10-gpt-download)
[Android 11 (HDMI 4K)](https://github.com/radxa/manifests/releases/tag/Rock-android11-20211115_1851) | [Android 7 TV(Deprecated)](https://rock.sh/rockpi-android7-tv-download)
[Android 9 TV](https://rock.sh/rockpi-android9-tv-gpt-download) | - -
- - -| ![Debian](/img/Debian-logo.webp) | ![Android](/img/Android-Logo.webp) | ![Android TV](/img/Android-tv-logo.webp) | -| ------------------------------------------------------------------------- | ----------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------- | ------------------------------------------------------------------------------------------------------------------------------------------- | -| [Debian Desktop](https://github.com/radxa-build/rock-pi-4a-plus/releases) | [Android 7 (DSI 480P)](https://rock.sh/rockpi-android7-dsi-download)
[Android 7 (HDMI 4K)](https://rock.sh/rockpi-android7-download)
[Android 9 (HDMI 4K)](https://rock.sh/rockpi-android9-gpt-download)
[Android 10 (HDMI 4K)](https://rock.sh/rockpi4b-android10-gpt-download)
[Android 11 (HDMI 4K)](https://github.com/radxa/manifests/releases/tag/Rock-android11-20211115_1851) | [Android 7 TV(Deprecated)](https://rock.sh/rockpi-android7-tv-download)
[Android 9 TV](https://rock.sh/rockpi-android9-tv-gpt-download) | - -
- - -| ![Debian](/img/Debian-logo.webp) | ![Android](/img/Android-Logo.webp) | ![Android TV](/img/Android-tv-logo.webp) | -| ----------------------------------------------------------------------------------- | ----------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------- | ------------------------------------------------------------------------------------------------------------------------------------------- | -| [Debian 11 Desktop(Linux 5.10)](https://github.com/radxa-build/rock-pi-4a/releases) | [Android 7 (DSI 480P)](https://rock.sh/rockpi-android7-dsi-download)
[Android 7 (HDMI 4K)](https://rock.sh/rockpi-android7-download)
[Android 9 (HDMI 4K)](https://rock.sh/rockpi-android9-gpt-download)
[Android 10 (HDMI 4K)](https://rock.sh/rockpi4b-android10-gpt-download)
[Android 11 (HDMI 4K)](https://github.com/radxa/manifests/releases/tag/Rock-android11-20211115_1851) | [Android 7 TV(Deprecated)](https://rock.sh/rockpi-android7-tv-download)
[Android 9 TV](https://rock.sh/rockpi-android9-tv-gpt-download) | - -
- - -| ![Debian](/img/Debian-logo.webp) | ![Android](/img/Android-Logo.webp) | ![Android TV](/img/Android-tv-logo.webp) | -| ----------------------------------------------------------------------------------- | ----------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------- | ------------------------------------------------------------------------------------------------------------------------------------------- | -| [Debian 11 Desktop(Linux 5.10)](https://github.com/radxa-build/rock-pi-4b/releases) | [Android 7 (DSI 480P)](https://rock.sh/rockpi-android7-dsi-download)
[Android 7 (HDMI 4K)](https://rock.sh/rockpi-android7-download)
[Android 9 (HDMI 4K)](https://rock.sh/rockpi-android9-gpt-download)
[Android 10 (HDMI 4K)](https://rock.sh/rockpi4b-android10-gpt-download)
[Android 11 (HDMI 4K)](https://github.com/radxa/manifests/releases/tag/Rock-android11-20211115_1851) | [Android 7 TV(Deprecated)](https://rock.sh/rockpi-android7-tv-download)
[Android 9 TV](https://rock.sh/rockpi-android9-tv-gpt-download) | - -
- - -| ![Debian](/img/Debian-logo.webp) | ![Android](/img/Android-Logo.webp) | -| --------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------- | ----------------------------------------------------------------------------- | -| [Debian 10 Desktop(Dual Display)](https://github.com/radxa/rock-pi-images-released/releases/download/v20210824/rockpi4c_debian_buster_xfce4_arm64_20210824_0245-gpt.img.gz)
**BETA**[Debian 11 Desktop(Linux 5.10)](https://github.com/radxa-build/rock-pi-4c/releases) | [Android 10 (HDMI 4K,DP 2K)](https://rock.sh/rockpi4c-android10-gpt-download) | - -
- -
- -## 第三方操作系统 - -请参阅[第三方操作系统](./alternative-os/third-party-images)。 diff --git a/docs/rock4/os-config/README.md b/docs/rock4/os-config/README.md deleted file mode 100644 index f722833bd..000000000 --- a/docs/rock4/os-config/README.md +++ /dev/null @@ -1,9 +0,0 @@ ---- -sidebar_position: 20 ---- - -# 系统配置 - -介绍如何通过工具(例如rsetup)或者命令行去使用设备或者功能。 - - diff --git a/docs/rock4/os-config/bootparam.md b/docs/rock4/os-config/bootparam.md deleted file mode 100644 index 2bc5e0594..000000000 --- a/docs/rock4/os-config/bootparam.md +++ /dev/null @@ -1,5 +0,0 @@ -import Bootparam from "../../common/radxa-os/\_bootparam.mdx"; - -# 启动参数 - - diff --git a/docs/rock4/os-config/rsetup.md b/docs/rock4/os-config/rsetup.md deleted file mode 100644 index 9e6a57b58..000000000 --- a/docs/rock4/os-config/rsetup.md +++ /dev/null @@ -1,3 +0,0 @@ -import Rsetup from "../../common/config/\_rsetup.mdx"; - - diff --git a/docs/rock4/rock4ab/README.md b/docs/rock4/rock4ab-se/README.md similarity index 78% rename from docs/rock4/rock4ab/README.md rename to docs/rock4/rock4ab-se/README.md index f81846058..8f1b07b6c 100644 --- a/docs/rock4/rock4ab/README.md +++ b/docs/rock4/rock4ab-se/README.md @@ -2,7 +2,7 @@ sidebar_position: 10 --- -# ROCK 4A/4B +# ROCK 4A/4A+/4B/4B+/4SE 基于 RK3399 的高扩展高兼容性 SBC。 diff --git a/docs/rock4/rock4ab-se/app-development/README.md b/docs/rock4/rock4ab-se/app-development/README.md new file mode 100644 index 000000000..2794a58b0 --- /dev/null +++ b/docs/rock4/rock4ab-se/app-development/README.md @@ -0,0 +1,9 @@ +--- +sidebar_position: 4 +--- + +# 应用开发 + +主要介绍上层应用开发,比如 QT, WiringX, Mraa 等 + + diff --git a/docs/rock4/rock4ab-se/app-development/gpiod.md b/docs/rock4/rock4ab-se/app-development/gpiod.md new file mode 100644 index 000000000..fd8dd9211 --- /dev/null +++ b/docs/rock4/rock4ab-se/app-development/gpiod.md @@ -0,0 +1,9 @@ +--- +sidebar_position: 2 +--- + +# GPIOD 使用 + +import GPIOD from '../../../common/dev/\_gpiod.mdx'; + + diff --git a/docs/rock4/rock4ab-se/app-development/mraa.md b/docs/rock4/rock4ab-se/app-development/mraa.md new file mode 100644 index 000000000..b460be602 --- /dev/null +++ b/docs/rock4/rock4ab-se/app-development/mraa.md @@ -0,0 +1,9 @@ +--- +sidebar_position: 3 +--- + +# Mraa 使用 + +import MRAA from '../../../common/dev/\_mraa.mdx'; + + diff --git a/docs/rock4/rock4ab-se/app-development/opencv.md b/docs/rock4/rock4ab-se/app-development/opencv.md new file mode 100644 index 000000000..b1bd52042 --- /dev/null +++ b/docs/rock4/rock4ab-se/app-development/opencv.md @@ -0,0 +1,9 @@ +--- +sidebar_position: 5 +--- + +# OpenCV + +import OPENCV from '../../../common/dev/\_opencv.mdx'; + + diff --git a/docs/rock4/rock4ab-se/app-development/qt_cross_compile.md b/docs/rock4/rock4ab-se/app-development/qt_cross_compile.md new file mode 100644 index 000000000..52b740ab6 --- /dev/null +++ b/docs/rock4/rock4ab-se/app-development/qt_cross_compile.md @@ -0,0 +1,9 @@ +--- +sidebar_position: 7 +--- + +# QT 交叉编译 + +import QTCROSSCOMPILE from '../../../common/dev/\_qt-cross-compile.mdx'; + + diff --git a/docs/rock4/rock4ab-se/app-development/rtsp.md b/docs/rock4/rock4ab-se/app-development/rtsp.md new file mode 100644 index 000000000..7bc9f74f5 --- /dev/null +++ b/docs/rock4/rock4ab-se/app-development/rtsp.md @@ -0,0 +1,9 @@ +--- +sidebar_position: 8 +--- + +import Rtsp from '../../../common/dev/\_rtsp.mdx'; + +# RTSP 推流 + + diff --git a/docs/rock4/rock4ab-se/app-development/venv_usage.md b/docs/rock4/rock4ab-se/app-development/venv_usage.md new file mode 100644 index 000000000..0c2820548 --- /dev/null +++ b/docs/rock4/rock4ab-se/app-development/venv_usage.md @@ -0,0 +1,9 @@ +--- +sidebar_position: 22 +--- + +# Python 虚拟环境使用 + +import VENVUSAGE from '../../../common/dev/\_venv_usage.mdx'; + + diff --git a/docs/rock4/rock4ab-se/download.md b/docs/rock4/rock4ab-se/download.md new file mode 100644 index 000000000..90da144a8 --- /dev/null +++ b/docs/rock4/rock4ab-se/download.md @@ -0,0 +1,181 @@ +--- +sidebar_position: 2 +--- + +# 资源下载汇总 + +## 操作系统镜像 + +### 官方操作系统 + +#### Linux + +- (Radxa ROCK 4A Debian 11 Desktop Linux 5.10)[https://github.com/radxa-build/rock-pi-4a/releases/download/test-build-1/rock-pi-4a_debian_bullseye-test_kde_t1.img.xz] + +- (Radxa ROCK 4A+ Debian 11 Desktop Linux 5.10)[https://github.com/radxa-build/rock-pi-4a-plus/releases/download/20230601-0150/rock-pi-4a-plus_debian_bullseye_kde_b14.img.xz] + +- [Radxa ROCK 4B Debian 11 Desktop Linux 5.10](https://github.com/radxa-build/rock-pi-4b/releases/download/20230601-0206/rock-pi-4b_debian_bullseye_kde_b32.img.xz) + +- (Radxa ROCK 4B+ Debian 11 Desktop Linux 5.10)[https://github.com/radxa-build/rock-pi-4b-plus/releases/download/rsdk-t2/rock-pi-4b-plus_bullseye_kde_t2.output.img.xz] + +- [Radxa ROCK 4SE Debian 11 Desktop Linux 5.10](https://github.com/radxa-build/rock-4se/releases/download/b38/rock-4se_debian_bullseye_kde_b38.img.xz) + +#### Android + +- [Radxa ROCK 4SE Android 11](https://github.com/radxa/manifests/releases/download/RockPi-android11-20220819_1707/rock4b-se-android11-20220819-1907-gpt.zip) + +- [Radxa ROCK 4B/4SE Android 11 (HDMI 4K)](https://github.com/radxa/manifests/releases/download/RockPi-android11-20220819_1707/rock4b-se-android11-20220819-1907-gpt.zip) + +- [Radxa ROCK 4B Android 7 (DSI 480P)](https://rock.sh/rockpi-android7-dsi-download) + +- [Radxa ROCK 4B Android 7 (HDMI 4K)](https://rock.sh/rockpi-android7-download) + +- [Radxa ROCK 4B Android 9 (HDMI 4K)](https://rock.sh/rockpi-android9-gpt-download) + +- [Radxa ROCK 4B Android 10 (HDMI 4K)](https://rock.sh/rockpi4b-android10-gpt-download) + +- [Radxa ROCK 4B Android 11 (HDMI 4K)](https://github.com/radxa/manifests/releases/tag/Rock-android11-20211115_1851) + +- [Radxa ROCK 4B Android 7 TV(Deprecated)](https://rock.sh/rockpi-android7-tv-download) + +- [Radxa ROCK 4B Android 9 TV](https://rock.sh/rockpi-android9-tv-gpt-download) + +### 第三方操作系统 + +- [Radxa ROCK Pi 4A OpenWRT](https://openwrt.org/toh/hwdata/radxa/radxa_rock_pi_4) + +- [Radxa ROCK 4A/4B/4C/4A+/4B+ DietPi](https://dietpi.com/downloads/images/DietPi_ROCKPi4-ARMv8-Bookworm.img.xz) + +- [Radxa ROCK 4SE DietPi](https://dietpi.com/downloads/images/DietPi_ROCK4SE-ARMv8-Bookworm.img.xz) + +:::caution + +官方镜像经过官方充分测试外,第三方镜像未经过严格测试,可能会存在未知问题,仅用于评估使用。 + +::: + +## Datasheet + +- [ROCK 4A/B 的 SOC RK3399 datasheet](http://rockchip.fr/RK3399%20datasheet%20V1.8.pdf) + +- [ROCK 4SE 的 SOC RK3399-T datasheet](https://dl.radxa.com/rockpi4/docs/hw/datasheets/Rockchip%20RK3399-T%20Datasheet%20V1.0-20210818.pdf) + +- [PMIC RK808 datasheet](http://rockchip.fr/RK808%20datasheet%20V1.4.pdf) + +- [AP6256 datasheet](https://dl.radxa.com/rockpi4/docs/hw/datasheets/AP6256%20datasheet_V1.3_12202017.pdf) + +- [USB PD 协议 IC LDR6015 datasheet](https://dl.radxa.com/rockpi4/docs/hw/datasheets/LDR6015T%20Spec%20EN%20V1.0.pdf) + +- [ 音频编解码器 ES8316 datasheet](https://dl.radxa.com/rockpi4/docs/hw/datasheets/ES8316%20PB.pdf) + +- [DRAM chip Foresee LPDDR4 datasheet](https://dl.radxa.com/rockpi4/docs/hw/datasheets/FORESEE_LPDDR4_200ball_NCLD4CXMAXXXM32_10x14.5_VFBGA_Spec_B1_20170802.pdf) + +- [RTL8211E datasheet]() + +- [Heatsink datasheet](https://dl.radxa.com/rockpi4/docs/hw/heatsink/rockpi4_heatsink_datasheet.pdf) + +## 硬件设计文件 + +- [ROCK 4A V1.52 原理图](https://dl.radxa.com/rockpi4/docs/hw/rockpi4/4a/ROCK_4A_V1.52_SCH.pdf) + +- [ROCK 4A V1.52 位号图](https://dl.radxa.com/rockpi4/docs/hw/rockpi4/4a/ROCK_4A_V1.52_SMD.pdf) + +- [ROCK 4B V1.52 原理图](https://dl.radxa.com/rockpi4/docs/hw/rockpi4/4b/ROCK_4B_v1.52_SCH.pdf) + +- [ROCK 4B V1.52 位号图](https://dl.radxa.com/rockpi4/docs/hw/rockpi4/4b/ROCK_4B_v1.52_SMD.pdf) + +- [ROCK 4A+ V1.6 原理图](https://dl.radxa.com/rockpi4/docs/hw/rockpi4/4ap/radxa_rock_4ap_v1600_schematic.pdf) + +- [ROCK 4A+ V1.73 原理图](https://dl.radxa.com/rockpi4/docs/hw/rockpi4/4ap/radxa_rock_4ap_v1730_schematic.pdf) + +- [ROCK 4B+ V1.6 原理图](https://dl.radxa.com/rockpi4/docs/hw/rockpi4/4bp/radxa_rock_4bp_v1600_schematic.pdf) + +- [ROCK 4B+ V1.6 位号图](https://dl.radxa.com/rockpi4/docs/hw/rockpi4/4bp/radxa_rock_4p_v1600_smd.pdf) + +- [ROCK 4B+ V1.73 原理图](https://dl.radxa.com/rockpi4/docs/hw/rockpi4/4bp/radxa_rock_4bp_v1730_schematic.pdf) + +- [ROCK 4B+ V1.73 位号图](https://dl.radxa.com/rockpi4/docs/hw/rockpi4/4bp/radxa_rock_4p_v1730_smd.pdf) + +- [ROCK 4SE V1.53 原理图](https://dl.radxa.com/rockpi4/docs/hw/rockpi4/ROCK-4-SE-V1.53-SCH.pdf) + +- [ROCK 4SE V1.53 位号图](https://dl.radxa.com/rockpi4/docs/hw/rockpi4/ROCK-4-SE-V1.53-SMD.pdf) + +- [ROCK 4 M.2 扩展板 PCIe to FPC 原理图](https://dl.radxa.com/rockpi4/docs/hw/m2_extend/rockpi4-m2-extend-sch_pcie_to_fpc_V1.4.pdf) + +- [SSD 安装板原理图](https://dl.radxa.com/rockpi4/docs/hw/m2_extend/rockpi4-m2-extend-sch_fpc_to_m2_V1.4.pdf) + +## 规格书 + +- [ROCK 4A 产品规格书](https://dl.radxa.com/rockpi4/docs/hw/rockpi4/radxa_rock4a_product_brief_Revision_1.0.pdf) + +- [ROCK 4B 产品规格书](https://dl.radxa.com/rockpi4/docs/hw/rockpi4/radxa_rock4b_product_brief_Revision_2.0.pdf) + +- [ROCK 4A+ 产品规格书](https://dl.radxa.com/rockpi4/docs/hw/rockpi4/radxa_rock4ap_product_brief_Revision_1.0.pdf) + +- [ROCK 4B+ 产品规格书](https://dl.radxa.com/rockpi4/docs/hw/rockpi4/radxa_rock4bp_product_brief_Revision_1.1.pdf) + +- [ROCK 4SE 产品规格书](https://dl.radxa.com/rockpi4/docs/hw/rockpi4/radxa_rock4se_product_brief_Revision_1.8.pdf) + +## TRM + +- [RK3399 TRM Part 1](http://rockchip.fr/Rockchip%20RK3399%20TRM%20V1.3%20Part1.pdf) + +- [RK3399 TRM Part 2](http://rockchip.fr/Rockchip%20RK3399%20TRM%20V1.3%20Part2.pdf) + +## 模型文件 + +- [ROCK 4A V1.52 DXF](https://dl.radxa.com/rockpi4/docs/hw/rockpi4/4a/ROCK_4A_V1.52_DXF.rar) + +- [ROCK 4B V1.52 DXF](https://dl.radxa.com/rockpi4/docs/hw/rockpi4/4b/ROCK_4B_v1.52_DXF.rar) + +- [ROCK 4B 3D](https://dl.radxa.com/rockpi4/docs/hw/rockpi4/ROCKPi-4B-3D.stp.zip) + +- [ROCK 4B+ V1.6 2D](https://dl.radxa.com/rockpi4/docs/hw/rockpi4/4bp/radxa_rock_4p_v1600_2d.zip) + +- [ROCK V1.73 2D](https://dl.radxa.com/rockpi4/docs/hw/rockpi4/4bp/radxa_rock_4p_v1730_2d.zip) + +- [ROCK 4SE V1.53 DXF](https://dl.radxa.com/rockpi4/docs/hw/rockpi4/4se/ROCK_4SE_V1.53_DXF.rar) + +- [ROCK PI 4 Bottom 2D DXF](https://dl.radxa.com/rockpi4/docs/hw/rockpi4/rockpi4_2d_v14_201811122_bottom.dxf.zip) + +- [ROCK PI 4 Top 2D DXF](https://dl.radxa.com/rockpi4/docs/hw/rockpi4/rockpi4_v14_2d_201811122_top.dxf) + +- [官方散热片 3D STP](https://dl.radxa.com/rockpi4/docs/hw/heatsink-1225-al-1.stp) + +- [M.2 拓展板 2D DXF](https://dl.radxa.com/rockpi4/docs/hw/m2_extend/PCIE_to_FPC_V1.4.dxf) + +- [FPC 转 M.2 2D DXF](https://dl.radxa.com/rockpi4/docs/hw/m2_extend/FPC_to_M2_V1.4.dxf) + +## 质量认证 + +- [ROCK 4A/4B CE RED](https://dl.radxa.com/rockpi4/compliance/4a4b/CE_RED/) + +- [ROCK 4A+/4B+ CE RED](https://dl.radxa.com/rockpi4/compliance/4ap4bp/CE_RED/) + +- [ROCK 4A+/4B+ FCC ID](https://dl.radxa.com/rockpi4/compliance/4ap4bp/FCC_ID/) + +- [ROCK 4SE CE RED](https://dl.radxa.com/rockpi4/compliance/4se/CE_RED/) + +- [ROCK 4SE FCC ID](https://dl.radxa.com/rockpi4/compliance/4se/FCC_ID/) + +- [ROCK 4SE ICASA](https://dl.radxa.com/rockpi4/compliance/4se/ICASA/) + +- [ROCK 4SE IC ID](https://dl.radxa.com/rockpi4/compliance/4se/IC_ID/) + +- [ROCK 4SE IMDA](https://dl.radxa.com/rockpi4/compliance/4se/IMDA/) + +- [ROCK 4SE NTC](https://dl.radxa.com/rockpi4/compliance/4se/NTC/) + +- [ROCK 4SE OFCA](https://dl.radxa.com/rockpi4/compliance/4se/OFCA/) + +- [ROCK 4SE RCM](https://dl.radxa.com/rockpi4/compliance/4se/RCM/) + +- [ROCK 4SE RCM](https://dl.radxa.com/rockpi4/compliance/4se/SRRC/) + +- [ROCK 4SE SRRC](https://dl.radxa.com/rockpi4/compliance/4se/SRRC/) + +- [ROCK 4SE TELEC](https://dl.radxa.com/rockpi4/compliance/4se/TELEC/) + +- [FCC ID: 2A3PA-ROCKPI4 US](https://fcc.report/FCC-ID/2A3PA-ROCKPI4/) + +- [FCC ID: 2A3PA-ROCK4SE US](https://fccid.io/2A3PA-ROCK4SE) diff --git a/docs/rock4/rock4ab-se/faq.md b/docs/rock4/rock4ab-se/faq.md new file mode 100644 index 000000000..bd97ec042 --- /dev/null +++ b/docs/rock4/rock4ab-se/faq.md @@ -0,0 +1,11 @@ +--- +sidebar_position: 10 +--- + +# FAQ + +## Q1: Google Play 设备未通过 Play Protect 认证 + +- https://forum.radxa.com/t/solve-google-play-device-is-not-play-protect-certified-issue/229 + +## diff --git a/docs/rock4/rock4ab-se/getting-started/README.md b/docs/rock4/rock4ab-se/getting-started/README.md new file mode 100644 index 000000000..af5bf057e --- /dev/null +++ b/docs/rock4/rock4ab-se/getting-started/README.md @@ -0,0 +1,7 @@ +--- +sidebar_position: 1 +--- + +# 上手指南 + + diff --git a/docs/rock4/rock4ab-se/getting-started/_package.mdx b/docs/rock4/rock4ab-se/getting-started/_package.mdx new file mode 100644 index 000000000..9fd1b6698 --- /dev/null +++ b/docs/rock4/rock4ab-se/getting-started/_package.mdx @@ -0,0 +1,28 @@ +export default function DynamicList({ items }) { + const fixedItems = [ + '封口防静电袋', + 'PP 塑料盒', + '牙膏盒', + ]; + +const renderItems = (modelName) => ( + +
    +
  • {modelName} 主板
  • + {fixedItems.map((item, index) => ( +
  • {item}
  • + ))} +
+); + +return ( + +
+ {items.map((modelName, index) => ( +
+

{modelName} 标准包装包括以下物品:

+ {renderItems(modelName)} +
+ ))} +
+); } diff --git a/docs/rock4/rock4ab-se/getting-started/basic-software-conf.md b/docs/rock4/rock4ab-se/getting-started/basic-software-conf.md new file mode 100644 index 000000000..a61219dd5 --- /dev/null +++ b/docs/rock4/rock4ab-se/getting-started/basic-software-conf.md @@ -0,0 +1,13 @@ +--- +sidebar_position: 4 +--- + +import BasicSoftWareConf from "../../../common/radxa-os/\_basicSoftwareConf.mdx"; + +# 快速设置 + + + +:::tip +请参考我们的[瑞莎系统](../radxa-os/)章节,了解更多软件配置内容。 +::: diff --git a/docs/rock4/rock4ab-se/getting-started/install-os/README.md b/docs/rock4/rock4ab-se/getting-started/install-os/README.md new file mode 100644 index 000000000..b3b4f43fb --- /dev/null +++ b/docs/rock4/rock4ab-se/getting-started/install-os/README.md @@ -0,0 +1,7 @@ +--- +sidebar_position: 3 +--- + +# 安装系统 + + diff --git a/docs/rock4/rock4ab-se/getting-started/install-os/boot-from-emmc.md b/docs/rock4/rock4ab-se/getting-started/install-os/boot-from-emmc.md new file mode 100644 index 000000000..dac882662 --- /dev/null +++ b/docs/rock4/rock4ab-se/getting-started/install-os/boot-from-emmc.md @@ -0,0 +1,39 @@ +--- +sidebar_position: 1 +--- + +import Etcher from '../../../../common/general/\_etcherV2.mdx'; + +# 安装系统到 eMMC Module + +本文介绍如何在 ROCK 4A/4B/4SE 上将系统安装到 eMMC Module 中,并通过 eMMC Module 启动系统。 + +## 文件下载 + +到资源下载汇总页面下载 [ROCK 4A/4B/4SE 系统镜像](../../download) + +## eMMC Module 准备 + +将 [eMMC Module](../../../../accessories/emmc_module) 插入到 [eMMC Reader](../../../../accessories/emmc_reader) 中,然后将 Reader 插入到 PC 的 USB 端口上 + +## 镜像烧录 + + + +## 启动系统 + +按照上述步骤成功烧录 eMMC Module 后, 将 eMMC Module 插入到 eMMC Module 插槽内(如下图所示),然后上电,系统开始启动,HDMI显示桌面。 + + + +## 登录系统 + +系统启动后,使用 radxa 账号登录,密码为 radxa。 + +:::tip +系统从上电到开机启动,整个过程持续约 40 秒,然后进入系统桌面。 +::: diff --git a/docs/rock4/rock4ab-se/getting-started/install-os/boot-from-nvme.md b/docs/rock4/rock4ab-se/getting-started/install-os/boot-from-nvme.md new file mode 100644 index 000000000..2b70c1218 --- /dev/null +++ b/docs/rock4/rock4ab-se/getting-started/install-os/boot-from-nvme.md @@ -0,0 +1,17 @@ +--- +sidebar_position: 3 +--- + +# 安装系统到 NVME + +:::tip +本教程仅使用与内核 >= 5.10 的系统 +::: + +import NVME from '../../../../common/dev/\_nvme.mdx'; + + + +:::tip +系统从上电到开机启动,整个过程持续约 40 秒,然后进入系统桌面。 +::: diff --git a/docs/rock4/rock4ab-se/getting-started/install-os/boot-from-pxe.md b/docs/rock4/rock4ab-se/getting-started/install-os/boot-from-pxe.md new file mode 100644 index 000000000..84cb46ad2 --- /dev/null +++ b/docs/rock4/rock4ab-se/getting-started/install-os/boot-from-pxe.md @@ -0,0 +1,5 @@ +--- +sidebar_position: 5 +--- + +# 从网络启动 diff --git a/docs/rock4/rock4ab-se/getting-started/install-os/boot-from-sd-card.md b/docs/rock4/rock4ab-se/getting-started/install-os/boot-from-sd-card.md new file mode 100644 index 000000000..7c1b00da3 --- /dev/null +++ b/docs/rock4/rock4ab-se/getting-started/install-os/boot-from-sd-card.md @@ -0,0 +1,39 @@ +--- +sidebar_position: 2 +--- + +import Etcher from '../../../../common/general/\_etcherV2.mdx'; + +# 安装系统到 MicroSD 卡 + +本文介绍如何在 ROCK 4A/4B/4A+/4B+/4SE 上将系统安装到 MicroSD 卡 中,并通过 MicroSD 卡 启动系统。 + +## 文件下载 + +到资源下载汇总页面下载 [ROCK 4A/4B/4A+/4B+/4SE 系统镜像](../../download) + +## MicroSD 卡准备 + +将 MicroSD 卡插入到 SD 卡读卡器中,然后将读卡器插入到 PC 的 USB 端口上 + +## 镜像烧录 + + + +## 启动系统 + +按照上述步骤成功烧录 MicroSD Card 后, 将 MicroSD Card 插入到 MicroSD Card 插槽内(如下图所示),然后上电,系统开始启动,HDMI显示桌面。 + + + +## 登录系统 + +系统启动后,使用 radxa 账号登录,密码为 radxa。 + +:::tip +系统从上电到开机启动,整个过程持续约 40 秒,然后进入系统桌面。 +::: diff --git a/docs/rock4/rock4ab-se/getting-started/install-os/erase-spi-flash.md b/docs/rock4/rock4ab-se/getting-started/install-os/erase-spi-flash.md new file mode 100644 index 000000000..673ab50ae --- /dev/null +++ b/docs/rock4/rock4ab-se/getting-started/install-os/erase-spi-flash.md @@ -0,0 +1,29 @@ +--- +sidebar_position: 4 +--- + +# 手动清空 SPI Flash + +::tip +本教程使用与内核 >= 5.10 的系统 +::: + +## 能启动 Linux + +- 打开终端,执行 rsetup + +- 选择 "System Maintenance" + +main menu + +- 选择 "Erase SPI Bootloader" + +System Maintenance + +- 选择 "OK" 之后,按空格键,选中 "rock-4a""rock-4b""rock-4a+""rock-4b+""rock-4se" + +rsetup rock4ab-se + +## 不能启动到系统 + +[参考 USB 线刷](/rock4/rock4ab-se/low-level-dev/maskrom) diff --git a/docs/rock4/rock4ab-se/getting-started/interface-usage/README.md b/docs/rock4/rock4ab-se/getting-started/interface-usage/README.md new file mode 100644 index 000000000..9cdf2dc60 --- /dev/null +++ b/docs/rock4/rock4ab-se/getting-started/interface-usage/README.md @@ -0,0 +1,5 @@ +--- +sidebar_position: 5 +--- + +# 接口使用说明 diff --git a/docs/rock4/rock4ab-se/getting-started/interface-usage/cpu.md b/docs/rock4/rock4ab-se/getting-started/interface-usage/cpu.md new file mode 100644 index 000000000..5da7c1df3 --- /dev/null +++ b/docs/rock4/rock4ab-se/getting-started/interface-usage/cpu.md @@ -0,0 +1,176 @@ +--- +sidebar_position: 1 +--- + +# CPU + +## CPU 频率支持信息 + + + + + Rockchip RK3399 SoC, 有 6 个 CPU 内核
两个大核 Cortex-A72, 频率 1.8 GHz, 最高可达 2.0 GHz
四个小核 Cortex-A53, 频率 1.4 GHz,最高可达 1.6 GHz +
+ + + Rockchip OP1 SoC, 有 6 个 CPU 内核
两个大核 Cortex A72, 频率 2.0 GHz, 最高可达 2.4 GHz
四 Cortex A53, 频率 1.6GHz +
+ + + Rockchip RK3399-T SoC, 有 6 个 CPU 内核
两个大核 Cortex A72,频率 1.5GHz, 最高可达 1.8 GHz
四 Cortex®-A53,频率 1.0GHz +
+ +
+ +## 超频 + +超频是通过提升硬件运行频率来提高性能的操作,但需要注意散热、稳定性和硬件寿命。 + +:::warning + +超频有风险,需谨慎操作。此处以 ROCK 4SE 为例 + +::: + +- 查看当前频率 + +```bash + +cat /sys/devices/system/cpu/cpu*/cpufreq/scaling_cur_freq +408000 +408000 +408000 +408000 +408000 +408000 + +``` + +- 使用 rsetup 开启超频的 Overlay + +- 查看超频后的频率 + +```bash + +cat /sys/devices/system/cpu/cpu*/cpufreq/scaling_cur_freq +1512000 +1512000 +1512000 +1512000 +1800000 +1800000 + +``` + +- 验证稳定性 + + - 开启终端,进行压测 + + ```bash + + stress -c 6 -t 600 + + ``` + + - 新开一个终端,同时监控当前频率 + + ```bash + + watch -n 1 "cat /sys/devices/system/cpu/cpu*/cpufreq/scaling_cur_freq" + + ``` + + 如果压测时的频率与超频后的频率保持一致,且稳定不变的话,则说明超频成功,如果压测的频率会小于超频后的频率,则说明超频失败。 + +## 定频 + +定频是将硬件频率固定在某一值,避免动态调整,以获得稳定的性能表现。 + +:::tip + +此处以 ROCK 4SE 为例 + +::: + +- 查看大小核支持的频率 + +```bash + +radxa@rock-4se:~$ cat /sys/devices/system/cpu/cpu0/cpufreq/scaling_available_frequencies +408000 600000 816000 1008000 1512000 +radxa@rock-4se:~$ cat /sys/devices/system/cpu/cpu4/cpufreq/scaling_available_frequencies +408000 600000 816000 1008000 1200000 1416000 1512000 1800000 + +``` + +- 查看当前频率 + +```bash + +radxa@rock-4se:~$ cat /sys/devices/system/cpu/cpufreq/policy0/scaling_cur_freq +408000 +radxa@rock-4se:~$ cat /sys/devices/system/cpu/cpufreq/policy4/scaling_cur_freq +408000 + +``` + +- 设置使用自定义频率 + +```bash + +radxa@rock-4se:~$ echo userspace | sudo tee /sys/devices/system/cpu/cpufreq/policy0/scaling_governor +userspace +radxa@rock-4se:~$ echo userspace | sudo tee /sys/devices/system/cpu/cpufreq/policy4/scaling_governor +userspace + +``` + +- 写入频率 + +```bash + +echo 1008000 | sudo tee /sys/devices/system/cpu/cpufreq/policy0/scaling_setspeed +1008000 + +echo 1512000 | sudo tee /sys/devices/system/cpu/cpufreq/policy4/scaling_setspeed +1512000 +radxa@rock-4se:~$ + +``` + +- 查看是否成功写入 + +```bash + +radxa@rock-4se:~$ cat /sys/devices/system/cpu/cpufreq/policy0/scaling_cur_freq +1008000 +radxa@rock-4se:~$ cat /sys/devices/system/cpu/cpufreq/policy4/scaling_cur_freq +1512000 + +``` + +## 设置 CPU 为性能模式 + +设置 CPU 为性能模式也是一种提升 CPU 性能的方法 + +- 设置性能模式 + +```bash + +radxa@rock-4se:~$ echo performance | sudo tee /sys/devices/system/cpu/cpufreq/policy0/scaling_governor +performance +radxa@rock-4se:~$ echo performance | sudo tee /sys/devices/system/cpu/cpufreq/policy4/scaling_governor +performance + +``` + +- 查看是否设置成功 + +```bash + +radxa@rock-4se:~$ cat /sys/devices/system/cpu/cpufreq/policy4/scaling_governor +performance +radxa@rock-4se:~$ cat /sys/devices/system/cpu/cpufreq/policy0/scaling_governor +performance + +``` diff --git a/docs/rock4/rock4ab-se/getting-started/interface-usage/csi.md b/docs/rock4/rock4ab-se/getting-started/interface-usage/csi.md new file mode 100644 index 000000000..856c3a75f --- /dev/null +++ b/docs/rock4/rock4ab-se/getting-started/interface-usage/csi.md @@ -0,0 +1,55 @@ +--- +sidebar_position: 3 +--- + +import CAMERA from "../../../../common/accessories/\_camera-usage.mdx"; + +# MIPI CSI 接口 + +## 支持列表 + + + + + + + + + + + + + + + + + + + + + + + + + + + +
Camera NameSensor 型号分辨率
OKDO 5MP CameraOV5647500 万 像素
Radxa Camera 8M 219IMX219800 万 像素
Raspberry Pi Camera V2IMX219800 万 像素
Raspberry Pi Camera v1.3OV5647500 万 像素
+ +## 配件的使用 + +### OKDO 5MP Camera + + + +### Radxa Camera 8M 219 + + + +### Raspberry Pi Camera V2 + + + +### Raspberry Pi Camera v1.3 + + diff --git a/docs/rock4/rock4ab-se/getting-started/interface-usage/dsi.md b/docs/rock4/rock4ab-se/getting-started/interface-usage/dsi.md new file mode 100644 index 000000000..ee9b3552c --- /dev/null +++ b/docs/rock4/rock4ab-se/getting-started/interface-usage/dsi.md @@ -0,0 +1,36 @@ +--- +sidebar_position: 4 +--- + +import DISPLAY from "../../../../common/accessories/\_display-usage.mdx"; + +# MIPI DSI 接口 + + + + + + + + + + + + + + + + + + +
Screen Name分辨率
Radxa Display 8 HD1280x800 像素
Radxa Display 10HD1200x1920 像素
Raspberry Pi 7 inch Touchscreen800 x 480 像素
+ +## 配件使用 + +### 瑞莎 8 寸 HD 高清显示屏 + + + +### 树莓派 7 寸触控显示屏 + + diff --git a/docs/rock4/rock4ab-se/getting-started/interface-usage/eth.md b/docs/rock4/rock4ab-se/getting-started/interface-usage/eth.md new file mode 100644 index 000000000..fa4cbc77f --- /dev/null +++ b/docs/rock4/rock4ab-se/getting-started/interface-usage/eth.md @@ -0,0 +1,15 @@ +--- +sidebar_position: 5 +--- + +import ETH from "../../../../common/accessories/\_ethernet.mdx"; + +# 以太网接口 + +## 以太网接口的测试 + + + +## 瑞莎 23 W PoE HAT + +请参考 [PoE HAT 的使用](./poe-hat)。 diff --git a/docs/rock4/rock4ab-se/getting-started/interface-usage/gpio-headers.md b/docs/rock4/rock4ab-se/getting-started/interface-usage/gpio-headers.md new file mode 100644 index 000000000..4e39ca753 --- /dev/null +++ b/docs/rock4/rock4ab-se/getting-started/interface-usage/gpio-headers.md @@ -0,0 +1,36 @@ +--- +sidebar_position: 6 +--- + +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'; +import LCD35 from '../../../../common/accessories/\_waveshare-35-display.mdx'; + +# 40-PIN GPIO Headers + +## GPIO + + + +## I2C + + + +## PWM + + + +## SPI + + + +## UART + + + +## 微雪 3.5 inch SPI TFT LCD 屏幕 + + diff --git a/docs/rock4/rock4ab-se/getting-started/interface-usage/hdmi.md b/docs/rock4/rock4ab-se/getting-started/interface-usage/hdmi.md new file mode 100644 index 000000000..ca11a0192 --- /dev/null +++ b/docs/rock4/rock4ab-se/getting-started/interface-usage/hdmi.md @@ -0,0 +1,11 @@ +--- +sidebar_position: 7 +--- + +import HDMI from "../../../../common/accessories/\_hdmi.mdx"; + +# HDMI 接口 + +## 接口测试方法 + + diff --git a/docs/rock4/rock4ab-se/getting-started/interface-usage/headphone-jack.md b/docs/rock4/rock4ab-se/getting-started/interface-usage/headphone-jack.md new file mode 100644 index 000000000..3f7de1d69 --- /dev/null +++ b/docs/rock4/rock4ab-se/getting-started/interface-usage/headphone-jack.md @@ -0,0 +1,11 @@ +--- +sidebar_position: 8 +--- + +# 耳机接口 + +import HeadphoneJackOutput from "../../../../common/accessories/\_headphone-jack-output.mdx"; + +## 音频播放 + + diff --git a/docs/rock4/rock4ab-se/getting-started/interface-usage/pcie-m-key.md b/docs/rock4/rock4ab-se/getting-started/interface-usage/pcie-m-key.md new file mode 100644 index 000000000..58d7c402e --- /dev/null +++ b/docs/rock4/rock4ab-se/getting-started/interface-usage/pcie-m-key.md @@ -0,0 +1,9 @@ +--- +sidebar_position: 9 +--- + +import PCIe_M from "../../../../common/accessories/\_pcie-m-key.mdx"; + +# PCIe M Key + + diff --git a/docs/rock4/rock4ab-se/getting-started/interface-usage/penta-hat.md b/docs/rock4/rock4ab-se/getting-started/interface-usage/penta-hat.md new file mode 100644 index 000000000..3254c89fc --- /dev/null +++ b/docs/rock4/rock4ab-se/getting-started/interface-usage/penta-hat.md @@ -0,0 +1,7 @@ +--- +sidebar_position: 10 +--- + +# Penta SATA HAT 的使用 + +- 参考文档 [瑞莎 Penta SATA 扩展板](/accessories/penta-sata-hat/raid-with-mdadm) diff --git a/docs/rock4/rock4ab-se/getting-started/interface-usage/poe-hat.md b/docs/rock4/rock4ab-se/getting-started/interface-usage/poe-hat.md new file mode 100644 index 000000000..d3267cd9a --- /dev/null +++ b/docs/rock4/rock4ab-se/getting-started/interface-usage/poe-hat.md @@ -0,0 +1,17 @@ +--- +sidebar_position: 11 +--- + +import PoE from "../../../../common/accessories/\_poe-hat.mdx"; + +# PoE HAT 的使用 + +ROCK 4B/4B+/4SE 千兆以太网端口(靠近 USB)支持 PoE,带有附加 瑞莎 23 W PoE HAT。 + +:::tip + +ROCK 4A/4A+ 不支持 PoE。 + +::: + + diff --git a/docs/rock4/rock4ab-se/getting-started/interface-usage/rtc.md b/docs/rock4/rock4ab-se/getting-started/interface-usage/rtc.md new file mode 100644 index 000000000..713f957f3 --- /dev/null +++ b/docs/rock4/rock4ab-se/getting-started/interface-usage/rtc.md @@ -0,0 +1,9 @@ +--- +sidebar_position: 12 +--- + +import RTC from "../../../../common/accessories/\_rtc.mdx"; + +# RTC 的使用 + + diff --git a/docs/rock4/rock4ab-se/getting-started/interface-usage/usb.md b/docs/rock4/rock4ab-se/getting-started/interface-usage/usb.md new file mode 100644 index 000000000..8306f2296 --- /dev/null +++ b/docs/rock4/rock4ab-se/getting-started/interface-usage/usb.md @@ -0,0 +1,9 @@ +--- +sidebar_position: 14 +--- + +import USB from "../../../../common/accessories/\_usb.mdx"; + +# USB + + diff --git a/docs/rock4/rock4ab-se/getting-started/interface-usage/witibt.md b/docs/rock4/rock4ab-se/getting-started/interface-usage/witibt.md new file mode 100644 index 000000000..2cf5a7a42 --- /dev/null +++ b/docs/rock4/rock4ab-se/getting-started/interface-usage/witibt.md @@ -0,0 +1,9 @@ +--- +sidebar_position: 15 +--- + +import WIFI_BT from "../../../../common/accessories/\_wifi-bt.mdx"; + +# WIFI-BT + + diff --git a/docs/rock4/rock4ab-se/getting-started/introduction.md b/docs/rock4/rock4ab-se/getting-started/introduction.md new file mode 100644 index 000000000..cdf510eda --- /dev/null +++ b/docs/rock4/rock4ab-se/getting-started/introduction.md @@ -0,0 +1,166 @@ +--- +sidebar_position: 1 +--- + +# 产品介绍 + +## 主要特性 + +ROCK 4A/ROCK 4A+/ROCK 4B/ROCK 4B+/ROCK 4SE 是一款超小型单板计算机 (SBC),具有领先的性能和出色的机械兼容性。Radxa ROCK 4A 为创客、物联网爱好者、业余爱好者、PC DIY 爱好者及其他人士提供了一个可靠且功能强大的平台,让他们可以构建和修补自己的想法,并将其变为现实。 + +### 接口丰富 + +ROCK 4A/ROCK 4A+/ROCK 4B/ROCK 4B+/ROCK 4SE 提供了丰富的接口,包括多个 USB 、HDMI 等接口,便于连接外部设备和扩展功能。详见详见[参数配置](#参数配置)。 + +### 配件生态丰富 + +ROCK 4A/ROCK 4A+/ROCK 4B/ROCK 4B+/ROCK 4SE 支持多款摄像头和显示屏, 另外 40-PIN 兼容市面上大多数的传感器模块。 + +### 强大的多媒体处理能力 + +- GPU 部分则集成了 Arm Mali™ T860MP4 GPU,支持 OpenGL® ES 1.1/2.0/3.0/3.1/3.2、Vulkan® 1.0、Open CL® 1.1/1.2/DirectX® 11.1 等多种图形接口,可提供高效流畅的图形处理体验。 + +### 丰富的操作系统支持 + +支持多种操作系统,包括 Radxa 官方的发行的 Debian 系统和 Android 系统,另外还有一些第三方操作系统,适用于各类应用场景。 + +### 开源支持 + +ROCK 4A/ROCK 4A+/ROCK 4B/ROCK 4B+/ROCK 4SE 提供了完整的硬件设计原理图和软件源代码,这一特性使得大多 DIY 设计爱好者和开发者进行个性化修改和功能拓展,吸引了一众开源爱好者活跃在社区,有利于促进知识共享和技术创新。 + +### 可用性强 + +瑞莎团队对 ROCK 4 所有型号都提供支持到至少 2029 年。 + +## 主办预览 + + + + + rock4a real + + + + rock4b real + + + + rock4ap real + + + + rock4bp real + + + + rock4se real + + + + +## 参数配置 + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + +
Model ROCK 4A ROCK 4B ROCK 4A+ ROCK 4B+ ROCK 4SE
CPU 64 位六核处理器
Rockchip RK3399 SoC
双 Cortex-A72, 频率 1.8 GHz, 最高可达 2.0 GHz 带四核 Cortex-A53, 频率 1.4 GHz
64 位六核处理器
Rockchip OP1 SoC
双 Cortex-72,频率 2.0 GHz, 最高可达 2.2/2.4 GHz,带 Cortex-A53,频率 1.5 GHz
64 位六核处理器
Rockchip RK3399-T SoC
双 Cortex-A72, 频率 1.5 GHz, 最高可达 1.8 GHz, 带四核 Cortex-A53, 频率 1.4 GHz
GPU GPU 集成了 Arm Mali™ T860MP4 GPU,支持:
OpenGL® ES 1.1/2.0/3.0/3.1/3.2
Vulkan® 1.0
Open CL® 1.1/1.2
DirectX® 11.1
内存 64 位双通道 LPDDR4@3200Mb/s
2GB/4GB 可选
64 位双通道 LPDDR4@3200Mb/s
1GB/2GB/4GB 可选
64 位双通道 LPDDR4@3200Mb/s
4GB
储存 eMMC 连接器
μSD card (μSD 插槽最大支持 256 GB μSD 卡)
M.2 SSD (M.2 连接器支持高达 2T 的 NVMe SSD)
不支持 M.2 SATA 固态硬盘
板载 eMMC,最高可提供 128 GB 版本
μSD card (μSD 插槽最大支持 256 GB μSD 卡)
M.2 SSD (M.2 连接器支持高达 2T 的 NVMe SSD)
eMMC 连接器
μSD card (μSD 插槽最大支持 256 GB μSD 卡)
M.2 SSD (M.2 连接器支持高达 2T 的 NVMe SSD)
不支持 M.2 SATA 固态硬盘
显示 标准 HDMI 2.0,最高 4k@60
通过 FPC 连接器的 MIPI DSI 2 通道
HDMI 和 MIPI DSI 可同时工作,支持镜像模式或扩展模式
音频 3.5mm 带麦克风插孔
ES8316 高清编解码器最高支持 24 位/96KHz 音频
摄像头 通过 FPC 连接器 2 通道的 MIPI CSI ,支持高达 800 万像素摄像头 (1 毫米间距连接器)
硬件编解码 H.265/VP9 (HEVC) 硬件解码(高达 4Kp60)
H.264 硬件解码 (最高 1080p60)
USB USB2 HOST 端口 x2
USB3 HOST 端口 x1
USB3 OTG 端口 x1
以太网 GbE LAN 支持以太网供电(PoE)的千兆以太网局域网
支持瑞莎 23 W PoE HAT 供电
GbE LAN 支持以太网供电(PoE)的千兆以太网局域网
支持瑞莎 23 W PoE HAT 供电
无线网络 N/A WiFi5/BT5(AP6256 模块),板载天线或外置天线 N/A WiFi5/BT5(AP6256 模块),板载天线或外置天线 WiFi5/BT5(AW-CM256 模块),板载天线(可根据要求外接天线)
40-PIN 40-pin expansion header
2 x UART
2 x SPI bus
3 x I2C bus
1 x PCM/I2S
1 x SPDIF
2 x PWM
1 x ADC
27 x GPIO
2 x 5V DC power in
2 x 3.3V DC 电源输入
SPI Flash 4MNone
其他 RTC
用于时间备份的 RTC 电池连接器(可选)
Size 85 mm x 56 mm
diff --git a/docs/rock4/rock4ab-se/getting-started/power-supply.md b/docs/rock4/rock4ab-se/getting-started/power-supply.md new file mode 100644 index 000000000..d58184e67 --- /dev/null +++ b/docs/rock4/rock4ab-se/getting-started/power-supply.md @@ -0,0 +1,35 @@ +--- +sidebar_position: 6 +--- + +# 电源选择 + +ROCK 4A/4B/4A+/4B+ 支持多种供电方式、智能电源适配器以及固定电压: + + + + + - USB PD 2.0 支持 USB C 类 PD 2.0、9V/2A、12V/2A、15V/2A、20V/2A + - Qualcomm® Quick Charge™ 2.0 支持 QC3.0/2.0 适配器,9V/2A、12V/1.5A + - 电源适配器的 USB C 电源端口可提供 6V 至 24V 的固定电压 + - 来自 GPIO 引脚 2 和 4 的 5V 电源 + - ROCK 4B 千兆以太网端口(靠近 USB)支持 PoE,带有附加 瑞莎 23 W PoE HAT + + + + + - USB Type-C™ PD 2.0、9V/2A、12V/2A + - Qualcomm® Quick Charge™ 2.0 QC3.0/2.0 适配器,9V/2A、12V/1.5A + - USB C 电源端口上有 6V 至 12V 固定电压的电源适配器 + - 来自 GPIO 引脚 2 和 4 的 5V 电源 + - ROCK 4B+ 千兆以太网端口(靠近 USB)支持 PoE,带有附加 瑞莎 23 W PoE HAT + + + + + +:::tip + +推荐使用官方 30W 适配器 [瑞莎 PD 30W 适配器](../../../accessories/pd_30w) + +::: diff --git a/docs/rock4/rock4ab-se/getting-started/quick-start.md b/docs/rock4/rock4ab-se/getting-started/quick-start.md new file mode 100644 index 000000000..bdfeeee37 --- /dev/null +++ b/docs/rock4/rock4ab-se/getting-started/quick-start.md @@ -0,0 +1,88 @@ +--- +sidebar_position: 2 +--- + +import Package from "./\_package.mdx" + +# 快速上手 + +## 包装清单 + + + + + rock4a package + + + + + + rock4b package + + + + + + + rock4ap package + + + + + + rock4bp package + + + + + + rock4se package + + + + + + +要启动 ROCK 4A/4B/4A+/4B+/4SE,您还需要以下设备: + +- 一个 12V/2A 或更高功率的 PD 适配器。其中 ROCK 4B/4B+/4SE 还支持 PoE 供电。更过供电详情,请参考[电源方案](./power-supply)。 + +- 一个 HDMI 线和一个支持 HDMI 的显示器,推荐分辨率为 1080P 或更高,4K 显示器将提供最佳体验。 + +- 一套 USB 鼠标和键盘,常见的 USB 输入设备均支持即插即用。 + +- 一根网线,更新系统时需要联网。 + +:::tip +电源适配器推荐使用官方的 [瑞莎 PD30W 适配器](../../../accessories/pd_30w)。 +::: + +非必需但可增强 ROCK 4A/4B/4A+/4B+/4SE 基本功能的外设: + +- 散热片 + +- M.2 NVMe SSD。推荐在 M.2 NVMe SSD 上安装操作系统。 + +## 接线和上电 + +1. 通过 HDMI 线将 ROCK 4A/4B/4A+/4B+/4SE 的任一 HDMI 输出接口连接到 HDMI 显示器。 + +rock4 hdmi + +2. 将 USB 鼠标和键盘连接到 ROCK 4A/4B/4A+/4B+/4SE 的任一 USB 2.0 或 3.0 接口。 + +rock4 usb + +3. 将网线连接到以太网口。 + +rock4 ethernet + +4. 如果有 M.2 Wi-Fi 模块或 SSD,使用提供的 M.2 螺丝安装并固定。 + +5. 将电源适配器插入 ROCK 4A/4B/4A+/4B+/4SE 的电源接口。设备上电启动,电源指示灯将亮起。 + +rock4 pwr + +:::tip +系统从上电到开机启动,整个过程持续约 40 秒,然后进入系统桌面。 +::: diff --git a/docs/rock4/rock4ab-se/hardware-design/README.md b/docs/rock4/rock4ab-se/hardware-design/README.md new file mode 100644 index 000000000..a408647f9 --- /dev/null +++ b/docs/rock4/rock4ab-se/hardware-design/README.md @@ -0,0 +1,9 @@ +--- +sidebar_position: 5 +--- + +# 硬件信息 + +介绍 ROCK 4A/4B/4SE 硬件信息,如各种接口说明、板级硬件数据表、所用设备的数据表等。 + + diff --git a/docs/rock4/rock4ab-se/hardware-design/hardware-interface.md b/docs/rock4/rock4ab-se/hardware-design/hardware-interface.md new file mode 100644 index 000000000..a277943f8 --- /dev/null +++ b/docs/rock4/rock4ab-se/hardware-design/hardware-interface.md @@ -0,0 +1,246 @@ +--- +sidebar_position: 1 +--- + +import GPIO from '../../\_rock4-gpio.mdx'; + +# 硬件接口说明 + +## 芯片框图 + + + + + rk3399 block diagram + + + + rk3399-t block diagram + + + + +## 实物照片 + + + + + rock4a real + + + + rock4b real + + + + rock4ap real + + + + rock4bp real + + + + rock4se real + + + + +## 接口详情 + +### 40-PIN GPIO Header + + + +### eMMC Connector + +| Pin | Name | Pin | Name | +| :-: | :-----: | :-: | :--------: | +| 1 | VCC_1V8 | 2 | VCC3V3_SYS | +| 3 | VCC_1V8 | 4 | VCC3V3_SYS | +| 5 | VCC_1V8 | 6 | VCC3V3_SYS | +| 7 | VCC_1V8 | 8 | VCC3V3_SYS | +| 9 | VCC_1V8 | 10 | GND | +| 11 | GND | 12 | eMMC_RST | +| 13 | GND | 14 | eMMC_CLK | +| 15 | GND | 16 | eMMC_CMD | +| 17 | GND | 18 | eMMC_D7 | +| 19 | GND | 20 | eMMC_D6 | +| 21 | GND | 22 | eMMC_D5 | +| 23 | GND | 24 | eMMC_D4 | +| 25 | GND | 26 | eMMC_D3 | +| 27 | GND | 28 | eMMC_D2 | +| 29 | GND | 30 | eMMC_D1 | +| 31 | GND | 32 | eMMC_D0 | +| 33 | NC | 34 | eMMC_DQS | +| 35 | NC | 36 | NC | +| 37 | NC | 38 | NC | +| 39 | | 40 | NC | +| 41 | | 42 | NC | + +### HDMI + +| Pin | Name | Pin | Name | +| :-: | :-------: | :-: | :---------: | +| 1 | HDMI_TX2P | 2 | GND | +| 3 | HDMI_TX2N | 4 | HDMI_TX1P | +| 5 | GND | 6 | HDMI_TX1N | +| 7 | HDMI_TX0P | 8 | GND | +| 9 | HDMI_TX0N | 10 | HDMI_TXCP | +| 11 | GND | 12 | HDMI_TXCN | +| 13 | PORT_CEC | 14 | NC | +| 15 | DDC_SCL | 16 | DDC_SDA | +| 17 | GND | 18 | VCC5V0_HDMI | +| 19 | HDMI_HPD | 20 | GND | +| 21 | GND | 22 | GND | +| 23 | GND | 24 | | + +### MicroSD + +| 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 | + +### MIPI CSI + +| Pin | Name | +| :-: | :-----------: | +| 1 | VCC_CAM | +| 2 | I2C4_SCL | +| 3 | I2C4_SDA | +| 4 | CAM_MCLK | +| 5 | CAM_GPIO1 | +| 6 | GND | +| 7 | MIPI_RX0_CLKP | +| 8 | MIPI_RX0_CLKN | +| 9 | GND | +| 10 | MIPI_RX0_D1P | +| 11 | MIPI_RX0_D1N | +| 12 | GND | +| 13 | MIPI_RX0_D0P | +| 14 | MIPI_RX0_D0N | +| 15 | GND | + +### MIPI DSI + +| Pin | Name | +| :-: | :-------------: | +| 1 | VCC_MIPI | +| 2 | VCC_MIPI | +| 3 | GND | +| 4 | I2C_SDA_AUDIO | +| 5 | I2C_SCL_AUDIO | +| 6 | GND | +| 7 | MIPI_TX/RX_D0P | +| 8 | MIPI_TX/RX_D0N | +| 9 | GND | +| 10 | MIPI_TX/RX_CLKP | +| 11 | MIPI_TX/RX_CLKN | +| 12 | GND | +| 13 | MIPI_TX/RX_D1P | +| 14 | MIPI_TX/RX_D1N | +| 15 | GND | + +### PCIe + +| Pin | Name | Pin | Name | +| :-: | :------------: | :-: | :-----------: | +| 1 | GND | 2 | VCC3V3_PCIE | +| 3 | GND | 4 | VCC3V3_PCIE | +| 5 | PCIE_RX3_N | 6 | NC | +| 7 | PCIE_RX3_P | 8 | NC | +| 9 | GND | 10 | NC | +| 11 | PCIE_TX3N | 12 | VCC3V3_PCIE | +| 13 | PCIE_TX3P | 14 | VCC3V3_PCIE | +| 15 | GND | 16 | VCC3V3_PCIE | +| 17 | PCIE_RX2_N | 18 | VCC3V3_PCIE | +| 19 | PCIE_RX2_P | 20 | NC | +| 21 | GND | 22 | NC | +| 23 | PCIE_TX2N | 24 | NC | +| 25 | PCIE_TX2P | 26 | NC | +| 27 | GND | 28 | NC | +| 29 | PCIE_RX1_N | 30 | NC | +| 31 | PCIE_RX1_P | 32 | NC | +| 33 | GND | 34 | NC | +| 35 | PCIE_TX1N | 36 | NC | +| 37 | PCIE_TX1P | 38 | NC | +| 39 | GND | 40 | NC | +| 41 | PCIE_RX0_N | 42 | NC | +| 43 | PCIE_RX0_P | 44 | NC | +| 45 | GND | 46 | NC | +| 47 | PCIE_TX0N | 48 | NC | +| 49 | PCIE_TX0P | 50 | PCIE_PERST_L | +| 51 | GND | 52 | PCIE_CLKREQ_L | +| 53 | PCIE_REF_CLK_N | 54 | NC | +| 55 | PCIE_REF_CLK_P | 56 | NC | +| 57 | GND | 58 | NC | +| | | | | +| 67 | NC | 68 | NC | +| 69 | NC | 70 | VCC3V3_PCIE | +| 71 | GND | 72 | VCC3V3_PCIE | +| 73 | GND | 74 | VCC3V3_PCIE | +| 75 | GND | 76 | GND | +| 77 | GND | | | + +### USB + +- USB 2.0 + +| Pin | Name | +| :-: | :--------------: | +| 1 | HOST0_DP | +| 2 | HOST0_DM | +| 3 | TYPEC0_DP | +| 4 | TYPEC0_DM | +| 5 | TYPEC0_ID | +| 6 | TYPEC0_U2VBUSDET | +| 7 | GND | +| 8 | HOST1_DP | +| 9 | HOST1_DM | +| 10 | USB3_DP | +| 11 | USB3_DM | +| 12 | NC | +| 13 | NC | +| 14 | GND | +| 15 | VCC_0V9 | +| 16 | VCCA_1V8 | +| 17 | VCC3V3_SYS | + +- USB 3.0 + +| Pin | Name | +| :-: | :---------: | +| 1 | USB3_SSTX1P | +| 2 | USB3_SSTX1N | +| 3 | USB3_SSRX1P | +| 4 | USB3_SSRX1N | +| 5 | NC | +| 6 | NC | +| 7 | NC | +| 8 | NC | +| 9 | NC | +| 10 | NC | +| 11 | NC | +| 12 | NC | +| 13 | NC | +| 14 | NC | +| 15 | NC | +| 16 | NC | +| 17 | NC | +| 18 | GND | +| 19 | VCC_0V9 | +| 20 | VCC_0V9 | +| 21 | VCCA_1V8 | +| 22 | VCC3V3_SYS | diff --git a/docs/rock4/rock4se/low-level-dev/README.md b/docs/rock4/rock4ab-se/low-level-dev/README.md similarity index 82% rename from docs/rock4/rock4se/low-level-dev/README.md rename to docs/rock4/rock4ab-se/low-level-dev/README.md index ec8364e2b..817ef793b 100644 --- a/docs/rock4/rock4se/low-level-dev/README.md +++ b/docs/rock4/rock4ab-se/low-level-dev/README.md @@ -1,5 +1,5 @@ --- -sidebar_position: 40 +sidebar_position: 7 --- # 底层开发 diff --git a/docs/rock4/rock4ab-se/low-level-dev/kernel.md b/docs/rock4/rock4ab-se/low-level-dev/kernel.md new file mode 100644 index 000000000..151ddd4a8 --- /dev/null +++ b/docs/rock4/rock4ab-se/low-level-dev/kernel.md @@ -0,0 +1,9 @@ +--- +sidebar_position: 3 +--- + +import KERNEL from '../../../common/dev/\_kernel.mdx' + +# Kernel 开发 + + diff --git a/docs/rock4/rock4ab-se/low-level-dev/maskrom/README.md b/docs/rock4/rock4ab-se/low-level-dev/maskrom/README.md new file mode 100644 index 000000000..569baf117 --- /dev/null +++ b/docs/rock4/rock4ab-se/low-level-dev/maskrom/README.md @@ -0,0 +1,5 @@ +--- +sidebar_position: 1 +--- + +# 通过 USB 刷机 diff --git a/docs/rock4/rock4ab-se/low-level-dev/maskrom/erase.md b/docs/rock4/rock4ab-se/low-level-dev/maskrom/erase.md new file mode 100644 index 000000000..bd7d52dab --- /dev/null +++ b/docs/rock4/rock4ab-se/low-level-dev/maskrom/erase.md @@ -0,0 +1,44 @@ +--- +sidebar_position: 4 +description: "通过 Maskrom 清除 eMMC 或者 SPI Flash" +--- + +import ERASE from "../../../../common/dev/\_erase-spi-emmc.mdx"; + +# 清除 eMMC 或者 SPI Flash + + + + + + + +
    +
  1. 移除 MicroSD 卡, 断开电源
  2. +
  3. 如果板上有一个 SPI Nor Flash,则将 SPI Nor Flash 短路
  4. +
  5. 使用 USB-A 转 USB-A 线从 OTG 端口连接 PC 主机
  6. +
  7. 按住 Maskrom 按键
  8. +
  9. 插入电源线上电并释放 Maskrom 按键,如果电源绿灯常亮则成功进入 Maskrom 模式
  10. +
+ + rock 4 maskrom button + +
+ + + +
    +
  1. 移除 MicroSD 卡, 断开电源
  2. +
  3. 如果板上有一个 SPI Nor Flash,则将 SPI Nor Flash 短路
  4. +
  5. 使用 USB-A 转 USB-A 线从 OTG 端口连接 PC 主机
  6. +
  7. 插入电源线上电,如果电源绿灯常亮则成功进入 Maskrom 模式
  8. +
  9. 插入 eMMC module
  10. +
+ +
+ +
+ +rock 4 with no button maskrom wire + +
diff --git a/docs/rock4/rock4ab-se/low-level-dev/maskrom/linux.md b/docs/rock4/rock4ab-se/low-level-dev/maskrom/linux.md new file mode 100644 index 000000000..4001bea0d --- /dev/null +++ b/docs/rock4/rock4ab-se/low-level-dev/maskrom/linux.md @@ -0,0 +1,48 @@ +--- +sidebar_position: 1 +description: "Linux 下通过 USB 刷机" +--- + +import Rkdeveloptool from "../../../../common/dev/\_rkdeveloptoolV2.mdx"; + +# Linux 主机 + +## 文件下载 + +到资源下载汇总页面下载 [ROCK 4A/4B/4SE 系统镜像](../../download) + + + + + + + +
    +
  1. 移除 MicroSD 卡, 断开电源
  2. +
  3. 如果板上有一个 SPI Nor Flash,则将 SPI Nor Flash 短路
  4. +
  5. 使用 USB-A 转 USB-A 线从 OTG 端口连接 PC 主机
  6. +
  7. 按住 Maskrom 按键
  8. +
  9. 插入电源线上电并释放 Maskrom 按键,如果电源绿灯常亮则成功进入 Maskrom 模式
  10. +
+ + rock 4 maskrom button + +
+ + + +
    +
  1. 移除 MicroSD 卡, 断开电源
  2. +
  3. 如果板上有一个 SPI Nor Flash,则将 SPI Nor Flash 短路
  4. +
  5. 使用 USB-A 转 USB-A 线从 OTG 端口连接 PC 主机
  6. +
  7. 插入电源线上电,如果电源绿灯常亮则成功进入 Maskrom 模式
  8. +
  9. 插入 eMMC module
  10. +
+ +
+ +
+ +rock 4 with no button maskrom wire + +
diff --git a/docs/rock4/rock4ab-se/low-level-dev/maskrom/macos.md b/docs/rock4/rock4ab-se/low-level-dev/maskrom/macos.md new file mode 100644 index 000000000..5b6800b9e --- /dev/null +++ b/docs/rock4/rock4ab-se/low-level-dev/maskrom/macos.md @@ -0,0 +1,48 @@ +--- +sidebar_position: 2 +description: "MacOS 下通过 USB 刷机" +--- + +import Rkdeveloptool from "../../../../common/dev/\_rkdeveloptoolV2.mdx"; + +# Mac OS 主机 + +## 文件下载 + +到资源下载汇总页面下载 [ROCK 4A/4B/4SE 系统镜像](../../download) + + + + + + + +
    +
  1. 移除 MicroSD 卡, 断开电源
  2. +
  3. 如果板上有一个 SPI Nor Flash,则将 SPI Nor Flash 短路
  4. +
  5. 使用 USB-A 转 USB-A 线从 OTG 端口连接 PC 主机
  6. +
  7. 按住 Maskrom 按键
  8. +
  9. 插入电源线上电并释放 Maskrom 按键,如果电源绿灯常亮则成功进入 Maskrom 模式
  10. +
+ + rock 4 maskrom button + +
+ + + +
    +
  1. 移除 MicroSD 卡, 断开电源
  2. +
  3. 如果板上有一个 SPI Nor Flash,则将 SPI Nor Flash 短路
  4. +
  5. 使用 USB-A 转 USB-A 线从 OTG 端口连接 PC 主机
  6. +
  7. 插入电源线上电,如果电源绿灯常亮则成功进入 Maskrom 模式
  8. +
  9. 插入 eMMC module
  10. +
+ +
+ +
+ +rock 4 with no button maskrom wire + +
diff --git a/docs/rock4/rock4ab-se/low-level-dev/maskrom/windows.md b/docs/rock4/rock4ab-se/low-level-dev/maskrom/windows.md new file mode 100644 index 000000000..94b8a7d25 --- /dev/null +++ b/docs/rock4/rock4ab-se/low-level-dev/maskrom/windows.md @@ -0,0 +1,48 @@ +--- +sidebar_position: 3 +description: "Windows 下通过 USB 刷机" +--- + +import Rkdevtool from "../../../../common/dev/\_rkdevtoolV2.mdx"; + +# Windows 主机 + +## 文件下载 + +到资源下载汇总页面下载 [ROCK 4A/4B/4SE 系统镜像](../../download) + + + + + + + +
    +
  1. 移除 MicroSD 卡, 断开电源
  2. +
  3. 如果板上有一个 SPI Nor Flash,则将 SPI Nor Flash 短路
  4. +
  5. 使用 USB-A 转 USB-A 线从 OTG 端口连接 PC 主机
  6. +
  7. 按住 Maskrom 按键
  8. +
  9. 插入电源线上电并释放 Maskrom 按键,如果电源绿灯常亮则成功进入 Maskrom 模式
  10. +
+ + rock 4 maskrom button + +
+ + + +
    +
  1. 移除 MicroSD 卡, 断开电源
  2. +
  3. 如果板上有一个 SPI Nor Flash,则将 SPI Nor Flash 短路
  4. +
  5. 使用 USB-A 转 USB-A 线从 OTG 端口连接 PC 主机
  6. +
  7. 插入电源线上电,如果电源绿灯常亮则成功进入 Maskrom 模式
  8. +
  9. 插入 eMMC module
  10. +
+ +
+ +
+ +rock 4 with no button maskrom wire + +
diff --git a/docs/rock4/rock4ab-se/low-level-dev/rootfs-armhf.md b/docs/rock4/rock4ab-se/low-level-dev/rootfs-armhf.md new file mode 100644 index 000000000..70cd0b703 --- /dev/null +++ b/docs/rock4/rock4ab-se/low-level-dev/rootfs-armhf.md @@ -0,0 +1,163 @@ +--- +sidebar_position: 5 +--- + +# 替换 32 位的根文件系统 + +## 编译 Debian 11 armhf rootfs + +### 安装必要的工具 + +```bash + +PC:~$ sudo apt install -y debootstrap + +``` + +### 创建 rootfs 目录 + +```bash + +PC:~$ mkdir rootfs + +PC:~$ cd rootfs + +``` + +### 使用 debootstrap 生成 Debian 11 armhf rootfs + +```bash + +PC:~$ sudo debootstrap --arch armhf bullseye rootfs http://mirrors.tuna.tsinghua.edu.cn/debian + +``` + +### 切换到 armhf rootfs + +```bash + +sudo chroot rootfs bash + +``` + +### 在 armhf rootfs 中安装你需要的软件包 + +```bash + +apt update + +apt install -y sudo usbutils network-managerfdisk \ +vim nano openssh-server iputils-ping wget curl \ +iproute2 dialog locales kmod zip unzip u-boot-tools initramfs-tools + +``` + +### 创建用户 + +```bash + +adduser radxa + +gpasswd -a radxa sudo + +``` + +## 烧录 Debian 11 arm64 的镜像到 SD 卡或 eMMC 模块中 + +## 记录目标设备信息 + +### 确认目标设备 + +将刚刚烧录 Debian 11 arm64 的 SD 卡或 eMMC 模块到本地 PC 中并挂载 + +```bash + +PC:~$ lsblk +sdb 8:16 1 29.3G 0 disk +├─sdb1 8:17 1 16M 0 part +└─sdb2 8:18 1 5.1G 0 part +``` + +由此可知,我们的目标设备是 /dev/sdb2 + +### 记录 UUID + +```bash + +PC:~$ sudo blkid /dev/sdb2 +/dev/sdb2: LABEL="rootfs" UUID="8bf96d05-7c97-42fc-863c-95e3e7603ef4" BLOCK_SIZE="4096" TYPE="ext4" PARTLABEL="rootfs" PARTUUID="474d4c1f-53da-447c-bab4-334abe0d5753" +PC:~$ sudo blkid /dev/sdb1 +/dev/sdb1: LABEL_FATBOOT="config" LABEL="config" UUID="4AD5-9369" BLOCK_SIZE="512" TYPE="vfat" PARTLABEL="config" PARTUUID="8d24a074-ea49-4d24-a17c-82dd88776fa2" + +``` + +## 替换 rootfs + +### 挂载目标设备 + +```bash + +PC:~$ sudo mount /dev/sdb2 /data2 +PC:~$ cd /data2 + +``` + +### 替换 rootfs + +进入到刚刚已经挂载的根文件系统,备份启动目录,删除并替换根文件系统,然后将启动目录恢复到根文件系统 + +```bash + +PC:/data2$ sudo cp -r ./boot ~/ +PC:/data2$ sudo rm -rf * +PC:/data2$ sudo cp -av /path/to/rootfs/* ./ +PC:/data2$ sudo cp -av ~/boot/* ./boot/ + +``` + +### 修改 fstab + +```bash + +PC:/data2$ cat ./etc/fstab +### UNCONFIGURED FSTAB FOR BASE SYSTEM + +``` + +将刚刚记录的 UUID 替换到 fstab 文件中 + +```bash + +PC:/data2$ sudo cat ./etc/fstab +### UNCONFIGURED FSTAB FOR BASE SYSTEM +UUID=8bf96d05-7c97-42fc-863c-95e3e7603ef4 / ext4 defaults 0 1 +UUID=4AD5-9369 /config vfat defaults,x-systemd.automount 0 2 + +``` + +### 取消挂载 + +```bash + +radxa@radxa:/data2$ cd +radxa@radxa:~$ sudo umount /data2 + +``` + +## 检查是否是 32 位的 rootfs + +### 启动系统 + +将刚刚已替换好 rootfs 的 SD 或者 eMMC 卡插入到板子上,然后上电启动。 + +### 检查当前 rootfs是否是 32 位的 + +```bash + +radxa@rock-4se:~$ sudo apt-get install file -y +radxa@rock-4se:~$ file /bin/ls +/bin/ls: ELF 32-bit LSB pie executable, ARM, EABI5 version 1 (SYSV), dynamically linked, interpreter /lib/ld-linux-armhf.so.3, Build + +``` + +由此可知我们已经成功替换了 32 位的 rootfs diff --git a/docs/rock4/rock4ab-se/low-level-dev/rsdk.md b/docs/rock4/rock4ab-se/low-level-dev/rsdk.md new file mode 100644 index 000000000..784104346 --- /dev/null +++ b/docs/rock4/rock4ab-se/low-level-dev/rsdk.md @@ -0,0 +1,9 @@ +--- +sidebar_position: 4 +--- + +import RSDK from '../../../common/dev/\_rsdk.mdx' + +# 编译 RadxaOS + + diff --git a/docs/rock4/rock4ab-se/low-level-dev/u-boot.md b/docs/rock4/rock4ab-se/low-level-dev/u-boot.md new file mode 100644 index 000000000..461cebceb --- /dev/null +++ b/docs/rock4/rock4ab-se/low-level-dev/u-boot.md @@ -0,0 +1,9 @@ +--- +sidebar_position: 2 +--- + +import UBOOT from '../../../common/dev/\_u-boot.mdx' + +# U-boot 开发 + + diff --git a/docs/rock4/rock4ab-se/other-os/README.md b/docs/rock4/rock4ab-se/other-os/README.md new file mode 100644 index 000000000..5ef281e6a --- /dev/null +++ b/docs/rock4/rock4ab-se/other-os/README.md @@ -0,0 +1,9 @@ +--- +sidebar_position: 6 +--- + +# 其他系统 + +介绍非 Radxa OS 的其他系统,例如 Android + + diff --git a/docs/rock4/rock4ab-se/other-os/android/README.md b/docs/rock4/rock4ab-se/other-os/android/README.md new file mode 100644 index 000000000..577d7a0fd --- /dev/null +++ b/docs/rock4/rock4ab-se/other-os/android/README.md @@ -0,0 +1,9 @@ +--- +sidebar_position: 1 +--- + +# Android 系统 + +主要介绍如何构建 Android 系统以及如何使用 Android 系统。 + + diff --git a/docs/rock4/rock4ab-se/other-os/android/app-development/README.md b/docs/rock4/rock4ab-se/other-os/android/app-development/README.md new file mode 100644 index 000000000..7ae3a3a1a --- /dev/null +++ b/docs/rock4/rock4ab-se/other-os/android/app-development/README.md @@ -0,0 +1,9 @@ +--- +sidebar_position: 6 +--- + +# 应用开发 + +主要介绍上层应用开发,比如 libgpiod 等 + + diff --git a/docs/rock4/rock4ab-se/other-os/android/app-development/libgpiod.md b/docs/rock4/rock4ab-se/other-os/android/app-development/libgpiod.md new file mode 100644 index 000000000..f467cc46b --- /dev/null +++ b/docs/rock4/rock4ab-se/other-os/android/app-development/libgpiod.md @@ -0,0 +1,24 @@ +--- +sidebar_position: 7 +--- + +import GPIOD from '../../../../../common/dev/\_android-gpiod.mdx'; +import APP_DEMO from '../../../../../common/dev/\_android-gpio-app-demo.mdx'; + +# GPIO 使用 + + + + + + + + + + + + + + + + diff --git a/docs/rock4/rock4ab-se/other-os/android/download.md b/docs/rock4/rock4ab-se/other-os/android/download.md new file mode 100644 index 000000000..bea6a7ed8 --- /dev/null +++ b/docs/rock4/rock4ab-se/other-os/android/download.md @@ -0,0 +1,17 @@ +--- +sidebar_position: 2 +--- + +# 资源下载汇总 + +## 官方系统镜像 + +- [Radxa ROCK 4A/B Android 11 GPT](https://github.com/radxa/manifests/releases/download/Rock-android11-20211115_1851/rockpi-4ab-android11-20211115_1851-gpt.zip) +- [Radxa ROCK 4A/B Android 11 Update](https://github.com/radxa/manifests/releases/download/Rock-android11-20211115_1851/rockpi-4ab-android11-20211115_1851-update.zip) +- [Radxa ROCK 4B Android 11 GPT](https://github.com/radxa/manifests/releases/download/Rock4b-android11-20220819/Rock4b-android11-20220819-gpt.zip) +- [Radxa ROCK 4SE Android 11 GPT](https://github.com/radxa/manifests/releases/download/Android11_Radxa_rk11_20230526/Rock4SE_Android11_rkr11_20230526_gpt.zip) +- [Radxa ROCK 4SE Android 11 Update](https://github.com/radxa/manifests/releases/download/RockPi-android11-20220819_1707/rock4b-se-android11-20220819-1907-update.zip) + +## 第三方系统 + +- [Android TV by Mo123](https://forum.radxa.com/t/libreelec-rockpi-4/1869) diff --git a/docs/rock4/rock4ab-se/other-os/android/getting-started/README.md b/docs/rock4/rock4ab-se/other-os/android/getting-started/README.md new file mode 100644 index 000000000..dd88ab8b3 --- /dev/null +++ b/docs/rock4/rock4ab-se/other-os/android/getting-started/README.md @@ -0,0 +1,17 @@ +--- +sidebar_position: 1 +--- + +# 上手指南 + +## [产品介绍](../../../getting-started/introduction) + +## [快速开始](../../../getting-started/quickstart) + +## [系统安装](./install-os/README) + +## [应用开发](../app-development/) + +## [底层开发](../low-level-dev/) + + diff --git a/docs/rock4/rock4ab-se/other-os/android/getting-started/install-os/README.md b/docs/rock4/rock4ab-se/other-os/android/getting-started/install-os/README.md new file mode 100644 index 000000000..5b2a49695 --- /dev/null +++ b/docs/rock4/rock4ab-se/other-os/android/getting-started/install-os/README.md @@ -0,0 +1,5 @@ +--- +sidebar_position: 2 +--- + +# 系统安装 diff --git a/docs/rock4/rock4ab-se/other-os/android/getting-started/install-os/boot-from-emmc.md b/docs/rock4/rock4ab-se/other-os/android/getting-started/install-os/boot-from-emmc.md new file mode 100644 index 000000000..70a6247aa --- /dev/null +++ b/docs/rock4/rock4ab-se/other-os/android/getting-started/install-os/boot-from-emmc.md @@ -0,0 +1,97 @@ +--- +sidebar_position: 2 +--- + +import UPGRADE_TOOL from "../../../../../../common/dev/\_upgrade-tool.mdx"; + +# 安装系统到 eMMC + +我们可以直接将 Android 系统安装到 eMMC 模块中,请参考 [安装系统到 MicroSD 卡](./boot-from-sd) 章节 。 +本篇主要讲述如何通过 Maskrom 模式将 update 格式的 Android 系统安装到 ROCK 4A/4B/4A+/4B+/4SE eMMC 上。 + +## 文件下载 + +到资源下载汇总页面下载 [ROCK 4A/4B/4SE 系统镜像](../../download) + +## 进入 Maskrom 模式 + + + + + +
    +
  1. 移除 MicroSD 卡,断开电源
  2. +
  3. 如果板上有一个 SPI Nor Flash,则将 SPI Nor Flash 短路
  4. +
  5. 使用 USB-A 转 USB-A 线从 OTG 端口连接 PC 主机
  6. +
  7. 按住 Maskrom 按键
  8. +
  9. 插入电源线上电并释放 Maskrom 按键,如果电源绿灯常亮则成功进入 Maskrom 模式
  10. +
+ + rock 4 maskrom button + +
+ + + +
    +
  1. 移除 MicroSD 卡,断开电源
  2. +
  3. 如果板上有一个 SPI Nor Flash,则将 SPI Nor Flash 短路
  4. +
  5. 使用 USB-A 转 USB-A 线从 OTG 端口连接 PC 主机
  6. +
  7. 插入电源线上电,如果电源绿灯常亮则成功进入 Maskrom 模式
  8. +
  9. 插入 eMMC module
  10. +
+ +
+ +
+ +## 安装系统 + + + +
    +
  • 请下载并解压以下文件以安装 upgrade_tool:
  • + +
    +
  • 确认开发板已经进入 Maskrom 模式
  • +
    +
    +                $ sudo upgrade_tool ld
    +                Program Log will save in the /root/upgrade_tool/log/
    +                List of rockusb connected(1)
    +                DevNo=1	Vid=0x2207,Pid=0x330c,LocationID=19	Mode=Maskrom
    +                            
    +
  • 烧录 update 系统镜像
  • +
    +
    +                $ sudo upgrade_tool uf rock4xx-android-xx-update.img
    +            
    +
  • 烧录完成后系统会自动启动
  • +
+
+ +
    +
  • 请下载并解压以下文件以安装 RKDevTool:
  • + +
    +
  • 选择 "升级固件"
  • +
  • 点击 "固件" 选择 update 格式的 Android Image
  • +
  • 点击 "升级"
  • +
  • 闪存完成后,系统将自动启动
  • + rock4 flash the update format image by rkdevtool +
+
+
diff --git a/docs/rock4/rock4ab-se/other-os/android/getting-started/install-os/boot-from-sd.md b/docs/rock4/rock4ab-se/other-os/android/getting-started/install-os/boot-from-sd.md new file mode 100644 index 000000000..681bcb921 --- /dev/null +++ b/docs/rock4/rock4ab-se/other-os/android/getting-started/install-os/boot-from-sd.md @@ -0,0 +1,37 @@ +--- +sidebar_position: 1 +--- + +import Etcher from '../../../../../../common/general/\_etcherV2.mdx'; + +# 安装系统到 MicroSD 卡 + +本文介绍如何在 ROCK 4A/4B/4A+/4B+/4SE 上将系统安装到 MicroSD 卡 中,并通过 MicroSD 卡 启动系统。 + +## 文件下载 + +到资源下载汇总页面下载 [ROCK 4A/4B/4A+/4B+/4SE 系统镜像](../../download) + +## MicroSD 卡准备 + +将 MicroSD 卡插入到 SD 卡读卡器中,然后将读卡器插入到 PC 的 USB 端口上 + +## 镜像烧录 + + + +## 启动系统 + +按照上述步骤成功烧录 MicroSD Card 后, 将 MicroSD Card 插入到 MicroSD Card 插槽内(如下图所示),然后上电,系统开始启动,HDMI显示桌面。 + + + +## 登录系统 + +:::tip +Android 系统在刷机完成后的第一次启动时常相对较长,还请耐心等待 +::: diff --git a/docs/rock4/rock4ab-se/other-os/android/getting-started/power-supply.md b/docs/rock4/rock4ab-se/other-os/android/getting-started/power-supply.md new file mode 100644 index 000000000..d58184e67 --- /dev/null +++ b/docs/rock4/rock4ab-se/other-os/android/getting-started/power-supply.md @@ -0,0 +1,35 @@ +--- +sidebar_position: 6 +--- + +# 电源选择 + +ROCK 4A/4B/4A+/4B+ 支持多种供电方式、智能电源适配器以及固定电压: + + + + + - USB PD 2.0 支持 USB C 类 PD 2.0、9V/2A、12V/2A、15V/2A、20V/2A + - Qualcomm® Quick Charge™ 2.0 支持 QC3.0/2.0 适配器,9V/2A、12V/1.5A + - 电源适配器的 USB C 电源端口可提供 6V 至 24V 的固定电压 + - 来自 GPIO 引脚 2 和 4 的 5V 电源 + - ROCK 4B 千兆以太网端口(靠近 USB)支持 PoE,带有附加 瑞莎 23 W PoE HAT + + + + + - USB Type-C™ PD 2.0、9V/2A、12V/2A + - Qualcomm® Quick Charge™ 2.0 QC3.0/2.0 适配器,9V/2A、12V/1.5A + - USB C 电源端口上有 6V 至 12V 固定电压的电源适配器 + - 来自 GPIO 引脚 2 和 4 的 5V 电源 + - ROCK 4B+ 千兆以太网端口(靠近 USB)支持 PoE,带有附加 瑞莎 23 W PoE HAT + + + + + +:::tip + +推荐使用官方 30W 适配器 [瑞莎 PD 30W 适配器](../../../accessories/pd_30w) + +::: diff --git a/docs/rock4/rock4ab-se/other-os/android/low-level-dev/README.md b/docs/rock4/rock4ab-se/other-os/android/low-level-dev/README.md new file mode 100644 index 000000000..a70cc64d0 --- /dev/null +++ b/docs/rock4/rock4ab-se/other-os/android/low-level-dev/README.md @@ -0,0 +1,5 @@ +--- +sidebar_position: 5 +--- + +# 底层开发 diff --git a/docs/rock4/rock4ab-se/other-os/android/low-level-dev/android-10-low-dev.md b/docs/rock4/rock4ab-se/other-os/android/low-level-dev/android-10-low-dev.md new file mode 100644 index 000000000..69f3a8f16 --- /dev/null +++ b/docs/rock4/rock4ab-se/other-os/android/low-level-dev/android-10-low-dev.md @@ -0,0 +1,9 @@ +--- +sidebar_position: 4 +--- + +import ANDROID_LOW_DEV from '../../../../../common/android/\_low-dev.mdx'; + +# 编译 Android 10 + + diff --git a/docs/rock4/rock4ab-se/other-os/android/low-level-dev/android-11-low-dev.md b/docs/rock4/rock4ab-se/other-os/android/low-level-dev/android-11-low-dev.md new file mode 100644 index 000000000..76db143e9 --- /dev/null +++ b/docs/rock4/rock4ab-se/other-os/android/low-level-dev/android-11-low-dev.md @@ -0,0 +1,9 @@ +--- +sidebar_position: 4 +--- + +import ANDROID_LOW_DEV from '../../../../../common/android/\_low-dev.mdx'; + +# 编译 Android 11 + + diff --git a/docs/rock4/rock4ab-se/other-os/armbian.md b/docs/rock4/rock4ab-se/other-os/armbian.md new file mode 100644 index 000000000..9b1684428 --- /dev/null +++ b/docs/rock4/rock4ab-se/other-os/armbian.md @@ -0,0 +1,9 @@ +--- +sidebar_position: 2 +--- + +# Armbian 构建 + +import Armbian_Build from '../../../common/armbian/\_armbian-build.mdx'; + + diff --git a/docs/rock4/rock4ab-se/other-os/yocto.md b/docs/rock4/rock4ab-se/other-os/yocto.md new file mode 100644 index 000000000..87bf13499 --- /dev/null +++ b/docs/rock4/rock4ab-se/other-os/yocto.md @@ -0,0 +1,9 @@ +--- +sidebar_position: 6 +--- + +# Yocto 构建 + +import RKYocto from '../../../common/yocto/\_yocto-rockchip.mdx'; + + diff --git a/docs/rock4/rock4ab-se/radxa-os/README.md b/docs/rock4/rock4ab-se/radxa-os/README.md new file mode 100644 index 000000000..7190d2ee5 --- /dev/null +++ b/docs/rock4/rock4ab-se/radxa-os/README.md @@ -0,0 +1,11 @@ +--- +sidebar_position: 3 +--- + +# 瑞莎系统 + +瑞莎系统,即 Radxa OS,是由 Radxa 团队基于 Debian Linux 发行版自主研发的一套开源操作系统。Radxa OS 不仅集成了众多外设和实用的系统软件,能满足日常的办公、学习和娱乐需求,而且 Radxa 团队还自行开发了 [Rsetup](./rsetup) 这款便捷的系统配置工具,进一步简化了用户的操作流程。 + +
+ + diff --git a/docs/rock4/rock4ab-se/radxa-os/ap.md b/docs/rock4/rock4ab-se/radxa-os/ap.md new file mode 100644 index 000000000..048101b55 --- /dev/null +++ b/docs/rock4/rock4ab-se/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/rock4/rock4ab-se/radxa-os/autologin.md b/docs/rock4/rock4ab-se/radxa-os/autologin.md new file mode 100644 index 000000000..570060b34 --- /dev/null +++ b/docs/rock4/rock4ab-se/radxa-os/autologin.md @@ -0,0 +1,10 @@ +--- +sidebar_position: 1 +description: "您可以将系统配置为无需输入密码即可自动登录!" +--- + +import AutoLogin from "../../../common/radxa-os/\_autologin.mdx"; + +# 自动登录 + + diff --git a/docs/rock4/rock4ab-se/radxa-os/backup.md b/docs/rock4/rock4ab-se/radxa-os/backup.md new file mode 100644 index 000000000..324b33364 --- /dev/null +++ b/docs/rock4/rock4ab-se/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/rock4/rock4ab-se/radxa-os/bootparam.md b/docs/rock4/rock4ab-se/radxa-os/bootparam.md new file mode 100644 index 000000000..43185c498 --- /dev/null +++ b/docs/rock4/rock4ab-se/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/rock4/rock4ab-se/radxa-os/display.md b/docs/rock4/rock4ab-se/radxa-os/display.md new file mode 100644 index 000000000..1f87546b9 --- /dev/null +++ b/docs/rock4/rock4ab-se/radxa-os/display.md @@ -0,0 +1,10 @@ +--- +sidebar_position: 3 +description: "在有显示器的情况下进行显示相关设置" +--- + +import Display from "../../../common/radxa-os/\_display.mdx"; + +# 显示设置 + + diff --git a/docs/rock4/rock4ab-se/radxa-os/headless.md b/docs/rock4/rock4ab-se/radxa-os/headless.md new file mode 100644 index 000000000..8b4f00488 --- /dev/null +++ b/docs/rock4/rock4ab-se/radxa-os/headless.md @@ -0,0 +1,10 @@ +--- +sidebar_position: 4 +description: "没有键盘或显示器的情况下使用系统" +--- + +import Headless from "../../../common/radxa-os/\_headless.mdx"; + +# 无屏模式 + + diff --git a/docs/rock4/rock4ab-se/radxa-os/media.md b/docs/rock4/rock4ab-se/radxa-os/media.md new file mode 100644 index 000000000..2790644ad --- /dev/null +++ b/docs/rock4/rock4ab-se/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"; + +# 多媒体 + +## 音频管理 + +