aboutsummaryrefslogtreecommitdiffstats
path: root/drivers/gdisp/KS0108/board_KS0108_example.h
diff options
context:
space:
mode:
Diffstat (limited to 'drivers/gdisp/KS0108/board_KS0108_example.h')
-rw-r--r--drivers/gdisp/KS0108/board_KS0108_example.h394
1 files changed, 394 insertions, 0 deletions
diff --git a/drivers/gdisp/KS0108/board_KS0108_example.h b/drivers/gdisp/KS0108/board_KS0108_example.h
new file mode 100644
index 00000000..86541f73
--- /dev/null
+++ b/drivers/gdisp/KS0108/board_KS0108_example.h
@@ -0,0 +1,394 @@
+/*
+ * 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
+ */
+/* KS0107/0108 Driver
+ * Pinout: There are at least two different Pinouts!
+ * Version 1:
+ * 1 - CS1 High Active
+ * 2 - CS2 High Active
+ * 3 - GND
+ * 4 - 5V
+ * 5 - CONTRAST
+ * 6 - RS(=DC) High = Data, Low = Command
+ * 7 - R/W High = Read, Low = Write
+ * 8 - E Data is KS0108_latched at the falling Edge
+ * 9..16 - D0..7
+ * Version 2:
+ * 1 - GND
+ * 2 - 5V
+ * 3 - Vo (Operating Voltage for LCD)
+ * 4 - RS High = Data, Low = Command
+ * 5 - R/W High = Read, Low = Write
+ * 6 - E Data is KS0108_latched at the falling Edge
+ * 7..14 - D0..7
+ * 15 - CS1 High Active
+ * 16 - CS2 High Active
+ * 17 - /RST Low Active
+ * 18 - Vout (Output voltage for LCD)
+ * 19 - LEDA
+ * 20 - LEDK
+ *
+ */
+#ifndef _GDISP_LLD_BOARD_H
+#define _GDISP_LLD_BOARD_H
+
+// My Settings
+#define GDISP_SCREEN_HEIGHT 64
+#define GDISP_SCREEN_WIDTH 128
+#define KS0108_NEED_READ FALSE
+#define KS0108_HAS_RESET FALSE
+#define KS0108_NEED_BACKLIGHT FALSE
+#define KS0108_NEED_PWMBACKLIGHT FALSE
+#define KS0108_NOP_DLY TRUE //doesn't work for me without!
+
+#define LINE_D0 PAL_LINE(GPIOB, 0U)
+#define LINE_D1 PAL_LINE(GPIOB, 1U)
+#define LINE_D2 PAL_LINE(GPIOB, 2U)
+#define LINE_D3 PAL_LINE(GPIOB, 3U)
+#define LINE_D4 PAL_LINE(GPIOB, 4U)
+#define LINE_D5 PAL_LINE(GPIOB, 5U)
+#define LINE_D6 PAL_LINE(GPIOB, 6U)
+#define LINE_D7 PAL_LINE(GPIOB, 7U)
+#define LINE_BUSY PAL_LINE(GPIOB, 7U)
+#define LINE_CS1 PAL_LINE(GPIOB, 8U)
+#define LINE_CS2 PAL_LINE(GPIOB, 9U)
+#define LINE_E PAL_LINE(GPIOB, 10U)
+#define LINE_DC PAL_LINE(GPIOB, 11U)
+#if KS0108_NEED_READ
+ #define LINE_RW PAL_LINE(GPIOB, 12U)
+#endif
+#if KS0108_NEED_BACKLIGHT
+ #define LINE_BL PAL_LINE(GPIOB, 13U)
+#endif
+#if KS0108_HAS_RESET
+ #define LINE_RESET PAL_LINE(GPIOB, 13U)
+#endif
+
+typedef struct {
+ ioline_t CS1; // Chip Select1 PIN
+ ioline_t CS2; // Chip Select2 PIN
+ ioline_t DC; // Register selector PIN
+ ioline_t E; // Enable PIN
+ ioline_t BUSY; // Busy PIN (Same as D[7])
+ #if KS0108_NEED_READ
+ ioline_t RW; // Read/Write PIN
+ #endif
+ #if KS0108_HAS_RESET
+ ioline_t RST; // Reset PIN
+ #endif
+ #if KS0108_NEED_BACKLIGHT
+ ioline_t BL; // Backlight PIN
+ #endif
+ ioline_t D[8];
+ ioline_t CS[CHIPS];
+ } lcd_pins_t;
+
+/*===========================================================================*/
+/* Driver local variables. */
+/*===========================================================================*/
+static const lcd_pins_t lcdpins = {
+ LINE_CS1,
+ LINE_CS2,
+ LINE_DC,
+ LINE_E,
+ LINE_BUSY,
+ #if KS0108_NEED_READ
+ LINE_RW,
+ #endif
+ #if KS0108_HAS_RESET
+ LINE_RST,
+ #endif
+ #if KS0108_NEED_BACKLIGHT
+ LINE_BL,
+ #endif
+ {
+ LINE_D0,
+ LINE_D1,
+ LINE_D2,
+ LINE_D3,
+ LINE_D4,
+ LINE_D5,
+ LINE_D6,
+ LINE_D7
+ },
+ {
+ LINE_CS1,
+ LINE_CS2
+ }
+};
+
+static GFXINLINE void init_board(GDisplay* g){
+ (void) g;
+ g->board = 0;
+ int ii;
+
+ for (ii = 0; ii < CHIPS; ii++){
+ palSetLineMode(lcdpins.CS[ii], PAL_MODE_OUTPUT_PUSHPULL);
+ palClearLine(lcdpins.CS[ii]);
+ }
+ palSetLineMode(lcdpins.DC, PAL_MODE_OUTPUT_PUSHPULL);
+ palClearLine(lcdpins.DC);
+ palSetLineMode(lcdpins.E, PAL_MODE_OUTPUT_PUSHPULL);
+ palSetLine(lcdpins.E);
+ #if KS0108_NEED_READ
+ palSetLineMode(lcdpins.RW, PAL_MODE_OUTPUT_PUSHPULL);
+ palClearLine(lcdpins.RW);
+ #endif
+ #if KS0108_HAS_RESET
+ palSetLineMode(lcdpins.RST, PAL_MODE_OUTPUT_PUSHPULL);
+ palSetLine(lcdpins.RST);
+ #endif
+ for(ii = 0; ii < 8; ii++) {
+ palSetLineMode(lcdpins.D[ii], PAL_MODE_OUTPUT_PUSHPULL);
+ palClearLine(lcdpins.D[ii]);
+ }
+ #if KS0108_NEED_BACKLIGHT
+ #if KS0108_NEED_PWMBACKLIGHT
+ palSetLineMode(lcdpins.BL, PAL_MODE_ALTERNATE(1));
+ #else
+ palSetLineMode(lcdpins.BL, PAL_MODE_OUTPUT_PUSHPULL);
+ #endif
+ #endif
+}
+
+static GFXINLINE void post_init_board(GDisplay *g) {
+ (void) g;
+}
+
+static GFXINLINE void setpin_reset(GDisplay *g, bool_t state) {
+ (void) g;
+ (void) state;
+
+ #if KS0108_HAS_RESET //Make Hardware Reset
+ if (state)
+ palClearLine(lcdpins.RST);
+ else
+ palSetLine(lcdpins.RST);
+ #endif
+}
+
+static GFXINLINE void set_backlight(GDisplay *g, uint8_t percent) {
+ (void) g;
+ (void) percent;
+}
+
+static GFXINLINE void acquire_bus(GDisplay *g) {
+ (void) g;
+}
+
+static GFXINLINE void release_bus(GDisplay *g) {
+ (void) g;
+}
+
+void KS0108_delay(uint16_t microsec){
+ #if KS0108_NOP_DLY
+ uint16_t cn;
+ for (cn=0;cn< microsec;cn++){
+
+ asm("nop");asm("nop");asm("nop");asm("nop");
+ asm("nop");asm("nop");asm("nop");asm("nop");
+ asm("nop");asm("nop");asm("nop");asm("nop");
+ asm("nop");asm("nop");asm("nop");asm("nop");
+
+ asm("nop");asm("nop");asm("nop");asm("nop");
+ asm("nop");asm("nop");asm("nop");asm("nop");
+ asm("nop");asm("nop");asm("nop");asm("nop");
+ asm("nop");asm("nop");asm("nop");asm("nop");
+
+ asm("nop");asm("nop");asm("nop");asm("nop");
+ asm("nop");asm("nop");asm("nop");asm("nop");
+ asm("nop");asm("nop");asm("nop");asm("nop");
+ asm("nop");asm("nop");asm("nop");asm("nop");
+
+ asm("nop");asm("nop");asm("nop");asm("nop");
+ asm("nop");asm("nop");asm("nop");asm("nop");
+ asm("nop");asm("nop");asm("nop");asm("nop");
+ asm("nop");asm("nop");asm("nop");asm("nop");
+
+ //asm("nop");asm("nop");asm("nop");asm("nop");
+ //asm("nop");asm("nop");asm("nop");asm("nop");
+ //1us
+ }
+ #else
+ gfxSleepMicroseconds(microsec);
+ #endif
+}
+
+static GFXINLINE void KS0108_latch(void){
+ palClearLine(lcdpins.E);
+ KS0108_delay(1);
+ palSetLine(lcdpins.E);
+}
+
+static GFXINLINE void KS0108_write(uint8_t value){
+ int ii;
+
+ for(ii = 0; ii < 8; ii++){
+ if(value & (1 << ii))
+ palSetLine(lcdpins.D[ii]);
+ else
+ palClearLine(lcdpins.D[ii]);
+ }
+ KS0108_delay(1);
+}
+
+static GFXINLINE void KS0108_select(uint8_t chip){
+ uint8_t ii;
+ KS0108_delay(1);
+ for (ii = 0; ii < CHIPS; ii++){
+ if (ii == chip)
+ palSetLine(lcdpins.CS[ii]);
+ }
+ KS0108_delay(1);
+}
+
+static GFXINLINE void KS0108_unselect(void){
+ uint8_t ii;
+
+ KS0108_delay(1);
+ for (ii = 0; ii < CHIPS; ii++){
+ palClearLine(lcdpins.CS[ii]);
+ }
+}
+
+/*
+#if KS0108_NEED_READ //Hardware Read ############## WORKS more or less
+static GFXINLINE uint8_t read_KS0108(void) {
+ uint8_t ii, data=0;
+
+ for(ii = 0; ii < 8; ii++)
+ palSetLineMode(lcdpins.D[ii], PAL_MODE_INPUT); //Set pads to input
+ palSetLine(lcdpins.RW);
+ KS0108_delay(1);
+ palClearLine(lcdpins.E);
+ KS0108_delay(1);
+ palSetLine(lcdpins.E);
+ KS0108_delay(1);
+// palClearLine(lcdpins.RW);
+// KS0108_delay(1);
+// palSetLine(lcdpins.RW);
+// KS0108_delay(1);
+ for(ii = 0; ii < 8; ii++){
+ if (palReadLine(lcdpins.D[ii]) == PAL_HIGH){ //Read output
+ data |= (1<<ii);
+ }
+ }
+// palClearLine(lcdpins.E);
+ palClearLine(lcdpins.RW); //Write again
+ for(ii = 0; ii < 8; ii++) {
+ palSetLineMode(lcdpins.D[ii], PAL_MODE_OUTPUT_PUSHPULL); //Set pads to output
+ }
+ return data;
+}
+#endif
+*/
+#if KS0108_NEED_READ //Hardware Read ########### needs more testing but my display is broken
+static GFXINLINE uint8_t read_KS0108(void) {
+ uint8_t ii, data=0;
+
+ for(ii = 0; ii < 8; ii++)
+ palSetLineMode(lcdpins.D[ii], PAL_MODE_INPUT); //Set pads to input
+ palSetLine(lcdpins.RW);
+ KS0108_delay(1);
+
+ palClearLine(lcdpins.DC);
+ KS0108_delay(1);
+
+
+ while (palReadLine(lcdpins.BUSY)); //Wait for busy flag
+ palSetLine(lcdpins.DC);
+ /*
+ KS0108_delay(2);
+ KS0108_latch();
+ KS0108_delay(2);
+ //KS0108_latch();
+ //KS0108_delay(1);
+ */
+ palClearLine(lcdpins.RW);
+ KS0108_delay(2);
+ palSetLine(lcdpins.RW);
+ KS0108_delay(1);
+ palClearLine(lcdpins.DC);
+ KS0108_delay(1);
+ while (palReadLine(lcdpins.BUSY)); //Wait for busy flag
+ //KS0108_delay(7);
+ palSetLine(lcdpins.DC);
+
+ //KS0108_delay(1);
+ //KS0108_latch();
+ //KS0108_delay(3);
+
+ KS0108_delay(1);
+ for(ii = 0; ii < 8; ii++){
+ if (palReadLine(lcdpins.D[ii]) == PAL_HIGH) //Read output
+ data |= (1<<ii);
+ }
+ // palClearLine(lcdpins.E);
+ palSetLine(lcdpins.DC);
+ palClearLine(lcdpins.RW); //Write again
+ for(ii = 0; ii < 8; ii++) {
+ palSetLineMode(lcdpins.D[ii], PAL_MODE_OUTPUT_PUSHPULL); //Set pads to output
+ }
+ return data;
+}
+#endif
+
+static GFXINLINE void write_data(GDisplay* g, uint16_t data){
+ (void)g;
+ uint8_t bit, displayData;
+ #if !KS0108_NEED_READ
+ uint8_t *p;
+ #endif
+
+ palSetLine(lcdpins.DC);
+ KS0108_select((uint8_t)(data>>8));
+ #if KS0108_NEED_READ
+ displayData=read_KS0108();
+ #else
+ p = RAM(g) + (GDISP_SCREEN_WIDTH*(g->p.y >> 3)) + g->p.x;
+ displayData = *p;
+ #endif
+ bit = 1 << (g->p.y & 7); //Get Page bit
+
+ if ((uint8_t)data){ //set bit
+ KS0108_write(displayData | bit);
+ #if !KS0108_NEED_READ
+ *p = (displayData | bit);
+ #endif
+ KS0108_latch();
+ } else {
+ KS0108_write(displayData & ~bit);
+ #if !KS0108_NEED_READ
+ *p = (displayData & ~bit);
+ #endif
+ KS0108_latch();
+ }
+ KS0108_delay(2); //one is too short!
+ KS0108_unselect(); //Important
+}
+
+static GFXINLINE void write_cmd(GDisplay* g, uint16_t cmd){
+ (void)g;
+ palClearLine(lcdpins.DC);
+ KS0108_select((uint8_t)(cmd>>8));
+ KS0108_write((uint8_t)cmd);
+ KS0108_latch();
+ KS0108_unselect(); //Important
+}
+
+static GFXINLINE void setreadmode(GDisplay *g) {
+ (void) g;
+}
+
+static GFXINLINE void setwritemode(GDisplay *g) {
+ (void) g;
+}
+
+static GFXINLINE uint16_t read_data(GDisplay *g) {
+ (void) g;
+ return 0;
+}
+#endif /* _GDISP_LLD_BOARD_H */
generated by cgit v1.2.3 (git 2.25.1) at 2024-06-02 11:06:08 +0000