Bus Pirate: HD44780 character LCD adapter

cover.ii

Cheap character LCDs based on the HD44780 chipset come in a variety of sizes: 2×16, 4×20, etc. These displays have two standard interface modes, 4bit and 8bit parallel. 8bit requires a total of 11 data lines, 4bit requires 7 (6 for write-only). Some LCDs support an additional serial data mode, like the VFD Ian covered at Hack a Day.

adapter-mini.225HD44780 LCDs are generally 5volt parts with a separate supply for the back light. The Bus Pirate only has five 5volt tolerant I/O pins, so we made a small adapter board with enough pins to control the LCD. The Bus Pirate controls the adapter board through its LCD interface library.

Continue reading about the Bus Pirate HD44780 character LCD adapter board and interface library after the break. We can have PCBs, kits, or assembled kits produced by Seeed Studio for about $15, including worldwide shipping, more here.

Overview

overview.ii

In this article we outline an I2C adapter board for HD44780-based LCDs. We demonstrate it with a Bus Pirate universal serial interface. The Bus Pirate source code for the I2C-based HD44780 interface library is public domain, so it’s free to adapt to your own projects.

Hardware

cct-450

Full size circuit image [PNG]. The circuit and PCB were designed with the free version of Cadsoft Eagle. The design files can be downloaded from the Bus Pirate SVN. Before using the adapter board, be sure to verify the datasheet for your LCD against the adapter pinout. Not all LCDs are the same.

PCF8574-adapter

PCF8574 I/O expander IC

This is a simple 8 I/O expander chip that’s controlled through the two-wire I2C interface. The I2C interface is accessible from header JP1.

The PCF8574 works from 2.5 to 5volts. The I/O pins operate at the supply voltage, so if we feed it 5volts it interfaces the LCD at 5volts.  C1 (0.1uF) decouples the IC from fluctuations in the power supply.

One pin of the PCF8574 controls a 3mm LED (LED1) through current limiting resistor R2 (1000 ohms). The LED lights to indicate successful communication between the Bus Pirate and the adapter. The PCF8574 can’t source enough current to power the LED, so we power the LED from the 5volt supply and switch the ground.

LCD

The adapter board communicates with an HD44780-based character LCD in 4bit parallel interface mode. The 4bit interface pins – RS, RW, EN, and D4-D7 – are connected to seven of the PCF8574 I/O pins. We like to use 0.1″ male pin header to connect the adapter to an LCD, you can usually lean the LCD against the pins to create sufficient contact for a quick test.

Trimmer resistor R1 (10K) provides a contrast adjustment voltage to pin 3 of the LCD header.

We didn’t connect the backlight pins because there’s so many different backlight styles. Providing power for an LED backlight might damage a screen that requires a negative voltage supply.

Power supply

Most LCDs require 5volts, provide an external power supply through header JP2. We provided a second power supply pin to connect the Bus Pirate’s pull-up resistors.

PCB

brd

The circuit and PCB were designed with the free version of Cadsoft Eagle. The design files can be downloaded from the Bus Pirate SVN. The PCB is a single-sided, all through-hole design with a single jumper wire (shown in red).

We can have PCBs, kits, or assembled kits produced by Seeed Studio for about $15, including worldwide shipping, more here.

Partlist

Part Value (all through-hole) Quantity
C1 0.1uF/10volts+ 1
R1 10000 (10K) ohm single turn trimmer/potentiometer, 6mm 1
R2 1000 (1K) ohm resistor, 1/4 watt 1
LED1 3mm (T1) LED, red 1
JP1+JP2 0.1″ male header, 5 pins 1
IC1 PCF8574N, 8bit I2C I/O expander DIP16 1
ICS1 16 pin DIP socket for IC1 1

render

Demonstration

Device: HD44780 character LCD.
Bus: 4bit parallel, with PCF8574 I2C adapter board.
Power requirements: 5volts.
References: example datasheet [PDF], HD44780 command reference, HD44780 LCD uber-site.
Complete Bus Pirate session log for this demonstration.

Connections

Bus Pirate LCD adapter PCF8574 (pin #)
MOSI SDA SDA (15)
CLK SCL SCL (14)
5volts +5V VCC (16)
GND GND GND (1,2,3,8)
Vpullup +5V

We designed the adapter for the LCD library of the Bus Pirate universal serial interface, but it’ll work with anything that can speak the I2C protocol. Take a look at the Bus Pirate source code for an example I2C->HD44780 implementation.

Connect the Bus Pirate to the adapter board as shown in the table. The table also shows the raw connections to the PCF8574 IC if you’re following along without an adapter board.

Connect the adapter to a power supply sufficient for the LCD, generally 5volts. The I2C connection between the adapter and the Bus Pirate requires pull-up resistors between 2 and 10K. Here’s more information about mixed voltage interfacing with pull-ups, and the Bus Pirate on-board pull-up resistors.

Interfacing

We’ve covered the adapter design and how to connect it to the Bus Pirate, now it’s finally time to write something to the LCD.

Step 1. Setup library

HiZ>m<<<set mode menu
1. HiZ

11. LCD
12. HWI2C
(1) >11<<<LCD interface mode
MODE SET
LCD type:
1. HD44780 (using PCF8574 IO expander)
(1) >1<<<currently only supports HD44780 LCDs
HD44780 LCD TESTER
REQUIRES PCF8574 I2C IO EXPANDER
LCD>W<<<big ‘W’ turns on the power supplies
POWER SUPPLIES ON
LCD>p<<<configure the pull-up resistors
1. Pullup off
2. Pullup on
(1) >2<<<turn the pull-ups on
PULLUP RESISTORS ON
LCD>v<<<get voltage report
VOLTAGE MONITOR: 5V: 4.9 | 3.3V: 3.3 | VPULLUP: 5.0<<<check Vpu
LCD>

Press ‘m’ in the Bus Pirate terminal and choose the LCD library. It currently it only supports HD44780 character LCDs using the PFC8574 adapter described in the first half of this article (option 1).

Enable the power supplies (big ‘W’) and pull-up resistors (menu ‘p’).  Check the voltage monitor (menu ‘v’) and make sure that the pull-up voltage (Vpullup) reads around 5volts.

Step 2. Reset & initialization

HD44780 command table

This table outlines the single-byte commands that control an HD44780 LCD, here’s a detailed reference. These commands can be entered from the Bus Pirate command line, but we’ve made macros for most of them to save time.

LCD>(0)<<<show macro menu
0.Macro menu<<<this menu
1.LCD Reset<<<reset the LCD
2.Init LCD<<<reset and initialize the LCD
3.Clear LCD<<<clear LCD, return cursor to 0
4.Cursor position ex:(4:0)<<<set cursor postion
5.Write test text <<<will be removed by firmware v2.1
6.Write :number test numbers ex:(6:80)
7.Write :number test characters ex:(7:80)
8.Insert text at cursor
LCD>

Macro 0 displays the macro menu for any Bus Pirate mode.

reset-macro

LCD>(2) <<<initialize LCD macro
Display lines:
1. 1<<<single line display
2. Multiple<<<multiple line display
(2) >2
RESET<<<macro 2 includes a reset sequence
INIT<<<initialize the LCD
LCD>

The initialize LCD macro (2) configures the screen for 4bit interface mode, enables cursor display, and sets a few other helpful options. Configure the number of display lines, choose 1 for a single line display, or 2 for all other displays.

After initialization, the screen should be clear with a cursor visible in the corner. If it didn’t work, check the I2C connection, pull-up resistors, and power supply, then try again.

HD44780 LCDs need to be reset with a special signal sequence before they can be initialized for 4bit or 8bit interface mode. Macro 1 creates this sequence. Macro 2 includes the reset sequence, so there’s no need to use macro 1 before macro 2.

Step 3. Write test characters

num-test

LCD>(6:80)<<<write 80 numbers
LCD>

The write numbers macro fills the LCD with test numbers between 0 and 9. The number after the colon tells the Bus Pirate how many test numbers to write, we’re using a 4x20LCD, so we write 80 numbers to fill it. Notice that the cursor ends at position 0, under the first ‘0’.

chara-test

LCD>(7:80)<<<write 80 characters
LCD>

The write characters macro fills the LCD with ASCII characters, enter the quantity after the colon. Notice that the fist line continues on the third, the third on the second, and the second on the last. The characters aren’t continuous because character LCDs don’t wrap from one line to the next. We’ll talk a little more about this in step 5.

Step 4. Clear LCD

reset-macro

LCD>(3)<<<clear the LCD
CLEARED
LCD>

The clear LCD macro sends the HD44780 command that erases the screen and returns the cursor to the first position.

You could also do any of these operations without the macros, refer to the command table at the beginning of this section. Enter ‘[0b1′ in the Bus Pirate to set the interface to command mode ([) and send the HD44780 clear screen command (0b00000001) without a macro.

Step 5. Type text

LCD1-text

LCD>(8)<<<insert user text
Enter text to insert at the cursor position.
HD44780 LCD demo<<<we typed this
LCD>

After clearing the LCD in step 4, the cursor is positioned at the first block. We could also set it with the macro (4:0), which moves the cursor to the first character.

The insert text at cursor macro asks  for text input, and then copies it to the LCD when you press enter.

LCD>(4:0x40)<<<position the cursor at 0x40
LCD>(8)<<<insert text
Enter text to insert at the cursor position.
Bus Pirate v2go<<<we typed this
LCD>

Writing to the second line is a little more complicated, it actually starts at character 64 on a 4×20 LCD. If you continue writing from the end of line 1 (character 20) then you’ll end up at the beginning of line three! This page has a nice collection of memory maps for most character LCD sizes.

First, we position the cursor on the second line (4:0x40). Next, the ‘insert text’ macro grabs our input and copies it to the LCD.

LCDall-text

LCD>(4:0x14)(8)(4:0x54)(8)<<<multiple macro syntax
Enter text to insert at the cursor position.
Firmware v2.0+<<<we typed this
Enter text to insert at the cursor position.
DangerousPrototypes<<<we typed this
LCD>

The Bus Pirate accepts multiple macros on the same line, so the entire screen can be written at once. We wrote to the last two lines with a single line of syntax.

We could use ‘(3)(4:0)(8)(4:0x40)(8)(4:0x14)(8)(4:0x54)(8)’ to clear the LCD and write all four lines with a single syntax entry.

Step 6. Reading from the LCD

The Bus Pirate and LCD adapter board can read from the LCD. We’ll read the text we wrote to the screen (DDRAM), but you can also read settings and custom character ram (CGRAM) by setting the correct address.

LCD>[0b10000000 <<<set the read pointer
HD44780 RS LOW, COMMAND MODE <<<register select pin low
CMD WRITE: 0x80 <<<wrote to LCD as command
LCD>

First, we tell the Bus Pirate to send data to the LCD command register ([). Next, we use the set DDRAM address command (0b1xxxxxxx) to set the read pointer to the beginning of the DDRAM (xxxxxxx=0000000).

LCD>]rrrrrrr <<<read data memory
HD44780 RS HIGH, DATA MODE<<<register select pin high
READ: 0x48<<< ‘H’
READ: 0x44<<< ‘D’
READ: 0x34<<< ‘4’
READ: 0x34<<< ‘4’
READ: 0x37<<< ‘7’
READ: 0x38<<< ‘8’
READ: 0x30<<< ‘0’
LCD>

Finally, tell the Bus Pirate to read from data memory (]), and then read a few bytes (rrrrrrr). We got “HD44780″, the text we wrote to the screen in step 5.

You should also be able to use the shortcut r:7 to read seven bytes, but it’s not working in the current firmware – we’ll fix this prior to the next release.

Doing more

The HD44780 character LCD adapter is a handy accessory for the Bus Pirate. It can be used for a quick test, or more advanced logic development.

In addition to LCDs, the eight 2.5volt-5volt I/O pins might be useful for other high pin-count Bus Pirate applications.

We can have PCBs, kits, or assembled kits produced by Seeed Studio for about $15, including worldwide shipping, more here.

This entry was posted in Bus Pirate, Bus Pirate accessories, Prototypes and tagged , , , .

Comments

  1. MQA_alex says:

    can any one please tell me the commands to display on 2nd, 3rd and, 4th lines of a 16×4 lcd module. i searched it on internet a lot but cant find it :-( . please help me.

  2. Ian says:

    Do you mean with the Bus Pirate, or just in general? This article and the sites linked (eg http://homepage.hispeed.ch/peterfleury/avr-lcd44780.html ) describe how to do it.

  3. MQA_alex says:

    No i mean i want to know about Commands.

    as we use the command 0c0H in a 16×2 LCD to force the cursor to the beginning of 2nd line. like wise what will be the commands for 16×4 LCD or 20×4 lcd modules to force the cursor to their 2nd, 3rd and 4th lines.

  4. MQA_alex says:

    Thank you very much Ian :-) your links really helped me alot and i got the required info about my confusion. again i am very thankful to u. :-)

  5. ALS says:

    Hi, Im wondering of doing the oposite.. How could It be done? Is there any interface I could get hold off? Would gladly pay someone to get this done for me a reasonable Price.

    I have a circuit board that creates output to a hd44780 4bit parallel LCD and would like to take Those
    Outputs that go to LCD and redirect them with cables to a small i2c oled screen.

    As said, if someone knows how this could be done through an interface or through arduino nano, would gladly pay for code squematics circuit or anything worth to do such task:)

  6. Edgardo says:

    Hello,can I use this with any board?I have a board that its lcd is I2C and its lcd is broken.Can I replace it with this tiny board? Thanks in advance!

Leave a Comment

Your email address will not be published. Required fields are marked *

You may use these HTML tags and attributes: <a href="" title=""> <abbr title=""> <acronym title=""> <b> <blockquote cite=""> <cite> <code> <del datetime=""> <em> <i> <q cite=""> <strike> <strong>

Notify me of followup comments via e-mail. You can also subscribe without commenting.