Files
eink-api/Pico_ePaper_Code/python/Pico-ePaper-4.2.py
2026-01-03 20:37:58 -05:00

646 lines
20 KiB
Python

# *****************************************************************************
# * | File : Pico_ePaper-3.7.py
# * | Author : Waveshare team
# * | Function : Electronic paper driver
# * | Info :
# *----------------
# * | This version: V1.0
# * | Date : 2021-06-01
# # | Info : python demo
# -----------------------------------------------------------------------------
# Permission is hereby granted, free of charge, to any person obtaining a copy
# of this software and associated documnetation 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
# furished 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 OR 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 machine import Pin, SPI
import framebuf
import utime
# Display resolution
EPD_WIDTH = 400
EPD_HEIGHT = 300
RST_PIN = 12
DC_PIN = 8
CS_PIN = 9
BUSY_PIN = 13
EPD_4IN2_lut_vcom0 = [
0x00, 0x08, 0x08, 0x00, 0x00, 0x02,
0x00, 0x0F, 0x0F, 0x00, 0x00, 0x01,
0x00, 0x08, 0x08, 0x00, 0x00, 0x02,
0x00, 0x00, 0x00, 0x00, 0x00, 0x00,
0x00, 0x00, 0x00, 0x00, 0x00, 0x00,
0x00, 0x00, 0x00, 0x00, 0x00, 0x00,
0x00, 0x00, 0x00, 0x00, 0x00, 0x00,
0x00, 0x00,
]
EPD_4IN2_lut_ww = [
0x50, 0x08, 0x08, 0x00, 0x00, 0x02,
0x90, 0x0F, 0x0F, 0x00, 0x00, 0x01,
0xA0, 0x08, 0x08, 0x00, 0x00, 0x02,
0x00, 0x00, 0x00, 0x00, 0x00, 0x00,
0x00, 0x00, 0x00, 0x00, 0x00, 0x00,
0x00, 0x00, 0x00, 0x00, 0x00, 0x00,
0x00, 0x00, 0x00, 0x00, 0x00, 0x00,
]
EPD_4IN2_lut_bw = [
0x50, 0x08, 0x08, 0x00, 0x00, 0x02,
0x90, 0x0F, 0x0F, 0x00, 0x00, 0x01,
0xA0, 0x08, 0x08, 0x00, 0x00, 0x02,
0x00, 0x00, 0x00, 0x00, 0x00, 0x00,
0x00, 0x00, 0x00, 0x00, 0x00, 0x00,
0x00, 0x00, 0x00, 0x00, 0x00, 0x00,
0x00, 0x00, 0x00, 0x00, 0x00, 0x00,
]
EPD_4IN2_lut_wb = [
0xA0, 0x08, 0x08, 0x00, 0x00, 0x02,
0x90, 0x0F, 0x0F, 0x00, 0x00, 0x01,
0x50, 0x08, 0x08, 0x00, 0x00, 0x02,
0x00, 0x00, 0x00, 0x00, 0x00, 0x00,
0x00, 0x00, 0x00, 0x00, 0x00, 0x00,
0x00, 0x00, 0x00, 0x00, 0x00, 0x00,
0x00, 0x00, 0x00, 0x00, 0x00, 0x00,
]
EPD_4IN2_lut_bb = [
0x20, 0x08, 0x08, 0x00, 0x00, 0x02,
0x90, 0x0F, 0x0F, 0x00, 0x00, 0x01,
0x10, 0x08, 0x08, 0x00, 0x00, 0x02,
0x00, 0x00, 0x00, 0x00, 0x00, 0x00,
0x00, 0x00, 0x00, 0x00, 0x00, 0x00,
0x00, 0x00, 0x00, 0x00, 0x00, 0x00,
0x00, 0x00, 0x00, 0x00, 0x00, 0x00,
]
# ******************************partial screen update LUT********************************* #
EPD_4IN2_Partial_lut_vcom1 =[
0x00,0x19,0x01,0x00,0x00,0x01,
0x00,0x00,0x00,0x00,0x00,0x00,
0x00,0x00,0x00,0x00,0x00,0x00,
0x00,0x00,0x00,0x00,0x00,0x00,
0x00,0x00,0x00,0x00,0x00,0x00,
0x00,0x00,0x00,0x00,0x00,0x00,
0x00,0x00,0x00,0x00,0x00,0x00,
0x00,0x00,
]
EPD_4IN2_Partial_lut_ww1 =[
0x00,0x19,0x01,0x00,0x00,0x01,
0x00,0x00,0x00,0x00,0x00,0x00,
0x00,0x00,0x00,0x00,0x00,0x00,
0x00,0x00,0x00,0x00,0x00,0x00,
0x00,0x00,0x00,0x00,0x00,0x00,
0x00,0x00,0x00,0x00,0x00,0x00,
0x00,0x00,0x00,0x00,0x00,0x00,
]
EPD_4IN2_Partial_lut_bw1 =[
0x80,0x19,0x01,0x00,0x00,0x01,
0x00,0x00,0x00,0x00,0x00,0x00,
0x00,0x00,0x00,0x00,0x00,0x00,
0x00,0x00,0x00,0x00,0x00,0x00,
0x00,0x00,0x00,0x00,0x00,0x00,
0x00,0x00,0x00,0x00,0x00,0x00,
0x00,0x00,0x00,0x00,0x00,0x00,
]
EPD_4IN2_Partial_lut_wb1 =[
0x40,0x19,0x01,0x00,0x00,0x01,
0x00,0x00,0x00,0x00,0x00,0x00,
0x00,0x00,0x00,0x00,0x00,0x00,
0x00,0x00,0x00,0x00,0x00,0x00,
0x00,0x00,0x00,0x00,0x00,0x00,
0x00,0x00,0x00,0x00,0x00,0x00,
0x00,0x00,0x00,0x00,0x00,0x00,
]
EPD_4IN2_Partial_lut_bb1 =[
0x00,0x19,0x01,0x00,0x00,0x01,
0x00,0x00,0x00,0x00,0x00,0x00,
0x00,0x00,0x00,0x00,0x00,0x00,
0x00,0x00,0x00,0x00,0x00,0x00,
0x00,0x00,0x00,0x00,0x00,0x00,
0x00,0x00,0x00,0x00,0x00,0x00,
0x00,0x00,0x00,0x00,0x00,0x00,
]
# ******************************gray********************************* #
# 0~3 gray
EPD_4IN2_4Gray_lut_vcom=[
0x00,0x0A,0x00,0x00,0x00,0x01,
0x60,0x14,0x14,0x00,0x00,0x01,
0x00,0x14,0x00,0x00,0x00,0x01,
0x00,0x13,0x0A,0x01,0x00,0x01,
0x00,0x00,0x00,0x00,0x00,0x00,
0x00,0x00,0x00,0x00,0x00,0x00,
0x00,0x00,0x00,0x00,0x00,0x00
]
# R21
EPD_4IN2_4Gray_lut_ww =[
0x40,0x0A,0x00,0x00,0x00,0x01,
0x90,0x14,0x14,0x00,0x00,0x01,
0x10,0x14,0x0A,0x00,0x00,0x01,
0xA0,0x13,0x01,0x00,0x00,0x01,
0x00,0x00,0x00,0x00,0x00,0x00,
0x00,0x00,0x00,0x00,0x00,0x00,
0x00,0x00,0x00,0x00,0x00,0x00,
]
# R22H r
EPD_4IN2_4Gray_lut_bw =[
0x40,0x0A,0x00,0x00,0x00,0x01,
0x90,0x14,0x14,0x00,0x00,0x01,
0x00,0x14,0x0A,0x00,0x00,0x01,
0x99,0x0C,0x01,0x03,0x04,0x01,
0x00,0x00,0x00,0x00,0x00,0x00,
0x00,0x00,0x00,0x00,0x00,0x00,
0x00,0x00,0x00,0x00,0x00,0x00,
]
# R23H w
EPD_4IN2_4Gray_lut_wb =[
0x40,0x0A,0x00,0x00,0x00,0x01,
0x90,0x14,0x14,0x00,0x00,0x01,
0x00,0x14,0x0A,0x00,0x00,0x01,
0x99,0x0B,0x04,0x04,0x01,0x01,
0x00,0x00,0x00,0x00,0x00,0x00,
0x00,0x00,0x00,0x00,0x00,0x00,
0x00,0x00,0x00,0x00,0x00,0x00,
]
# R24H b
EPD_4IN2_4Gray_lut_bb =[
0x80,0x0A,0x00,0x00,0x00,0x01,
0x90,0x14,0x14,0x00,0x00,0x01,
0x20,0x14,0x0A,0x00,0x00,0x01,
0x50,0x13,0x01,0x00,0x00,0x01,
0x00,0x00,0x00,0x00,0x00,0x00,
0x00,0x00,0x00,0x00,0x00,0x00,
0x00,0x00,0x00,0x00,0x00,0x00,
]
class EPD_4in2:
def __init__(self):
self.reset_pin = Pin(RST_PIN, Pin.OUT)
self.busy_pin = Pin(BUSY_PIN, Pin.IN, Pin.PULL_UP)
self.cs_pin = Pin(CS_PIN, Pin.OUT)
self.width = EPD_WIDTH
self.height = EPD_HEIGHT
self.lut_vcom0 = EPD_4IN2_lut_vcom0
self.lut_ww = EPD_4IN2_lut_ww
self.lut_bw = EPD_4IN2_lut_bw
self.lut_wb = EPD_4IN2_lut_wb
self.lut_bb = EPD_4IN2_lut_bb
self.lut_Partial_vcom = EPD_4IN2_Partial_lut_vcom1
self.lut_Partial_ww = EPD_4IN2_Partial_lut_ww1
self.lut_Partial_bw = EPD_4IN2_Partial_lut_bw1
self.lut_Partial_wb = EPD_4IN2_Partial_lut_wb1
self.lut_Partial_bb = EPD_4IN2_Partial_lut_bb1
self.lut_4Gray_vcom = EPD_4IN2_4Gray_lut_vcom
self.lut_4Gray_ww = EPD_4IN2_4Gray_lut_ww
self.lut_4Gray_bw = EPD_4IN2_4Gray_lut_bw
self.lut_4Gray_wb = EPD_4IN2_4Gray_lut_wb
self.lut_4Gray_bb = EPD_4IN2_4Gray_lut_bb
self.black = 0x00
self.white = 0xff
self.darkgray = 0xaa
self.grayish = 0x55
self.spi = SPI(1)
self.spi.init(baudrate=4000_000)
self.dc_pin = Pin(DC_PIN, Pin.OUT)
self.buffer_1Gray_DATA = [0x00] * (self.height * self.width // 8)
self.buffer_1Gray = bytearray(self.height * self.width // 8)
self.buffer_4Gray = bytearray(self.height * self.width // 4)
self.image1Gray = framebuf.FrameBuffer(self.buffer_1Gray, self.width, self.height, framebuf.MONO_HLSB)
self.image4Gray = framebuf.FrameBuffer(self.buffer_4Gray, self.width, self.height, framebuf.GS2_HMSB)
self.EPD_4IN2_Init_4Gray()
self.EPD_4IN2_Clear()
utime.sleep_ms(500)
def digital_write(self, pin, value):
pin.value(value)
def digital_read(self, pin):
return pin.value()
def delay_ms(self, delaytime):
utime.sleep(delaytime / 1000.0)
def spi_writebyte(self, data):
self.spi.write(bytearray(data))
def module_exit(self):
self.digital_write(self.reset_pin, 0)
# Hardware reset
def reset(self):
self.digital_write(self.reset_pin, 1)
self.delay_ms(20)
self.digital_write(self.reset_pin, 0)
self.delay_ms(2)
self.digital_write(self.reset_pin, 1)
self.delay_ms(20)
self.digital_write(self.reset_pin, 0)
self.delay_ms(2)
self.digital_write(self.reset_pin, 1)
self.delay_ms(20)
self.digital_write(self.reset_pin, 0)
self.delay_ms(2)
self.digital_write(self.reset_pin, 1)
self.delay_ms(20)
def send_command(self, command):
self.digital_write(self.dc_pin, 0)
self.digital_write(self.cs_pin, 0)
self.spi_writebyte([command])
self.digital_write(self.cs_pin, 1)
def send_data(self, data):
self.digital_write(self.dc_pin, 1)
self.digital_write(self.cs_pin, 0)
self.spi_writebyte([data])
self.digital_write(self.cs_pin, 1)
def send_data1(self, buf):
self.digital_write(self.dc_pin, 1)
self.digital_write(self.cs_pin, 0)
self.spi.write(bytearray(buf))
self.digital_write(self.cs_pin, 1)
def ReadBusy(self):
print("e-Paper busy")
while(self.digital_read(self.busy_pin) == 0): # LOW: idle, HIGH: busy
self.send_command(0x71)
self.delay_ms(100)
print("e-Paper busy release")
def TurnOnDisplay(self):
self.send_command(0x12)
self.delay_ms(100)
self.ReadBusy()
def EPD_4IN2_SetLut(self):
self.send_command(0x20)
self.send_data1(self.lut_vcom0[0:36])
self.send_command(0x21)
self.send_data1(self.lut_ww[0:36])
self.send_command(0x22)
self.send_data1(self.lut_bw[0:36])
self.send_command(0x23)
self.send_data1(self.lut_wb[0:36])
self.send_command(0x24)
self.send_data1(self.lut_bb[0:36])
def EPD_4IN2_Partial_SetLut(self):
self.send_command(0x20)
self.send_data1(self.lut_Partial_vcom[0:44])
self.send_command(0x21)
self.send_data1(self.lut_Partial_ww[0:42])
self.send_command(0x22)
self.send_data1(self.lut_Partial_bw[0:42])
self.send_command(0x23)
self.send_data1(self.lut_Partial_wb[0:42])
self.send_command(0x24)
self.send_data1(self.lut_Partial_bb[0:42])
def EPD_4IN2_4Gray_lut(self):
self.send_command(0x20)
self.send_data1(self.lut_4Gray_vcom[0:42])
self.send_command(0x21)
self.send_data1(self.lut_4Gray_ww[0:42])
self.send_command(0x22)
self.send_data1(self.lut_4Gray_bw[0:42])
self.send_command(0x23)
self.send_data1(self.lut_4Gray_wb[0:42])
self.send_command(0x24)
self.send_data1(self.lut_4Gray_bb[0:42])
self.send_command(0x25)
self.send_data1(self.lut_4Gray_ww[0:42])
def EPD_4IN2_Init(self):
self.reset()
self.send_command(0x01) # POWER SETTING
self.send_data(0x03)
self.send_data(0x00)
self.send_data(0x2b)
self.send_data(0x2b)
self.send_command(0x06) # boost soft start
self.send_data(0x17) # A
self.send_data(0x17) # B
self.send_data(0x17) # C
self.send_command(0x04) # POWER_ON
self.ReadBusy()
self.send_command(0x00) # panel setting
self.send_data(0xbf) # KW-BF KWR-AF BWROTP 0f BWOTP 1f
self.send_data(0x0d)
self.send_command(0x30) # PLL setting
self.send_data(0x3C) # 3A 100HZ 29 150Hz 39 200HZ 31 171HZ
self.send_command(0x61) # resolution setting
self.send_data(0x01)
self.send_data(0x90) # 128
self.send_data(0x01)
self.send_data(0x2c)
self.send_command(0x82) # vcom_DC setting
self.send_data(0x28)
self.send_command(0X50) # VCOM AND DATA INTERVAL SETTING
self.send_data(0x97) # 97white border 77black border VBDF 17|D7 VBDW 97 VBDB 57 VBDF F7 VBDW 77 VBDB 37 VBDR B7
self.EPD_4IN2_SetLut()
def EPD_4IN2_Init_4Gray(self):
self.reset();
self.send_command(0x01) # POWER SETTING
self.send_data (0x03)
self.send_data (0x00) # VGH=20V,VGL=-20V
self.send_data (0x2b) # VDH=15V
self.send_data (0x2b) # VDL=-15V
self.send_data (0x13)
self.send_command(0x06) # booster soft start
self.send_data (0x17) # A
self.send_data (0x17) # B
self.send_data (0x17) # C
self.send_command(0x04)
self.ReadBusy()
self.send_command(0x00) # panel setting
self.send_data(0x3f) # KW-3f KWR-2F BWROTP 0f BWOTP 1f
self.send_command(0x30) # PLL setting
self.send_data (0x3c) # 100hz
self.send_command(0x61) # resolution setting
self.send_data (0x01) # 400
self.send_data (0x90)
self.send_data (0x01) # 300
self.send_data (0x2c)
self.send_command(0x82) # vcom_DC setting
self.send_data (0x12)
self.send_command(0X50) # VCOM AND DATA INTERVAL SETTING
self.send_data(0x97)
def EPD_4IN2_Clear(self):
high = self.height
if( self.width % 8 == 0) :
wide = self.width // 8
else :
wide = self.width // 8 + 1
self.send_command(0x10)
for i in range(0, wide):
self.send_data1([0xff] * high)
self.send_command(0x13)
for i in range(0, wide):
self.send_data1([0xff] * high)
self.send_command(0x12)
self.delay_ms(10)
self.TurnOnDisplay()
def EPD_4IN2_Display(self,Image):
self.send_command(0x13)
self.send_data1(Image)
self.TurnOnDisplay()
def EPD_4IN2_PartialDisplay(self,X_start,Y_start,X_wide,Y_high,Image):
high = self.height
if( self.width % 8 == 0) :
wide = self.width // 8
else :
wide = self.width // 8 + 1
if( X_start % 8 != 0) :
X_start = X_start // 8 * 8 + 8
if( X_wide % 8 != 0) :
X_wide = X_wide // 8 * 8 +8
X_end = X_start + X_wide
Y_end = Y_start + Y_high
self.send_command(0X50);
self.send_data(0xf7);
self.delay_ms(100);
self.send_command(0x82) # vcom_DC setting
self.send_data (0x08)
self.send_command(0X50)
self.send_data(0x47)
self.EPD_4IN2_Partial_SetLut()
self.send_command(0x91) # This command makes the display enter partial mode
self.send_command(0x90) # resolution setting
self.send_data (int(X_start/256))
self.send_data (int(X_start)%256) # x-start
self.send_data (int(X_end/256))
self.send_data (int(X_end)%256-1) # x-end
self.send_data (int(Y_start/256))
self.send_data (Y_start%256) # y-start
self.send_data (int(Y_end/256))
self.send_data (Y_end%256-1) # y-end
self.send_data (0x28)
self.send_command(0x10); #writes Old data to SRAM for programming
for j in range(0, Y_high):
for i in range(0, int(X_wide/8)):
self.send_data(self.buffer_1Gray_DATA[(Y_start + j)*wide + int(X_start/8) + i]);
self.send_command(0x13); #writes New data to SRAM.
for j in range(0, Y_high):
for i in range(0, int(X_wide/8)):
self.send_data(~Image[(Y_start + j)*wide + int(X_start/8) + i]);
self.buffer_1Gray_DATA[(Y_start + j)*wide + int(X_start/8) + i] = ~Image[(Y_start + j)*wide + int(X_start/8) + i]
self.send_command(0x12) # DISPLAY REFRESH
self.delay_ms(10) # The delay here is necessary, 200uS at least!!!
self.TurnOnDisplay()
def EPD_4IN2_4GrayDisplay(self,Image):
self.send_command(0x10)
for i in range(0, 15000):
temp3=0
for j in range(0, 2):
temp1 = Image[i*2+j]
for k in range(0, 2):
temp2 = temp1&0x03
if(temp2 == 0x03):
temp3 |= 0x01 # white
elif(temp2 == 0x00):
temp3 |= 0x00 # black
elif(temp2 == 0x02):
temp3 |= 0x00 # gray1
else: # 0x01
temp3 |= 0x01 # gray2
temp3 <<= 1
temp1 >>= 2
temp2 = temp1&0x03
if(temp2 == 0x03): # white
temp3 |= 0x01;
elif(temp2 == 0x00): # black
temp3 |= 0x00;
elif(temp2 == 0x02):
temp3 |= 0x00 # gray1
else: # 0x01
temp3 |= 0x01 # gray2
if (( j!=1 ) | ( k!=1 )):
temp3 <<= 1
temp1 >>= 2
self.send_data(temp3)
self.send_command(0x13)
for i in range(0, 15000):
temp3=0
for j in range(0, 2):
temp1 = Image[i*2+j]
for k in range(0, 2):
temp2 = temp1&0x03
if(temp2 == 0x03):
temp3 |= 0x01 # white
elif(temp2 == 0x00):
temp3 |= 0x00 # black
elif(temp2 == 0x02):
temp3 |= 0x01 # gray1
else: # 0x01
temp3 |= 0x00 # gray2
temp3 <<= 1
temp1 >>= 2
temp2 = temp1&0x03
if(temp2 == 0x03): # white
temp3 |= 0x01;
elif(temp2 == 0x00): # black
temp3 |= 0x00;
elif(temp2 == 0x02):
temp3 |= 0x01 # gray1
else: # 0x01
temp3 |= 0x00 # gray2
if (( j!=1 ) | ( k!=1 )):
temp3 <<= 1
temp1 >>= 2
self.send_data(temp3)
self.EPD_4IN2_4Gray_lut()
self.TurnOnDisplay()
def Sleep(self):
# self.send_command(0X02) # power off
# self.ReadBusy()
self.send_command(0X07) # deep sleep
self.send_data(0xA5)
if __name__=='__main__':
epd = EPD_4in2()
epd.image1Gray.fill(0xff)
epd.image4Gray.fill(0xff)
epd.image4Gray.text("Waveshare", 5, 10, epd.black)
epd.image4Gray.text("Pico_ePaper-4.2", 5, 40, epd.black)
epd.image4Gray.text("Raspberry Pico", 5, 70, epd.black)
epd.EPD_4IN2_4GrayDisplay(epd.buffer_4Gray)
epd.delay_ms(500)
epd.image4Gray.vline(10, 90, 60, epd.black)
epd.image4Gray.vline(90, 90, 60, epd.black)
epd.image4Gray.hline(10, 90, 80, epd.black)
epd.image4Gray.hline(10, 150, 80, epd.black)
epd.image4Gray.line(10, 90, 90, 150, epd.black)
epd.image4Gray.line(90, 90, 10, 150, epd.black)
epd.EPD_4IN2_4GrayDisplay(epd.buffer_4Gray)
epd.delay_ms(500)
epd.image4Gray.rect(10, 180, 50, 80, epd.black)
epd.image4Gray.fill_rect(70, 180, 50, 80, epd.black)
epd.EPD_4IN2_4GrayDisplay(epd.buffer_4Gray)
epd.delay_ms(500)
epd.image4Gray.fill_rect(150, 10, 250, 30, epd.black)
epd.image4Gray.text('GRAY1 with black background',155, 21, epd.white)
epd.image4Gray.text('GRAY2 with white background',155, 51, epd.grayish)
epd.image4Gray.text('GRAY3 with white background',155, 81, epd.darkgray)
epd.image4Gray.text('GRAY4 with white background',155, 111, epd.black)
epd.EPD_4IN2_4GrayDisplay(epd.buffer_4Gray)
epd.delay_ms(500)
# print("Support for partial refresh, but the refresh effect is not good, but it is not recommended\r\n")
# print("Partial refresh\r\n")
# epd.EPD_4IN2_Init()
# for i in range(0, 10):
# print(str(i))
# epd.image1Gray.fill_rect(0, 200, 10, 10, epd.white)
# epd.image1Gray.text(str(i), 2, 201, epd.black)
# epd.EPD_4IN2_PartialDisplay(0, 200, 10, 10, epd.buffer_1Gray)
epd.EPD_4IN2_Init()
epd.EPD_4IN2_Clear()
epd.Sleep()