diff options
Diffstat (limited to 'drivers/gdisp/HX8347D')
| -rw-r--r-- | drivers/gdisp/HX8347D/HX8347D.h | 143 | ||||
| -rw-r--r-- | drivers/gdisp/HX8347D/gdisp_lld.c | 495 | ||||
| -rw-r--r-- | drivers/gdisp/HX8347D/gdisp_lld.mk | 5 | ||||
| -rw-r--r-- | drivers/gdisp/HX8347D/gdisp_lld_board_st_stm32f4_discovery.h | 202 | ||||
| -rw-r--r-- | drivers/gdisp/HX8347D/gdisp_lld_config.h | 39 | ||||
| -rw-r--r-- | drivers/gdisp/HX8347D/readme.txt | 24 |
6 files changed, 908 insertions, 0 deletions
diff --git a/drivers/gdisp/HX8347D/HX8347D.h b/drivers/gdisp/HX8347D/HX8347D.h new file mode 100644 index 00000000..c0cb18fb --- /dev/null +++ b/drivers/gdisp/HX8347D/HX8347D.h @@ -0,0 +1,143 @@ +/*
+ * This file is subject to the terms of the GFX License, v1.0. If a copy of
+ * the license was not distributed with this file, you can obtain one at:
+ *
+ * http://chibios-gfx.com/license.html
+ */
+
+/**
+ * @file drivers/gdisp/HX8347D/HX8347D.h
+ * @brief GDISP Graphic Driver support header for the HX8347D display.
+ *
+ * @addtogroup GDISP
+ * @{
+ */
+
+#ifndef _HX8347D_H
+#define _HX8347D_H
+
+/* HX8347D registers */
+
+/* page 0 registers */
+#define HX8347D_REG_HID 0x00 /* Himax ID */
+#define HX8347D_REG_DMODE 0x01 /* Display mode control */
+#define HX8347D_REG_SCH 0x02 /* Column address start high */
+#define HX8347D_REG_SCL 0x03 /* Column address start low */
+#define HX8347D_REG_ECH 0x04 /* Column address end high */
+#define HX8347D_REG_ECL 0x05 /* Column address end low */
+#define HX8347D_REG_SPH 0x06 /* Row address start high */
+#define HX8347D_REG_SPL 0x07 /* Row address start low */
+#define HX8347D_REG_EPH 0x08 /* Row address end high */
+#define HX8347D_REG_EPL 0x09 /* Row address end low */
+#define HX8347D_REG_PSLH 0x0a /* Partial area start row high */
+#define HX8347D_REG_PSLL 0x0b /* Partial area start row low */
+#define HX8347D_REG_PELH 0x0c /* Partial area end row high */
+#define HX8347D_REG_PELL 0x0d /* Partial area end row low */
+#define HX8347D_REG_TFAH 0x0e /* Vertical srcoll top fixed area high */
+#define HX8347D_REG_TFAL 0x0f /* Vertical scroll top fixed area low */
+
+#define HX8347D_REG_VSAH 0x10 /* Vertical scroll height area high */
+#define HX8347D_REG_VSAL 0x11 /* Vertical scroll height area low */
+#define HX8347D_REG_BFAH 0x12 /* Vertical scroll button area high */
+#define HX8347D_REG_BFAL 0x13 /* Vertical scroll button area low */
+#define HX8347D_REG_VSPH 0x14 /* Vertical scroll start address high */
+#define HX8347D_REG_VSPL 0x15 /* Vertical scroll start address low */
+#define HX8347D_REG_MAC 0x16 /* Memory access control */
+#define HX8347D_REG_COLMOD 0x17 /* COLMOD */
+#define HX8347D_REG_OSCCH 0x18 /* OSC control 2 */
+#define HX8347D_REG_OSCCL 0x19 /* OSC control 1 */
+#define HX8347D_REG_PWC1 0x1a /* Power control 1 */
+#define HX8347D_REG_PWC2 0x1b /* Power control 2 */
+#define HX8347D_REG_PWC3 0x1c /* Power control 3 */
+#define HX8347D_REG_PWC4 0x1d /* Power control 4 */
+#define HX8347D_REG_PWC5 0x1e /* Power control 5 */
+#define HX8347D_REG_PWC6 0x1f /* Power control 6 */
+
+#define HX8347D_REG_SRAMWC 0x22 /* SRAM write control */
+#define HX8347D_REG_VMF 0x23 /* VCOM control 1 */
+#define HX8347D_REG_VMH 0x24 /* VCOM control 2 */
+#define HX8347D_REG_VML 0x25 /* VCOM control 3 */
+#define HX8347D_REG_DC1 0x26 /* Display control 1 */
+#define HX8347D_REG_DC2 0x27 /* Display control 2 */
+#define HX8347D_REG_DC3 0x28 /* Display control 3 */
+#define HX8347D_REG_FRC1 0x29 /* Frame rate control 1 */
+#define HX8347D_REG_FRC2 0x2a /* Frame rate control 2 */
+#define HX8347D_REG_FRC3 0x2b /* Frame rate control 3 */
+#define HX8347D_REG_FRC4 0x2c /* Frame rate control 4 */
+#define HX8347D_REG_GDON 0x2d /* Cycle control 1 */
+#define HX8347D_REG_GDOF 0x2e /* Cycle control 2 */
+#define HX8347D_REG_DINV 0x2f /* Display inversion */
+
+#define HX8347D_REG_RGB1 0x31 /* RGB interface control 1 */
+#define HX8347D_REG_RGB2 0x32 /* RGB interface control 2 */
+#define HX8347D_REG_RGB3 0x33 /* RGB interface control 3 */
+#define HX8347D_REG_RGB4 0x34 /* RGB interface control 4 */
+#define HX8347D_REG_PCH 0x36 /* Panel characteristic */
+#define HX8347D_REG_OTP1 0x38 /* OTP control 1 */
+#define HX8347D_REG_OTP2 0x39 /* OTP control 2 */
+#define HX8347D_REG_OTP3 0x3a /* OTP control 3 */
+#define HX8347D_REG_CABC1 0x3c /* CABC control 1 */
+#define HX8347D_REG_CABC2 0x3d /* CABC control 2 */
+#define HX8347D_REG_CABC3 0x3e /* CABC control 3 */
+#define HX8347D_REG_CABC4 0x3f /* CABC control 4 */
+
+#define HX8347D_REG_VRP0 0x40 /* Gamma control 1 */
+#define HX8347D_REG_VRP1 0x41 /* Gamma control 2 */
+#define HX8347D_REG_VRP2 0x42 /* Gamma control 3 */
+#define HX8347D_REG_VRP3 0x43 /* Gamma control 4 */
+#define HX8347D_REG_VRP4 0x44 /* Gamma control 5 */
+#define HX8347D_REG_VRP5 0x45 /* Gamma control 6 */
+#define HX8347D_REG_PRP0 0x46 /* Gamma control 7 */
+#define HX8347D_REG_PRP1 0x47 /* Gamma control 8 */
+#define HX8347D_REG_PKP0 0x48 /* Gamma control 9 */
+#define HX8347D_REG_PKP1 0x49 /* Gamma control 10 */
+#define HX8347D_REG_PKP2 0x4a /* Gamma control 11 */
+#define HX8347D_REG_PKP3 0x4b /* Gamma control 12 */
+#define HX8347D_REG_PKP4 0x4c /* Gamma control 13 */
+
+#define HX8347D_REG_VRN0 0x50 /* Gamma control 14 */
+#define HX8347D_REG_VRN1 0x51 /* Gamma control 15 */
+#define HX8347D_REG_VRN2 0x52 /* Gamma control 16 */
+#define HX8347D_REG_VRN3 0x53 /* Gamma control 17 */
+#define HX8347D_REG_VRN4 0x54 /* Gamma control 18 */
+#define HX8347D_REG_VRN5 0x55 /* Gamma control 19 */
+#define HX8347D_REG_PRN0 0x56 /* Gamma control 20 */
+#define HX8347D_REG_PRN1 0x57 /* Gamma control 21 */
+#define HX8347D_REG_PKN0 0x58 /* Gamma control 22 */
+#define HX8347D_REG_PKN1 0x59 /* Gamma control 23 */
+#define HX8347D_REG_PKN2 0x5a /* Gamma control 24 */
+#define HX8347D_REG_PKN3 0x5b /* Gamma control 25 */
+#define HX8347D_REG_PKN4 0x5c /* Gamma control 26 */
+#define HX8347D_REG_CGM 0x5d /* Gamma control 27 */
+
+#define HX8347D_REG_TEC 0x60 /* TE control */
+
+#define HX8347D_REG_PS1 0xe4 /* Power saving 1 */
+#define HX8347D_REG_PS2 0xe5 /* Power saving 2 */
+#define HX8347D_REG_PS3 0xe6 /* Power saving 3 */
+#define HX8347D_REG_PS4 0xe7 /* Power saving 4 */
+#define HX8347D_REG_OPONN 0xe8 /* Source OP control normal */
+#define HX8347D_REG_OPONI 0xe9 /* Source OP control idle */
+#define HX8347D_REG_STBAH 0xea /* Power control internal use 1 */
+#define HX8347D_REG_STBAL 0xeb /* Power control internal use 2 */
+#define HX8347D_REG_PTBAH 0xec /* Source control internal use 1 */
+#define HX8347D_REG_PTBAL 0xed /* Source control internal use 2 */
+
+/* page 1 registers */
+#define HX8347D_REG_CABC5 0xc3 /* CABC control 5 */
+#define HX8347D_REG_CABC6 0xc5 /* CABC control 6 */
+#define HX8347D_REG_CABC7 0xc7 /* CABC control 7 */
+#define HX8347D_REG_DBG0 0xcb /* Gain select register 0 */
+#define HX8347D_REG_DBG1 0xcc /* Gain select register 1 */
+#define HX8347D_REG_DBG2 0xcd /* Gain select register 2 */
+#define HX8347D_REG_DBG3 0xce /* Gain select register 3 */
+#define HX8347D_REG_DBG4 0xcf /* Gain select register 4 */
+#define HX8347D_REG_DBG5 0xd0 /* Gain select register 5 */
+#define HX8347D_REG_DBG6 0xd1 /* Gain select register 6 */
+#define HX8347D_REG_DBG7 0xd2 /* Gain select register 7 */
+#define HX8347D_REG_DBG8 0xd3 /* Gain select register 8 */
+
+#define HX8347D_REG_PGSEL 0xff /* Page select */
+
+#endif /* _HX8347D_H */
+/** @} */
diff --git a/drivers/gdisp/HX8347D/gdisp_lld.c b/drivers/gdisp/HX8347D/gdisp_lld.c new file mode 100644 index 00000000..8443ca3d --- /dev/null +++ b/drivers/gdisp/HX8347D/gdisp_lld.c @@ -0,0 +1,495 @@ +/*
+ * This file is subject to the terms of the GFX License, v1.0. If a copy of
+ * the license was not distributed with this file, you can obtain one at:
+ *
+ * http://chibios-gfx.com/license.html
+ */
+
+/**
+ * @file drivers/gdisp/HX8347D/gdisp_lld.c
+ * @brief GDISP Graphics Driver subsystem low level driver source for the HX8347D display.
+ *
+ * @addtogroup GDISP
+ * @{
+ */
+
+#include "ch.h"
+#include "hal.h"
+#include "gfx.h"
+
+#include "HX8347D.h"
+
+#if GFX_USE_GDISP /*|| defined(__DOXYGEN__)*/
+
+/* Include the emulation code for things we don't support */
+#include "gdisp/lld/emulation.c"
+
+/*===========================================================================*/
+/* Driver local definitions. */
+/*===========================================================================*/
+
+#ifndef GDISP_SCREEN_HEIGHT
+ #define GDISP_SCREEN_HEIGHT 320
+#endif
+#ifndef GDISP_SCREEN_WIDTH
+ #define GDISP_SCREEN_WIDTH 240
+#endif
+
+#define GDISP_INITIAL_CONTRAST 50
+#define GDISP_INITIAL_BACKLIGHT 50
+
+/*===========================================================================*/
+/* Driver local functions. */
+/*===========================================================================*/
+
+#if defined(GDISP_USE_CUSTOM_BOARD) && GDISP_USE_CUSTOM_BOARD
+ /* Include the user supplied board definitions */
+ #include "gdisp_lld_board.h"
+#elif defined(BOARD_ST_STM32F4_DISCOVERY)
+ #include "gdisp_lld_board_st_stm32f4_discovery.h"
+#else
+ /* Include the user supplied board definitions */
+ #include "gdisp_lld_board.h"
+#endif
+
+// Some common routines and macros
+#define write_reg(reg, data) { write_index(reg); write_data(data); }
+#define write_ram(color1, color2) { write_index(0x22); write_ram8(color1,color2); }
+#define stream_start() { write_index(0x22); spiStart(&SPID1, &spi1cfg2); }
+#define stream_stop() {while(((SPI1->SR & SPI_SR_TXE) == 0) || ((SPI1->SR & SPI_SR_BSY) != 0));palSetPad(GPIOA, 4);spiStart(&SPID1, &spi1cfg1); }
+#define delay(us) chThdSleepMicroseconds(us)
+#define delayms(ms) chThdSleepMilliseconds(ms)
+
+static inline void set_cursor(coord_t x, coord_t y) {
+ write_reg(HX8347D_REG_SCL, (uint8_t) x);
+ write_reg(HX8347D_REG_SCH, (uint8_t) (x >> 8));
+ write_reg(HX8347D_REG_SPL, (uint8_t) y);
+ write_reg(HX8347D_REG_SPH, (uint8_t) (y >> 8));
+}
+
+static void set_viewport(coord_t x, coord_t y, coord_t cx, coord_t cy) {
+ write_reg(HX8347D_REG_SCL, (uint8_t) x);
+ write_reg(HX8347D_REG_SCH, (uint8_t) (x >> 8));
+ write_reg(HX8347D_REG_ECL, (uint8_t) (x + cx -1));
+ write_reg(HX8347D_REG_ECH, (uint8_t) ((x + cx -1) >> 8));
+ write_reg(HX8347D_REG_SPL, (uint8_t) y);
+ write_reg(HX8347D_REG_SPH, (uint8_t) (y >> 8));
+ write_reg(HX8347D_REG_EPL, (uint8_t) (y + cy -1));
+ write_reg(HX8347D_REG_EPH, (uint8_t) ((y + cy -1) >> 8));
+}
+
+static inline void reset_viewport(void) {
+ set_viewport(0, 0, GDISP.Width, GDISP.Height);
+}
+
+/*===========================================================================*/
+/* Driver interrupt handlers. */
+/*===========================================================================*/
+
+/*===========================================================================*/
+/* Driver exported functions. */
+/*===========================================================================*/
+
+/* ---- Required Routines ---- */
+/*
+ The following 2 routines are required.
+ All other routines are optional.
+*/
+
+/**
+ * @brief Low level GDISP driver initialization.
+ *
+ * @notapi
+ */
+bool_t gdisp_lld_init(void) {
+ /* Initialise your display */
+ init_board();
+
+ // Hardware reset
+ setpin_reset(TRUE);
+ delayms(1);
+ setpin_reset(FALSE);
+ delayms(5);
+
+ // Get the bus for the following initialisation commands
+ acquire_bus();
+
+ /* Start Initial Sequence ----------------------------------------------------*/
+ write_reg(HX8347D_REG_STBAH, 0x00); /* Reset Power Control 1 */
+ write_reg(HX8347D_REG_STBAL, 0x20); /* Power Control 2 */
+ write_reg(HX8347D_REG_PTBAH, 0x0C); /* Power Control 1 */
+ write_reg(HX8347D_REG_PTBAL, 0xC4); /* Power Control 2 */
+ write_reg(HX8347D_REG_OPONN, 0x40); /* Source OPON_N */
+ write_reg(HX8347D_REG_OPONI, 0x38); /* Source OPON_I */
+ write_reg(HX8347D_REG_DC2, 0xA3); /* Display Control 2 */
+
+ /* Power On sequence ---------------------------------------------------------*/
+ write_reg(HX8347D_REG_PWC2, 0x1B); /* Power Control 2 */
+ write_reg(HX8347D_REG_PWC1, 0x01); /* Power Control 1 */
+ write_reg(HX8347D_REG_VMH, 0x2F); /* Vcom Control 2 */
+ write_reg(HX8347D_REG_VML, 0x57); /* Vcom Control 3 */
+ write_reg(HX8347D_REG_VMF, 0x8D); /* Vcom Control 1 */
+
+ /* Gamma settings -----------------------------------------------------------*/
+ write_reg(HX8347D_REG_VRP0,0x01); // default setup
+ write_reg(HX8347D_REG_VRP1,0x0e); //
+ write_reg(HX8347D_REG_VRP2,0x11); //
+ write_reg(HX8347D_REG_VRP3,0x1a); //
+ write_reg(HX8347D_REG_VRP4,0x18); //
+ write_reg(HX8347D_REG_VRP5,0x24); //
+ write_reg(HX8347D_REG_PRP0,0x15); //
+ write_reg(HX8347D_REG_PRP1,0x65); //
+ write_reg(HX8347D_REG_PKP0,0x0b); //
+ write_reg(HX8347D_REG_PKP1,0x18); //
+ write_reg(HX8347D_REG_PKP2,0x19); //
+ write_reg(HX8347D_REG_PKP3,0x1a); //
+ write_reg(HX8347D_REG_PKP4,0x18); //
+ write_reg(HX8347D_REG_VRN0,0x1b); //
+ write_reg(HX8347D_REG_VRN1,0x27); //
+ write_reg(HX8347D_REG_VRN2,0x25); //
+ write_reg(HX8347D_REG_VRN3,0x2e); //
+ write_reg(HX8347D_REG_VRN4,0x31); //
+ write_reg(HX8347D_REG_VRN5,0x3e); //
+ write_reg(HX8347D_REG_PRN0,0x1a); //
+ write_reg(HX8347D_REG_PRN1,0x6a); //
+ write_reg(HX8347D_REG_PKN0,0x07); //
+ write_reg(HX8347D_REG_PKN1,0x05); //
+ write_reg(HX8347D_REG_PKN2,0x06); //
+ write_reg(HX8347D_REG_PKN3,0x0b); //
+ write_reg(HX8347D_REG_PKN4,0x14); //
+ write_reg(HX8347D_REG_CGM,0xcc); //
+
+ /* Power + Osc ---------------------------------------------------------------*/
+ write_reg(HX8347D_REG_OSCCH, 0x36); /* OSC Control 1 */
+ write_reg(HX8347D_REG_OSCCL, 0x01); /* OSC Control 2 */
+ write_reg(HX8347D_REG_DMODE, 0x00); /* Display Mode Control */
+ write_reg(HX8347D_REG_PWC6, 0x88); /* Power Control 6 */
+ delayms(5); /* Delay 5 ms */
+ write_reg(HX8347D_REG_PWC6, 0x80); /* Power Control 6 */
+ delayms(5); /* Delay 5 ms */
+ write_reg(HX8347D_REG_PWC6, 0x90); /* Power Control 6 */
+ delayms(5); /* Delay 5 ms */
+ write_reg(HX8347D_REG_PWC6, 0xD0); /* Power Control 6 */
+ delayms(5); /* Delay 5 ms */
+ write_reg(HX8347D_REG_COLMOD, 0x05); /* Colmod 16Bit/Pixel */
+ write_reg(HX8347D_REG_PCH, 0x00); /* Panel Characteristic */
+ write_reg(HX8347D_REG_DC3, 0x38); /* Display Control 3 */
+ delayms(40);
+ write_reg(HX8347D_REG_DC3, 0x3C); /* Display Control 3 */
+ write_reg(HX8347D_REG_MAC, 0x08); /* Memory access control */
+
+ write_reg(HX8347D_REG_SCL, 0x00);
+ write_reg(HX8347D_REG_SCH, 0x00);
+ write_reg(HX8347D_REG_ECL, 0xef);
+ write_reg(HX8347D_REG_ECH, 0x00);
+ write_reg(HX8347D_REG_SPL, 0x00);
+ write_reg(HX8347D_REG_SPH, 0x00);
+ write_reg(HX8347D_REG_EPL, 0x3f);
+ write_reg(HX8347D_REG_EPH, 0x01);
+
+ // Release the bus
+ release_bus();
+
+ /* Turn on the backlight */
+ set_backlight(GDISP_INITIAL_BACKLIGHT);
+
+ /* Initialise the GDISP structure */
+ GDISP.Width = GDISP_SCREEN_WIDTH;
+ GDISP.Height = GDISP_SCREEN_HEIGHT;
+ GDISP.Orientation = GDISP_ROTATE_0;
+ GDISP.Powermode = powerOn;
+ GDISP.Backlight = GDISP_INITIAL_BACKLIGHT;
+ GDISP.Contrast = GDISP_INITIAL_CONTRAST;
+ #if GDISP_NEED_VALIDATION || GDISP_NEED_CLIP
+ GDISP.clipx0 = 0;
+ GDISP.clipy0 = 0;
+ GDISP.clipx1 = GDISP.Width;
+ GDISP.clipy1 = GDISP.Height;
+ #endif
+ return TRUE;
+}
+
+/**
+ * @brief Draws a pixel on the display.
+ *
+ * @param[in] x X location of the pixel
+ * @param[in] y Y location of the pixel
+ * @param[in] color The color of the pixel
+ *
+ * @notapi
+ */
+void gdisp_lld_draw_pixel(coord_t x, coord_t y, color_t color) {
+ #if GDISP_NEED_VALIDATION || GDISP_NEED_CLIP
+ if (x < GDISP.clipx0 || y < GDISP.clipy0 || x >= GDISP.clipx1 || y >= GDISP.clipy1) return;
+ #endif
+
+ acquire_bus();
+ set_cursor(x, y);
+ write_ram((color >> 8) & 0xFF, color & 0xFF);
+ release_bus();
+}
+
+/* ---- Optional Routines ---- */
+/*
+ All the below routines are optional.
+ Defining them will increase speed but everything
+ will work if they are not defined.
+ If you are not using a routine - turn it off using
+ the appropriate GDISP_HARDWARE_XXXX macro.
+ Don't bother coding for obvious similar routines if
+ there is no performance penalty as the emulation software
+ makes a good job of using similar routines.
+ eg. If gfillarea() is defined there is little
+ point in defining clear() unless the
+ performance bonus is significant.
+ For good performance it is suggested to implement
+ fillarea() and blitarea().
+*/
+
+#if GDISP_HARDWARE_CLEARS || defined(__DOXYGEN__)
+ /**
+ * @brief Clear the display.
+ * @note Optional - The high level driver can emulate using software.
+ *
+ * @param[in] color The color of the pixel
+ *
+ * @notapi
+ */
+ void gdisp_lld_clear(color_t color) {
+ unsigned i;
+
+ acquire_bus();
+ reset_viewport();
+ stream_start();
+ for(i = 0; i < GDISP_SCREEN_WIDTH * GDISP_SCREEN_HEIGHT; i++)
+ write_ram16(color);
+ stream_stop();
+ release_bus();
+ }
+#endif
+
+#if GDISP_HARDWARE_FILLS || defined(__DOXYGEN__)
+ /**
+ * @brief Fill an area with a color.
+ * @note Optional - The high level driver can emulate using software.
+ *
+ * @param[in] x, y The start filled area
+ * @param[in] cx, cy The width and height to be filled
+ * @param[in] color The color of the fill
+ *
+ * @notapi
+ */
+ void gdisp_lld_fill_area(coord_t x, coord_t y, coord_t cx, coord_t cy, color_t color) {
+ unsigned i, area;
+
+ #if GDISP_NEED_VALIDATION || GDISP_NEED_CLIP
+ if (x < GDISP.clipx0) { cx -= GDISP.clipx0 - x; x = GDISP.clipx0; }
+ if (y < GDISP.clipy0) { cy -= GDISP.clipy0 - y; y = GDISP.clipy0; }
+ if (cx <= 0 || cy <= 0 || x >= GDISP.clipx1 || y >= GDISP.clipy1) return;
+ if (x+cx > GDISP.clipx1) cx = GDISP.clipx1 - x;
+ if (y+cy > GDISP.clipy1) cy = GDISP.clipy1 - y;
+ #endif
+
+ area = cx*cy;
+
+ acquire_bus();
+ set_viewport(x, y, cx, cy);
+ stream_start();
+ for(i = 0; i < area; i++)
+ write_ram16(color);
+ stream_stop();
+ release_bus();
+ }
+#endif
+
+#if GDISP_HARDWARE_BITFILLS || defined(__DOXYGEN__)
+ /**
+ * @brief Fill an area with a bitmap.
+ * @note Optional - The high level driver can emulate using software.
+ *
+ * @param[in] x, y The start filled area
+ * @param[in] cx, cy The width and height to be filled
+ * @param[in] srcx, srcy The bitmap position to start the fill from
+ * @param[in] srccx The width of a line in the bitmap.
+ * @param[in] buffer The pixels to use to fill the area.
+ *
+ * @notapi
+ */
+ void gdisp_lld_blit_area_ex(coord_t x, coord_t y, coord_t cx, coord_t cy, coord_t srcx, coord_t srcy, coord_t srccx, const pixel_t *buffer) {
+ coord_t endx, endy;
+ unsigned lg;
+
+ #if GDISP_NEED_VALIDATION || GDISP_NEED_CLIP
+ if (x < GDISP.clipx0) { cx -= GDISP.clipx0 - x; srcx += GDISP.clipx0 - x; x = GDISP.clipx0; }
+ if (y < GDISP.clipy0) { cy -= GDISP.clipy0 - y; srcy += GDISP.clipy0 - y; y = GDISP.clipy0; }
+ if (srcx+cx > srccx) cx = srccx - srcx;
+ if (cx <= 0 || cy <= 0 || x >= GDISP.clipx1 || y >= GDISP.clipy1) return;
+ if (x+cx > GDISP.clipx1) cx = GDISP.clipx1 - x;
+ if (y+cy > GDISP.clipy1) cy = GDISP.clipy1 - y;
+ #endif
+
+ acquire_bus();
+ set_viewport(x, y, cx, cy);
+ stream_start();
+
+ endx = srcx + cx;
+ endy = y + cy;
+ lg = srccx - cx;
+ buffer += srcx + srcy * srccx;
+ for(; y < endy; y++, buffer += lg)
+ for(x=srcx; x < endx; x++)
+ write_data(*buffer++);
+ stream_stop();
+ release_bus();
+ }
+#endif
+
+#if (GDISP_NEED_PIXELREAD && GDISP_HARDWARE_PIXELREAD) || defined(__DOXYGEN__)
+ /**
+ * @brief Get the color of a particular pixel.
+ * @note Optional.
+ * @note If x,y is off the screen, the result is undefined.
+ *
+ * @param[in] x, y The pixel to be read
+ *
+ * @notapi
+ */
+ color_t gdisp_lld_get_pixel_color(coord_t x, coord_t y) {
+ color_t color;
+
+ #if GDISP_NEED_VALIDATION || GDISP_NEED_CLIP
+ if (x < 0 || x >= GDISP.Width || y < 0 || y >= GDISP.Height) return 0;
+ #endif
+}
+#endif
+
+#if (GDISP_NEED_SCROLL && GDISP_HARDWARE_SCROLL) || defined(__DOXYGEN__)
+ /**
+ * @brief Scroll vertically a section of the screen.
+ * @note Optional.
+ * @note If x,y + cx,cy is off the screen, the result is undefined.
+ * @note If lines is >= cy, it is equivelent to a area fill with bgcolor.
+ *
+ * @param[in] x, y The start of the area to be scrolled
+ * @param[in] cx, cy The size of the area to be scrolled
+ * @param[in] lines The number of lines to scroll (Can be positive or negative)
+ * @param[in] bgcolor The color to fill the newly exposed area.
+ *
+ * @notapi
+ */
+ void gdisp_lld_vertical_scroll(coord_t x, coord_t y, coord_t cx, coord_t cy, int lines, color_t bgcolor) {
+ static color_t buf[((GDISP_SCREEN_HEIGHT > GDISP_SCREEN_WIDTH ) ? GDISP_SCREEN_HEIGHT : GDISP_SCREEN_WIDTH)];
+ coord_t row0, row1;
+ unsigned i, abslines, j;
+ static int gap;
+
+ #if GDISP_NEED_VALIDATION || GDISP_NEED_CLIP
+ if (x < GDISP.clipx0) { cx -= GDISP.clipx0 - x; x = GDISP.clipx0; }
+ if (y < GDISP.clipy0) { cy -= GDISP.clipy0 - y; y = GDISP.clipy0; }
+ if (!lines || cx <= 0 || cy <= 0 || x >= GDISP.clipx1 || y >= GDISP.clipy1) return;
+ if (x+cx > GDISP.clipx1) cx = GDISP.clipx1 - x;
+ if (y+cy > GDISP.clipy1) cy = GDISP.clipy1 - y;
+ #endif
+
+ }
+#endif
+
+#if (GDISP_NEED_CONTROL && GDISP_HARDWARE_CONTROL) || defined(__DOXYGEN__)
+ /**
+ * @brief Driver Control
+ * @details Unsupported control codes are ignored.
+ * @note The value parameter should always be typecast to (void *).
+ * @note There are some predefined and some specific to the low level driver.
+ * @note GDISP_CONTROL_POWER - Takes a gdisp_powermode_t
+ * GDISP_CONTROL_ORIENTATION - Takes a gdisp_orientation_t
+ * GDISP_CONTROL_BACKLIGHT - Takes an int from 0 to 100. For a driver
+ * that only supports off/on anything other
+ * than zero is on.
+ *
+ * @param[in] what What to do.
+ * @param[in] value The value to use (always cast to a void *).
+ *
+ * @notapi
+ */
+ void gdisp_lld_control(unsigned what, void *value) {
+ switch(what) {
+ case GDISP_CONTROL_ORIENTATION:
+ if (GDISP.Orientation == (gdisp_orientation_t)value)
+ return;
+ switch((gdisp_orientation_t)value) {
+ case GDISP_ROTATE_0:
+ acquire_bus();
+ write_reg(HX8347D_REG_MAC, 0x08); /* Memory access control */
+ write_reg(HX8347D_REG_ECL, 0xef);
+ write_reg(HX8347D_REG_ECH, 0x00);
+ write_reg(HX8347D_REG_EPL, 0x3f);
+ write_reg(HX8347D_REG_EPH, 0x01);
+ release_bus();
+ GDISP.Height = GDISP_SCREEN_HEIGHT;
+ GDISP.Width = GDISP_SCREEN_WIDTH;
+ break;
+
+ case GDISP_ROTATE_90:
+ acquire_bus();
+ write_reg(HX8347D_REG_MAC, 0x68); /* Memory access control */
+ write_reg(HX8347D_REG_ECL, 0x3f);
+ write_reg(HX8347D_REG_ECH, 0x01);
+ write_reg(HX8347D_REG_EPL, 0xef);
+ write_reg(HX8347D_REG_EPH, 0x00);
+ release_bus();
+ GDISP.Height = GDISP_SCREEN_WIDTH;
+ GDISP.Width = GDISP_SCREEN_HEIGHT;
+ break;
+
+ case GDISP_ROTATE_180:
+ acquire_bus();
+ write_reg(HX8347D_REG_MAC, 0xc8); /* Memory access control */
+ write_reg(HX8347D_REG_ECL, 0xef);
+ write_reg(HX8347D_REG_ECH, 0x00);
+ write_reg(HX8347D_REG_EPL, 0x3f);
+ write_reg(HX8347D_REG_EPH, 0x01);
+ release_bus();
+ GDISP.Height = GDISP_SCREEN_HEIGHT;
+ GDISP.Width = GDISP_SCREEN_WIDTH;
+ break;
+
+ case GDISP_ROTATE_270:
+ acquire_bus();
+ write_reg(HX8347D_REG_MAC, 0xa8); /* Memory access control */
+ write_reg(HX8347D_REG_ECL, 0x3f);
+ write_reg(HX8347D_REG_ECH, 0x01);
+ write_reg(HX8347D_REG_EPL, 0xef);
+ write_reg(HX8347D_REG_EPH, 0x00);
+ release_bus();
+ GDISP.Height = GDISP_SCREEN_WIDTH;
+ GDISP.Width = GDISP_SCREEN_HEIGHT;
+ break;
+
+ default:
+ return;
+ }
+
+ #if GDISP_NEED_CLIP || GDISP_NEED_VALIDATION
+ GDISP.clipx0 = 0;
+ GDISP.clipy0 = 0;
+ GDISP.clipx1 = GDISP.Width;
+ GDISP.clipy1 = GDISP.Height;
+ #endif
+ GDISP.Orientation = (gdisp_orientation_t)value;
+ return;
+
+ case GDISP_CONTROL_BACKLIGHT:
+ if ((unsigned)value > 100)
+ value = (void *)100;
+ set_backlight((unsigned)value);
+ GDISP.Backlight = (unsigned)value;
+ return;
+
+ default:
+ return;
+ }
+ }
+#endif
+
+#endif /* GFX_USE_GDISP */
+/** @} */
diff --git a/drivers/gdisp/HX8347D/gdisp_lld.mk b/drivers/gdisp/HX8347D/gdisp_lld.mk new file mode 100644 index 00000000..fed905e1 --- /dev/null +++ b/drivers/gdisp/HX8347D/gdisp_lld.mk @@ -0,0 +1,5 @@ +# List the required driver.
+GFXSRC += $(GFXLIB)/drivers/gdisp/HX8347D/gdisp_lld.c
+
+# Required include directories
+GFXINC += $(GFXLIB)/drivers/gdisp/HX8347D
diff --git a/drivers/gdisp/HX8347D/gdisp_lld_board_st_stm32f4_discovery.h b/drivers/gdisp/HX8347D/gdisp_lld_board_st_stm32f4_discovery.h new file mode 100644 index 00000000..da078541 --- /dev/null +++ b/drivers/gdisp/HX8347D/gdisp_lld_board_st_stm32f4_discovery.h @@ -0,0 +1,202 @@ +/*
+ * This file is subject to the terms of the GFX License, v1.0. If a copy of
+ * the license was not distributed with this file, you can obtain one at:
+ *
+ * http://chibios-gfx.com/license.html
+ */
+
+/**
+ * @file drivers/gdisp/HX8347D/gdisp_lld_board_embest_dmstf4bb.h
+ * @brief GDISP Graphic Driver subsystem board SPI interface for the HX8347D display.
+ *
+ * @addtogroup GDISP
+ * @{
+ */
+
+#ifndef _GDISP_LLD_BOARD_H
+#define _GDISP_LLD_BOARD_H
+
+#define SET_RST palSetPad(GPIOB, 8);
+#define CLR_RST palClearPad(GPIOB, 8);
+
+/* PWM configuration structure. We use timer 4 channel 2 (orange LED on board). */
+static const PWMConfig pwmcfg = {
+ 1000000, /* 1 MHz PWM clock frequency. */
+ 100, /* PWM period is 100 cycles. */
+ NULL,
+ {
+ {PWM_OUTPUT_ACTIVE_HIGH, NULL},
+ {PWM_OUTPUT_ACTIVE_HIGH, NULL},
+ {PWM_OUTPUT_ACTIVE_HIGH, NULL},
+ {PWM_OUTPUT_ACTIVE_HIGH, NULL}
+ },
+ 0
+};
+
+/*
+ * SPI1 configuration structure.
+ * Speed 42MHz, CPHA=0, CPOL=0, 8bits frames, MSb transmitted first.
+ * The slave select line is the pin 4 on the port GPIOA.
+ */
+static const SPIConfig spi1cfg1 = {
+ NULL,
+ /* HW dependent part.*/
+ GPIOA,
+ 4,
+ 0 //SPI_CR1_BR_0
+};
+
+/*
+ * SPI1 configuration structure.
+ * Speed 42MHz, CPHA=0, CPOL=0, 16bits frames, MSb transmitted first.
+ * The slave select line is the pin 4 on the port GPIOA.
+ */
+static const SPIConfig spi1cfg2 = {
+ NULL,
+ /* HW dependent part.*/
+ GPIOA,
+ 4,
+ SPI_CR1_DFF //SPI_CR1_BR_0
+};
+
+/**
+ * @brief Initialise the board for the display.
+ * @notes This board definition uses GPIO and assumes exclusive access to these GPIO pins
+ *
+ * @notapi
+ */
+static inline void init_board(void) {
+
+ /* Display backlight control */
+ /* TIM4 is an alternate function 2 (AF2) */
+ pwmStart(&PWMD4, &pwmcfg);
+ palSetPadMode(GPIOD, 13, PAL_MODE_ALTERNATE(2));
+ pwmEnableChannel(&PWMD4, 1, 100);
+
+ palSetPadMode(GPIOB, 8, PAL_MODE_OUTPUT_PUSHPULL |
+ PAL_STM32_OSPEED_HIGHEST); /* RST */
+ palSetPadMode(GPIOB, 9, PAL_MODE_OUTPUT_PUSHPULL |
+ PAL_STM32_OSPEED_HIGHEST); /* RS */
+ /*
+ * Initializes the SPI driver 1. The SPI1 signals are routed as follow:
+ * PB12 - NSS.
+ * PB13 - SCK.
+ * PB14 - MISO.
+ * PB15 - MOSI.
+ */
+ spiStart(&SPID1, &spi1cfg1);
+ palSetPad(GPIOA, 4);
+ palSetPadMode(GPIOA, 4, PAL_MODE_OUTPUT_PUSHPULL |
+ PAL_STM32_OSPEED_HIGHEST); /* NSS. */
+ palSetPadMode(GPIOA, 5, PAL_MODE_ALTERNATE(5) |
+ PAL_STM32_OSPEED_HIGHEST); /* SCK. */
+ palSetPadMode(GPIOA, 6, PAL_MODE_ALTERNATE(5)); /* MISO. */
+ palSetPadMode(GPIOA, 7, PAL_MODE_ALTERNATE(5) |
+ PAL_STM32_OSPEED_HIGHEST); /* MOSI. */
+
+}
+
+/**
+ * @brief Set or clear the lcd reset pin.
+ *
+ * @param[in] state TRUE = lcd in reset, FALSE = normal operation
+ *
+ * @notapi
+ */
+static inline void setpin_reset(bool_t state) {
+ if (state) {
+ CLR_RST;
+ } else {
+ SET_RST;
+ }
+}
+
+/**
+ * @brief Set the lcd back-light level.
+ *
+ * @param[in] percent 0 to 100%
+ *
+ * @notapi
+ */
+static inline void set_backlight(uint8_t percent) {
+ pwmEnableChannel(&PWMD4, 1, percent);
+}
+
+/**
+ * @brief Take exclusive control of the bus
+ * @note Not needed, not implemented
+ *
+ * @notapi
+ */
+static inline void acquire_bus(void) {
+ spiAcquireBus(&SPID1);
+}
+
+/**
+ * @brief Release exclusive control of the bus
+ * @note Not needed, not implemented
+ *
+ * @notapi
+ */
+static inline void release_bus(void) {
+ spiReleaseBus(&SPID1);
+}
+
+/**
+ * @brief Send data to the index register.
+ *
+ * @param[in] index The index register to set
+ *
+ * @notapi
+ */
+static inline void write_index(uint8_t cmd) {
+ palClearPad(GPIOB, 9);
+ palClearPad(GPIOA, 4);
+ while((SPI1->SR & SPI_SR_TXE) == 0);
+ SPI1->DR = cmd;
+ while(((SPI1->SR & SPI_SR_TXE) == 0) || ((SPI1->SR & SPI_SR_BSY) != 0));
+ palSetPad(GPIOB, 9);
+}
+
+/**
+ * @brief Send data to the lcd.
+ *
+ * @param[in] data The data to send
+ *
+ * @notapi
+ */
+static inline void write_data(uint8_t data) {
+ SPI1->DR = data;
+ while(((SPI1->SR & SPI_SR_TXE) == 0) || ((SPI1->SR & SPI_SR_BSY) != 0));
+ palSetPad(GPIOA, 4);
+}
+
+static inline void write_ram8(uint8_t data1, uint8_t data2) {
+ SPI1->DR = data1;
+ while((SPI1->SR & SPI_SR_TXE) == 0);
+ SPI1->DR = data2;
+ while(((SPI1->SR & SPI_SR_TXE) == 0) || ((SPI1->SR & SPI_SR_BSY) != 0));
+ palSetPad(GPIOA, 4);
+}
+
+static inline void write_ram16(uint16_t data) {
+ while((SPI1->SR & SPI_SR_TXE) == 0);
+ SPI1->DR = data;
+}
+
+#if GDISP_HARDWARE_READPIXEL || defined(__DOXYGEN__)
+/**
+ * @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 */
+/** @} */
diff --git a/drivers/gdisp/HX8347D/gdisp_lld_config.h b/drivers/gdisp/HX8347D/gdisp_lld_config.h new file mode 100644 index 00000000..b8bf853f --- /dev/null +++ b/drivers/gdisp/HX8347D/gdisp_lld_config.h @@ -0,0 +1,39 @@ +/*
+ * This file is subject to the terms of the GFX License, v1.0. If a copy of
+ * the license was not distributed with this file, you can obtain one at:
+ *
+ * http://chibios-gfx.com/license.html
+ */
+
+/**
+ * @file drivers/gdisp/HX8347D/gdisp_lld_config.h
+ * @brief GDISP Graphic Driver subsystem low level driver header for the HX8347D display.
+ *
+ * @addtogroup GDISP
+ * @{
+ */
+
+#ifndef _GDISP_LLD_CONFIG_H
+#define _GDISP_LLD_CONFIG_H
+
+#if GFX_USE_GDISP
+
+/*===========================================================================*/
+/* Driver hardware support. */
+/*===========================================================================*/
+
+#define GDISP_DRIVER_NAME "HX8347D"
+
+#define GDISP_HARDWARE_CLEARS TRUE
+#define GDISP_HARDWARE_FILLS TRUE
+#define GDISP_HARDWARE_BITFILLS TRUE
+#define GDISP_HARDWARE_SCROLL FALSE
+#define GDISP_HARDWARE_PIXELREAD FALSE
+#define GDISP_HARDWARE_CONTROL TRUE
+
+#define GDISP_PIXELFORMAT GDISP_PIXELFORMAT_RGB565
+
+#endif /* GFX_USE_GDISP */
+
+#endif /* _GDISP_LLD_CONFIG_H */
+/** @} */
diff --git a/drivers/gdisp/HX8347D/readme.txt b/drivers/gdisp/HX8347D/readme.txt new file mode 100644 index 00000000..1725ef60 --- /dev/null +++ b/drivers/gdisp/HX8347D/readme.txt @@ -0,0 +1,24 @@ +Description:
+
+Driver for LCD with 4-wire serial interface (65k colors).
+
+To use this driver:
+
+1. Add in your halconf.h:
+ a) #define GFX_USE_GDISP TRUE
+
+ b) Any optional high level driver defines (see gdisp.h) eg: GDISP_NEED_MULTITHREAD
+
+ c) If you are not using a known board then create a gdisp_lld_board.h file
+ and ensure it is on your include path.
+ Use the gdisp_lld_board_st_stm32f4_discovery.h file as a basis.
+ Currently known boards are:
+ BOARD_ST_STM32F4_DISCOVERY
+ Board configuration assume that you have STM32_PWM_USE_TIM4 set to TRUE in your mcuconf.h.
+
+ d) The following are optional - define them if you are not using the defaults below:
+ #define GDISP_SCREEN_WIDTH 240
+ #define GDISP_SCREEN_HEIGHT 320
+
+2. To your makefile add the following lines:
+ include $(GFXLIB)/drivers/gdisp/HX8347D/gdisp_lld.mk
|