Big Screen

Big Screen

2.0" IPS color display with 320x240 resolution

A larger color display for dashboards, games, animations, and user interfaces. 2.0 inch IPS panel (ST7789) at 320x240 with 65K colors, driven over SPI at 40MHz for about 20 full frames per second. Uses the same drawing commands as the Screen, with four times the pixels. The panel overhangs the board edge, and the backlight is always on.

For ages 14 and up. Not a toy. Contains small parts: choking hazard. Keep away from children under 3. Adult supervision recommended.

Made by Atech ApS, Lille Strandstræde 6A, st. th., 1254 København K, Denmark.

Technical specifications

Part
ST7789 TFT Color Display (320x240)
Interface
Digital
Ports
2 neighbouring ports
Current
~40 mA
Size
39.5 x 59.7 x 9.5 mm

Pins

3.3V (first port)
supply
GND (first port)
ground
Data A (first port)
DC, data/command select (the panel's RS pin)
Data B (first port)
CS, chip select
3.3V (second port)
supply
GND (second port)
ground
Data A (second port)
MOSI, data in
Data B (second port)
SCLK, serial clock

Key features

  • 320x240 pixel resolution
  • 2.0" IPS panel with wide viewing angles
  • 65K color depth
  • ST7789 driver, fast 40MHz SPI

Common applications

Dashboards
Games and animations
Data visualization
Menus and user interfaces
+ Use in Project

Technical

Display

Big Screen

ST7789 TFT Color Display (320x240)
Interfacedigital
PortsTakes 2 adjacent ports; needs a port carrying digital
Current40 mA
Size39.5 × 9.5 × 59.72 mm (CAD bounding box)
DriverST7789_TFT

2.0 inch 320x240 IPS color display with ST7789 controller, SPI interface. Same wiring and same drawing API as the small Color Display, with four times the pixels. Double module spanning two adjacent ports: DC on Line A1, CS on Line B1, MOSI on Line A2, SCLK on Line B2. The panel overhangs the board edge. Backlight is always on.

What it can do
  • display_text Display text at cursor position with configurable size and color
  • clear_display Clear the display to black
  • fill_screen Fill entire screen with a color
  • draw_pixel Draw a single pixel at x,y with color
  • draw_line Draw a line between two points
  • draw_rect Draw a rectangle outline
  • fill_rect Draw a filled rectangle
  • draw_circle Draw a circle outline
  • fill_circle Draw a filled circle
  • draw_round_rect Draw a rounded rectangle, outline or filled
  • draw_triangle Draw a triangle, outline or filled
  • draw_ellipse Draw an ellipse, outline or filled
How it works
BIG SCREEN (ST7789 320x240, landscape): SAME API AS THE SMALL COLOR DISPLAY, 4x THE PIXELS.

SIZE AND SPEED (big_screen.md):
- 320x240 pixels in landscape (x 0-319, y 0-239). Lay out for that, not for 160x80.
- display() in canvas mode pushes the whole frame in about 31 ms, so full redraws top
  out around 20-25 fps. Rate-limit redraws to 33-50 ms.
- Canvas mode needs a 150 KB framebuffer. If begin() cannot allocate it the driver runs
  in direct mode on its own; isDirectMode() tells you.

CHOOSING A MODE, by how much of the screen changes per frame:
- CANVAS MODE (default) whenever a frame repaints most of the screen: dashboards,
  readouts, and games that redraw a background every frame.
  Pattern: clear() -> draw everything -> display(). Flicker-free.
- DIRECT MODE (setDirectMode(true) once in setup) only for small sprites moving over a
  background that stays put: erase the old spot with a small fillRect, draw the new one.
  A full-screen fill in direct mode takes about 31 ms and shows on its own: never per frame.

SHAPES: drawRoundRect/fillRoundRect(x, y, w, h, radius, color),
drawTriangle/fillTriangle(x0, y0, x1, y1, x2, y2, color),
drawEllipse/fillEllipse(x, y, rx, ry, color), besides rect/circle/line/pixel.

TEXT:
- Coordinates are never arguments to print(). setCursor(x, y), then print(value);
  print(float, decimals) exists. displayText(text, x, y, size, color) does both.
- The default 5x7 font is tiny at 320x240. Use #include <Fonts/FreeSansBold12pt7b.h>
  (9/12/18/24 pt, FreeSans or FreeSansBold), setFont(&...), setTextSize(1). With a
  custom font Y is the BASELINE. textWidth(), lineHeight() and textBounds() measure text.
- Colors: ST7789_TFT::COLOR_BLACK, COLOR_WHITE, COLOR_RED, COLOR_GREEN, COLOR_BLUE,
  COLOR_CYAN, COLOR_MAGENTA, COLOR_YELLOW, COLOR_ORANGE, or raw RGB565.

ROTATION: 1 and 3 are landscape, 0 and 2 portrait (240x320). st7789_tft.h says begin()'s
3 is upright on the board's right-hand column and 1 on the left; studio has not measured
this panel, and nothing in studio's setup sets it for you. Changing between landscape and
portrait replaces the canvas, which clears it, so rotate first in setup.

SPI: the screen takes a hardware SPI host only if one is free; otherwise it bit-bangs
(same drawing, slower pushes). isSoftwareSpi() says which. With a microSD card or a
camera on the board, see their notes on atech::reserveSpiHosts().
No brightness control: the backlight is hard-wired on.
Suggested control

A text input labeled 'Display text' plus a Send button that dispatches a display-text action. Add 4-6 color preset chips that send a fill-screen action, and a 4:3 preview tile showing the last text that was sent.

Pinout
Port 1
PinLineDirFunction
1HV–not connected
25V–not connected
33.3Vinputsupply
4GND–ground
5Data AinputDC, data/command select (the panel's RS pin)
6Data BinputCS, chip select
Port 2
PinLineDirFunction
7HV–not connected
85V–not connected
93.3Vinputsupply
10GND–ground
11Data AinputMOSI, data in
12Data BinputSCLK, serial clock

from p2p/ground_truth/hardware/prototyping_line/modules/big_screen.md

Chip

The doc for this module names no separate part. It is passive or discrete hardware, so there is no chip datasheet to read.