Convert Nokia6610GE12 driver to new format.

ugfx_release_2.6
inmarket 2013-10-19 15:38:00 +10:00
parent 87a6af81f4
commit e9895b5d14
5 changed files with 349 additions and 359 deletions

View File

@ -6,11 +6,8 @@
*/
/**
* @file drivers/gdisp/Nokia6610GE8/gdisp_lld_board_olimexsam7ex256.h
* @file drivers/gdisp/Nokia6610GE8/board_Nokia6610GE12_olimexsam7ex256.h
* @brief GDISP Graphic Driver subsystem board interface for the Olimex SAM7-EX256 board.
*
* @addtogroup GDISP
* @{
*/
#ifndef _GDISP_LLD_BOARD_H
@ -28,6 +25,9 @@
//#define GDISP_INITIAL_CONTRAST 50 // The initial contrast percentage
//#define GDISP_INITIAL_BACKLIGHT 100 // The initial backlight percentage
// For a multiple display configuration we would put all this in a structure and then
// set g->priv to that structure.
// ******************************************************
// Pointers to AT91SAM7X256 peripheral data structures
// ******************************************************
@ -57,17 +57,13 @@ static const PWMConfig pwmcfg = {
static bool_t pwmRunning = FALSE;
/**
* @brief Initialise the board for the display.
* @notes Performs the following functions:
* 1. initialise the spi port used by your display
* 2. initialise the reset pin (initial state not-in-reset)
* 3. initialise the chip select pin (initial state not-active)
* 4. initialise the backlight pin (initial state back-light off)
*
* @notapi
*/
static inline void init_board(void) {
static inline void init_board(GDisplay *g) {
// As we are not using multiple displays we set g->priv to NULL as we don't use it.
g->priv = 0;
switch(g->controllerdisplay) {
case 0: // Set up for Display 0
// *********************************************************************************************
// InitSpi( )
//
@ -118,6 +114,8 @@ static inline void init_board(void) {
/* Display backlight control at 100% */
pwmRunning = FALSE;
palSetPad(IOPORT2, PIOB_LCD_BL);
break;
}
}
/**
@ -127,7 +125,8 @@ static inline void init_board(void) {
*
* @notapi
*/
static inline void setpin_reset(bool_t state) {
static inline void setpin_reset(GDisplay *g, bool_t state) {
(void) g;
if (state)
palClearPad(IOPORT1, PIOA_LCD_RESET);
else
@ -144,7 +143,9 @@ static inline void setpin_reset(bool_t state) {
*
* @notapi
*/
static inline void set_backlight(uint8_t percent) {
static inline void set_backlight(GDisplay *g, uint8_t percent) {
(void) g;
if (percent == 100) {
/* Turn the pin on - No PWM */
if (pwmRunning) {
@ -174,7 +175,8 @@ static inline void set_backlight(uint8_t percent) {
*
* @notapi
*/
static inline void acquire_bus(void) {
static inline void acquire_bus(GDisplay *g) {
(void) g;
/* Nothing to do for this board as the LCD is the only device on the SPI port */
}
@ -183,7 +185,8 @@ static inline void acquire_bus(void) {
*
* @notapi
*/
static inline void release_bus(void) {
static inline void release_bus(GDisplay *g) {
(void) g;
// Nothing to do for this board as the LCD is the only device on the SPI port
}
@ -194,7 +197,9 @@ static inline void release_bus(void) {
*
* @notapi
*/
static inline void write_cmd(uint16_t cmd) {
static inline void write_index(GDisplay *g, uint16_t cmd) {
(void) g;
// wait for the previous transfer to complete
while((pSPI->SPI_SR & AT91C_SPI_TXEMPTY) == 0);
// send the command
@ -208,26 +213,13 @@ static inline void write_cmd(uint16_t cmd) {
*
* @notapi
*/
static inline void write_data(uint16_t data) {
static inline void write_data(GDisplay *g, uint16_t data) {
(void) g;
// wait for the previous transfer to complete
while((pSPI->SPI_SR & AT91C_SPI_TXEMPTY) == 0);
// send the data
pSPI->SPI_TDR = data | 0x0100;
}
#if GDISP_HARDWARE_READPIXEL || GDISP_HARDWARE_SCROLL || defined(__DOXYGEN__)
/**
* @brief Read data from the lcd.
*
* @return The data from the lcd
*
* @notapi
*/
static inline uint16_t read_data(void) {
#error "gdispNokia6610GE12: GDISP_HARDWARE_READPIXEL and GDISP_HARDWARE_SCROLL are not supported on this board"
return 0;
}
#endif
#endif /* _GDISP_LLD_BOARD_H */
/** @} */

View File

@ -6,7 +6,7 @@
*/
/**
* @file drivers/gdisp/Nokia6610GE12/gdisp_lld_board_template.h
* @file drivers/gdisp/Nokia6610GE12/board_Nokia6610GE12_template.h
* @brief GDISP Graphic Driver subsystem board interface for the Nokia6610 GE12 display.
*
* @addtogroup GDISP
@ -30,97 +30,102 @@
/**
* @brief Initialise the board for the display.
* @notes Performs the following functions:
* 1. initialise the spi port used by your display
* 2. initialise the reset pin (initial state not-in-reset)
* 3. initialise the chip select pin (initial state not-active)
* 4. initialise the backlight pin (initial state back-light off)
*
* @param[in] g The GDisplay structure
*
* @note Set the g->priv member to whatever is appropriate. For multiple
* displays this might be a pointer to the appropriate register set.
*
* @notapi
*/
static inline void init_board(void) {
static inline void init_board(GDisplay *g) {
(void) g;
}
/**
* @brief After the initialisation.
*
* @param[in] g The GDisplay structure
*
* @notapi
*/
static inline void post_init_board(GDisplay *g) {
(void) g;
}
/**
* @brief Set or clear the lcd reset pin.
*
* @param[in] g The GDisplay structure
* @param[in] state TRUE = lcd in reset, FALSE = normal operation
*
* @notapi
*/
static inline void setpin_reset(bool_t state) {
static inline void setpin_reset(GDisplay *g, bool_t state) {
(void) g;
(void) state;
}
/**
* @brief Set the lcd back-light level.
* @note For now 0% turns the backlight off, anything else the backlight is on.
* While the hardware supports PWM backlight control, we are not using it
* yet.
*
* @param[in] g The GDisplay structure
* @param[in] percent 0 to 100%
*
* @notapi
*/
static inline void set_backlight(uint8_t percent) {
static inline void set_backlight(GDisplay *g, uint8_t percent) {
(void) g;
(void) percent;
}
/**
* @brief Take exclusive control of the bus
*
* @param[in] g The GDisplay structure
*
* @notapi
*/
static inline void acquire_bus(void) {
static inline void acquire_bus(GDisplay *g) {
(void) g;
}
/**
* @brief Release exclusive control of the bus
*
* @notapi
*/
static inline void release_bus(void) {
}
/**
* @brief Send an 8 bit command to the lcd.
*
* @param[in] cmd The command to send
* @param[in] g The GDisplay structure
*
* @notapi
*/
static inline void write_cmd(uint16_t cmd) {
static inline void release_bus(GDisplay *g) {
(void) g;
}
/**
* @brief Send an 8 bit data to the lcd.
* @brief Send data to the index register.
*
* @param[in] g The GDisplay structure
* @param[in] index The index register to set
*
* @notapi
*/
static inline void write_index(GDisplay *g, uint16_t index) {
(void) g;
(void) index;
}
/**
* @brief Send data to the lcd.
*
* @param[in] g The GDisplay structure
* @param[in] data The data to send
*
* @notapi
*/
static inline void write_data(uint16_t data) {
static inline void write_data(GDisplay *g, uint16_t data) {
(void) g;
(void) data;
}
#if GDISP_HARDWARE_READPIXEL || GDISP_HARDWARE_SCROLL
/**
* @brief Read data from the lcd.
*
* @return The data from the lcd
* @note The chip select may need to be asserted/de-asserted
* around the actual spi read
*
* @notapi
*/
static inline uint16_t read_data(void) {
}
#endif
#endif /* _GDISP_LLD_BOARD_H */
/** @} */

View File

@ -8,14 +8,11 @@
/**
* @file drivers/gdisp/Nokia6610GE12/gdisp_lld.c
* @brief GDISP Graphics Driver subsystem low level driver source for the Nokia6610 GE12 display.
*
* @addtogroup GDISP
* @{
*/
#include "gfx.h"
#if GFX_USE_GDISP /*|| defined(__DOXYGEN__)*/
#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."
@ -26,9 +23,11 @@
#undef GDISP_SCREEN_WIDTH
#endif
#define GDISP_LLD_DECLARATIONS
#define GDISP_DRIVER_VMT GDISPVMT_Nokia6610GE12
#include "../drivers/gdisp/Nokia6610GE12/gdisp_lld_config.h"
#include "gdisp/lld/gdisp_lld.h"
#include "gdisp_lld_board.h"
#include "board_Nokia6610GE12.h"
/*===========================================================================*/
/* Driver local definitions. */
@ -70,7 +69,7 @@
/* Driver local variables. */
/*===========================================================================*/
static color_t savecolor;
static color_t savecolor[GDISP_TOTAL_DISPLAYS];
#define GDISP_FLG_ODDBYTE (GDISP_FLG_DRIVER<<0)
@ -80,36 +79,42 @@ static color_t savecolor;
// Some macros just to make reading the code easier
#define delayms(ms) gfxSleepMilliseconds(ms)
#define write_data2(d1, d2) { write_data(d1); write_data(d2); }
#define write_data3(d1, d2, d3) { write_data(d1); write_data(d2); write_data(d3); }
#define write_cmd1(cmd, d1) { write_cmd(cmd); write_data(d1); }
#define write_cmd2(cmd, d1, d2) { write_cmd(cmd); write_data2(d1, d2); }
#define write_cmd3(cmd, d1, d2, d3) { write_cmd(cmd); write_data3(d1, d2, d3); }
#define write_data2(g, d1, d2) { write_data(g, d1); write_data(g, d2); }
#define write_data3(g, d1, d2, d3) { write_data(g, d1); write_data(g, d2); write_data(g, d3); }
#define write_reg(g, cmd, d1) { write_index(g, cmd); write_data(g, d1); }
#define write_reg2(g, cmd, d1, d2) { write_index(g, cmd); write_data2(g, d1, d2); }
#define write_reg3(g, cmd, d1, d2, d3) { write_index(g, cmd); write_data3(g, d1, d2, d3); }
static inline void set_viewport(GDisplay* g) {
write_reg2(g, CASET, GDISP_RAM_X_OFFSET+g->p.x, GDISP_RAM_X_OFFSET+g->p.x+g->p.cx-1); // Column address set
write_reg2(g, PASET, GDISP_RAM_Y_OFFSET+g->p.y, GDISP_RAM_Y_OFFSET+g->p.y+g->p.cy-1); // Page address set
write_index(g, RAMWR);
}
/*===========================================================================*/
/* Driver exported functions. */
/*===========================================================================*/
LLDSPEC bool_t gdisp_lld_init(GDISPDriver *g) {
LLDSPEC bool_t gdisp_lld_init(GDisplay *g) {
/* Initialise your display */
init_board();
init_board(g);
// Hardware reset
setpin_reset(TRUE);
setpin_reset(g, TRUE);
delayms(20);
setpin_reset(FALSE);
setpin_reset(g, FALSE);
delayms(20);
acquire_bus();
write_cmd(SLEEPOUT); // Sleep out
write_cmd1(COLMOD, 0x03); // Color Interface Pixel Format - 0x03 = 12 bits-per-pixel
write_cmd1(MADCTL, 0x00); // Memory access controller
write_cmd1(SETCON, 127*GDISP_INITIAL_CONTRAST/100-64); // Write contrast
acquire_bus(g);
write_index(g, SLEEPOUT); // Sleep out
write_reg(g, COLMOD, 0x03); // Color Interface Pixel Format - 0x03 = 12 bits-per-pixel
write_reg(g, MADCTL, 0x00); // Memory access controller
write_reg(g, SETCON, 127*GDISP_INITIAL_CONTRAST/100-64); // Write contrast
delayms(20);
release_bus();
release_bus(g);
/* Turn on the back-light */
set_backlight(GDISP_INITIAL_BACKLIGHT);
set_backlight(g, GDISP_INITIAL_BACKLIGHT);
/* Initialise the GDISP structure to match */
g->g.Width = GDISP_SCREEN_WIDTH;
@ -122,34 +127,34 @@ LLDSPEC bool_t gdisp_lld_init(GDISPDriver *g) {
}
#if GDISP_HARDWARE_STREAM_WRITE
LLDSPEC void gdisp_lld_write_start(GDISPDriver *g) {
acquire_bus();
write_cmd2(CASET, GDISP_RAM_X_OFFSET+g->p.x, GDISP_RAM_X_OFFSET+g->p.x+g->p.cx-1); // Column address set
write_cmd2(PASET, GDISP_RAM_Y_OFFSET+g->p.y, GDISP_RAM_Y_OFFSET+g->p.y+g->p.cy-1); // Page address set
write_cmd(RAMWR);
LLDSPEC void gdisp_lld_write_start(GDisplay *g) {
acquire_bus(g);
set_viewport(g);
g->flags &= ~GDISP_FLG_ODDBYTE;
}
LLDSPEC void gdisp_lld_write_color(GDISPDriver *g) {
LLDSPEC void gdisp_lld_write_color(GDisplay *g) {
if ((g->flags & GDISP_FLG_ODDBYTE)) {
// Write the pair of pixels to the display
write_data3(((savecolor >> 4) & 0xFF), (((savecolor << 4) & 0xF0)|((g->p.color >> 8) & 0x0F)), (g->p.color & 0xFF));
write_data3(g, ((savecolor[g->controllerdisplay] >> 4) & 0xFF),
(((savecolor[g->controllerdisplay] << 4) & 0xF0)|((g->p.color >> 8) & 0x0F)),
(g->p.color & 0xFF));
g->flags &= ~GDISP_FLG_ODDBYTE;
} else {
savecolor = g->p.color;
savecolor[g->controllerdisplay] = g->p.color;
g->flags |= GDISP_FLG_ODDBYTE;
}
}
LLDSPEC void gdisp_lld_write_stop(GDISPDriver *g) {
LLDSPEC void gdisp_lld_write_stop(GDisplay *g) {
if ((g->flags & GDISP_FLG_ODDBYTE)) {
write_data2(((savecolor >> 4) & 0xFF), ((savecolor << 4) & 0xF0));
write_cmd(NOP);
write_data2(g, ((savecolor[g->controllerdisplay] >> 4) & 0xFF), ((savecolor[g->controllerdisplay] << 4) & 0xF0));
write_index(g, NOP);
}
release_bus();
release_bus(g);
}
#endif
#if GDISP_NEED_CONTROL && GDISP_HARDWARE_CONTROL
LLDSPEC void gdisp_lld_control(GDISPDriver *g) {
LLDSPEC void gdisp_lld_control(GDisplay *g) {
/* The hardware is capable of supporting...
* GDISP_CONTROL_POWER - supported
* GDISP_CONTROL_ORIENTATION - supported
@ -162,24 +167,24 @@ LLDSPEC bool_t gdisp_lld_init(GDISPDriver *g) {
return;
switch((powermode_t)g->p.ptr) {
case powerOff:
acquire_bus();
write_cmd(SLEEPIN);
release_bus();
acquire_bus(g);
write_index(g, SLEEPIN);
release_bus(g);
break;
case powerOn:
acquire_bus();
write_cmd(SLEEPOUT);
acquire_bus(g);
write_index(g, SLEEPOUT);
delayms(20);
write_cmd(NORON); // Set Normal mode (my)
release_bus();
write_index(g, NORON); // Set Normal mode (my)
release_bus(g);
break;
case powerSleep:
acquire_bus();
write_cmd(SLEEPOUT);
acquire_bus(g);
write_index(g, SLEEPOUT);
delayms(20);
write_cmd2(PTLAR, GDISP_SLEEP_POS, GDISP_SLEEP_POS+GDISP_SLEEP_SIZE)
write_cmd(PTLON);
release_bus();
write_reg2(g, PTLAR, GDISP_SLEEP_POS, GDISP_SLEEP_POS+GDISP_SLEEP_SIZE)
write_index(g, PTLON);
release_bus(g);
break;
default:
return;
@ -192,30 +197,30 @@ LLDSPEC bool_t gdisp_lld_init(GDISPDriver *g) {
return;
switch((orientation_t)g->p.ptr) {
case GDISP_ROTATE_0:
acquire_bus();
write_cmd1(MADCTL, 0x00);
release_bus();
acquire_bus(g);
write_reg(g, MADCTL, 0x00);
release_bus(g);
g->g.Height = GDISP_SCREEN_HEIGHT;
g->g.Width = GDISP_SCREEN_WIDTH;
break;
case GDISP_ROTATE_90:
acquire_bus();
write_cmd1(MADCTL, 0xA0); // MY, MX, V, LAO, RGB, X, X, X
release_bus();
acquire_bus(g);
write_reg(g, MADCTL, 0xA0); // MY, MX, V, LAO, RGB, X, X, X
release_bus(g);
g->g.Height = GDISP_SCREEN_WIDTH;
g->g.Width = GDISP_SCREEN_HEIGHT;
break;
case GDISP_ROTATE_180:
acquire_bus();
write_cmd1(MADCTL, 0xC0);
release_bus();
acquire_bus(g);
write_reg(g, MADCTL, 0xC0);
release_bus(g);
g->g.Height = GDISP_SCREEN_HEIGHT;
g->g.Width = GDISP_SCREEN_WIDTH;
break;
case GDISP_ROTATE_270:
acquire_bus();
write_cmd1(MADCTL, 0x60);
release_bus();
acquire_bus(g);
write_reg(g, MADCTL, 0x60);
release_bus(g);
g->g.Height = GDISP_SCREEN_WIDTH;
g->g.Width = GDISP_SCREEN_HEIGHT;
break;
@ -227,14 +232,14 @@ LLDSPEC bool_t gdisp_lld_init(GDISPDriver *g) {
case GDISP_CONTROL_BACKLIGHT:
if ((unsigned)g->p.ptr > 100) g->p.ptr = (void *)100;
set_backlight((unsigned)g->p.ptr);
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;
acquire_bus();
write_cmd1(CONTRAST,(unsigned)127*g->p.ptr/100-64);
release_bus();
acquire_bus(g);
write_reg(g, CONTRAST,(unsigned)127*g->p.ptr/100-64);
release_bus(g);
g->g.Contrast = (unsigned)g->p.ptr;
return;
}
@ -242,4 +247,3 @@ LLDSPEC bool_t gdisp_lld_init(GDISPDriver *g) {
#endif
#endif /* GFX_USE_GDISP */
/** @} */

View File

@ -1,5 +1,2 @@
# List the required driver.
GFXSRC += $(GFXLIB)/drivers/gdisp/Nokia6610GE12/gdisp_lld.c
# Required include directories
GFXINC += $(GFXLIB)/drivers/gdisp/Nokia6610GE12
GFXSRC += $(GFXLIB)/drivers/gdisp/Nokia6610GE12/gdisp_lld.c

View File

@ -22,18 +22,10 @@
/* Driver hardware support. */
/*===========================================================================*/
#define GDISP_DRIVER_NAME "Nokia6610GE12"
#define GDISP_DRIVER_STRUCT GDISP_Nokia6610GE12
#define GDISP_HARDWARE_CONTROL TRUE
#define GDISP_HARDWARE_STREAM_WRITE TRUE
#define GDISP_PIXELFORMAT GDISP_PIXELFORMAT_RGB444
/* This driver supports both packed and unpacked pixel formats and line formats.
* By default we leave these as FALSE.
*/
#define GDISP_PACKED_PIXELS FALSE
#define GDISP_PACKED_LINES FALSE
#endif /* GFX_USE_GDISP */