树莓派 5 欠压降频 (0x50000)、Hailo-8L NPU 未识别与 ALSA 麦克风掉线排障

普通手机或笔记本快充头通常不包含 5.1V / 5A 专有档位，树莓派 5 握手后会退化为 5V / 3A 模式并将 USB 接口限流在 600mA。四核满载跑模型时电压跌破 4.63V，直接导致 USB 外设断电重连。

1. 更换为具备 5.1V / 5A 输出档位的树莓派 5 官方 27W USB-C PD 电源（自动解锁 1.6A USB 外设供电上限）。
2. 加装官方 PWM 主动涡轮散热器（Active Cooler），将持续推理温度压制在 62°C 左右，避免 80°C 过热降频。

# Verify PMIC negotiated 5A max current (expect 5000000 uA = 5A):
od -An -tx1 /proc/device-tree/chosen/power/max_current

# Verify zero throttling flags during active Ollama inference:
vcgencmd get_throttled

[边界说明]切勿在使用劣质 5V/3A 充电头时强行在 config.txt 写入 usb_max_current_enable=1，否则满载时极易引发突然断电重启并损坏 TF 卡文件系统。

树莓派 5 外置 PCIe 控制器未在 /boot/firmware/config.txt 中显式激活、EEPROM 引导固件过旧，或 16-pin FPC 软排线金手指方向插反/卡扣未压紧。

1. 在 `/boot/firmware/config.txt` 末尾添加 `dtparam=pciex1` 与 `dtparam=pciex1_gen=3`。
2. 执行 `sudo rpi-eeprom-update -a` 升级引导固件并安装 `hailo-all`，彻底断电后检查 FPC 软排线锁扣，重新通电。

# 1. Enable PCIe x1 at Gen 3 speed
sudo sh -c 'printf "\ndtparam=pciex1\ndtparam=pciex1_gen=3\n" >> /boot/firmware/config.txt'

# 2. Update EEPROM firmware & install Hailo driver stack
sudo rpi-eeprom-update -a
sudo apt update && sudo apt install -y hailo-all
sudo reboot

[边界说明]硬件分工边界提醒：Hailo-8L NPU 专用于加速 .hef 视觉模型（如 YOLOv8），而 Ollama 的 GGUF 语言模型运行在 CPU 上，两者通过异构分工实现零争抢协同。

当前非 root 用户未加入 `audio` 权限组，或者直接使用 `hw:1,0` 裸设备时因 USB 麦克风原生仅支持 48kHz 双声道而拒绝了 Whisper 所需的 16kHz 单声道请求。

1. 执行 `sudo usermod -aG audio,video $USER` 赋予当前用户音视频外设访问权限并重新登录。
2. 在 `arecord` 中使用 `plughw:1,0` 替代 `hw:1,0`，利用 ALSA 插件层自动将硬件 48kHz 采样率重采样为 Whisper 所需的 16kHz 单声道。

# 1. Grant device permissions
sudo usermod -aG audio,video $USER

# 2. Check USB microphone card & device index
arecord -l

# 3. Record 3s 16kHz mono WAV using plughw auto-resampler
arecord -D plughw:1,0 -f S16_LE -r 16000 -c 1 -d 3 /tmp/test.wav && aplay /tmp/test.wav

[边界说明]在语音助手循环脚本中，务必在 `aplay` 播报期间暂停麦克风采集（半双工锁），防止扬声器声音被麦克风录回引发自问自答死循环。