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

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

news 2025/5/26 7:29:09

以下是 微雪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);

四、关键注意事项

初始化与显示匹配
- 使用 _Fast 显示函数前必须调用 _Init_Fast。
- 4灰度显示必须配对 _Init_4GRAY 和 _4GrayDisplay。
局刷的残影问题
- 每 5-10次局刷 后需全刷一次（调用EPD_2IN7_V2_Display）。
功耗控制
- 长期不操作时务必调用 EPD_2IN7_V2_Sleep()。
灰度数据格式
- 4灰度模式下，图像数据需按 2bit/像素 编码（0x00=黑, 0x03=白）。