diff --git a/docs/rock5/rock5a/_image.mdx b/docs/rock5/rock5a/_image.mdx index d67b34e31..50ed6f771 100644 --- a/docs/rock5/rock5a/_image.mdx +++ b/docs/rock5/rock5a/_image.mdx @@ -22,6 +22,13 @@ import React, { Fragment } from "react"; ROCK 5A 系统镜像（6.1 内核）: Radxa ROCK 5A Debian12 b3{" "} +
  • + {" "} + + {" "} + ROCK 5A Android12 : Radxa ROCK 5A Android{" "} + +
  • {" "} {" "} - MiniLoader.bin{" "} + ROCK 5A Android Loader 文件：MiniLoader.bin{" "}
    • diff --git a/docs/rock5/rock5a/download.md b/docs/rock5/rock5a/download.md index 34df1ab64..8482849d3 100644 --- a/docs/rock5/rock5a/download.md +++ b/docs/rock5/rock5a/download.md @@ -16,7 +16,7 @@ Radxa ROCK 5A V1.1 版本 ## 操作系统镜像 - + :::caution diff --git a/docs/rock5/rock5a/other-os/android/README.md b/docs/rock5/rock5a/other-os/android/README.md new file mode 100644 index 000000000..ad6379ff3 --- /dev/null +++ b/docs/rock5/rock5a/other-os/android/README.md @@ -0,0 +1,9 @@ +--- +sidebar_position: 7 +--- + +# Android 系统 + +主要介绍系统如何使用 + + diff --git a/docs/rock5/rock5a/other-os/android/getting-started.md b/docs/rock5/rock5a/other-os/android/getting-started.md new file mode 100644 index 000000000..78f64bcff --- /dev/null +++ b/docs/rock5/rock5a/other-os/android/getting-started.md @@ -0,0 +1,20 @@ +--- +sidebar_position: 1 +description: "快速上手 ROCK 5A，让您能够轻松开始使用和探索其功能。" +--- + +# 上手指南 + +## 产品介绍 + +请参考 [产品介绍](../../getting-started/introduction.md) + +## 快速上手 + +请参考 [快速上手](../../getting-started/quick-start.md) + +**_Note: 系统安装部分 要参考[这里](./install-os.md)_** + +## 电源选择 + +请参考 [电源选择](../../getting-started/power-supply.md) diff --git a/docs/rock5/rock5a/other-os/android/install-os.md b/docs/rock5/rock5a/other-os/android/install-os.md new file mode 100644 index 000000000..3fe639d13 --- /dev/null +++ b/docs/rock5/rock5a/other-os/android/install-os.md @@ -0,0 +1,97 @@ +--- +sidebar_position: 2 +title: 系统安装 +--- + +import Etcher from '../../../../common/general/\_etcherV2.mdx' + +本文档将介绍如何把 Android 镜像安装到 ROCK 5C。 + +ROCK 5A 可以从 microSD 卡启动，也可以从 EMMC 启动，基于不同的启动方式，安装系统到不同的介质上. + + + + + +#### 准备工作 + +- 1x microSD 卡(容量 >=16GB，读写速度等级 >= class10) +- 1x microSD 读卡器 +- 5V 电源适配器 (推荐使用 [Radxa Power PD30W](../../accessories/pd-30w)) + +#### 镜像下载 + +请到 [资源下载汇总](../../download) 下载对应的镜像文件并解压 + +#### 安装系统 + + + +#### 启动系统 + +- 按照上述步骤成功烧录 microSD 卡后，将 microSD 卡插入 ROCK 5A 的 MicroSD 插槽内。 +- ROCK 5A 的供电接口为 [Type C port](/rock5/rock5a/hardware-design/hardware-interface)，请使用 Type-C 线缆连接供电口和适配器。 + + + + + +#### 准备工作 + +- USB 接口线缆(A-A) +- 1x eMMC 模块 +- 5V 电源适配器 (推荐使用 [Radxa Power PD30W](../../accessories/pd-30w)) + +#### 镜像下载 + +请到 [资源下载汇总](../../download) 下载对应的镜像文件并解压 + +#### 系统安装 + +进入 maskrom 模式 + +- 断开开发板电源 +- 移除 SD 卡，并插入 EMMC 模块 +- 用 USB A-A 连接 Radxa ROCK 5A 的 USB3.0 口 和 PC 端 +- 使用杜邦线短接 Maskrom Key +- 给开发板上电 +- PC 端查看是否有 USB 设备 + - Linux/macOS: 检查执行 lsusb 后是否有显示 "Bus 001 Device 112: ID 2207:350a Fuzhou Rockchip Electronics Company" + - Windows: 打开 RKDevTool 您会看到设备处于 "maskrom mode". + + + + + +#### Linux 系统使用 rkdeveloptool 写入 + +[rkdeveloptool](../../low-level-dev/maskrom/linux) + + + + + +#### Mac 系统使用 rkdeveloptool 写入 + +[rkdeveloptool](../../low-level-dev/maskrom/mac-os) + + + + + +#### Windows 系统使用 rkdevtool 写入 + +[rkdevtool](/rock5/rock5a/low-level-dev/maskrom/windows) + + + + + +#### 启动 ROCK 5A + +1. 通过适配器为 ROCK 5A 供电 +2. ROCK 5A 将绿色电源 LED 亮起的情况下启动，启动成功后蓝色 LED 闪烁 + + + + diff --git a/docs/rock5/rock5a/other-os/android/low-level-dev.md b/docs/rock5/rock5a/other-os/android/low-level-dev.md new file mode 100644 index 000000000..db643cdad --- /dev/null +++ b/docs/rock5/rock5a/other-os/android/low-level-dev.md @@ -0,0 +1,93 @@ +--- +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 -UACKu +# get images from rockdev directory +``` + +等待编译完成就可以在 rockdev 目录找到镜像 + +### 方法二 + +可以根据这个方法一步一步编译镜像 + +1. 设置编译项目的环境 + +```bash +radxa:rock-android12 $ source build/envsetup.sh +radxa:rock-android12 $ lunch RadxaRock5C-userdebug +``` + +2. 编译 U-boot + +```bash +radxa:rock-android12 $ ./build.sh -U +``` + +3. 编译内核 + +```bash +radxa:rock-android12 $ ./build.sh -CK +``` + +4. 编译AOSP + +```bash +radxa:rock-android12 $ ./build.sh -A +``` + +5. 制作 Images + +```bash +radxa:rock-android12 $ ./build.sh -u +``` diff --git a/docs/rock5/rock5a/other-os/android/remote-login.md b/docs/rock5/rock5a/other-os/android/remote-login.md new file mode 100644 index 000000000..5ce01ef95 --- /dev/null +++ b/docs/rock5/rock5a/other-os/android/remote-login.md @@ -0,0 +1,128 @@ +--- +sidebar_position: 3 +--- + +import Serial from "../../../../common/general/\_serial.mdx" + +# 远程登录 + +本章节旨在向需要通过个人电脑（PC）远程访问 SBC 的用户介绍如何通过串口、adb 等方式进行远程登录 ROCK 5A + + + + + +#### 准备工作 + +adb（调试桥）安装： + + + + + +从Android[官方网站](https://source.android.com/docs/setup/build/adb)下载Windows版本的adb工具包，下载解压后需要配置环境变量: + +方式一：在终端窗口输入以下命令： + +```bash + +set HTTP_PROXY=myserver:1981 + +``` + +方式二：打开系统设置，修改环境变量：![rock5a 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 5A + +#### 步骤 + +1. 用 USB 线连接计算机的 USB 接口和 ROCK 5A 的 USB3.0 Type A 接口 +2. 打开计算机终端输入 adb devices 确认识别到 ROCK 5A ,输入 adb shell 登录 + +```bash + +$ adb devices + List of devices attached + f94f8e0d28380ceb device + +$ adb shell + RadxaRock5A:/ $ + +``` + + + + + +Android 11 版本以后支持无线 ADB 。 + +#### 要求 + +1. 一台有安装 ADB 工具的电脑或笔记本 ，ADB 版本需要大于 31.0.0 +2. 一个ROCK 5A，安卓镜像需要大于或等于 11 +3. 计算机和 ROCK 5A 需要在同一个局域网 + +#### 步骤 + +1. 启动 ROCK 5A ，使用 wifi 连接 网络 +2. 进入开发着模式，点击7次版本号可进入开发着模式（设置 -> 关于平板电脑 -> 版本号） +3. 进入开发着选项（设置 -> 系统 -> 开发着选项），打开无线调试，记住IP地址和接(例：10.0.0.16:45613) +4. 打开计算机终端输入 adb connect 10.0.0.16:45613 连接 ROCK 5A ，输入 adb shell 登录 + +```bash +$ adb connect 10.0.0.16:45613 + +$ adb shell + RadxaRock5A:/ $ +``` + + + + + + + + + + + + + + diff --git a/i18n/en/docusaurus-plugin-content-docs/current/rock5/rock5a/_image.mdx b/i18n/en/docusaurus-plugin-content-docs/current/rock5/rock5a/_image.mdx index 62901f621..6e163a8c3 100644 --- a/i18n/en/docusaurus-plugin-content-docs/current/rock5/rock5a/_image.mdx +++ b/i18n/en/docusaurus-plugin-content-docs/current/rock5/rock5a/_image.mdx @@ -22,6 +22,13 @@ import React, { Fragment } from "react"; ROCK 5A (Kernel 6.1): Radxa ROCK 5A Debian12 b3{" "} +
  • + {" "} + + {" "} + ROCK 5A Android12 : Radxa ROCK 5A Android{" "} + +
  • {" "} {" "} - MiniLoader.bin{" "} + ROCK 5A Android Loader : MiniLoader.bin{" "}
    • diff --git a/i18n/en/docusaurus-plugin-content-docs/current/rock5/rock5a/download.md b/i18n/en/docusaurus-plugin-content-docs/current/rock5/rock5a/download.md index 1167539c8..56c4ff6c6 100644 --- a/i18n/en/docusaurus-plugin-content-docs/current/rock5/rock5a/download.md +++ b/i18n/en/docusaurus-plugin-content-docs/current/rock5/rock5a/download.md @@ -16,7 +16,7 @@ Radxa ROCK 5A Version V1.1 ## System Image - + :::caution diff --git a/i18n/en/docusaurus-plugin-content-docs/current/rock5/rock5a/other-os/android/README.md b/i18n/en/docusaurus-plugin-content-docs/current/rock5/rock5a/other-os/android/README.md new file mode 100644 index 000000000..a919b88d0 --- /dev/null +++ b/i18n/en/docusaurus-plugin-content-docs/current/rock5/rock5a/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/rock5a/other-os/android/getting-started.md b/i18n/en/docusaurus-plugin-content-docs/current/rock5/rock5a/other-os/android/getting-started.md new file mode 100644 index 000000000..70e711589 --- /dev/null +++ b/i18n/en/docusaurus-plugin-content-docs/current/rock5/rock5a/other-os/android/getting-started.md @@ -0,0 +1,20 @@ +--- +sidebar_position: 1 +description: "Quickly get started with ROCK 5B/5B+, allowing you to easily start using and exploring its features." +--- + +# Getting Started Guide + +## Product Introduction + +Please refer to [Product Introduction](../../getting-started/introduction.md) + +## Get started quickly + +Please refer to [Quick Start](../../getting-started/quick-start.md) + +**_Note: ‘Installing the operating system' part needs to refer to[ here](./install-os.md)_** + +## Power supply + +Please refer to [Power Selection](../../getting-started/power-supply.md) diff --git a/i18n/en/docusaurus-plugin-content-docs/current/rock5/rock5a/other-os/android/install-os.md b/i18n/en/docusaurus-plugin-content-docs/current/rock5/rock5a/other-os/android/install-os.md new file mode 100644 index 000000000..eb8d1deed --- /dev/null +++ b/i18n/en/docusaurus-plugin-content-docs/current/rock5/rock5a/other-os/android/install-os.md @@ -0,0 +1,101 @@ +--- +sidebar_position: 2 +title: Install OS +--- + +import Etcher from '../../../../common/general/\_etcherV2.mdx' + +This document describes how to install an Android image to the ROCK 5A. + +ROCK 5A can be booted from microSD card or EMMC, depending on the boot method, the system will be installed on different media. + + + + + +#### 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 ROCK 5A. +- The power supply interface of ROCK 5A is [Type C port](/rock5/rock5a/hardware-design/hardware-interface), please connect the power supply port and the adapter with Type-C cable. + + + + + +#### Preparation + +#### Prepare installation media + +- USB connector cable (A-A) +- 1x eMMC module +- 5V power adapter (Recommended [Radxa Power PD30W](../../accessories/pd-30w)) + +#### Download the image + +Please go to [Resource Download Summary](../../download) to download the corresponding image file. + +#### System Installation + +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 5A 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 systems are written using rkdeveloptool + +[rkdeveloptool](../../low-level-dev/maskrom/linux) + + + + + +#### Mac systems are written using rkdeveloptool + +[rkdeveloptool](../../low-level-dev/maskrom/mac-os) + + + + + +#### Windows systems write with rkdevtool + +[rkdevtool](/rock5/rock5b/low-level-dev/maskrom/windows) + + + + + +#### Starting the ROCK 5A + +1. Power up the ROCK 5A via the adapter. +2. The ROCK 5A will start up with the green power LED on. + + + + diff --git a/i18n/en/docusaurus-plugin-content-docs/current/rock5/rock5a/other-os/android/low-level-dev.md b/i18n/en/docusaurus-plugin-content-docs/current/rock5/rock5a/other-os/android/low-level-dev.md new file mode 100644 index 000000000..43d044ed9 --- /dev/null +++ b/i18n/en/docusaurus-plugin-content-docs/current/rock5/rock5a/other-os/android/low-level-dev.md @@ -0,0 +1,94 @@ +--- +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 -UACKu +# get images from rockdev directory +``` + +Wait for the build to complete and you will find the images in the rockdev 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 $ source build/envsetup.sh +radxa:rock-android12 $ lunch RadxaRock5C-userdebug +``` + +2. Compile U-boot + +```bash +radxa:rock-android12 $ . /build.sh -U +``` + +3. Compile the kernel + +```bash +radxa:rock-android12 $ . /build.sh -CK +``` + +4. Compile AOSP + +```bash +radxa:rock-android12 $ . /build.sh -A +``` + +5. Make Images + +```bash +radxa:rock-android12 $ . /build.sh -u +``` diff --git a/i18n/en/docusaurus-plugin-content-docs/current/rock5/rock5a/other-os/android/remote-login.md b/i18n/en/docusaurus-plugin-content-docs/current/rock5/rock5a/other-os/android/remote-login.md new file mode 100644 index 000000000..b615cebe2 --- /dev/null +++ b/i18n/en/docusaurus-plugin-content-docs/current/rock5/rock5a/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:/ $ + +``` + + + + + + + + + + + + + +