Rev Author Line No. Line
193 miho 1 // LCD modul pro ovladani dvouradkoveho LCD modulu se standardnim Hitachi radicem
2 // (c)miho 2002
3 //
4 // Historie:
5 //
6 // 0.00 Uvodni verze se snadnou definici portu LCD displeje
7 // 0.01 Oprava portu (zapomenute stare identifikatory)
8 // 0.02 Doplnena moznost pripojeni datoveho portu LCD na libovolne porty
9 //
10 //
11 // Funkce:
12 //
13 // lcd_init() inicializuje LCD displej a porty, nutno volat jako prvni
14 //
15 // lcd_putc(c) zapis snaku do lcd displeje, zpracovava nasledujici ridici znaky
16 // \f = \x0C - nova stranka - smazani displeje
17 // \n = \x0A - odradkovani (prechod na druhou radku)
18 // \b = \x08 - backspace - posunuti kurzoru o 1 pozici zpet
19 // \r = \x0D - goto home to position 1,1
20 // \0 .. \7 - definovatelne znaky v pozicich 0 az 7 v CGRAM
21 // \20 .. \27 - alternativne zapsane znaky (oktalove) v pozicich 0 az 7 CGRAM
22 // Pozor na to, ze funkce printf konci tisk pokud narazi na \0 (konec retezce)
23 //
24 // lcd_gotoxy(x,y) presune kurzor na uvedenou adresu
25 // nekontroluje parametry
26 //
27 // lcd_cursor_on zapne kurzor
28 // lcd_cursor_off vypne kurzor
29 //
30 // lcd_define_char(Index, Def) Makro, ktere definuje znaky od pozice Index obsahem definicniho
31 // retezce Def. Kazdych 8 znaku retezce Def definuje dalsi znak v CGRAM.
32 // Kapacita CGRAM je celkem 8 znaku s indexem 0 az 7.
33 // Na konci se provede lcd_gotoxy(1,1).
34 // Na konci teto knihovny je priklad pouziti definovanych znaku
35 //
36 //
37 // Definice portu: // Datovy port displeje pripojeny na 4 bity za sebou na jeden port
38 //
39 // #define LCD_RS PIN_B2 // rizeni registru LCD displeje
40 // #define LCD_E PIN_B1 // enable LCD displeje
41 // #define LCD_DATA_LSB PIN_C2 // pripojeni LSB bitu datoveho portu LCD displeje (celkem 4 bity vzestupne za sebou)
42 //
43 //
44 // Alternativni definice: // Datovy port displeje pripojeny na libovolne 4 bitove porty (vede na kod delsi asi o 25 slov)
45 //
46 // #define LCD_RS PIN_B2 // rizeni registru LCD displeje
47 // #define LCD_E PIN_B1 // enable LCD displeje
48 // #define LCD_D0 PIN_C2 // D0 - datove bity pripojene na libovolne porty
49 // #define LCD_D1 PIN_C3 // D1
50 // #define LCD_D2 PIN_C4 // D2
51 // #define LCD_D3 PIN_C5 // D3
52  
53  
54  
55  
56 // Privatni sekce, cist jen v pripade, ze neco nefunguje
57  
58  
59  
60  
61 #ifdef LCD_DATA_LSB
62 // Generovane defince portu pro ucely teto knihovny aby kod generoval spravne IO operace a soucasne
63 // bylo mozne jednoduse deklarovat pripojene piny LCD displeje pri pouziti teto knihovny. Problem spociva
64 // v tom, ze se musi spravne ridit smery portu a soucasne datovy port zabira jen 4 bity ze zadaneho portu
65 //
66 #define LCD_SHIFT (LCD_DATA_LSB&7) // pocet bitu posuvu datoveho kanalu v datovem portu
67 #define LCD_PORT (LCD_DATA_LSB>>3) // adresa LCD datoveho portu
68 #define LCD_TRIS (LCD_PORT+0x80) // adresa prislusneho TRIS registru
69 #define LCD_MASK (0xF<<LCD_SHIFT) // maska platnych bitu
70 //
71 #if LCD_SHIFT>4 // kontrola mezi
72 #error LCD data port LSB bit not in range 0..4
73 #endif
74 #endif
75  
76  
77 // Definice konstant pro LCD display
78 //
79 #define LCD_CURSOR_ON_ 0x0E // kurzor jako blikajici radka pod znakem
80 #define LCD_CURSOR_OFF_ 0x0C // zadny kurzor
81 #define LCD_LINE_2 0x40 // adresa 1. znaku 2. radky
82  
83  
84 // Definice rezimu LCD displeje
85 //
86 BYTE const LCD_INIT_STRING[4] =
87 {
88 0x28, // intrfejs 4 bity, 2 radky, font 5x7
89 LCD_CURSOR_OFF_, // display on, kurzor off,
90 0x01, // clear displeje
91 0x06 // inkrement pozice kurzoru (posun kurzoru doprava)
92 };
93  
94  
95 // Odesle nibble do displeje (posle data a klikne signalem e)
96 //
97 void lcd_send_nibble( BYTE n )
98 {
99 #ifdef LCD_DATA_LSB
100 // data jsou za sebou na 4 bitech jednoho portu
101 *LCD_PORT = (*LCD_PORT & ~LCD_MASK) | ((n << LCD_SHIFT) & LCD_MASK); // nastav datove bity portu a ostatni zachovej
102 #else
103 // data jsou na libovolnych 4 bitech libovolnych portu
104 output_bit(LCD_D0,bit_test(n,0));
105 output_bit(LCD_D1,bit_test(n,1));
106 output_bit(LCD_D2,bit_test(n,2));
107 output_bit(LCD_D3,bit_test(n,3));
108 #endif
109 output_bit(LCD_E,1); // vzestupna hrana
110 delay_us(1); // pockej alespon 450ns od e nebo alespon 195ns od dat
111 output_bit(LCD_E,0); // sestupna hrana (minimalni perioda e je 1us)
112 }
113  
114  
115 // Odesle bajt do registru LCD
116 //
117 // Pokud je Adr=0 .. instrukcni registr
118 // Pokud je Adr=1 .. datovy registr
119 //
120 void lcd_send_byte( BOOLEAN Adr, BYTE n )
121 {
122 output_bit(LCD_RS,Adr); // vyber registr
123 swap(n);
124 lcd_send_nibble(n); // posli horni pulku bajtu
125 swap(n);
126 lcd_send_nibble(n); // posli spodni pulku bajtu
127 delay_us(40); // minimalni doba na provedeni prikazu
128 }
129  
130  
131 // Provede inicializaci LCD displeje, smaze obsah a nastavi mod displeje
132 //
133 // Tato procedura se musi volat pred pouzitim ostatnich lcd_ procedur
134 //
135 void lcd_init()
136 {
137  
138 int i; // pocitadlo cyklu
139  
140 delay_ms(20); // spozdeni pro provedeni startu displeje po zapnuti napajeni
141  
142 #ifdef LCD_DATA_LSB
143 // data jsou na 4 bitech za sebou, nastav smer pro vsechny dalsi prenosy
144 *LCD_TRIS = *LCD_TRIS & ~LCD_MASK; // nuluj odpovidajici bity tris registru datoveho portu LCD
145 #endif
146  
147 output_bit(LCD_RS,0); // nastav jako vystup a nastav klidovy stav
148 output_bit(LCD_E, 0); // nastav jako vystup a nastav klidovy stav
149  
150 for (i=0; i<3; i++) // nastav lcd do rezimu 8 bitu sbernice
151 {
152 delay_ms(2); // muze byt rozdelany prenos dat (2x 4 bity) nebo pomaly povel
153 lcd_send_nibble(3); // rezim 8 bitu
154 }
155  
156 delay_us(40); // cas na zpracovani
157 lcd_send_nibble(2); // nastav rezim 4 bitu (plati od nasledujiciho prenosu)
158 delay_us(40); // cas na zpracovani
159  
160 for (i=0;i<3;i++) // proved inicializaci (nastaveni modu, smazani apod)
161 {
162 lcd_send_byte(0,LCD_INIT_STRING[i]);
163 delay_ms(2);
164 }
165 }
166  
167  
168 // Proved presun kurzoru
169 //
170 // Pozice 1.1 je domu
171 //
172 void lcd_gotoxy( BYTE x, BYTE y)
173 {
174  
175 BYTE Adr;
176  
177 Adr=x-1;
178 if(y==2)
179 Adr+=LCD_LINE_2;
180  
181 lcd_send_byte(0,0x80|Adr);
182 }
183  
184  
185 // Zapis znaku na displej, zpracovani ridicich znaku
186 //
187 void lcd_putc( char c)
188 {
189  
190 switch (c)
191 {
192 case '\f' : lcd_send_byte(0,1); // smaz displej
193 delay_ms(2);
194 break;
195 case '\n' : lcd_gotoxy(1,2); break; // presun se na 1. znak 2. radky
196 case '\r' : lcd_gotoxy(1,1); break; // presun home
197 case '\b' : lcd_send_byte(0,0x10); break; // posun kurzor o 1 zpet
198 default : if (c<0x20) c&=0x7; // preklopeni definovatelnych znaku na rozsah 0 az 0x1F
199 lcd_send_byte(1,c); break; // zapis znak
200 }
201 }
202  
203  
204 // Zapni kurzor
205 //
206 void lcd_cursor_on()
207 {
208 lcd_send_byte(0,LCD_CURSOR_ON_);
209 }
210  
211  
212 // Vypni kurzor
213 //
214 void lcd_cursor_off()
215 {
216 lcd_send_byte(0,LCD_CURSOR_OFF_);
217 }
218  
219  
220 // Definice vlastnich fontu
221 //
222 // Vlastnich definic muze byt jen 8 do pozic 0 az 7 pameti CGRAM radice lcd displeje
223 // Pro snadne definovani jsou pripraveny nasledujici definice a na konci souboru je uveden
224 // priklad pouziti definovanych znaku.
225  
226  
227 // Pomocna procedura pro posilani ridicich dat do radice displeje
228 //
229 void lcd_putc2(int Data)
230 {
231 lcd_send_byte(1,Data);
232 }
233  
234  
235 // Pomocne definice pro programovani obsahu CGRAM
236 //
237 #define lcd_define_start(Code) lcd_send_byte(0,0x40+(Code<<3)); delay_ms(2)
238 #define lcd_define_def(String) printf(lcd_putc2,String);
239 #define lcd_define_end() lcd_send_byte(0,3); delay_ms(2)
240  
241  
242 // Vlastni vykonne makro pro definovani fontu do pozice Index CGRAM s definicnim retezcem Def
243 //
244 #define lcd_define_char(Index, Def) lcd_define_start(Index); lcd_define_def(Def); lcd_define_end();
245  
246  
247 // Pripravene definice fontu vybranych znaku
248 // V tabulce nesmi byt 00 (konec retezce v printf()), misto toho davame 80
249 //
250 #define LCD_CHAR_BAT100 "\x0E\x1F\x1F\x1F\x1F\x1F\x1F\x1F" /* symbol plne baterie */
251 #define LCD_CHAR_BAT50 "\x0E\x1F\x11\x11\x13\x17\x1F\x1F" /* symbol polovicni baterie */
252 #define LCD_CHAR_BAT0 "\x0E\x1F\x11\x11\x11\x11\x11\x1F" /* symbol vybite baterie */
253 #define LCD_CHAR_UP "\x80\x04\x0E\x15\x04\x04\x04\x80" /* symbol sipka nahoru */
254 #define LCD_CHAR_DOWN "\x80\x04\x04\x04\x15\x0E\x04\x80" /* symbol Sipka dolu */
255 #define LCD_CHAR_LUA "\x04\x0E\x11\x11\x1F\x11\x11\x80" /* A s carkou */
256 #define LCD_CHAR_LLA "\x01\x02\x0E\x01\x1F\x11\x0F\x80" /* a s carkou */
257 #define LCD_CHAR_HUC "\x0A\x0E\x11\x10\x10\x11\x0E\x80" /* C s hackem */
258 #define LCD_CHAR_HLC "\x0A\x04\x0E\x10\x10\x11\x0E\x80" /* c s hackem */
259 #define LCD_CHAR_HUD "\x0A\x1C\x12\x11\x11\x12\x1C\x80" /* D s hackem */
260 #define LCD_CHAR_HLD "\x05\x03\x0D\x13\x11\x11\x0F\x80" /* d s hackem */
261 #define LCD_CHAR_LUE "\x04\x1F\x10\x10\x1E\x10\x1F\x80" /* E s carkou */
262 #define LCD_CHAR_LLE "\x01\x02\x0E\x11\x1F\x10\x0E\x80" /* e s carkou */
263 #define LCD_CHAR_HUE "\x0A\x1F\x10\x1E\x10\x10\x1F\x80" /* E s hackem */
264 #define LCD_CHAR_HLE "\x0A\x04\x0E\x11\x1F\x10\x0E\x80" /* e s hackem */
265 #define LCD_CHAR_LUI "\x04\x0E\x04\x04\x04\x04\x0E\x80" /* I s carkou */
266 #define LCD_CHAR_LLI "\x02\x04\x80\x0C\x04\x04\x0E\x80" /* i s carkou */
267 #define LCD_CHAR_HUN "\x0A\x15\x11\x19\x15\x13\x11\x80" /* N s hackem */
268 #define LCD_CHAR_HLN "\x0A\x04\x16\x19\x11\x11\x11\x80" /* n s hackem */
269 #define LCD_CHAR_LUO "\x04\x0E\x11\x11\x11\x11\x0E\x80" /* O s carkou */
270 #define LCD_CHAR_LLO "\x02\x04\x0E\x11\x11\x11\x0E\x80" /* o s carkou */
271 #define LCD_CHAR_HUR "\x0A\x1E\x11\x1E\x14\x12\x11\x80" /* R s hackem */
272 #define LCD_CHAR_HLR "\x0A\x04\x16\x19\x10\x10\x10\x80" /* r s hackem */
273 #define LCD_CHAR_HUS "\x0A\x0F\x10\x0E\x01\x01\x1E\x80" /* S s hackem */
274 #define LCD_CHAR_HLS "\x0A\x04\x0E\x10\x0E\x01\x1E\x80" /* s s hackem */
275 #define LCD_CHAR_HUT "\x0A\x1F\x04\x04\x04\x04\x04\x80" /* T s hackem */
276 #define LCD_CHAR_HLT "\x0A\x0C\x1C\x08\x08\x09\x06\x80" /* t s hackem */
277 #define LCD_CHAR_LUU "\x02\x15\x11\x11\x11\x11\x0E\x80" /* U s carkou */
278 #define LCD_CHAR_LLU "\x02\x04\x11\x11\x11\x13\x0D\x80" /* u s carkou */
279 #define LCD_CHAR_CUU "\x06\x17\x11\x11\x11\x11\x0E\x80" /* U s krouzkem */
280 #define LCD_CHAR_CLU "\x06\x06\x11\x11\x11\x11\x0E\x80" /* u s krouzkem */
281 #define LCD_CHAR_LUY "\x02\x15\x11\x0A\x04\x04\x04\x80" /* Y s carkou */
282 #define LCD_CHAR_LLY "\x02\x04\x11\x11\x0F\x01\x0E\x80" /* y s carkou */
283 #define LCD_CHAR_HUZ "\x0A\x1F\x01\x02\x04\x08\x1F\x80" /* Z s hackem */
284 #define LCD_CHAR_HLZ "\x0A\x04\x1F\x02\x04\x08\x1F\x80" /* z s hackem */
285  
286  
287 // Priklad pouziti definovanych znaku
288 //
289 //
290 //void lcd_sample()
291 //{
292 // lcd_define_char(0,LCD_CHAR_BAT50); // Priklad definice znaku baterie do pozice 0
293 // lcd_define_char(2,LCD_CHAR_HLE LCD_CHAR_LUI); // Priklad definice znaku e s hackem a I s carkou od pozice 2
294 // // vsimnete si, ze neni carka mezi retezci s definici (oba retezce definuji
295 // // jediny definicni retezec)
296 // printf(lcd_putc,"\fZnaky:\20\22\23"); // priklad vypisu znaku z pozice 0, 2 a 3
297 // delay_ms(1000);
298 // lcd_define_char(0,LCD_CHAR_BAT0); // Predefinovani tvaru znaku v pozici 0
299 // delay_ms(1000);
300 //}