Using LPC4357 LCD Controller in Linux Print

 

This application note explains how to use the LPC4357 LCD controller in Linux.

All software tests documented below were performed on the Embedded Artists LPC4357 Dev Kit with the connected Embedded Artists 4.3 inch LCD board.

The Linux framebuffer driver for the LPC4357 LCD controller is linux/drivers/video/amba-clcd.c. To enable the LCD support in the kernel, you must enable the CONFIG_FB_ARMCLCD build time option in the kernel configuration. To do so, start the kernel configuration GUI (make kmenuconfig from the project directory) and proceed to enable the following items: Device Drivers -> Graphics support -> Support for framebuffer devices -> ARM PrimeCell PL110 support:

The platform code responsible for registering a platform device for the LPC4357 LCD controller with the framebuffer driver resides in linux/arch/arm/mach-lpc18xx/fb.c. If you would like to port the framebuffer to a custom LCD, you will need to update that file to provide the framebuffer driver with configuration parameters appropriate for your LCD.

There must be a device node in the target root file system for the framebuffer to allow accessing it using standard Linux interfaces. Add the following line into your <project>.initramfs file to create a device node for the LCD interface:

...
nod /dev/fb0 0600 0 0 c 29 0
...

When you boot the newly installed Linux image on the target, there will be the following message in the kernel bootstrap print-out indicating that the framebuffer driver is available and has registered a platform device for the on-chip LCD controller:

...
CLCD: LPC18xx/43xx LCDC hardware, HSD043I9W1-A00-0299 display
...

The next question is what you can do with the framebuffer from Linux userspace code in order to display something on an attached LCD. At a lowest level, the framebuffer exposes a device file /dev/fbN for the LCD interface it is responsible for. Typically, as is the case for the LPC4357, the framebuffer services a single LCD interface so N is 0 and the device file is /dev/fb0. Through that file, userspace applications can perform reads/writes to directly access the LCD framebuffer - i.e. the pixel values being displayed on the screen. Additional APIs are available via ioctl calls on that file, that provide functionality to determine parameters of the LCD (width, height, pixel-depth, etc) as well as to perform some other operations.

As an example, this is a demo project (lcdtest.tgz) that illustrates how to display a static test image on the LCD.

Note: This demo project was validated in context of Release 1.14.0. If you are using a different release, some porting changes may be needed.

When you unpack the tarball (lcdtest.tgz) in the projects/ directory, the userspace application that accesses the LCD is projects/lcdtest/app/lcdtest.c. You will see from the sources that the application uses standard POSIX APIs to open /dev/fd0, then calls appropriate ioctl commands to determine the LCD geometry, then maps the LCD memory buffer into the application address space using mmap and then renders the test image onto the LCD by writing directly into the LCD framebuffer. As mentioned, the application makes use of standard Linux APIs so the same code should work on any Linux system.

To build the project, simply go to projects/lcdtest and run make. The resultant bootable image will be lcdtest.uImage. When you have booted lcdtest.uImage to the target, call the application as follows in order to render the test image on the LCD:

~ # ./lcdtest -c
480x272, 32bpp
The framebuffer can be accessed at the address 0xc0f00000
Press Ctrl-C to exit
^C ~ #

Here is what the image will look like on the LCD:

Of course, in real-life designs developing low-level code that renders graphics directly through the framebuffer is not practical. Typically, developers use ready GUI frameworks, such as for instance the Qt GUI application software, to implement a feature-rich GUI.