312 lines
11 KiB
Python
312 lines
11 KiB
Python
"""
|
||
MicroPython Good Display GDEQ042T81 (GDEY042T81)
|
||
|
||
Based on MicroPython Waveshare 4.2" Black/White GDEW042T2 e-paper display driver
|
||
https://github.com/mcauser/micropython-waveshare-epaper
|
||
|
||
licensed under the MIT License
|
||
Copyright (c) 2017 Waveshare
|
||
Copyright (c) 2018 Mike Causer
|
||
"""
|
||
|
||
"""
|
||
MicroPython Good Display GDEQ042T81 (GDEY042T81) e-paper display driver
|
||
|
||
MIT License
|
||
Copyright (c) 2024 Martin Maly
|
||
|
||
Permission is hereby granted, free of charge, to any person obtaining a copy
|
||
of this software and associated documentation files (the "Software"), to deal
|
||
in the Software without restriction, including without limitation the rights
|
||
to use, copy, modify, merge, publish, distribute, sublicense, and/or sell
|
||
copies of the Software, and to permit persons to whom the Software is
|
||
furnished to do so, subject to the following conditions:
|
||
|
||
The above copyright notice and this permission notice shall be included in all
|
||
copies or substantial portions of the Software.
|
||
|
||
THE SOFTWARE IS PROVIDED "AS IS", WITHOUT WARRANTY OF ANY KIND, EXPRESS OR
|
||
IMPLIED, INCLUDING BUT NOT LIMITED TO THE WARRANTIES OF MERCHANTABILITY,
|
||
FITNESS FOR A PARTICULAR PURPOSE AND NONINFRINGEMENT. IN NO EVENT SHALL THE
|
||
AUTHORS OR COPYRIGHT HOLDERS BE LIABLE FOR ANY CLAIM, DAMAGES OR OTHER
|
||
LIABILITY, WHETHER IN AN ACTION OF CONTRACT, TORT OR OTHERWISE, ARISING FROM,
|
||
OUT OF OR IN CONNECTION WITH THE SOFTWARE OR THE USE OR OTHER DEALINGS IN THE
|
||
SOFTWARE.
|
||
"""
|
||
|
||
from micropython import const
|
||
from time import sleep_ms
|
||
try:
|
||
from buzzer import system_buzzer
|
||
except ImportError:
|
||
system_buzzer = None
|
||
|
||
# Display resolution
|
||
EPD_WIDTH = const(400)
|
||
EPD_HEIGHT = const(300)
|
||
BUSY = const(0) # 0=busy, 1=idle
|
||
|
||
class EPD:
|
||
def __init__(self, spi, cs, dc, rst, busy):
|
||
self.spi = spi
|
||
self.cs = cs
|
||
self.dc = dc
|
||
self.rst = rst
|
||
self.busy = busy
|
||
self.cs.init(self.cs.OUT, value=1)
|
||
self.dc.init(self.dc.OUT, value=0)
|
||
self.rst.init(self.rst.OUT, value=0)
|
||
self.busy.init(self.busy.IN)
|
||
self.width = EPD_WIDTH
|
||
self.height = EPD_HEIGHT
|
||
self.powered = False
|
||
self.init_done = False
|
||
self.hibernate = True
|
||
self.use_fast_update = True
|
||
# 添加刷新计数器，用于控制全屏刷新频率
|
||
self.refresh_count = 0
|
||
# 每N次局部刷新后执行一次全屏刷新，防止残影积累
|
||
self.partial_refresh_limit = 5
|
||
# 强制全屏刷新标志
|
||
self.force_full_refresh = False
|
||
|
||
def _command(self, command, data=None):
|
||
self.dc(0)
|
||
self.cs(0)
|
||
self.spi.write(bytearray([command]))
|
||
self.cs(1)
|
||
if data is not None:
|
||
self._data(data)
|
||
|
||
def _data(self, data):
|
||
self.dc(1)
|
||
self.cs(0)
|
||
self.spi.write(data)
|
||
self.cs(1)
|
||
|
||
def _ndata(self, data):
|
||
self._data(bytearray([data]))
|
||
|
||
def pwr_on(self):
|
||
if self.powered == False:
|
||
self._command(0x22, b'\xe0')
|
||
self._command(0x20)
|
||
self.wait_until_idle()
|
||
self.powered = True
|
||
|
||
def pwr_off(self):
|
||
if self.powered == True:
|
||
self._command(0x22, b'\x83')
|
||
self._command(0x20)
|
||
self.wait_until_idle()
|
||
self.powered = False
|
||
|
||
#set partial
|
||
def set_partial(self, x, y, w, h):
|
||
self._command(0x11,b'\x03')
|
||
self._command(0x44)
|
||
self._ndata(x // 8)
|
||
self._ndata((x + w - 1) // 8)
|
||
self._command(0x45)
|
||
self._ndata(y % 256)
|
||
self._ndata(y // 256)
|
||
self._ndata((y+h-1) % 256)
|
||
self._ndata((y+h-1) // 256)
|
||
self._command(0x4E)
|
||
self._ndata(x // 8)
|
||
self._command(0x4F)
|
||
self._ndata(y % 256)
|
||
self._ndata(y // 256)
|
||
|
||
def init(self):
|
||
if self.hibernate==True:
|
||
self.reset()
|
||
sleep_ms(100)
|
||
#self.wait_until_idle()
|
||
self._command(const(0x12)) #SWRESET
|
||
self.wait_until_idle()
|
||
|
||
# 优化驱动初始化参数，确保与GDEY042T81规格匹配
|
||
self._command(0x01,b'\x2B\x01\x00') #MUX 设置
|
||
self._command(0x21,b'\x40\x00') # 显示更新控制
|
||
self._command(0x3C,b'\x05') # 边界波形控制，减少残影
|
||
self._command(0x18,b'\x80') # 读取内部温度传感器
|
||
self._command(0x0C,b'\x8B\x00\x00') # 设置开始和结束阶段，优化刷新
|
||
|
||
self.set_partial(0, 0, self.width, self.height)
|
||
self.init_done = True
|
||
|
||
def wait_until_idle(self):
|
||
while self.busy.value() == BUSY:
|
||
sleep_ms(100)
|
||
print("等待墨水屏空闲")
|
||
|
||
def reset(self):
|
||
self.rst(0)
|
||
sleep_ms(200)
|
||
self.rst(1)
|
||
sleep_ms(200)
|
||
|
||
def update_full(self):
|
||
#update Full
|
||
print("执行全屏更新")
|
||
self._command(0x21,b'\x40\x00')
|
||
if self.use_fast_update == False:
|
||
self._command(0x22,b'\xf7')
|
||
else:
|
||
self._command(0x1A, b'\x64') # 快速刷新设置
|
||
self._command(0x22,b'\xd7')
|
||
self._command(0x20)
|
||
self.wait_until_idle()
|
||
print("更新完成", self.busy.value())
|
||
|
||
# 添加专门的全屏刷新方法，用于清除残影
|
||
def clear_screen(self, double_refresh=True):
|
||
"""执行全屏刷新以清除残影
|
||
|
||
参数:
|
||
double_refresh: 是否执行两次刷新以彻底清除残影，默认为True
|
||
"""
|
||
if double_refresh:
|
||
print("执行双次全屏刷新以彻底清除残影")
|
||
else:
|
||
print("执行单次全屏刷新以清除残影")
|
||
|
||
# 创建全白缓冲区
|
||
white_buffer = bytearray(self.width * self.height // 8)
|
||
for i in range(len(white_buffer)):
|
||
white_buffer[i] = 0xFF # 全白
|
||
|
||
# 先写入全白数据
|
||
self.set_partial(0, 0, self.width, self.height)
|
||
self.write_image(0x24, white_buffer, True, True)
|
||
|
||
# 执行第一次全屏刷新
|
||
self._command(0x21,b'\x40\x00')
|
||
self._command(0x22,b'\xf7') # 使用完整刷新模式
|
||
self._command(0x20)
|
||
self.wait_until_idle()
|
||
|
||
# 如果启用双次刷新，再执行一次
|
||
if double_refresh:
|
||
print("执行第二次全屏刷新")
|
||
self._command(0x21,b'\x40\x00')
|
||
self._command(0x22,b'\xf7') # 使用完整刷新模式
|
||
self._command(0x20)
|
||
self.wait_until_idle()
|
||
|
||
# 重置刷新计数器
|
||
self.refresh_count = 0
|
||
self.force_full_refresh = False
|
||
print("全屏刷新完成")
|
||
|
||
def write_image(self, command, bitmap, mirror_x, mirror_y):
|
||
sleep_ms(1)
|
||
h = self.height
|
||
w = self.width
|
||
bpl = w // 8 # bytes per line
|
||
|
||
self._command(command)
|
||
for i in range(0, h):
|
||
for j in range(0, bpl):
|
||
idx = ((bpl-j-1) if mirror_x else j) + ((h-i-1) if mirror_y else i) * bpl
|
||
self._ndata(bitmap[idx])
|
||
|
||
def write_value(self, command, value):
|
||
sleep_ms(1)
|
||
h = self.height
|
||
w = self.width
|
||
bpl = w // 8 # bytes per line
|
||
|
||
self._command(command)
|
||
for i in range(0, h):
|
||
for j in range(0, bpl):
|
||
self._ndata(value)
|
||
|
||
# 修改显示方法，添加刷新控制逻辑
|
||
def display_frame(self, frame_buffer, partial=False, x=0, y=0, w=None, h=None, global_refresh=False):
|
||
"""显示帧缓冲区内容
|
||
|
||
参数:
|
||
frame_buffer: 要显示的帧缓冲区数据
|
||
partial: 是否使用局部刷新模式，默认为False
|
||
x: 局部刷新的起始X坐标，默认为0
|
||
y: 局部刷新的起始Y坐标，默认为0
|
||
w: 局部刷新的宽度，默认为全屏宽度
|
||
h: 局部刷新的高度，默认为全屏高度
|
||
global_refresh: 是否使用全局刷新模式，默认为False
|
||
"""
|
||
print("显示帧缓冲区")
|
||
if self.init_done==False:
|
||
self.init()
|
||
|
||
# 如果未指定宽高，则使用全屏
|
||
if w is None:
|
||
w = self.width
|
||
if h is None:
|
||
h = self.height
|
||
|
||
# 检查是否需要强制全屏刷新
|
||
need_clear_screen = self.force_full_refresh or self.refresh_count >= self.partial_refresh_limit
|
||
|
||
# 如果使用全局刷新模式，则设置全屏刷新区域
|
||
if global_refresh:
|
||
self.set_partial(0, 0, self.width, self.height)
|
||
elif need_clear_screen:
|
||
self.clear_screen()
|
||
# 设置局部刷新区域
|
||
self.set_partial(x, y, w, h)
|
||
else:
|
||
# 设置局部刷新区域
|
||
self.set_partial(x, y, w, h)
|
||
|
||
# 写入图像数据
|
||
self.write_image(0x24, frame_buffer, True, True)
|
||
|
||
# 播放等待音效 (异步)
|
||
if system_buzzer:
|
||
system_buzzer.play_process_async()
|
||
|
||
# 执行刷新
|
||
if global_refresh:
|
||
# 全局刷新模式
|
||
print("执行全局刷新模式")
|
||
self._command(0x21,b'\x40\x00')
|
||
self._command(0x22,b'\xf7') # 使用完整刷新模式
|
||
self._command(0x20)
|
||
self.wait_until_idle()
|
||
self.refresh_count = 0
|
||
print("全局刷新完成，重置计数器")
|
||
elif need_clear_screen:
|
||
# 已经通过clear_screen()执行了刷新，这里不需要再次刷新
|
||
print("已通过clear_screen完成全屏刷新，跳过重复刷新")
|
||
self.refresh_count = 0
|
||
elif partial and not self.force_full_refresh and self.refresh_count < self.partial_refresh_limit:
|
||
# 局部刷新模式
|
||
print("执行局部刷新模式")
|
||
self._command(0x21,b'\x40\x00')
|
||
self._command(0x1A, b'\x64') # 快速刷新设置
|
||
self._command(0x22,b'\xd7') # 局部刷新命令
|
||
self._command(0x20)
|
||
self.wait_until_idle()
|
||
self.refresh_count += 1
|
||
print(f"局部刷新完成，刷新计数: {self.refresh_count}/{self.partial_refresh_limit}")
|
||
else:
|
||
# 全屏刷新模式
|
||
print("执行全屏刷新模式")
|
||
self.update_full()
|
||
self.refresh_count = 0
|
||
print("全屏刷新完成，重置计数器")
|
||
|
||
# 添加强制全屏刷新的方法
|
||
def force_refresh(self):
|
||
"""强制执行下一次全屏刷新，清除所有残影"""
|
||
self.force_full_refresh = True
|
||
print("已设置强制全屏刷新标志")
|
||
|
||
# to wake call reset() or init()
|
||
def sleep(self):
|
||
self.pwr_off()
|
||
self._command(0x10, b'\x01')
|
||
self.init_done = False
|
||
self.hibernate = True |