TFT LCD Breakout 1.8in 128x160 Hookup Guide

Pages
Contributors: Ell C, Liquid Soulder
Favorited Favorite 6

Software Setup

Note: This example assumes you are using the latest version of the Arduino IDE on your desktop. If this is your first time using Arduino, please review our tutorial on installing the Arduino IDE. If you have not previously installed an Arduino library, please check out our installation guide.

Since the driver IC conveniently supports the SPI protocol you could start using it with just the stock Arduino libraries - but nobody wants to recreate the proverbial 'wheel' of computer graphics so we will get tricked out with the SparkFun HyperDisplay library and a driver made especially for this breakout.

Everything You Should Know About HyperDisplay

February 20, 2019

This is a tutorial to go in-depth about the SparkFun HyperDisplay Arduino Library.

HyperDisplay is an abstracted library for pretty much any 2D graphics display and has a focus on extensibility. Since the interface is standardized you can write display applications just once and make them work on many different displays with a few small changes. If you want to go more in depth check out this HyperDisplay tutorial. To get your TFT breakout working as soon as possible just keep reading along!

To use the breakout with HyperDisplay you will need to have all three of the following libraries installed in your Arduino IDE. You can head on over to the individual GitHub pages to download or simply click the appropriate link for each of the libraries listed below:

Library Name Arduino Library Manager Search Term GitHub Link Download Link
HyperDisplay SparkFun HyperDisplay HyperDisplay GitHub HyperDisplay Download
HyperDisplay ILI9163C SparkFun HyperDisplay ILI9163C ILI9163C GitHub ILI9163C Download
HyperDisplay KWH018ST01 4WSPI SparkFun HyperDisplay KWH018ST01 4WSPI KWH018ST01 4WSPI GitHub KWH018ST01 4WSPI Download

Check out this tutorial on how to install an Arduino library if you are unfamiliar.

Each of the libraries above contain some examples, however the ones that will actually make your TFT breakout light up are contained in the 'KWH018ST01' library -- in case you are wondering that name comes from the name of the TFT module that is used on the breakout. Once your libraries have been installed move on to the next section and try out a few of the examples.