-
Notifications
You must be signed in to change notification settings - Fork 23
Commit
This commit does not belong to any branch on this repository, and may belong to a fork outside of the repository.
- Loading branch information
0 parents
commit 8d4748c
Showing
131 changed files
with
23,662 additions
and
0 deletions.
There are no files selected for viewing
Large diffs are not rendered by default.
Oops, something went wrong.
Large diffs are not rendered by default.
Oops, something went wrong.
271 changes: 271 additions & 0 deletions
271
gdeh029a1_2.9inch_e-paper/raspberrypi/python/epd2in9.py
This file contains bidirectional Unicode text that may be interpreted or compiled differently than what appears below. To review, open the file in an editor that reveals hidden Unicode characters.
Learn more about bidirectional Unicode characters
Original file line number | Diff line number | Diff line change |
---|---|---|
@@ -0,0 +1,271 @@ | ||
## | ||
# @filename : epd2in9.py | ||
# @brief : Implements for e-paper library | ||
# @author : Yehui from Waveshare | ||
# | ||
# Copyright (C) Waveshare September 9 2017 | ||
# | ||
# 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. | ||
# | ||
|
||
import epdif | ||
import Image | ||
import RPi.GPIO as GPIO | ||
|
||
# Display resolution | ||
EPD_WIDTH = 128 | ||
EPD_HEIGHT = 296 | ||
|
||
# EPD2IN9 commands | ||
DRIVER_OUTPUT_CONTROL = 0x01 | ||
BOOSTER_SOFT_START_CONTROL = 0x0C | ||
GATE_SCAN_START_POSITION = 0x0F | ||
DEEP_SLEEP_MODE = 0x10 | ||
DATA_ENTRY_MODE_SETTING = 0x11 | ||
SW_RESET = 0x12 | ||
TEMPERATURE_SENSOR_CONTROL = 0x1A | ||
MASTER_ACTIVATION = 0x20 | ||
DISPLAY_UPDATE_CONTROL_1 = 0x21 | ||
DISPLAY_UPDATE_CONTROL_2 = 0x22 | ||
WRITE_RAM = 0x24 | ||
WRITE_VCOM_REGISTER = 0x2C | ||
WRITE_LUT_REGISTER = 0x32 | ||
SET_DUMMY_LINE_PERIOD = 0x3A | ||
SET_GATE_TIME = 0x3B | ||
BORDER_WAVEFORM_CONTROL = 0x3C | ||
SET_RAM_X_ADDRESS_START_END_POSITION = 0x44 | ||
SET_RAM_Y_ADDRESS_START_END_POSITION = 0x45 | ||
SET_RAM_X_ADDRESS_COUNTER = 0x4E | ||
SET_RAM_Y_ADDRESS_COUNTER = 0x4F | ||
TERMINATE_FRAME_READ_WRITE = 0xFF | ||
|
||
class EPD: | ||
def __init__(self): | ||
self.reset_pin = epdif.RST_PIN | ||
self.dc_pin = epdif.DC_PIN | ||
self.busy_pin = epdif.BUSY_PIN | ||
self.width = EPD_WIDTH | ||
self.height = EPD_HEIGHT | ||
self.lut = self.lut_full_update | ||
|
||
lut_full_update = [ | ||
0x02, 0x02, 0x01, 0x11, 0x12, 0x12, 0x22, 0x22, | ||
0x66, 0x69, 0x69, 0x59, 0x58, 0x99, 0x99, 0x88, | ||
0x00, 0x00, 0x00, 0x00, 0xF8, 0xB4, 0x13, 0x51, | ||
0x35, 0x51, 0x51, 0x19, 0x01, 0x00 | ||
] | ||
|
||
lut_partial_update = [ | ||
0x10, 0x18, 0x18, 0x08, 0x18, 0x18, 0x08, 0x00, | ||
0x00, 0x00, 0x00, 0x00, 0x00, 0x00, 0x00, 0x00, | ||
0x00, 0x00, 0x00, 0x00, 0x13, 0x14, 0x44, 0x12, | ||
0x00, 0x00, 0x00, 0x00, 0x00, 0x00 | ||
] | ||
|
||
def digital_write(self, pin, value): | ||
epdif.epd_digital_write(pin, value) | ||
|
||
def digital_read(self, pin): | ||
return epdif.epd_digital_read(pin) | ||
|
||
def delay_ms(self, delaytime): | ||
epdif.epd_delay_ms(delaytime) | ||
|
||
def send_command(self, command): | ||
self.digital_write(self.dc_pin, GPIO.LOW) | ||
# the parameter type is list but not int | ||
# so use [command] instead of command | ||
epdif.spi_transfer([command]) | ||
|
||
def send_data(self, data): | ||
self.digital_write(self.dc_pin, GPIO.HIGH) | ||
# the parameter type is list but not int | ||
# so use [data] instead of data | ||
epdif.spi_transfer([data]) | ||
|
||
def init(self, lut): | ||
if (epdif.epd_init() != 0): | ||
return -1 | ||
# EPD hardware init start | ||
self.lut = lut | ||
self.reset() | ||
self.send_command(DRIVER_OUTPUT_CONTROL) | ||
self.send_data((EPD_HEIGHT - 1) & 0xFF) | ||
self.send_data(((EPD_HEIGHT - 1) >> 8) & 0xFF) | ||
self.send_data(0x00) # GD = 0 SM = 0 TB = 0 | ||
self.send_command(BOOSTER_SOFT_START_CONTROL) | ||
self.send_data(0xD7) | ||
self.send_data(0xD6) | ||
self.send_data(0x9D) | ||
self.send_command(WRITE_VCOM_REGISTER) | ||
self.send_data(0xA8) # VCOM 7C | ||
self.send_command(SET_DUMMY_LINE_PERIOD) | ||
self.send_data(0x1A) # 4 dummy lines per gate | ||
self.send_command(SET_GATE_TIME) | ||
self.send_data(0x08) # 2us per line | ||
self.send_command(DATA_ENTRY_MODE_SETTING) | ||
self.send_data(0x03) # X increment Y increment | ||
self.set_lut(self.lut) | ||
# EPD hardware init end | ||
return 0 | ||
|
||
def wait_until_idle(self): | ||
while(self.digital_read(self.busy_pin) == 1): # 0: idle, 1: busy | ||
self.delay_ms(100) | ||
## | ||
# @brief: module reset. | ||
# often used to awaken the module in deep sleep, | ||
## | ||
def reset(self): | ||
self.digital_write(self.reset_pin, GPIO.LOW) # module reset | ||
self.delay_ms(200) | ||
self.digital_write(self.reset_pin, GPIO.HIGH) | ||
self.delay_ms(200) | ||
|
||
## | ||
# @brief: set the look-up table register | ||
## | ||
def set_lut(self, lut): | ||
self.lut = lut | ||
self.send_command(WRITE_LUT_REGISTER) | ||
# the length of look-up table is 30 bytes | ||
for i in range(0, len(lut)): | ||
self.send_data(self.lut[i]) | ||
|
||
## | ||
# @brief: convert an image to a buffer | ||
## | ||
def get_frame_buffer(self, image): | ||
buf = [0x00] * (self.width * self.height / 8) | ||
# Set buffer to value of Python Imaging Library image. | ||
# Image must be in mode 1. | ||
image_monocolor = image.convert('1') | ||
imwidth, imheight = image_monocolor.size | ||
if imwidth != self.width or imheight != self.height: | ||
raise ValueError('Image must be same dimensions as display \ | ||
({0}x{1}).' .format(self.width, self.height)) | ||
|
||
pixels = image_monocolor.load() | ||
for y in range(self.height): | ||
for x in range(self.width): | ||
# Set the bits for the column of pixels at the current position. | ||
if pixels[x, y] != 0: | ||
buf[(x + y * self.width) / 8] |= 0x80 >> (x % 8) | ||
return buf | ||
|
||
## | ||
# @brief: put an image to the frame memory. | ||
# this won't update the display. | ||
## | ||
def set_frame_memory(self, image, x, y): | ||
if (image == None or x < 0 or y < 0): | ||
return | ||
image_monocolor = image.convert('1') | ||
image_width, image_height = image_monocolor.size | ||
# x point must be the multiple of 8 or the last 3 bits will be ignored | ||
x = x & 0xF8 | ||
image_width = image_width & 0xF8 | ||
if (x + image_width >= self.width): | ||
x_end = self.width - 1 | ||
else: | ||
x_end = x + image_width - 1 | ||
if (y + image_height >= self.height): | ||
y_end = self.height - 1 | ||
else: | ||
y_end = y + image_height - 1 | ||
self.set_memory_area(x, y, x_end, y_end) | ||
self.set_memory_pointer(x, y) | ||
self.send_command(WRITE_RAM) | ||
# send the image data | ||
pixels = image_monocolor.load() | ||
byte_to_send = 0x00 | ||
for j in range(0, y_end - y + 1): | ||
# 1 byte = 8 pixels, steps of i = 8 | ||
for i in range(0, x_end - x + 1): | ||
# Set the bits for the column of pixels at the current position. | ||
if pixels[i, j] != 0: | ||
byte_to_send |= 0x80 >> (i % 8) | ||
if (i % 8 == 7): | ||
self.send_data(byte_to_send) | ||
byte_to_send = 0x00 | ||
|
||
## | ||
# @brief: clear the frame memory with the specified color. | ||
# this won't update the display. | ||
## | ||
def clear_frame_memory(self, color): | ||
self.set_memory_area(0, 0, self.width - 1, self.height - 1) | ||
self.set_memory_pointer(0, 0) | ||
self.send_command(WRITE_RAM) | ||
# send the color data | ||
for i in range(0, self.width / 8 * self.height): | ||
self.send_data(color) | ||
|
||
## | ||
# @brief: update the display | ||
# there are 2 memory areas embedded in the e-paper display | ||
# but once this function is called, | ||
# the the next action of SetFrameMemory or ClearFrame will | ||
# set the other memory area. | ||
## | ||
def display_frame(self): | ||
self.send_command(DISPLAY_UPDATE_CONTROL_2) | ||
self.send_data(0xC4) | ||
self.send_command(MASTER_ACTIVATION) | ||
self.send_command(TERMINATE_FRAME_READ_WRITE) | ||
self.wait_until_idle() | ||
|
||
## | ||
# @brief: specify the memory area for data R/W | ||
## | ||
def set_memory_area(self, x_start, y_start, x_end, y_end): | ||
self.send_command(SET_RAM_X_ADDRESS_START_END_POSITION) | ||
# x point must be the multiple of 8 or the last 3 bits will be ignored | ||
self.send_data((x_start >> 3) & 0xFF) | ||
self.send_data((x_end >> 3) & 0xFF) | ||
self.send_command(SET_RAM_Y_ADDRESS_START_END_POSITION) | ||
self.send_data(y_start & 0xFF) | ||
self.send_data((y_start >> 8) & 0xFF) | ||
self.send_data(y_end & 0xFF) | ||
self.send_data((y_end >> 8) & 0xFF) | ||
|
||
## | ||
# @brief: specify the start point for data R/W | ||
## | ||
def set_memory_pointer(self, x, y): | ||
self.send_command(SET_RAM_X_ADDRESS_COUNTER) | ||
# x point must be the multiple of 8 or the last 3 bits will be ignored | ||
self.send_data((x >> 3) & 0xFF) | ||
self.send_command(SET_RAM_Y_ADDRESS_COUNTER) | ||
self.send_data(y & 0xFF) | ||
self.send_data((y >> 8) & 0xFF) | ||
self.wait_until_idle() | ||
|
||
## | ||
# @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. | ||
# You can use reset() to awaken or init() to initialize | ||
## | ||
def sleep(self): | ||
self.send_command(DEEP_SLEEP_MODE) | ||
self.wait_until_idle() | ||
|
||
### END OF FILE ### | ||
|
Binary file not shown.
This file contains bidirectional Unicode text that may be interpreted or compiled differently than what appears below. To review, open the file in an editor that reveals hidden Unicode characters.
Learn more about bidirectional Unicode characters
Original file line number | Diff line number | Diff line change |
---|---|---|
@@ -0,0 +1,63 @@ | ||
## | ||
# @filename : epdif.py | ||
# @brief : EPD hardware interface implements (GPIO, SPI) | ||
# @author : Yehui from Waveshare | ||
# | ||
# Copyright (C) Waveshare July 10 2017 | ||
# | ||
# 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. | ||
# | ||
|
||
import spidev | ||
import RPi.GPIO as GPIO | ||
import time | ||
|
||
# Pin definition | ||
RST_PIN = 17 | ||
DC_PIN = 25 | ||
CS_PIN = 8 | ||
BUSY_PIN = 24 | ||
|
||
# SPI device, bus = 0, device = 0 | ||
SPI = spidev.SpiDev(0, 0) | ||
|
||
def epd_digital_write(pin, value): | ||
GPIO.output(pin, value) | ||
|
||
def epd_digital_read(pin): | ||
return GPIO.input(BUSY_PIN) | ||
|
||
def epd_delay_ms(delaytime): | ||
time.sleep(delaytime / 1000.0) | ||
|
||
def spi_transfer(data): | ||
SPI.writebytes(data) | ||
|
||
def epd_init(): | ||
GPIO.setmode(GPIO.BCM) | ||
GPIO.setwarnings(False) | ||
GPIO.setup(RST_PIN, GPIO.OUT) | ||
GPIO.setup(DC_PIN, GPIO.OUT) | ||
GPIO.setup(CS_PIN, GPIO.OUT) | ||
GPIO.setup(BUSY_PIN, GPIO.IN) | ||
SPI.max_speed_hz = 2000000 | ||
SPI.mode = 0b00 | ||
return 0; | ||
|
||
### END OF FILE ### |
Binary file not shown.
Oops, something went wrong.