mb/starlabs/labtop: Add comments for GPIOs
Add comment for each GPIO details its endpoint based
on the schematic.
Signed-off-by: Sean Rhodes <sean@starlabs.systems>
Change-Id: Ia3678274dcd52285019fb3cf8ccd22617268ce1a
Reviewed-on: https://review.coreboot.org/c/coreboot/+/60123
Tested-by: build bot (Jenkins) <no-reply@coreboot.org>
Reviewed-by: Matt DeVillier <matt.devillier@gmail.com>
diff --git a/src/mainboard/starlabs/labtop/variants/tgl/gpio.c b/src/mainboard/starlabs/labtop/variants/tgl/gpio.c
index a0fc12c..e9729c2 100644
--- a/src/mainboard/starlabs/labtop/variants/tgl/gpio.c
+++ b/src/mainboard/starlabs/labtop/variants/tgl/gpio.c
@@ -9,7 +9,9 @@
/* Early pad configuration in bootblock */
const struct pad_config early_gpio_table[] = {
+ /* C20: UART2_RXD_R */
PAD_CFG_NF(GPP_C20, NONE, DEEP, NF1),
+ /* C21: UART2_TXD_R */
PAD_CFG_NF(GPP_C21, NONE, DEEP, NF1),
};
@@ -19,201 +21,408 @@
return early_gpio_table;
}
-/* Pad configuration in ramstage.c */
+/* Pad configuration in ramstage. */
const struct pad_config gpio_table[] = {
+ /* REFERENCE: EP PER SCHEMATIC */
+
+ /* GPD0: PCH_BATLOW# */
PAD_CFG_NF(GPD0, UP_20K, PWROK, NF1),
+ /* GPD1: AC_PRESENT */
PAD_CFG_NF(GPD1, NATIVE, PWROK, NF1),
+ /* GPD2: LAN_WAKE# */
PAD_CFG_NF(GPD2, NATIVE, PWROK, NF1),
+ /* GPD3: SIO_PWRBTN# */
PAD_CFG_NF(GPD3, UP_20K, PWROK, NF1),
+ /* GPD4: SIO_SLP_S3# */
PAD_CFG_NF(GPD4, NONE, PWROK, NF1),
+ /* GPD5: SIO_SLP_S4# */
PAD_CFG_NF(GPD5, NONE, PWROK, NF1),
+ /* GPD6: SIO_SLP_A# */
PAD_CFG_NF(GPD6, NONE, PWROK, NF1),
+ /* GPD7: PCH_TBT_PERST# */
PAD_CFG_GPO(GPD7, 0, PWROK),
+ /* GPD8: SUSCLK */
PAD_CFG_NF(GPD8, NONE, PWROK, NF1),
+ /* GPD9: SIO_SLP_WLAN# */
PAD_CFG_NF(GPD9, NONE, PWROK, NF1),
+ /* GPD10: SIO_SLP_S5# */
PAD_CFG_NF(GPD10, NONE, PWROK, NF1),
+ /* GPD11: PM_LANPHY_EN */
PAD_CFG_GPO(GPD11, 0, PWROK),
+
+ /* A0: ESPI_IO_0 */
PAD_CFG_NF(GPP_A0, UP_20K, DEEP, NF1),
+ /* A1: ESPI_IO_1 */
PAD_CFG_NF(GPP_A1, UP_20K, DEEP, NF1),
+ /* A2: ESPI_IO_2 */
PAD_CFG_NF(GPP_A2, UP_20K, DEEP, NF1),
+ /* A3: ESPI_IO_3 */
PAD_CFG_NF(GPP_A3, UP_20K, DEEP, NF1),
+ /* A4: ESPI_CS_L */
PAD_CFG_NF(GPP_A4, UP_20K, DEEP, NF1),
+ /* A5: ESPI_CLK */
PAD_CFG_NF(GPP_A5, DN_20K, DEEP, NF1),
+ /* A6: Not Connected(TP764) */
PAD_CFG_NF(GPP_A6, NONE, DEEP, NF1),
+ /* A7: WLAN_PCM_CLK */
PAD_NC(GPP_A7, NONE),
+ /* A8: WLAN_PCM_RST */
PAD_CFG_NF(GPP_A8, NONE, DEEP, NF2),
+ /* A9: WLAN_PCM_CLKREQ0 */
PAD_CFG_NF(GPP_A9, NONE, DEEP, NF3),
+ /* A10: WLAN_PCM_IN */
PAD_NC(GPP_A10, NONE),
+ /* A11: M2_CPU_SSD_RST_N */
PAD_CFG_GPO(GPP_A11, 1, PLTRST),
+ /* A12: SATAGP_1 */
PAD_CFG_NF(GPP_A12, UP_20K, DEEP, NF1),
+ /* A13: Not Connected */
PAD_NC(GPP_A13, NONE),
+ /* A14: Not Connected */
PAD_CFG_GPO(GPP_A14, 0, PLTRST),
+ /* A15 Not Connected */
PAD_NC(GPP_A15, NONE),
+ /* A16: USB2_OCB_3 */
PAD_CFG_NF(GPP_A16, NONE, DEEP, NF1),
+ /* A17: Not Connected */
PAD_NC(GPP_A17, NONE),
+ /* A18: DDIB_HPD */
PAD_CFG_NF(GPP_A18, NONE, DEEP, NF1),
+ /* A19 Not Connected */
PAD_NC(GPP_A19, NONE),
+ /* A20: Not Connected */
PAD_NC(GPP_A20, NONE),
+ /* A21 Not Connected */
PAD_NC(GPP_A21, NONE),
+ /* A22: Not Connected */
PAD_NC(GPP_A22, NONE),
+ /* A23: TC_RETIMER_FORCE_PWR */
PAD_CFG_GPO(GPP_A23, 0, PLTRST),
+
+ /* B0: CORE_VID_0 */
PAD_CFG_NF(GPP_B0, NONE, DEEP, NF1),
+ /* B1: CORE_VID_1 */
PAD_CFG_NF(GPP_B1, NONE, DEEP, NF1),
+ /* B2: VRALERT_N */
PAD_NC(GPP_B2, NONE),
+ /* B3: Not Connected */
PAD_NC(GPP_B3, NONE),
+ /* B4: Not Connected */
PAD_NC(GPP_B4, NONE),
+ /* B5: Not Connected */
PAD_NC(GPP_B5, NONE),
+ /* B6: Not Connected */
PAD_NC(GPP_B6, NONE),
+ /* B7: Not Connected */
PAD_NC(GPP_B7, NONE),
+ /* B8: Not Connected */
PAD_NC(GPP_B8, NONE),
+ /* B9: PWR_MON_I2C_SDA_R */
PAD_CFG_NF(GPP_B9, NONE, DEEP, NF1),
+ /* B10: PWR_MON_I2C_SCL_R */
PAD_CFG_NF(GPP_B10, NONE, DEEP, NF1),
+ /* B11: I2C_PMC_PD_INT_N */
PAD_CFG_NF(GPP_B11, NONE, PWROK, NF1),
+ /* B12: PM_SLP_S0_N */
PAD_CFG_NF(GPP_B12, NONE, DEEP, NF1),
+ /* B13: PLT_RST_N */
PAD_CFG_NF(GPP_B13, NONE, DEEP, NF1),
+ /* B14: FPS_RST_N */
PAD_CFG_GPO(GPP_B14, 1, PLTRST),
+ /* B15: Not Connected */
PAD_NC(GPP_B15, NONE),
+ /* B16: M2_PCH_SSD_PWREN */
PAD_NC(GPP_B16, NONE),
+ /* B17: Not Connected */
PAD_CFG_GPO(GPP_B17, 0, PWROK),
+ /* B18: UF_CAM_STROBE */
PAD_CFG_GPO(GPP_B18, 0, DEEP),
+ /* B19: GSPI1_CS0_FPS_N */
PAD_NC(GPP_B19, NONE),
+ /* B20: GSPI1_CLK_FPS */
PAD_NC(GPP_B20, NONE),
+ /* B21: GSPI1_MISO_FPS */
PAD_NC(GPP_B21, NONE),
+ /* B22: GSPI1_MOSI_FPS */
PAD_CFG_GPO(GPP_B22, 0, DEEP),
+ /* B23: CPU_CLKFREQ */
PAD_CFG_GPO(GPP_B23, 0, DEEP),
+
+ /* C0: SMBCLK */
PAD_CFG_NF(GPP_C0, NONE, DEEP, NF1),
+ /* C1: SMBDATA */
PAD_CFG_NF(GPP_C1, NONE, DEEP, NF1),
+ /* C2: SMBALERT_N */
PAD_CFG_GPO(GPP_C2, 0, DEEP),
+ /* C3: SML0_CLK */
PAD_CFG_NF(GPP_C3, NONE, DEEP, NF1),
+ /* C4: SML0_DATA */
PAD_CFG_NF(GPP_C4, NONE, DEEP, NF1),
+ /* C5: SML0ALERT_IN */
PAD_CFG_GPO(GPP_C5, 0, DEEP),
+ /* C6: SML1_CLK */
PAD_CFG_NF(GPP_C6, NONE, PWROK, NF1),
+ /* C7: SML1_DATA */
PAD_CFG_NF(GPP_C7, NONE, PWROK, NF1),
+ /* C8: CLICK_PAD_INT_N */
PAD_CFG_NF(GPP_C8, NONE, DEEP, NF1),
+ /* C9: Not Connected */
PAD_NC(GPP_C9, NONE),
+ /* C10: Not Connected */
PAD_CFG_GPO(GPP_C10, 0, PWROK),
+ /* C11: Not Connected */
PAD_CFG_GPO(GPP_C11, 0, PWROK),
+ /* C12: Not Connected */
PAD_CFG_NF(GPP_C12, NONE, DEEP, NF1),
+ /* C13: Not Connected */
PAD_CFG_GPO(GPP_C13, 1, PLTRST),
+ /* C14: TPM_IRQ */
PAD_NC(GPP_C14, NONE),
+ /* C15: TPM_RST */
PAD_NC(GPP_C15, NONE),
+ /* C16: I2C0_SDA */
PAD_CFG_NF(GPP_C16, NONE, DEEP, NF1),
+ /* C17: I2C0_SCL */
PAD_CFG_NF(GPP_C17, NONE, DEEP, NF1),
+ /* C18: TOUCH_I2C_SDA */
PAD_CFG_NF(GPP_C18, NONE, DEEP, NF1),
+ /* C19: TOUCH_I2C_CLK */
PAD_CFG_NF(GPP_C19, NONE, DEEP, NF1),
+ /* C22: Not Connected */
PAD_NC(GPP_C22, NONE),
+ /* C23: WLAN_WAKE_N */
PAD_NC(GPP_C23, NONE),
+
+ /* D0: ACCEL1_INT */
PAD_NC(GPP_D0, NONE),
+ /* D1: ACCEL2_INT */
PAD_NC(GPP_D1, NONE),
+ /* D2: Not Connected */
PAD_CFG_GPI(GPP_D2, NONE, DEEP),
+ /* D3: Not Connected */
PAD_CFG_GPI(GPP_D3, NONE, DEEP),
+ /* D4: Not Connected */
PAD_NC(GPP_D4, NONE),
+ /* D5: CLKREQ0_M2_SSD_N */
PAD_CFG_NF(GPP_D5, NONE, DEEP, NF1),
+ /* D6: CLKREQ1_WLAN_N */
PAD_CFG_NF(GPP_D6, NONE, DEEP, NF1),
+ /* D7: LAN_CLKREQ# */
PAD_CFG_NF(GPP_D7, NONE, DEEP, NF1),
+ /* D8: Not Connected */
PAD_CFG_NF(GPP_D8, NONE, DEEP, NF1),
+ /* D9: Not Connected */
PAD_NC(GPP_D9, NATIVE),
+ /* D10: Not Connected */
PAD_NC(GPP_D10, NATIVE),
+ /* D11: Not Connected */
PAD_NC(GPP_D11, NATIVE),
+ /* D12: Not Connected */
PAD_NC(GPP_D12, NATIVE),
+ /* D13: Not Connected */
PAD_NC(GPP_D13, NONE),
+ /* D14: Not Connected */
PAD_NC(GPP_D14, NONE),
+ /* D15: Not Connected */
PAD_NC(GPP_D15, NONE),
+ /* D16: CPU_SSD_PWREN */
PAD_CFG_GPO(GPP_D16, 1, PLTRST),
+ /* D17: Not Connected */
PAD_CFG_GPI(GPP_D17, NONE, DEEP),
+ /* D18: Not Connected */
PAD_CFG_GPI(GPP_D18, NONE, DEEP),
+ /* D19: GPPC_D_19_WFCAM_PD_N */
PAD_CFG_TERM_GPO(GPP_D19, 1, UP_20K, DEEP),
+
+ /* E0: SATAXPCIE_0_SATAGP_0 */
PAD_NC(GPP_E0, NONE),
+ /* E1: Not Connected */
PAD_NC(GPP_E1, NONE),
+ /* E2: Not Connected */
PAD_NC(GPP_E2, NONE),
+ /* E3: FPS_INT */
PAD_CFG_NF(GPP_E3, NONE, DEEP, NF1),
+ /* E4: Not Connected */
PAD_NC(GPP_E4, NONE),
+ /* E5: Not Connected */
PAD_NC(GPP_E5, NONE),
+ /* E6: THC0_SPI1_RST_N_TCH_PNL */
PAD_NC(GPP_E6, NONE),
+ /* E7: EC_SMI_LP_N */
PAD_NC(GPP_E7, NONE),
+ /* E8: EC_SLP_S0IX_N */
PAD_NC(GPP_E8, NONE),
+ /* E9: USB2_TCP01_OC_N */
PAD_CFG_NF(GPP_E9, NONE, DEEP, NF1),
+ /* E10: SPI1_TCH_PNL_CS_N */
PAD_NC(GPP_E10, NONE),
+ /* E11: SPI1_CLK */
PAD_NC(GPP_E11, NONE),
+ /* E12: Not Connected */
PAD_NC(GPP_E12, NONE),
+ /* E13: Not Connected */
PAD_NC(GPP_E13, NONE),
+ /* E14: EDP_HPD */
PAD_CFG_NF(GPP_E14, NONE, DEEP, NF1),
+ /* E15: Not Connected */
PAD_CFG_NF(GPP_E15, NONE, DEEP, NF2),
+ /* E16: Not Connected */
PAD_CFG_NF(GPP_E16, NONE, DEEP, NF2),
+ /* E17: Not Connected */
PAD_NC(GPP_E17, NONE),
+ /* E18: TBT_LSX0_TXD */
PAD_NC(GPP_E18, NATIVE),
+ /* E19: TBT_LSX0_RXD */
PAD_NC(GPP_E19, NATIVE),
+ /* E20: Not Connected */
PAD_NC(GPP_E20, NATIVE),
+ /* E21: TBT_LSX1_RXD */
PAD_NC(GPP_E21, NATIVE),
+ /* E22: Not Connected */
PAD_CFG_NF(GPP_E22, DN_20K, DEEP, NF2),
+ /* E23: Not Connected */
PAD_CFG_GPO(GPP_E23, 0, DEEP),
+
+ /* F0: CNV_BRI_DT_BT_UART0_RTS_R */
PAD_CFG_NF(GPP_F0, NONE, DEEP, NF1),
+ /* F1: CNV_BRI_RSP_BT_UART0_RX_R */
PAD_CFG_NF(GPP_F1, UP_20K, DEEP, NF1),
+ /* F2: CNV_RGI_DT_BT_UART0_TX_R */
PAD_CFG_NF(GPP_F2, NONE, DEEP, NF1),
+ /* F3: CNV_RGI_RSP_BT_UART0_CTS */
PAD_CFG_NF(GPP_F3, UP_20K, DEEP, NF1),
+ /* F4: Not Connected */
PAD_CFG_NF(GPP_F4, NONE, DEEP, NF1),
+ /* F5: GPPC_F5_MODEM_CLKREQ */
PAD_CFG_NF(GPP_F5, NONE, DEEP, NF2),
+ /* F6: Not Connected */
PAD_NC(GPP_F6, NONE),
+ /* F7: BIOS_REC */
PAD_CFG_GPO(GPP_F7, 1, PLTRST),
+ /* F8: Not Connected */
PAD_NC(GPP_F8, NONE),
+ /* F9: Not Connected */
PAD_CFG_GPO(GPP_F9, 1, PLTRST),
+ /* F10: GPPC_F_10 */
PAD_CFG_GPO(GPP_F10, 0, DEEP),
+ /* F11: Not Connected */
PAD_NC(GPP_F11, NONE),
+ /* F12: Not Connected */
PAD_NC(GPP_F12, NONE),
+ /* F13: Not Connected */
PAD_NC(GPP_F13, NONE),
+ /* F14: Not Connected */
PAD_NC(GPP_F14, NONE),
+ /* F15: Not Connected */
PAD_NC(GPP_F15, NONE),
+ /* F16: Not Connected */
PAD_NC(GPP_F16, NONE),
+ /* F17: TOUCH_PANEL_RESET_N */
PAD_NC(GPP_F17, NONE),
+ /* F18: TOUCH_PANEL_INT_N */
PAD_NC(GPP_F18, NONE),
+ /* F19: Not Connected */
PAD_NC(GPP_F19, NONE),
+ /* F20: Not Connected */
PAD_CFG_NF(GPP_F20, NONE, DEEP, NF1),
+ /* F21: Not Connected */
PAD_CFG_NF(GPP_F21, NONE, DEEP, NF1),
+ /* F22: Not Connected */
PAD_NC(GPP_F22, NONE),
+ /* F23: Not Connected */
PAD_NC(GPP_F23, NONE),
+
+ /* H0: GPPC_H0_M2_SSD_RST_N */
PAD_CFG_GPO(GPP_H0, 0, DEEP),
+ /* H1: GPPC_H_1 */
PAD_CFG_GPO(GPP_H1, 0, DEEP),
+ /* H2: GPPC_H_2 */
PAD_CFG_GPO(GPP_H2, 0, DEEP),
+ /* H3: Not Connected */
PAD_NC(GPP_H3, NONE),
+ /* H4: GSENSOR_I2C_SDA */
PAD_CFG_NF(GPP_H4, NONE, DEEP, NF1),
+ /* H5: GSENSOR_I2C_SCL */
PAD_CFG_NF(GPP_H5, NONE, DEEP, NF1),
+ /* H6: Not Connected */
PAD_CFG_NF(GPP_H6, NONE, DEEP, NF1),
+ /* H7: Not Connected */
PAD_CFG_NF(GPP_H7, NONE, DEEP, NF1),
+ /* H8: Not Connected */
PAD_CFG_NF(GPP_H8, NONE, DEEP, NF1),
+ /* H9: Not Connected */
PAD_CFG_NF(GPP_H9, NONE, DEEP, NF1),
+ /* H10: Not Connected */
PAD_NC(GPP_H10, NONE),
+ /* H11: Not Connected */
PAD_NC(GPP_H11, NONE),
+ /* H12: Not Connected */
PAD_NC(GPP_H12, NONE),
+ /* H13: Not Connected */
PAD_NC(GPP_H13, NONE),
+ /* H14: Not Connected */
PAD_CFG_GPO(GPP_H14, 1, PLTRST),
+ /* H15: Not Connected */
PAD_NC(GPP_H15, NONE),
+ /* H16: DDIB_DDC_SCL */
PAD_CFG_NF(GPP_H16, NONE, DEEP, NF1),
+ /* H17: DDIB_DDC_SDA */
PAD_CFG_NF(GPP_H17, NONE, DEEP, NF1),
+ /* H18: CPU_C10_GATE_N */
PAD_CFG_NF(GPP_H18, NONE, DEEP, NF1),
+ /* H19: UART_BT_WAKE_N */
PAD_NC(GPP_H19, NONE),
+ /* H20: Not Connected */
PAD_NC(GPP_H20, NONE),
+ /* H21: Not Connected */
PAD_NC(GPP_H21, NONE),
+ /* H22: Not Connected */
PAD_NC(GPP_H22, NONE),
+ /* H23: Not Connected */
PAD_CFG_GPO(GPP_H23, 0, DEEP),
+
+ /* R0: HDA_BCLK */
PAD_CFG_NF(GPP_R0, NONE, DEEP, NF1),
+ /* R1: HDA_SYNC */
PAD_CFG_NF(GPP_R1, NATIVE, DEEP, NF1),
+ /* R2: HDA_SDO */
PAD_CFG_NF(GPP_R2, NATIVE, DEEP, NF1),
+ /* R3: HDA_SDI_0_SSP0_RXD */
PAD_CFG_NF(GPP_R3, NATIVE, DEEP, NF1),
+ /* R4: Not Connected */
PAD_CFG_NF(GPP_R4, NONE, DEEP, NF1),
+ /* R5: Not Connected */
PAD_CFG_GPO(GPP_R5, 0, PLTRST),
+ /* R6: Not Connected */
PAD_CFG_GPO(GPP_R6, 1, PLTRST),
+ /* R7: Not Connected */
PAD_NC(GPP_R7, NONE),
+
+ /* S0: Not Connected */
PAD_NC(GPP_S0, NONE),
+ /* S1: Not Connected */
PAD_NC(GPP_S1, NONE),
+ /* S2: Not Connected */
PAD_NC(GPP_S2, NONE),
+ /* S3: Not Connected */
PAD_NC(GPP_S3, NONE),
+ /* S4: Not Connected */
PAD_NC(GPP_S4, NONE),
+ /* S5: Not Connected */
PAD_NC(GPP_S5, NONE),
+ /* S6: Not Connected */
PAD_NC(GPP_S6, NONE),
+ /* S7: Not Connected */
PAD_NC(GPP_S7, NONE),
+
+ /* T2: Not Connected */
PAD_CFG_NF(GPP_T2, DN_20K, DEEP, NF2),
+ /* T3: Not Connected */
PAD_CFG_NF(GPP_T3, DN_20K, DEEP, NF2),
+
+ /* U4: Not Connected */
PAD_NC(GPP_U4, NONE),
+ /* U5: Not Connected */
PAD_NC(GPP_U5, NONE),
};