【程序说明】

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

【硬件连接】

• 将开发板接入电脑

【代码分析】

• 显示初始化：

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!");

【运行效果】

【程序说明】

• 本示例通过使用Arduino GFX库在ESP32上展示了如何在CO5300显示屏上显示一个基本的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_CO5300(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);
  }
}

【运行效果】

【程序说明】

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

【硬件连接】

• 将开发板接入电脑

【代码分析】

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

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

【运行效果】

【程序说明】

• 本示例演示了使用 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示例，动态状态下帧率可达20~30帧，通过优化CO5300显示库可实现更佳流畅的帧率，实际可对比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函数继续列出其内容。对于文件，打印文件名和文件大小。最后将所有收集到的信息作为字符串返回