Skip to content
Merged
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
85 changes: 85 additions & 0 deletions docs/common/accessories/_rtc-bat.mdx
Original file line number Diff line number Diff line change
@@ -0,0 +1,85 @@
import { Image } from "@site/src/utils/docs";

{props.product} 的板载 RTC 电池接口用于为系统提供稳定的时钟信号,确保系统在断电后仍能保持时间。

## 接口规格

- 接口类型:{props.interface}
- 电池类型:{props.battery_type}
- 电池电压:{props.battery_voltage}

## 硬件连接

{props.product} 连接 RTC 电池时,请注意正负极以及工作电压,避免损坏 {props.product}。

<Image
src="/img/common/accessories/rtc-bat-#board#.webp"
board={props.board}
fallback={props.board}
width="1200"
/>

## 配置 RTC

### 确认 RTC 硬件

使用以下命令来确认 RTC 硬件是否正常工作。

<NewCodeBlock tip={`radxa@${props?.board ?? 'device'}$`} type="device">

```
sudo dmesg | grep rtc
```

</NewCodeBlock>

终端输出类似信息:`registered as rtc0`,说明 RTC 电池被正确识别。

```
[ 0.368528] msm_dpu ae01000.display-controller: [drm] Cannot find any crtc or sizes
[ 0.368720] msm_dpu ae01000.display-controller: [drm] Cannot find any crtc or sizes
[ 6.259233] rtc-ds1307 10-0068: registered as rtc0
[ 6.260658] rtc-ds1307 10-0068: setting system clock to 2025-08-06T08:39:15 UTC (1754469555)
```

### 读取 RTC 时间

终端使用 `hwclock` 命令读取 RTC 芯片(/dev/rtc0)的当前时间。

<NewCodeBlock tip={`radxa@${props?.board ?? 'device'}$`} type="device">

```
sudo apt update
sudo apt install util-linux util-linux-extra -y
sudo hwclock -r -f /dev/rtc0
```

</NewCodeBlock>

### 显示系统时间

使用 `date` 命令显示系统当前时间。

<NewCodeBlock tip={`radxa@${props?.board ?? 'device'}$`} type="device">

```
date
```

</NewCodeBlock>

### 设置 RTC 时间

若 RTC 时间和系统时间不一致,可以使用 `hwclock` 命令将系统当前时间写入 RTC。

<NewCodeBlock tip={`radxa@${props?.board ?? 'device'}$`} type="device">

```
sudo hwclock -w -f /dev/rtc0
```

</NewCodeBlock>

### 验证 RTC 功能

记录当前系统时间,然后断开主板电源和网络,等待 10 分钟左右,然后重新连接电源,观察系统时间是否正常计时。
20 changes: 12 additions & 8 deletions docs/common/radxa-os/rkdevtool/_emmc.mdx
Original file line number Diff line number Diff line change
@@ -1,6 +1,10 @@
主要介绍如何使用 RKDevTool 工具将系统镜像烧录到 eMMC 模块上
使用 RKDevTool 工具将系统镜像烧录到 eMMC

说明:需要确保主板已经进入 Maskrom 模式且被系统正常识别
:::tip 重要提醒
安装系统到 eMMC 中,需要确保主板已经进入 Maskrom 模式且被系统正常识别。

需要的 Loader 文件和系统镜像可以访问 <a href={props?.download_page ?? '../../../../download'}>资源汇总下载</a> 页面下载。
:::

<Tabs queryString="platform">

Expand All @@ -26,18 +30,18 @@
/>
</div>

断开主板与 PC 的连接,然后重新插拔电源,系统会自动从 eMMC 模块中启动
断开主板与 PC 的连接,然后重新插拔电源,系统会自动从 eMMC 启动

</TabItem>

<TabItem value="Linux / MacOS">
在 Linux / MacOS 平台,我们可以终端命令行,然后按照以下步骤安装系统到 eMMC 上。
<TabItem value="Linux / macOS">
在 Linux / macOS 平台,我们可以终端命令行,然后按照以下步骤安装系统到 eMMC 上。

1. 运行 Loader 文件

将下面命令中的 `demo.bin` 替换为主板对应的 Loader 文件。

<NewCodeBlock tip="Linux / MacOS$" type="host">
<NewCodeBlock tip="Linux / macOS$" type="host">

```
sudo rkdeveloptool db demo.bin
Expand All @@ -49,7 +53,7 @@ sudo rkdeveloptool db demo.bin

将下面命令中的 `demo.img` 替换为主板对应的系统镜像。

<NewCodeBlock tip="Linux / MacOS$" type="host">
<NewCodeBlock tip="Linux / macOS$" type="host">

```
sudo rkdeveloptool wl 0 demo.img
Expand All @@ -61,7 +65,7 @@ sudo rkdeveloptool wl 0 demo.img

断开主板与 PC 的连接,然后重新插拔电源,系统会自动从 eMMC 中启动。

<NewCodeBlock tip="Linux / MacOS$" type="host">
<NewCodeBlock tip="Linux / macOS$" type="host">

```
sudo rkdeveloptool rd
Expand Down
14 changes: 7 additions & 7 deletions docs/common/radxa-os/rkdevtool/_maskrom.mdx
Original file line number Diff line number Diff line change
@@ -1,6 +1,6 @@
import { Image } from "@site/src/utils/docs";

## Maskrom 模式说明
- Maskrom 模式说明

在瑞芯微(Rockchip)平台的开发中,RKDevTool 是常用的烧录工具,我们可以让主板进入 Maskrom 模式后使用 RKDevTool 进行固件的烧录。

Expand All @@ -10,7 +10,7 @@ Maskrom 模式是嵌入式设备的“硬件急救箱”,通过直接操作芯
Maskrom 模式是 Rockchip 芯片内置的底层恢复模式,当设备无法从任何启动介质( eMMC、 SD 卡等)加载有效引导程序时自动进入系统时,我们可以通过通过 RockUSB 协议重新烧写设备固件。
:::

## 进入 Maskrom 模式
- 进入 Maskrom 模式

我们的主板上有一个专用的 Maskrom 按键,在给主板上电前按住 Maskrom 按键,通电后系统检测到 Maskrom 按键被按下,主板就会自动进入 Maskrom 模式。

Expand All @@ -33,7 +33,7 @@ Maskrom 模式是 Rockchip 芯片内置的底层恢复模式,当设备无法

主板进入 Maskrom 模式后,我们可以使用 RKDevTool 工具验证主板是否进入 Maskrom 模式。

## 验证 Maskrom 模式
- 验证 Maskrom 模式

<Tabs queryString="rkdevtool">

Expand All @@ -52,13 +52,13 @@ Maskrom 模式是 Rockchip 芯片内置的底层恢复模式,当设备无法

</TabItem>

<TabItem value="Linux / MacOS">
<TabItem value="Linux / macOS">

在 Linux / MacOS 平台,我们可以使用 RKDevTool 工具验证主板是否进入 Maskrom 模式。
在 Linux / macOS 平台,我们可以使用 RKDevTool 工具验证主板是否进入 Maskrom 模式。

使用 `rkdeveloptool ld` 命令可以查看主板是否进入 Maskrom 模式。

<NewCodeBlock tip="Linux / MacOS$" type="host">
<NewCodeBlock tip="Linux / macOS$" type="host">

```
sudo rkdeveloptool ld
Expand All @@ -68,7 +68,7 @@ sudo rkdeveloptool ld

若系统终端输出类似以下信息,说明主板已经进入 Maskrom 模式。

<NewCodeBlock tip="Linux / MacOS$" type="host">
<NewCodeBlock tip="Linux / macOS$" type="host">

```
DevNo=1 Vid=0x2207,Pid=0x350e,LocationID=109 Maskrom
Expand Down
8 changes: 4 additions & 4 deletions docs/common/radxa-os/rkdevtool/_maskrom_two_device.mdx
Original file line number Diff line number Diff line change
Expand Up @@ -77,13 +77,13 @@ Maskrom 模式是 Rockchip 芯片内置的底层恢复模式,当设备无法

</TabItem>

<TabItem value="Linux / MacOS">
<TabItem value="Linux / macOS">

在 Linux / MacOS 平台,我们可以使用 RKDevTool 工具验证主板是否进入 Maskrom 模式。
在 Linux / macOS 平台,我们可以使用 RKDevTool 工具验证主板是否进入 Maskrom 模式。

使用 `rkdeveloptool ld` 命令可以查看主板是否进入 Maskrom 模式。

<NewCodeBlock tip="Linux / MacOS$" type="host">
<NewCodeBlock tip="Linux / macOS$" type="host">

```
sudo rkdeveloptool ld
Expand All @@ -93,7 +93,7 @@ sudo rkdeveloptool ld

若系统终端输出类似以下信息,说明主板已经进入 Maskrom 模式。

<NewCodeBlock tip="Linux / MacOS$" type="host">
<NewCodeBlock tip="Linux / macOS$" type="host">

```
DevNo=1 Vid=0x2207,Pid=0x350e,LocationID=109 Maskrom
Expand Down
6 changes: 3 additions & 3 deletions docs/common/radxa-os/rkdevtool/_spi.mdx
Original file line number Diff line number Diff line change
Expand Up @@ -43,7 +43,7 @@ SPI启动固件(BootROM + 引导程序)的核心任务是分阶段初始化

</TabItem>

<TabItem value="Linux / MacOS">
<TabItem value="Linux / macOS">

1. 确保主板处于 Maskrom 模式

Expand Down Expand Up @@ -118,7 +118,7 @@ sudo rkdeveloptool rd

</TabItem>

<TabItem value="Linux / MacOS">
<TabItem value="Linux / macOS">

1. 确保主板处于 Maskrom 模式

Expand All @@ -140,7 +140,7 @@ DevNo=1 Vid=0x2207,Pid=0x350e,LocationID=109 Maskrom

你需要将 `demo.bin` 换成主板对应的 Loader 文件

<NewCodeBlock tip="Linux / MacOS$" type="host">
<NewCodeBlock tip="Linux / macOS$" type="host">

```
sudo rkdeveloptool db demo.bin
Expand Down
14 changes: 7 additions & 7 deletions docs/common/radxa-os/rkdevtool/_use.mdx
Original file line number Diff line number Diff line change
@@ -1,4 +1,4 @@
RKDevTool 是瑞芯微(Rockchip)平台为 Windows/Linux/MacOS 平台下进行 USB 烧录所开发的软件,旨在简化和加速对 Rockchip 系列芯片的开发、调试过程。
RKDevTool 是瑞芯微(Rockchip)平台为 Windows/Linux/macOS 平台下进行 USB 烧录所开发的软件,旨在简化和加速对瑞芯微系列芯片的开发、调试过程。

<Tabs queryString="rkdevtool">

Expand All @@ -21,7 +21,7 @@ RKDevTool 是瑞芯微(Rockchip)平台为 Windows/Linux/MacOS 平台下进
<div style={{ textAlign: "center" }}>
<img
src="/img/common/tools/rkdevtool/rkdevtool-driver.webp"
style={{ width: "75%", maxWidth: "700" }}
style={{ width: "50%", maxWidth: "700" }}
/>
</div>

Expand Down Expand Up @@ -66,15 +66,15 @@ rkdeveloptool -V

</TabItem>

<TabItem value="MacOS">
<TabItem value="macOS">

- 安装 HomeBrew

[HomeBrew](https://brew.sh/) 是一个免费且开源的包管理器,它简化了 MacOS 用户安装软件的过程。
[HomeBrew](https://brew.sh/) 是一个免费且开源的包管理器,它简化了 macOS 用户安装软件的过程。

若没有安装 HomeBrew,可以按照教程进行安装。

<NewCodeBlock tip="MacOS$" type="host">
<NewCodeBlock tip="macOS$" type="host">

```
/bin/bash -c "$(curl -fsSL https://raw.githubusercontent.com/Homebrew/install/HEAD/install.sh)"
Expand All @@ -86,7 +86,7 @@ rkdeveloptool -V

打开系统终端或命令行,运行以下命令进行安装。

<NewCodeBlock tip="MacOS$" type="host">
<NewCodeBlock tip="macOS$" type="host">

```
brew install automake autoconf libusb pkg-config git wget
Expand All @@ -104,7 +104,7 @@ cp rkdeveloptool /opt/homebrew/bin/

完成 RKDevTool 安装后,使用以下命令可以查看 RKDevTool 版本号。

<NewCodeBlock tip="MacOS$" type="host">
<NewCodeBlock tip="macOS$" type="host">

```
rkdeveloptool -V
Expand Down
Loading
Loading