1. 项目概述：当复古情怀遇见现代流媒体

我一直对老式电子管收音机那种温润的灯光、带有刻度的玻璃面板和旋钮转动时“咔哒”的质感着迷。但传统收音机受限于信号，能收听的频道实在有限。于是，一个想法冒了出来：能不能把这种复古的物理交互体验，和如今海量的互联网电台资源结合起来？这就是我动手打造这台“复古电子管风格网络收音机”的初衷。

这个项目的核心，是用树莓派作为大脑，驱动一块7英寸的工业级HMI触摸屏，并在屏幕上模拟出老式收音机的经典刻度盘界面。最关键的人机交互，我选择了一个旋转编码器——它就像老收音机的调谐旋钮，通过旋转来切换电台，那种“拧动”寻找电台的仪式感一下子就回来了。整个系统运行一个用Python编写的图形界面程序，它负责从网络获取音频流、解码播放，并同步驱动屏幕上的指针在虚拟刻度盘上移动。最终成品不仅外观怀旧，操作直觉，更重要的是，它能让你瞬间接入全球数以万计的广播电台，从古典音乐到实时新闻，应有尽有。

无论你是嵌入式开发爱好者，想深入学习树莓派GPIO控制、Python GUI编程和音频流处理；还是复古设备改造玩家，希望给老物件注入新灵魂；亦或是单纯想拥有一个独一无二的桌面摆件，这个项目都能提供从硬件选型、软件配置到外壳制作的完整参考。接下来，我会拆解每一个步骤，分享其中踩过的坑和总结出的技巧。

2. 核心硬件选型与设计思路解析

硬件是项目的骨架，选型直接决定了成品的稳定性、美观度和开发难度。我的核心思路是： 在保证工业级可靠性的前提下，最大化复古元素的呈现，并简化不必要的连线。

2.1 控制核心：为什么是树莓派 Compute Module 4 与集成化HMI面板？

传统树莓派开发，我们需要单独购买主板、屏幕、触摸驱动板，再进行繁琐的接线和组装，不仅体积臃肿，稳定性也面临挑战。这次我选择了 Elecrow的Crowpanel 7英寸Pi Terminal 。它本质上是一个 All-in-One 的工业HMI（人机界面）解决方案，核心是一块树莓派Compute Module 4（CM4），直接集成在屏幕背面。

这么选的理由很充分：

1. 极致的集成度与可靠性 ：CM4通过板对板连接器直接与屏幕驱动板相连，省去了所有排线。工业级的设计意味着更强的抗干扰能力和更长的连续运行时间，这对于需要7x24小时开机的网络收音机至关重要。我自己用普通树莓派4B做过原型，连续播放几天后偶尔会出现USB声卡识别不稳或系统卡顿，而CM4集成方案至今运行数月毫无问题。
2. 音频输出的便利性 ：这个面板自带3.5mm耳机孔和功放芯片，可以直接驱动无源音箱。很多树莓派项目需要额外配置USB声卡或HAT音频板，这里一步到位。一个重要的避坑点：务必使用厂商提供的定制系统镜像。我最初尝试安装最新的Raspberry Pi OS，发现音频输出无法工作，原因是官方系统对这块定制板的音频芯片支持不完善。厂商镜像已经做好了所有底层驱动适配。
3. 节省空间与简化供电 ：整个设备只需一根12V DC电源线供电，同时给CM4和屏幕供电，桌面非常整洁。

注意 ：工业HMI面板的价格通常高于自行组装，但它带来的稳定性、美观性和节省的开发调试时间，对于想做一个“成品”而非“实验品”的项目来说，是完全值得的投资。

2.2 交互灵魂：旋转编码器的“废物利用”与信号处理

复古收音机的灵魂在于那个调谐旋钮。我选择了旋转编码器，它每旋转一个刻度会产生一组脉冲信号，通过判断相位差就能知道是左转还是右转。市面上有直接输出A、B两相脉冲的编码器模块，需要连接树莓派的GPIO引脚并编写中断服务程序去解码。

但我想到了一个更巧妙的“偷懒”方法： 拆解一个旧的滚轮USB鼠标 。鼠标的滚轮本质上就是一个旋转编码器，并且鼠标内部芯片已经完成了编码器信号的解码工作，通过USB接口输出的是标准的“滚轮滚动”事件。这意味着，我只需要把这个旧鼠标的编码器部分拆出来，将其USB线连接到树莓派上，就可以在系统中直接监听“滚轮事件”，完全无需处理底层的GPIO脉冲和防抖算法。

具体操作心得：

1. 拆开鼠标，找到滚轮组件。通常编码器是焊在一个小板子上的，小心地将它连同微动开关（左键、右键、中键）一起从主板上切割或焊接下来。
2. 保留一段USB线，将其与编码器小板连接。你需要根据鼠标主板线路，将USB数据线（D+, D-）、电源线（VCC, GND）正确连接到编码器小板的对应焊点。用万用表蜂鸣档测通断是最可靠的方法。
3. 连接好后，插入树莓派USB口，在终端输入 lsusb 和 evtest 命令，测试转动编码器时是否有对应的事件输出。这个方法将硬件问题转化为了纯粹的软件问题，大大降低了门槛。

2.3 外壳与辅助材料：营造沉浸式复古感

硬件功能实现后，外壳是赋予项目“灵魂”的关键。我直接复用了一个之前为其他项目制作的木制外壳，内部空间刚好容纳这块7英寸面板。如果你从零制作，建议：

• 材质 ：实木或高密度中纤板（MDF）能提供温润的质感，适合喷涂哑光漆或木蜡油。
• 开孔 ：面板开孔务必精确。最好先用纸板制作1:1模型，确认所有接口（电源口、耳机孔）位置无误后再对正式材料加工。
• 前面板设计 ：这是复古感的重点。我采用的方法是： 让屏幕显示的内容与物理外壳融为一体 。在屏幕边框周围，可以贴上一圈仿木纹或黑色磨砂的贴纸，并开一个圆孔将旋转编码器物理旋钮安装上去，确保旋钮在屏幕显示的“刻度盘”视觉中心位置。这样在昏暗光线下，屏幕发光的部分就像老收音机内部的电子管和刻度盘，而物理边框和旋钮则构成了收音机的外壳，虚实结合，效果极佳。

3. 软件系统搭建与核心功能实现

软件部分是这个项目的大脑，负责协调音频播放、用户输入和图形显示。我的技术栈是： Raspberry Pi OS（定制版） + Python + Pygame + VLC 。下面分步解析。

3.1 操作系统与基础环境配置

首先，从Elecrow官网下载为Crowpanel定制的Raspberry Pi OS镜像并刷入SD卡。首次启动后，进行基础配置：

# 更新系统
sudo apt update && sudo apt upgrade -y

# 安装核心软件包：Python3开发环境、Pygame（用于GUI）、python-vlc（用于音频流播放）
sudo apt install python3-pip python3-pygame python3-vlc -y

# 安装用于监听输入设备的库 evdev
sudo apt install python3-evdev -y

关键一步：设置音频输出。 在终端输入 sudo raspi-config ，进入 System Options -> Audio ，选择 3.5mm jack 作为输出设备。如果使用厂商镜像，这一步通常已预设好。

3.2 音频流播放引擎：为什么选择VLC？

Python播放网络音频流有多种选择，如 mpg123 , ffplay 或 pyaudio 配合 ffmpeg 。我选择 python-vlc 绑定库，原因如下：

1. 格式兼容性无敌 ：VLC内核几乎支持所有流媒体协议（HTTP, HLS, RTMP）和音频格式（MP3, AAC, OGG等），无需关心电台流的具体编码，稳定性极高。
2. 缓冲与网络适应 ：VLC内置完善的流缓冲机制，在网络波动时能有效避免卡顿，这是许多轻量级播放器不具备的。
3. 控制接口丰富 ：通过 python-vlc ，我们可以轻松实现播放、暂停、停止、音量调节、获取元数据（如电台名）等操作，非常适合集成到我们的控制程序中。

一个基础的播放器类可能如下所示：

import vlc
import time

class InternetRadioPlayer:
    def __init__(self):
        self.instance = vlc.Instance('--no-video') # 不初始化视频，节省资源
        self.player = self.instance.media_player_new()
        self.current_station_index = 0
        self.stations = [] # 电台URL列表将从文件加载

    def load_station(self, station_url):
        media = self.instance.media_new(station_url)
        self.player.set_media(media)
        self.player.play()
        # 等待一下，让流缓冲
        time.sleep(0.5)

    def stop(self):
        self.player.stop()

    def set_volume(self, percent):
        # VLC音量范围是0-100
        self.player.audio_set_volume(percent)

实操心得 ：直接调用 player.play() 后立即操作（如调节音量）可能会失败，因为媒体可能还未完全加载。添加一个短暂的 time.sleep(0.5) 或使用事件回调机制是更稳健的做法。

3.3 旋转编码器与触摸屏输入捕获

输入系统需要同时处理两种交互：物理旋转编码器（通过USB鼠标改装）和屏幕触摸。

对于旋转编码器（USB鼠标滚轮）： 我们使用 evdev 库来监听原始输入事件。它可以直接读取 /dev/input/ 下的事件，无需依赖X Window图形环境，这在全屏运行的Kiosk模式应用中非常有用。

from evdev import InputDevice, categorize, ecodes

def listen_to_encoder():
    # 通常，USB鼠标设备事件路径类似 /dev/input/event2
    # 可以通过 `python3 -m evdev.evtest` 命令交互式查看设备事件路径
    dev = InputDevice('/dev/input/event2')
    for event in dev.read_loop():
        if event.type == ecodes.EV_REL: # 相对坐标事件
            if event.code == ecodes.REL_WHEEL: # 滚轮事件
                if event.value > 0:
                    print("Encoder rotated CW (Next Station)")
                    # 调用切换电台函数，索引+1
                elif event.value < 0:
                    print("Encoder rotated CCW (Previous Station)")
                    # 调用切换电台函数，索引-1

对于触摸屏输入： 由于我们使用Pygame创建全屏GUI，可以直接利用Pygame的事件循环来捕获触摸（或鼠标点击）事件。

import pygame

pygame.init()
screen = pygame.display.set_mode((800, 480), pygame.FULLSCREEN)

running = True
while running:
    for event in pygame.event.get():
        if event.type == pygame.QUIT:
            running = False
        elif event.type == pygame.MOUSEBUTTONDOWN:
            x, y = event.pos
            # 根据(x, y)坐标判断点击了哪个功能区域
            # 例如：if 10 < x < 50 and 400 < y < 470: 点击了音量调节区域
            # 调用相应的功能函数

两者协同工作 ：主程序会运行在一个无限循环中，同时检查 evdev 的事件（非阻塞方式）和Pygame的事件。编码器事件触发电台切换，触摸事件触发音量调节、开关机等。

3.4 复古GUI界面绘制与动态效果

界面是复古感的视觉核心。我使用Pygame进行绘制，主要元素包括：

1. 静态背景图 ：一张高分辨率的复古收音机刻度盘图片。这张图需要精心挑选或设计，确保指针旋转轴心、刻度位置与程序逻辑对齐。我将它作为背景全屏显示。
2. 动态指针 ：用一个红色的箭头图片或直接绘制一个三角形来模拟指针。其关键逻辑是 根据当前电台索引，计算指针应指向的旋转角度 。

   # 假设有N个电台，将360度（或刻度盘有效角度范围）平均分成N份
   total_stations = len(station_list)
   angle_per_station = 300 / total_stations  # 假设刻度盘跨度是300度
   current_angle = start_angle + current_station_index * angle_per_station # start_angle是起始角度
   
   # 旋转指针图片并绘制
   rotated_pointer = pygame.transform.rotate(original_pointer_image, -current_angle) # 注意角度方向
   # 计算旋转后图像的定位矩形，使其绕底部中心点旋转
   rect = rotated_pointer.get_rect(center=pointer_pivot_position)
   screen.blit(rotated_pointer, rect.topleft)
   

3. 电台名与音量信息显示 ：在屏幕角落用抗锯齿字体渲染当前播放的电台名称和音量百分比。
4. 隐形触摸按钮 ：在屏幕特定区域（如右下角上下分块作为“上一台/下一台”，底部滑条作为音量调节）不绘制按钮图形，但通过检测点击坐标来触发功能。这保持了界面视觉的纯粹复古感。

性能优化点 ：不要每一帧都重绘整个屏幕。只更新发生变化的部分（如指针位置、文字），这被称为“脏矩形”更新。但在我们这个相对简单的界面上，全屏重绘（ screen.fill() 后重新绘制所有元素）在树莓派上也能达到流畅的60fps。

4. 项目集成与系统优化

将各个模块整合成一个稳定、可自启动的系统应用，是项目从原型走向成品的关键。

4.1 代码结构组织与电台列表管理

一个清晰的项目目录结构如下：

/home/pi/retro_radio/
├── main.py              # 主程序入口
├── radio_player.py      # 播放器类封装
├── ui_engine.py         # 界面绘制与事件处理类
├── encoder_listener.py  # 编码器输入监听线程
├── stations.txt         # 电台列表文件
├── assets/
│   ├── dial_background.jpg
│   ├── pointer.png
│   └── font.ttf
└── requirements.txt

电台列表管理 ： stations.txt 文件每行定义一个电台，格式可以是 电台名称,http://stream.url 。主程序启动时读取这个文件，加载到列表中。这样，用户要增删电台，只需编辑这个文本文件，无需修改代码。

4.2 自启动与Kiosk模式设置

我们不希望用户看到标准的Linux桌面。目标是通电后直接进入全屏收音机界面。

1. 禁用桌面管理器（可选） ：对于专注于此功能的设备，可以完全禁用图形桌面，但会失去灵活性。更推荐以下方法。
2. 自动登录并启动程序 ：
   • 在终端输入 sudo raspi-config -> System Options -> Boot / Auto Login -> 选择 Desktop Autologin 。
   • 编辑用户自动启动文件： nano ~/.config/lxsession/LXDE-pi/autostart
   • 在文件末尾添加（假设你的程序叫 retro_ui.py ）：

     @lxterminal -e python3 /home/pi/retro_radio/retro_ui.py
     

   • 这样启动后会先打开一个终端窗口运行程序，程序界面会覆盖桌面。
3. 真正的Kiosk模式（推荐） ：使用轻量级窗口管理器（如 matchbox-window-manager ）并直接启动程序。

   sudo apt install matchbox-window-manager x11-xserver-utils unclutter
   

   创建一个启动脚本 start_radio.sh ：

   #!/bin/bash
   # 关闭屏保和电源管理
   xset s off
   xset -dpms
   xset s noblank
   # 隐藏鼠标光标（当无触摸时）
   unclutter -idle 0.5 -root &
   # 启动窗口管理器并全屏运行程序
   matchbox-window-manager -use_titlebar no &
   python3 /home/pi/retro_radio/main.py
   

   然后修改 ~/.config/lxsession/LXDE-pi/autostart ，将之前的命令替换为执行这个脚本： @/home/pi/start_radio.sh 。这样系统启动后就是一个纯净的全屏应用，无法意外退出到桌面。

4.3 电源管理与网络稳定性

作为常开设备，稳定性是第一位的。

• 电源 ：务必使用官方或足额（5V/3A以上）的电源适配器。电压不稳会导致树莓派重启或USB设备断开。
• 散热 ：CM4集成在屏幕背后，虽然工业设计考虑了散热，但长期运行仍建议在被动散热片基础上，确保外壳有通风孔。我实测连续播放48小时，芯片温度在55-65°C之间，属于安全范围。
• 网络 ：
  • 有线优先 ：如果位置固定，强烈建议使用网线连接。它比Wi-Fi更稳定，延迟和丢包率极低，对音频流播放体验提升巨大。
  • Wi-Fi优化 ：若必须使用Wi-Fi，在树莓派配置中 ( sudo raspi-config ) 选择你的国家代码，以确保使用正确的信道。可以尝试将路由器信道固定在较少干扰的1、6或11信道。并让设备尽量靠近路由器。
  • 断线重连 ：在代码中增加网络状态监测。如果播放器报错或长时间缓冲，可以尝试自动重连当前电台，或者提供一个“重试”的触摸按钮。

5. 常见问题排查与进阶玩法

即使按照步骤操作，你也可能会遇到一些问题。这里记录了我遇到的一些典型情况及其解决方法。

5.1 硬件与基础环境问题

问题1：没有声音，或音频输出设备不对。

• 排查 ：运行 aplay -l 查看音频设备列表。确认系统默认输出是否正确。
• 解决 ：
  1. 运行 sudo raspi-config 确认音频输出设置为“3.5mm jack”。
  2. 对于使用 python-vlc 的情况，可以在初始化时指定音频输出设备： instance = vlc.Instance('--aout=alsa') 。有时需要强制指定设备： instance = vlc.Instance('--alsa-audio-device=hw:0,0') ，设备号通过 aplay -l 查询。
  3. 检查音量是否被静音：在终端运行 alsamixer ，确保Master和PCM通道未被静音（MM表示静音，按 M 键解除）。

问题2：旋转编码器（USB鼠标）无反应。

• 排查 ：运行 ls /dev/input/ 查看输入设备。然后使用 sudo evtest 命令，选择对应的 eventX 设备，转动编码器看是否有事件输出。
• 解决 ：
  1. 确保USB连接可靠。尝试不同的USB口。
  2. 检查代码中的设备路径 /dev/input/eventX 是否正确。设备编号可能在重启后变化，更稳健的方法是 通过设备名称来定位 ：

     import evdev
     devices = [evdev.InputDevice(path) for path in evdev.list_devices()]
     for device in devices:
         if "Mouse" in device.name: # 根据你的设备名称关键词匹配
             encoder_device_path = device.path
             break
     

问题3：触摸屏点击位置不准。

• 排查 ：这是触摸屏校准问题。
• 解决 ：安装校准工具 sudo apt install xinput-calibrator 。运行 xinput_calibrator ，按照屏幕提示依次点击四个十字光标。完成后会生成校准参数，按照提示将其添加到 /etc/X11/xorg.conf.d/99-calibration.conf 配置文件中（如果没有该目录或文件，则创建）。

5.2 软件与功能问题

问题4：切换电台时，前一个电台的声音会“重叠”播放一小段。

• 原因 ：在调用 player.stop() 后立即 player.play() 新流，VLC内部资源释放需要时间。
• 解决 ：在停止和播放之间增加一个短暂延迟，或者更优雅地，等待 player 的状态变为 vlc.State.Stopped 后再播放新的。

  self.player.stop()
  while self.player.get_state() != vlc.State.Stopped:
      time.sleep(0.01)
  self.load_station(new_url)
  

问题5：程序在全屏下无法通过键盘快捷键（如Ctrl+C）退出，变得无法控制。

• 解决 ：这是Kiosk模式的常见问题。我们必须在程序中预留一个“软件出口”。
  1. 隐藏的退出热键 ：在Pygame事件循环中，除了监听触摸，也监听键盘事件。例如，长按屏幕某个角落（比如左上角5秒），或者同时按下键盘的 ESC 键（如果接了键盘）来退出程序。
  2. 物理按钮 ：在外壳上安装一个轻触开关，连接到树莓派的GPIO，并在程序中用 RPi.GPIO 库监听。按下时调用 sys.exit() 。
  3. 远程退出 ：在程序中开启一个简单的HTTP服务器线程（如使用Flask），监听本地端口。通过同一局域网内的另一台设备访问一个特定URL（如 http://树莓派IP:8080/exit ）来触发程序退出。这适合调试和紧急情况。

问题6：电台列表很多时，指针移动的“刻度感”不强，容易调过头。

• 解决 ：这是交互设计问题。可以引入两种模式：
  1. 快速滚动 ：正常旋转编码器，指针快速移动，适合在大范围电台间跳跃。
  2. 微调模式 ：按下编码器（如果支持按键功能）或触摸屏上的一个“微调”按钮后，旋转编码器一格只移动一个电台，实现精准定位。这完全可以通过软件逻辑实现。

5.3 项目扩展与进阶想法

这个项目的基础框架搭建好后，有很多可以扩展的方向：

• 多“波段”切换 ：仿照老式收音机的短波、中波、FM波段。可以在界面上增加一个虚拟的“波段开关”，点击后加载不同的 stations.txt 文件（如 stations_fm.txt , stations_news.txt ），实现电台分类管理。
• 收藏夹与预设 ：长按某个电台位置，将当前电台保存为“预设”，类似于老收音机的数字存台。数据可以保存在一个JSON文件中。
• 可视化音频频谱 ：利用 libvisual 或 pygame 的绘图功能，在屏幕下方绘制一个简单的音频频谱柱状图，增加科技感。
• 网络电台发现 ：集成像 radio-browser.info 这样的开源网络电台目录API，让用户可以直接在设备上搜索和添加新电台，而无需手动编辑文本文件。
• 与智能家居联动 ：通过MQTT协议，让收音机成为智能家居的一部分。例如，早上7点自动播放新闻电台，或者当门传感器被触发时播放特定音乐。

这个项目最让我享受的，就是看着一个充满现代技术的设备，通过设计和代码，呈现出经典产品的交互质感和温度。它不仅仅是一个播放器，更是连接过去与现在的一个触点。动手去做的过程中，你会对硬件交互、事件驱动编程、资源管理和用户体验设计有更深的体会。希望这份详细的指南能帮你少走弯路，顺利打造出属于你自己的那台独一无二的复古网络收音机。如果在制作中遇到任何新问题，不妨回到硬件和软件的基础逻辑去排查，大部分难题都能迎刃而解。