Skip to content
New issue

Have a question about this project? Sign up for a free GitHub account to open an issue and contact its maintainers and the community.

By clicking “Sign up for GitHub”, you agree to our terms of service and privacy statement. We’ll occasionally send you account related emails.

Already on GitHub? Sign in to your account

fix: rock5b documentation error #53

Closed
wants to merge 2 commits into from
Closed
Show file tree
Hide file tree
Changes from all commits
Commits
File filter

Filter by extension

Filter by extension

Conversations
Failed to load comments.
Loading
Jump to
Jump to file
Failed to load files.
Loading
Diff view
Diff view
9 changes: 1 addition & 8 deletions docs/compute-module/cm5/android/low-level-dev.md
Original file line number Diff line number Diff line change
Expand Up @@ -49,13 +49,6 @@ ENV PS1="\[\033[01;37m\]\u@build\[\033[00m\]:\[\033[01;32m\]\w\[\033[00m\]:$ "
RUN apt-get install -y lzop swig
RUN apt-get update -y && apt-get install -y tzdata
RUN mkdir /opt/toolchains
COPY ./gcc-linaro-6.3.1-2017.02-x86_64_arm-linux-gnueabihf /opt/gcc-linaro-6.3.1-2017.02-x86_64_arm-linux-gnueabihf
COPY ./gcc-linaro-aarch64-none-elf-4.8-2013.11_linux /opt/gcc-linaro-aarch64-none-elf-4.8-2013.11_linux
COPY ./gcc-linaro-aarch64-none-elf-4.8-2013.11_linux /opt/toolchains/gcc-linaro-aarch64-none-elf-4.8-2013.11_linux
COPY ./gcc-arm-none-eabi-6-2017-q2-update /opt/toolchains/gcc-arm-none-eabi-6-2017-q2-update
COPY ./gcc-linaro-6.3.1-2017.02-x86_64_arm-linux-gnueabihf /opt/toolchains/gcc-linaro-6.3.1-2017.02-x86_64_arm-linux-gnueabihf
COPY ./gcc-linaro-6.3.1-2017.02-x86_64_aarch64-linux-gnu /opt/toolchains/gcc-linaro-6.3.1-2017.02-x86_64_aarch64-linux-gnu
COPY ./gcc-linaro-7.2.1-2017.11-x86_64_aarch64-elf /opt/toolchains/gcc-linaro-7.2.1-2017.11-x86_64_aarch64-elf
RUN apt-get install -y net-tools gcc-arm-linux-gnueabihf gcc-arm-none-eabi
ENV TZ=Asia/Shanghai
RUN ln -snf /usr/share/zoneinfo/$TZ /etc/localtime && echo $TZ > /etc/timezone
Expand Down Expand Up @@ -90,7 +83,7 @@ $ sudo chmod +x /usr/local/bin/repo
#### 代码下载

```bash
$ repo init -u https://github.com/radxa/manifests.git -b Android12_Radxa_rk14 -m rockchip-r-release.xml
$ repo init -u https://github.com/radxa/manifests.git -b Android12_Radxa_rk14 -m rockchip-s-release.xml
$ repo sync -d --no-tags -j4
```

Expand Down
69 changes: 42 additions & 27 deletions docs/compute-module/nx5/android/low-level-dev.md
Original file line number Diff line number Diff line change
Expand Up @@ -17,29 +17,42 @@ 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
FROM ubuntu:20.04

RUN rm /etc/apt/sources.list
RUN echo "deb http://mirrors.tuna.tsinghua.edu.cn/ubuntu/ focal main restricted universe multiverse" | tee /etc/apt/sources.list
RUN echo "deb http://mirrors.tuna.tsinghua.edu.cn/ubuntu/ focal-updates main restricted universe multiverse" >> /etc/apt/sources.list
RUN echo "deb http://mirrors.tuna.tsinghua.edu.cn/ubuntu/ focal-backports main restricted universe multiverse" >> /etc/apt/sources.list
RUN echo "deb http://mirrors.tuna.tsinghua.edu.cn/ubuntu/ focal-security main restricted universe multiverse" >> /etc/apt/sources.list

ENV DEBIAN_FRONTEND noninteractive

RUN apt-get update -y && apt-get install -y software-properties-common apt-utils
RUN add-apt-repository -y ppa:deadsnakes/ppa
RUN apt-get update -y && apt-get install -y python3.8
RUN update-alternatives --install /usr/bin/python3 python3 /usr/bin/python3.8 150
RUN apt-get install -y python3-pip && pip install pycrypto

RUN apt-get update -y && apt-get install -y openjdk-8-jdk python git-core gnupg flex bison gperf build-essential \
zip curl gawk liblz4-tool zlib1g-dev gcc-multilib g++-multilib libc6-dev-i386 \
libncurses5 libncurses-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 sudo rsync python3-pyelftools cpio


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/'
ENV PS1="\[\033[01;37m\]\u@build\[\033[00m\]:\[\033[01;32m\]\w\[\033[00m\]:$ "

RUN apt-get install -y lzop swig
RUN apt-get update -y && apt-get install -y tzdata
RUN apt-get install -y net-tools gcc-arm-linux-gnueabihf gcc-arm-none-eabi
ENV TZ=Asia/Shanghai
RUN ln -snf /usr/share/zoneinfo/$TZ /etc/localtime && echo $TZ > /etc/timezone

```

Expand All @@ -58,16 +71,18 @@ Repo 是 Android 开发中用于管理多个 Git 仓库的工具,它是一个P
#### 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)

$ echo "export REPO_URL='https://mirrors.tuna.tsinghua.edu.cn/git/git-repo/'" >> ~/.bashrc
$ source ~/.bashrc
$ curl https://mirrors.tuna.tsinghua.edu.cn/git/git-repo -o /tmp/repo
$ sudo cp /tmp/repo /usr/local/bin/repo
$ sudo chmod +x /usr/local/bin/repo
```

## 源码下载

```bash

$ repo init -u [email protected]:rockchip_android_s/rk3588-manifests.git -b Android12_Radxa_rkr14 -m rockchip-s-local.xml
$ repo init -u https://github.com/radxa/manifests -b Android12_Radxa_rk14 -m rockchip-s-release.xml
$ repo sync -d --no-tags -j4

```
Expand Down
76 changes: 60 additions & 16 deletions docs/rock5/rock5b/other-os/android/install-os.md
Copy link
Contributor

Choose a reason for hiding this comment

The reason will be displayed to describe this comment to others. Learn more.

还可以从 SPI-NVME 启动。

SPI-NVME 表达有点奇怪,改成 NVMe SSD

Copy link
Contributor

Choose a reason for hiding this comment

The reason will be displayed to describe this comment to others. Learn more.

安装系统到 SPI-NVME

改成 安装系统到 NVMe

Copy link
Contributor

Choose a reason for hiding this comment

The reason will be displayed to describe this comment to others. Learn more.

常见问题里的两个 SPI-NVME 也改一下,NVMe 即可

Original file line number Diff line number Diff line change
Expand Up @@ -7,7 +7,7 @@ import Etcher from '../../../../common/general/\_etcher.mdx'

本文档将介绍如何把 Android 镜像安装到 ROCK 5B。

ROCK 5B 可以从 microSD 卡启动,也可以从 EMMC 启动,基于不同的启动方式,安装系统到不同的介质上.
ROCK 5B 可以从 microSD 卡启动,也可以从 EMMC 启动,还可以从 SPI-NVME 启动。基于不同的启动方式,安装系统到不同的介质上

<Tabs queryString="target">

Expand Down Expand Up @@ -38,8 +38,6 @@ ROCK 5B 可以从 microSD 卡启动,也可以从 EMMC 启动,基于不同的
ROCK 5B 支持 9V/2A、12V/2A、15V/2A 和 20V/2A 的 USB Type-C PD 2.0。瑞莎推荐使用 [Radxa Power PD30W](../../accessories/pd-30w)。
:::

## 参考文档

</TabItem>

<TabItem value="emmc" label="安装系统到 eMMC ">
Expand All @@ -48,7 +46,7 @@ ROCK 5B 支持 9V/2A、12V/2A、15V/2A 和 20V/2A 的 USB Type-C PD 2.0。瑞莎

### 准备安装介质

- micro usb 转 typea usb 接口线缆
- TypeC 转 TypeA 接口线缆

### 镜像下载

Expand All @@ -58,16 +56,13 @@ ROCK 5B 支持 9V/2A、12V/2A、15V/2A 和 20V/2A 的 USB Type-C PD 2.0。瑞莎

### 系统安装

1. 将micro usb 线缆连接到主机

2. 进入 maskrom 模式
1. 进入 maskrom 模式

- 断开开发板电源
- 移除 SD 卡,并插入 eMMC 模块
- 用 USB A-A 连接 Radxa ROCK 5B 的 USB3.0 口 和 PC 端
- 短接下面引脚
- 给开发板上电
- 摘下右边的黄色跳线帽,保留左边的黄色跳线帽
- 移除 SD 卡,并扣好 eMMC 模块
- 按住 maskrom 按键
- 用 TypeC 转 TypeA 接口线缆连接 Radxa ROCK 5B 的全功能 TypeC 口和 PC 端 USB 接口
- 松开 maskrom 按键

<img src="/img/rock5b/rock-5b-maskrom-01.webp" alt="ROCK 5B maskrom" width="500" />

Expand All @@ -82,20 +77,66 @@ ROCK 5B 支持 9V/2A、12V/2A、15V/2A 和 20V/2A 的 USB Type-C PD 2.0。瑞莎

#### Linux/Mac 系统使用 rkdeveloptool 写入

[rkdeveloptool](../../low-level-dev/rkdeveloptool)
可以参考这个文档:[rkdeveloptool](../../low-level-dev/rkdeveloptool)

</TabItem>

<TabItem value="windows" label="Windows">

#### Windows 系统使用 rkdevetool 写入

[rkdevtool](/rock5/rock5b/low-level-dev/rkdevtool)
可以参考这个文档:[rkdevtool](/rock5/rock5b/low-level-dev/rkdevtool)

</TabItem>
## 系统启动

### 启动 ROCK 5B

1. 通过适配器为 ROCK 5B 供电
2. ROCK 5B 将在绿色电源 LED 亮起的情况下启动

</TabItem>
</Tabs>

</TabItem>

<TabItem value="nvme" label="安装系统到 SPI-NVME">

## 准备工作

暂时只能使用 Windows 系统安装

### 准备安装介质

- TypeC 转 TypeA 接口线缆
- 一个 M.2 NVME 固态硬盘
- NVME 转 USB3.0 读卡器或带 NVME 插槽的 PC

### 镜像下载

请到 [资源下载汇总](../../getting-started/download) 下载对应的镜像文件

## 系统安装

### 系统安装

1. 使用 NVME 转 USB3.0 读卡器在电脑上把 M.2 NVME 固态硬盘格式化成 FAT32 格式

2. 按以下步骤让 ROCK 5B 进入 moskrom 模式

- 断开开发板电源
- 移除 SD 卡、eMMC ,并装好 M.2 NVME 固态硬盘
- 按住 maskrom 按键
- 用 TypeC 转 TypeA 接口线缆连接 Radxa ROCK 5B 的全功能 TypeC 口和 PC 端 USB 接口
- 松开 maskrom 按键

3. 使用 rkdevtool 工具烧录

- 查看 ROCK 5B 是否进入 MASKROM 模式
![RKDevTool zh maskrom](/img/configuration/rkdevtool-zh-maskrom.webp)

- 在升级固件页面选择固件,然后点击升级
![RKDevTool zh spi-nvme](/img/rock5b/Rock5b-rkdevtool-ssd.webp)

## 系统启动

### 启动 ROCK 5B
Expand All @@ -104,9 +145,12 @@ ROCK 5B 支持 9V/2A、12V/2A、15V/2A 和 20V/2A 的 USB Type-C PD 2.0。瑞莎
2. ROCK 5B 将在绿色电源 LED 亮起的情况下启动

</TabItem>

</Tabs>

## 常见问题

问:ROCK 5B 烧录 SPI-NVME 固件后,现在想换成 SD 卡或 eMMC 启动,发现不能启动了

答:由于 SPI-NVME 固件不兼容 SD 卡和 eMMC,需要先擦除 SPI 闪存固件。可以参考[这里擦除](../../low-level-dev/erase-spi-from-usb-otg)

## 参考文档
61 changes: 38 additions & 23 deletions docs/rock5/rock5b/other-os/android/low-level-dev.md
Original file line number Diff line number Diff line change
Expand Up @@ -17,29 +17,42 @@ Docker是一个开源的应用容器引擎,可以帮助开发者更有效地
Dockerfile 是一个构建 Docker 镜像的文本文件,可以根据以下内容构建编译 Android 所需环境。

```
FROM ubuntu:xenial
FROM ubuntu:20.04

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
RUN rm /etc/apt/sources.list
RUN echo "deb http://mirrors.tuna.tsinghua.edu.cn/ubuntu/ focal main restricted universe multiverse" | tee /etc/apt/sources.list
RUN echo "deb http://mirrors.tuna.tsinghua.edu.cn/ubuntu/ focal-updates main restricted universe multiverse" >> /etc/apt/sources.list
RUN echo "deb http://mirrors.tuna.tsinghua.edu.cn/ubuntu/ focal-backports main restricted universe multiverse" >> /etc/apt/sources.list
RUN echo "deb http://mirrors.tuna.tsinghua.edu.cn/ubuntu/ focal-security main restricted universe multiverse" >> /etc/apt/sources.list

#### 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
ENV DEBIAN_FRONTEND noninteractive

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
RUN apt-get update -y && apt-get install -y software-properties-common apt-utils
RUN add-apt-repository -y ppa:deadsnakes/ppa
RUN apt-get update -y && apt-get install -y python3.8
RUN update-alternatives --install /usr/bin/python3 python3 /usr/bin/python3.8 150
RUN apt-get install -y python3-pip && pip install pycrypto

USER android12-docker
RUN apt-get update -y && apt-get install -y openjdk-8-jdk python git-core gnupg flex bison gperf build-essential \
zip curl gawk liblz4-tool zlib1g-dev gcc-multilib g++-multilib libc6-dev-i386 \
libncurses5 libncurses-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 sudo rsync python3-pyelftools cpio


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/'
ENV PS1="\[\033[01;37m\]\u@build\[\033[00m\]:\[\033[01;32m\]\w\[\033[00m\]:$ "

RUN apt-get install -y lzop swig
RUN apt-get update -y && apt-get install -y tzdata
RUN apt-get install -y net-tools gcc-arm-linux-gnueabihf gcc-arm-none-eabi
ENV TZ=Asia/Shanghai
RUN ln -snf /usr/share/zoneinfo/$TZ /etc/localtime && echo $TZ > /etc/timezone

```

Expand All @@ -58,16 +71,18 @@ Repo 是 Android 开发中用于管理多个 Git 仓库的工具,它是一个P
#### 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)

$ echo "export REPO_URL='https://mirrors.tuna.tsinghua.edu.cn/git/git-repo/'" >> ~/.bashrc
$ source ~/.bashrc
$ curl https://mirrors.tuna.tsinghua.edu.cn/git/git-repo -o /tmp/repo
$ sudo cp /tmp/repo /usr/local/bin/repo
$ sudo chmod +x /usr/local/bin/repo
```

## 源码下载

```bash

$ repo init -u [email protected]:rockchip_android_s/rk3588-manifests.git -b Android12_Radxa_rkr14 -m rockchip-s-local.xml
$ repo init -u https://github.com/radxa/manifests -b Android12_Radxa_rk14 -m rockchip-s-release.xml
$ repo sync -d --no-tags -j4

```
Expand Down
18 changes: 14 additions & 4 deletions docs/rock5/rock5b/other-os/android/preparation.md
Original file line number Diff line number Diff line change
Expand Up @@ -22,19 +22,29 @@ microSD 卡,容量不小于 8GB, 用于系统启动盘

### 显示

带有 HDMI 接口的显示器,ROCK 5B 有两个 HDMI 输出端口,均支持 CEC 和 HDMI 2.1,分辨率最高支持分别为 8Kp60 和 4Kp60,并且其 Type-C 接口也可支持视频输出。
另外,ROCK 5B 拥有 1 个 HDMI 输入接口,支持 HDMI 2.1 输入,分辨率为 4Kp60。

### 网络连接

ROCK 5B 有以太网口,可以通过以太网接入网络; ROCK 5B 主板正面有一个带 2230 安装孔的 M.2 E Key 连接器,提供 PCIe 2.1 单通道、USB、SATA、SDIO、PCM 和 UART 信号。
如果你想通过无线模块上网,Radxa 推荐使用 [Radxa Wireless A8](../../accessories/wifi_bt_access.md)。Radxa Wireless A8 的接口规格是 M.2 2230 E 口,安装在 ROCK 5B 的 M.2 E 口然后打开 wifi 网络就可以上网。

### Type-C Hub

用于 USB 口接口扩展,可外接类似 USB 鼠标, USB 键盘等设备

### USB 鼠标
## 常见问题

问:为什么新买的 Radxa A8 wifi 模块不能在 ROCK 5B 安卓系统上使用?

### USB 键盘
答:因为老固件没有兼容新的 Radxa A8 模块,可以找 Radxa 工作人员提供新固件。

## 常见问题
问:为什么我的 Radxa 8HD 屏不能在安卓系统上使用,Radxa 10HD 屏却可以使用?

答:现阶段 ROCK 5B 一个安卓固件只能支持一个 mipi 屏,如果固件不支持您的 mipi 屏,可以找 Radxa 工作人员提供新固件。

## 注意事项
其它[常见问题](../../../faq.md)

## 参考文档

Expand Down
2 changes: 1 addition & 1 deletion docs/zero/zero3/other-os/android/download.md
Original file line number Diff line number Diff line change
Expand Up @@ -13,7 +13,7 @@ sidebar_position: 5
Radxa ZERO 3 安卓镜像格式有两种,分别是gpt、update。可以看镜像文件名称区分。
推荐使用 gpt 格式镜像。

Radxa ZERO 3 gpt 格式镜像下载请[点击这里](https://github.com/radxa/manifests/releases/download/Android11_Radxa_rk12_20231109/Radxa_ZERO_3W_3E_Android11_rkr12_20231109-gpt.zip)。
Radxa ZERO 3 gpt 格式镜像下载请[点击这里](https://github.com/radxa/manifests/releases/download/radxa-zero3-we-android11-rkr12-20240111/Radxa-Zero3WE-20231130-gpt.zip)。

Radxa ZERO 3 update 格式镜像下载请[点击这里](https://github.com/radxa/manifests/releases/download/Android11_Radxa_rk12_20231109/Radxa_ZERO_3W_3E_Android11_rkr12_20231109-update.zip)。

Expand Down
Binary file added static/img/rock5b/Rock5b-rkdevtool-ssd.webp
Binary file not shown.
Loading