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:
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); } }
epd1in54.h@0:ac97d71fe296, 2018-02-16 (annotated)
- Committer:
- imachooon
- Date:
- Fri Feb 16 21:30:08 2018 +0000
- Revision:
- 0:ac97d71fe296
initial commit
Who changed what in which revision?
User | Revision | Line number | New contents of line |
---|---|---|---|
imachooon | 0:ac97d71fe296 | 1 | /** |
imachooon | 0:ac97d71fe296 | 2 | * @filename : epd1in54.h |
imachooon | 0:ac97d71fe296 | 3 | * @brief : Header file for e-paper display library epd1in54b.cpp |
imachooon | 0:ac97d71fe296 | 4 | * @author : Yehui from Waveshare |
imachooon | 0:ac97d71fe296 | 5 | * |
imachooon | 0:ac97d71fe296 | 6 | * Copyright (C) Waveshare August 10 2017 |
imachooon | 0:ac97d71fe296 | 7 | * |
imachooon | 0:ac97d71fe296 | 8 | * Permission is hereby granted, free of charge, to any person obtaining a copy |
imachooon | 0:ac97d71fe296 | 9 | * of this software and associated documnetation files (the "Software"), to deal |
imachooon | 0:ac97d71fe296 | 10 | * in the Software without restriction, including without limitation the rights |
imachooon | 0:ac97d71fe296 | 11 | * to use, copy, modify, merge, publish, distribute, sublicense, and/or sell |
imachooon | 0:ac97d71fe296 | 12 | * copies of the Software, and to permit persons to whom the Software is |
imachooon | 0:ac97d71fe296 | 13 | * furished to do so, subject to the following conditions: |
imachooon | 0:ac97d71fe296 | 14 | * |
imachooon | 0:ac97d71fe296 | 15 | * The above copyright notice and this permission notice shall be included in |
imachooon | 0:ac97d71fe296 | 16 | * all copies or substantial portions of the Software. |
imachooon | 0:ac97d71fe296 | 17 | * |
imachooon | 0:ac97d71fe296 | 18 | * THE SOFTWARE IS PROVIDED "AS IS", WITHOUT WARRANTY OF ANY KIND, EXPRESS OR |
imachooon | 0:ac97d71fe296 | 19 | * IMPLIED, INCLUDING BUT NOT LIMITED TO THE WARRANTIES OF MERCHANTABILITY, |
imachooon | 0:ac97d71fe296 | 20 | * FITNESS OR A PARTICULAR PURPOSE AND NONINFRINGEMENT. IN NO EVENT SHALL THE |
imachooon | 0:ac97d71fe296 | 21 | * AUTHORS OR COPYRIGHT HOLDERS BE LIABLE FOR ANY CLAIM, DAMAGES OR OTHER |
imachooon | 0:ac97d71fe296 | 22 | * LIABILITY WHETHER IN AN ACTION OF CONTRACT, TORT OR OTHERWISE, ARISING FROM, |
imachooon | 0:ac97d71fe296 | 23 | * OUT OF OR IN CONNECTION WITH THE SOFTWARE OR THE USE OR OTHER DEALINGS IN |
imachooon | 0:ac97d71fe296 | 24 | * THE SOFTWARE. |
imachooon | 0:ac97d71fe296 | 25 | */ |
imachooon | 0:ac97d71fe296 | 26 | |
imachooon | 0:ac97d71fe296 | 27 | #ifndef EPD1IN54_H |
imachooon | 0:ac97d71fe296 | 28 | #define EPD1IN54_H |
imachooon | 0:ac97d71fe296 | 29 | |
imachooon | 0:ac97d71fe296 | 30 | #include "epdif.h" |
imachooon | 0:ac97d71fe296 | 31 | #include "fonts.h" |
imachooon | 0:ac97d71fe296 | 32 | |
imachooon | 0:ac97d71fe296 | 33 | #define LOW 0 |
imachooon | 0:ac97d71fe296 | 34 | #define HIGH 1 |
imachooon | 0:ac97d71fe296 | 35 | |
imachooon | 0:ac97d71fe296 | 36 | // Display resolution |
imachooon | 0:ac97d71fe296 | 37 | #define EPD_WIDTH 200 |
imachooon | 0:ac97d71fe296 | 38 | #define EPD_HEIGHT 200 |
imachooon | 0:ac97d71fe296 | 39 | |
imachooon | 0:ac97d71fe296 | 40 | #define COLORED 1 |
imachooon | 0:ac97d71fe296 | 41 | #define UNCOLORED 0 |
imachooon | 0:ac97d71fe296 | 42 | |
imachooon | 0:ac97d71fe296 | 43 | // EPD1IN54 commands |
imachooon | 0:ac97d71fe296 | 44 | #define DRIVER_OUTPUT_CONTROL 0x01 |
imachooon | 0:ac97d71fe296 | 45 | #define BOOSTER_SOFT_START_CONTROL 0x0C |
imachooon | 0:ac97d71fe296 | 46 | #define GATE_SCAN_START_POSITION 0x0F |
imachooon | 0:ac97d71fe296 | 47 | #define DEEP_SLEEP_MODE 0x10 |
imachooon | 0:ac97d71fe296 | 48 | #define DATA_ENTRY_MODE_SETTING 0x11 |
imachooon | 0:ac97d71fe296 | 49 | #define SW_RESET 0x12 |
imachooon | 0:ac97d71fe296 | 50 | #define TEMPERATURE_SENSOR_CONTROL 0x1A |
imachooon | 0:ac97d71fe296 | 51 | #define MASTER_ACTIVATION 0x20 |
imachooon | 0:ac97d71fe296 | 52 | #define DISPLAY_UPDATE_CONTROL_1 0x21 |
imachooon | 0:ac97d71fe296 | 53 | #define DISPLAY_UPDATE_CONTROL_2 0x22 |
imachooon | 0:ac97d71fe296 | 54 | #define WRITE_RAM 0x24 |
imachooon | 0:ac97d71fe296 | 55 | #define WRITE_VCOM_REGISTER 0x2C |
imachooon | 0:ac97d71fe296 | 56 | #define WRITE_LUT_REGISTER 0x32 |
imachooon | 0:ac97d71fe296 | 57 | #define SET_DUMMY_LINE_PERIOD 0x3A |
imachooon | 0:ac97d71fe296 | 58 | #define SET_GATE_TIME 0x3B |
imachooon | 0:ac97d71fe296 | 59 | #define BORDER_WAVEFORM_CONTROL 0x3C |
imachooon | 0:ac97d71fe296 | 60 | #define SET_RAM_X_ADDRESS_START_END_POSITION 0x44 |
imachooon | 0:ac97d71fe296 | 61 | #define SET_RAM_Y_ADDRESS_START_END_POSITION 0x45 |
imachooon | 0:ac97d71fe296 | 62 | #define SET_RAM_X_ADDRESS_COUNTER 0x4E |
imachooon | 0:ac97d71fe296 | 63 | #define SET_RAM_Y_ADDRESS_COUNTER 0x4F |
imachooon | 0:ac97d71fe296 | 64 | #define TERMINATE_FRAME_READ_WRITE 0xFF |
imachooon | 0:ac97d71fe296 | 65 | |
imachooon | 0:ac97d71fe296 | 66 | // Display orientation |
imachooon | 0:ac97d71fe296 | 67 | #define ROTATE_0 0 |
imachooon | 0:ac97d71fe296 | 68 | #define ROTATE_90 1 |
imachooon | 0:ac97d71fe296 | 69 | #define ROTATE_180 2 |
imachooon | 0:ac97d71fe296 | 70 | #define ROTATE_270 3 |
imachooon | 0:ac97d71fe296 | 71 | |
imachooon | 0:ac97d71fe296 | 72 | extern const unsigned char lut_full_update[]; |
imachooon | 0:ac97d71fe296 | 73 | extern const unsigned char lut_partial_update[]; |
imachooon | 0:ac97d71fe296 | 74 | |
imachooon | 0:ac97d71fe296 | 75 | class Epd : EpdIf { |
imachooon | 0:ac97d71fe296 | 76 | public: |
imachooon | 0:ac97d71fe296 | 77 | unsigned long width; |
imachooon | 0:ac97d71fe296 | 78 | unsigned long height; |
imachooon | 0:ac97d71fe296 | 79 | unsigned int rotate; |
imachooon | 0:ac97d71fe296 | 80 | |
imachooon | 0:ac97d71fe296 | 81 | |
imachooon | 0:ac97d71fe296 | 82 | Epd(PinName mosi, |
imachooon | 0:ac97d71fe296 | 83 | PinName miso, |
imachooon | 0:ac97d71fe296 | 84 | PinName sclk, |
imachooon | 0:ac97d71fe296 | 85 | PinName cs, |
imachooon | 0:ac97d71fe296 | 86 | PinName dc, |
imachooon | 0:ac97d71fe296 | 87 | PinName rst, |
imachooon | 0:ac97d71fe296 | 88 | PinName busy |
imachooon | 0:ac97d71fe296 | 89 | ); |
imachooon | 0:ac97d71fe296 | 90 | ~Epd(); |
imachooon | 0:ac97d71fe296 | 91 | int Init(const unsigned char* lut); |
imachooon | 0:ac97d71fe296 | 92 | void SendCommand(unsigned char command); |
imachooon | 0:ac97d71fe296 | 93 | void SendData(unsigned char data); |
imachooon | 0:ac97d71fe296 | 94 | void WaitUntilIdle(void); |
imachooon | 0:ac97d71fe296 | 95 | void Reset(void); |
imachooon | 0:ac97d71fe296 | 96 | |
imachooon | 0:ac97d71fe296 | 97 | void SetLut(const unsigned char* lut); |
imachooon | 0:ac97d71fe296 | 98 | void SetMemoryArea(int x_start, int y_start, int x_end, int y_end); |
imachooon | 0:ac97d71fe296 | 99 | void SetMemoryPointer(int x, int y); |
imachooon | 0:ac97d71fe296 | 100 | void SetFrameMemory(const unsigned char* image_buffer, int x, int y, int image_width, int image_height); |
imachooon | 0:ac97d71fe296 | 101 | void ClearFrameMemory(unsigned char color); |
imachooon | 0:ac97d71fe296 | 102 | void DisplayFrame(void); |
imachooon | 0:ac97d71fe296 | 103 | |
imachooon | 0:ac97d71fe296 | 104 | void Sleep(void); |
imachooon | 0:ac97d71fe296 | 105 | void SetRotate(int rotate); |
imachooon | 0:ac97d71fe296 | 106 | void SetPixel(unsigned char *frame_buffer, int x, int y, int colored); |
imachooon | 0:ac97d71fe296 | 107 | void SetAbsolutePixel(unsigned char *frame_buffer, int x, int y, int colored); |
imachooon | 0:ac97d71fe296 | 108 | void DrawLine(unsigned char *frame_buffer, int x0, int y0, int x1, int y1, int colored); |
imachooon | 0:ac97d71fe296 | 109 | void DrawHorizontalLine(unsigned char *frame_buffer, int x, int y, int width, int colored); |
imachooon | 0:ac97d71fe296 | 110 | void DrawVerticalLine(unsigned char *frame_buffer, int x, int y, int height, int colored); |
imachooon | 0:ac97d71fe296 | 111 | void DrawRectangle(unsigned char *frame_buffer, int x0, int y0, int x1, int y1, int colored); |
imachooon | 0:ac97d71fe296 | 112 | void DrawFilledRectangle(unsigned char *frame_buffer, int x0, int y0, int x1, int y1, int colored); |
imachooon | 0:ac97d71fe296 | 113 | void DrawCircle(unsigned char *frame_buffer, int x, int y, int radius, int colored); |
imachooon | 0:ac97d71fe296 | 114 | void DrawFilledCircle(unsigned char *frame_buffer, int x, int y, int radius, int colored); |
imachooon | 0:ac97d71fe296 | 115 | void DrawCharAt(unsigned char *frame_buffer, int x, int y, char ascii_char, sFONT* font, int colored); |
imachooon | 0:ac97d71fe296 | 116 | void DrawStringAt(unsigned char *frame_buffer, int x, int y, const char* text, sFONT* font, int colored); |
imachooon | 0:ac97d71fe296 | 117 | |
imachooon | 0:ac97d71fe296 | 118 | |
imachooon | 0:ac97d71fe296 | 119 | }; |
imachooon | 0:ac97d71fe296 | 120 | |
imachooon | 0:ac97d71fe296 | 121 | #endif /* EPD1IN54_H */ |
imachooon | 0:ac97d71fe296 | 122 | |
imachooon | 0:ac97d71fe296 | 123 | /* END OF FILE */ |