123456789101112131415161718192021222324252627282930313233343536373839404142434445464748495051525354555657585960616263646566676869707172737475767778798081828384858687888990919293949596979899100101102103104105106107108109110111112113114115116117118119120121122123124125126127128129130131132133134135136137138139140141142143144145146147148149150151152153154155156157158159160161162163164165166167168169170171172173174175176177178179180181182183184185186187188189190191192193194195196197198199200201202203204205206207208209210211212213214215216217218219220221222223224225226227228229230231232233234235236237238239240241242243244245246247248249250251252253254255256257258259260261262263264265266267268269270271272273274275276277278279280281282283284285286287288289290291292293294295296297298299300301302303304305306307308309310311312313314315316317318319320321322323324325326327328329330331332333334335336337338339340341342343344345346347348349350351352353354355356357358359360361362363364365366367368369370371372373374375376377378379380381382383384385386387388389390391392393394395396397 |
- # *****************************************************************************
- # * | File : epd2in13_V3.py
- # * | Author : Waveshare team
- # * | Function : Electronic paper driver
- # * | Info :
- # *----------------
- # * | This version: V1.1
- # * | Date : 2021-10-30
- # # | 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.
- #
- import logging
- from . import epdconfig
- import numpy as np
- # Display resolution
- EPD_WIDTH = 122
- EPD_HEIGHT = 250
- logger = logging.getLogger(__name__)
- class EPD:
- def __init__(self):
- self.reset_pin = epdconfig.RST_PIN
- self.dc_pin = epdconfig.DC_PIN
- self.busy_pin = epdconfig.BUSY_PIN
- self.cs_pin = epdconfig.CS_PIN
- self.width = EPD_WIDTH
- self.height = EPD_HEIGHT
-
- lut_partial_update= [
- 0x0,0x40,0x0,0x0,0x0,0x0,0x0,0x0,0x0,0x0,0x0,0x0,
- 0x80,0x80,0x0,0x0,0x0,0x0,0x0,0x0,0x0,0x0,0x0,0x0,
- 0x40,0x40,0x0,0x0,0x0,0x0,0x0,0x0,0x0,0x0,0x0,0x0,
- 0x0,0x80,0x0,0x0,0x0,0x0,0x0,0x0,0x0,0x0,0x0,0x0,
- 0x0,0x0,0x0,0x0,0x0,0x0,0x0,0x0,0x0,0x0,0x0,0x0,
- 0x14,0x0,0x0,0x0,0x0,0x0,0x0,
- 0x1,0x0,0x0,0x0,0x0,0x0,0x0,
- 0x1,0x0,0x0,0x0,0x0,0x0,0x0,
- 0x0,0x0,0x0,0x0,0x0,0x0,0x0,
- 0x0,0x0,0x0,0x0,0x0,0x0,0x0,
- 0x0,0x0,0x0,0x0,0x0,0x0,0x0,
- 0x0,0x0,0x0,0x0,0x0,0x0,0x0,
- 0x0,0x0,0x0,0x0,0x0,0x0,0x0,
- 0x0,0x0,0x0,0x0,0x0,0x0,0x0,
- 0x0,0x0,0x0,0x0,0x0,0x0,0x0,
- 0x0,0x0,0x0,0x0,0x0,0x0,0x0,
- 0x0,0x0,0x0,0x0,0x0,0x0,0x0,
- 0x22,0x22,0x22,0x22,0x22,0x22,0x0,0x0,0x0,
- 0x22,0x17,0x41,0x00,0x32,0x36,
- ]
- lut_full_update = [
- 0x80,0x4A,0x40,0x0,0x0,0x0,0x0,0x0,0x0,0x0,0x0,0x0,
- 0x40,0x4A,0x80,0x0,0x0,0x0,0x0,0x0,0x0,0x0,0x0,0x0,
- 0x80,0x4A,0x40,0x0,0x0,0x0,0x0,0x0,0x0,0x0,0x0,0x0,
- 0x40,0x4A,0x80,0x0,0x0,0x0,0x0,0x0,0x0,0x0,0x0,0x0,
- 0x0,0x0,0x0,0x0,0x0,0x0,0x0,0x0,0x0,0x0,0x0,0x0,
- 0xF,0x0,0x0,0x0,0x0,0x0,0x0,
- 0xF,0x0,0x0,0xF,0x0,0x0,0x2,
- 0xF,0x0,0x0,0x0,0x0,0x0,0x0,
- 0x1,0x0,0x0,0x0,0x0,0x0,0x0,
- 0x0,0x0,0x0,0x0,0x0,0x0,0x0,
- 0x0,0x0,0x0,0x0,0x0,0x0,0x0,
- 0x0,0x0,0x0,0x0,0x0,0x0,0x0,
- 0x0,0x0,0x0,0x0,0x0,0x0,0x0,
- 0x0,0x0,0x0,0x0,0x0,0x0,0x0,
- 0x0,0x0,0x0,0x0,0x0,0x0,0x0,
- 0x0,0x0,0x0,0x0,0x0,0x0,0x0,
- 0x0,0x0,0x0,0x0,0x0,0x0,0x0,
- 0x22,0x22,0x22,0x22,0x22,0x22,0x0,0x0,0x0,
- 0x22,0x17,0x41,0x0,0x32,0x36,
- ]
-
- '''
- function :Hardware reset
- parameter:
- '''
- def reset(self):
- epdconfig.digital_write(self.reset_pin, 1)
- epdconfig.delay_ms(20)
- epdconfig.digital_write(self.reset_pin, 0)
- epdconfig.delay_ms(2)
- epdconfig.digital_write(self.reset_pin, 1)
- epdconfig.delay_ms(20)
- '''
- function :send command
- parameter:
- command : Command register
- '''
- def send_command(self, command):
- epdconfig.digital_write(self.dc_pin, 0)
- epdconfig.digital_write(self.cs_pin, 0)
- epdconfig.spi_writebyte([command])
- epdconfig.digital_write(self.cs_pin, 1)
- '''
- function :send data
- parameter:
- data : Write data
- '''
- def send_data(self, data):
- epdconfig.digital_write(self.dc_pin, 1)
- epdconfig.digital_write(self.cs_pin, 0)
- epdconfig.spi_writebyte([data])
- epdconfig.digital_write(self.cs_pin, 1)
-
- '''
- function :Wait until the busy_pin goes LOW
- parameter:
- '''
- def ReadBusy(self):
- logger.debug("e-Paper busy")
- while(epdconfig.digital_read(self.busy_pin) == 1): # 0: idle, 1: busy
- epdconfig.delay_ms(10)
- logger.debug("e-Paper busy release")
- '''
- function : Turn On Display
- parameter:
- '''
- def TurnOnDisplay(self):
- self.send_command(0x22) # Display Update Control
- self.send_data(0xC7)
- self.send_command(0x20) # Activate Display Update Sequence
- self.ReadBusy()
-
- '''
- function : Turn On Display Part
- parameter:
- '''
- def TurnOnDisplayPart(self):
- self.send_command(0x22) # Display Update Control
- self.send_data(0x0f) # fast:0x0c, quality:0x0f, 0xcf
- self.send_command(0x20) # Activate Display Update Sequence
- self.ReadBusy()
-
- '''
- function : Set lut
- parameter:
- lut : lut data
- '''
- def Lut(self, lut):
- self.send_command(0x32)
- for i in range(0, 153):
- self.send_data(lut[i])
- self.ReadBusy()
-
- '''
- function : Send lut data and configuration
- parameter:
- lut : lut data
- '''
- def SetLut(self, lut):
- self.Lut(lut)
- self.send_command(0x3f)
- self.send_data(lut[153])
- self.send_command(0x03) # gate voltage
- self.send_data(lut[154])
- self.send_command(0x04) # source voltage
- self.send_data(lut[155]) # VSH
- self.send_data(lut[156]) # VSH2
- self.send_data(lut[157]) # VSL
- self.send_command(0x2c) # VCOM
- self.send_data(lut[158])
-
- '''
- function : Setting the display window
- parameter:
- xstart : X-axis starting position
- ystart : Y-axis starting position
- xend : End position of X-axis
- yend : End position of Y-axis
- '''
- def SetWindow(self, x_start, y_start, x_end, y_end):
- self.send_command(0x44) # SET_RAM_X_ADDRESS_START_END_POSITION
- # x point must be the multiple of 8 or the last 3 bits will be ignored
- self.send_data((x_start>>3) & 0xFF)
- self.send_data((x_end>>3) & 0xFF)
-
- self.send_command(0x45) # SET_RAM_Y_ADDRESS_START_END_POSITION
- self.send_data(y_start & 0xFF)
- self.send_data((y_start >> 8) & 0xFF)
- self.send_data(y_end & 0xFF)
- self.send_data((y_end >> 8) & 0xFF)
- '''
- function : Set Cursor
- parameter:
- x : X-axis starting position
- y : Y-axis starting position
- '''
- def SetCursor(self, x, y):
- self.send_command(0x4E) # SET_RAM_X_ADDRESS_COUNTER
- # x point must be the multiple of 8 or the last 3 bits will be ignored
- self.send_data(x & 0xFF)
-
- self.send_command(0x4F) # SET_RAM_Y_ADDRESS_COUNTER
- self.send_data(y & 0xFF)
- self.send_data((y >> 8) & 0xFF)
-
- '''
- function : Initialize the e-Paper register
- parameter:
- '''
- def init(self):
- if (epdconfig.module_init() != 0):
- return -1
- # EPD hardware init start
- self.reset()
-
- self.ReadBusy()
- self.send_command(0x12) #SWRESET
- self.ReadBusy()
- self.send_command(0x01) #Driver output control
- self.send_data(0xf9)
- self.send_data(0x00)
- self.send_data(0x00)
-
- self.send_command(0x11) #data entry mode
- self.send_data(0x03)
- self.SetWindow(0, 0, self.width-1, self.height-1)
- self.SetCursor(0, 0)
-
- self.send_command(0x3c)
- self.send_data(0x05)
- self.send_command(0x21) # Display update control
- self.send_data(0x00)
- self.send_data(0x80)
-
- self.send_command(0x18)
- self.send_data(0x80)
-
- self.ReadBusy()
-
- self.SetLut(self.lut_full_update)
- return 0
- '''
- function : Display images
- parameter:
- image : Image data
- '''
- def getbuffer(self, image):
- img = image
- imwidth, imheight = img.size
- if(imwidth == self.width and imheight == self.height):
- img = img.convert('1')
- elif(imwidth == self.height and imheight == self.width):
- # image has correct dimensions, but needs to be rotated
- img = img.rotate(90, expand=True).convert('1')
- else:
- logger.warning("Wrong image dimensions: must be " + str(self.width) + "x" + str(self.height))
- # return a blank buffer
- return [0x00] * (int(self.width/8) * self.height)
- buf = bytearray(img.tobytes('raw'))
- return buf
-
- '''
- function : Sends the image buffer in RAM to e-Paper and displays
- parameter:
- image : Image data
- '''
- def display(self, image):
- if self.width%8 == 0:
- linewidth = int(self.width/8)
- else:
- linewidth = int(self.width/8) + 1
- self.send_command(0x24)
- for j in range(0, self.height):
- for i in range(0, linewidth):
- self.send_data(image[i + j * linewidth])
- self.TurnOnDisplay()
-
- '''
- function : Sends the image buffer in RAM to e-Paper and partial refresh
- parameter:
- image : Image data
- '''
- def displayPartial(self, image):
- if self.width%8 == 0:
- linewidth = int(self.width/8)
- else:
- linewidth = int(self.width/8) + 1
- epdconfig.digital_write(self.reset_pin, 0)
- epdconfig.delay_ms(1)
- epdconfig.digital_write(self.reset_pin, 1)
-
- self.SetLut(self.lut_partial_update)
- self.send_command(0x37)
- self.send_data(0x00)
- self.send_data(0x00)
- self.send_data(0x00)
- self.send_data(0x00)
- self.send_data(0x00)
- self.send_data(0x40)
- self.send_data(0x00)
- self.send_data(0x00)
- self.send_data(0x00)
- self.send_data(0x00)
- self.send_command(0x3C) #BorderWavefrom
- self.send_data(0x80)
- self.send_command(0x22)
- self.send_data(0xC0)
- self.send_command(0x20)
- self.ReadBusy()
- self.SetWindow(0, 0, self.width - 1, self.height - 1)
- self.SetCursor(0, 0)
-
- self.send_command(0x24) # WRITE_RAM
- for j in range(0, self.height):
- for i in range(0, linewidth):
- self.send_data(image[i + j * linewidth])
- self.TurnOnDisplayPart()
- '''
- function : Refresh a base image
- parameter:
- image : Image data
- '''
- def displayPartBaseImage(self, image):
- if self.width%8 == 0:
- linewidth = int(self.width/8)
- else:
- linewidth = int(self.width/8) + 1
- self.send_command(0x24)
- for j in range(0, self.height):
- for i in range(0, linewidth):
- self.send_data(image[i + j * linewidth])
-
- self.send_command(0x26)
- for j in range(0, self.height):
- for i in range(0, linewidth):
- self.send_data(image[i + j * linewidth])
- self.TurnOnDisplay()
-
- '''
- function : Clear screen
- parameter:
- '''
- def Clear(self, color):
- if self.width%8 == 0:
- linewidth = int(self.width/8)
- else:
- linewidth = int(self.width/8) + 1
- # logger.debug(linewidth)
-
- self.send_command(0x24)
- for j in range(0, self.height):
- for i in range(0, linewidth):
- self.send_data(color)
-
- self.TurnOnDisplay()
- '''
- function : Enter sleep mode
- parameter:
- '''
- def sleep(self):
- self.send_command(0x10) #enter deep sleep
- self.send_data(0x01)
-
- epdconfig.delay_ms(2000)
- epdconfig.module_exit()
- ### END OF FILE ###
|