AMP-AUDIO v1.0.0：把音频播放交给一颗 Zephyr guest

拓扑：谁负责什么

                 ┌──────────────── ROCK 5B+ (RK3588) ────────────────┐
   mp3 / 混音     │                                                  │
   /dev/ndp_pcm   │  ┌─────────── A76 ×4 · Linux 6.1.75 ──────────┐  │
       │           │  │  ndp_cons.ko                               │  │
       └──────────►│  │    · /dev/ndp_pcm  (用户态注入 1920 B 帧)   │  │
                   │  │    · L2Z ring  → 写入共享内存               │  │
                   │  │    · 邮箱门铃 → 通知 guest                  │  │
                   │  └───────────────────┬────────────────────────┘  │
                   │                      │ 共享内存 0x7800000 (4 MiB)│
                   │                      │ 邮箱 fec60000             │
                   │  ┌───────────────────▼──── A55 core3 · Zephyr ──┐ │
                   │  │  rk_i2s_tdm.c   I2S TDM 驱动                 │ │
                   │  │  rk_pl330_dma.c PL330 DMA API 驱动           │ │
                   │  │  rk_es8316_i2c.c 编解码器配置                │ │
                   │  └───────────────────┬──────────────────────────┘ │
                   │                      │ I2S0 0xfe470000            │
                   │                      ▼                            │
                   │              ES8316 codec ──► 耳机/喇叭            │
                   └───────────────────────────────────────────────────┘

两者之间不是「Linux 写 FIFO」，而是共享内存 ring + 门铃：Linux 侧往 ring 里放 10 ms 一帧的 PCM， guest 按自己的节拍取走、交给 DMA。Linux 卡一下，guest 靠缓冲顶住。Linux 侧永不等 ack—— 积压超过上限就丢最旧的（DROP_OLD），生产端永不阻塞，丢失量单独计数。

三条命令上手

bash scripts/verify-release.sh          # 1. 校验和 + 环境自检（不需要 root）
sudo bash scripts/amp-audio-up.sh       # 2. 拉起链路（装模块、点火 guest）
sudo python3 scripts/amp-tone.py        # 3. 听琶音 —— 通了就是通了

amp-tone.py 自带音频发生器，不需要任何 mp3 素材：它直接合成 1920 B/10 ms 的 PCM 帧写进 /dev/ndp_pcm。这正是「伴音发生器」的最小可用形态：一条跨域音频通路，能被三行命令验证， 而不是一堆需要先凑齐素材才能试的代码。

能力与实测数字（全部来自本板运行）

为什么必须显式预充（最容易踩的一条）

guest 每 10 ms 取 1 帧，Linux 也是 100 帧/s，两者严格 1:1 ⇒ ring 占用恒定在起播时的初值。 初值为 0，ring 就永远是空的，此时的「缓冲」只是纸面参数。所以起播必须先用 --prime 把 ring 垫到目标水位，之后 1:1 的节拍会把它稳定维持在那个深度。

可观测性也是刻意做的：play: underrun / silence 会真实增长，不是假绿灯； 缓冲积压掉到 8 帧以下自动回到填充态（jb_resyncs 计数）；jb-receipt.py 用「停送数 + 采样 guest 计数器」给出可复算的收据。

用例：写一段简谱，喂给 DSH，板子出伴音

这是工作组自己的用法：先写歌的简谱——纯文本，几行数字（1=D 76BPM、5 5 4 3 2 3 | 1—）， 再把它连同「要什么风格、要不要厅堂、人声靠前还是靠后」一起喂给 DSH。DSH 在这块 ROCK 5B+ 上把谱子 编配成声部、合成成分轨 PCM、排成一条混音时间线，最后按 100 帧/s 灌进 AMP 从核， 由 Zephyr guest 驱动 I2S 出声。听到的是一段有伴奏的歌，不是提示音；伴奏、厅堂、人声、延时都是参数，不是重新录一遍。

这条链路上的四个可调面

# 谱子与编配（示例：四声部民谣，简谱在 scores/ 下）
python3 make_chengdu.py            # 合成声部 → tracks_chengdu/
python3 make_chengdu_json.py       # 生成 chengdu.json（hall / parts / clips）
# 只试听混音，不出声（存 WAV 便于核对）
python3 amp-mix-play.py --edit chengdu.json --dry-run --wav /tmp/chengdu.wav
# 真放：前置检查 + 点火 guest + 按 100 帧/s 灌流（约 4 分钟）
bash chengdu-play.sh

边界与已知限制（诚实清单）

获取发布包与许可

相关链接