TFT LCD Breakout 1.8in 128x160 Hookup Guide
Software Setup
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
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.