e-paper-display/bcm2835-1.71/e-Paper/Arduino/epd2in7_V2/epd2in7_V2.cpp

586 lines
16 KiB
C++
Raw Normal View History

2024-01-31 22:04:09 +00:00
/**
* @filename : epd2in7_V2.cpp
* @brief : Implements for e-paper library
* @author : Waveshare
*
* Copyright (C) Waveshare September 20 2022
*
* 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 <stdlib.h>
#include "epd2in7_V2.h"
static const unsigned char LUT_DATA_4Gray[159] =
{
0x40, 0x48, 0x80, 0x0, 0x0, 0x0, 0x0, 0x0, 0x0, 0x0, 0x0, 0x0,
0x8, 0x48, 0x10, 0x0, 0x0, 0x0, 0x0, 0x0, 0x0, 0x0, 0x0, 0x0,
0x2, 0x48, 0x4, 0x0, 0x0, 0x0, 0x0, 0x0, 0x0, 0x0, 0x0, 0x0,
0x20, 0x48, 0x1, 0x0, 0x0, 0x0, 0x0, 0x0, 0x0, 0x0, 0x0, 0x0,
0x0, 0x0, 0x0, 0x0, 0x0, 0x0, 0x0, 0x0, 0x0, 0x0, 0x0, 0x0,
0xA, 0x19, 0x0, 0x3, 0x8, 0x0, 0x0,
0x14, 0x1, 0x0, 0x14, 0x1, 0x0, 0x3,
0xA, 0x3, 0x0, 0x8, 0x19, 0x0, 0x0,
0x1, 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,
0x22, 0x22, 0x22, 0x22, 0x22, 0x22, 0x0, 0x0, 0x0,
0x22, 0x17, 0x41, 0x0, 0x32, 0x1C
};
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) {
/* this calls the peripheral hardware interface, see epdif */
if (IfInit() != 0) {
return -1;
}
Reset();
ReadBusy();
SendCommand(0x12); //SWRESET
ReadBusy();
SendCommand(0x45); //set Ram-Y address start/end position
SendData(0x00);
SendData(0x00);
SendData(0x07); //0x0107-->(263+1)=264
SendData(0x01);
SendCommand(0x4F); // set RAM y address count to 0;
SendData(0x00);
SendData(0x00);
SendCommand(0x11); // data entry mode
SendData(0x03);
return 0;
}
int Epd::Init_Fast(void) {
/* this calls the peripheral hardware interface, see epdif */
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(0x64);
SendData(0x00);
SendCommand(0x45); //set Ram-Y address start/end position
SendData(0x00);
SendData(0x00);
SendData(0x07); //0x0107-->(263+1)=264
SendData(0x01);
SendCommand(0x4F); // set RAM y address count to 0;
SendData(0x00);
SendData(0x00);
SendCommand(0x11); // data entry mode
SendData(0x03);
SendCommand(0x22); // Load temperature value
SendData(0x91);
SendCommand(0x20);
ReadBusy();
return 0;
}
void Epd::Init_4Gray(void)
{
Reset();
ReadBusy();
SendCommand(0x12); // soft reset
ReadBusy();
SendCommand(0x74); //set analog block control
SendData(0x54);
SendCommand(0x7E); //set digital block control
SendData(0x3B);
SendCommand(0x01); //Driver output control
SendData(0x07);
SendData(0x01);
SendData(0x00);
SendCommand(0x11); //data entry mode
SendData(0x03);
SendCommand(0x44); //set Ram-X address start/end position
SendData(0x00);
SendData(0x15); //0x15-->(21+1)*8=176
SendCommand(0x45); //set Ram-Y address start/end position
SendData(0x00);
SendData(0x00);
SendData(0x07);//0x0107-->(263+1)=264
SendData(0x01);
SendCommand(0x3C); //BorderWavefrom
SendData(0x00);
SendCommand(0x2C); //VCOM Voltage
SendData(LUT_DATA_4Gray[158]); //0x1C
SendCommand(0x3F); //EOPQ
SendData(LUT_DATA_4Gray[153]);
SendCommand(0x03); //VGH
SendData(LUT_DATA_4Gray[154]);
SendCommand(0x04); //
SendData(LUT_DATA_4Gray[155]); //VSH1
SendData(LUT_DATA_4Gray[156]); //VSH2
SendData(LUT_DATA_4Gray[157]); //VSL
Lut(); //LUT
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();
}
/**
* @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) {
Serial.print("e-Paper busy\r\n");
while(DigitalRead(busy_pin) == 1) { //1: busy, 0: idle
DelayMs(100);
}
Serial.print("e-Paper busy release\r\n");
}
/**
* @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);
DelayMs(2);
DigitalWrite(reset_pin, HIGH);
DelayMs(200);
}
/**
* @brief: set the look-up tables
*/
void Epd::Lut(void) {
unsigned int count;
SendCommand(0x32); //vcom
for(count = 0; count < 153; count++) {
SendData(LUT_DATA_4Gray[count]);
}
}
/******************************************************************************
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_Fast(void)
{
SendCommand(0x22); //Display Update Control
SendData(0xC7);
SendCommand(0x20); //Activate Display Update Sequence
ReadBusy();
}
void Epd::TurnOnDisplay_Partial(void)
{
SendCommand(0x22);
SendData(0xFF);
SendCommand(0x20);
ReadBusy();
}
void Epd::TurnOnDisplay_4GRAY(void)
{
SendCommand(0x22);
SendData(0xC7);
SendCommand(0x20);
ReadBusy();
}
/******************************************************************************
function : Clear screen
parameter:
******************************************************************************/
void Epd::Clear(void)
{
unsigned int Width, Height;
Width = (WIDTH % 8 == 0)? (WIDTH / 8 ): (WIDTH / 8 + 1);
Height = HEIGHT;
SendCommand(0x24);
for (unsigned int j = 0; j < Height; j++) {
for (unsigned int i = 0; i < Width; i++) {
SendData(0XFF);
}
}
TurnOnDisplay();
}
/******************************************************************************
function : Sends the image buffer in RAM to e-Paper and displays
parameter:
******************************************************************************/
void Epd::Display(const unsigned char* Image)
{
unsigned int Width, Height;
Width = (WIDTH % 8 == 0)? (WIDTH / 8 ): (WIDTH / 8 + 1);
Height = HEIGHT;
SendCommand(0x24);
for (unsigned int j = 0; j < Height; j++) {
for (unsigned int i = 0; i < Width; i++) {
SendData(pgm_read_byte(&Image[i + j * Width]));
}
}
TurnOnDisplay();
}
void Epd::Display_Fast(const unsigned char* Image)
{
unsigned int Width, Height;
Width = (WIDTH % 8 == 0)? (WIDTH / 8 ): (WIDTH / 8 + 1);
Height = HEIGHT;
SendCommand(0x24);
for (unsigned int j = 0; j < Height; j++) {
for (unsigned int i = 0; i < Width; i++) {
SendData(pgm_read_byte(&Image[i + j * Width]));
}
}
TurnOnDisplay_Fast();
}
void Epd::Display_Base(const unsigned char* Image)
{
unsigned int Width, Height;
Width = (WIDTH % 8 == 0)? (WIDTH / 8 ): (WIDTH / 8 + 1);
Height = HEIGHT;
SendCommand(0x24); //Write Black and White image to RAM
for (unsigned int j = 0; j < Height; j++) {
for (unsigned int i = 0; i < Width; i++) {
SendData(pgm_read_byte(&Image[i + j * Width]));
}
}
SendCommand(0x26); //Write Black and White image to RAM
for (unsigned int j = 0; j < Height; j++) {
for (unsigned int i = 0; i < Width; i++) {
SendData(pgm_read_byte(&Image[i + j * Width]));
}
}
TurnOnDisplay();
}
void Epd::Display_Base_color(unsigned char color)
{
unsigned int Width, Height;
Width = (WIDTH % 8 == 0)? (WIDTH / 8 ): (WIDTH / 8 + 1);
Height = HEIGHT;
SendCommand(0x24); //Write Black and White image to RAM
for (unsigned int j = 0; j < Height; j++) {
for (unsigned int i = 0; i < Width; i++) {
SendData(color);
}
}
SendCommand(0x26); //Write Black and White image to RAM
for (unsigned int j = 0; j < Height; j++) {
for (unsigned int i = 0; i < Width; i++) {
SendData(color);
}
}
// TurnOnDisplay();
}
void Epd::Display_Partial(unsigned char* Image, unsigned int Xstart, unsigned int Ystart, unsigned int Xend, unsigned int Yend)
{
unsigned int i, Width;
unsigned int IMAGE_COUNTER;
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;
}
Width = Xend - Xstart;
IMAGE_COUNTER = Width * (Yend-Ystart);
Serial.println(IMAGE_COUNTER);
Xend -= 1;
Yend -= 1;
//Reset
Reset();
SendCommand(0x3C); //BorderWavefrom
SendData(0x80);
//
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(Image[i]);
}
TurnOnDisplay_Partial();
}
void Epd::Display_Partial_Not_refresh(unsigned char* Image, unsigned int Xstart, unsigned int Ystart, unsigned int Xend, unsigned int Yend)
{
unsigned int i, Width;
unsigned int IMAGE_COUNTER;
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;
}
Width = Xend - Xstart;
IMAGE_COUNTER = Width * (Yend-Ystart);
Serial.println(IMAGE_COUNTER);
Xend -= 1;
Yend -= 1;
//Reset
Reset();
SendCommand(0x3C); //BorderWavefrom
SendData(0x80);
//
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(Image[i]);
}
// TurnOnDisplay_Partial();
}
void Epd::Display4Gray(const unsigned char *Image)
{
int i,j,k;
unsigned char temp1,temp2,temp3;
SendCommand(0x24);
for(i=0;i<5808;i++) //5808*4 46464
{
temp3=0;
for(j=0;j<2;j++)
{
temp1 = pgm_read_byte(&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 |= 0x01; //gray1
else //0x40
temp3 |= 0x00; //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 |= 0x01; //gray1
else //0x40
temp3 |= 0x00; //gray2
if(j!=1 || k!=1)
temp3 <<= 1;
temp1 <<= 2;
}
}
SendData(temp3);
}
// new data
SendCommand(0x26);
for(i=0;i<5808;i++) //5808*4 46464
{
temp3=0;
for(j=0;j<2;j++)
{
temp1 = pgm_read_byte(&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;
}
}
SendData(temp3);
}
TurnOnDisplay_4GRAY();
}
/**
* @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 executed if check code = 0xA5.
* You can use Epd::Reset() to awaken and use Epd::Init() to initialize.
*/
void Epd::Sleep() {
SendCommand(0X10);
SendData(0x01);
}