4 * This file is part of BeRTOS.
6 * Bertos is free software; you can redistribute it and/or modify
7 * it under the terms of the GNU General Public License as published by
8 * the Free Software Foundation; either version 2 of the License, or
9 * (at your option) any later version.
11 * This program is distributed in the hope that it will be useful,
12 * but WITHOUT ANY WARRANTY; without even the implied warranty of
13 * MERCHANTABILITY or FITNESS FOR A PARTICULAR PURPOSE. See the
14 * GNU General Public License for more details.
16 * You should have received a copy of the GNU General Public License
17 * along with this program; if not, write to the Free Software
18 * Foundation, Inc., 51 Franklin St, Fifth Floor, Boston, MA 02110-1301 USA
20 * As a special exception, you may use this file as part of a free software
21 * library without restriction. Specifically, if other files instantiate
22 * templates or use macros or inline functions from this file, or you compile
23 * this file and link it with other files to produce an executable, this
24 * file does not by itself cause the resulting executable to be covered by
25 * the GNU General Public License. This exception does not however
26 * invalidate any other reasons why the executable file might be covered by
27 * the GNU General Public License.
29 * Copyright 2005 Develer S.r.l. (http://www.develer.com/)
33 * \brief LM044L type LCD hardware module (impl.)
36 * \author Bernardo Innocenti <bernie@develer.com>
37 * \author Stefano Fedrigo <aleph@develer.com>
42 #include "hw/hw_lcd.h"
44 #include "cfg/cfg_arch.h"
46 #include <drv/timer.h>
48 #if defined(LCD_READ_H) && defined(LCD_READ_L) && defined(LCD_WRITE_H) && defined(LCD_WRITE_L)
49 #define CONFIG_LCD_4BIT 1
50 #elif defined(LCD_READ) && defined(LCD_WRITE)
51 #define CONFIG_LCD_4BIT 0
53 #error Incomplete or missing LCD_READ/LCD_WRITE macros
56 /** Flag di stato del display */
57 #define LCDF_BUSY BV(7)
59 #if CONFIG_LCD_ADDRESS_FAST == 1
60 #define lcd_address(x) lcd_address[x]
62 * Addresses of LCD display character positions, expanded
63 * for faster access (DB7 = 1).
65 static const uint8_t lcd_address[] =
68 0x80, 0x81, 0x82, 0x83,
69 0x84, 0x85, 0x86, 0x87,
70 0x88, 0x89, 0x8A, 0x8B,
71 0x8C, 0x8D, 0x8E, 0x8F,
73 0x90, 0x91, 0x92, 0x93,
77 0xC0, 0xC1, 0xC2, 0xC3,
78 0xC4, 0xC5, 0xC6, 0xC7,
79 0xC8, 0xC9, 0xCA, 0xCB,
80 0xCC, 0xCD, 0xCE, 0xCF,
82 0xD0, 0xD1, 0xD2, 0xD3,
87 0x94, 0x95, 0x96, 0x97,
88 0x98, 0x99, 0x9A, 0x9B,
89 0x9C, 0x9D, 0x9E, 0x9F,
90 0xA0, 0xA1, 0xA2, 0xA3,
92 0xA4, 0xA5, 0xA6, 0xA7,
96 0xD4, 0xD5, 0xD6, 0xD7,
97 0xD8, 0xD9, 0xDA, 0xDB,
98 0xDC, 0xDD, 0xDE, 0xDF,
99 0xE0, 0xE1, 0xE2, 0xE3,
101 0xE4, 0xE5, 0xE6, 0xE7,
104 #endif /* LCD_ROWS > 2 */
107 STATIC_ASSERT(countof(lcd_address) == LCD_ROWS * LCD_COLS);
108 #else /* CONFIG_LCD_ADDRESS_FAST == 0 */
110 static const uint8_t col_address[] =
119 STATIC_ASSERT(countof(col_address) == LCD_ROWS);
121 * Addresses of LCD display character positions, calculated runtime to save RAM
123 static uint8_t lcd_address(uint8_t addr)
125 return col_address[addr / LCD_COLS] + addr % LCD_COLS;
127 #endif /* CONFIG_LCD_ADDRESS_FAST */
130 * Current display position. We remember this to optimize
131 * LCD output by avoiding to set the address every time.
133 static lcdpos_t lcd_current_addr;
136 #if !defined(ARCH_EMUL) || !(ARCH & ARCH_EMUL)
137 /* __________________
140 * R/W __________________
144 * DATA -<================
146 INLINE void lcd_dataWrite(uint8_t data)
149 /* Write high nibble */
156 /* Write low nibble */
163 #else /* !CONFIG_LCD_4BIT */
172 #endif /* !CONFIG_LCD_4BIT */
175 /* __________________
184 INLINE uint8_t lcd_dataRead(void)
189 LCD_DB_IN; /* Set bus as input! */
194 /* Read high nibble */
201 /* Read low nibble */
208 #else /* !CONFIG_LCD_4BIT */
217 #endif /* !CONFIG_LCD_4BIT */
220 LCD_DB_OUT; /* Reset bus as output! */
228 * READ __________________
232 * DATA --<===============
234 INLINE void lcd_regWrite(uint8_t data)
250 INLINE uint8_t lcd_regRead(void)
255 data = lcd_dataRead();
262 INLINE void lcd_mode4Bit(void)
266 LCD_WRITE_H(LCD_CMD_SETFUNC);
275 #endif /* CONFIG_LCD_4BIT */
277 #else /* ARCH_EMUL */
279 extern void Emul_LCDWriteReg(uint8_t d);
280 extern uint8_t Emul_LCDReadReg(void);
281 extern void Emul_LCDWriteData(uint8_t d);
282 extern uint8_t Emul_LCDReadData(void);
284 #define lcd_regWrite(d) Emul_LCDWriteReg(d)
285 #define lcd_regRead(d) Emul_LCDReadReg()
286 #define lcd_dataWrite(d) Emul_LCDWriteData(d)
287 #define lcd_dataRead(d) Emul_LCDReadData()
289 #endif /* ARCH_EMUL */
293 * Wait until the LCD busy flag clears.
295 void lcd_waitBusy(void)
299 uint8_t val = lcd_regRead();
300 if (!(val & LCDF_BUSY))
307 * Move the cursor to \a addr, only if not already there.
309 void lcd_moveTo(uint8_t addr)
311 if (addr != lcd_current_addr)
314 lcd_regWrite(lcd_address(addr));
315 lcd_current_addr = addr;
321 * Write a value in LCD data register, waiting for the busy flag.
323 void lcd_setReg(uint8_t val)
329 #include <cfg/debug.h>
331 * Write the character \a c on display address \a addr.
333 * NOTE: argh, the HD44 lcd type is a bad beast: our
334 * move/write -> write optimization requires this mess
335 * because display lines are interleaved!
337 void lcd_putc(uint8_t addr, uint8_t c)
339 if (addr != lcd_current_addr)
340 lcd_setReg(lcd_address(addr));
344 lcd_current_addr = addr + 1;
346 /* If we are at end of display wrap the address to 0 */
347 if (lcd_current_addr == LCD_COLS * LCD_ROWS)
348 lcd_current_addr = 0;
350 /* If we are at the end of a row put the cursor at the beginning of the next */
351 if (!(lcd_current_addr % LCD_COLS))
352 lcd_setReg(lcd_address(lcd_current_addr));
357 * Remap the glyph of a character.
359 * glyph - bitmap of 8x8 bits.
360 * code - must be 0-7 for the Hitachi LCD-II controller.
362 void lcd_remapChar(const char *glyph, char code)
366 /* Set CG RAM address */
367 lcd_setReg((uint8_t)((1<<6) | (code << 3)));
369 /* Write bitmap data */
370 for (i = 0; i < 8; i++)
373 lcd_dataWrite(glyph[i]);
376 /* Move back to original address */
377 lcd_setReg(lcd_address(lcd_current_addr));
382 void lcd_remapfont(void)
384 static const char lcd_glyphs[8] =
386 0x04, 0x0E, 0x15, 0x04, 0x04, 0x04, 0x04, 0x00 /* up arrow */
390 for (i = 0; i < 15; i++)
391 lcd_remapChar(i, bernie_char);
394 lcd_setAddr(lcd_DefLayer, 0);
395 for (i = 0; i < 80; i++)
396 lcd_putCharUnlocked(i);
400 void lcd_hw_init(void)
409 #endif /* CONFIG_LCD_4BIT */
411 lcd_regWrite(LCD_CMD_SETFUNC);
414 lcd_regWrite(LCD_CMD_DISPLAY_ON);
417 lcd_regWrite(LCD_CMD_CLEAR);
421 lcd_regWrite(LCD_CMD_RESET_DDRAM); // 4 bit mode doesn't allow char reprogramming
423 lcd_regWrite(LCD_CMD_DISPLAYMODE);