当前位置：首页 > news >正文

ёRadio显示配置全攻略：OLED、TFT屏幕驱动与界面定制

news 2026/6/13 10:26:09

ёRadio显示配置全攻略：OLED、TFT屏幕驱动与界面定制

【免费下载链接】yoradioWeb-radio based on ESP32-audioI2S library项目地址: https://gitcode.com/GitHub_Trending/yo/yoradio

ёRadio是基于ESP32-audioI2S库开发的Web-radio项目，提供了丰富的显示配置功能，支持多种OLED和TFT屏幕驱动，用户可以根据自己的硬件设备进行灵活定制。本文将详细介绍ёRadio的显示配置方法，帮助新手和普通用户轻松完成屏幕驱动设置与界面个性化。

支持的显示类型与驱动

ёRadio项目支持多种显示类型，包括OLED和TFT屏幕，能够满足不同用户的需求。在项目的yoRadio/src/displays目录下，可以找到各种屏幕的驱动文件，例如displaySH1106.h、displaySSD1327.h、displayST7735.h等，分别对应不同型号的OLED和TFT屏幕。

OLED屏幕驱动

OLED屏幕以其低功耗、高对比度的特点，成为很多嵌入式项目的首选。ёRadio支持多种OLED屏幕，如SH1106、SSD1306、SSD1322、SSD1327等。在配置文件中，通过定义DSP_OLED宏来启用OLED屏幕支持，同时可以设置屏幕的背景色、前景色等参数。例如，在displaySH1106.h文件中，定义了TFT_BG（背景色）和TFT_FG（前景色）等宏，用户可以根据需要进行修改。

TFT屏幕驱动

TFT屏幕则提供了更丰富的色彩和更高的分辨率，适合对显示效果有较高要求的场景。ёRadio支持的TFT屏幕包括ST7735、ST7789、ILI9341、ILI9488等。与OLED屏幕类似，TFT屏幕的配置文件中也定义了屏幕的宽度（DSP_WIDTH）、高度（DSP_HEIGHT）等参数，用户可以根据自己的屏幕型号进行调整。例如，在displayST7735_144conf.h文件中，DSP_WIDTH被定义为128，DSP_HEIGHT根据具体屏幕型号进行设置。

屏幕配置文件详解

屏幕配置文件是ёRadio显示功能的核心，位于yoRadio/src/displays/conf目录下。这些文件以displayXXXconf.h的形式命名，其中XXX代表具体的屏幕型号。配置文件中包含了屏幕的基本参数、滚动配置、填充配置等信息，用户可以通过修改这些文件来实现对屏幕显示效果的定制。

基本参数设置

基本参数包括屏幕的宽度（DSP_WIDTH）、高度（DSP_HEIGHT）、边框宽度（TFT_FRAMEWDT）等。例如，在displayGC9A01Aconf.h文件中，DSP_WIDTH被定义为240，TFT_FRAMEWDT为8，MAX_WIDTH则是屏幕可显示内容的最大宽度，通过DSP_WIDTH-TFT_FRAMEWDT*2计算得出。

滚动配置

滚动配置用于控制文本在屏幕上的滚动效果，包括滚动区域的位置、滚动速度等参数。例如，在displayST7735_144conf.h文件中，metaConf定义了元数据的滚动配置，包括滚动区域的起始坐标、滚动速度（5000毫秒）等。

填充配置

填充配置用于设置屏幕上不同区域的填充效果，如背景色、进度条颜色等。例如，在displayILI9341conf.h文件中，volbarConf定义了音量条的填充配置，包括填充区域的位置、宽度和高度等。

界面定制方法

ёRadio提供了灵活的界面定制功能，用户可以通过修改配置文件和相关代码来调整界面的布局、颜色、字体等元素，打造属于自己的个性化界面。

颜色主题定制

颜色主题的定制主要通过修改配置文件中的颜色宏来实现。例如，在tools/oledcolorfix.h文件中，定义了各种界面元素的颜色，如背景色（config.theme.background）、标题颜色（config.theme.title1）等。用户可以根据自己的喜好修改这些颜色值，实现界面的整体风格调整。

布局调整

布局调整可以通过修改配置文件中的滚动配置、填充配置和部件配置来实现。例如，在displayST7735_144conf.h文件中，playlistConf定义了播放列表的滚动配置，用户可以通过调整滚动区域的起始坐标和宽度，来改变播放列表在屏幕上的位置和大小。

字体选择

ёRadio支持多种字体，位于yoRadio/src/displays/fonts目录下。用户可以通过修改代码中的字体引用，来改变界面上文本的显示字体。例如，DS_DIGI15pt7b.h、TinyFont5.h等字体文件提供了不同大小和风格的字体，用户可以根据需要选择合适的字体。

实际操作示例

下面以设置ST7789 TFT屏幕为例，介绍具体的配置步骤：

选择屏幕驱动：在yoRadio/src/displays/dspcore.h文件中，确保包含了ST7789的驱动头文件#include "displayST7789.h"。
修改配置文件：打开yoRadio/src/displays/conf/displayST7789conf.h文件，根据屏幕型号设置DSP_WIDTH和DSP_HEIGHT。例如，对于240x240分辨率的屏幕，将DSP_WIDTH设置为240，DSP_HEIGHT设置为240。
调整颜色主题：在tools/oledcolorfix.h文件中，修改config.theme相关的颜色值，如将config.theme.background设置为黑色，config.theme.title1设置为黄色。
编译上传：完成配置后，编译项目并将固件上传到ESP32开发板，重启设备即可看到修改后的显示效果。