ESP32 网络收音机 yoRadio 完整指南从接线到出声一次跑通【免费下载链接】yoradioWeb-radio based on ESP32-audioI2S library项目地址: https://gitcode.com/GitHub_Trending/yo/yoradioyoRadio 是一个基于 ESP32-audioI2S 音频库的开源网络收音机固件把一块裸的 ESP32 开发板变成能播放网络电台的收音机带 Web 配置界面、屏幕显示和多种控制方式适合想自制网络收音机或入门嵌入式音频开发的人。项目速览yoRadio 能做什么yoRadio 的定位是一台轻量级网络收音机核心负责流媒体解码播放显示、控制、联网能力则按你的硬件自由搭配官方还另有 yopcb 仓库提供配套的 PCB 设计文件。主要功能播放最多 65535 个电台支持 20 多种 OLED/TFT/LCD 屏幕按钮、编码器、红外、触屏控制Web 界面管理 WiFi 与歌单内置 Web 服务器支持 OTA 升级设备屏幕上的播放器界面电台、歌曲名、均衡器滑条和歌单列表。准备工作硬件清单与软件版本硬件必选1 块 ESP32 开发板Dev Module 或 Wrover 系列均可I2S DAC 模块MAX98357A 一类或 VS1053b 模块二选一可选SSD1306、ST7735、ST7789、ILI9341 等屏幕三个轻触按键旋转编码器红外接收头DS3231 时钟模块软件Arduino IDE 1.8.19不支持 2.x 版本ESP32 板卡核心 ≥ 2.0.0ESP32 Filesystem Uploader 工具或使用 IDE 内置的 ESP32 Sketch Data UploadAdafruit_GFX 等屏幕相关库通过 Library Manager 安装取决于所选屏幕首次跑通五步从克隆到出声克隆仓库git clone https://gitcode.com/GitHub_Trending/yo/yoradio按你的接线生成硬件配置文件放在项目根目录与 yoRadio.ino 同级。模板见 examples/myoptions.h需要确认的关键项DSP_MODEL屏幕型号无屏填DSP_DUMMY、I2S_DOUT/VS1053_CS未用的模块一律填 255、各引脚定义。用 yoRadio/fonts/glcdfont.c 替换Arduino/libraries/Adafruit_GFX_Library/下的同名文件重启 Arduino IDE。在 IDE 中先执行 Tools → ESP32 Sketch Data Upload 上传网页与配置数据分区方案选 Minimal SPIFFS (1.9MB APP with OTA/190KB SPIFFS)再上传 yoRadio.ino 程序。连上设备热点 yoRadioAP密码 12345987打开http://192.168.4.1/配置家里的 WiFi。连上后访问设备 IP把电台加入歌单出声。三种 ESP32 板型的 IDE 关键设置上传速度 921600、Flash Mode QIO、分区方案 Minimal SPIFFS。实用技巧三个常用配置点跳过热点配置上传数据前把家里 WiFi 写入 yoRadio/data/data/wifi.csvSSID 和密码以制表符分隔一行一个热点设备开机后直连省去热点配置步骤。屏幕配色与旋转TFT 彩色屏的背景、歌名、时钟各区块颜色定义在 examples/mytheme.h取消注释对应行即可改色屏幕旋转角度由 myoptions.h 中的TFT_ROTATE控制0/90/180/270 度。绿色板 VS1053 无声部分绿色电路的 VS1053 模块装好后没声音在 myoptions.h 中加#define VS_PATCH_ENABLE false关闭补丁通常即可出声。3.5 英寸彩色屏上同时显示电台、歌曲、天气、时钟与 VU 表。常见坑位与解决问程序编译报错或行为异常像是版本问题。答yoRadio 不支持 Arduino IDE 2.x换回 1.8.19并确认 ESP32 核心不低于 2.0.0。问TFT 彩色屏配 wroom 板内存不够或播放卡顿。答VSPI 任务栈占用过大按 README 说明把 AsyncTCP.cpp 中任务栈8192 * 2改为8192 / 2。问屏幕上的天气、WiFi 信号等图标不显示。答屏幕字体文件没换成项目版本重新把 yoRadio/fonts/glcdfont.c 拷入 Adafruit_GFX 库目录并重启 IDE。问升级后电台列表和 WiFi 配置丢了。答升级前从设备网页下载data/playlist.csv与data/wifi.csv存回 yoRadio/data/data/ 目录再重新上传数据。扩展与生态从插件到智能家居MQTT把 examples/mqttoptions.h 复制到 yoRadio/ 目录并填写 broker 地址与主题前缀即可暴露 command/status/playlist/volume 四个主题支持 next、prev、play x、vol x 等指令。Home Assistant将 HA/custom_components/yoradio 拷到.homeassistant/custom_components/按 HA/example_configuration.yaml 添加实体Lovelace 里即可当作 Media Player 使用依赖 MQTT 集成。插件系统继承 Plugin 基类、重写 on_start_play、on_btn_click 等钩子新插件放在 src/plugins/ 对应目录examples/plugins/ 有背光控制、深度睡眠等现成示例接口定义见 yoRadio/src/pluginsManager/pluginsManager.h。其他mDNS 发现、屏保、通过 /update 页面上传固件与 SPIFFS 镜像做 OTA 均已内置屏幕文字支持 EN/RU 两种语言L10N_LANGUAGE参数源文件在 yoRadio/locale/Nextion 触摸屏有独立的 nextion/ 工程。按键行为映射、红外遥控器配码流程等细节见 Controls.md。yoRadio 把解码、播放、显示、控制和智能家居集成做成了完整的闭环硬件最小组合只需一块 ESP32、一个音频模块和几个按键。更多细节可看仓库 README 与 Wiki遇到问题先查版本日志或直接向官方仓库提 Issue。【免费下载链接】yoradioWeb-radio based on ESP32-audioI2S library项目地址: https://gitcode.com/GitHub_Trending/yo/yoradio创作声明：本文部分内容由AI辅助生成（AIGC），仅供参考 
长河君 · 2026/10/29 1:57:35 · 阅读 1.2k ESP32 网络收音机 yoRadio 完整指南：从接线到出声一次跑通
ESP32 网络收音机 yoRadio 完整指南从接线到出声一次跑通【免费下载链接】yoradioWeb-radio based on ESP32-audioI2S library项目地址: https://gitcode.com/GitHub_Trending/yo/yoradioyoRadio 是一个基于 ESP32-audioI2S 音频库的开源网络收音机固件把一块裸的 ESP32 开发板变成能播放网络电台的收音机带 Web 配置界面、屏幕显示和多种控制方式适合想自制网络收音机或入门嵌入式音频开发的人。项目速览yoRadio 能做什么yoRadio 的定位是一台轻量级网络收音机核心负责流媒体解码播放显示、控制、联网能力则按你的硬件自由搭配官方还另有 yopcb 仓库提供配套的 PCB 设计文件。主要功能播放最多 65535 个电台支持 20 多种 OLED/TFT/LCD 屏幕按钮、编码器、红外、触屏控制Web 界面管理 WiFi 与歌单内置 Web 服务器支持 OTA 升级设备屏幕上的播放器界面电台、歌曲名、均衡器滑条和歌单列表。准备工作硬件清单与软件版本硬件必选1 块 ESP32 开发板Dev Module 或 Wrover 系列均可I2S DAC 模块MAX98357A 一类或 VS1053b 模块二选一可选SSD1306、ST7735、ST7789、ILI9341 等屏幕三个轻触按键旋转编码器红外接收头DS3231 时钟模块软件Arduino IDE 1.8.19不支持 2.x 版本ESP32 板卡核心 ≥ 2.0.0ESP32 Filesystem Uploader 工具或使用 IDE 内置的 ESP32 Sketch Data UploadAdafruit_GFX 等屏幕相关库通过 Library Manager 安装取决于所选屏幕首次跑通五步从克隆到出声克隆仓库git clone https://gitcode.com/GitHub_Trending/yo/yoradio按你的接线生成硬件配置文件放在项目根目录与 yoRadio.ino 同级。模板见 examples/myoptions.h需要确认的关键项DSP_MODEL屏幕型号无屏填DSP_DUMMY、I2S_DOUT/VS1053_CS未用的模块一律填 255、各引脚定义。用 yoRadio/fonts/glcdfont.c 替换Arduino/libraries/Adafruit_GFX_Library/下的同名文件重启 Arduino IDE。在 IDE 中先执行 Tools → ESP32 Sketch Data Upload 上传网页与配置数据分区方案选 Minimal SPIFFS (1.9MB APP with OTA/190KB SPIFFS)再上传 yoRadio.ino 程序。连上设备热点 yoRadioAP密码 12345987打开http://192.168.4.1/配置家里的 WiFi。连上后访问设备 IP把电台加入歌单出声。三种 ESP32 板型的 IDE 关键设置上传速度 921600、Flash Mode QIO、分区方案 Minimal SPIFFS。实用技巧三个常用配置点跳过热点配置上传数据前把家里 WiFi 写入 yoRadio/data/data/wifi.csvSSID 和密码以制表符分隔一行一个热点设备开机后直连省去热点配置步骤。屏幕配色与旋转TFT 彩色屏的背景、歌名、时钟各区块颜色定义在 examples/mytheme.h取消注释对应行即可改色屏幕旋转角度由 myoptions.h 中的TFT_ROTATE控制0/90/180/270 度。绿色板 VS1053 无声部分绿色电路的 VS1053 模块装好后没声音在 myoptions.h 中加#define VS_PATCH_ENABLE false关闭补丁通常即可出声。3.5 英寸彩色屏上同时显示电台、歌曲、天气、时钟与 VU 表。常见坑位与解决问程序编译报错或行为异常像是版本问题。答yoRadio 不支持 Arduino IDE 2.x换回 1.8.19并确认 ESP32 核心不低于 2.0.0。问TFT 彩色屏配 wroom 板内存不够或播放卡顿。答VSPI 任务栈占用过大按 README 说明把 AsyncTCP.cpp 中任务栈8192 * 2改为8192 / 2。问屏幕上的天气、WiFi 信号等图标不显示。答屏幕字体文件没换成项目版本重新把 yoRadio/fonts/glcdfont.c 拷入 Adafruit_GFX 库目录并重启 IDE。问升级后电台列表和 WiFi 配置丢了。答升级前从设备网页下载data/playlist.csv与data/wifi.csv存回 yoRadio/data/data/ 目录再重新上传数据。扩展与生态从插件到智能家居MQTT把 examples/mqttoptions.h 复制到 yoRadio/ 目录并填写 broker 地址与主题前缀即可暴露 command/status/playlist/volume 四个主题支持 next、prev、play x、vol x 等指令。Home Assistant将 HA/custom_components/yoradio 拷到.homeassistant/custom_components/按 HA/example_configuration.yaml 添加实体Lovelace 里即可当作 Media Player 使用依赖 MQTT 集成。插件系统继承 Plugin 基类、重写 on_start_play、on_btn_click 等钩子新插件放在 src/plugins/ 对应目录examples/plugins/ 有背光控制、深度睡眠等现成示例接口定义见 yoRadio/src/pluginsManager/pluginsManager.h。其他mDNS 发现、屏保、通过 /update 页面上传固件与 SPIFFS 镜像做 OTA 均已内置屏幕文字支持 EN/RU 两种语言L10N_LANGUAGE参数源文件在 yoRadio/locale/Nextion 触摸屏有独立的 nextion/ 工程。按键行为映射、红外遥控器配码流程等细节见 Controls.md。yoRadio 把解码、播放、显示、控制和智能家居集成做成了完整的闭环硬件最小组合只需一块 ESP32、一个音频模块和几个按键。更多细节可看仓库 README 与 Wiki遇到问题先查版本日志或直接向官方仓库提 Issue。【免费下载链接】yoradioWeb-radio based on ESP32-audioI2S library项目地址: https://gitcode.com/GitHub_Trending/yo/yoradio创作声明：本文部分内容由AI辅助生成（AIGC），仅供参考