WaveShare e-paper module (epd1in54). Monochrome version

e-Paper Module

Description

Waveshare 1.54 e-paper module imported from offiicial code https://www.waveshare.com/wiki/1.54inch_e-Paper_Module Codes are referenced from official Arduino code and Raspberry pi code.

SPI is used for communication between ePaper module and mbed.

Following shapes can be used:

  • primitive shape (square, circle, line)
  • font (variable sizes)

Pull request are appreciated (Note that the original code is copyrighted by (C) Waveshare )

Example Output

Display output with example code will be like following image:

/media/uploads/imachooon/img_20180216_223238.jpg

Example Code

include the mbed library with this snippet

#include "mbed.h"
#include "epd1in54.h"
#include "m41t62_rtc.h"
// Control
PinName rst;
PinName dc;
PinName busy;
// SPI communication
PinName mosi;
PinName miso;
PinName sclk;
PinName cs;

DigitalOut myled(LED1);

unsigned char frame_black[EPD_HEIGHT*EPD_WIDTH/8];


int main() {
    mosi = p5;
    miso = p6;
    sclk = p7;
    cs = p8;
    rst = p9;
    dc = p10;
    busy = p11;
    
    memset(frame_black, 0xFF, sizeof(unsigned char)*EPD_HEIGHT*EPD_WIDTH/8);

    Epd epd = Epd(mosi, miso, sclk, cs, dc, rst, busy);
    if (epd.Init(lut_full_update) != 0){
        return -1;
    }

    /* Draw something to the frame buffer */
    // For simplicity, the arguments are explicit numerical coordinates
    epd.DrawRectangle(frame_black, 10, 60, 50, 110, COLORED);
    epd.DrawLine(frame_black, 10, 60, 50, 110, COLORED);
    epd.DrawLine(frame_black, 50, 60, 10, 110, COLORED);
    epd.DrawCircle(frame_black, 120, 80, 30, COLORED);
    epd.DrawFilledRectangle(frame_black, 10, 130, 50, 180, COLORED);
    epd.DrawFilledRectangle(frame_black, 0, 6, 200, 26, COLORED);
    epd.DrawFilledCircle(frame_black, 120, 150, 30, COLORED);

    /*Write strings to the buffer */
    epd.DrawStringAt(frame_black, 30, 30, "e-Paper Demo", &Font16, COLORED);
    epd.DrawStringAt(frame_black, 28, 10, "Hello world!", &Font16, UNCOLORED);


    
    /* Display the frame_buffer */
    epd.SetFrameMemory(frame_black, 0, 0, epd.width, epd.height);
    epd.DisplayFrame();
    epd.Sleep();

    
    while(1) {
        myled = 1;
        wait(0.5);
        myled = 0;
        wait(0.5);
    }
}

Committer:
imachooon
Date:
Fri Feb 16 21:30:08 2018 +0000
Revision:
0:ac97d71fe296
initial commit

Who changed what in which revision?

UserRevisionLine numberNew contents of line
imachooon 0:ac97d71fe296 1 /**
imachooon 0:ac97d71fe296 2 * @filename : epdif.cpp
imachooon 0:ac97d71fe296 3 * @brief : Implements EPD interface functions
imachooon 0:ac97d71fe296 4 * Users have to implement all the functions in epdif.cpp
imachooon 0:ac97d71fe296 5 * @author : Yehui from Waveshare
imachooon 0:ac97d71fe296 6 *
imachooon 0:ac97d71fe296 7 * Copyright (C) Waveshare August 10 2017
imachooon 0:ac97d71fe296 8 *
imachooon 0:ac97d71fe296 9 * Permission is hereby granted, free of charge, to any person obtaining a copy
imachooon 0:ac97d71fe296 10 * of this software and associated documnetation files (the "Software"), to deal
imachooon 0:ac97d71fe296 11 * in the Software without restriction, including without limitation the rights
imachooon 0:ac97d71fe296 12 * to use, copy, modify, merge, publish, distribute, sublicense, and/or sell
imachooon 0:ac97d71fe296 13 * copies of the Software, and to permit persons to whom the Software is
imachooon 0:ac97d71fe296 14 * furished to do so, subject to the following conditions:
imachooon 0:ac97d71fe296 15 *
imachooon 0:ac97d71fe296 16 * The above copyright notice and this permission notice shall be included in
imachooon 0:ac97d71fe296 17 * all copies or substantial portions of the Software.
imachooon 0:ac97d71fe296 18 *
imachooon 0:ac97d71fe296 19 * THE SOFTWARE IS PROVIDED "AS IS", WITHOUT WARRANTY OF ANY KIND, EXPRESS OR
imachooon 0:ac97d71fe296 20 * IMPLIED, INCLUDING BUT NOT LIMITED TO THE WARRANTIES OF MERCHANTABILITY,
imachooon 0:ac97d71fe296 21 * FITNESS OR A PARTICULAR PURPOSE AND NONINFRINGEMENT. IN NO EVENT SHALL THE
imachooon 0:ac97d71fe296 22 * AUTHORS OR COPYRIGHT HOLDERS BE LIABLE FOR ANY CLAIM, DAMAGES OR OTHER
imachooon 0:ac97d71fe296 23 * LIABILITY WHETHER IN AN ACTION OF CONTRACT, TORT OR OTHERWISE, ARISING FROM,
imachooon 0:ac97d71fe296 24 * OUT OF OR IN CONNECTION WITH THE SOFTWARE OR THE USE OR OTHER DEALINGS IN
imachooon 0:ac97d71fe296 25 * THE SOFTWARE.
imachooon 0:ac97d71fe296 26 */
imachooon 0:ac97d71fe296 27
imachooon 0:ac97d71fe296 28 #include "epdif.h"
imachooon 0:ac97d71fe296 29 EpdIf::EpdIf(){
imachooon 0:ac97d71fe296 30 }
imachooon 0:ac97d71fe296 31 EpdIf::EpdIf(PinName mosi,
imachooon 0:ac97d71fe296 32 PinName miso,
imachooon 0:ac97d71fe296 33 PinName sclk,
imachooon 0:ac97d71fe296 34 PinName cs,
imachooon 0:ac97d71fe296 35 PinName dc,
imachooon 0:ac97d71fe296 36 PinName rst,
imachooon 0:ac97d71fe296 37 PinName busy) {
imachooon 0:ac97d71fe296 38 m_spi = new SPI(mosi, miso, sclk);
imachooon 0:ac97d71fe296 39 m_cs = new DigitalOut(cs);
imachooon 0:ac97d71fe296 40 m_dc = new DigitalOut(dc);
imachooon 0:ac97d71fe296 41 m_rst = new DigitalOut(rst);
imachooon 0:ac97d71fe296 42 m_busy = new DigitalIn(busy);
imachooon 0:ac97d71fe296 43 }
imachooon 0:ac97d71fe296 44
imachooon 0:ac97d71fe296 45 EpdIf::~EpdIf() {
imachooon 0:ac97d71fe296 46 }
imachooon 0:ac97d71fe296 47
imachooon 0:ac97d71fe296 48 void EpdIf::DigitalWrite(DigitalOut* pout, int value) {
imachooon 0:ac97d71fe296 49 *pout = value;
imachooon 0:ac97d71fe296 50 }
imachooon 0:ac97d71fe296 51
imachooon 0:ac97d71fe296 52 int EpdIf::DigitalRead(DigitalIn* pin) {
imachooon 0:ac97d71fe296 53 int ret = *pin;
imachooon 0:ac97d71fe296 54 return ret;
imachooon 0:ac97d71fe296 55 }
imachooon 0:ac97d71fe296 56
imachooon 0:ac97d71fe296 57 void EpdIf::DelayMs(unsigned int delaytime) {
imachooon 0:ac97d71fe296 58 wait_ms(delaytime);
imachooon 0:ac97d71fe296 59 }
imachooon 0:ac97d71fe296 60
imachooon 0:ac97d71fe296 61 void EpdIf::SpiTransfer(unsigned char data) {
imachooon 0:ac97d71fe296 62 *m_cs = 0;
imachooon 0:ac97d71fe296 63 m_spi->write(data);
imachooon 0:ac97d71fe296 64 *m_cs = 1;
imachooon 0:ac97d71fe296 65 }
imachooon 0:ac97d71fe296 66
imachooon 0:ac97d71fe296 67 int EpdIf::IfInit(void){
imachooon 0:ac97d71fe296 68 m_spi->format(8,0);
imachooon 0:ac97d71fe296 69 m_spi->frequency(2000000);
imachooon 0:ac97d71fe296 70 return 0;
imachooon 0:ac97d71fe296 71 }
imachooon 0:ac97d71fe296 72
imachooon 0:ac97d71fe296 73