From bf3761e0f2f4096081602238642d2393bfe5842f Mon Sep 17 00:00:00 2001
From: Joel Bodenmann <joel@unormal.org>
Date: Sun, 15 Sep 2013 00:32:57 +0200
Subject: [PATCH] Added ST7565 driver by user sam0737

---
 drivers/gdisp/ST7565/gdisp_lld.c              | 269 ++++++++++++++++++
 drivers/gdisp/ST7565/gdisp_lld.mk             |   6 +
 .../gdisp/ST7565/gdisp_lld_board_template.h   |  82 ++++++
 drivers/gdisp/ST7565/gdisp_lld_config.h       |  29 ++
 drivers/gdisp/ST7565/st7565.h                 |  42 +++
 5 files changed, 428 insertions(+)
 create mode 100644 drivers/gdisp/ST7565/gdisp_lld.c
 create mode 100644 drivers/gdisp/ST7565/gdisp_lld.mk
 create mode 100644 drivers/gdisp/ST7565/gdisp_lld_board_template.h
 create mode 100644 drivers/gdisp/ST7565/gdisp_lld_config.h
 create mode 100644 drivers/gdisp/ST7565/st7565.h

diff --git a/drivers/gdisp/ST7565/gdisp_lld.c b/drivers/gdisp/ST7565/gdisp_lld.c
new file mode 100644
index 00000000..960b1389
--- /dev/null
+++ b/drivers/gdisp/ST7565/gdisp_lld.c
@@ -0,0 +1,269 @@
+/*
+ * 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 || defined(__DOXYGEN__)
+
+
+/* Include the emulation code for things we don't support */
+#include "gdisp/lld/emulation.c"
+#include "st7565.h"
+#include "gdisp_lld_board.h"
+
+
+/*===========================================================================*/
+/* Driver local definitions.                                                 */
+/*===========================================================================*/
+
+#ifndef GDISP_SCREEN_HEIGHT
+#define GDISP_SCREEN_HEIGHT		64
+#endif
+#ifndef GDISP_SCREEN_WIDTH
+#define GDISP_SCREEN_WIDTH		128
+#endif
+
+#define GDISP_INITIAL_CONTRAST		0xFF
+
+/*===========================================================================*/
+/* Driver local functions.                                                   */
+/*===========================================================================*/
+
+// Some common routines and macros
+#define delay(us)         gfxSleepMicroseconds(us)
+#define delay_ms(ms)      gfxSleepMilliseconds(ms)
+
+// The memory buffer for the display
+static uint8_t gdisp_buffer[GDISP_SCREEN_HEIGHT * GDISP_SCREEN_WIDTH / 8];
+
+/** Set the display to normal or inverse.
+ *  @param[in] value 0 for normal mode, or 1 for inverse mode.
+ *  @notapi
+ */
+static void invert_display(uint8_t i) {
+  write_cmd(i ? ST7565_INVERT_DISPLAY : ST7565_POSITIVE_DISPLAY);
+}
+
+/** Turn the whole display off.
+ *	Sends the display to sleep, but leaves RAM intact.
+ *	@notapi
+ */
+static void display_off(void) {
+  write_cmd(ST7565_DISPLAY_OFF);
+}
+
+/** Turn the whole display on.
+ * 	Wakes up this display following a sleep() call.
+ *	@notapi
+ */
+static void display_on(void) {
+  write_cmd(ST7565_DISPLAY_ON);
+}
+
+/** Set the display contrast.
+ *  @param[in] value The contrast, from 1 to 63.
+ *	@notapi
+ */
+static void set_contrast(uint8_t value) {
+  write_cmd(ST7565_CONTRAST);
+  write_cmd(value & 0x3F);
+}
+
+/** Set the display start line.  This is the line at which the display will start rendering.
+ *  @param[in] value A value from 0 to 63 denoting the line to start at.
+ *	@notapi
+ */
+static void set_display_start_line(unsigned char value) {
+  write_cmd(ST7565_START_LINE | value);
+}
+
+static void gdisp_lld_display(void) {
+  uint8_t p;
+  set_display_start_line(0);
+
+  for (p = 0; p < 8; p++) {
+    write_cmd(ST7565_PAGE | p);
+    write_cmd(ST7565_COLUMN_MSB | 0);
+    write_cmd(ST7565_COLUMN_LSB | 0);
+    write_cmd(ST7565_RMW);
+    write_data(&gdisp_buffer[p * GDISP_SCREEN_WIDTH], GDISP_SCREEN_WIDTH);
+  }
+}
+
+/*===========================================================================*/
+/* 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) {
+  // Initialize your display
+  init_board();
+
+  // Hardware reset.
+  setpin_reset(TRUE);
+  delay_ms(10);
+  setpin_reset(FALSE);
+  delay_ms(1);
+
+  write_cmd(ST7565_LCD_BIAS_7);
+  write_cmd(ST7565_ADC_NORMAL);
+  write_cmd(ST7565_COM_SCAN_INC);
+  set_display_start_line(0);
+
+  set_contrast(32);
+  write_cmd(ST7565_RESISTOR_RATIO | 0x3);
+
+  // turn on voltage converter (VC=1, VR=0, VF=0)
+  write_cmd(ST7565_POWER_CONTROL | 0x04);
+  delay_ms(50);
+  // turn on voltage regulator (VC=1, VR=1, VF=0)
+  write_cmd(ST7565_POWER_CONTROL | 0x06);
+  delay_ms(50);
+  // turn on voltage follower (VC=1, VR=1, VF=1)
+  write_cmd(ST7565_POWER_CONTROL | 0x07);
+  delay_ms(50);
+
+  display_on();
+  write_cmd(ST7565_ALLON_NORMAL);
+  invert_display(0);// Disable Inversion of display.
+
+  write_cmd(ST7565_RMW);
+  gdisp_lld_display();
+
+  // Initialize the GDISP structure
+  GDISP.Width = GDISP_SCREEN_WIDTH;
+  GDISP.Height = GDISP_SCREEN_HEIGHT;
+  GDISP.Orientation = GDISP_ROTATE_0;
+  GDISP.Powermode = powerOn;
+  GDISP.Contrast = 50;
+#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
+
+  if (color == 1)
+  gdisp_buffer[x+ (y/8)*GDISP_SCREEN_WIDTH] |= (1<<y%8);
+  else
+  gdisp_buffer[x+ (y/8)*GDISP_SCREEN_WIDTH] &= ~(1<<y%8);
+}
+
+/* ---- 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_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.
+ *          GDISP_CONTROL_CONTRAST      - Takes an int from 0 to 100.
+ *          GDISP_CONTROL_LLD           - Low level driver control constants start at
+ *                                        this value.
+ *
+ * @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_POWER:
+      if (GDISP.Powermode == (gdisp_powermode_t)value)
+        return;
+
+      switch((gdisp_powermode_t)value) {
+        case powerOff:
+          display_off();
+          break;
+        case powerSleep:
+          display_off();
+          break;
+        case powerDeepSleep:
+          display_off();
+          break;
+        case powerOn:
+          display_on();
+          break;
+        default:
+          return;
+      }
+      GDISP.Powermode = (gdisp_powermode_t)value;
+      return;
+
+    case GDISP_CONTROL_BACKLIGHT:
+      set_backlight((uint8_t)(size_t)value);
+      return;
+
+    case GDISP_CONTROL_CONTRAST:
+      if ((unsigned)value > 100) value = (void*)100;
+      if (GDISP.Contrast == (uint8_t)((float)((size_t)value) * 63.0/100.0))
+        return;
+      set_contrast((uint8_t)((float)((size_t)value) * 63.0/100.0) );
+      GDISP.Contrast = (unsigned)value;
+      return;
+
+    case GDISP_CONTROL_LLD_FLUSH:
+      gdisp_lld_display();
+      return;
+  }
+}
+#endif // GDISP_NEED_CONTROL
+
+#endif // GFX_USE_GDISP
+/** @} */
+
diff --git a/drivers/gdisp/ST7565/gdisp_lld.mk b/drivers/gdisp/ST7565/gdisp_lld.mk
new file mode 100644
index 00000000..cd925824
--- /dev/null
+++ b/drivers/gdisp/ST7565/gdisp_lld.mk
@@ -0,0 +1,6 @@
+# List the required driver.
+GFXSRC += $(GFXLIB)/drivers/gdisp/ST7565/gdisp_lld.c
+
+# Required include directories
+GFXINC += $(GFXLIB)/drivers/gdisp/ST7565
+
diff --git a/drivers/gdisp/ST7565/gdisp_lld_board_template.h b/drivers/gdisp/ST7565/gdisp_lld_board_template.h
new file mode 100644
index 00000000..2f40ccc7
--- /dev/null
+++ b/drivers/gdisp/ST7565/gdisp_lld_board_template.h
@@ -0,0 +1,82 @@
+/*
+ * 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
+
+/**
+ * @brief   Initialize 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) {
+  /* Configure SPI bus here. Up to 10Mhz, SPI Mode = 3 (CPOL = 1, CPHA = 0) */
+  /* Configure A0, !CS, !RST pin for output */
+}
+
+/**
+ * @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) {
+  /* Set !CS to low */
+  if (state) {
+    /* Set !RST to low */
+  } else {
+    /* Set !RST to high */
+  }
+}
+
+/**
+ * @brief   Set the lcd back-light level.
+ * @param[in] percent		0 to 100%
+ * @notapi
+ */
+static inline void set_backlight(uint8_t percent) {
+
+}
+
+/**
+ * @brief   Take exclusive control of the bus
+ * @notapi
+ */
+static inline void acquire_bus(void) {
+
+}
+
+/**
+ * @brief   Release exclusive control of the bus
+ * @notapi
+ */
+static inline void release_bus(void) {
+
+}
+
+/**
+ * @brief   Send command to the display.
+ * @param[in] cmd	The command to send
+ * @notapi
+ */
+static inline void write_cmd(uint8_t cmd) {
+  /* Set A0 to low */
+  /* Transmit cmd over SPI */
+}
+
+/**
+ * @brief   Send data to the display.
+ * @param[in] data	The data to send
+ * @notapi
+ */
+static inline void write_data(uint8_t* data, uint16_t length) {
+  /* Set A0 to high */
+  /* Transmit data for length over SPI. DMA is recommended. */
+}
+
+#endif /* _GDISP_LLD_BOARD_H */
+/** @} */
+
diff --git a/drivers/gdisp/ST7565/gdisp_lld_config.h b/drivers/gdisp/ST7565/gdisp_lld_config.h
new file mode 100644
index 00000000..8d26a0aa
--- /dev/null
+++ b/drivers/gdisp/ST7565/gdisp_lld_config.h
@@ -0,0 +1,29 @@
+/*
+ * 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_DRIVER_NAME         "ST7565"
+
+#define GDISP_HARDWARE_CONTROL    TRUE
+
+#define GDISP_PIXELFORMAT         GDISP_PIXELFORMAT_MONO
+
+#define GDISP_CONTROL_LLD_FLUSH   (GDISP_CONTROL_LLD + 1)
+
+#endif	/* GFX_USE_GDISP */
+
+#endif	/* _GDISP_LLD_CONFIG_H */
+/** @} */
+
diff --git a/drivers/gdisp/ST7565/st7565.h b/drivers/gdisp/ST7565/st7565.h
new file mode 100644
index 00000000..b1f43f6b
--- /dev/null
+++ b/drivers/gdisp/ST7565/st7565.h
@@ -0,0 +1,42 @@
+/*
+ * 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 _ST7565_H
+#define _ST7565_H
+
+#define ST7565_BLACK 0
+#define ST7565_WHITE 1
+
+#define ST7565_CONTRAST             0x81
+#define ST7565_ALLON_NORMAL         0xA4
+#define ST7565_ALLON                0xA5
+#define ST7565_POSITIVE_DISPLAY     0xA6
+#define ST7565_INVERT_DISPLAY       0xA7
+#define ST7565_DISPLAY_OFF          0xAE
+#define ST7565_DISPLAY_ON           0xAF
+
+#define ST7565_LCD_BIAS_7           0xA3
+#define ST7565_LCD_BIAS_9           0xA2
+
+#define ST7565_ADC_NORMAL           0xA0
+#define ST7565_ADC_REVERSE          0xA1
+
+#define ST7565_COM_SCAN_INC         0xC0
+#define ST7565_COM_SCAN_DEC         0xC8
+
+#define ST7565_START_LINE           0x40
+#define ST7565_PAGE                 0xB0
+#define ST7565_COLUMN_MSB           0x10
+#define ST7565_COLUMN_LSB           0x00
+#define ST7565_RMW                  0xE0
+
+#define ST7565_RESISTOR_RATIO       0x20
+#define ST7565_POWER_CONTROL        0x28
+
+#endif /* _ST7565_H */
+/** @} */
+