← Back to branch summary

~ubuntu-branches/ubuntu/raring/avr-libc/raring-proposed

« back to all changes in this revision

Viewing changes to doc/examples/stdiodemo/hd44780.c

  • Committer: Bazaar Package Importer
  • Author(s): Hakan Ardo
  • Date: 2009-10-31 11:52:10 UTC
  • mfrom: (1.1.8 upstream) (4.1.2 squeeze)
  • Revision ID: james.westby@ubuntu.com-20091031115210-x0mlijnegkce86fk
Tags: 1:1.6.7-1
http://bugs.debian.org/544030
http://bugs.debian.org/553265
* New upstream relese (closes: #544030)
* Added lintian overrides (closes: #553265)

Show diffs side-by-side

added added

removed removed

Lines of Context:
doc/examples/stdiodemo/hd44780.c
11
11
 * The LCD controller is used in 4-bit mode with a full bi-directional
12
12
 * interface (i.e. R/~W is connected) so the busy flag can be read.
13
13
 *
14
 
 * $Id: hd44780.c,v 1.3 2006/10/08 21:47:36 joerg_wunsch Exp $
 
14
 * $Id: hd44780.c,v 1.3.2.1 2009/06/25 20:21:16 joerg_wunsch Exp $
15
15
 */
16
16
 
17
17
#include "defines.h"
25
25
#include "hd44780.h"
26
26
 
27
27
#define GLUE(a, b)     a##b
28
 
#define PORT(x)        GLUE(PORT, x)
29
 
#define PIN(x)         GLUE(PIN, x)
30
 
#define DDR(x)         GLUE(DDR, x)
31
 
 
32
 
#define HD44780_PORTOUT    PORT(HD44780_PORT)
33
 
#define HD44780_PORTIN     PIN(HD44780_PORT)
34
 
#define HD44780_DDR        DDR(HD44780_PORT)
35
 
 
36
 
#define HD44780_DATABITS \
37
 
(_BV(HD44780_D4)|_BV(HD44780_D5)|_BV(HD44780_D6)|_BV(HD44780_D7))
 
28
 
 
29
/* single-bit macros, used for control bits */
 
30
#define SET_(what, p, m) GLUE(what, p) |= (1 << (m))
 
31
#define CLR_(what, p, m) GLUE(what, p) &= ~(1 << (m))
 
32
#define GET_(/* PIN, */ p, m) GLUE(PIN, p) & (1 << (m))
 
33
#define SET(what, x) SET_(what, x)
 
34
#define CLR(what, x) CLR_(what, x)
 
35
#define GET(/* PIN, */ x) GET_(x)
 
36
 
 
37
/* nibble macros, used for data path */
 
38
#define ASSIGN_(what, p, m, v) GLUE(what, p) = (GLUE(what, p) & \
 
39
                                                ~((1 << (m)) | (1 << ((m) + 1)) | \
 
40
                                                  (1 << ((m) + 2)) | (1 << ((m) + 3)))) | \
 
41
                                                ((v) << (m))
 
42
#define READ_(what, p, m) (GLUE(what, p) & ((1 << (m)) | (1 << ((m) + 1)) | \
 
43
                                            (1 << ((m) + 2)) | (1 << ((m) + 3)))) >> (m)
 
44
#define ASSIGN(what, x, v) ASSIGN_(what, x, v)
 
45
#define READ(what, x) READ_(what, x)
38
46
 
39
47
#define HD44780_BUSYFLAG 0x80
40
48
 
51
59
{
52
60
  uint8_t x;
53
61
 
54
 
  HD44780_PORTOUT |= _BV(HD44780_E);
 
62
  SET(PORT, HD44780_E);
55
63
  /*
56
64
   * Guarantee at least 500 ns of pulse width.  For high CPU
57
65
   * frequencies, a delay loop is used.  For lower frequencies, NOPs
78
86
#  endif /* F_CPU > 1000000UL */
79
87
#endif
80
88
  if (readback)
81
 
    x = HD44780_PORTIN & HD44780_DATABITS;
 
89
    x = READ(PIN, HD44780_D4);
82
90
  else
83
91
    x = 0;
84
 
  HD44780_PORTOUT &= ~_BV(HD44780_E);
 
92
  CLR(PORT, HD44780_E);
85
93
 
86
94
  return x;
87
95
}
92
100
static void
93
101
hd44780_outnibble(uint8_t n, uint8_t rs)
94
102
{
95
 
  uint8_t x;
96
 
 
97
 
  HD44780_PORTOUT &= ~_BV(HD44780_RW);
 
103
  CLR(PORT, HD44780_RW);
98
104
  if (rs)
99
 
    HD44780_PORTOUT |= _BV(HD44780_RS);
 
105
    SET(PORT, HD44780_RS);
100
106
  else
101
 
    HD44780_PORTOUT &= ~_BV(HD44780_RS);
102
 
  x = (HD44780_PORTOUT & ~HD44780_DATABITS) | ((n << HD44780_D4) & HD44780_DATABITS);
103
 
  HD44780_PORTOUT = x;
 
107
    CLR(PORT, HD44780_RS);
 
108
  ASSIGN(PORT, HD44780_D4, n);
104
109
  (void)hd44780_pulse_e(false);
105
110
}
106
111
 
123
128
{
124
129
  uint8_t x;
125
130
 
126
 
  HD44780_PORTOUT |= _BV(HD44780_RW);
127
 
  HD44780_DDR &= ~HD44780_DATABITS;
 
131
  SET(PORT, HD44780_RW);
 
132
  ASSIGN(DDR, HD44780_D4, 0x00);
128
133
  if (rs)
129
 
    HD44780_PORTOUT |= _BV(HD44780_RS);
 
134
    SET(PORT, HD44780_RS);
130
135
  else
131
 
    HD44780_PORTOUT &= ~_BV(HD44780_RS);
 
136
    CLR(PORT, HD44780_RS);
132
137
  x = hd44780_pulse_e(true);
133
 
  HD44780_DDR |= HD44780_DATABITS;
134
 
  HD44780_PORTOUT &= ~_BV(HD44780_RW);
 
138
  ASSIGN(DDR, HD44780_D4, 0x0F);
 
139
  CLR(PORT, HD44780_RW);
135
140
 
136
 
  return (x & HD44780_DATABITS) >> HD44780_D4;
 
141
  return x;
137
142
}
138
143
 
139
144
/*
154
159
 * Wait until the busy flag is cleared.
155
160
 */
156
161
void
157
 
hd44780_wait_ready(void)
 
162
hd44780_wait_ready(bool longwait)
158
163
{
 
164
#if USE_BUSY_BIT
159
165
  while (hd44780_incmd() & HD44780_BUSYFLAG) ;
 
166
#else
 
167
  if (longwait)
 
168
    _delay_ms(1.52);
 
169
  else
 
170
    _delay_us(37);
 
171
#endif
160
172
}
161
173
 
162
174
/*
170
182
void
171
183
hd44780_init(void)
172
184
{
173
 
 
174
 
  HD44780_DDR = _BV(HD44780_RS) | _BV(HD44780_RW) | _BV(HD44780_E)
175
 
    | HD44780_DATABITS;
 
185
  SET(DDR, HD44780_RS);
 
186
  SET(DDR, HD44780_RW);
 
187
  SET(DDR, HD44780_E);
 
188
  ASSIGN(DDR, HD44780_D4, 0x0F);
176
189
 
177
190
  _delay_ms(15);                /* 40 ms needed for Vcc = 2.7 V */
178
191
  hd44780_outnibble(HD44780_FNSET(1, 0, 0) >> 4, 0);
180
193
  hd44780_outnibble(HD44780_FNSET(1, 0, 0) >> 4, 0);
181
194
  _delay_ms(0.1);
182
195
  hd44780_outnibble(HD44780_FNSET(1, 0, 0) >> 4, 0);
 
196
  _delay_us(37);
183
197
 
184
198
  hd44780_outnibble(HD44780_FNSET(0, 1, 0) >> 4, 0);
185
 
  hd44780_wait_ready();
 
199
  hd44780_wait_ready(false);
186
200
  hd44780_outcmd(HD44780_FNSET(0, 1, 0));
187
 
  hd44780_wait_ready();
 
201
  hd44780_wait_ready(false);
188
202
  hd44780_outcmd(HD44780_DISPCTL(0, 0, 0));
189
 
  hd44780_wait_ready();
 
203
  hd44780_wait_ready(false);
190
204
}
191
205
 
 
206
/*
 
207
 * Prepare the LCD controller pins for powerdown.
 
208
 */
 
209
void
 
210
hd44780_powerdown(void)
 
211
{
 
212
  ASSIGN(PORT, HD44780_D4, 0);
 
213
  CLR(PORT, HD44780_RS);
 
214
  CLR(PORT, HD44780_RW);
 
215
  CLR(PORT, HD44780_E);
 
216
}