查看“E-paper for Arduino Use”的源代码

==Arduino使用例程==
例程均在Arduino uno上进行了测试，如果需要是其他型号的Arduino需要自己确定连接的管脚是否正确。<br />
===硬件连接===
{|border=1; style="width:700px;" align="center"
|+Arduino UNO连接引脚对应关系
|-style="background:#2D6FDF; color:white;" align="center"
|e-Paper||Arduino
|-align="center"
|Vcc||5V
|-align="center"
|GND||GND
|-align="center"
|DIN||D11
|-align="center"
|CLK||D13
|-align="center"
|CS||D10
|-align="center"
|DC||D9
|-align="center"
|RST||D8
|-align="center"
|BUSY||D7
|}
===安装编译软件（windows教程）===
*打开浏览器，访问[https://www.arduino.cc/en/Main/Software arduinoIDE的官方下载页面]，不熟练英文没关系，可以切换到中文(点击可放大)：<br />
*点击此处下载软件<br />
[[file:e-paper_arduino_ide_software2.png]]<br />
*打开刚刚的下载的安装软件，双击安装，一路点击next即可：<br />
*快安装完成的时候，会弹出安装USB驱动，点击安装<br />
*安装完成，桌面生成了快捷打开方式，双击打开之后弹出arduino IDE软件<br />

==运行程序==
*在资料下载示例程序，然后解压。Arduino程序位于	~/Arduino/… <br />
*打开2.13inch的程序<br />
*打开程序，选择开发板型号Arduino  UNO<br />
*选择对应COM口<br />
*然后点击编译并下载即可<br />
【注意】由于arduino UNO的flash十分小，几款大尺寸的屏幕使用MEGA2560效果更佳：<br />

==程序说明==
===文件说明===
以Arduino UNO控制2.13寸墨水屏为例，打开epd2in13 v2目录：<br />
[[file:e-paper_arduino_ide_codeDescription1.png]]<br />
其中：<br />
epd2in13.ino：使用Arduino IDE打开即可；<br />
epd2in13.cpp(.h):是墨水屏的驱动程序；<br />
epdif.cpp(.h):是硬件接口定义，里面封装了读写管脚电平，SPI传输数据，以及管脚初始化；<br />
font8.cpp、font12.cpp、font16.cpp、font20.cpp、font24.cpp、fonts.h：为不同大小字符的模；<br />
imagedata.cpp(.h)：是图片数据，这个可以通过Img2Lcd(在开发资料中可下载)把2位深度的BMP图片转换成数组。<br />
程序分为底层硬件接口、中间层墨水屏驱动、上层应用；<br />

===底层硬件接口===
在epdif.cpp(.h)两个文件中定义了硬件接口，并封装好读写管脚电平、延时、SPI传输等函数。<br />
;写管脚电平 
<pre>
void DigitalWrite(int pin, int value)
</pre>
第一个参数为管脚、第二个为高低电平。<br />
;读管脚电平 
<pre>
int DigitalRead(int pin)
</pre>
参数为管脚，返回值为读取管脚的电平。<br />

;延时 
<pre>
DelayMs(unsigned int delaytime)
</pre>
毫秒级别延时。<br />

;SPI输出数据 
<pre>
SpiTransfer(unsigned char data)
</pre>
参数为char型，占8位。<br />

;硬件初始化 
<pre>
int IfInit(void)
</pre>
里面已经封装好了各管脚的输入输出，以及SPI的初始化。<br />

===中间层墨水屏驱动===
;实例化墨水屏
由于Arduino是C++开发，需要把墨水屏实例化：
<pre>
Epd epd;
</pre>

;墨水屏初始化，再屏幕开始工作时和退出睡眠模式之后调用
*2.13inch e-Paper，2.9inch e-Paper
<pre>
epd.Init(lut_full_update); //全刷初始化
epd.Init(lut_partial_update); //局刷初始化
</pre>

*4.2inch e-Paper
<pre>
epd.Init();
</pre>

;清屏，把墨水屏刷成白色
<pre>
epd.clear();
</pre>
可能某些程序里面会被拆分成两句，但是他们最终的效果都是一样的：<br />
<pre>
epd.ClearFrameMemory(0xFF); 
epd.DisplayFrame();//打开显示
</pre>

;传输一帧的图片数据并显示
<pre>
void Display(const unsigned char* frame_buffer);
void DisplayFrame(const unsigned char* frame_buffer_black, const unsigned char* frame_buffer_red); //三色屏幕
</pre>

;睡眠
<pre>
epd.Sleep();
</pre>
进入睡眠模式，墨水屏讲进入超低耗电，如果长时间不用需要刷白保存，否则长时间会有残影。<br />

===上层应用===
上层应用也就是我们的需要用墨水屏实现的功能，一般就是画图、字符等功能，也就是epdpaint.cpp里面定义的功能<br />
首先需要讲解一下缓存的坐标系，为了传输方便通常吧坐上定位原点，往右X轴增加，往下Y轴增加：<br />
[[file:e-paper_arduino_pic1.png|300px]]

打开epdpaint.h可以看到如下：<br />
[[file:e-paper_arduino_ide_codeDescription2.png]]<br />
只需要看public下函数即可：<br />

;初始化图片缓存
<pre>
Paint(unsigned char* image, int width, int height);
</pre>
第一个参数是图片缓存，第二个参数是定义图片长度，第三个参数定义图片高度，你可能会在程序中看到如下<br />
<pre>
Paint paint(image, 0, 0);    // width should be the multiple of 8
</pre>
第二、三个参数这里设置成0，是因为下面还可以设置。<br />

;设置高宽、获取高宽、设置翻转角度、获取翻转角度
<pre>
int  GetWidth(void); //得到宽度
void SetWidth(int width);//设置宽度
int  GetHeight(void);//得到高度
void SetHeight(int height);//设置高度
int  GetRotate(void);//得到翻转角度
void SetRotate(int rotate);//设置翻转角度
</pre>

;获取图像缓存
<pre>
unsigned char* GetImage(void);
</pre>

;画点
<pre>
void DrawPixel(int x, int y, int colored);
</pre>
在坐标（x,y）

;写字符
<pre>
void DrawCharAt(int x, int y, char ascii_char, sFONT* font, int colored);
</pre>
在（x,y）这一点为左顶点写字符ascii_char，字体大小为font，颜色为colored<br />

;写字符串
<pre>
void DrawStringAt(int x, int y, const char* text, sFONT* font, int colored);
</pre>
在（x,y）这一点为左顶点写字符串text，字体大小为font，颜色为colored<br />

;画线
<pre>
void DrawLine(int x0, int y0, int x1, int y1, int colored);
</pre>
以（x0,y0）为起点，（x1,y1）为终点画一条线，斜率任意；<br />

;画横线
<pre>
void DrawHorizontalLine(int x, int y, int width, int colored);
</pre>
以（x0,y0）为起点，（x1,y1）为终点画一条横线，速度比DrawLine()快<br />

;画竖线
<pre>
void DrawVerticalLine(int x, int y, int height, int colored);
</pre>
以（x0,y0）为起点，（x1,y1）为终点画一条竖线，速度比DrawLine()快<br />

;矩形，画空心框
<pre>
void DrawRectangle(int x0, int y0, int x1, int y1, int colored);
</pre>
以（x0,y0）为起点，（x1,y1）为终点画一个框，边的颜色为colored<br >

;填充矩形，画实心框
<pre>
void DrawFilledRectangle(int x0, int y0, int x1, int y1, int colored);
</pre>
以（x0,y0）为起点，（x1,y1）为终点画一个框，并且内部填充，颜色为colored<br >

;画空心圆
<pre>
void DrawCircle(int x, int y, int radius, int colored);
</pre>
以（x,y）为圆心，radius为半斤画一个空心圆，颜色为colored<br >

;画实心圆
<pre>
void DrawFilledCircle(int x, int y, int radius, int colored);
</pre>
以（x,y）为圆心，radius为半斤画一个实心心圆，颜色为colored<br >