hd44780 kernel module for OpenWRT using GPIOs
This module controls LCD dot-matrix displays based on the popular Hitachi
HD44780 chipset. Data and commands are passed to the display through a misc device located at /dev/hd44780. To write text to the LCD, just write your text into the device file like this (ash):
echo -n 'hello world' > /dev/hd44780
To send commands to the unit, the first byte in the string sent to the device file must be 0xff. 0xff was chosen because it corresponds to the ASCII code for "data link escape" and isn't commonly used. 0x00 through 0x01 are used by the hd44780 to display custom characters. The 0xff character can easily be sent using escape characters (ash again):
printf '\xff\x01' > /dev/hd44780
In this example, command mode is enabled with \xff and the screen is cleared with \x01. Similar results can be achieved using escape characters when writing to the device file from most programming languages. Several commands can be chained together. This command:
printf '\xff\x01\xc6\x0f' > /dev/hd44780
will clear the display (0x01), move the cursor to the 6th position of the second row (0xc6) and make the cursor blink (0x0f).
Each discrete string written to the file is evaluated for the presence of the command character. So this sequence
printf '\xff\x01' > /dev/hd44780
printf 'hello world' > /dev/hd44780
would clear the screen and then write hello world to it. The second statement is sent to the device file as a separate string and evaluated independently. Here's a similar routine in NodeJS:
var fs = require('fs');
var data_file = '/dev/hd44780';
fs.writeFileSync(data_file, "\ff\1");
fs.writeFile(data_file, 'hello world\n' + Math.random()));
Newline characters are automatically converted to the LCD's next line command, so the output here would be:
hello world
0.13524234984187
And here's a similar thing, in Lua this time:
local lcd, err = io.open('/dev/hd44780', 'w')
if not lcd then return print(err) end
lcd:write(string.chars(0xff, 0x01, 0x0f))
lcd:flush()
lcd:write('hello world')
lcd:close()
The command characters must be encoded with string.chars(...). string.format(...) won't work because it terminates strings on a zero character, while string.chars(...) happily encodes it and continues. Note that in Lua you must call flush() to end the command input and start another set of input (data this time).
(TODO)
Copy the hd44780 folder into the package folder in your OpenWRT build root. From the build root, run
./scripts/feeds update -i
This updates the package index, making the module you just added visible in menuconfig. Next run
make menuconfig
and select the option for kmod-hd44780 (Kernel Modules -> Other modules). Now the module will be built along with OpenWRT. To build just the module itself, run
make package/hd44780/compile
- v 1.1 Added ability to send command characters to device file
- v 1.0 Original code by bufferos