KE0159keyes 电子墨水屏 2.13寸 250*122分辨率红色环保

1.说明

当我们在DIY实验时，经常需要用到显示屏。keyes 电子墨水屏模块上带有一个2.13寸的显示屏，显示颜色为黑白色，分辨率为250*122。模块通过SPI通讯，可动态显示图案。模块上带有2个拨码开关，P1拨码开关用于调节显示亮度，拨打到“0.47”时，显示更亮；拨打到“3”时，显示更暗。P2拨码开关用于调节供电电压，拨打到“5VIN”时，供电电压为5V；拨打到“3.3VIN”时，供电电压为3.3V。

为了方便你使用，我们还提供显示屏模块和arduino单片机、树莓派搭配使用的详细方法。同时，为了方便将模块固定在其他设备上，模块自带2个直径为3mm的定位孔。

特别注意：测试时，我们使用的是1.8.9版本的IDE软件测试，如果使用其他版本IDE，

代码可能出现不兼容现象。

2.技术参数

工作电压: DC 3.3或5V（拨码开关控制）

工作电流：100mA

最大功率：0.8W

显示屏颜色：黑白色

显示屏大小：2.13寸

显示屏分辨率：250*122

接口类型：间距为2.54mm的8pin排针

工作温度范围：-20℃到+60℃

定位孔大小：直径3mm

尺寸：79*40*7mm

重量：9.6g

环保属性：ROHS

3.接线方法

UNO板连接方法

KE0159

树莓派连接方法

4.测试代码

Arduino代码

#include”Ap_29demo.h”

//IO settings

int BUSY_Pin = 8;

int RES_Pin = 9;

int DC_Pin = 10;

int CS_Pin = 11;

int SCK_Pin = 12;

int SDI_Pin = 13;

#define EPD_W21_MOSI_0 digitalWrite(SDI_Pin,LOW)

#define EPD_W21_MOSI_1 digitalWrite(SDI_Pin,HIGH)

#define EPD_W21_CLK_0 digitalWrite(SCK_Pin,LOW)

#define EPD_W21_CLK_1 digitalWrite(SCK_Pin,HIGH)

#define EPD_W21_CS_0 digitalWrite(CS_Pin,LOW)

#define EPD_W21_CS_1 digitalWrite(CS_Pin,HIGH)

#define EPD_W21_DC_0 digitalWrite(DC_Pin,LOW)

#define EPD_W21_DC_1 digitalWrite(DC_Pin,HIGH)

#define EPD_W21_RST_0 digitalWrite(RES_Pin,LOW)

#define EPD_W21_RST_1 digitalWrite(RES_Pin,HIGH)

#define isEPD_W21_BUSY digitalRead(BUSY_Pin)

//250*122///////////////////////////////////////

#define MONOMSB_MODE 1

#define MONOLSB_MODE 2

#define RED_MODE 3

#define MAX_LINE_BYTES 16// =128/8

#define MAX_COLUMN_BYTES 250

#define ALLSCREEN_GRAGHBYTES 4000

////////FUNCTION//////

void driver_delay_us(unsigned int xus);

void driver_delay_xms(unsigned long xms);

void DELAY_S(unsigned int delaytime);

void SPI_Delay(unsigned char xrate);

void SPI_Write(unsigned char value);

void Epaper_Write_Command(unsigned char command);

void Epaper_Write_Data(unsigned char command);

//EPD

void Epaper_READBUSY(void);

void SPI_Write(u8 TxData);

void Epaper_Write_Command(u8 cmd);

void Epaper_Write_Data(u8 data);

void EPD_HW_Init(void); //Electronic paper initialization

void EPD_Part_Init(void); //Local refresh initialization

void EPD_Part_Update(void);

void EPD_Update(void);

void EPD_WhiteScreen_Black(void);

void EPD_WhiteScreen_White(void);

void EPD_DeepSleep(void);

//Display

void EPD_WhiteScreen_ALL(const unsigned char * datas);

void EPD_SetRAMValue_BaseMap(const unsigned char * datas);

void EPD_Dis_Part(unsigned int x_start,unsigned int y_start,const unsigned char * datas,unsigned int PART_COLUMN,unsigned int PART_LINE);

void setup() {

pinMode(BUSY_Pin, INPUT);

pinMode(RES_Pin, OUTPUT);

pinMode(DC_Pin, OUTPUT);

pinMode(CS_Pin, OUTPUT);

pinMode(SCK_Pin, OUTPUT);

pinMode(SDI_Pin, OUTPUT);

}

void loop() {

unsigned char fen_L,fen_H,miao_L,miao_H;

//////////////////////Partial refresh digital presentation//////////////////////////////////////

EPD_HW_Init(); //Electronic paper initialization

EPD_WhiteScreen_ALL(gImage_1); //Refresh the picture in full screen

delay(100);

EPD_SetRAMValue_BaseMap(gImage_basemap); //Partial refresh background color,Brush map is a must, please do not delete

delay(100);

////////////////////////////////////////////////////////////////////////

}

///////////////////EXTERNAL FUNCTION////////////////////////////////////////////////////////////////////////

/////////////////////delay//////////////////////////////////////

void driver_delay_us(unsigned int xus) //1us

{

for(;xus>1;xus–);

}

void driver_delay_xms(unsigned long xms) //1ms

{

unsigned long i = 0 , j=0;

for(j=0;j<xms;j++)

{

for(i=0; i<256; i++);

}

void DELAY_S(unsigned int delaytime)

{

int i,j,k;

for(i=0;i<delaytime;i++)

{

for(j=0;j<4000;j++)

{

for(k=0;k<222;k++);

}

//////////////////////SPI///////////////////////////////////

void SPI_Delay(unsigned char xrate)

{

unsigned char i;

while(xrate)

{

for(i=0;i<2;i++);

xrate–;

}

void SPI_Write(unsigned char value)

{

unsigned char i;

SPI_Delay(1);

for(i=0; i<8; i++)

{

EPD_W21_CLK_0;

SPI_Delay(1);

if(value & 0x80)

EPD_W21_MOSI_1;

else

EPD_W21_MOSI_0;

value = (value << 1);

SPI_Delay(1);

driver_delay_us(1);

EPD_W21_CLK_1;

SPI_Delay(1);

}

void Epaper_Write_Command(unsigned char command)

{

SPI_Delay(1);

EPD_W21_CS_0;

EPD_W21_DC_0; // command write

SPI_Write(command);

EPD_W21_CS_1;

}

void Epaper_Write_Data(unsigned char command)

{

SPI_Delay(1);

EPD_W21_CS_0;

EPD_W21_DC_1; // command write

SPI_Write(command);

EPD_W21_CS_1;

}

/////////////////EPD settings Functions/////////////////////

//////////////////////////////////////////////////////////////////////////////////////////////////

void EPD_HW_Init(void)

{

EPD_W21_RST_0;

delay(1);

EPD_W21_RST_1; //hard reset

delay(1);

Epaper_READBUSY();

Epaper_Write_Command(0x12); //SWRESET

Epaper_READBUSY();

Epaper_Write_Command(0x01); //Driver output control

Epaper_Write_Data(0xF9);

Epaper_Write_Data(0x00);

Epaper_Write_Command(0x11); //data entry mode

Epaper_Write_Data(0x01);

Epaper_Write_Command(0x44); //set Ram-X address start/end position

Epaper_Write_Data(0x00);

Epaper_Write_Data(0x0F); //0x0F–>(15+1)*8=128

Epaper_Write_Command(0x45); //set Ram-Y address start/end position

Epaper_Write_Data(0xF9); //0xF9–>(249+1)=250

Epaper_Write_Data(0x00);

Epaper_Write_Command(0x3C); //BorderWavefrom

Epaper_Write_Data(0x01);

Epaper_Write_Command(0x18);

Epaper_Write_Data(0x80);

Epaper_Write_Command(0x4E); // set RAM x address count to 0;

Epaper_Write_Data(0x00);

Epaper_Write_Command(0x4F); // set RAM y address count to 0X199;

Epaper_Write_Data(0xF9);

Epaper_Write_Data(0x00);

Epaper_READBUSY();

}

//////////////////////////////All screen update////////////////////////////////////////////

void EPD_WhiteScreen_ALL(const unsigned char * datas)

{

unsigned int i;

Epaper_Write_Command(0x24); //write RAM for black(0)/white (1)

for(i=0;i<ALLSCREEN_GRAGHBYTES;i++)

{

Epaper_Write_Data(pgm_read_byte(&datas[i]));

}

EPD_Update();

}

/////////////////////////////////////////////////////////////////////////////////////////

void EPD_Update(void)

{

Epaper_Write_Command(0x22);

Epaper_Write_Data(0xF7);

Epaper_Write_Command(0x20);

Epaper_READBUSY();

}

void EPD_Part_Update(void)

{

Epaper_Write_Command(0x22);

Epaper_Write_Data(0xFF);

Epaper_Write_Command(0x20);

Epaper_READBUSY();

}

void EPD_DeepSleep(void)

{

Epaper_Write_Command(0x10); //enter deep sleep

Epaper_Write_Data(0x01);

delay(100);

}

void Epaper_READBUSY(void)

{

while(1)

{ //=1 BUSY

if(isEPD_W21_BUSY==0) break;

}

///////////////////////////Part update//////////////////////////////////////////////

void EPD_SetRAMValue_BaseMap( const unsigned char * datas)

{

unsigned int i;

const unsigned char *datas_flag;

datas_flag=datas;

Epaper_Write_Command(0x24); //Write Black and White image to RAM

for(i=0;i<ALLSCREEN_GRAGHBYTES;i++)

{

Epaper_Write_Data(pgm_read_byte(&datas[i]));

}

datas=datas_flag;

Epaper_Write_Command(0x26); //Write Black and White image to RAM

for(i=0;i<ALLSCREEN_GRAGHBYTES;i++)

{

Epaper_Write_Data(pgm_read_byte(&datas[i]));

}

EPD_Update();

}

void EPD_Dis_Part(unsigned int x_start,unsigned int y_start,const unsigned char * datas,unsigned int PART_COLUMN,unsigned int PART_LINE)

{

unsigned int i;

unsigned int x_end,y_start1,y_start2,y_end1,y_end2;

x_start=x_start/8;//

x_end=x_start+PART_LINE/8-1;

y_start1=0;

y_start2=y_start;

if(y_start>=256)

{

y_start1=y_start2/256;

y_start2=y_start2%256;

}

y_end1=0;

y_end2=y_start+PART_COLUMN-1;

if(y_end2>=256)

{

y_end1=y_end2/256;

y_end2=y_end2%256;

}

Epaper_Write_Command(0x44); // set RAM x address start/end, in page 35

Epaper_Write_Data(x_start); // RAM x address start at 00h;

Epaper_Write_Data(x_end); // RAM x address end at 0fh(15+1)*8->128

Epaper_Write_Command(0x45); // set RAM y address start/end, in page 35

Epaper_Write_Data(y_start2); // RAM y address start at 0127h;

Epaper_Write_Data(y_start1); // RAM y address start at 0127h;

Epaper_Write_Data(y_end2); // RAM y address end at 00h;

Epaper_Write_Data(y_end1); // ????=0

Epaper_Write_Command(0x4E); // set RAM x address count to 0;

Epaper_Write_Data(x_start);

Epaper_Write_Command(0x4F); // set RAM y address count to 0X127;

Epaper_Write_Data(y_start2);

Epaper_Write_Data(y_start1);

Epaper_Write_Command(0x24); //Write Black and White image to RAM

for(i=0;i<PART_COLUMN*PART_LINE/8;i++)

{

Epaper_Write_Data(pgm_read_byte(&datas[i]));

}

EPD_Part_Update();

}

/////////////////////////////////Single display////////////////////////////////////////////////

void EPD_WhiteScreen_Black(void)

{

unsigned int i,k;

Epaper_Write_Command(0x24); //write RAM for black(0)/white (1)

for(k=0;k<250;k++)

{

for(i=0;i<16;i++)

{

Epaper_Write_Data(0x00);

}

EPD_Update();

}

void EPD_WhiteScreen_White(void)

{

unsigned int i,k;

Epaper_Write_Command(0x24); //write RAM for black(0)/white (1)

for(k=0;k<250;k++)

{

for(i=0;i<16;i++)

{

Epaper_Write_Data(0xff);

}

EPD_Update();

}

树莓派代码（main.c）

#include <stdio.h>

#include <stdlib.h>

#include <time.h>

#include “epd1in54.h”

#include “epdpaint.h”

#include “imagedata.h”

#define COLORED 0

#define UNCOLORED 1

//Tips//

/*When the electronic paper is refreshed in full screen, the picture flicker is a normal phenomenon, and the main function is to clear the display afterimage in the previous picture.

When the local refresh is performed, the screen does not flash.*/

/*When you need to transplant the driver, you only need to change the corresponding IO. The BUSY pin is the input mode and the others are the output mode. */

int main(void)

{

time_t now;

struct tm* timenow;

Epd epd;

if (epd.Init(lut_full_update) != 0) {

printf(“e-Paper init failed\n”);

return -1;

}

//Full screen refresh

epd.EPD_HW_Init(); //Electronic paper initialization

epd.EPD_WhiteScreen_ALL(gImage_1); //Refresh the picture in full screen