Add TLS8204 monochrome display. Not fully tested yet.

ugfx_release_2.6
inmarket 2015-01-27 13:42:46 +10:00
parent adebde7a99
commit 606eeff79f
5 changed files with 405 additions and 0 deletions

View File

@ -0,0 +1,87 @@
/*
* 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 _TLS8204_H
#define _TLS8204_H
// H1H0=xx =========================================
#define TLS8204_NOP 0x00 // H1H0=xx: NOP - 0 0 0 0 0 0 0 0
#define TLS8204_SET_FUNC 0x20 // H1H0=xx: Function set - 0 0 1 MX MY PD H1 H0
#define TLS8204_H0_BIT 0x01
#define TLS8204_H1_BIT 0x02
#define TLS8204_PD_BIT 0x04
#define TLS8204_MX_BIT 0x08
#define TLS8204_MY_BIT 0x10
// H1H0=00 =========================================
#define TLS8204_SET_VLCD7 0x04 // H1H0=00: Set Contrast bit7 - 0 0 0 0 0 1 0 V7
#define TLS8204_SET_DISPLAY_OFF 0x08 // H1H0=00: Display Control - 0 0 0 0 1 D 0 E (D = 0, E = 0)
#define TLS8204_SET_DISPLAY_FILL 0x09 // H1H0=00: Display Control - 0 0 0 0 1 D 0 E (D = 0, E = 1)
#define TLS8204_SET_DISPLAY_NORMAL 0x0C // H1H0=00: Display Control - 0 0 0 0 1 D 0 E (D = 1, E = 0)
#define TLS8204_SET_DISPLAY_INVERT 0x0D // H1H0=00: Display Control - 0 0 0 0 1 D 0 E (D = 1, E = 1)
#define TLS8204_SET_Y 0x40 // H1H0=00: Set Y/8 (page) - 0 1 0 0 Y3 Y2 Y1 Y0
#define TLS8204_SET_X 0x80 // H1H0=00: Set X (column) - 1 X6 X5 X4 X3 X2 X1 X0
// H1H0=01 =========================================
#define TLS8204_SET_STARTLINE_S6 0x04 // H1H0=01: Set Startline S6 - 0 0 0 0 0 1 0 S6
#define TLS8204_SET_STARTLINE_S0_5 0x40 // H1H0=01: Set Startline S0-5 - 0 1 S5 S4 S3 S2 S1 S0
#define TLS8204_SET_Y_LSB_FIRST 0x08 // H1H0=01: Set Y to LSB first - 0 0 0 0 1 D0 x x (D0 = 0)
#define TLS8204_SET_Y_MSB_FIRST 0x0C // H1H0=01: Set Y to LSB first - 0 0 0 0 1 D0 x x (D0 = 1)
#define TLS8204_SET_BIAS_7 0x10 // H1H0=01: Set Bias 1/100 - 0 0 0 1 0 B2 B1 B0
#define TLS8204_SET_BIAS_6 0x11 // H1H0=01: Set Bias 1/81 - 0 0 0 1 0 B2 B1 B0
#define TLS8204_SET_BIAS_5 0x12 // H1H0=01: Set Bias 1/65,68 - 0 0 0 1 0 B2 B1 B0
#define TLS8204_SET_BIAS_4 0x13 // H1H0=01: Set Bias 1/49 - 0 0 0 1 0 B2 B1 B0
#define TLS8204_SET_BIAS_3 0x14 // H1H0=01: Set Bias 1/40,36 - 0 0 0 1 0 B2 B1 B0
#define TLS8204_SET_BIAS_2 0x15 // H1H0=01: Set Bias 1/24 - 0 0 0 1 0 B2 B1 B0
#define TLS8204_SET_BIAS_1 0x16 // H1H0=01: Set Bias 1/18,16 - 0 0 0 1 0 B2 B1 B0
#define TLS8204_SET_BIAS_0 0x17 // H1H0=01: Set Bias 1/10,9,8 - 0 0 0 1 0 B2 B1 B0
#define TLS8204_SET_VLCD0_6 0x80 // H1H0=01: Set Contrast Bit0-6 - 1 V6 V5 V4 V3 V2 V1 V0 (Real range 36 - 219)
// H1H0=10 =========================================
#define TLS8204_SET_PARTIAL_OFF 0x04 // H1H0=10: Partial Mode Off - 0 0 0 0 0 1 0 PS (PS = 0)
#define TLS8204_SET_PARTIAL_ON 0x05 // H1H0=10: Partial Mode On - 0 0 0 0 0 1 0 PS (PS = 1)
#define TLS8204_SET_PARTIAL16 0x08 // H1H0=10: 16 line Partial - 0 0 0 0 1 0 0 WS (WS = 0)
#define TLS8204_SET_PARTIAL32 0x09 // H1H0=10: 32 line Partial - 0 0 0 0 1 0 0 WS (WS = 1)
#define TLS8204_SET_PARTIAL_Y 0x10 // H1H0=10: The Partial Y/8 (pg)- 0 0 0 1 0 P2 P1 P0
// H1H0=11 =========================================
#define TLS8204_RESET 0x03 // H1H0=11: Reset - 0 0 0 0 0 0 1 1
#define TLS8204_SET_FREQ55 0x08 // H1H0=11: Frame Frequency - 0 0 0 0 1 F2 F1 F0 (F = 0)
#define TLS8204_SET_FREQ65 0x09 // H1H0=11: Frame Frequency - 0 0 0 0 1 F2 F1 F0 (F = 1)
#define TLS8204_SET_FREQ68 0x0A // H1H0=11: Frame Frequency - 0 0 0 0 1 F2 F1 F0 (F = 2)
#define TLS8204_SET_FREQ70 0x0B // H1H0=11: Frame Frequency - 0 0 0 0 1 F2 F1 F0 (F = 3)
#define TLS8204_SET_FREQ73 0x0C // H1H0=11: Frame Frequency - 0 0 0 0 1 F2 F1 F0 (F = 4)
#define TLS8204_SET_FREQ76 0x0D // H1H0=11: Frame Frequency - 0 0 0 0 1 F2 F1 F0 (F = 5)
#define TLS8204_SET_FREQ80 0x0E // H1H0=11: Frame Frequency - 0 0 0 0 1 F2 F1 F0 (F = 6)
#define TLS8204_SET_FREQ137 0x0F // H1H0=11: Frame Frequency - 0 0 0 0 1 F2 F1 F0 (F = 7)
#define TLS8204_SET_INVERSION 0x40 // H1H0=11: Set line inversion - 0 1 0 L4 L3 L2 L1 L0 (Lines = 0 or L+2)
#define TLS8204_SET_BOOST 0x50 // H1H0=11: Set Boost - 1 0 0 1 E1 E0 B1 B0
#define TLS8204_BOOST_EFFICIENCY1 0x5C // H1H0=11: Set Boost - 1 0 0 1 E1 E0 B1 B0 (E1E0 = 3)
#define TLS8204_BOOST_EFFICIENCY2 0x58 // H1H0=11: Set Boost - 1 0 0 1 E1 E0 B1 B0 (E1E0 = 2)
#define TLS8204_BOOST_EFFICIENCY3 0x54 // H1H0=11: Set Boost - 1 0 0 1 E1 E0 B1 B0 (E1E0 = 1)
#define TLS8204_BOOST_EFFICIENCY4 0x50 // H1H0=11: Set Boost - 1 0 0 1 E1 E0 B1 B0 (E1E0 = 0)
#define TLS8204_BOOST_5X 0x53 // H1H0=11: Set Boost - 1 0 0 1 E1 E0 B1 B0 (B1B0 = 3)
#define TLS8204_BOOST_4X 0x52 // H1H0=11: Set Boost - 1 0 0 1 E1 E0 B1 B0 (B1B0 = 2)
#define TLS8204_BOOST_3X 0x51 // H1H0=11: Set Boost - 1 0 0 1 E1 E0 B1 B0 (B1B0 = 1)
#define TLS8204_BOOST_2X 0x50 // H1H0=11: Set Boost - 1 0 0 1 E1 E0 B1 B0 (B1B0 = 0)
#endif /* _TLS8204_H */

View File

@ -0,0 +1,43 @@
/*
* 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 acquire_bus(GDisplay *g) {
(void) g;
}
static inline void release_bus(GDisplay *g) {
(void) g;
}
static inline void write_cmd(GDisplay *g, uint8_t cmd) {
(void) g;
(void) cmd;
}
static inline void write_data(GDisplay *g, uint8_t* data, uint16_t length) {
(void) g;
(void) data;
(void) length;
}
#endif /* _GDISP_LLD_BOARD_H */

View File

@ -0,0 +1,2 @@
GFXINC += $(GFXLIB)/drivers/gdisp/TLS8204
GFXSRC += $(GFXLIB)/drivers/gdisp/TLS8204/gdisp_lld_TLS8204.c

View File

@ -0,0 +1,245 @@
/*
* 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
#define GDISP_DRIVER_VMT GDISPVMT_TLS8204
#include "drivers/gdisp/TLS8204/gdisp_lld_config.h"
#include "src/gdisp/gdisp_driver.h"
#include "board_TLS8204.h"
/*===========================================================================*/
/* Driver local definitions. */
/*===========================================================================*/
#define GDISP_TLS8204_HEIGHT 48
#define GDISP_TLS8204_WIDTH 84
#define GDISP_INITIAL_CONTRAST 51
#define GDISP_INITIAL_BACKLIGHT 100
#define GDISP_FLG_NEEDFLUSH (GDISP_FLG_DRIVER << 0)
#include "drivers/gdisp/TLS8204/TLS8204.h"
/*===========================================================================*/
/* Driver local routines. */
/*===========================================================================*/
// Some common routines and macros
#define RAM(g) ((uint8_t *)g->priv)
#define xyaddr(x, y) ((x) + ((y) >> 3) * GDISP_TLS8204_WIDTH)
#define xybit(y) (1 << ((y) & 7))
/*===========================================================================*/
/* Driver exported functions. */
/*===========================================================================*/
/*
* As this controller can't update on a pixel boundary we need to maintain the
* the entire display surface in memory so that we can do the necessary bit
* operations. Fortunately it is a small display in monochrome.
* Display 48 * 84 / 8 = 504 bytes
*/
#define GDISP_SCREEN_BYTES ((GDISP_TLS8204_WIDTH * GDISP_TLS8204_HEIGHT) / 8)
LLDSPEC bool_t gdisp_lld_init(GDisplay *g) {
// The private area is the display surface.
if (!(g->priv = gfxAlloc(GDISP_SCREEN_BYTES)))
gfxHalt("GDISP TLS8204: Failed to allocate private memory");
// Initialise the board interface
init_board(g);
// Hardware reset
setpin_reset(g, TRUE);
gfxSleepMilliseconds(100);
setpin_reset(g, FALSE);
gfxSleepMilliseconds(100);
acquire_bus(g);
// Soft reset - display on
write_cmd(g, TLS8204_SET_FUNC | TLS8204_H0_BIT | TLS8204_H1_BIT);
write_cmd(g, TLS8204_RESET);
gfxSleepMilliseconds(100);
// H0H1 = 01
write_cmd(g, TLS8204_SET_FUNC | TLS8204_H0_BIT);
write_cmd(g, TLS8204_SET_BIAS_4);
write_cmd(g, TLS8204_SET_Y_LSB_FIRST);
write_cmd(g, TLS8204_SET_VLCD0_6 + ((GDISP_INITIAL_CONTRAST * 2 + 22) & 0x7F));
// H0H1 = 00
write_cmd(g, TLS8204_SET_FUNC);
write_cmd(g, TLS8204_SET_VLCD7 + ((GDISP_INITIAL_CONTRAST * 2 + 22) >> 7));
write_cmd(g, TLS8204_SET_DISPLAY_NORMAL);
write_cmd(g, TLS8204_SET_X + 0);
write_cmd(g, TLS8204_SET_Y + 0/8);
// 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_TLS8204_WIDTH;
g->g.Height = GDISP_TLS8204_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_FLUSH
LLDSPEC void gdisp_lld_flush(GDisplay *g) {
// Don't flush if we don't need it.
if (!(g->flags & GDISP_FLG_NEEDFLUSH))
return;
acquire_bus(g);
write_cmd(g, TLS8204_SET_X + 0); // X = 0
write_cmd(g, TLS8204_SET_Y + 0/8); // Y = 0
write_data(g, RAM(g), GDISP_SCREEN_BYTES);
release_bus(g);
}
#endif
#if GDISP_HARDWARE_DRAWPIXEL
LLDSPEC void gdisp_lld_draw_pixel(GDisplay *g) {
coord_t x, y;
#if GDISP_NEED_CONTROL
switch(g->g.Orientation) {
default:
case GDISP_ROTATE_0:
x = g->p.x;
y = g->p.y;
break;
case GDISP_ROTATE_90:
x = g->p.y;
y = g->g.Width - g->p.x - 1;
break;
case GDISP_ROTATE_180:
x = g->g.Width - g->p.x - 1;
y = g->g.Height - g->p.y - 1;
break;
case GDISP_ROTATE_270:
x = g->g.Height - g->p.y - 1;
y = g->p.x;
break;
}
#else
x = g->p.x;
y = g->p.y;
#endif
if (gdispColor2Native(g->p.color) != gdispColor2Native(Black)) {
RAM(g)[xyaddr(x, y)] |= xybit(y);
} else {
RAM(g)[xyaddr(x, y)] &= ~xybit(y);
}
g->flags |= GDISP_FLG_NEEDFLUSH;
}
#endif
#if GDISP_NEED_CONTROL
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);
write_cmd(g, TLS8204_SET_FUNC | TLS8204_PD_BIT);
release_bus(g);
break;
case powerOn:
acquire_bus(g);
write_cmd(g, TLS8204_SET_FUNC);
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:
case GDISP_ROTATE_180:
if (g->g.Orientation == GDISP_ROTATE_90 || g->g.Orientation == GDISP_ROTATE_270) {
coord_t tmp;
tmp = g->g.Width;
g->g.Width = g->g.Height;
g->g.Height = tmp;
}
break;
case GDISP_ROTATE_90:
case GDISP_ROTATE_270:
if (g->g.Orientation == GDISP_ROTATE_0 || g->g.Orientation == GDISP_ROTATE_180) {
coord_t tmp;
tmp = g->g.Width;
g->g.Width = g->g.Height;
g->g.Height = tmp;
}
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:
if ((unsigned)g->p.ptr > 100) g->p.ptr = (void *)100;
{
uint8_t cval;
cval = (unsigned)g->p.ptr * 2 + 22;
acquire_bus(g);
write_cmd(g, TLS8204_SET_FUNC | TLS8204_H0_BIT); // H1H0 = 01
write_cmd(g, TLS8204_SET_VLCD0_6 + (cval & 0x7F));
write_cmd(g, TLS8204_SET_FUNC); // H1H0 = 00
write_cmd(g, TLS8204_SET_VLCD7 + (cval >> 7));
release_bus(g);
}
g->g.Contrast = (unsigned)g->p.ptr;
return;
}
}
#endif
#endif // GFX_USE_GDISP

View File

@ -0,0 +1,28 @@
/*
* 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_FLUSH TRUE // This controller requires flushing
#define GDISP_HARDWARE_DRAWPIXEL TRUE
#define GDISP_HARDWARE_CONTROL TRUE
// Set this to your frame buffer pixel format.
#ifndef GDISP_LLD_PIXELFORMAT
#define GDISP_LLD_PIXELFORMAT GDISP_PIXELFORMAT_MONO
#endif
#endif /* GFX_USE_GDISP */
#endif /* _GDISP_LLD_CONFIG_H */