TFT Display (ST7735)

> [!NOTE] > The Blockly setup block's own field labels use slightly different names for two of these — MOSI (same signal as this component's SDA pin) and RST (same signal as RES).

Displays17 blocksMicroPythonC++
1.8" TFT Display (ST7735)

At a glance

Pins and properties exactly as the circuit editor and simulator define this part. The text below explains how to use them.

Pinout

Pinout of the 1.8" TFT Display (ST7735), drawn as in the circuit editor. Select a label to see that pin in the table below.

1. Overview

The ST7735 drives a small full-color TFT LCD panel over SPI — the first color (not just monochrome) display in this chapter. At 128×160 pixels with 16-bit color, it's a large step up in both capability and generated-code complexity from the character LCDs and LED matrix covered so far.


2. Pinout

Verified against simulator/components/tft display (st7735) .ts (8-pin header):

Pins of this part
PinLabelTypeNotes
GNDGNDGroundGround
VCCVCCPower in+3.3V/5V supply
SCKSCKSignal inSPI clock
SDASDASignal inSPI data (MOSI)
RESRESSignal inReset
DCDCSignal inData/Command select
CSCSSignal inChip select
BLBLPower inBacklight anode

[!NOTE] The Blockly setup block's own field labels use slightly different names for two of these — MOSI (same signal as this component's SDA pin) and RST (same signal as RES). Wire the block's MOSI field to this component's SDA pin, and RST to RES — they're the same wire, just labeled differently between the block UI and the datasheet-style silkscreen on the simulated part.


3. Key Specifications

SpecValue
ControllerST7735
Resolution128 × 160 px
Color depth16-bit RGB565 (65K colors)
InterfaceSPI, 4-wire + reset (CS/DC/RST/SCK/MOSI)
BacklightSeparate pin (BL), PWM-dimmable

4. Libraries Used

  • C++ (Arduino): Adafruit_GFX + Adafruit_ST7735.
  • MicroPython: no external import — OMS's code generator writes a complete, self-contained ST7735 driver class directly into your generated code the first time any ST7735 block is used (covering fill, pixel, line, rect/fill_rect, text, rotation, and PWM brightness). There's nothing to separately install.

5. Component Properties

From the real props: [...]:

  • titleText (text) — Header bar text on the simulated screen. Default: "ST7735 128x160".
  • valueText (text) — Body readout text. Default: "Temp: 24.5 C".
  • demoScreen (select) — 📊 Live Dashboard (default), 💻 Terminal CLI, or 👾 Retro Game UI.

Powered state comes from VCC: above 2.8V the screen lights; below 3.0V while powered, a LOW VCC fault is raised.


6. Simulator Behavior

The canvas renders one of three built-in demo layouts (a sensor dashboard with a progress gauge and waveform, a terminal-style boot log, or a simple retro game scene) driven entirely by titleText/valueText/demoScreen. During simulation, a dropdown and text field let you switch layouts and edit the value text live.

[!IMPORTANT] Same disclosed gap as the LCD displays in 10.2/10.3: OMS has no SPI-transaction decoder for this component, so the on-canvas screen is always one of the three built-in demo layouts — not a pixel-accurate reflection of what your real fillRect()/drawPixel()/print() calls actually draw. The generated code is real and correct for actual hardware; it just has nothing to render against in the Circuit Canvas today.


7. Supported Blockly Blocks (16 Blocks)

Drawing the blocks…

TFT Display (ST7735) — OMS Parts