389 lines
11 KiB
C++
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 */
|