微雪2.7英寸墨水屏 API函数 解释

以下是 微雪2.7英寸墨水屏（EPD_2IN7_V2） 各初始化函数和显示函数的详细区别说明，按功能分类整理：

---

一、初始化函数对比

函数名称	作用	适用场景	刷新速度	备注
EPD_2IN7_V2_Init()	标准初始化，配置全刷波形	通用场景（需高稳定性显示）	慢 (~2s)	支持全刷和局刷，但局刷需手动调用EPD_2IN7_V2_Display_Partial
EPD_2IN7_V2_Init_Fast()	快速初始化，优化波形缩短刷新时间	需要快速更新的场景（如动态内容）	较快 (~1s)	可能牺牲部分显示质量（残影略多）
EPD_2IN7_V2_Init_4GRAY()	4灰度模式初始化，支持16级灰度显示	需要显示灰度图像（如照片、渐变效果）	慢 (~3s)	必须配合EPD_2IN7_V2_4GrayDisplay()使用

---

二、显示函数对比

1. 全刷显示（Full Refresh）

函数名称	作用	刷新方式	适用场景	备注
EPD_2IN7_V2_Display()	标准全刷显示，清除残影	全刷（慢速）	静态内容（如文字、图标）	调用后需延时等待刷新完成
EPD_2IN7_V2_Display_Fast()	快速全刷显示，缩短时间但可能有残影	全刷（快速）	需频繁更新的内容	需先调用EPD_2IN7_V2_Init_Fast()
EPD_2IN7_V2_Display_Base()	显示基准图像（不刷新旧内容）	局刷（无清屏）	局部更新（如时钟背景固定）	需先调用EPD_2IN7_V2_Display_Base_color
EPD_2IN7_V2_4GrayDisplay()	4灰度全刷显示，支持16级灰度	全刷（慢速）	灰度图像（如照片、渐变）	需先调用EPD_2IN7_V2_Init_4GRAY()

2. 局刷显示（Partial Refresh）

函数名称	作用	刷新区域	适用场景	备注
EPD_2IN7_V2_Display_Partial()	局部刷新指定区域，保留其他内容	自定义矩形区域	动态内容（如秒针、进度条）	需定期全刷防止残影累积
EPD_2IN7_V2_Display_Base_color()	设置基准背景色（用于局刷时保留背景）	全局	配合Display_Base使用	通常设为白色（WHITE）

3. 其他功能

函数名称	作用
EPD_2IN7_V2_Clear()	全刷清屏（纯白或纯黑），通常用于初始化或长期存放前。
EPD_2IN7_V2_Sleep()	进入睡眠模式，断电后仅维持微安级电流，保护屏幕。

---

三、核心使用场景示例

1. 静态文本显示（标准全刷）

EPD_2IN7_V2_Init();
EPD_2IN7_V2_Clear();
Paint_DrawString_EN(10, 10, "Hello", &Font16, BLACK, WHITE);
EPD_2IN7_V2_Display(gImage);  // 全刷显示
EPD_2IN7_V2_Sleep();

2. 动态时钟（局刷+定期全刷）

EPD_2IN7_V2_Init();
EPD_2IN7_V2_Display_Base_color(WHITE);  // 设置基准背景
EPD_2IN7_V2_Display_Base(gImage);       // 显示静态背景// 每秒局刷更新秒针
EPD_2IN7_V2_Display_Partial(second_image, 50, 50, 80, 80);

3. 灰度图像显示（4灰度模式）

EPD_2IN7_V2_Init_4GRAY();
Paint_DrawBitMap(gImage_4gray);  // 加载灰度位图
EPD_2IN7_V2_4GrayDisplay(gImage_4gray);

---

四、关键注意事项

1. 初始化与显示匹配

   • 使用 _Fast 显示函数前必须调用 _Init_Fast。
   • 4灰度显示必须配对 _Init_4GRAY 和 _4GrayDisplay。

2. 局刷的残影问题

   • 每 5-10次局刷 后需全刷一次（调用EPD_2IN7_V2_Display）。

3. 功耗控制

   • 长期不操作时务必调用 EPD_2IN7_V2_Sleep()。

4. 灰度数据格式

   • 4灰度模式下，图像数据需按 2bit/像素 编码（0x00=黑, 0x03=白）。

---

五、函数选择流程图

通过合理选择函数组合，可平衡显示质量、刷新速度和功耗。