/* $Id: HD44780.c,v 1.49 2004/01/09 04:16:06 reinelt Exp $ * * driver for display modules based on the HD44780 chip * * Copyright 1999-2004 Michael Reinelt * * Modification for 4-Bit mode * Copyright 2003 Martin Hejl (martin@hejl.de) * * Modification for 2nd controller support * Copyright 2003 Jesse Brook Kovach * * This file is part of LCD4Linux. * * LCD4Linux is free software; you can redistribute it and/or modify * it under the terms of the GNU General Public License as published by * the Free Software Foundation; either version 2, or (at your option) * any later version. * * LCD4Linux is distributed in the hope that it will be useful, * but WITHOUT ANY WARRANTY; without even the implied warranty of * MERCHANTABILITY or FITNESS FOR A PARTICULAR PURPOSE. See the * GNU General Public License for more details. * * You should have received a copy of the GNU General Public License * along with this program; if not, write to the Free Software * Foundation, Inc., 675 Mass Ave, Cambridge, MA 02139, USA. * * * $Log: HD44780.c,v $ * Revision 1.49 2004/01/09 04:16:06 reinelt * added 'section' argument to cfg_get(), but NULLed it on all calls by now. * * Revision 1.48 2004/01/06 22:33:13 reinelt * Copyright statements cleaned up * * Revision 1.47 2003/11/12 05:42:35 reinelt * small changes to the 16x4 handling * * Revision 1.46 2003/10/08 06:48:47 nicowallmeier * special handling for 16x4 displays * * Revision 1.45 2003/10/08 06:45:00 nicowallmeier * Support of two displays of the same size * * Revision 1.44 2003/10/05 17:58:50 reinelt * libtool junk; copyright messages cleaned up * * Revision 1.43 2003/09/29 06:12:56 reinelt * changed default HD44780 wiring: unused signals are GND * * Revision 1.42 2003/09/21 06:43:02 reinelt * * * MatrixOrbital: bidirectional communication * HD44780: special handling for 16x1 displays (thanks to Maciej Witkowiak) * * Revision 1.41 2003/09/13 06:20:39 reinelt * HD44780 timings changed; deactivated libtool * * Revision 1.40 2003/09/11 04:09:52 reinelt * minor cleanups * * Revision 1.39 2003/09/10 03:48:22 reinelt * Icons for M50530, new processing scheme (Ticks.Text...) * * Revision 1.38 2003/09/09 11:47:47 reinelt * basic icon support for HD44780 * * Revision 1.37 2003/09/09 06:54:43 reinelt * new function 'cfg_number()' * * Revision 1.36 2003/08/24 05:17:58 reinelt * liblcd4linux patch from Patrick Schemitz * * Revision 1.35 2003/08/22 03:45:08 reinelt * bug in parallel port code fixed, more icons stuff * * Revision 1.34 2003/08/19 05:23:55 reinelt * HD44780 dual-controller patch from Jesse Brook Kovach * * Revision 1.33 2003/08/19 04:28:41 reinelt * more Icon stuff, minor glitches fixed * * Revision 1.32 2003/08/16 07:31:35 reinelt * double buffering in all drivers * * Revision 1.31 2003/08/15 07:54:07 reinelt * HD

# Sweden - Bankeryd
# T freq bw fec_hi fec_lo mod transmission-mode guard-interval hierarchy
T 634000000 8MHz 2/3 NONE QAM64 8k 1/8 NONE
T 698000000 8MHz 2/3 NONE QAM64 8k 1/8 NONE

gned char controller, unsigned char data, unsigned char RS) { // send high nibble of the data HD_nibble (controller, ((data>>4)&0x0f)|RS); // Make sure we honour T_CYCLE ndelay(T_CYCLE-T_AS-T_PW); // send low nibble of the data HD_nibble(controller, (data&0x0f)|RS); } static void HD_command (unsigned char controller, unsigned char cmd, int delay) { unsigned char enable; if (Bits==8) { // enable signal: 'controller' is a bitmask // bit 0 .. send to controller #0 // bit 1 .. send to controller #1 // so we can send a byte to both controllers at the same time! enable=0; if (controller&0x01) enable|=SIGNAL_ENABLE; if (controller&0x02) enable|=SIGNAL_ENABLE2; // put data on DB1..DB8 parport_data (cmd); // clear RW and RS parport_control (SIGNAL_RW | SIGNAL_RS, 0); // Address set-up time ndelay(T_AS); // send command parport_toggle (enable, 1, T_PW); } else { HD_byte (controller, cmd, 0); } // wait for command completion udelay(delay); } static void HD_write (unsigned char controller, char *string, int len, int delay) { unsigned char enable; // sanity check if (len<=0) return; if (Bits==8) { // enable signal: 'controller' is a bitmask // bit 0 .. send to controller #0 // bit 1 .. send to controller #1 // so we can send a byte to both controllers at the same time! enable=0; if (controller&0x01) enable|=SIGNAL_ENABLE; if (controller&0x02) enable|=SIGNAL_ENABLE2; // clear RW, set RS parport_control (SIGNAL_RW | SIGNAL_RS, SIGNAL_RS); // Address set-up time ndelay(T_AS); while (len--) { // put data on DB1..DB8 parport_data (*(string++)); // send command parport_toggle (enable, 1, T_PW); // wait for command completion udelay(delay); } } else { // 4 bit mode while (len--) { // send data with RS enabled HD_byte (controller, *(string++), SIGNAL_RS); // wait for command completion udelay(delay); } } } static void HD_setGPO (int bits) { if (Lcd.gpos>0) { // put data on DB1..DB8 parport_data (bits); // 74HCT573 set-up time ndelay(20); // send data // 74HCT573 enable pulse width = 24ns parport_toggle (SIGNAL_GPO, 1, 230); } } static void HD_define_char (int ascii, char *buffer) { // define chars on *both* controllers! HD_command (0x03, 0x40|8*ascii, T_EXEC); HD_write (0x03, buffer, 8, T_WRCG); } int HD_clear (int full) { memset (FrameBuffer1, ' ', Lcd.rows*Lcd.cols*sizeof(char)); icon_clear(); bar_clear(); GPO=0; if (full) { memset (FrameBuffer2, ' ', Lcd.rows*Lcd.cols*sizeof(char)); HD_command (0x03, 0x01, T_CLEAR); // clear *both* displays HD_command (0x03, 0x03, T_CLEAR); // return home HD_setGPO (GPO); // all GPO's off } return 0; } int HD_init (LCD *Self) { int rows=-1, cols=-1, gpos=-1; char *s; s=cfg_get(NULL, "Size", NULL); if (s==NULL || *s=='\0') { error ("HD44780: no 'Size' entry in %s", cfg_source()); return -1; } if (sscanf(s,"%dx%d",&cols,&rows)!=2 || rows<1 || cols<1) { error ("HD44780: bad size '%s'",s); return -1; } if (cfg_number(NULL, "GPOs", 0, 0, 8, &gpos)<0) return -1; info ("HD44780: controlling %d GPO's", gpos); if (cfg_number(NULL, "Controllers", 1, 1, 2, &Controllers)<0) return -1; info ("wiring: using display with %d controllers", Controllers); // current controller Controller=1; Self->rows=rows; Self->cols=cols; Self->gpos=gpos; Lcd=*Self; // Init the framebuffers FrameBuffer1 = (char*)malloc(Lcd.cols*Lcd.rows*sizeof(char)); FrameBuffer2 = (char*)malloc(Lcd.cols*Lcd.rows*sizeof(char)); if (FrameBuffer1==NULL || FrameBuffer2==NULL) { error ("HD44780: framebuffer could not be allocated: malloc() failed"); return -1; } if (cfg_number(NULL, "Bits", 8, 4, 8, &Bits)<0) return -1; if (Bits!=4 && Bits!=8) { error ("HD44780: bad Bits '%s' in %s, should be '4' or '8'", s, cfg_source()); return -1; } info ("wiring: using %d bit mode", Bits); if (Bits==8) { if ((SIGNAL_RS = parport_wire_ctrl ("RS", "AUTOFD"))==0xff) return -1; if ((SIGNAL_RW = parport_wire_ctrl ("RW", "GND" ))==0xff) return -1; if ((SIGNAL_ENABLE = parport_wire_ctrl ("ENABLE", "STROBE"))==0xff) return -1; if ((SIGNAL_ENABLE2 = parport_wire_ctrl ("ENABLE2", "GND" ))==0xff) return -1; if ((SIGNAL_GPO = parport_wire_ctrl ("GPO", "GND" ))==0xff) return -1; } else { if ((SIGNAL_RS = parport_wire_data ("RS", "DB4"))==0xff) return -1; if ((SIGNAL_RW = parport_wire_data ("RW", "DB5"))==0xff) return -1; if ((SIGNAL_ENABLE = parport_wire_data ("ENABLE", "DB6"))==0xff) return -1; if ((SIGNAL_ENABLE2 = parport_wire_data ("ENABLE2", "GND"))==0xff) return -1; if ((SIGNAL_GPO = parport_wire_data ("GPO", "GND"))==0xff) return -1; } if (parport_open() != 0) { error ("HD44780: could not initialize parallel port!"); return -1; } // clear all signals if (Bits==8) { parport_control (SIGNAL_RS|SIGNAL_RW|SIGNAL_ENABLE|SIGNAL_ENABLE2|SIGNAL_GPO, 0); } else { parport_data (0); } // set direction: write parport_direction (0); // initialize *both* displays if (Bits==8) { HD_command (0x03, 0x30, T_INIT1); // 8 Bit mode, wait 4.1 ms HD_command (0x03, 0x30, T_INIT2); // 8 Bit mode, wait 100 us HD_command (0x03, 0x38, T_EXEC); // 8 Bit mode, 1/16 duty cycle, 5x8 font } else { HD_nibble(0x03, 0x03); udelay(T_INIT1); // 4 Bit mode, wait 4.1 ms HD_nibble(0x03, 0x03); udelay(T_INIT2); // 4 Bit mode, wait 100 us HD_nibble(0x03, 0x03); udelay(T_INIT1); // 4 Bit mode, wait 4.1 ms HD_nibble(0x03, 0x02); udelay(T_INIT2); // 4 Bit mode, wait 100 us HD_command (0x03, 0x28, T_EXEC); // 4 Bit mode, 1/16 duty cycle, 5x8 font } HD_command (0x03, 0x08, T_EXEC); // Display off, cursor off, blink off HD_command (0x03, 0x0c, T_CLEAR); // Display on, cursor off, blink off, wait 1.64 ms HD_command (0x03, 0x06, T_EXEC); // curser moves to right, no shift if (cfg_number(NULL, "Icons", 0, 0, CHARS, &Icons)<0) return -1; if (Icons>0) { debug ("reserving %d of %d user-defined characters for icons", Icons, CHARS); icon_init(Lcd.rows, Lcd.cols, XRES, YRES, CHARS, Icons, HD_define_char); Self->icons=Icons; Lcd.icons=Icons; } bar_init(rows, cols, XRES, YRES, CHARS-Icons); bar_add_segment( 0, 0,255, 32); // ASCII 32 = blank bar_add_segment(255,255,255,255); // ASCII 255 = block HD_clear(1); return 0; } void HD_goto (int row, int col) { int pos; // handle multiple displays/controllers if (Controllers>1 && row>=Lcd.rows/2) { row -= Lcd.rows/2; Controller = 2; } else { Controller = 1; } // 16x1 Displays are organized as 8x2 :-( if (Lcd.cols==16 && Lcd.rows==1 && col>7) { row++; col-=8; } // 16x4 Displays use a slightly different layout if (Lcd.cols==16 && Lcd.rows==4) { pos=(row%2)*64+(row/2)*16+col; } else { pos=(row%2)*64+(row/2)*20+col; } HD_command (Controller, (0x80|pos), T_EXEC); } int HD_put (int row, int col, char *text) { char *p=FrameBuffer1+row*Lcd.cols+col; char *t=text; while (*t && col++<=Lcd.cols) { *p++=*t++; } return 0; } int HD_bar (int type, int row, int col, int max, int len1, int len2) { return bar_draw (type, row, col, max, len1, len2); } int HD_icon (int num, int seq, int row, int col) { return icon_draw (num, seq, row, col); } int HD_gpo (int num, int val) { if (num>=Lcd.gpos) return -1; if (val) { GPO |= 1<2) break; } else { pos2=col; equal=0; } // special handling of 16x1 displays if (Lcd.rows==1 && Lcd.cols==16 && col==7) { break; } } HD_write (Controller, FrameBuffer1+row*Lcd.cols+pos1, pos2-pos1+1, T_EXEC); } } memcpy (FrameBuffer2, FrameBuffer1, Lcd.rows*Lcd.cols*sizeof(char)); HD_setGPO(GPO); return 0; } int HD_quit (void) { info("HD44780: shutting down."); if (FrameBuffer1) { free(FrameBuffer1); FrameBuffer1=NULL; } if (FrameBuffer2) { free(FrameBuffer2); FrameBuffer2=NULL; } return parport_close(); } LCD HD44780[] = { { name: "HD44780", rows: 0, cols: 0, xres: XRES, yres: YRES, bars: BAR_L | BAR_R | BAR_U | BAR_D | BAR_H2, icons: 0, gpos: 0, init: HD_init, clear: HD_clear, put: HD_put, bar: HD_bar, icon: HD_icon, gpo: HD_gpo, flush: HD_flush, quit: HD_quit }, { NULL } };