Skip to content

Commit

Permalink
docs: Added cm3i installation Android documentation
Browse files Browse the repository at this point in the history
  • Loading branch information
y0w0 committed Nov 13, 2024
1 parent 4c4d0b3 commit 2ee741f
Show file tree
Hide file tree
Showing 4 changed files with 217 additions and 0 deletions.
38 changes: 38 additions & 0 deletions docs/compute-module/cm3i/other-os/android/install-os.mdx
Original file line number Diff line number Diff line change
@@ -0,0 +1,38 @@
---
sidebar_position: 2
title: 系统安装
---

import Etcher from "../../../../common/general/_etcherV2.mdx";

本文档将介绍如何把 Android 镜像安装到 Radxa CM3。

CM3I 可以从 microSD 卡启动,也可以从板载 EMMC 启动,基于不同的启动方式,安装系统到不同的介质上.

## 镜像下载

[Android11 镜像下载](https://github.com/radxa/manifests/releases/download/android11-radxa-20240724/Radxa_CM3I_Android11_r12-20240724-gpt.zip)

## 系统安装

### 安装系统到 EMMC 参考 <a href="../../low-level-dev/maskrom">通过 USB 刷机部分</a>

### 安装系统到 microSD 卡

#### MicroSD 卡准备

将 MicroSD 卡插入到 SD 卡读卡器中,然后将读卡器插入到 PC 的 USB 端口上

#### 镜像烧录

<Etcher />

#### 启动系统

按照上述步骤成功烧录 MicroSD Card 后, 将 MicroSD Card 插入到 MicroSD Card 插槽内 (如下图所示),然后上电,系统开始启动,HDMI显示桌面。

<img
src="/img/cm3i/radxa-cm3i-io-board-sd-slot.webp"
alt="sd slot"
style={{ width: "60%" }}
/>
72 changes: 72 additions & 0 deletions docs/compute-module/cm3i/other-os/android/low-level-dev.md
Original file line number Diff line number Diff line change
@@ -0,0 +1,72 @@
---
sidebar_position: 4
---

# 底层开发

主要介绍 uboot, kernel, aosp 编译打包等内容

## 环境配置

建议使用 Ubuntu 16.04 及以上版本

## 源码下载

```bash

$ repo init -u https://github.com/radxa/manifests.git -b Android11_Radxa_rk12 -m rockchip-r-release.xml
$ repo sync -d -c -j4

```

## 镜像编译

### 全部编译

适合第一次编译

CM3I IO

```bash
radxa:rock-android12 $ source build/envsetup.sh
radxa:rock-android12 $ lunch rk3568_radxa_cm3i-userdebug
radxa:rock-android12 $ ./build.sh -UACKup
# get images from IMAGE directory
```

等待编译完成就可以在 IMAGE 目录找到镜像

### 单独编译

适合小修改后编译

例如,只修改过

U-boot

```bash
radxa:rock-android12 $ source build/envsetup.sh
radxa:rock-android12 $ lunch rk3568_radxa_cm3i-userdebug
radxa:rock-android12 $ ./build.sh -AUup

```

Kernel

```bash
radxa:rock-android12 $ source build/envsetup.sh
radxa:rock-android12 $ lunch rk3568_radxa_cm3i-userdebug
radxa:rock-android12 $ ./build.sh -ACKup
```

AOSP

```bash
radxa:rock-android12 $ source build/envsetup.sh
radxa:rock-android12 $ lunch rk3568_radxa_cm3i-userdebug
radxa:rock-android12 $ ./build.sh -Aup
```

等待编译完成就可以在 IMAGE 目录找到镜像

## 常见问题
Original file line number Diff line number Diff line change
@@ -0,0 +1,38 @@
---
sidebar_position: 2
title: Install OS
---

import Etcher from "../../../../common/general/_etcherV2.mdx";

This document introduces how to install Android image to Radxa CM3.

CM3I can boot from microSD card or eMMC, so install os on microSD card or eMMC based on your choose.

## Image download

[Android11 Image](https://github.com/radxa/manifests/releases/download/android11-radxa-20240724/Radxa_CM3I_Android11_r12-20240724-gpt.zip)

## Install OS

### Installing the system to EMMC reference <a href="../../low-level-dev/maskrom">Install OS via USB Section</a>

### Install the system to the microSD card

#### MicroSD card preparation

Insert the MicroSD card into the SD card reader, and then insert the card reader into the USB port of the PC.

#### Image burning

<Etcher />

#### Boot the system

After successfully burning the MicroSD Card according to the above steps, insert the MicroSD Card into the MicroSD Card slot (as shown in the following figure), and then power on the system, the system will start booting up and HDMI will display the desktop.

<img
src="/img/cm3i/radxa-cm3i-io-board-sd-slot.webp"
alt="sd slot"
style={{ width: "60%" }}
/>
Original file line number Diff line number Diff line change
@@ -0,0 +1,69 @@
---
sidebar_position: 4
---

# Low-Level development

Introduces how to download and build uboot, kernel, os etc.

## Environment configuration

Ubuntu 16.04 and above are recommended

## code download

```bash

$ repo init -u https://github.com/radxa/manifests.git -b Android11_Radxa_rk12 -m rockchip-r-release.xml
$ repo sync -d -c -j4
```

## build

Suitable for first compilation

CM3 IO

```bash
radxa:rock-android12 $ source build/envsetup.sh
radxa:rock-android12 $ lunch rk3568_radxa_cm3i-userdebug
radxa:rock-android12 $ ./build.sh -UACKup
# get images from IMAGE directory
```

Wait for the compilation to complete and you can find the image in the IMAGE directory

### Compile separately

Suitable for compiling after minor modifications

For example, only modify

U-boot

```bash
radxa:rock-android12 $ source build/envsetup.sh
radxa:rock-android12 $ lunch rk3568_radxa_cm3i-userdebug
radxa:rock-android12 $ ./build.sh -AUup

```

Kernel

```bash
radxa:rock-android12 $ source build/envsetup.sh
radxa:rock-android12 $ lunch rk3568_radxa_cm3i-userdebug
radxa:rock-android12 $ ./build.sh -ACKup
```

AOSP

```bash
radxa:rock-android12 $ source build/envsetup.sh
radxa:rock-android12 $ lunch rk3568_radxa_cm3i-userdebug
radxa:rock-android12 $ ./build.sh -Aup
```

Wait for the compilation to complete and you can find the image in the IMAGE directory

## FAQ

0 comments on commit 2ee741f

Please sign in to comment.