From 1b701a235644fad6c85c097d6f43ec85cc065fde Mon Sep 17 00:00:00 2001
From: Tang Zaozao <tangzz@radxa.com>
Date: Tue, 26 May 2026 19:41:14 +0800
Subject: [PATCH] docs(cubie/a5e): add audio interface clarification note

Source: GitHub Discussion #1776 - user question about analog audio via 40-pin GPIO on Cubie A5E.

The shared audio template lists 'Bluetooth Audio > Headphones > HDMI Audio' as the default priority, but the Cubie A5E board has no physical 3.5mm headphone jack. This note clarifies:
- No onboard headphone jack exists
- 'Headphones' entry in alsamixer only appears when USB audio device is connected
- I2S2 via 40-pin GPIO is available for digital audio output (requires external DAC)

Both Chinese (docs/) and English (i18n/en/) versions updated.
---
 docs/cubie/a5e/system-config/audio-usage.md                 | 6 ++++++
 .../current/cubie/a5e/system-config/audio-usage.md          | 6 ++++++
 2 files changed, 12 insertions(+)

diff --git a/docs/cubie/a5e/system-config/audio-usage.md b/docs/cubie/a5e/system-config/audio-usage.md
index 2494318f0..ab1e36129 100644
--- a/docs/cubie/a5e/system-config/audio-usage.md
+++ b/docs/cubie/a5e/system-config/audio-usage.md
@@ -12,3 +12,9 @@ import AUDIO from '../../../common/radxa-os/system-config/\_audio_usage.mdx';
 # 音频管理
 
 <AUDIO debian_version="debian11" board="cubie-a5e" />
+
+:::note Cubie A5E 音频接口说明
+Cubie A5E 主板**未配备 3.5mm 耳机接口**。系统默认音频输出优先级为「蓝牙音频 > 耳机 > HDMI 音频」，其中「耳机」选项将在连接 USB 耳机或通过 40 Pin GPIO 接口连接外部 USB 声卡时生效。
+
+如需通过 40 Pin GPIO 接口使用数字音频，可使用 I2S2 接口（需外接 DAC 芯片转换为模拟音频）。
+:::
diff --git a/i18n/en/docusaurus-plugin-content-docs/current/cubie/a5e/system-config/audio-usage.md b/i18n/en/docusaurus-plugin-content-docs/current/cubie/a5e/system-config/audio-usage.md
index a5140a77e..173c16d84 100644
--- a/i18n/en/docusaurus-plugin-content-docs/current/cubie/a5e/system-config/audio-usage.md
+++ b/i18n/en/docusaurus-plugin-content-docs/current/cubie/a5e/system-config/audio-usage.md
@@ -12,3 +12,9 @@ import AUDIO from '../../../common/radxa-os/system-config/\_audio_usage.mdx';
 # Audio Management
 
 <AUDIO debian_version="debian11" board="cubie-a5e" />
+
+:::note Cubie A5E Audio Interface Note
+The Cubie A5E board **does not have a 3.5mm headphone jack**. The default audio output priority listed as "Bluetooth Audio > Headphones > HDMI Audio" means the "Headphones" entry will appear when a USB headphone or external USB audio card connected via the 40 Pin GPIO is detected.
+
+To use digital audio via the 40 Pin GPIO interface, you can use the I2S2 interface (requires an external DAC chip to convert to analog audio).
+:::