View source for 1.14-lcd-breakout

<div class="row">
  <div class="large-8 column">
== 1.14" LCD Breakout ==
1.14 inch LCD Breakout is a 1.14-inch display breakout with a resolution of 240 135 pixels, 65K RGB colours, and a crisp and colorful showing effect, built specifically for cross-platform to broaden its involvement via SPI communication by including a GPIO header. The ST7789 Driver and SPI Interface are included in the 1.14 Inch LCD Breakout, reducing the number of IO pins required.

=== Features ===
* 4-wire SPI Communication
* Cross-Platform support
* SPI Interface
* 1.14 inch display
* Voltage Level Shifter

=== Specifications ===
* Operating Voltage - 3.3 V / 5V
* Display Size - 24.91 × 14.86mm
* Pixels - 240×135 resolution
* Pixel Size - 0.1101 × 0.1035mm
* Display Colour - 65K RGB
* Display Driver -  ST7789
* Voltage Level Shifter - TXB0108PWR

</div>
  <div class="large-4 column">
[[File:1.14InchLCDBreakout.png|thumb|left|alt=1.14 Round LCD Breakout| Buy it From : ''[https://shop.sb-components.co.uk/products/1-14-inch-lcd-breakout Click Here]'']]
  </div>
</div>

== Pinout ==
<table class="wikitable">
<tr> <th>1.14" LCD Breakout</th> <th>Description </th></tr>

<tr> <td> GND </td> <td> Ground Supply </td></tr>
<tr> <td> VCC </td> <td> Power Supply 3.3V - 5V DC </td></tr>
<tr> <td> DIN </td> <td> Serial Data Input / Output </td></tr>
<tr> <td> CLK </td> <td> Serial Clock </td></tr>
<tr> <td> CS </td> <td> Chip select input pin ("Low" enable) </td></tr>
<tr> <td> DC </td> <td> Display data / Command selection pin </br> DC='1': Display data. </br> DC='0': Command data </td></tr>
<tr> <td> RST </td> <td> Reset Pin. Initialize the chip with a low input </td></tr>
<tr> <td> BL </td> <td> Blacklight Control. High: Blacklight on Low: Blacklight off. </td></tr>

</table>

== Installation ==
==== Arduino ====
* [https://github.com/moononournation/Arduino_GFX '''Arduino Library for 1.14" LCD Breakout''']

If you are using Arduino Ide, you can use the above library.

==== PICO RP2040 (MicroPython) ====
*  For running this HAT, you require these components :
** Raspberry Pi Pico X 1
** 1.14" LCD Breakout X 1
** USB Cable X 1

* Copy or clone code from Github.
https://github.com/sbcshop/1.14-LCD-Breakout

* Connect 1.14 inch LCD breakout with Raspberry Pi Pico as shown in the below pinout.

<table class="wikitable">
<tr> <th>1.14" LCD Breakout </th> <th>PICO Pins </th></tr>
<tr> <td> VCC </td> <td> 3.3V / 5V </td></tr>
<tr> <td> GND </td> <td> GND </td></tr>
<tr> <td> LCD DIN </td> <td> GP11 </td></tr>
<tr> <td> LCD CLK </td> <td> GP10 </td></tr>
<tr> <td> LCD DC </td> <td> GP8 </td></tr>
<tr> <td>LCD CS</td> <td> GP9 </td></tr>
<tr> <td> LCD RST </td> <td> GP12 </td></tr>
<tr> <td> LCD BL </td> <td> GP13 </td></tr>
</table>

* Press and hold  '''BOOTSEL''' pin of Raspberry Pi Pico and connect the USB cable, it will create a drive as RPI-RP2.

* Now drag and drop or copy and paste '''firmware.uf2''' file from firmware folder to RPI-RP2 Drive. It will reboot your raspberry pi pico.

* Open Thonny IDE and Choose interpreter as MicroPython (Raspberry Pi pico).
[[File:Thonny-interpreter.PNG|600px]]

* Now you can run example codes from the '''Pico_Example_mpy''' folder in Thonny Ide. For example, Open the '''hello.py''' file in thonny and click on the green play button to run this example.
[[File:114_LCD_thonny_code.PNG]]

It will print "Hello World!" on LCD.

==== Working Example ====
* This module was tested on Raspberry Pi Pico. You need to provide a SPI object and the pin to use for the DC pin of the screen.

<source lang="python">
import machine
import st7789
spi = SPI(1, baudrate=40000000, sck=Pin(10), mosi=Pin(11))
tft = st7789.ST7789(spi, 135, 240, reset=Pin(12, Pin.OUT), cs=Pin(9, Pin.OUT), dc=Pin(8, Pin.OUT), backlight=Pin(13, Pin.OUT), rotation=3)
tft.init()
</source>


==== Functions and Arguments ==== 
* <source inline>  st7789.ST7789(spi, width, height, reset, dc, cs, backlight, rotation, buffer_size) </source>
required arguments:
<source>
`spi` spi device
  `width` display width
  `height` display height
</source>

optional args:
<source>
  `reset` reset pin
  `dc` dc pin
  `cs` cs pin
  `backlight` backlight pin
  `rotation` 0-0 degrees, 1-90 degrees, 2-180 degrees, 3-270 degrees
  `buffer_size` 0= buffer dynamically allocated and freed as needed.
</source>

If buffer_size is specified it must be large enough to contain the largest bitmap, font character, and/or JPG used (Rows * Columns *2 bytes). Specifying a buffer_size reserves memory for use by the driver otherwise, memory required is allocated and free dynamically as it is needed. Dynamic allocation can cause heap fragmentation so garbage collection (GC) should be enabled.

'''This driver supports only 16bit colors in RGB565 notation.'''

* <source inline> ST7789.on() </source>

Turn on the backlight pin if one was defined during init.

* <source inline> ST7789.off() </source>

Turn off the backlight pin if one was defined during init.

* <source inline> ST7789.pixel(x, y, color) </source>

Set the specified pixel to the given color.

* <source inline> ST7789.line(x0, y0, x1, y1, color) </source>

Draws a single line with the provided color from (x0, y0) to (x1, y1).

* <source inline> ST7789.hline(x, y, length, color) </source>

Draws a single horizontal line with the provided color and length in pixels. Along with vline, this is a fast version with reduced number of SPI calls.

* <source inline> ST7789.vline(x, y, length, color) </source>

Draws a single horizontal line with the provided color and length in pixels.

* <source inline> ST7789.rect(x, y, width, height, color) </source>

Draws a rectangle from (x, y) with corresponding dimensions

* <source inline> ST7789.fill_rect(x, y, width, height, color) </source>

Fill a rectangle starting from (x, y) coordinates

Source code credit: https://github.com/russhughes/st7789_mpy

== Resources ==
<b> Github </b>
* [https://github.com/sbcshop/1.14-LCD-Breakout Source Code]