lcdParallel_init.c File Reference

Display driver for character LCD screens based on Hitachi HD44780 (or compatible) chipsets, which are found in most text-based LCDs. The library works with either 4 or 8 data lines in addition to the rs, and enable lines. More...

#include "lcdParallel.h"
#include "simpletools.h"

Functions
lcdParallel *	lcdParallel_init (char cols, char lines, char dotsize, char rs, char enable, char d0, char d1, char d2, char d3)
	initialize a parallel character LCD display into 4-wire mode. More...
lcdParallel *	lcdParallel_init8 (char cols, char lines, char dotsize, char rs, char enable, char d0, char d1, char d2, char d3, char d4, char d5, char d6, char d7)
	initialize a parallel character LCD display into 8-wire mode. More...

Detailed Description

Display driver for character LCD screens based on Hitachi HD44780 (or compatible) chipsets, which are found in most text-based LCDs. The library works with either 4 or 8 data lines in addition to the rs, and enable lines.

Author

Matthew Matz, Jeff Martin

Version

0.5

Copyright

Copyright (C) Parallax, Inc. 2018. All Rights MIT Licensed.

Function Documentation

lcdParallel_init()

lcdParallel* lcdParallel_init	(	char	cols,
		char	lines,
		char	dotsize,
		char	rs,
		char	enable,
		char	d0,
		char	d1,
		char	d2,
		char	d3
	)

initialize a parallel character LCD display into 4-wire mode.

Parameters

cols	Number of columns on the character display.
lines	Number of lines on the character display.
dotsize	Number of pixels tall the characters are on the display. Most displays are 8, a few displays have 10 pixel tall characters.
rs	Register Select pin connect to the display's RS pin.
enable	Enable pin connect to the display's Enable pin.
d0	Data pin 0 usually connected to the display's fifth data pin (for 4-wire mode).
d1	Data pin 1 usually connected to the display's sixth data pin (for 4-wire mode).
d2	Data pin 2 usually connected to the display's seventh data pin (for 4-wire mode).
d3	Data pin 3 usually connected to the display's eigth data pin (for 4-wire mode).

Returns

lcdParallel device identifier for use with functions in the lcdParallel library.

lcdParallel_init8()

lcdParallel* lcdParallel_init8	(	char	cols,
		char	lines,
		char	dotsize,
		char	rs,
		char	enable,
		char	d0,
		char	d1,
		char	d2,
		char	d3,
		char	d4,
		char	d5,
		char	d6,
		char	d7
	)

initialize a parallel character LCD display into 8-wire mode.

Parameters

cols	Number of columns on the character display.
lines	Number of lines on the character display.
dotsize	Number of pixels tall the characters are on the display. Most displays are 8, a few displays have 10 pixel tall characters.
rs	Register Select pin connect to the display's RS pin.
enable	Enable pin connect to the display's Enable pin.
d0	Data pin 0 usually connected to the display's first data pin (for 8-wire mode).
d1	Data pin 1 usually connected to the display's second data pin (for 8-wire mode).
d2	Data pin 2 usually connected to the display's third data pin (for 8-wire mode).
d3	Data pin 3 usually connected to the display's fourth data pin (for 8-wire mode).
d4	Data pin 4 usually connected to the display's fifth data pin (for 8-wire mode).
d5	Data pin 5 usually connected to the display's sixth data pin (for 8-wire mode).
d6	Data pin 6 usually connected to the display's seventh data pin (for 8-wire mode).
d7	Data pin 7 usually connected to the display's eigth data pin (for 8-wire mode).

Returns

lcdParallel device identifier for use with functions in the lcdParallel library.