From f8e921d01882a829331682ea07809053605e5d85 Mon Sep 17 00:00:00 2001 From: ace <147782332+skljfi@users.noreply.github.com> Date: Fri, 19 Apr 2024 20:06:42 +0800 Subject: [PATCH] docs: rock5c add adnroid document (#5) refactor:rock5c download directory structure --- .../rock5c/{getting-started => }/download.md | 4 +- .../rock5c/getting-started/install-os.md | 2 +- .../low-level-dev/install-os-via-usb-otg.md | 2 +- docs/rock5/rock5c/other-os/README.md | 4 + docs/rock5/rock5c/other-os/android/README.md | 9 ++ .../rock5c/other-os/android/install-os.md | 103 ++++++++++++++ .../rock5c/other-os/android/low-level-dev.md | 132 +++++++++++++++++ .../rock5c/other-os/android/preparation.md | 47 +++++++ .../rock5c/other-os/android/remote-login.md | 128 +++++++++++++++++ .../rock5c/{getting-started => }/download.md | 4 +- .../rock5c/getting-started/install-os.md | 2 +- .../low-level-dev/install-os-via-usb-otg.md | 2 +- .../current/rock5/rock5c/other-os/README.md | 6 +- .../rock5/rock5c/other-os/android/README.md | 9 ++ .../rock5c/other-os/android/install-os.md | 105 ++++++++++++++ .../rock5c/other-os/android/low-level-dev.md | 133 ++++++++++++++++++ .../rock5c/other-os/android/preparation.md | 47 +++++++ .../rock5c/other-os/android/remote-login.md | 128 +++++++++++++++++ 18 files changed, 860 insertions(+), 7 deletions(-) rename docs/rock5/rock5c/{getting-started => }/download.md (93%) create mode 100644 docs/rock5/rock5c/other-os/android/README.md create mode 100644 docs/rock5/rock5c/other-os/android/install-os.md create mode 100644 docs/rock5/rock5c/other-os/android/low-level-dev.md create mode 100644 docs/rock5/rock5c/other-os/android/preparation.md create mode 100644 docs/rock5/rock5c/other-os/android/remote-login.md rename i18n/en/docusaurus-plugin-content-docs/current/rock5/rock5c/{getting-started => }/download.md (94%) create mode 100644 i18n/en/docusaurus-plugin-content-docs/current/rock5/rock5c/other-os/android/README.md create mode 100644 i18n/en/docusaurus-plugin-content-docs/current/rock5/rock5c/other-os/android/install-os.md create mode 100644 i18n/en/docusaurus-plugin-content-docs/current/rock5/rock5c/other-os/android/low-level-dev.md create mode 100644 i18n/en/docusaurus-plugin-content-docs/current/rock5/rock5c/other-os/android/preparation.md create mode 100644 i18n/en/docusaurus-plugin-content-docs/current/rock5/rock5c/other-os/android/remote-login.md diff --git a/docs/rock5/rock5c/getting-started/download.md b/docs/rock5/rock5c/download.md similarity index 93% rename from docs/rock5/rock5c/getting-started/download.md rename to docs/rock5/rock5c/download.md index 5f887ca30..2b4ecc525 100644 --- a/docs/rock5/rock5c/getting-started/download.md +++ b/docs/rock5/rock5c/download.md @@ -1,5 +1,5 @@ --- -sidebar_position: 5 +sidebar_position: 0 --- # 资源下载汇总 @@ -10,6 +10,8 @@ sidebar_position: 5 - [ROCK 5C Debian 镜像 T2](https://github.com/radxa-build/rock-5c/releases/tag/test-build-2) +- Android12 镜像 + ## 硬件设计 ### V1.1 diff --git a/docs/rock5/rock5c/getting-started/install-os.md b/docs/rock5/rock5c/getting-started/install-os.md index 5ddc05556..88d9c915c 100644 --- a/docs/rock5/rock5c/getting-started/install-os.md +++ b/docs/rock5/rock5c/getting-started/install-os.md @@ -35,7 +35,7 @@ import Etcher from '../../../common/general/\_etcher.mdx' ## 镜像下载 -请到 [资源下载汇总](./download) 下载对应的镜像文件 +请到 [资源下载汇总](../download.md) 下载对应的镜像文件 ## 安装系统 diff --git a/docs/rock5/rock5c/low-level-dev/install-os-via-usb-otg.md b/docs/rock5/rock5c/low-level-dev/install-os-via-usb-otg.md index 641fe05dc..8f075963e 100644 --- a/docs/rock5/rock5c/low-level-dev/install-os-via-usb-otg.md +++ b/docs/rock5/rock5c/low-level-dev/install-os-via-usb-otg.md @@ -14,7 +14,7 @@ sidebar_class_name: hidden ## 镜像下载 -请到 [资源下载汇总](../getting-started/download) 下载对应的镜像文件 +请到 [资源下载汇总](../download) 下载对应的镜像文件 ## 进入 Maskrom 模式 diff --git a/docs/rock5/rock5c/other-os/README.md b/docs/rock5/rock5c/other-os/README.md index 051cbb33e..ef1565c51 100644 --- a/docs/rock5/rock5c/other-os/README.md +++ b/docs/rock5/rock5c/other-os/README.md @@ -3,3 +3,7 @@ sidebar_position: 8 --- # 其他系统 + +介绍非 Radxa OS 的其他系统，例如 Android + + diff --git a/docs/rock5/rock5c/other-os/android/README.md b/docs/rock5/rock5c/other-os/android/README.md new file mode 100644 index 000000000..ad6379ff3 --- /dev/null +++ b/docs/rock5/rock5c/other-os/android/README.md @@ -0,0 +1,9 @@ +--- +sidebar_position: 7 +--- + +# Android 系统 + +主要介绍系统如何使用 + + diff --git a/docs/rock5/rock5c/other-os/android/install-os.md b/docs/rock5/rock5c/other-os/android/install-os.md new file mode 100644 index 000000000..bb139b896 --- /dev/null +++ b/docs/rock5/rock5c/other-os/android/install-os.md @@ -0,0 +1,103 @@ +--- +sidebar_position: 2 +title: 系统安装 +--- + +import Etcher from '../../../../common/general/\_etcher.mdx' + +本文档将介绍如何把 Android 镜像安装到 ROCK 5C。 + +ROCK 5C 可以从 microSD 卡启动，也可以从 EMMC 启动，基于不同的启动方式，安装系统到不同的介质上. + + + + + +# 安装操作系统 + +## 准备工作 + +- 1x microSD 卡(容量 >=16GB，读写速度等级 >= class10) +- 1x microSD 读卡器 +- 5V 电源适配器 (推荐使用 [Radxa Power PD30W](../../accessories/pd-30w)) + +## 镜像下载 + +请到 [资源下载汇总](../../download) 下载对应的镜像文件 + +## 安装系统 + + + +## 启动系统 + +- 按照上述步骤成功烧录 microSD 卡后，将 microSD 卡插入 Radxa ROCK 5C 的 MicroSD 插槽内。 +- Radxa ROCK 5C 的供电接口为 [Type C port](/rock5/rock5c/hardware-design/hardware-interface)，请使用 Type-C 线缆连接供电口和适配器。 + +:::tip +ROCK 5C 支持 9V/2A、12V/2A、15V/2A 和 20V/2A 的 USB Type-C PD 2.0。瑞莎推荐使用 [Radxa Power PD30W](../../accessories/pd-30w)。 +::: + +## 参考文档 + + + + + +## 准备工作 + +### 准备安装介质 + +- micro usb 转 typea usb 接口线缆 + +### 镜像下载 + +请到 [资源下载汇总](../../download) 下载对应的镜像文件 + +## 系统安装 + +### 系统安装 + +1. 将micro usb 线缆连接到主机 + +2. 进入 maskrom 模式 + +- 断开开发板电源 +- 移除 SD 卡，并插入 EMMC 模块 +- 用 USB A-A 连接 Radxa ROCK 5C 的 USB3.0 口 和 PC 端 +- 使用杜邦线短接 Maskrom Key +- 给开发板上电 +- 查看是否有 USB 设备 + - Linux/macOS: 检查执行 lsusb 后是否有显示 "Bus 001 Device 112: ID 2207:350a Fuzhou Rockchip Electronics Company" + - Windows: 打开 RKDevTool 您会看到设备处于 "maskrom mode". + + + + + +#### Linux/Mac 系统使用 rkdeveloptool 写入 + +[rkdeveloptool](../../low-level-dev/rkdeveloptool) + + + + + +#### Windows 系统使用 rkdevetool 写入 + +[rkdevtool](/rock5/rock5c/low-level-dev/rkdevtool) + + + + + +## 系统启动 + +### 启动 ROCK 5C + +1. 通过适配器为 ROCK 5C 供电 +2. ROCK 5C 将蓝色电源 LED 亮起的情况下启动 + + + + diff --git a/docs/rock5/rock5c/other-os/android/low-level-dev.md b/docs/rock5/rock5c/other-os/android/low-level-dev.md new file mode 100644 index 000000000..411f552fe --- /dev/null +++ b/docs/rock5/rock5c/other-os/android/low-level-dev.md @@ -0,0 +1,132 @@ +--- +sidebar_position: 4 +--- + +# 底层开发 + +主要介绍 uboot, kernel, aosp 编译打包等内容 + +## 环境配置 + +在 Ubuntu(>=15.04) 上使用OpenJDK + +```bash +sudo apt-get update +sudo apt-get install openjdk-8-jdk +``` + +## 下载 Radxa Android SDK + +Radxa Android SDK 包含数百个 Git 仓库，如果不用 repo 逐个下载会非常繁琐。 + +### Repo + +Repo 是 Android 开发中用于管理多个 Git 仓库的工具，它是一个Python脚本，方便开发者对多个 Git 库进行版本控制和管理。 + +#### 下载 Repo + +```bash +$ echo "export REPO_URL='https://storage.googleapis.com/git-repo-downloads/repo'" >> ~/.bashrc +$ source ~/.bashrc +$ curl https://storage.googleapis.com/git-repo-downloads/repo -o /tmp/repo +$ sudo cp /tmp/repo /usr/local/bin/repo +$ sudo chmod +x /usr/local/bin/repo +``` + +#### 代码下载 + +```bash +$ repo init -u https://github.com/radxa/manifests.git -b Android12_Radxa_rk14 -m rockchip-s-release.xml +$ repo sync -d --no-tags -j4 +``` + +## 镜像编译 + +镜像编译可以使用两种方法 + +### 方法一 (**推荐**) + +使用 SDK 编译脚本方式编译 + +```bash +radxa:rock-android12 $ source build/envsetup.sh +radxa:rock-android12 $ lunch RadxaRock5C-userdebug +radxa:rock-android12 $ ./build.sh -UACKup +# get images from IMAGE directory +``` + +等待编译完成就可以在 IMAGE 目录找到镜像 + +### 方法二 + +可以根据这个方法一步一步编译镜像 + +1. 设置编译项目的环境 + +```bash +radxa:rock-android12 $ export PRODUCT_NAME="RadxaRock5C" +radxa:rock-android12 $ export PRODUCT_UBOOT_CONFIG="rk3588" +radxa:rock-android12 $ export PRODUCT_KERNEL_CONFIG="rockchip_defconfig android-11.config rock5c.config" +radxa:rock-android12 $ export PRODUCT_KERNEL_DTS="rk3588s-rock-5c" +``` + +2. 编译 U-boot + +```bash +android12 $ cd u-boot +android12/u-boot $ make clean +android12/u-boot $ make mrproper +android12/u-boot $ make distclean +android12/u-boot $ ./make.sh ${PRODUCT_UBOOT_CONFIG} +android12 $ cd - +``` + +3. 编译内核 + +```bash +radxa:rock-android12 $ cd kernel-5.10 +radxa:rock-android12/kernel-5.10 $ export PATH=../prebuilts/clang/host/linux-x86/clang-r416183b/bin:$PATH +radxa:rock-android12/kernel-5.10 $ alias msk='make CROSS_COMPILE=aarch64-linux-gnu- LLVM=1 LLVM_IAS=1' +radxa:rock-android12/kernel-5.10 $ msk ARCH=arm64 ${PRODUCT_KERNEL_CONFIG} +radxa:rock-android12/kernel-5.10 $ msk ARCH=arm64 BOOT_IMG=../rockdev/Image-${PRODUCT_NAME}/boot.img ${PRODUCT_KERNEL_DTS}.img + +radxa:rock-android12 $ cd - +``` + +4. 编译AOSP + +```bash +android12 $ source build/envsetup.sh +android12 $ lunch ${PRODUCT_NAME}-userdebug +android12 $ make -j$(nproc) +``` + +5. 制作 Images + +```bash +android12 $ rm -rf rockdev +android12 $ ln -s RKTools/linux/Linux_Pack_Firmware/rockdev . +android12 $ ./mkimage.sh +``` + +6. 打包 Image + +```bash +android12 $ cd rockdev +android12/rockdev $ rm -rf Image +android12/rockdev $ ln -s Image-${PRODUCT_NAME} Image +``` + +- 打包成 RK update 格式镜像 + +``` +radxa:rock-android12/rockdev $ ./mkupdate.sh rk3588 Image +``` + +在 rockdev/ 目录下生成了 update.img + +- 打包成 GPT 格式镜像 + +``` +android12/rockdev $ ./android-gpt.sh +``` diff --git a/docs/rock5/rock5c/other-os/android/preparation.md b/docs/rock5/rock5c/other-os/android/preparation.md new file mode 100644 index 000000000..2f802a0fa --- /dev/null +++ b/docs/rock5/rock5c/other-os/android/preparation.md @@ -0,0 +1,47 @@ +--- +sidebar_position: 1 +--- + +# 准备工作 + +## 开发准备 + + + + + +### 供电 + +:::tip +ROCK 5C 支持 9V/2A、12V/2A、15V/2A 和 20V/2A 的 USB Type-C PD 2.0。瑞莎推荐使用 [Radxa Power PD30W](../../accessories/pd-30w)。 +::: + +### 存储 + +microSD /emmc (>=16GB), 用于系统启动盘 + +### microSD 读卡器 + +用于制作系统启动盘 + + + + + +### 显示 + +### 网络连接 + +### Type-C Hub + +用于 USB 口接口扩展，可外接类似 USB 鼠标, USB 键盘等设备 + +### USB 鼠标 + +### USB 键盘 + + + + + +[支持的配件](../../accessories) diff --git a/docs/rock5/rock5c/other-os/android/remote-login.md b/docs/rock5/rock5c/other-os/android/remote-login.md new file mode 100644 index 000000000..c6e52eec8 --- /dev/null +++ b/docs/rock5/rock5c/other-os/android/remote-login.md @@ -0,0 +1,128 @@ +--- +sidebar_position: 3 +--- + +import Serial from "../../../../common/general/\_serial.mdx" + +# 远程登录 + +本章节旨在向需要通过个人电脑（PC）远程访问 SBC 的用户介绍如何通过串口、adb 等方式进行远程登录 Rock 5C + + + + + +### 准备工作 + +adb（调试桥）安装： + + + + + +从Android[官方网站](https://source.android.com/docs/setup/build/adb)下载Windows版本的adb工具包，下载解压后需要配置环境变量: + +方式一：在终端窗口输入以下命令： + +```bash + +set HTTP_PROXY=myserver:1981 + +``` + +方式二：打开系统设置，修改环境变量：![rock5c adb](/img/nx5/adb_config.webp) + + + + + +使用以下命令安装即可： + +```bash + +sudo apt install adb + +``` + + + + + +从Android[官方网站](https://source.android.com/docs/setup/build/adb)下载Mac版本的adb工具包，下载解压后需要配置环境变量: +打开终端输入一下命令进行环境变量配置： + +```bash + +export PATH=${path}:~/platform-tools('~'代表解压出来的工具包路径) + +``` + + + + + + + + + +#### 要求 + +1. 一条USB A-A 线 +2. 一台有安装 ADB 工具的电脑或笔记本 +3. 一个 Rock 5C + +#### 步骤 + +1. 用 USB 线连接计算机的 USB 接口和 Rock 5C 的 USB3.0 Type A 接口 +2. 打开计算机终端输入 adb devices 确认识别到 Rock 5C ,输入 adb shell 登录 + +```bash + +$ adb devices + List of devices attached + f94f8e0d28380ceb device + +$ adb shell + RadxaRock5C:/ $ + +``` + + + + + +Android 11 版本以后支持无线 ADB 。 + +#### 要求 + +1. 一台有安装 ADB 工具的电脑或笔记本 ，ADB 版本需要大于 31.0.0 +2. 一个Rock 5C，安卓镜像需要大于或等于 11 +3. 计算机和 Radxa 5C 需要在同一个局域网 + +#### 步骤 + +1. 启动 Rock 5C ，使用 wifi 连接 网络 +2. 进入开发着模式，点击7次版本号可进入开发着模式（设置 -> 关于平板电脑 -> 版本号） +3. 进入开发着选项（设置 -> 系统 -> 开发着选项），打开无线调试，记住IP地址和接(例：10.0.0.16:45613) +4. 打开计算机终端输入 adb connect 10.0.0.16:45613 连接 Radxa 5C ，输入 adb shell 登录 + +```bash +$ adb connect 10.0.0.16:45613 + +$ adb shell + RadxaRock5C:/ $ +``` + + + + + + + + + + + + + + diff --git a/i18n/en/docusaurus-plugin-content-docs/current/rock5/rock5c/getting-started/download.md b/i18n/en/docusaurus-plugin-content-docs/current/rock5/rock5c/download.md similarity index 94% rename from i18n/en/docusaurus-plugin-content-docs/current/rock5/rock5c/getting-started/download.md rename to i18n/en/docusaurus-plugin-content-docs/current/rock5/rock5c/download.md index 64674286a..0849bea7c 100644 --- a/i18n/en/docusaurus-plugin-content-docs/current/rock5/rock5c/getting-started/download.md +++ b/i18n/en/docusaurus-plugin-content-docs/current/rock5/rock5c/download.md @@ -1,5 +1,5 @@ --- -sidebar_position: 5 +sidebar_position: 0 --- # Resource Download Summary @@ -10,6 +10,8 @@ Test Version: - [ROCK 5C Debian Image T2](https://github.com/radxa-build/rock-5c/releases/tag/test-build-2) +- Android12 Image + ## Hardware Design ### V1.1 diff --git a/i18n/en/docusaurus-plugin-content-docs/current/rock5/rock5c/getting-started/install-os.md b/i18n/en/docusaurus-plugin-content-docs/current/rock5/rock5c/getting-started/install-os.md index e490443e8..7484ababf 100644 --- a/i18n/en/docusaurus-plugin-content-docs/current/rock5/rock5c/getting-started/install-os.md +++ b/i18n/en/docusaurus-plugin-content-docs/current/rock5/rock5c/getting-started/install-os.md @@ -36,7 +36,7 @@ import Etcher from '../../../common/general/\_etcher.mdx' ## Image Download -Please go to [Resource Download Summary](./download) to download the corresponding image file. +Please go to [Resource Download Summary](../download) to download the corresponding image file. ## Install the system diff --git a/i18n/en/docusaurus-plugin-content-docs/current/rock5/rock5c/low-level-dev/install-os-via-usb-otg.md b/i18n/en/docusaurus-plugin-content-docs/current/rock5/rock5c/low-level-dev/install-os-via-usb-otg.md index 523b7ceca..f2bee0399 100644 --- a/i18n/en/docusaurus-plugin-content-docs/current/rock5/rock5c/low-level-dev/install-os-via-usb-otg.md +++ b/i18n/en/docusaurus-plugin-content-docs/current/rock5/rock5c/low-level-dev/install-os-via-usb-otg.md @@ -14,7 +14,7 @@ sidebar_class_name: hidden ## Image Download -Please go to [Resource Download Summary](../getting-started/download) to download the corresponding image file. +Please go to [Resource Download Summary](../download) to download the corresponding image file. ## Enter Maskrom mode diff --git a/i18n/en/docusaurus-plugin-content-docs/current/rock5/rock5c/other-os/README.md b/i18n/en/docusaurus-plugin-content-docs/current/rock5/rock5c/other-os/README.md index dcb2babe2..d7dc261d3 100644 --- a/i18n/en/docusaurus-plugin-content-docs/current/rock5/rock5c/other-os/README.md +++ b/i18n/en/docusaurus-plugin-content-docs/current/rock5/rock5c/other-os/README.md @@ -2,4 +2,8 @@ sidebar_position: 8 --- -# Other OS +# Other System + +Introduces other systems than Radxa OS, such as Android. + + diff --git a/i18n/en/docusaurus-plugin-content-docs/current/rock5/rock5c/other-os/android/README.md b/i18n/en/docusaurus-plugin-content-docs/current/rock5/rock5c/other-os/android/README.md new file mode 100644 index 000000000..a919b88d0 --- /dev/null +++ b/i18n/en/docusaurus-plugin-content-docs/current/rock5/rock5c/other-os/android/README.md @@ -0,0 +1,9 @@ +--- +sidebar_position: 7 +--- + +# Android OS + +Introduce how to use android and do development on it + + diff --git a/i18n/en/docusaurus-plugin-content-docs/current/rock5/rock5c/other-os/android/install-os.md b/i18n/en/docusaurus-plugin-content-docs/current/rock5/rock5c/other-os/android/install-os.md new file mode 100644 index 000000000..9c9145012 --- /dev/null +++ b/i18n/en/docusaurus-plugin-content-docs/current/rock5/rock5c/other-os/android/install-os.md @@ -0,0 +1,105 @@ +--- +sidebar_position: 2 +title: Install OS +--- + +import Etcher from '../../../../common/general/\_etcher.mdx' + +This document describes how to install an Android image to the ROCK 5C. + +ROCK 5C can be booted from microSD card or EMMC, depending on the boot method, the system will be installed on different media. + + + + + +# Install the operating system + +## Preparation + +- 1x microSD card (capacity >=16GB, speed level >= class10) +- 1x microSD card reader +- 5V power adapter (Recommended [Radxa Power PD30W](../../accessories/pd-30w)) + +## Image Download + +Please go to [Resource Download Summary](../../download) to download the corresponding image file. + +## Install the system + + + +## Boot the system + +- After successfully burning the microSD card as described above, insert the microSD card into the microSD slot of Radxa ROCK 5C. +- The power supply interface of Radxa ROCK 5C is [Type C port](/rock5/rock5c/hardware-design/hardware-interface), please connect the power supply port and the adapter with Type-C cable. + +:::tip +The ROCK 5C supports USB Type-C PD 2.0 at 9V/2A, 12V/2A, 15V/2A and 20V/2A. Radxa recommends using the [Radxa Power PD30W](../../accessories/pd-30w). +:::. + +## Reference Documentation + + + + + +### Preparation + +### Prepare installation media + +- micro usb to typea usb connector cable + +### Download the image + +Please go to [Resource Download Summary](../../download) to download the corresponding image file. + +### System Installation + +### System Installation + +1. Connect the micro usb cable to the host computer. + +2. Enter maskrom mode + +- Disconnect the board from the power supply. +- Remove the SD card and insert the eMMC module. +- Connect the USB3.0 port of the Radxa ROCK 5C to the PC side with USB A-A. +- Short the Maskrom pins +- Power up the board. +- Remove the right yellow jumper cap and keep the left yellow jumper cap. + +- Check for USB devices + - Linux/macOS: Check if "Bus 001 Device 112: ID 2207:350a Fuzhou Rockchip Electronics Company" is displayed after running lsusb. + - Windows: Open RKDevTool and you will see the device in "maskrom mode". + + + + + +#### Linux/Mac systems are written using rkdeveloptool + +[rkdeveloptool](../../low-level-dev/rkdeveloptool) + + + + + +#### Windows systems write with rkdevetool + +[rkdevtool](/rock5/rock5c/low-level-dev/rkdevtool) + + + + + +## System startup + +### Starting the ROCK 5C + +1. Power up the ROCK 5C via the adapter. +2. The ROCK 5C will start up with the blue power LED on. + + + + diff --git a/i18n/en/docusaurus-plugin-content-docs/current/rock5/rock5c/other-os/android/low-level-dev.md b/i18n/en/docusaurus-plugin-content-docs/current/rock5/rock5c/other-os/android/low-level-dev.md new file mode 100644 index 000000000..cae6a23b0 --- /dev/null +++ b/i18n/en/docusaurus-plugin-content-docs/current/rock5/rock5c/other-os/android/low-level-dev.md @@ -0,0 +1,133 @@ +--- +sidebar_position: 4 +--- + +# Low Level Development + +Introduces how to build and pack uboot, kernel, aosp and so on. + +## Environment configuration + +For Ubuntu >= 15.04 ,use Open JDK + +```bash +sudo apt-get update +sudo apt-get install openjdk-8-jdk + +``` + +## Download Radxa Android SDK + +Radxa Android SDK contains hundreds of Git repositories, and it would be very tedious to download them one by one without repo. + +### Repo + +Repo is a tool used in Android development to manage multiple Git repositories. It is a Python script that facilitates developers to version control and manage multiple Git libraries. + +#### Download Repo + +```bash +$ echo "export REPO_URL='https://storage.googleapis.com/git-repo-downloads/repo'" >> ~/.bashrc +$ source ~/.bashrc +$ curl https://storage.googleapis.com/git-repo-downloads/repo -o /tmp/repo +$ sudo cp /tmp/repo /usr/local/bin/repo +$ sudo chmod +x /usr/local/bin/repo +``` + +#### Code download + +```bash +$ repo init -u https://github.com/radxa/manifests.git -b Android12_Radxa_rk14 -m rockchip-s-release.xml +$ repo sync -d --no-tags -j4 +``` + +## Mirror compilation + +Mirror compilation can be done using two methods + +### Method 1 (**recommended**) + +Compile using the SDK compilation script method + +```bash +radxa:rock-android12 $ source build/envsetup.sh +radxa:rock-android12 $ lunch RadxaRock5C-userdebug +radxa:rock-android12 $ . /build.sh -UACKup +# get images from IMAGE directory +``` + +Wait for the build to complete and you will find the images in the IMAGE directory. + +### Method two + +You can compile the image step by step according to this method + +1. Set up the environment for compiling the project + +```bash +radxa:rock-android12 $ export PRODUCT_NAME="RadxaRock5C" +radxa:rock-android12 $ export PRODUCT_UBOOT_CONFIG="rk3588" +radxa:rock-android12 $ export PRODUCT_KERNEL_CONFIG="rockchip_defconfig android-11.config rock5c.config" +radxa:rock-android12 $ export PRODUCT_KERNEL_DTS="rk3588s-rock-5c" +``` + +2. Compile U-boot + +```bash +android12 $ cd u-boot +android12/u-boot $ make clean +android12/u-boot $ make mrproper +android12/u-boot $ make distclean +android12/u-boot $ ./make.sh ${PRODUCT_UBOOT_CONFIG} +android12 $ cd - +``` + +3. Compile the kernel + +```bash +radxa:rock-android12 $ cd kernel-5.10 +radxa:rock-android12/kernel-5.10 $ export PATH=../prebuilts/clang/host/linux-x86/clang-r416183b/bin:$PATH +radxa:rock-android12/kernel-5.10 $ alias msk='make CROSS_COMPILE=aarch64-linux-gnu- LLVM=1 LLVM_IAS=1' +radxa:rock-android12/kernel-5.10 $ msk ARCH=arm64 ${PRODUCT_KERNEL_CONFIG} +radxa:rock-android12/kernel-5.10 $ msk ARCH=arm64 BOOT_IMG=../rockdev/Image-${PRODUCT_NAME}/boot.img ${PRODUCT_KERNEL_DTS}.img + +radxa:rock-android12 $ cd - +``` + +4. Compile AOSP + +```bash +android12 $ source build/envsetup.sh +android12 $ lunch ${PRODUCT_NAME}-userdebug +android12 $ make -j$(nproc) +``` + +5. Make Images + +```bash +android12 $ rm -rf rockdev +android12 $ ln -s RKTools/linux/Linux_Pack_Firmware/rockdev . +android12 $ ./mkimage.sh +``` + +6. Pack Images + +```bash +android12 $ cd rockdev +android12/rockdev $ rm -rf Image +android12/rockdev $ ln -s Image-${PRODUCT_NAME} Image +``` + +- Packaged as an RK update format image + +``` +radxa:rock-android12/rockdev $ ./mkupdate.sh rk3588 Image +``` + +Generated update.img in the rockdev/ directory + +- Packaged as a GPT format image + +``` +android12/rockdev $ ./android-gpt.sh +``` diff --git a/i18n/en/docusaurus-plugin-content-docs/current/rock5/rock5c/other-os/android/preparation.md b/i18n/en/docusaurus-plugin-content-docs/current/rock5/rock5c/other-os/android/preparation.md new file mode 100644 index 000000000..0c16f907d --- /dev/null +++ b/i18n/en/docusaurus-plugin-content-docs/current/rock5/rock5c/other-os/android/preparation.md @@ -0,0 +1,47 @@ +--- +sidebar_position: 1 +--- + +## Preparation + +## Development preparation + + + + + +### Power supply + +:::tip +The ROCK 5C supports USB Type-C PD 2.0 at 9V/2A, 12V/2A, 15V/2A and 20V/2A. Radxa recommends using [Radxa Power PD30W](../../accessories/pd-30w). +:::. + +### Storage + +microSD card with a capacity of at least 8GB, for system boot disk + +### microSD card reader + +Used to create system boot disk + + + + + +### Display + +### Network connection + +### Type-C Hub + +Used to extend the USB port for external devices such as USB mouse, USB keyboard, etc. + +### USB Mouse + +### USB Keyboard + + + + + +[Supported Accessories](../../accessories) diff --git a/i18n/en/docusaurus-plugin-content-docs/current/rock5/rock5c/other-os/android/remote-login.md b/i18n/en/docusaurus-plugin-content-docs/current/rock5/rock5c/other-os/android/remote-login.md new file mode 100644 index 000000000..41c5af994 --- /dev/null +++ b/i18n/en/docusaurus-plugin-content-docs/current/rock5/rock5c/other-os/android/remote-login.md @@ -0,0 +1,128 @@ +--- +sidebar_position: 3 +--- + +import Serial from "../../../../common/general/\_serial.mdx" + +# Remote login + +Introduce how to access SBC through a personal computer (PC) via serial port,adb,etc. + + + + + +ADB is a bridge between your Android device and your computer, and is used to fully operate and manage your Android device on your computer. + +### preparation + +install adb(Android Debug Bridge): + + + + + +Download the Windows version of the adb toolkit from [Android](https://source.android.com/docs/setup/build/adb),and after downloading and decompressing,you need to configure the environment variables: + +Method 1:Enter the following command in the terminal window: + +```bash + +set HTTP_PROXY=myserver:1981 + +``` + +Method 2:Open system settings and modify environment variables:![5c adb](/img/nx5/adb_config_en.webp) + + + + + +Use the following command to install: + +```bash + +sudo apt install adb + +``` + + + + + +Download the Mac version of the adb toolkit from [Android](https://source.android.com/docs/setup/build/adb),and after downloading and decompressing,you need to configure the environment variables: + +```bash +export PATH=${path}:~/platform-tools( '~' is the path of the extracted toolkit) +``` + + + + + + + + + +#### Requirements + +- 1 x USB A-A cable +- 1 x computer or laptop with the ADB tool installed on it +- 1 x Rock 5C + +#### Steps + +1. Connect the USB cable between the USB connector of the computer and the OTG Type C connector of the Rock 5C. +2. Open the computer terminal and enter adb devices to confirm that the Rock 5C is recognized.Type adb shell to login. + +```bash + +$ adb devices + List of devices attached + f94f8e0d28380ceb device + +$ adb shell + RadxaRock5C:/ $ + +``` + + + + + +Wireless ADB is supported on Android 11 and later. + +#### Requirements + +1. a computer or laptop with ADB tools installed and ADB version greater than 31.0.0. +2. a Rock 5C with an Android image greater than or equal to 11. +3. the computer and Rock 5C need to be on the same LAN. + +#### Steps + +1. Start Rock 5C and connect to the network using wifi. +2. Enter the Developing mode by tapping the version number 7 times (Settings -> About Tablet -> Version Number). +3. Go to Developing Options (Settings -> System -> Developing Options),turn on wireless debugging and memorize the IP address and interface (example: 10.0.0.16:45613). +4. Open a computer terminal and type adb connect 10.0.0.16:45613 to connect to the Rock 5C,type adb shell to login. + +```bash + +$ adb connect 10.0.0.16:45613 +$ adb shell + RadxaRock5C:/ $ + +``` + + + + + + + + + + + + + +