1.02inch e-ink display issue - black frame remain after reset

[shlomogithub]

Hi,
Here is the link to the screen: https://www.waveshare.com/product/displays/e-paper/epaper-3/1.02inch-e-paper-module.htm
The github link from the manufacture doesn't have a micropython code for that screen, only python code for RPi,
So I modified the python code to micropython and it's working, however, a black frame remain on the screen after the reset code,
Here is my code:

from machine import Pin, SPI
import framebuf
import utime

# Display resolution
EPD_WIDTH       = 80
EPD_HEIGHT      = 128

RST_PIN         = 12
DC_PIN          = 8
CS_PIN          = 9
BUSY_PIN        = 13

class EPD_1in02(framebuf.FrameBuffer):
    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.spi = SPI(1)
        self.spi.init(baudrate=4000_000)
        self.dc_pin = Pin(DC_PIN, Pin.OUT)
        
        
        self.buffer = bytearray(self.height * self.width // 8)
        super().__init__(self.buffer, self.width, self.height, framebuf.MONO_HLSB)
        self.Init()
        
    lut_w1 =[
        0x60,  0x5A,  0x5A,  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,  
    ]

    lut_b1 =[
        0x90,  0x5A,  0x5A,  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,  
    ]

    # partial screen update LUT
    lut_w = [
        0x60,  0x01,  0x01,  0x00,  0x00,  0x01,  
        0x80,  0x1f,  0x00,  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,  
    ]

    lut_b = [
        0x90,  0x01,  0x01,  0x00,  0x00,  0x01,  
        0x40,  0x1f,  0x00,  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,  
    ]

    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(200) 
        self.digital_write(self.reset_pin, 0)         # module reset
        self.delay_ms(2)
        self.digital_write(self.reset_pin, 1)
        self.delay_ms(200)   

    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 ReadBusy(self):
        print("e-Paper busy")
        self.send_command(0x71)
        busy = self.digital_read(self.busy_pin)
        busy = not(busy & 0x01)
        while(busy):
            self.send_command(0x71)
            busy = self.digital_read(self.busy_pin)
            busy =not(busy & 0x01)
        self.delay_ms(800)
        print("e-Paper busy release")        

    def TurnOnDisplay(self):
        self.send_command(0x12)
        self.delay_ms(10)
        self.ReadBusy()

    def SetFulltReg(self):
        self.send_command(0x23)
        for count in range(0, 42):
            self.send_data(self.lut_w1[count]) 
        
        self.send_command(0x24)
        for count in range(0, 42):
            self.send_data(self.lut_b1[count])     

    def SetPartReg(self):
        self.send_command(0x23)
        for count in range(0, 42):
            self.send_data(self.lut_w[count]) 
        
        self.send_command(0x24)
        for count in range(0, 42):
            self.send_data(self.lut_b[count])     

    def Init(self):
        # EPD hardware init start
        self.reset()
        
        self.send_command(0xD2)			
        self.send_data(0x3F)

        self.send_command(0x00)  			
        self.send_data (0x6F)  #from outside

        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)  #Configuring the charge pump
        self.send_data(0x3f)

        self.send_command(0x2A)  #Setting XON and the options of LUT
        self.send_data(0x00) 
        self.send_data(0x00) 

        self.send_command(0x30)  #Set the clock frequency
        self.send_data(0x17) #50Hz

        self.send_command(0x50)  #Set VCOM and data output interval
        self.send_data(0x57)			

        self.send_command(0x60)  #Set The non-overlapping period of Gate and Source.
        self.send_data(0x22)

        self.send_command(0x61)  #resolution setting
        self.send_data (0x50)    #source 128 	 
        self.send_data (0x80)       

        self.send_command(0x82)  #sets VCOM_DC value
        self.send_data(0x12)  #-1v

        self.send_command(0xe3)#Set POWER SAVING
        self.send_data(0x33)
        self.SetFulltReg()	
        self.send_command(0x04)     		#power on
        self.ReadBusy()
        # EPD hardware init end
        return 0
    
    def Partial_Init(self):
        self.reset()
        
        self.send_command(0xD2)
        self.send_data(0x3F)

        self.send_command(0x00)
        self.send_data (0x6F)  #from outside

        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)  #Configuring the charge pump
        self.send_data(0x3f)

        self.send_command(0x2A)  #Setting XON and the options of LUT
        self.send_data(0x00)
        self.send_data(0x00)

        self.send_command(0x30)  #Set the clock frequency
        self.send_data(0x17)

        self.send_command(0x50)  #Set VCOM and data output interval
        self.send_data(0xf2)

        self.send_command(0x60)  #Set The non-overlapping period of Gate and Source.
        self.send_data(0x22)

        self.send_command(0x82)  #Set VCOM_DC value
        self.send_data(0x12)#-1v

        self.send_command(0xe3)#Set POWER SAVING
        self.send_data(0x33)

        self.SetPartReg()	

        self.send_command(0x04)#Set POWER SAVING	
        self.ReadBusy()
        # EPD hardware init end
        return 0
    
    def getbuffer(self, image):
        buf = [0xFF] * (int(self.width / 8) * self.height)
        image_monocolor = image.convert('1')
        imwidth, imheight = image_monocolor.size
        pixels = image_monocolor.load()
        if(imwidth == self.width and imheight == self.height):
            print("Horizontal")
            for y in range(imheight):
                for x in range(imwidth):
                    # Set the bits for the column of pixels at the current position.
                    if pixels[x, y] == 0:
                        buf[int((x + y * self.width) / 8)] &= ~(0x80 >> (x % 8))
        elif(imwidth == self.height and imheight == self.width):
            print("Vertical")
            for y in range(imheight):
                for x in range(imwidth):
                    newx = y
                    newy = self.height - x - 1
                    if pixels[x, y] == 0:
                        buf[int((newx + newy*self.width) / 8)] &= ~(0x80 >> (y % 8))
        return buf

    def display(self, image):
        if (image == None):
            return
        # Width = (self.width % 8 == 0)? (self.width // 8 ): (self.width // 8 + 1)
        if(self.width % 8 == 0):
            Width = self.width // 8
        else:
            Width = self.width // 8 + 1
            
        self.send_command(0x10)
        for j in range(0, self.height):
            for i in range(0, int(Width)):
                self.send_data(0xff)  
        
        self.send_command(0x13)
        for j in range(0, self.height):
            for i in range(0, int(Width)):
                self.send_data(image[i + j * int(Width)])  
        self.TurnOnDisplay()
        
    def Clear(self):
        # Width = (self.width % 8 == 0)? (self.width // 8 ): (self.width // 8 + 1)
        if(self.width % 8 == 0):
            Width = self.width // 8 + 1
        else:
            Width = self.width // 8 + 2
            
        Height = self.height + 2
        
        self.send_command(0x10)
        for j in range(0, Height):
            for i in range(0, int(Width)):
                self.send_data(0x00)  
        
        self.send_command(0x13)
        for j in range(0, Height):
            for i in range(0, int(Width)):
                self.send_data(0xff)  
        self.TurnOnDisplay()

    def DisplayPartial(self, old_Image, Image):

        # Set partial Windows */
        self.send_command(0x91)		#This command makes the display enter partial mode
        self.send_command(0x90)		#resolution setting
        self.send_data(0)           #x-start
        self.send_data(79)       #x-end

        self.send_data(0)
        self.send_data(127)  #y-end
        self.send_data(0x00)
       
        # Width = (self.width % 8 == 0)? (self.width // 8 ): (self.width // 8 + 1)
        if(self.width % 8 == 0):
            Width = self.width // 8
        else:
            Width = self.width // 8 + 1
            
        Height = self.height
        # send data
        self.send_command(0x10)
        for j in range(0, Height):
            for i in range(0, int(Width)):
                self.send_data(old_Image[i + j * int(Width)])

        self.send_command(0x13)
        for j in range(0, Height):
            for i in range(0, int(Width)):
                self.send_data(Image[i + j * int(Width)])

        # Set partial refresh
        self.TurnOnDisplay()

    def Sleep(self):
        self.send_command(0x50)
        self.send_data(0xf7)
        self.send_command(0x02)
        self.ReadBusy()
        self.send_command(0x07)
        self.send_data(0xA5)
        self.delay_ms(200)

        self.delay_ms(2000)
        self.module_exit()
        
        
if __name__=='__main__':
    epd = EPD_1in02()
    epd.Init()
    epd.Clear()
    epd.fill(0xff)
    epd.text("Hello!", 10, 20, 0x00)
    epd.display(epd.buffer)
    epd.delay_ms(2000)
    epd.Clear()
    epd.Sleep()

Please advise,
Thank you.

[peterhinch]

I encountered a similar issue with a different display. See code comments and Adafuit issue. Maybe there is something which might help you.