/** * @filename : epd2in9b_V4.cpp * @brief : Implements for e-paper library * @author : Waveshare * * Copyright (C) Waveshare 2023-12-20 * * 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 #include "epd2in9b_V4.h" #include "imagedata.h" Epd::~Epd() { }; Epd::Epd() { reset_pin = RST_PIN; dc_pin = DC_PIN; cs_pin = CS_PIN; busy_pin = BUSY_PIN; width = EPD_WIDTH; height = EPD_HEIGHT; }; int Epd::Init(void) { if (IfInit() != 0) { return -1; } Reset(); ReadBusy(); SendCommand(0x12); ReadBusy(); SendCommand(0x01); //Driver output control SendData((height-1)%256); SendData((height-1)/256); SendData(0x00); SendCommand(0x11); //data entry mode SendData(0x03); SendCommand(0x44); //set Ram-X address start/end position SendData(0x00); SendData(width/8-1); SendCommand(0x45); //set Ram-Y address start/end position SendData(0x00); SendData(0x00); SendData((height-1)%256); SendData((height-1)/256); SendCommand(0x3C); //BorderWavefrom SendData(0x05); SendCommand(0x21); // Display update control SendData(0x00); SendData(0x80); SendCommand(0x18); //Read built-in temperature sensor SendData(0x80); SendCommand(0x4E); // set RAM x address count to 0; SendData(0x00); SendCommand(0x4F); // set RAM y address count to 0X199; SendData(0x00); SendData(0x00); ReadBusy(); return 0; } int Epd::Init_Fast(void) { if (IfInit() != 0) { return -1; } Reset(); ReadBusy(); SendCommand(0x12); //SWRESET ReadBusy(); SendCommand(0x18); //Read built-in temperature sensor SendData(0x80); SendCommand(0x22); // Load temperature value SendData(0xB1); SendCommand(0x20); ReadBusy(); SendCommand(0x1A); // Write to temperature register SendData(0x5a); // 90 SendData(0x00); SendCommand(0x22); // Load temperature value SendData(0x91); SendCommand(0x20); ReadBusy(); SendCommand(0x01); //Driver output control SendData((height-1)%256); SendData((height-1)/256); SendData(0x00); SendCommand(0x11); //data entry mode SendData(0x03); SendCommand(0x44); //set Ram-X address start/end position SendData(0x00); SendData(width/8-1); SendCommand(0x45); //set Ram-Y address start/end position SendData(0x00); SendData(0x00); SendData((height-1)%256); SendData((height-1)/256); SendCommand(0x4E); // set RAM x address count to 0; SendData(0x00); SendCommand(0x4F); // set RAM y address count to 0X199; SendData(0x00); SendData(0x00); ReadBusy(); return 0; } /** * @brief: basic function for sending commands */ void Epd::SendCommand(unsigned char command) { DigitalWrite(dc_pin, LOW); SpiTransfer(command); } /** * @brief: basic function for sending data */ void Epd::SendData(unsigned char data) { DigitalWrite(dc_pin, HIGH); SpiTransfer(data); } /** * @brief: Wait until the busy_pin goes HIGH */ void Epd::ReadBusy(void) { unsigned char busy; Serial.print("e-Paper busy \r\n "); while(1) { if(DigitalRead(busy_pin) == 0) break; DelayMs(50); } Serial.print("e-Paper busy release \r\n "); DelayMs(200); } /** * @brief: module reset. * often used to awaken the module in deep sleep, * see Epd::Sleep(); */ void Epd::Reset(void) { DigitalWrite(reset_pin, HIGH); DelayMs(200); DigitalWrite(reset_pin, LOW); //module reset DelayMs(5); DigitalWrite(reset_pin, HIGH); DelayMs(200); } /****************************************************************************** function : Turn On Display parameter: ******************************************************************************/ void Epd::TurnOnDisplay(void) { SendCommand(0x22); //Display Update Control SendData(0xF7); SendCommand(0x20); //Activate Display Update Sequence ReadBusy(); } void Epd::TurnOnDisplay_Base(void) { SendCommand(0x22); //Display Update Control SendData(0xF4); SendCommand(0x20); //Activate Display Update Sequence ReadBusy(); } void Epd::TurnOnDisplay_Partial(void) { SendCommand(0x22); //Display Update Control SendData(0x1C); SendCommand(0x20); //Activate Display Update Sequence ReadBusy(); } void Epd::TurnOnDisplay_Fast(void) { SendCommand(0x22); //Display Update Control SendData(0xC7); SendCommand(0x20); //Activate Display Update Sequence ReadBusy(); } void Epd::Display(const UBYTE *blackimage, const UBYTE *ryimage) { UBYTE k; SendCommand(0x24); for (UWORD j = 0; j < height; j++) { for (UWORD i = 0; i < width/8; i++) { SendData(pgm_read_byte(&blackimage[i + (j*width/8)])); } } SendCommand(0x26); for (UWORD j = 0; j < height; j++) { for (UWORD i = 0; i < width/8; i++) { k = pgm_read_byte(&ryimage[i + (j*width/8)]); SendData(~k); } } TurnOnDisplay(); } void Epd::Display_Fast(const UBYTE *blackimage, const UBYTE *ryimage) { UBYTE k; SendCommand(0x24); for (UWORD j = 0; j < height; j++) { for (UWORD i = 0; i < width/8; i++) { SendData(pgm_read_byte(&blackimage[i + (j*width/8)])); } } SendCommand(0x26); for (UWORD j = 0; j < height; j++) { for (UWORD i = 0; i < width/8; i++) { k = pgm_read_byte(&ryimage[i + (j*width/8)]); SendData(~k); } } TurnOnDisplay_Fast(); } void Epd::Clear() { //send black data SendCommand(0x24); for (UWORD j = 0; j < height; j++) { for (UWORD i = 0; i < width/8; i++) { SendData(0xff); } } //send red data SendCommand(0x26); for (UWORD j = 0; j < height; j++) { for (UWORD i = 0; i < width/8; i++) { SendData(0x00); } } TurnOnDisplay_Base(); SendCommand(0x26); for (UWORD j = 0; j < height; j++) { for (UWORD i = 0; i < width/8; i++) { SendData(0xff); } } } void Epd::Clear_Base() { //send black data SendCommand(0x10); for (UWORD j = 0; j < height; j++) { for (UWORD i = 0; i < width/8; i++) { SendData(0xff); } } //send red data SendCommand(0x26); for (UWORD j = 0; j < height; j++) { for (UWORD i = 0; i < width/8; i++) { SendData(0x00); } } TurnOnDisplay(); } //Partial refresh display void Epd::Partial(const UBYTE *Image, UWORD Xstart, UWORD Ystart, UWORD Xend, UWORD Yend) { if((Xstart % 8 + Xend % 8 == 8 && Xstart % 8 > Xend % 8) || Xstart % 8 + Xend % 8 == 0 || (Xend - Xstart)%8 == 0) { Xstart = Xstart / 8 ; Xend = Xend / 8; } else { Xstart = Xstart / 8 ; Xend = Xend % 8 == 0 ? Xend / 8 : Xend / 8 + 1; } UWORD i, Width; Width = Xend - Xstart; UWORD IMAGE_COUNTER = Width * (Yend-Ystart); Xend -= 1; Yend -= 1; SendCommand(0x44); // set RAM x address start/end, in page 35 SendData(Xstart & 0xff); // RAM x address start at 00h; SendData(Xend & 0xff); // RAM x address end at 0fh(15+1)*8->128 SendCommand(0x45); // set RAM y address start/end, in page 35 SendData(Ystart & 0xff); // RAM y address start at 0127h; SendData((Ystart>>8) & 0x01); // RAM y address start at 0127h; SendData(Yend & 0xff); // RAM y address end at 00h; SendData((Yend>>8) & 0x01); SendCommand(0x4E); // set RAM x address count to 0; SendData(Xstart & 0xff); SendCommand(0x4F); // set RAM y address count to 0X127; SendData(Ystart & 0xff); SendData((Ystart>>8) & 0x01); SendCommand(0x24); //Write Black and White image to RAM for (i = 0; i < IMAGE_COUNTER; i++) { SendData(pgm_read_byte(&Image[i])); } TurnOnDisplay_Partial(); } /** * @brief: After this command is transmitted, the chip would enter the * deep-sleep mode to save power. * The deep sleep mode would return to standby by hardware reset. * The only one parameter is a check code, the command would be * You can use EPD_Reset() to awaken */ void Epd::Sleep(void) { SendCommand(0x10); // DEEP_SLEEP SendData(0x01); // check code } /* END OF FILE */