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

add o6 debian and serial guide #663

Merged
merged 7 commits into from
Jan 28, 2025
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
1 change: 1 addition & 0 deletions .typos.toml
Original file line number Diff line number Diff line change
Expand Up @@ -4,4 +4,5 @@ extend-ignore-identifiers-re = [
"DuPont",
"g3caf61a44c2",
"des3_ede",
"hda",
]
17 changes: 16 additions & 1 deletion docs/common/general/_serial.mdx
Original file line number Diff line number Diff line change
Expand Up @@ -12,6 +12,11 @@ import { Section, Image } from "@site/src/utils/docs";

:::tip

<Section compatible="cix" platform={props.platform}>
基于 CIX 芯片的瑞莎产品,UART 默认配置为 115200n8,无流量控制。

</Section>

<Section compatible="aml" platform={props.platform}>
基于 Amlogic 芯片的瑞莎产品,UART 默认配置为 115200n8,无流量控制。

Expand Down Expand Up @@ -39,7 +44,7 @@ import { Section, Image } from "@site/src/utils/docs";

如下所示连接 USB 转 TTL 串口线:

<Section compatible="^rock5itx" model={props.model}>
<Section compatible="^rock5itx,^o6" model={props.model}>

| Radxa SBC | 连接 | 串口线 |
| --------------- | ----------- | ------ |
Expand All @@ -59,6 +64,16 @@ import { Section, Image } from "@site/src/utils/docs";

</Section>

<Section compatible="o6" model={props.model}>

| Orion O6 | 连接 | 串口线 |
| -------- | ----------- | ------ |
| **GND** | &lt;---&gt; | 黑色线 |
| **TX** | &lt;---&gt; | 白色线 |
| **RX** | &lt;---&gt; | 绿色线 |

</Section>

<Image
src="/img/accessories/#model#-1000px-Serial-connection.webp"
model={props.model}
Expand Down
144 changes: 144 additions & 0 deletions docs/orion/o6/debian/debian-user-guide.md
Original file line number Diff line number Diff line change
Expand Up @@ -48,3 +48,147 @@ Orion O6 有5个显示接口,分别是
| /sys/class/drm/card2-eDP-1 | eDP |
| /sys/class/drm/card3-DP-3 | USBC 1 |
| /sys/class/drm/card4-DP-4 | DP |

## 音频

### 桌面模式

桌面系统的声音设置界面,有显示当前可使用的的音频输出设备。

#### 音频输出设备与硬件接口的对应关系

| 音频输出设备 | 硬件接口 |
| -------------------- | -------- |
| Headphone | 耳机插孔 |
| Speaker | Speaker |
| HDMI / DisplayPort 2 | USBC 0 |
| HDMI / DisplayPort 3 | HDMI |
| HDMI / DisplayPort 4 | USBC 1 |
| HDMI / DisplayPort 5 | DP |

### 命令行模式

#### 查看播音设备

```
root@orion-o6:~# aplay -l
**** List of PLAYBACK Hardware Devices ****
card 0: cixsky1 [cix,sky1], device 0: hda hda-audio-codec-0 []
Subdevices: 1/1
Subdevice #0: subdevice #0
card 0: cixsky1 [cix,sky1], device 1: dptx0_audio i2s-hifi-1 [dptx0_audio i2s-hifi-1]
Subdevices: 1/1
Subdevice #0: subdevice #0
card 0: cixsky1 [cix,sky1], device 2: dptx1_audio i2s-hifi-2 [dptx1_audio i2s-hifi-2]
Subdevices: 1/1
Subdevice #0: subdevice #0
card 0: cixsky1 [cix,sky1], device 3: dptx3_audio i2s-hifi-3 [dptx3_audio i2s-hifi-3]
Subdevices: 1/1
Subdevice #0: subdevice #0
card 0: cixsky1 [cix,sky1], device 4: dptx4_audio i2s-hifi-4 [dptx4_audio i2s-hifi-4]
Subdevices: 1/1
Subdevice #0: subdevice #0
```

#### 查看录音设备

```
root@orion-o6:~# arecord -l
**** List of CAPTURE Hardware Devices ****
card 0: cixsky1 [cix,sky1], device 0: hda hda-audio-codec-0 []
Subdevices: 1/1
Subdevice #0: subdevice #0
```

#### 系统音频设备与硬件接口的对应关系

| 音频设备 | 硬件接口 |
| ---------------------- | ------------------------ |
| had had-audio-codec-0 | 耳机插孔/Speaker/F_AUDIO |
| dptx0_audio i2s-hifi-1 | USBC 0 |
| dptx1_audio i2s-hifi-2 | HDMI |
| dptx3_audio i2s-hifi-3 | USBC 1 |
| dptx4_audio i2s-hifi-4 | DP |

#### F_AUDIO 录音

```
amixer cset iface=MIXER,name='Line1 Mic Switch' 1
arecord -Dhw:0,0 -c 2 -r 48000 -f S16_LE hda_line1_mic.wav
```

#### F_AUDIO 播音

```
amixer cset iface=MIXER,name='ClassD AMP Mute' 1
amixer cset iface=MIXER,name='HP Out Mute' 1
amixer cset iface=MIXER,name='Line2 Out Mute' 0
amixer cset iface=MIXER,name='Line2 Switch' 1
aplay -Dhw:0,0 -c 2 -r 48000 -f S16_LE hda_line1_mic.wav
```

#### 耳机口录音

```
amixer cset iface=MIXER,name='Headset Mic Switch' 1
arecord -Dhw:0,0 -c 2 -r 48000 -f S16_LE hda_hs_mic.wav
```

#### 耳机口播音

```
amixer cset iface=MIXER,name='ClassD AMP Mute' 1
amixer cset iface=MIXER,name='HP Out Mute' 0
amixer cset iface=MIXER,name='Line2 Out Mute' 1
amixer cset iface=MIXER,name='Headset Switch' 1
aplay -Dhw:0,0 -c 2 -r 48000 -f S16_LE hda_hs_mic.wav
```

#### Speaker 播音

```
amixer cset iface=MIXER,name='ClassD AMP Mute' 0
amixer cset iface=MIXER,name='HP Out Mute' 1
amixer cset iface=MIXER,name='Line2 Out Mute' 1
aplay -Dhw:0,0 -c 2 -r 48000 -f S16_LE hda_hs_mic.wav
```

#### USBC 0 播音

```
aplay -Dhw:0,1 playback-songs.wav
```

#### HDMI 播音

```
aplay -Dhw:0,2 playback-songs.wav
```

#### USBC 1 播音

```
aplay -Dhw:0,3 playback-songs.wav
```

#### DP 播音

```
aplay -Dhw:0,4 playback-songs.wav
```

## WiFi/BT 模块

支持列表

- Radxa Wireless Module A8

## 以太网

当使用 iperf3 测试吞吐量时,先使用如下指令,修改中断分配

```
echo 40 > /proc/irq/$(cat /proc/interrupts | grep eth0-0 | cut -d ":" -f 1)/smp_affinity

echo 40 > /proc/irq/$(cat /proc/interrupts | grep eth1-0 | cut -d ":" -f 1)/smp_affinity
```
39 changes: 31 additions & 8 deletions docs/orion/o6/download.md
Original file line number Diff line number Diff line change
Expand Up @@ -18,25 +18,48 @@ Orion O6 V1.2 版本

## 刷机工具

## BIOS & 操作系统镜像
## BIOS

### BIOS
[O6 BIOS](https://dl.radxa.com/orion/o6/images/bios/)

[O6 BIOS](https://github.com/radxa-pkg/edk2-cix/releases)
## Debian 12 预装版系统镜像

### Debian 12 预装版系统镜像
### Debian12 Desktop b3

Radxa DL 链接:[Debian12 Desktop B1](https://dl.radxa.com/orion/o6/images/debian/orion-o6-debian12-preinstalled-desktop-b1.img.gz)
| orion-o6-debian12-preinstalled-desktop-b3.img |
| :-----------------------------------------------------------------------------------------------------------: |
| [Radxa DL 链接](https://dl.radxa.com/orion/o6/images/debian/orion-o6-debian12-preinstalled-desktop-b3.img.gz) |
| [百度网盘链接](https://pan.baidu.com/s/1HzxxBGpHq_CBjzX5SWuzJw?pwd=j6ck) |
| [Mega 链接](https://mega.nz/file/Q2oUVJSS#JBV7U-9miON4_L2Ljw8-4t5lzxJe4tC6PRAtZfIvgPo) |

百度网盘链接:[Debian12 Desktop B1](https://pan.baidu.com/s/1vUQOqCUKBPwJvlPEhubeXw?pwd=5nac)
说明:

Mega 链接:[Debian12 Desktop B1](https://mega.nz/file/lzwmkJAI#LTs9ywuJP4wTq1Dnwgmy34CCPn8LWFhv7stuwvl5ZQA)
- 用于 NVME 和 USB 启动。
- 用户可通过主机上的 balenaEtcher 将该镜像烧写到 U盘或 NVME SSD 中。

| 用户名 | 密码 |
| :----: | :---: |
| radxa | radxa |

### Fedora
### Debian12 Desktop b3(镜像名带有 usb-install,USB 启动盘用)

| orion-o6-usb-install-sdebian12-preinstalled-desktop-b3.img |
| :-----------------------------------------------------------------------------------------------------------------------: |
| [Radxa DL 链接](https://dl.radxa.com/orion/o6/images/debian/orion-o6-usb-install-debian12-preinstalled-desktop-b3.img.gz) |
| [百度网盘链接](https://pan.baidu.com/s/1usQ8CoBnPHF8sISZT0nfRA?pwd=s2tn) |
| [Mega 链接](https://mega.nz/file/1mIEBICb#d-gk8iBij8uUNv1-oQeqytxCDn7cO7mLubdmoAG6TvQ) |

说明:

- 该镜像名带 “usb-install” 字符串,镜像的目录 `/home/radxa` 有 b3 镜像文件。用于 USB 启动盘。
- 用户可通过主机上的 balenaEtcher 将该镜像烧写到 U盘中。
- O6 从 U盘启动后,用户可在 O6 系统中,将 `/home/radxa` 的 b3 镜像,烧写到 NVME SSD 中。见 [快速上手](./getting-started/quick-start.md)。

| 用户名 | 密码 |
| :----: | :---: |
| radxa | radxa |

## Fedora

[Fedora 41 Gnome](https://openkoji.iscas.ac.cn/pub/dist-repos/dl/Radxa/Orion-O6/images/fedora-disk-gnome-workstation_radxa_orion-o6_202501041239.raw.gz)

Expand Down
16 changes: 8 additions & 8 deletions docs/orion/o6/hardware-design/hardware-interface.md
Original file line number Diff line number Diff line change
Expand Up @@ -256,8 +256,8 @@ O6 主板上包含一个 40 针 GPIO 连接器,用于低速总线连接和通
</tr>
<tr>
<td>6</td>
<td>UART3_TXD</td>
<td>UART3 发送信号(3.3V)</td>
<td>GND</td>
<td>接地</td>
</tr>
<tr>
<td>7</td>
Expand All @@ -266,8 +266,8 @@ O6 主板上包含一个 40 针 GPIO 连接器,用于低速总线连接和通
</tr>
<tr>
<td>8</td>
<td>UART3_RXD</td>
<td>UART3 接收信号(3.3V)</td>
<td>UART3_TXD</td>
<td>UART3 发送信号(3.3V)</td>
</tr>
<tr>
<td>9</td>
Expand All @@ -276,8 +276,8 @@ O6 主板上包含一个 40 针 GPIO 连接器,用于低速总线连接和通
</tr>
<tr>
<td>10</td>
<td>I2S4_SCK</td>
<td>I2S4 串行时钟(3.3V)</td>
<td>UART3_RXD</td>
<td>UART3 接收信号(3.3V)</td>
</tr>
<tr>
<td>11</td>
Expand All @@ -286,8 +286,8 @@ O6 主板上包含一个 40 针 GPIO 连接器,用于低速总线连接和通
</tr>
<tr>
<td>12</td>
<td>GPIO</td>
<td>通用 I/O(3.3V)</td>
<td>I2S4_SCK</td>
<td>I2S4 串行时钟(3.3V)</td>
</tr>
<tr>
<td>13</td>
Expand Down
9 changes: 9 additions & 0 deletions docs/orion/o6/low-level-dev/README.md
Original file line number Diff line number Diff line change
@@ -0,0 +1,9 @@
---
sidebar_position: 40
---

# 底层开发

主要介绍调试串口,debian os 编译打包等内容。

<DocCardList />
10 changes: 10 additions & 0 deletions docs/orion/o6/low-level-dev/serial.md
Original file line number Diff line number Diff line change
@@ -0,0 +1,10 @@
---
sidebar_position: 14
description: "您可以通过串口登录系统"
---

import Serial from "../../../common/general/\_serial.mdx"

# UART 串口控制台

<Serial platform="cix" model="o6" />
2 changes: 1 addition & 1 deletion docs/rock5/rock5itx/radxa-os/serial.md
Original file line number Diff line number Diff line change
Expand Up @@ -7,4 +7,4 @@ import Serial from "../../../common/general/\_serial.mdx"

# UART 串口控制台

<Serial platform="rk" />
<Serial platform="rk" model="rock5itx" />
Original file line number Diff line number Diff line change
Expand Up @@ -12,6 +12,11 @@ Most of radxa's products define pins 8 (TX) and 10 (RX) on the GPIO pins as UART

:::tip

<Section compatible="cix" platform={props.platform}>
For Radxa products based on CIX chips, the default UART configuration is 115200n8 without flow control.

</Section>

<Section compatible="aml" platform={props.platform}>
For Radxa products based on Amlogic chips, the default UART configuration is 115200n8 without flow control.

Expand Down Expand Up @@ -39,7 +44,7 @@ The Flowing text uses a serial cable based on [CH340](http://wch-ic.com/products

As shown below, connect the USB to TTL serial cable:

<Section compatible="^rock5itx" model={props.model}>
<Section compatible="^rock5itx,^o6" model={props.model}>

| Radxa SBC | Connection | Serial Cable |
| --------------- | ----------- | ------------ |
Expand All @@ -59,6 +64,16 @@ As shown below, connect the USB to TTL serial cable:

</Section>

<Section compatible="o6" model={props.model}>

| Orion O6 | Connection | Serial Cable |
| -------- | ----------- | ------------ |
| **GND** | &lt;---&gt; | Black line |
| **TX** | &lt;---&gt; | White line |
| **RX** | &lt;---&gt; | Green line |

</Section>

<Image
src="/img/accessories/#model#-1000px-Serial-connection.webp"
model={props.model}
Expand Down
Original file line number Diff line number Diff line change
Expand Up @@ -2,6 +2,7 @@
sidebar_position: 4
description: ""
---
# Install BIOS

## Installing BIOS

Expand Down
Loading
Loading