【程序说明】

• 本示例演示了如何使用 Arduino GFX 库控制 SH8601 显示屏，通过动态变化的文本展示了基本的图形库功能。该代码也可以用于测试显示屏的基础性能以及随机文本显示效果

【硬件连接】

• 将开发板接入电脑

【代码分析】

• 显示初始化：

if (!gfx->begin()) {
  USBSerial.println("gfx->begin() failed!");
}

• 清屏并显示文本：

gfx->fillScreen(BLACK);
gfx->setCursor(10, 10);
gfx->setTextColor(RED);
gfx->println("Hello World!");

• 动图显示：

gfx->setCursor(random(gfx->width()), random(gfx->height()));
gfx->setTextColor(random(0xffff), random(0xffff));
gfx->setTextSize(random(6), random(6), random(2));
gfx->println("Hello World!");

• 本示例演示了如何使用ESP32通过I2C接口控制FT3168触摸控制器和TCA9554 GPIO扩展器，同时使用Arduino GFX、Arduino_DriveBus库来驱动SH8601显示屏

【硬件连接】

• 将开发板接入电脑

【代码分析】

• 显示屏初始化与亮度渐变动画：

gfx->begin();
gfx->fillScreen(WHITE);
for (int i = 0; i <= 255; i++) {
  gfx->Display_Brightness(i);
  gfx->setCursor(30, 150);
  gfx->setTextColor(BLUE);
  gfx->setTextSize(4);
  gfx->println("Loading board");
  delay(3);
}

• 触摸中断处理和坐标读取

void Arduino_IIC_Touch_Interrupt(void) {
  FT3168->IIC_Interrupt_Flag = true;
}

int32_t touchX = FT3168->IIC_Read_Device_Value(FT3168->Arduino_IIC_Touch::Value_Information::TOUCH_COORDINATE_X);
int32_t touchY = FT3168->IIC_Read_Device_Value(FT3168->Arduino_IIC_Touch::Value_Information::TOUCH_COORDINATE_Y); 

if (FT3168->IIC_Interrupt_Flag == true) {
  FT3168->IIC_Interrupt_Flag = false;
  USBSerial.printf("Touch X:%d Y:%d\n", touchX, touchY);
  if (touchX > 20 && touchY > 20) {
    gfx->fillCircle(touchX, touchY, 5, BLUE);
  }
}

【程序说明】

• 本示例通过使用Arduino GFX库在ESP32上展示了如何在SH8601显示屏上显示一个基本的ASCII字符表格。代码的核心功能是初始化显示屏，并根据屏幕尺寸，在显示屏上按行列打印ASCII字符

【硬件连接】

• 将开发板接入电脑

【代码分析】

• 数据总线和图形显示对象的创建
  
  • 这里创建了一个用于与显示屏通信的数据总线对象bus，使用特定的引脚配置进行初始化。然后创建了一个图形显示对象gfx，传入数据总线、复位引脚、旋转角度、是否为 IPS 屏以及显示屏的宽度和高度等参数

Arduino_DataBus *bus = new Arduino_ESP32QSPI(
  LCD_CS /* CS */, LCD_SCLK /* SCK */, LCD_SDIO0 /* SDIO0 */, LCD_SDIO1 /* SDIO1 */,
  LCD_SDIO2 /* SDIO2 */, LCD_SDIO3 /* SDIO3 */);

Arduino_GFX *gfx = new Arduino_SH8601(bus, -1 /* RST */,
                                      0 /* rotation */, false /* IPS */, LCD_WIDTH, LCD_HEIGHT);

• 绘制行列编号和字符表
  
  • 首先设置文本颜色为绿色，在显示屏上逐个打印行号。然后设置文本颜色为蓝色，打印列号。接着使用循环逐个绘制字符，组成字符表，每个字符使用白色前景和黑色背景

gfx->setTextColor(GREEN);
for (int x = 0; x < numRows; x++) {
  gfx->setCursor(10 + x * 8, 2);
  gfx->print(x, 16);
}
gfx->setTextColor(BLUE);
for (int y = 0; y < numCols; y++) {
  gfx->setCursor(2, 12 + y * 10);
  gfx->print(y, 16);
}

char c = 0;
for (int y = 0; y < numRows; y++) {
  for (int x = 0; x < numCols; x++) {
    gfx->drawChar(10 + x * 8, 12 + y * 10, c++, WHITE, BLACK);
  }
}

【程序说明】

• 本示例通过 ESP32-S3 上的 QSPI 驱动的 SH8601 显示屏实现触摸屏显示界面。集成了一个用于检测触摸输入的 I2C 触摸控制器 (FT3168)，以及一个用于管理额外输出引脚的 I2C GPIO 扩展器 (TCA9554)。该代码设置显示屏、触摸控制器和扩展器，并在触摸屏幕时循环显示多个图像

【硬件连接】

• 将开发板接入电脑

【代码分析】

• 图像显示：

if (fingers_number > 0) {
  switch (Image_Flag) {
    case 0: gfx->draw16bitRGBBitmap(0, 0, (uint16_t *)gImage_1, LCD_WIDTH, LCD_HEIGHT); break;
    case 1: gfx->draw16bitRGBBitmap(0, 0, (uint16_t *)gImage_2, LCD_WIDTH, LCD_HEIGHT); break;
    case 2: gfx->draw16bitRGBBitmap(0, 0, (uint16_t *)gImage_3, LCD_WIDTH, LCD_HEIGHT); break;
    case 3: gfx->draw16bitRGBBitmap(0, 0, (uint16_t *)gImage_4, LCD_WIDTH, LCD_HEIGHT); break;
    case 4: gfx->draw16bitRGBBitmap(0, 0, (uint16_t *)gImage_5, LCD_WIDTH, LCD_HEIGHT); break;
  }
  Image_Flag++;
  if (Image_Flag > 4) {
    Image_Flag = 0;
  }
}

【代码修改】

• 图片内容资源较大，需要设置Tools ->Partition Scheme -> 16M Flash (3MB APP/9.9MB FATFS)

【程序说明】

• 本示例演示了使用PCF85063 RTC 模块在 SH8601 显示屏上显示当前时间，每秒检索时间并仅在时间发生变化时更新显示

【硬件连接】

• 将开发板接入电脑

【代码分析】

• setup：进行程序的初始化设置
  • 串口初始化，为输出错误信息提供通道
  • 初始化实时时钟芯片，包括连接检查和设置初始时间，确保时间的准确性
  • 初始化图形显示设备，设置背景颜色和亮度，为时间显示提供可视化界面

• loop：在程序运行过程中不断检查时间变化并更新显示屏上的时间显示
  • 定期检查时间是否变化，通过比较当前时间和上一次更新时间的差值来确定是否需要更新时间显示
  • 获取实时时钟的时间信息并格式化，以便在显示屏上正确显示
  • 如果时间发生变化，清除上一次的时间显示区域，设置文本颜色和大小，计算居中位置，并在显示屏上显示新的时间。最后保存当前时间作为上一次时间，以便下次比较

【程序说明】

• 本示例演示了在SH8601显示器上绘制WiFi频段信号强度示例，实现WiFi分析器的功能

【硬件连接】

• 将开发板接入电脑

【代码分析】

• setup：为整个程序进行初始化准备
  • 初始化串口通信，设置波特率为 115200，用于输出信息和调试
  • 将 WiFi 设置为站点模式并断开连接，为后续的网络扫描做准备
  • 根据不同的硬件条件进行一些额外的预初始化操作（如果定义了GFX_EXTRA_PRE_INIT）
  • 初始化图形显示设备，计算一些与显示相关的参数，如文本大小、横幅高度等，并设置显示屏亮度。最后绘制初始的横幅信息

• loop：行主要的程序逻辑，包括进行 WiFi 网络扫描、处理扫描结果、绘制图表和显示统计信息，以及根据需要进行节能操作
  • WiFi 扫描和处理：进行 WiFi 网络扫描，获取网络数量和各种网络信息；统计每个频道的接入点数量，计算噪声水平和确定信号峰值；根据扫描结果绘制 WiFi 信号强度图表，包括绘制椭圆表示信号强度和显示相关的网络信息
  • 显示统计信息：在显示屏上打印找到的网络数量和噪声较小的频道信息，绘制图表的基线和频道标记，并显示每个频道的接入点数量
  • 节能操作：根据配置的扫描次数，在满足条件时进行节能操作，如关闭显示屏电源引脚和进入深度睡眠模式

【程序说明】

• 本示例演示了一个简单的SH8601时钟示例，通过简单的标记指针和时间管理实现时钟示例

【硬件连接】

• 将开发板接入电脑

【代码分析】

• 时针、分针、秒针的绘制

void redraw_hands_cached_draw_and_erase() {
    gfx->startWrite();
    draw_and_erase_cached_line(center, center, nsx, nsy, SECOND_COLOR, cached_points, sHandLen + 1, false, false);
    draw_and_erase_cached_line(center, center, nhx, nhy, HOUR_COLOR, cached_points + ((sHandLen + 1) * 2), hHandLen + 1, true, false);
    draw_and_erase_cached_line(center, center, nmx, nmy, MINUTE_COLOR, cached_points + ((sHandLen + 1 + hHandLen + 1) * 2), mHandLen + 1, true, true);
    gfx->endWrite();
}

【程序说明】

• 本示例演示了一个简单的LVGL滑块示例，可以通过改变滑块的数值改变屏幕背光亮度

【硬件连接】

• 将开发板接入电脑

【代码分析】

• 实时修改背光亮度

int32_t slider_value = lv_slider_get_value(ui_Slider1);
int32_t brightness = map(slider_value, 0, 100, 5, 255);
gfx->Display_Brightness(brightness);

【程序说明】

• 本示例演示了一个LVGL背光明暗场景变化，通过定义简单的按钮组件实现背景颜色的变化

【硬件连接】

• 将开发板接入电脑

【代码分析】

• setup：负责整个系统的初始化工作
  • 首先初始化串口用于可能的调试输出
  • 接着初始化 I²C 总线和扩展芯片，设置扩展芯片的引脚模式和初始状态
  • 然后不断尝试初始化触摸控制器，成功后设置其电源模式
  • 初始化图形显示设备并设置亮度，还打印 LVGL 和 Arduino 的版本信息
  • 初始化 LVGL，包括注册调试打印回调函数、初始化显示驱动和输入设备驱动
  • 创建并启动 LVGL 的定时器，初始化用户界面并打印设置完成信息

• loop
  • 在主循环中不断调用lv_timer_handler()让 LVGL 图形库处理各种任务
  • 添加了一个小的延迟，避免过度占用 CPU 资源

• my_touchpad_read：读取触摸板的坐标，根据触摸状态设置 LVGL 的输入设备状态，并更新触摸坐标

【程序说明】

• 本示例演示了在LVGL下使用PCF85063 RTC 模块在 SH8601 显示屏上显示当前时间,每秒检索时间并仅在时间发生变化时更新显示，对比时间刷新效果更佳

【硬件连接】

• 将开发板接入电脑

【代码分析】

• setup：负责初始化各种硬件设备和 LVGL图形库环境
  • 串口初始化：USBSerial.begin(115200)为串口调试做准备
  • 实时时钟初始化：尝试初始化实时时钟rtc，如果失败则进入死循环。设置日期和时间
  • 触摸控制器初始化：不断尝试初始化触摸控制器FT3168，如果初始化失败则打印错误信息并延迟等待，成功后打印成功信息
  • 图形显示初始化：初始化图形显示设备gfx，设置亮度，并打印 LVGL 和 Arduino 的版本信息。接着初始化 LVGL，包括注册打印回调函数用于调试，初始化显示驱动和输入设备驱动。创建并启动 LVGL 的定时器，最后创建一个标签并设置初始文本为 “Initializing...”

• loop
  • lv_timer_handler()：这是 LVGL 图形库中的一个重要函数，用于处理图形界面的各种定时器事件、动画更新、输入处理等任务。在每个循环中调用这个函数可以确保图形界面的流畅运行和及时响应交互操作
  • 时间更新和显示：每秒钟获取一次实时时钟的时间，并通过串口打印出来。然后将时间格式化为字符串，并更新标签的文本显示当前时间。同时设置标签的字体为特定字体。最后添加一个小的延迟

【程序说明】

• 本示例演示了使用 LVGL 进行图形显示，与 QMI8658 IMU 通信以获取加速度计和陀螺仪数据

【硬件连接】

• 将开发板接入电脑

【代码分析】

• setup：负责初始化各种硬件设备和 LVGL图形库环境
  • 串口初始化：USBSerial.begin(115200)为串口调试做准备
  • 触摸控制器初始化：不断尝试初始化触摸控制器FT3168，如果初始化失败则打印错误信息并延迟等待，成功后打印成功信息
  • 图形显示初始化：初始化图形显示设备gfx，设置亮度，并打印 LVGL 和 Arduino 的版本信息。接着初始化 LVGL，包括注册打印回调函数用于调试，初始化显示驱动和输入设备驱动。创建并启动 LVGL 的定时器，最后创建一个标签并设置初始文本为 “Initializing...”
  • 创建图表：创建一个图表对象chart，设置图表的类型、范围、数据点数量等属性，并为加速度的三个轴添加数据系列
  • 加速度传感器初始化：初始化加速度传感器qmi，配置加速度计和陀螺仪的参数，启用它们，并打印芯片 ID 和控制寄存器信息

• loop
  • lv_timer_handler()：这是 LVGL 图形库中的一个重要函数，用于处理图形界面的各种定时器事件、动画更新、输入处理等任务。在每个循环中调用这个函数可以确保图形界面的流畅运行和及时响应交互操作
  • 读取加速度传感器数据：如果加速度传感器数据准备好，读取加速度数据并通过串口打印出来，同时更新图表显示加速度数据。如果陀螺仪数据准备好，读取陀螺仪数据并通过串口打印出来。最后添加一个小的延迟，增加数据 polling 的频率

【程序说明】

• 本示例演示了LVGL下使用XPowers库进行电源管理，并且提供PWR自定义按钮控制亮屏、熄屏动作

【硬件连接】

• 将开发板接入电脑

【代码分析】

• 亮屏熄屏实现函数

void toggleBacklight() {
  USBSerial.println(backlight_on);
  if (backlight_on) {
    for (int i = 255; i >= 0; i--) {
      gfx->Display_Brightness(i);
      delay(3);
    }
  } else {
    for (int i = 0; i <= 255; i++) {
      gfx->Display_Brightness(i);
      delay(3);
    }
  }
  backlight_on = !backlight_on;
}

【运行效果】

• 显示参数：芯片温度，是否正在充电，是否放电，是否待机状态，Vbus是否连接，Vbus是否良好，充电器状态，电池电压，Vbus电压，系统电压，电池百分比

【程序说明】

• 本示例演示了LVGL Widgets示例，动态状态下帧率可达50~60帧，通过优化SH8601显示库可实现更佳流畅的帧率，实际可对比ESP-IDF环境下启用双缓存、双加速的场景

【硬件连接】

• 将开发板接入电脑

【代码分析】

• setup：负责初始化各种硬件设备和 LVGL图形库环境
  • 串口初始化：USBSerial.begin(115200)为串口调试做准备
  • I²C 总线初始化：Wire.begin(IIC_SDA, IIC_SCL);初始化 I²C 总线，用于与其他 I²C 设备通信
  • 扩展芯片初始化：创建并初始化扩展芯片expander，设置引脚模式为输出，并进行一些初始的引脚状态设置
  • 触摸控制器初始化：不断尝试初始化触摸控制器FT3168，如果初始化失败则打印错误信息并延迟等待，成功后打印成功信息
  • 图形显示初始化：初始化图形显示设备gfx，设置亮度，并获取屏幕的宽度和高度。然后初始化 LVGL，包括注册打印回调函数用于调试，设置触摸控制器的电源模式为监控模式，初始化显示驱动和输入设备驱动。创建并启动 LVGL 的定时器，创建一个标签并设置文本，最后调用lv_demo_widgets()展示 LVGL 的示例小部件

• loop
  • lv_timer_handler()：这是 LVGL 图形库中的一个重要函数，用于处理图形界面的各种定时器事件、动画更新、输入处理等任务。在每个循环中调用这个函数可以确保图形界面的流畅运行和及时响应交互操作
  • delay(5);：添加一个小的延迟，避免过度占用 CPU 资源

【程序说明】

• 本示例演示了使用SDMMC驱动SD卡，并输出其内容到显示屏上

【硬件连接】

• 将开发板接入电脑
• 将SD卡装入开发板

【代码分析】

• setup：负责初始化各种硬件设备和 LVGL图形库环境
  • 串口初始化：USBSerial.begin(115200)为串口调试做准备
  • I²C 总线和扩展芯片初始化：初始化 I²C 总线，创建并初始化扩展芯片，设置其引脚模式为输出，并打印初始状态和新的状态
  • 图形显示初始化：初始化图形显示设备，设置亮度，初始化 LVGL，设置显示驱动和输入设备驱动，创建并启动 LVGL 的定时器
  • SD 卡初始化和信息显示：设置 SD 卡的引脚，尝试挂载 SD 卡。如果挂载失败，在串口和屏幕上显示错误信息。如果成功挂载，检测 SD 卡类型并显示，获取 SD 卡大小并显示。然后调用listDir函数列出 SD 卡根目录的内容，并将 SD 卡的类型、大小和目录列表信息显示在屏幕上的标签中

• listDir：递归地列出指定目录下的文件和子目录信息
  • 首先打印正在列出的目录名称。然后打开指定目录，如果打开失败，返回错误信息。如果打开的不是目录，也返回错误信息。如果是目录，则遍历其中的文件和子目录。对于子目录，递归调用listDir函数继续列出其内容。对于文件，打印文件名和文件大小。最后将所有收集到的信息作为字符串返回