This library supports the Kentec EB-LM4F120-L35 3.5" QVGA TFT LCD BoosterPack with Parallel I/O.
The EB-LM4F120-L35 uses the same display and controller chip as the SPI-based BOOSTXL-K350QVG-S1 BoosterPack.
The parallel I/O of the LM4F120 version of the BoosterPack allows faster screen drawing with the disadvantage of requiring more I/O pins. Although the name implies that it was designed for the Stellaris ARM-based LaunchPad, it will work with MSP430-based LaunchPads that have the 40-pin BOOSTXL interface and enough RAM to support using a large display.
This library is optimized for use with the MSP430F5529 and MSP432P401R LaunchPads, but will also work with any other MSP or Tiva LaunchPad with the BOOSTXL interface. Display refresh rates on boards other than the F5529 or MSP432 will be much slower due to the use of the generic DigitalWrite() for I/O control. When used with the F5529 or MSP432, the library uses a much faster direct register control for I/O.
This library is based on the Kentec_35_SPI library which is included with Energia.
The screen touch functionality was carried over from the SPI version of the library and the I/O pin number definitions were updated accordingly. However, touch functionality has not been tested with this library.
See the sketch included in the examples folder.
The parallel library works the same as the built-in SPI version of the library. See the Reference Manual included with the library.
I created a custom interface board to change the mapping of the pins between the Kentec BoosterPack and the F5529 LaunchPad. This was done for two reasons:
- Directly map the data bit positions of the Kentec controller interface to the MSP port bit positions. This allows simplification of the library code to allow even faster screen refresh rates.
- Move the Kentec pins to the inner BOOSTXL header pins (J3 and J4), so that the standard BoosterPack I/O pins are available for other devices (e.g. SPI and I2C pins).
Details on the board design can be found in the extras/Hardware folder.
The library has been modified to support the interface board. When using the library with the interface, the only code change needed is in the constructor to let the library know that the interface board is connected. By default, the TOUCH functionality is not connected when using the interface board:
Screen_K35_Parallel myScreen(Screen_K35_Parallel::F5529_INTERFACE_BOARD_INSTALLED, Screen_K35_Parallel::TOUCH_DISABLED);
If, however, you connect the TOUCH sensor pins (XP->P2, YP->P6, XN->P12, YN->P11), then use the following constructor:
Screen_K35_Parallel myScreen(Screen_K35_Parallel::F5529_INTERFACE_BOARD_INSTALLED, Screen_K35_Parallel::TOUCH_ENABLED);
- EB-LM4F120-L35 BoosterPack product page
- EB-LM4F120-L35 BoosterPack user guide
- SSD2119 driver chip datasheet
- Review of the EB-LM4F120-L35 from Rei Vilo's Embedded Computing site.
- Kentec_35_SPI library suite description and source.
- BOOSTXL-K350QVG-S1 (SPI) product page
This library is based off of code by Rei VILO, https://embedxcode.weebly.com, https://github.com/energia/msp430-lg-core/tree/master/libraries/Kentec_35_SPI.
The software and other files in this repository are licensed for hobbyist and personal use under the Creative Commons License CC BY-NC-SA 3.0. See the file LICENSE in this repository.