GT911 Touch Controller: I2C Address, Reset Sequence, Registers and Configuration

The GT911 is a Goodix 5-point capacitive touch screen controller for panels of about 7 to 8 inches. It talks I2C at up to 400 kbit/s on address 0x5D or 0x14, chosen by the level on its INT pin while RESET is released, and it reports each finger as an 8-byte record starting at register 0x814F. Most bring-up problems come from three places: the reset sequence, not clearing the status register 0x814E after a read, and writing a configuration without its checksum.

Request a quote Touch panel and cover lens options

GT911 reset sequence and I2C address selection timingTiming diagram with three traces: VDD, RESET and INT. After power is up, the host drives INT low to select I2C address 0x5D, or high to select 0x14, and pulls RESET low for more than 100 microseconds. RESET is then released while INT is held at the chosen level for at least 5 milliseconds. INT is then switched to a floating input, and the host waits 50 milliseconds before writing configuration over I2C.GT911 reset and I2C address selectionVDDRESETINTINT low: address 0x5DINT high: address 0x14INT becomes a floating inputRESET low, more than 100 µshold INT at least 5 mswait 50 ms, then write config over I2CI2C ready
Figure: the GT911 reads INT while RESET is released. Low selects 0x5D, high selects 0x14; release INT afterwards and wait 50 ms before writing configuration.

What the GT911 is

A touch screen controller drives the transmit electrodes of a capacitive sensor, measures the receive electrodes, and turns the changes into finger coordinates. The GT911 does this for up to 5 fingers and hands the result to the host over I2C. The main figures from the Goodix datasheet and programming guide:

ItemGT911
Touch pointsUp to 5
Sensor channels26 drive (Tx), 14 sense (Rx)
Target screen size7 to 8 inch
Report rate100 Hz
Host interfaceI2C, at or below 400 kbit/s, plus INT and RESET
SupplyAVDD 2.8 to 3.3 V, VDDIO 1.8 to 3.3 V
PackageQFN52, 6 × 6 × 0.8 mm

One detail to check in your copy of the datasheet: the features list gives −40 to +85 °C, while the recommended operating table gives −20 to +85 °C. If your product runs below −20 °C, get the supplier to confirm which applies.

GT911 I2C address: 0x5D or 0x14

The GT911 picks its address at every power-on or reset from the level the host puts on INT. INT low gives 0x5D (0xBA to write, 0xBB to read). INT high gives 0x14 (0x28 and 0x29). The address is not stored, so a board that lets INT float during reset can come up at either address.

If a scan finds nothing, check three things: that the host is actually driving INT during reset rather than leaving a weak pull-up in charge, that RESET is really toggling, and that the pull-ups on SDA and SCL suit the bus speed. Goodix advises paying attention to pull-up values above 200 kbit/s.

GT911 reset sequence

  1. Drive INT as an output: low for 0x5D, high for 0x14.
  2. Pull RESET low for more than 100 µs.
  3. Release RESET high and keep INT at the chosen level for at least 5 ms.
  4. Switch INT to a floating input.
  5. Wait 50 ms before writing configuration.

The Zephyr driver follows the same pattern with generous margins: 20 ms after power-on, 1 ms in reset, 5 ms of INT hold and a 50 ms wait. Those margins add under 80 ms to start-up.

Reading touch points from the GT911

Register 0x814E is the status byte. Bit 7 says new coordinates are ready, and bits 3 to 0 hold the number of touch points. The point records follow from 0x814F, 8 bytes each: track ID, X low, X high, Y low, Y high, size low, size high and a reserved byte. After reading, write 0 to 0x814E. If you skip that write, the controller will not post new data.

In polling mode, read 0x814E and retry after about 1 ms when bit 7 is clear. In interrupt mode, INT pulses each time coordinates update, and the host should read and clear the buffer within one report period.

Worked example: how much of the I2C bus touch uses. Reading the status byte and five points means a 2-byte register address, 41 data bytes and the device address sent twice, once to write and once to read: 45 bytes, or 405 bit times at 9 bits per byte. At 400 kbit/s it takes about 1.0 ms; the clearing write adds 4 bytes, about 0.09 ms. At the 100 Hz report rate there is a new report every 10 ms, so touch keeps the bus about 11 percent busy. At 100 kbit/s the same read takes about 4.4 ms, over 40 percent of each period, which matters if other devices share the bus.

Configuration: the 184-byte block and its checksum

The configuration lives at 0x8047 to 0x80FE, 184 bytes. The first byte is the config version, stored as a letter from A to Z. Other fields set the output resolution, the touch count limit at 0x804C and the report timing. The rules for writing it:

  • Compute the checksum as the two’s complement of the 8-bit sum of those 184 bytes and write it to 0x80FF. If the bytes sum to 0x3A7C, the low byte is 0x7C and the checksum is 0x100 minus 0x7C, which is 0x84.
  • Write 1 to 0x8100, the Config_Fresh flag. Without the checksum and this flag, the GT911 ignores the new block.
  • Read the product ID at 0x8140 first. It returns the ASCII characters 911.

The panel maker tunes the configuration for its own sensor pattern, cover glass and stack-up. A block copied from another board can give offset coordinates, phantom touches or dead edges. On a working panel, change only the resolution and orientation fields unless the supplier gives you a new block.

GT911 vs other capacitive touch controllers

Within our own catalogue, the 7-inch S700GG-42 touch panel uses a GT911, the 10-inch S10GF2-94 uses a FocalTech FT5426G, and the 3.5-inch S35001D uses an FT5446 with 10 touch points. All three talk I2C, but the FocalTech parts have their own register maps, so a GT911 driver will not read them. When you change panels, check the controller part number before you reuse firmware.

ReferenceSizeTouch controllerInterfaceOutline (reference)
S700GG-427 inGT911I²C164.4 × 99.5 mm
S10GF2-9410 inFT5426GI²C247 × 152 mm
S35001D3.5 in, display and touchFT5446-P03I²C76.96 × 63.96 mm

Using a GT911 with Arduino, ESP32 or Linux

Drivers already exist for most platforms. Zephyr has an input_gt911 driver, ESPHome has a gt911 touchscreen component, MicroPython on OpenMV has a gt911 module, and Linux handles Goodix controllers with its goodix touchscreen driver. On an ESP32 the same INT and RESET rules apply, and the touch shares no pins with the display bus; see the ESP32 display guide.

When the GT911 is the wrong choice

  • Panels well above 8 inches, where 26 by 14 channels run short. Our 10-inch panel uses a different controller.
  • More than 5 simultaneous touches.
  • Thick cover glass, gloves or water on the screen. Those depend on sensor design and tuning more than on the controller name, so test with the final stack. See capacitive touch with gloves, water and thick glass.

FAQ

What is the I2C address of the GT911?

It is 0x5D if INT is held low while RESET is released, and 0x14 if INT is held high. In 8-bit form these are 0xBA and 0xBB, or 0x28 and 0x29. The address is chosen again at every reset.

Why does my GT911 not respond on I2C?

Usually the reset sequence is wrong: INT was not driven during reset, RESET never toggled, or the host wrote before the 50 ms wait ended. Also check the SDA and SCL pull-ups and that you are scanning for both 0x5D and 0x14.

How do I calculate the GT911 config checksum?

Add the 184 configuration bytes from 0x8047 to 0x80FE, keep the low 8 bits, and take the two’s complement. Write the result to 0x80FF, then write 1 to 0x8100 so the controller loads the new block.

What is a touch screen controller?

It is the chip that drives a capacitive or resistive touch sensor, measures it and reports touch coordinates to the host, usually over I2C. Each controller family has its own register map and needs a configuration tuned to the sensor and cover glass.

Pairing a touch panel with your display? Send the display size, cover glass thickness, host processor and whether you need a specific controller such as the GT911. We will check the catalogue panels and their controller configuration against your stack-up. See custom touch panels and cover lenses, or send a touch panel enquiry.

Scroll to Top
Get a QuoteWhatsApp