/***************************************************************************** * | File : EPD_2in9_V2.c * | Author : Waveshare team * | Function : 2.9inch e-paper V2 * | Info : *---------------- * | This version: V1.1 * | Date : 2023-08-30 * | Info : * ----------------------------------------------------------------------------- # # 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. # ******************************************************************************/ #include "EPD_2in9_V2.h" #include "Debug.h" UBYTE _WF_PARTIAL_2IN9[159] = { 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, 0x0A,0x0,0x0,0x0,0x0,0x0,0x2, 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,0xB0,0x32,0x36, }; UBYTE WS_20_30[159] = { 0x80, 0x66, 0x0, 0x0, 0x0, 0x0, 0x0, 0x0, 0x40, 0x0, 0x0, 0x0, 0x10, 0x66, 0x0, 0x0, 0x0, 0x0, 0x0, 0x0, 0x20, 0x0, 0x0, 0x0, 0x80, 0x66, 0x0, 0x0, 0x0, 0x0, 0x0, 0x0, 0x40, 0x0, 0x0, 0x0, 0x10, 0x66, 0x0, 0x0, 0x0, 0x0, 0x0, 0x0, 0x20, 0x0, 0x0, 0x0, 0x0, 0x0, 0x0, 0x0, 0x0, 0x0, 0x0, 0x0, 0x0, 0x0, 0x0, 0x0, 0x14, 0x8, 0x0, 0x0, 0x0, 0x0, 0x1, 0xA, 0xA, 0x0, 0xA, 0xA, 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, 0x14, 0x8, 0x0, 0x1, 0x0, 0x0, 0x1, 0x0, 0x0, 0x0, 0x0, 0x0, 0x0, 0x1, 0x0, 0x0, 0x0, 0x0, 0x0, 0x0, 0x0, 0x0, 0x0, 0x0, 0x0, 0x0, 0x0, 0x0, 0x44, 0x44, 0x44, 0x44, 0x44, 0x44, 0x0, 0x0, 0x0, 0x22, 0x17, 0x41, 0x0, 0x32, 0x36 }; unsigned char Gray4[159] = { 0x00, 0x60, 0x00, 0x00, 0x00, 0x00, 0x00, 0x00, 0x00, 0x00, 0x00, 0x00, //VS L0 //2.28s 0x20, 0x60, 0x10, 0x00, 0x00, 0x00, 0x00, 0x00, 0x00, 0x00, 0x00, 0x00, //VS L1 0x28, 0x60, 0x14, 0x00, 0x00, 0x00, 0x00, 0x00, 0x00, 0x00, 0x00, 0x00, //VS L2 0x2A, 0x60, 0x15, 0x00, 0x00, 0x00, 0x00, 0x00, 0x00, 0x00, 0x00, 0x00, //VS L3 0x00, 0x90, 0x00, 0x00, 0x00, 0x00, 0x00, 0x00, 0x00, 0x00, 0x00, 0x00, //VS L4 0x00, 0x02, 0x00, 0x05, 0x14, 0x00, 0x00, //TP, SR, RP of Group0 0x1E, 0x1E, 0x00, 0x00, 0x00, 0x00, 0x01, //TP, SR, RP of Group1 0x00, 0x02, 0x00, 0x05, 0x14, 0x00, 0x00, //TP, SR, RP of Group2 0x00, 0x00, 0x00, 0x00, 0x00, 0x00, 0x00, //TP, SR, RP of Group3 0x00, 0x00, 0x00, 0x00, 0x00, 0x00, 0x00, //TP, SR, RP of Group4 0x00, 0x00, 0x00, 0x00, 0x00, 0x00, 0x00, //TP, SR, RP of Group5 0x00, 0x00, 0x00, 0x00, 0x00, 0x00, 0x00, //TP, SR, RP of Group6 0x00, 0x00, 0x00, 0x00, 0x00, 0x00, 0x00, //TP, SR, RP of Group7 0x00, 0x00, 0x00, 0x00, 0x00, 0x00, 0x00, //TP, SR, RP of Group8 0x00, 0x00, 0x00, 0x00, 0x00, 0x00, 0x00, //TP, SR, RP of Group9 0x00, 0x00, 0x00, 0x00, 0x00, 0x00, 0x00, //TP, SR, RP of Group10 0x00, 0x00, 0x00, 0x00, 0x00, 0x00, 0x00, //TP, SR, RP of Group11 0x24, 0x22, 0x22, 0x22, 0x23, 0x32, 0x00, 0x00, 0x00, //FR, XON 0x22, 0x17, 0x41, 0xAE, 0x32, 0x28, //EOPT VGH VSH1 VSH2 VSL VCOM }; /****************************************************************************** function : Software reset parameter: ******************************************************************************/ static void EPD_2IN9_V2_Reset(void) { DEV_Digital_Write(EPD_RST_PIN, 1); DEV_Delay_ms(10); DEV_Digital_Write(EPD_RST_PIN, 0); DEV_Delay_ms(2); DEV_Digital_Write(EPD_RST_PIN, 1); DEV_Delay_ms(10); } /****************************************************************************** function : send command parameter: Reg : Command register ******************************************************************************/ static void EPD_2IN9_V2_SendCommand(UBYTE Reg) { DEV_Digital_Write(EPD_DC_PIN, 0); DEV_Digital_Write(EPD_CS_PIN, 0); DEV_SPI_WriteByte(Reg); DEV_Digital_Write(EPD_CS_PIN, 1); } /****************************************************************************** function : send data parameter: Data : Write data ******************************************************************************/ static void EPD_2IN9_V2_SendData(UBYTE Data) { DEV_Digital_Write(EPD_DC_PIN, 1); DEV_Digital_Write(EPD_CS_PIN, 0); DEV_SPI_WriteByte(Data); DEV_Digital_Write(EPD_CS_PIN, 1); } /****************************************************************************** function : Wait until the busy_pin goes LOW parameter: ******************************************************************************/ void EPD_2IN9_V2_ReadBusy(void) { Debug("e-Paper busy\r\n"); while(1) { //=1 BUSY if(DEV_Digital_Read(EPD_BUSY_PIN)==0) break; DEV_Delay_ms(50); } DEV_Delay_ms(50); Debug("e-Paper busy release\r\n"); } static void EPD_2IN9_V2_LUT(UBYTE *lut) { UBYTE count; EPD_2IN9_V2_SendCommand(0x32); for(count=0; count<153; count++) EPD_2IN9_V2_SendData(lut[count]); EPD_2IN9_V2_ReadBusy(); } static void EPD_2IN9_V2_LUT_by_host(UBYTE *lut) { EPD_2IN9_V2_LUT((UBYTE *)lut); //lut EPD_2IN9_V2_SendCommand(0x3f); EPD_2IN9_V2_SendData(*(lut+153)); EPD_2IN9_V2_SendCommand(0x03); // gate voltage EPD_2IN9_V2_SendData(*(lut+154)); EPD_2IN9_V2_SendCommand(0x04); // source voltage EPD_2IN9_V2_SendData(*(lut+155)); // VSH EPD_2IN9_V2_SendData(*(lut+156)); // VSH2 EPD_2IN9_V2_SendData(*(lut+157)); // VSL EPD_2IN9_V2_SendCommand(0x2c); // VCOM EPD_2IN9_V2_SendData(*(lut+158)); } /****************************************************************************** function : Turn On Display parameter: ******************************************************************************/ static void EPD_2IN9_V2_TurnOnDisplay(void) { EPD_2IN9_V2_SendCommand(0x22); //Display Update Control EPD_2IN9_V2_SendData(0xc7); EPD_2IN9_V2_SendCommand(0x20); //Activate Display Update Sequence EPD_2IN9_V2_ReadBusy(); } static void EPD_2IN9_V2_TurnOnDisplay_Partial(void) { EPD_2IN9_V2_SendCommand(0x22); //Display Update Control EPD_2IN9_V2_SendData(0x0F); EPD_2IN9_V2_SendCommand(0x20); //Activate Display Update Sequence EPD_2IN9_V2_ReadBusy(); } /****************************************************************************** function : Setting the display window parameter: ******************************************************************************/ static void EPD_2IN9_V2_SetWindows(UWORD Xstart, UWORD Ystart, UWORD Xend, UWORD Yend) { EPD_2IN9_V2_SendCommand(0x44); // SET_RAM_X_ADDRESS_START_END_POSITION EPD_2IN9_V2_SendData((Xstart>>3) & 0xFF); EPD_2IN9_V2_SendData((Xend>>3) & 0xFF); EPD_2IN9_V2_SendCommand(0x45); // SET_RAM_Y_ADDRESS_START_END_POSITION EPD_2IN9_V2_SendData(Ystart & 0xFF); EPD_2IN9_V2_SendData((Ystart >> 8) & 0xFF); EPD_2IN9_V2_SendData(Yend & 0xFF); EPD_2IN9_V2_SendData((Yend >> 8) & 0xFF); } /****************************************************************************** function : Set Cursor parameter: ******************************************************************************/ static void EPD_2IN9_V2_SetCursor(UWORD Xstart, UWORD Ystart) { EPD_2IN9_V2_SendCommand(0x4E); // SET_RAM_X_ADDRESS_COUNTER EPD_2IN9_V2_SendData(Xstart & 0xFF); EPD_2IN9_V2_SendCommand(0x4F); // SET_RAM_Y_ADDRESS_COUNTER EPD_2IN9_V2_SendData(Ystart & 0xFF); EPD_2IN9_V2_SendData((Ystart >> 8) & 0xFF); } /****************************************************************************** function : Initialize the e-Paper register parameter: ******************************************************************************/ void EPD_2IN9_V2_Init(void) { EPD_2IN9_V2_Reset(); DEV_Delay_ms(100); EPD_2IN9_V2_ReadBusy(); EPD_2IN9_V2_SendCommand(0x12); // soft reset EPD_2IN9_V2_ReadBusy(); EPD_2IN9_V2_SendCommand(0x01); //Driver output control EPD_2IN9_V2_SendData(0x27); EPD_2IN9_V2_SendData(0x01); EPD_2IN9_V2_SendData(0x00); EPD_2IN9_V2_SendCommand(0x11); //data entry mode EPD_2IN9_V2_SendData(0x03); EPD_2IN9_V2_SetWindows(0, 0, EPD_2IN9_V2_WIDTH-1, EPD_2IN9_V2_HEIGHT-1); EPD_2IN9_V2_SendCommand(0x21); // Display update control EPD_2IN9_V2_SendData(0x00); EPD_2IN9_V2_SendData(0x80); EPD_2IN9_V2_SetCursor(0, 0); EPD_2IN9_V2_ReadBusy(); EPD_2IN9_V2_LUT_by_host(WS_20_30); } void EPD_2IN9_V2_Gray4_Init(void) { EPD_2IN9_V2_Reset(); DEV_Delay_ms(100); EPD_2IN9_V2_ReadBusy(); EPD_2IN9_V2_SendCommand(0x12); // soft reset EPD_2IN9_V2_ReadBusy(); EPD_2IN9_V2_SendCommand(0x01); //Driver output control EPD_2IN9_V2_SendData(0x27); EPD_2IN9_V2_SendData(0x01); EPD_2IN9_V2_SendData(0x00); EPD_2IN9_V2_SendCommand(0x11); //data entry mode EPD_2IN9_V2_SendData(0x03); EPD_2IN9_V2_SetWindows(8, 0, EPD_2IN9_V2_WIDTH, EPD_2IN9_V2_HEIGHT-1); EPD_2IN9_V2_SendCommand(0x3C); EPD_2IN9_V2_SendData(0x04); EPD_2IN9_V2_SetCursor(1, 0); EPD_2IN9_V2_ReadBusy(); EPD_2IN9_V2_LUT_by_host(Gray4); } /****************************************************************************** function : Clear screen parameter: ******************************************************************************/ void EPD_2IN9_V2_Clear(void) { UWORD i; EPD_2IN9_V2_SendCommand(0x24); //write RAM for black(0)/white (1) for(i=0;i<4736;i++) { EPD_2IN9_V2_SendData(0xff); } EPD_2IN9_V2_SendCommand(0x26); //write RAM for black(0)/white (1) for(i=0;i<4736;i++) { EPD_2IN9_V2_SendData(0xff); } EPD_2IN9_V2_TurnOnDisplay(); } /****************************************************************************** function : Sends the image buffer in RAM to e-Paper and displays parameter: ******************************************************************************/ void EPD_2IN9_V2_Display(UBYTE *Image) { UWORD i; EPD_2IN9_V2_SendCommand(0x24); //write RAM for black(0)/white (1) for(i=0;i<4736;i++) { EPD_2IN9_V2_SendData(Image[i]); } EPD_2IN9_V2_TurnOnDisplay(); } void EPD_2IN9_V2_Display_Base(UBYTE *Image) { UWORD i; EPD_2IN9_V2_SendCommand(0x24); //Write Black and White image to RAM for(i=0;i<4736;i++) { EPD_2IN9_V2_SendData(Image[i]); } EPD_2IN9_V2_SendCommand(0x26); //Write Black and White image to RAM for(i=0;i<4736;i++) { EPD_2IN9_V2_SendData(Image[i]); } EPD_2IN9_V2_TurnOnDisplay(); } void EPD_2IN9_V2_4GrayDisplay(UBYTE *Image) { UDOUBLE i,j,k; UBYTE temp1,temp2,temp3; // old data EPD_2IN9_V2_SendCommand(0x24); for(i=0; i<4736; i++) { temp3=0; for(j=0; j<2; j++) { temp1 = Image[i*2+j]; for(k=0; k<2; k++) { temp2 = temp1&0xC0; if(temp2 == 0xC0) temp3 |= 0x00; else if(temp2 == 0x00) temp3 |= 0x01; else if(temp2 == 0x80) temp3 |= 0x01; else //0x40 temp3 |= 0x00; temp3 <<= 1; temp1 <<= 2; temp2 = temp1&0xC0 ; if(temp2 == 0xC0) temp3 |= 0x00; else if(temp2 == 0x00) temp3 |= 0x01; else if(temp2 == 0x80) temp3 |= 0x01; else //0x40 temp3 |= 0x00; if(j!=1 || k!=1) temp3 <<= 1; temp1 <<= 2; } } EPD_2IN9_V2_SendData(temp3); // printf("%x ",temp3); } EPD_2IN9_V2_SendCommand(0x26); //write RAM for black(0)/white (1) for(i=0; i<4736; i++) { temp3=0; for(j=0; j<2; j++) { temp1 = Image[i*2+j]; for(k=0; k<2; k++) { temp2 = temp1&0xC0 ; if(temp2 == 0xC0) temp3 |= 0x00;//white else if(temp2 == 0x00) temp3 |= 0x01; //black else if(temp2 == 0x80) temp3 |= 0x00; //gray1 else //0x40 temp3 |= 0x01; //gray2 temp3 <<= 1; temp1 <<= 2; temp2 = temp1&0xC0 ; if(temp2 == 0xC0) //white temp3 |= 0x00; else if(temp2 == 0x00) //black temp3 |= 0x01; else if(temp2 == 0x80) temp3 |= 0x00; //gray1 else //0x40 temp3 |= 0x01; //gray2 if(j!=1 || k!=1) temp3 <<= 1; temp1 <<= 2; } } EPD_2IN9_V2_SendData(temp3); // printf("%x ",temp3); } EPD_2IN9_V2_TurnOnDisplay(); } void EPD_2IN9_V2_Display_Partial(UBYTE *Image) { UWORD i; //Reset DEV_Digital_Write(EPD_RST_PIN, 0); DEV_Delay_ms(1); DEV_Digital_Write(EPD_RST_PIN, 1); DEV_Delay_ms(2); EPD_2IN9_V2_LUT(_WF_PARTIAL_2IN9); EPD_2IN9_V2_SendCommand(0x37); EPD_2IN9_V2_SendData(0x00); EPD_2IN9_V2_SendData(0x00); EPD_2IN9_V2_SendData(0x00); EPD_2IN9_V2_SendData(0x00); EPD_2IN9_V2_SendData(0x00); EPD_2IN9_V2_SendData(0x40); EPD_2IN9_V2_SendData(0x00); EPD_2IN9_V2_SendData(0x00); EPD_2IN9_V2_SendData(0x00); EPD_2IN9_V2_SendData(0x00); EPD_2IN9_V2_SendCommand(0x3C); //BorderWavefrom EPD_2IN9_V2_SendData(0x80); EPD_2IN9_V2_SendCommand(0x22); EPD_2IN9_V2_SendData(0xC0); EPD_2IN9_V2_SendCommand(0x20); EPD_2IN9_V2_ReadBusy(); EPD_2IN9_V2_SetWindows(0, 0, EPD_2IN9_V2_WIDTH-1, EPD_2IN9_V2_HEIGHT-1); EPD_2IN9_V2_SetCursor(0, 0); EPD_2IN9_V2_SendCommand(0x24); //Write Black and White image to RAM for(i=0;i<4736;i++) { EPD_2IN9_V2_SendData(Image[i]); } EPD_2IN9_V2_TurnOnDisplay_Partial(); } /****************************************************************************** function : Enter sleep mode parameter: ******************************************************************************/ void EPD_2IN9_V2_Sleep(void) { EPD_2IN9_V2_SendCommand(0x10); //enter deep sleep EPD_2IN9_V2_SendData(0x01); DEV_Delay_ms(100); }