From 8e18cc30e240293a9bb7024a5e0d75232ce81dab Mon Sep 17 00:00:00 2001 From: inmarket Date: Wed, 1 Apr 2015 00:29:18 +1000 Subject: [PATCH] First cut SSD1351 driver --- drivers/gdisp/SSD1351/SSD1351.h | 37 +++ .../gdisp/SSD1351/board_SSD1351_template.h | 60 ++++ drivers/gdisp/SSD1351/driver.mk | 2 + drivers/gdisp/SSD1351/gdisp_lld_SSD1351.c | 264 ++++++++++++++++++ drivers/gdisp/SSD1351/gdisp_lld_config.h | 25 ++ 5 files changed, 388 insertions(+) create mode 100644 drivers/gdisp/SSD1351/SSD1351.h create mode 100644 drivers/gdisp/SSD1351/board_SSD1351_template.h create mode 100644 drivers/gdisp/SSD1351/driver.mk create mode 100644 drivers/gdisp/SSD1351/gdisp_lld_SSD1351.c create mode 100644 drivers/gdisp/SSD1351/gdisp_lld_config.h diff --git a/drivers/gdisp/SSD1351/SSD1351.h b/drivers/gdisp/SSD1351/SSD1351.h new file mode 100644 index 00000000..67804c26 --- /dev/null +++ b/drivers/gdisp/SSD1351/SSD1351.h @@ -0,0 +1,37 @@ +#ifndef SSD1351_H +#define SSD1351_H + +#define SSD1351_SET_COLUMN_ADDRESS 0x15 +#define SSD1351_SET_ROW_ADDRESS 0x75 +#define SSD1351_WRITE_RAM 0x5C +#define SSD1351_READ_RAM 0x5D +#define SSD1351_SET_REMAP 0xA0 + +#define SSD1351_SET_DISPLAY_START 0xA1 +#define SSD1351_SET_DISPLAY_OFFSET 0xA2 +#define SSD1351_SET_DISPLAY_MODE_ALL_OFF 0xA4 +#define SSD1351_SET_DISPLAY_MODE_ALL_ON 0xA5 +#define SSD1351_SET_DISPLAY_MODE_RESET 0xA6 +#define SSD1351_SET_DISPLAY_MODE_INVERT 0xA7 +#define SSD1351_SET_FUNCTION_SELECT 0xAB +#define SSD1351_SET_SLEEP_ON 0xAE +#define SSD1351_SET_SLEEP_OFF 0xAF +#define SSD1351_SET_RESET_PRECHARGE 0xB1 + +#define SSD1351_DISPLAY_ENHANCEMENT 0xB2 +#define SSD1351_CLOCKDIV_OSCFREQ 0xB3 +#define SSD1351_SET_VSL 0xB4 +#define SSD1351_SET_GPIO 0xB5 +#define SSD1351_SET_SECOND_PRECHARGE 0xB6 + +#define SSD1351_LUT_GRAYSCALE 0xB8 +#define SSD1351_USE_BUILTIN_LUT 0xB9 +#define SSD1351_SET_PRECHARGE 0xBB +#define SSD1351_SET_VCOMH 0xBE + +#define SSD1351_SET_CONTRAST 0xC1 +#define SSD1351_MASTER_CONTRAST_CURRENT_CONTROL 0xC7 +#define SSD1351_SET_MUX_RATIO 0xCA +#define SSD1351_SET_COMMAND_LOCK 0xFD + +#endif // SSD1351_H diff --git a/drivers/gdisp/SSD1351/board_SSD1351_template.h b/drivers/gdisp/SSD1351/board_SSD1351_template.h new file mode 100644 index 00000000..e28ce23a --- /dev/null +++ b/drivers/gdisp/SSD1351/board_SSD1351_template.h @@ -0,0 +1,60 @@ +/* + * This file is subject to the terms of the GFX License. If a copy of + * the license was not distributed with this file, you can obtain one at: + * + * http://ugfx.org/license.html + */ + +#ifndef _GDISP_LLD_BOARD_H +#define _GDISP_LLD_BOARD_H + +static inline void init_board(GDisplay *g) { + (void) g; +} + +static inline void post_init_board(GDisplay *g) { + (void) g; +} + +static inline void setpin_reset(GDisplay *g, bool_t state) { + (void) g; + (void) state; +} + +static inline void set_backlight(GDisplay *g, uint8_t percent) { + (void) g; + (void) percent; +} + +static inline void acquire_bus(GDisplay *g) { + (void) g; +} + +static inline void release_bus(GDisplay *g) { + (void) g; +} + +static inline void write_cmd(GDisplay *g, uint8_t index) { + (void) g; + (void) index; +} + +static inline void write_data(GDisplay *g, uint8_t data) { + (void) g; + (void) data; +} + +static inline void setreadmode(GDisplay *g) { + (void) g; +} + +static inline void setwritemode(GDisplay *g) { + (void) g; +} + +static inline uint16_t read_data(GDisplay *g) { + (void) g; + return 0; +} + +#endif /* _GDISP_LLD_BOARD_H */ diff --git a/drivers/gdisp/SSD1351/driver.mk b/drivers/gdisp/SSD1351/driver.mk new file mode 100644 index 00000000..d96e11ea --- /dev/null +++ b/drivers/gdisp/SSD1351/driver.mk @@ -0,0 +1,2 @@ +GFXINC += $(GFXLIB)/drivers/gdisp/SSD1351 +GFXSRC += $(GFXLIB)/drivers/gdisp/SSD1351/gdisp_lld_SSD1351.c diff --git a/drivers/gdisp/SSD1351/gdisp_lld_SSD1351.c b/drivers/gdisp/SSD1351/gdisp_lld_SSD1351.c new file mode 100644 index 00000000..35f059cb --- /dev/null +++ b/drivers/gdisp/SSD1351/gdisp_lld_SSD1351.c @@ -0,0 +1,264 @@ +/* + * This file is subject to the terms of the GFX License. If a copy of + * the license was not distributed with this file, you can obtain one at: + * + * http://ugfx.org/license.html + */ + +#include "gfx.h" + +#if GFX_USE_GDISP + +#if defined(GDISP_SCREEN_HEIGHT) + #warning "GDISP: This low level driver does not support setting a screen size. It is being ignored." + #undef GISP_SCREEN_HEIGHT +#endif +#if defined(GDISP_SCREEN_WIDTH) + #warning "GDISP: This low level driver does not support setting a screen size. It is being ignored." + #undef GDISP_SCREEN_WIDTH +#endif + +#define GDISP_DRIVER_VMT GDISPVMT_SSD1351 +#include "gdisp_lld_config.h" +#include "src/gdisp/gdisp_driver.h" + +#include "board_SSD1351.h" + +/*===========================================================================*/ +/* Driver local definitions. */ +/*===========================================================================*/ + +#ifndef GDISP_SCREEN_HEIGHT + #define GDISP_SCREEN_HEIGHT 128 +#endif +#ifndef GDISP_SCREEN_WIDTH + #define GDISP_SCREEN_WIDTH 128 +#endif +#ifndef GDISP_INITIAL_CONTRAST + #define GDISP_INITIAL_CONTRAST 100 +#endif +#ifndef GDISP_INITIAL_BACKLIGHT + #define GDISP_INITIAL_BACKLIGHT 100 +#endif + +#include "SSD1351.h" + +/*===========================================================================*/ +/* Driver local functions. */ +/*===========================================================================*/ + +// Some common routines and macros +#define dummy_read(g) { volatile uint16_t dummy; dummy = read_data(g); (void) dummy; } +#define write_reg(g, reg, data) { write_cmd(g, reg); write_data(g, data); } + +/*===========================================================================*/ +/* Driver exported functions. */ +/*===========================================================================*/ + +LLDSPEC bool_t gdisp_lld_init(GDisplay *g) { + // No private area for this controller + g->priv = 0; + + // Initialise the board interface + init_board(g); + + // Hardware reset + setpin_reset(g, TRUE); + gfxSleepMilliseconds(20); + setpin_reset(g, FALSE); + gfxSleepMilliseconds(20); + + // Get the bus for the following initialisation commands + acquire_bus(g); + + write_reg(g, 0xFD, 0x12); // unlock OLED driver IC + write_reg(g, 0xFD, 0xB1); // make commands A1, B1, B3, BB, BE, C1 accesible in unlocked state + write_cmd(g, 0xAE); // sleep mode ON (display off) + write_reg(g, 0xB3, 0xF1); // Front clock divider / osc freq - Osc = 0xF; div = 2 + write_reg(g, 0xCA, 127); // set MUX ratio + write_reg(g, 0xA0, 0b01110100); // Set re-map / color depth + // [0] : address increment (0: horizontal, 1: vertical, reset 0) + // [1] : column remap (0: 0..127, 1: 127..0, reset 0) + // [2] : color remap (0: A->B->C, 1: C->B->A, reset 0) + // [3] : reserved + // [4] : column scan direction (0: top->down, 1: bottom->up, reset 0) + // [5] : odd/even split COM (0: disable, 1: enable, reset 1) + // [6..7] : color depth (00,01: 65k, 10: 262k, 11: 262k format 2) + + write_cmd(g, 0x15); // Set Column address + write_data(g, 0x00); // start + write_data(g, 0x7F); // end + + write_cmd(g, 0x75); // set row address + write_data(g, 0x00); // start + write_data(g, 0x7F); // end + + write_reg(g, 0xA1, 0x00); // set display start line - 0 + write_reg(g, 0xA2, 0x00); // set display offset - 0 + write_reg(g, 0xB5, 0x00); // set GPIO - both HiZ, input disabled + write_reg(g, 0xAB, 0x01); // enable internal VDD regulator + write_reg(g, 0xB1, 0x32); // set reset / pre-charge period - phase 2: 3 DCLKs, phase 1: 5 DCLKs + write_reg(g, 0xBE, 0x05); // set VComH voltage - 0.82*Vcc + write_reg(g, 0xBB, 0x17); // set pre-charge voltage - 0.6*Vcc + write_cmd(g, 0xA6); // set display mode: reset to normal display + + write_cmd(g, 0xC1); // set contrast current for A,B,C + write_data(g, 0xC8); + write_data(g, 0x80); + write_data(g, 0xC8); + + write_reg(g, 0xC7, 0x0F); // master contrast current control - no change + + write_cmd(g, 0xB4); // set segment low voltage + write_data(g, 0xA0); // external VSL + write_data(g, 0xB5); // hard value + write_data(g, 0x55); // hard value + + write_reg(g, 0xB6, 0x01); // set second pre-charge period - 1 DCLKs + write_cmd(g, 0xAF); // sleep mode OFF (display on) + write_cmd(g, 0x5C); // write to RAM + + release_bus(g); + + // Finish Init + post_init_board(g); + + // Release the bus + release_bus(g); + + /* Turn on the back-light */ + set_backlight(g, GDISP_INITIAL_BACKLIGHT); + + /* Initialise the GDISP structure */ + g->g.Width = GDISP_SCREEN_WIDTH; + g->g.Height = GDISP_SCREEN_HEIGHT; + g->g.Orientation = GDISP_ROTATE_0; + g->g.Powermode = powerOn; + g->g.Backlight = GDISP_INITIAL_BACKLIGHT; + g->g.Contrast = GDISP_INITIAL_CONTRAST; + return TRUE; +} + +#if GDISP_HARDWARE_STREAM_WRITE + LLDSPEC void gdisp_lld_write_start(GDisplay *g) { + acquire_bus(g); + write_cmd(g, SSD1351_SET_COLUMN_ADDRESS); + write_data(g, g->p.x); + write_data(g, g->p.x + g->p.cx - 1); + write_cmd(g, SSD1351_SET_ROW_ADDRESS); + write_data(g, g->p.y); + write_data(g, g->p.y + g->p.cy - 1); + write_cmd(g, SSD1351_WRITE_RAM); + } + LLDSPEC void gdisp_lld_write_color(GDisplay *g) { + LLDCOLOR_TYPE c; + + c = gdispColor2Native(g->p.color); + write_data(g, c >> 8); + write_data(g, c & 0xFF); + } + LLDSPEC void gdisp_lld_write_stop(GDisplay *g) { + release_bus(g); + } +#endif + +#if GDISP_HARDWARE_STREAM_READ + #error "SSD1351 - Stream Read is not supported yet" + LLDSPEC void gdisp_lld_read_start(GDisplay *g) { + acquire_bus(g); + //set_viewport(g); + //write_index(g, 0x2E); + setreadmode(g); + //dummy_read(g); + } + LLDSPEC color_t gdisp_lld_read_color(GDisplay *g) { + uint16_t data; + + data = read_data(g); + return gdispNative2Color(data); + } + LLDSPEC void gdisp_lld_read_stop(GDisplay *g) { + setwritemode(g); + release_bus(g); + } +#endif + +#if GDISP_NEED_CONTROL && GDISP_HARDWARE_CONTROL + #error "SSD1351 - Hardware control is not supported yet" + LLDSPEC void gdisp_lld_control(GDisplay *g) { + switch(g->p.x) { + case GDISP_CONTROL_POWER: + if (g->g.Powermode == (powermode_t)g->p.ptr) + return; + switch((powermode_t)g->p.ptr) { + case powerOff: + case powerSleep: + case powerDeepSleep: + acquire_bus(g); + //TODO + release_bus(g); + break; + case powerOn: + acquire_bus(g); + //TODO + release_bus(g); + break; + default: + return; + } + g->g.Powermode = (powermode_t)g->p.ptr; + return; + + case GDISP_CONTROL_ORIENTATION: + if (g->g.Orientation == (orientation_t)g->p.ptr) + return; + switch((orientation_t)g->p.ptr) { + case GDISP_ROTATE_0: + acquire_bus(g); + //TODO + release_bus(g); + g->g.Height = GDISP_SCREEN_HEIGHT; + g->g.Width = GDISP_SCREEN_WIDTH; + break; + case GDISP_ROTATE_90: + acquire_bus(g); + //TODO + release_bus(g); + g->g.Height = GDISP_SCREEN_WIDTH; + g->g.Width = GDISP_SCREEN_HEIGHT; + break; + case GDISP_ROTATE_180: + acquire_bus(g); + //TODO + release_bus(g); + g->g.Height = GDISP_SCREEN_HEIGHT; + g->g.Width = GDISP_SCREEN_WIDTH; + break; + case GDISP_ROTATE_270: + acquire_bus(g); + //TODO + release_bus(g); + g->g.Height = GDISP_SCREEN_WIDTH; + g->g.Width = GDISP_SCREEN_HEIGHT; + break; + default: + return; + } + g->g.Orientation = (orientation_t)g->p.ptr; + return; + + case GDISP_CONTROL_BACKLIGHT: + if ((unsigned)g->p.ptr > 100) + g->p.ptr = (void *)100; + set_backlight(g, (unsigned)g->p.ptr); + g->g.Backlight = (unsigned)g->p.ptr; + return; + + //case GDISP_CONTROL_CONTRAST: + default: + return; + } + } +#endif + +#endif /* GFX_USE_GDISP */ diff --git a/drivers/gdisp/SSD1351/gdisp_lld_config.h b/drivers/gdisp/SSD1351/gdisp_lld_config.h new file mode 100644 index 00000000..def94f44 --- /dev/null +++ b/drivers/gdisp/SSD1351/gdisp_lld_config.h @@ -0,0 +1,25 @@ +/* + * This file is subject to the terms of the GFX License. If a copy of + * the license was not distributed with this file, you can obtain one at: + * + * http://ugfx.org/license.html + */ + +#ifndef _GDISP_LLD_CONFIG_H +#define _GDISP_LLD_CONFIG_H + +#if GFX_USE_GDISP + +/*===========================================================================*/ +/* Driver hardware support. */ +/*===========================================================================*/ + +#define GDISP_HARDWARE_STREAM_WRITE TRUE +//#define GDISP_HARDWARE_STREAM_READ TRUE +//#define GDISP_HARDWARE_CONTROL TRUE + +#define GDISP_LLD_PIXELFORMAT GDISP_PIXELFORMAT_RGB565 + +#endif /* GFX_USE_GDISP */ + +#endif /* _GDISP_LLD_CONFIG_H */