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

389 lines
11 KiB
C++

/**
* @filename : epd3in7.cpp
* @brief : Implements for e-paper library
* @author : Waveshare
*
* Copyright (C) Waveshare July 17 2020
*
* 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 "epd3in7.h"
#include "imagedata.h"
static const UBYTE lut_4Gray_GC[] =
{
0x2A,0x06,0x15,0x00,0x00,0x00,0x00,0x00,0x00,0x00,//1
0x28,0x06,0x14,0x00,0x00,0x00,0x00,0x00,0x00,0x00,//2
0x20,0x06,0x10,0x00,0x00,0x00,0x00,0x00,0x00,0x00,//3
0x14,0x06,0x28,0x00,0x00,0x00,0x00,0x00,0x00,0x00,//4
0x00,0x00,0x00,0x00,0x00,0x00,0x00,0x00,0x00,0x00,//5
0x00,0x02,0x02,0x0A,0x00,0x00,0x00,0x08,0x08,0x02,//6
0x00,0x02,0x02,0x0A,0x00,0x00,0x00,0x00,0x00,0x00,//7
0x00,0x00,0x00,0x00,0x00,0x00,0x00,0x00,0x00,0x00,//8
0x00,0x00,0x00,0x00,0x00,0x00,0x00,0x00,0x00,0x00,//9
0x00,0x00,0x00,0x00,0x00,0x00,0x00,0x00,0x00,0x00,//10
0x22,0x22,0x22,0x22,0x22
};
static const UBYTE lut_1Gray_GC[] =
{
0x2A,0x05,0x00,0x00,0x00,0x00,0x00,0x00,0x00,0x00,//1
0x05,0x2A,0x00,0x00,0x00,0x00,0x00,0x00,0x00,0x00,//2
0x2A,0x15,0x00,0x00,0x00,0x00,0x00,0x00,0x00,0x00,//3
0x05,0x0A,0x00,0x00,0x00,0x00,0x00,0x00,0x00,0x00,//4
0x00,0x00,0x00,0x00,0x00,0x00,0x00,0x00,0x00,0x00,//5
0x00,0x02,0x03,0x0A,0x00,0x02,0x06,0x0A,0x05,0x00,//6
0x00,0x00,0x00,0x00,0x00,0x00,0x00,0x00,0x00,0x00,//7
0x00,0x00,0x00,0x00,0x00,0x00,0x00,0x00,0x00,0x00,//8
0x00,0x00,0x00,0x00,0x00,0x00,0x00,0x00,0x00,0x00,//9
0x00,0x00,0x00,0x00,0x00,0x00,0x00,0x00,0x00,0x00,//10
0x22,0x22,0x22,0x22,0x22
};
static const UBYTE lut_1Gray_DU[] =
{
0x00,0x00,0x00,0x00,0x00,0x00,0x00,0x00,0x00,0x00,//1
0x01,0x2A,0x00,0x00,0x00,0x00,0x00,0x00,0x00,0x00,
0x0A,0x55,0x00,0x00,0x00,0x00,0x00,0x00,0x00,0x00,//3
0x00,0x00,0x00,0x00,0x00,0x00,0x00,0x00,0x00,0x00,
0x00,0x00,0x00,0x00,0x00,0x00,0x00,0x00,0x00,0x00,//5
0x00,0x00,0x05,0x05,0x00,0x05,0x03,0x05,0x05,0x00,
0x00,0x00,0x00,0x00,0x00,0x00,0x00,0x00,0x00,0x00,//7
0x00,0x00,0x00,0x00,0x00,0x00,0x00,0x00,0x00,0x00,
0x00,0x00,0x00,0x00,0x00,0x00,0x00,0x00,0x00,0x00,//9
0x00,0x00,0x00,0x00,0x00,0x00,0x00,0x00,0x00,0x00,
0x22,0x22,0x22,0x22,0x22
};
static const UBYTE lut_1Gray_A2[] =
{
0x00,0x00,0x00,0x00,0x00,0x00,0x00,0x00,0x00,0x00, //1
0x0A,0x00,0x00,0x00,0x00,0x00,0x00,0x00,0x00,0x00, //2
0x05,0x00,0x00,0x00,0x00,0x00,0x00,0x00,0x00,0x00, //3
0x00,0x00,0x00,0x00,0x00,0x00,0x00,0x00,0x00,0x00, //4
0x00,0x00,0x00,0x00,0x00,0x00,0x00,0x00,0x00,0x00, //5
0x00,0x00,0x03,0x05,0x00,0x00,0x00,0x00,0x00,0x00, //6
0x00,0x00,0x00,0x00,0x00,0x00,0x00,0x00,0x00,0x00, //7
0x00,0x00,0x00,0x00,0x00,0x00,0x00,0x00,0x00,0x00, //8
0x00,0x00,0x00,0x00,0x00,0x00,0x00,0x00,0x00,0x00, //9
0x00,0x00,0x00,0x00,0x00,0x00,0x00,0x00,0x00,0x00, //10
0x22,0x22,0x22,0x22,0x22
};
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();
SendCommand(0x12);
DelayMs(300);
SendCommand(0x46);
SendData(0xF7);
WaitUntilIdle();
SendCommand(0x47);
SendData(0xF7);
WaitUntilIdle();
SendCommand(0x01); // setting gaet number
SendData(0xDF);
SendData(0x01);
SendData(0x00);
SendCommand(0x03); // set gate voltage
SendData(0x00);
SendCommand(0x04); // set source voltage
SendData(0x41);
SendData(0xA8);
SendData(0x32);
SendCommand(0x11); // set data entry sequence
SendData(0x03);
SendCommand(0x3C); // set border
SendData(0x00);
SendCommand(0x0C); // set booster strength
SendData(0xAE);
SendData(0xC7);
SendData(0xC3);
SendData(0xC0);
SendData(0xC0);
SendCommand(0x18); // set internal sensor on
SendData(0x80);
SendCommand(0x2C); // set vcom value
SendData(0x44);
SendCommand(0x37); // set display option, these setting turn on previous function
SendData(0x00);
SendData(0xff);
SendData(0xff);
SendData(0xff);
SendData(0xff);
SendData(0x4f);
SendData(0xff);
SendData(0xff);
SendData(0xff);
SendData(0xff);
SendCommand(0x44); // setting X direction start/end position of RAM
SendData(0x00);
SendData(0x00);
SendData(0x17);
SendData(0x01);
SendCommand(0x45); // setting Y direction start/end position of RAM
SendData(0x00);
SendData(0x00);
SendData(0xDF);
SendData(0x01);
SendCommand(0x22); // Display Update Control 2
SendData(0xCF);
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::WaitUntilIdle(void) {
Serial.print("e-Paper busy \r\n ");
UBYTE busy;
do {
busy = DigitalRead(busy_pin);
} while(busy);
DelayMs(200);
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(20);
DigitalWrite(reset_pin, LOW); //module reset
DelayMs(2);
DigitalWrite(reset_pin, HIGH);
DelayMs(20);
}
/******************************************************************************
function : Display
******************************************************************************/
void Epd::DisplayFrame(const UBYTE *Image, bool isBase) {
UWORD i;
UWORD IMAGE_COUNTER = width * height / 8;
SendCommand(0x4E);
SendData(0x00);
SendData(0x00);
SendCommand(0x4F);
SendData(0x00);
SendData(0x00);
SendCommand(0x24);
for (i = 0; i < IMAGE_COUNTER; i++) {
SendData(pgm_read_byte(&Image[i]));
}
if(isBase) {
SendCommand(0x26);
for (i = 0; i < IMAGE_COUNTER; i++) {
SendData(pgm_read_byte(&Image[i]));
}
}
Load_LUT(1);
SendCommand(0x20);
WaitUntilIdle();
}
/******************************************************************************
function : Partial Display
note:
1. iwidth must be a multiple of 8
2. The update will clear other parts of the image data
******************************************************************************/
void Epd::DisplayFrame_Partial(const UBYTE *Image, UWORD Xstart, UWORD Ystart, UWORD iwidth, UWORD iheight) {
UWORD i, j;
SendCommand(0x4E);
SendData(0x00);
SendData(0x00);
SendCommand(0x4F);
SendData(0x00);
SendData(0x00);
SendCommand(0x24);
for(i=0; i<EPD_WIDTH; i++) {
for(j=0; j<EPD_HEIGHT/8; j++) {
if(i>=Ystart && i<Ystart+iheight && j>=Xstart/8 && j<(Xstart+iwidth)/8)
SendData(Image[(j-Xstart/8) + (i-Ystart)*iwidth/8]);
else
SendData(0xff);
}
}
Load_LUT(0);
SendCommand(0x20);
WaitUntilIdle();
}
/******************************************************************************
function : Sends part the image buffer in RAM to e-Paper and displays
notes:
1. Xstart must be a multiple of 8
1. isGC: use GC mode to clear base-image
******************************************************************************/
void Epd::DisplayFrame_Part(const UBYTE *Image, UWORD Xstart, UWORD Ystart, UWORD Xend, UWORD Yend, bool isGC)
{
UWORD i, Width;
Width = (Xend-Xstart)%8 == 0 ? (Xend-Xstart)/8 : (Xend-Xstart)/8+1;
UWORD IMAGE_COUNTER = Width * (Yend-Ystart);
Xend -= 1;
Yend -= 1;
SendCommand(0x44);
SendData(Xstart & 0xff);
SendData((Xstart>>8) & 0x03);
SendData(Xend & 0xff);
SendData((Xend>>8) & 0x03);
SendCommand(0x45);
SendData(Ystart & 0xff);
SendData((Ystart>>8) & 0x03);
SendData(Yend & 0xff);
SendData((Yend>>8) & 0x03);
SendCommand(0x4E); // SET_RAM_X_ADDRESS_COUNTER
SendData(Xstart & 0xFF);
SendCommand(0x4F); // SET_RAM_Y_ADDRESS_COUNTER
SendData(Ystart & 0xFF);
SendData((Ystart >> 8) & 0xFF);
SendCommand(0x24);
for (i = 0; i < IMAGE_COUNTER; i++)
{
SendData(Image[i]);
}
if(isGC)
Load_LUT(1);
else
Load_LUT(0);
}
void Epd::TurnOnDisplay(void) {
SendCommand(0x20);
WaitUntilIdle();
}
/******************************************************************************
function : set the look-up tables
parameter:
******************************************************************************/
void Epd::Load_LUT(UBYTE mode) {
UWORD i;
SendCommand(0x32);
for (i = 0; i < 105; i++) {
if(mode == 1)
SendData(lut_1Gray_GC[i]);
else if(mode == 0)
SendData(lut_1Gray_A2[i]);
}
}
/******************************************************************************
function : Clear Screen
parameter:
mode: 0:just partial mode
1:clear all
******************************************************************************/
void Epd::Clear(UBYTE mode) {
UWORD i;
UWORD IMAGE_COUNTER = width * height / 8;
SendCommand(0x4E);
SendData(0x00);
SendData(0x00);
SendCommand(0x4F);
SendData(0x00);
SendData(0x00);
SendCommand(0x24);
for (i = 0; i < IMAGE_COUNTER; i++)
{
SendData(0xff);
}
if(mode)
Load_LUT(1);
else
Load_LUT(0);
SendCommand(0x20);
WaitUntilIdle();
}
/**
* @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(0x03);
}
/* END OF FILE */