How to use a 2.4 inch 240x320 TFT display with STM32?

How to Use a 2.4 Inch 240x320 TFT Display with STM32

To use a 2.4 inch 240x320 tft display with an STM32 microcontroller, you need to connect it via the SPI or parallel interface, initialize the display driver (typically ILI9341 or ST7789), and write pixel data to the frame buffer. The most common approach is using SPI with 4-wire mode, which requires only 6 pins: CS, DC, MOSI, SCK, RST, and LED (backlight). For example, with an STM32F103C8T6 (Blue Pill), you can assign CS to PA4, DC to PA3, MOSI to PA7, SCK to PA5, RST to PA2, and LED to PA1 (with a 100Ω resistor). The display operates at 3.3V logic, so direct connection works without level shifting. The key is to configure the SPI peripheral at 18 MHz (maximum for STM32F103) to achieve a refresh rate of about 30 fps for full-screen updates. You can find detailed wiring and code examples in the datasheet for this 2.4 inch 240x320 tft display.

Start by identifying the display driver chip. Most 2.4-inch 240x320 TFT panels use the ILI9341 controller, which supports both SPI and 8-bit parallel interfaces. The SPI mode uses 4-wire serial communication: CS (chip select), DC (data/command), MOSI (master out slave in), and SCK (serial clock). RST is optional if you tie it to the STM32 reset pin, but a dedicated GPIO is better for reliability. The backlight LED pin is often controlled via PWM for brightness adjustment. For the STM32, you can use Timer 2 (channel 1) on PA1 to generate a 1 kHz PWM signal with a duty cycle from 0 to 100%.

For wiring, connect the display pins as follows: VCC to 3.3V, GND to GND, CS to PA4, DC to PA3, MOSI to PA7, SCK to PA5, RST to PA2, and LED to PA1. If your display has a separate T_IRQ pin for touch (resistive), leave it unconnected unless you use a touch controller like XPT2046. The ILI9341 operates at 2.8V to 3.6V, so 3.3V is safe. Ensure the STM32 SPI pins are configured as alternate function push-pull outputs. The STM32F103 SPI1 on PA5 (SCK) and PA7 (MOSI) supports up to 18 MHz, but the ILI9341 can handle up to 40 MHz in SPI mode, so you can push the clock to 36 MHz on STM32F4 or higher. For the F103, stick to 18 MHz to avoid signal integrity issues on breadboards.

Initialization sequence is critical. The ILI9341 requires a specific set of commands to exit sleep mode, set color format (16-bit RGB565), and configure the display orientation. Here’s a typical initialization sequence for SPI mode: send command 0x01 (Software Reset), wait 120 ms, then 0x11 (Sleep Out), wait 150 ms, then 0x36 (Memory Access Control) with data 0x48 (for portrait mode), then 0x3A (Pixel Format Set) with data 0x55 (16-bit color), then 0x29 (Display On), wait 20 ms. You can also set the column and page addresses using commands 0x2A (Column Address Set) and 0x2B (Page Address Set) to define a drawing window. For example, to write to the entire 240x320 area, send 0x2A with data 0x00, 0x00, 0x00, 0xEF (240 pixels), and 0x2B with data 0x00, 0x00, 0x01, 0x3F (320 pixels).

Writing pixel data is done via the 0x2C (Memory Write) command. Each pixel requires 2 bytes (RGB565 format: 5 bits red, 6 bits green, 5 bits blue). For a full-screen update, you need to send 240 * 320 * 2 = 153,600 bytes. At 18 MHz SPI clock, each byte takes about 0.56 µs, so the total transfer time is 86 ms, ignoring overhead. With command overhead and delays, a full refresh takes about 120 ms, yielding 8 fps. To improve performance, use DMA (direct memory access) to transfer data without CPU intervention. Configure SPI1 with DMA1 channel 3 (for TX) and set the memory address to your frame buffer. The STM32F103 can handle DMA transfers at full SPI speed, reducing CPU load to near zero during pixel writes.

For color depth, 16-bit RGB565 is standard. To display a solid color, fill a buffer with the 16-bit value (e.g., 0xF800 for red, 0x07E0 for green, 0x001F for blue). For images, you need to convert 24-bit BMP to 16-bit format. A common method is to use a lookup table for gamma correction, but for most applications, simple truncation works. The ILI9341 also supports 18-bit color (262K colors) via 3 bytes per pixel, but that increases data size by 50% and reduces performance. Stick to 16-bit for most STM32 projects.

Backlight control is essential for power management. The LED pin typically draws 20-40 mA at 3.3V. Use a PWM signal from a timer to control brightness. For example, with Timer 2 on STM32F103, set the prescaler to 72 (for 1 MHz timer clock) and the period to 1000 (for 1 kHz PWM). Adjust the duty cycle by setting the compare register (CCR1) from 0 to 999. A 50% duty cycle reduces brightness by half while extending LED lifespan. If you don’t need brightness control, connect the LED pin to 3.3V through a 100Ω resistor to limit current to 33 mA.

Touch functionality (if your display includes a resistive touch panel) requires an additional ADC controller like the XPT2046. This chip communicates via SPI and provides touch coordinates as 12-bit values. Wire the T_IRQ pin to a GPIO interrupt on STM32 (e.g., PB0) to detect touches. The XPT2046 requires a separate SPI bus or a shared bus with a different CS pin. For example, use SPI2 on PB13 (SCK) and PB15 (MOSI) with CS on PB12. The touch sampling rate is typically 125 kHz, so you can read coordinates at 100 Hz without issues. Calibration involves mapping ADC values to display coordinates using a linear transformation: x_display = (x_adc - x_min) * 240 / (x_max - x_min).

Power consumption is a concern for battery-powered projects. The ILI9341 draws about 20 mA during normal operation and 5 µA in sleep mode. The backlight adds 20-40 mA. To reduce power, use the sleep command (0x10) when the display is idle, and turn off the backlight via PWM. The STM32F103 in stop mode consumes 14 µA, so total system power can be under 50 µA in sleep. For always-on displays, consider using a lower refresh rate (e.g., 1 fps) and only update changed regions.

Software libraries simplify development. The most popular is the Adafruit GFX library, ported to STM32 via the Arduino core or bare-metal C. The library provides functions like drawPixel, fillRect, drawCircle, and printText. For text rendering, you need a font bitmap; the default 5x7 font is small but readable. For larger fonts, use a custom font generator like “Fontographer” or “GLCD Font Creator”. The library uses a frame buffer in RAM, which requires 153,600 bytes for full resolution. The STM32F103 has 64 KB SRAM, so you can only store one frame buffer. For larger displays, use partial updates or external SRAM (e.g., 23LC1024 via SPI).

Timing constraints are important. The ILI9341 command cycle requires a minimum delay of 5 µs between commands. The data write cycle has no delay, but the display needs a 120 ms delay after reset and 150 ms after sleep out. Use the STM32 SysTick timer (1 ms resolution) for delays. For microsecond delays, use a busy-wait loop with NOP instructions. For example, a 5 µs delay on a 72 MHz STM32 requires 360 NOPs (since each NOP is 1/72 µs).

Common issues include garbled display, no response, or wrong colors. Garbled display often results from incorrect SPI clock polarity or phase. The ILI9341 expects SPI mode 0 (CPOL=0, CPHA=0) or mode 3 (CPOL=1, CPHA=1). Most libraries use mode 0. Check the SCK line with an oscilloscope to ensure clean edges. No response usually means the CS or DC pin is not toggling correctly. Use a logic analyzer to verify the command sequence. Wrong colors indicate a byte order issue: the ILI9341 expects big-endian data (high byte first), but some STM32 SPI peripherals send little-endian. Set the SPI data size to 8 bits and configure the byte order in the CR1 register (LSBFIRST=0).

For advanced users, you can implement a double-buffer system using two frame buffers in external SRAM. This allows you to draw to one buffer while the other is being sent to the display, eliminating tearing. The 23LC1024 SRAM (1 Mbit) provides 128 KB, enough for one buffer. Use SPI2 to communicate with the SRAM at 20 MHz. The DMA transfer from SRAM to display takes about 100 ms, so you can achieve 10 fps with smooth animations. For graphic user interfaces (GUIs), use the emWin library (free for STM32) or TouchGFX for high-performance rendering. These libraries support anti-aliasing, transparency, and hardware acceleration via DMA2D on STM32F4.

Display orientation is controlled by the MADCTL command (0x36). The default orientation (0x48) is portrait with the origin at the top-left. To rotate 90 degrees, use 0x28 (landscape) or 0x88 (landscape flipped). The column and page addresses must be swapped accordingly. For example, in landscape mode, the column range is 0-319 and page range is 0-239. Update the initialization sequence to match the orientation. The ILI9341 also supports mirroring via the MY and MX bits in the MADCTL register.

Temperature range is another factor. The ILI9341 operates from -20°C to +70°C, but the LCD panel itself can degrade at low temperatures (slower response). For outdoor projects, use a heater or choose a display with a wider temperature range. The backlight LED is rated for 20,000 hours at 20 mA, so expect 2-3 years of continuous use. Dimming the backlight extends this lifespan.

Testing your setup: write a simple test pattern like a color bar (red, green, blue, white, black) to verify pixel mapping. Use a logic analyzer (e.g., Saleae) to capture the SPI signals and compare with the ILI9341 datasheet. The command 0x04 (Read Display ID) should return 0x9341 for a genuine ILI9341. If you get 0x00, check the wiring and power. Some clone displays use ST7789 or HX8357 drivers, which have different initialization sequences. For ST7789, the command set is similar but uses different register addresses (e.g., 0x36 with 0x70 for orientation).

For production, use a PCB with decoupling capacitors (100 nF near the display VCC) and a ferrite bead on the backlight line to reduce EMI. The STM32 SPI lines should be kept short (<10 cm) and shielded from high-current traces. For high-speed SPI (18 MHz), use a ground plane and series resistors (22Ω) on the MOSI and SCK lines to dampen reflections. The display module itself often has a built-in voltage regulator, so no external LDO is needed. The 2.4 inch 240x320 tft display from DisplayModule includes a 4-wire SPI interface and a 10-pin header, making it breadboard-friendly.

Finally, benchmark your frame rate. Use a GPIO toggle to measure the time between frame updates. On an STM32F103 at 72 MHz, a full-screen fill with DMA takes 86 ms, yielding 11.6 fps. With partial updates (e.g., only a 100x100 pixel area), you can achieve 100+ fps. For scrolling text, update only the changed rows. The ILI9341 supports hardware scrolling via the Vertical Scrolling Definition command (0x33), which shifts the display content without rewriting pixels. This is useful for terminal-like interfaces. Set the TFA (top fixed area) and BFA (bottom fixed area) to 0, and the VSA (vertical scroll area) to 320 lines. Then write new data to the bottom of the frame buffer and increment the scroll start address (0x37). This reduces CPU load by 50% for scrolling applications.