board_pins.h File Reference

Pin map for the 7-inch ESP32-P4 display board from Waveshare (ESP32-P4-WIFI6-Touch-LCD-7B). More...

#include "driver/gpio.h"

Go to the source code of this file.

Macros
#define	BOARD_NAME_TEXT   "ESP32-P4 7B"
	The board and the display as the splash names them.
#define	BOARD_DISPLAY_TEXT   "1024x600 DSI"
#define	BOARD_LCD_H_RES   1024
	The panel's size in pixels.
#define	BOARD_LCD_V_RES   600
#define	BOARD_UI_H_RES   1024
	The area the UI (user interface) draws: the whole panel, 1024 x.
#define	BOARD_UI_V_RES   600
	The UI area's height: the panel's 600 rows.
#define	BOARD_LCD_DPI_CLOCK_MHZ   52.0f
	DPI (Display Pixel Interface) timing, in pixels and lines.
#define	BOARD_LCD_HSYNC_PULSE_WIDTH   10
#define	BOARD_LCD_HSYNC_BACK_PORCH   160
#define	BOARD_LCD_HSYNC_FRONT_PORCH   160
#define	BOARD_LCD_VSYNC_PULSE_WIDTH   1
#define	BOARD_LCD_VSYNC_BACK_PORCH   23
#define	BOARD_LCD_VSYNC_FRONT_PORCH   12
#define	BOARD_DSI_LANES   2
	The DSI link: 2 data lanes. The lane rate is one define; 1000, 900 and 500Mbit/s per lane are the three to try on a board. RGB565 at 60Hz carries 297Mbit/s of pixels a lane. The EK79007 datasheet states 500Mbit/s as its maximum; Waveshare's examples run 900 and 1000.
#define	BOARD_DSI_LANE_MBPS   1000
#define	BOARD_DSI_PHY_LDO_CHAN   3
	The DSI PHY (physical layer) supply: on-chip LDO (low-dropout regulator) channel 3 at 2500mV, on before the bus starts.
#define	BOARD_DSI_PHY_LDO_MV   2500
#define	BOARD_LCD_PIN_RST   GPIO_NUM_33
	LCD reset, active low; a 10kOhm pull-down holds the panel in reset until firmware drives the pin.
#define	BOARD_LCD_ADDRESS_MODE   0x02
	The EK79007's address mode (DCS command 0x36): bit 1 the gate scan direction, bit 0 the source shift direction, 0x01 after reset. 0x02 reverses both, which turns the picture by 180 degrees. Waveshare's own start-up turns its picture by 180 degrees in software, so the panel's reset scan is taken to show the picture upside down; not measured.
#define	BOARD_BL_PIN   GPIO_NUM_32
	The backlight's PWM (pulse-width modulation) on GPIO32.
#define	BOARD_BL_LEDC_TIMER   1
#define	BOARD_BL_LEDC_CHANNEL   1
#define	BOARD_BL_PWM_HZ   5000
#define	BOARD_BL_DUTY_BITS   10
#define	BOARD_I2C_PORT   0
	The touch bus, I2C (Inter-Integrated Circuit): GPIO7 and GPIO8 reach the touch connector J3.
#define	BOARD_I2C_PIN_SDA   GPIO_NUM_7
#define	BOARD_I2C_PIN_SCL   GPIO_NUM_8
#define	BOARD_I2C_FREQ_HZ   400000
#define	BOARD_TOUCH_I2C_ADDR   0x5D
	The GT911 touch controller's addresses and reset line.
#define	BOARD_TOUCH_I2C_ADDR_ALT   0x14
#define	BOARD_TOUCH_PIN_RST   GPIO_NUM_23
#define	BOARD_TOUCH_MIRROR_X   1
	Touch mirroring, 1 to mirror an axis.
#define	BOARD_TOUCH_MIRROR_Y   1
#define	BOARD_SD_SLOT   0
	The SD card: SDMMC (SD card host) slot 0, 4-bit, on its fixed IO MUX pins: D0 to D3 GPIO39 to GPIO42, CLK GPIO43, CMD GPIO44. The card's supply is on-chip LDO channel 4.
#define	BOARD_SD_WIDTH   4
#define	BOARD_SD_PIN_CLK   GPIO_NUM_43
#define	BOARD_SD_PIN_CMD   GPIO_NUM_44
#define	BOARD_SD_PIN_D0   GPIO_NUM_39
#define	BOARD_SD_PIN_D1   GPIO_NUM_40
#define	BOARD_SD_PIN_D2   GPIO_NUM_41
#define	BOARD_SD_PIN_D3   GPIO_NUM_42
#define	BOARD_SD_LDO_CHAN   4
#define	BOARD_SD_FREQ_KHZ   20000
#define	BOARD_C6_SLOT   1
#define	BOARD_C6_WIDTH   4
#define	BOARD_C6_FREQ_KHZ   40000
#define	BOARD_C6_PIN_CLK   GPIO_NUM_18
#define	BOARD_C6_PIN_CMD   GPIO_NUM_19
#define	BOARD_C6_PIN_D0   GPIO_NUM_14
#define	BOARD_C6_PIN_D1   GPIO_NUM_15
#define	BOARD_C6_PIN_D2   GPIO_NUM_16
#define	BOARD_C6_PIN_D3   GPIO_NUM_17
#define	BOARD_C6_PIN_EN   GPIO_NUM_54
	ESP32-C6 chip enable, GPIO54; low holds it in reset.
#define	PANEL_CAN_PIN_TX   GPIO_NUM_22
	The link's CAN (Controller Area Network) pins.
#define	PANEL_CAN_PIN_RX   GPIO_NUM_21
#define	PANEL_CAN_BITRATE   1000000u
	The link's bit rate. Both ends must agree. 1Mbit/s is what the IOmcu's 16MHz crystal reaches exactly; see IOMCU_CAN_BITRATE and docs/Link.md.
#define	PANEL_HEARTBEAT_PIN   GPIO_NUM_28
	The heartbeat: IO28 of the 12-pin header P3 (3V3, GND, IO2-5, IO28-31, IO34, IO36).
#define	BOARD_KNOB_I2C_PORT   1
	The rotary knob's sensor, on an I2C controller of its own: nothing of the board shares its bus.
#define	BOARD_KNOB_PIN_SDA   GPIO_NUM_30
	The knob's SDA line: IO30 of header P3.
#define	BOARD_KNOB_PIN_SCL   GPIO_NUM_31
	The knob's SCL line: IO31 of header P3.
#define	BOARD_KNOB_I2C_FREQ_HZ   400000
	The knob's I2C clock in Hz.

Detailed Description

Pin map for the 7-inch ESP32-P4 display board from Waveshare (ESP32-P4-WIFI6-Touch-LCD-7B).

The board carries a 1024 x 600 IPS (in-plane switching) LCD (liquid-crystal display) on a 2-lane MIPI DSI (Display Serial Interface) link with an EK79007 controller, a GT911 touch controller and an ESP32-C6 for the radio.

Values are from the board schematic of 2025-09-25 and the EK79007 datasheet. "Not measured" marks a value no board has confirmed.

SPDX-License-Identifier: MIT

Macro Definition Documentation

BOARD_BL_DUTY_BITS

#define BOARD_BL_DUTY_BITS   10

backlight PWM resolution, 10 bits

BOARD_BL_LEDC_CHANNEL

#define BOARD_BL_LEDC_CHANNEL   1

LEDC channel of the backlight, 1

BOARD_BL_LEDC_TIMER

#define BOARD_BL_LEDC_TIMER   1

LEDC timer of the backlight, 1

BOARD_BL_PIN

#define BOARD_BL_PIN   GPIO_NUM_32

The backlight's PWM (pulse-width modulation) on GPIO32.

GPIO32 feeds the backlight boost converter's feedback node through 10kOhm: a higher level dims. LEDC (the LED pulse-width modulation controller) drives it inverted, so a duty of 100% is a constant low and full brightness. Whether a constant high is fully dark is not measured.

BOARD_BL_PWM_HZ

#define BOARD_BL_PWM_HZ   5000

backlight PWM frequency, 5000Hz

BOARD_C6_FREQ_KHZ

#define BOARD_C6_FREQ_KHZ   40000

radio clock, 40000kHz

BOARD_C6_PIN_CLK

#define BOARD_C6_PIN_CLK   GPIO_NUM_18

radio clock, GPIO18

BOARD_C6_PIN_CMD

#define BOARD_C6_PIN_CMD   GPIO_NUM_19

radio command, GPIO19

BOARD_C6_PIN_D0

#define BOARD_C6_PIN_D0   GPIO_NUM_14

radio data 0, GPIO14

BOARD_C6_PIN_D1

#define BOARD_C6_PIN_D1   GPIO_NUM_15

radio data 1, GPIO15

BOARD_C6_PIN_D2

#define BOARD_C6_PIN_D2   GPIO_NUM_16

radio data 2, GPIO16

BOARD_C6_PIN_D3

#define BOARD_C6_PIN_D3   GPIO_NUM_17

radio data 3, GPIO17

BOARD_C6_SLOT

#define BOARD_C6_SLOT   1

SDMMC slot of the ESP32-C6 radio, 1

BOARD_C6_WIDTH

#define BOARD_C6_WIDTH   4

radio bus width, bits

BOARD_DISPLAY_TEXT

#define BOARD_DISPLAY_TEXT   "1024x600 DSI"

the display as the splash names it

BOARD_DSI_LANE_MBPS

#define BOARD_DSI_LANE_MBPS   1000

per-lane rate, Mbit/s

BOARD_DSI_PHY_LDO_MV

#define BOARD_DSI_PHY_LDO_MV   2500

DSI PHY supply voltage, mV

BOARD_I2C_FREQ_HZ

#define BOARD_I2C_FREQ_HZ   400000

I2C clock, 400kHz

BOARD_I2C_PIN_SCL

#define BOARD_I2C_PIN_SCL   GPIO_NUM_8

I2C clock line, GPIO8

BOARD_I2C_PIN_SDA

#define BOARD_I2C_PIN_SDA   GPIO_NUM_7

I2C data line, GPIO7

BOARD_LCD_DPI_CLOCK_MHZ

#define BOARD_LCD_DPI_CLOCK_MHZ   52.0f

DPI (Display Pixel Interface) timing, in pixels and lines.

The panel refreshes at 60.38Hz, measured: the VSYNC figure of the console's 300-frame line on the station, 2026-10-23. 52MHz is requested; ESP-IDF v5.5.5 rounds 240MHz / 52MHz to a divider of 5, which delivers 48MHz. The defines make a frame 1354 x 636 clocks (1024 + 10 + 160 + 160 by 600 + 1 + 23 + 12); at 48MHz that alone would give 55.74Hz. mipi_dsi_hal_host_dpi_set_horizontal_timing() (components/hal/mipi_dsi_hal.c) keeps the requested rate instead: it times the DSI host's line from 1354 clocks at 52MHz and shortens the bridge's front porch by 104 clocks, so the line is 1250 clocks at 48MHz, 26.04us either way. 52MHz over 1354 x 636 is 60.38Hz, the measured figure. That this compensation is what sets the rate is read from the source, not from the registers. The EK79007 accepts 44.9 to 70.3MHz at 60Hz.

BOARD_LCD_HSYNC_BACK_PORCH

#define BOARD_LCD_HSYNC_BACK_PORCH   160

horizontal back porch, pixel clocks

BOARD_LCD_HSYNC_FRONT_PORCH

#define BOARD_LCD_HSYNC_FRONT_PORCH   160

horizontal front porch, pixel clocks

BOARD_LCD_HSYNC_PULSE_WIDTH

#define BOARD_LCD_HSYNC_PULSE_WIDTH   10

horizontal sync pulse width, pixel clocks

BOARD_LCD_V_RES

#define BOARD_LCD_V_RES   600

panel height, rows

BOARD_LCD_VSYNC_BACK_PORCH

#define BOARD_LCD_VSYNC_BACK_PORCH   23

vertical back porch, lines

BOARD_LCD_VSYNC_FRONT_PORCH

#define BOARD_LCD_VSYNC_FRONT_PORCH   12

vertical front porch, lines

BOARD_LCD_VSYNC_PULSE_WIDTH

#define BOARD_LCD_VSYNC_PULSE_WIDTH   1

vertical sync pulse width, lines

BOARD_SD_FREQ_KHZ

#define BOARD_SD_FREQ_KHZ   20000

SD clock, 20000kHz

BOARD_SD_LDO_CHAN

#define BOARD_SD_LDO_CHAN   4

on-chip LDO channel that supplies the card, 4

BOARD_SD_PIN_CLK

#define BOARD_SD_PIN_CLK   GPIO_NUM_43

SD clock, GPIO43

BOARD_SD_PIN_CMD

#define BOARD_SD_PIN_CMD   GPIO_NUM_44

SD command, GPIO44

BOARD_SD_PIN_D0

#define BOARD_SD_PIN_D0   GPIO_NUM_39

SD data 0, GPIO39

BOARD_SD_PIN_D1

#define BOARD_SD_PIN_D1   GPIO_NUM_40

SD data 1, GPIO40

BOARD_SD_PIN_D2

#define BOARD_SD_PIN_D2   GPIO_NUM_41

SD data 2, GPIO41

BOARD_SD_PIN_D3

#define BOARD_SD_PIN_D3   GPIO_NUM_42

SD data 3, GPIO42

BOARD_SD_WIDTH

#define BOARD_SD_WIDTH   4

SD bus width, bits

BOARD_TOUCH_I2C_ADDR

#define BOARD_TOUCH_I2C_ADDR   0x5D

The GT911 touch controller's addresses and reset line.

GT911 at 0x5D, 0x14 its second address. Its INT line reaches only J3 and a test point, so the touch task polls. The schematic routes GPIO23 to the GT911's reset through a 0Ohm resistor; GPIO_NUM_NC here runs no reset sequence.

BOARD_TOUCH_MIRROR_X

#define BOARD_TOUCH_MIRROR_X   1

Touch mirroring, 1 to mirror an axis.

The GT911 reports 1024 x 600 in its own orientation. These mirror it into the panel's, applied before rotation; both set match BOARD_LCD_ADDRESS_MODE 0x02. Not measured.

BOARD_TOUCH_MIRROR_Y

#define BOARD_TOUCH_MIRROR_Y   1

mirror the touch Y axis: 1

BOARD_TOUCH_PIN_RST

#define BOARD_TOUCH_PIN_RST   GPIO_NUM_23

GT911 reset line, GPIO23

BOARD_UI_H_RES

#define BOARD_UI_H_RES   1024

The area the UI (user interface) draws: the whole panel, 1024 x.

1. Touches outside it are dropped (touch.c).

PANEL_CAN_PIN_RX

#define PANEL_CAN_PIN_RX   GPIO_NUM_21

CAN receive from the transceiver, GPIO21

PANEL_CAN_PIN_TX

#define PANEL_CAN_PIN_TX   GPIO_NUM_22

The link's CAN (Controller Area Network) pins.

TWAI (Two-Wire Automotive Interface, the ESP32-P4's CAN controller) to the TJA1051T/3 transceiver on header H11. Pin 1 of H11 is the board's 5V rail, so the link cable can power the board.