coreboot
coreboot is an Open Source project aimed at replacing the proprietary BIOS found in most computers.
gpio.c
Go to the documentation of this file.
1 /* SPDX-License-Identifier: GPL-2.0-only */
2 
3 #include <acpi/acpi.h>
4 #include <baseboard/gpio.h>
5 #include <baseboard/variants.h>
6 #include <commonlib/helpers.h>
7 
8 static const struct pad_config gpio_table[] = {
9  /* A8 : PEN_GARAGE_DET_L (wake) */
10  PAD_CFG_GPI_SCI(GPP_A8, NONE, DEEP, EDGE_SINGLE, NONE),
11  /* A11 : PCH_SPI_FPMCU_CS_L */
12  PAD_CFG_NF(GPP_A11, NONE, DEEP, NF2),
13  /* A12 : FPMCU_RST_ODL */
14  PAD_CFG_GPO(GPP_A12, 0, DEEP),
15  /* A16 : EMR_GARAGE_DET (notification) */
17  /* A17 : PIRQA# ==> NC */
19  /* A18 : ISH_GP0 ==> NC */
21  /* A19 : PEN_RESET_ODL */
22  PAD_CFG_GPO(GPP_A19, 0, DEEP),
23  /* A20 : ISH_GP2 ==> NC */
25  /* A22 : ISH_GP4 ==> NC */
27  /* B8 : SRCCLKREQ3#: NC */
28  PAD_NC(GPP_B8, NONE),
29  /* C1 : SMBDATA: NC */
30  PAD_NC(GPP_C1, NONE),
31  /* C7 : PEN_IRQ_OD_L */
32  PAD_CFG_GPI_APIC(GPP_C7, NONE, PLTRST, LEVEL, INVERT),
33  /* C12 : EN_PP3300_TSP_DX */
34  PAD_CFG_GPO(GPP_C12, 0, DEEP),
35  /* C13 : EC_PCH_INT_L - needs to wake the system */
36  PAD_CFG_GPI_IRQ_WAKE(GPP_C13, NONE, PLTRST, LEVEL, INVERT),
37  /* C15 : EN_PP3300_DIG_DX */
38  PAD_CFG_GPO(GPP_C15, 0, DEEP),
39  /* C23 : UART2_CTS# ==> NC */
41  /* D16 : TOUCHSCREEN_INT_L */
42  PAD_CFG_GPI_APIC(GPP_D16, NONE, PLTRST, LEVEL, INVERT),
43  /* E23 : GPP_E23 ==> NC */
45  /* F1 : GPP_F1 ==> NC */
46  PAD_NC(GPP_F1, NONE),
47  /* F11 : PCH_MEM_STRAP_2 */
48  PAD_CFG_GPI(GPP_F11, NONE, PLTRST),
49  /* F20 : PCH_MEM_STRAP_0 */
50  PAD_CFG_GPI(GPP_F20, NONE, PLTRST),
51  /* F21 : PCH_MEM_STRAP_1 */
52  PAD_CFG_GPI(GPP_F21, NONE, PLTRST),
53  /* F22 : PCH_MEM_STRAP_3 */
54  PAD_CFG_GPI(GPP_F22, NONE, PLTRST),
55  /* G0 : GPP_G0 ==> NC */
56  PAD_NC(GPP_G0, NONE),
57  /* G1 : GPP_G1 ==> NC */
58  PAD_NC(GPP_G1, NONE),
59  /* G2 : GPP_G2 ==> NC */
60  PAD_NC(GPP_G2, NONE),
61  /* G3 : GPP_G3 ==> NC */
62  PAD_NC(GPP_G3, NONE),
63  /* G4 : GPP_G4 ==> NC */
64  PAD_NC(GPP_G4, NONE),
65  /* G5 : GPP_G5 ==> NC */
66  PAD_NC(GPP_G5, NONE),
67  /* G6 : GPP_G6 ==> NC */
68  PAD_NC(GPP_G6, NONE),
69  /* H3 : SPKR_PA_EN */
70  PAD_CFG_GPO(GPP_H3, 0, DEEP),
71  /* H4 : PCH_I2C_PEN_SDA */
72  PAD_CFG_NF(GPP_H4, NONE, DEEP, NF1),
73  /* H5 : PCH_I2C_PEN_SCL */
74  PAD_CFG_NF(GPP_H5, NONE, DEEP, NF1),
75 };
76 
77 const struct pad_config *override_gpio_table(size_t *num)
78 {
79  *num = ARRAY_SIZE(gpio_table);
80  return gpio_table;
81 }
82 
83 /*
84  * GPIOs configured before ramstage
85  * Note: the Hatch platform's romstage will configure
86  * the MEM_STRAP_* (a.k.a GPIO_MEM_CONFIG_*) pins
87  * as inputs before it reads them, so they are not
88  * needed in this table.
89  */
90 static const struct pad_config early_gpio_table[] = {
91  /* B15 : H1_SLAVE_SPI_CS_L */
92  PAD_CFG_NF(GPP_B15, NONE, DEEP, NF1),
93  /* B16 : H1_SLAVE_SPI_CLK */
94  PAD_CFG_NF(GPP_B16, NONE, DEEP, NF1),
95  /* B17 : H1_SLAVE_SPI_MISO_R */
96  PAD_CFG_NF(GPP_B17, NONE, DEEP, NF1),
97  /* B18 : H1_SLAVE_SPI_MOSI_R */
98  PAD_CFG_NF(GPP_B18, NONE, DEEP, NF1),
99  /* C8 : UART_PCH_RX_DEBUG_TX */
100  PAD_CFG_NF(GPP_C8, NONE, DEEP, NF1),
101  /* C9 : UART_PCH_TX_DEBUG_RX */
102  PAD_CFG_NF(GPP_C9, NONE, DEEP, NF1),
103  /* C14 : BT_DISABLE_L */
104  PAD_CFG_GPO(GPP_C14, 0, DEEP),
105  /* PCH_WP_OD */
106  PAD_CFG_GPI(GPP_C20, NONE, DEEP),
107  /* C21 : H1_PCH_INT_ODL */
108  PAD_CFG_GPI_APIC(GPP_C21, NONE, PLTRST, LEVEL, INVERT),
109  /* C22 : EC_IN_RW_OD */
110  PAD_CFG_GPI(GPP_C22, NONE, DEEP),
111  /* E1 : M2_SSD_PEDET */
112  PAD_CFG_NF(GPP_E1, NONE, DEEP, NF1),
113  /* E5 : SATA_DEVSLP1 */
114  PAD_CFG_NF(GPP_E5, NONE, PLTRST, NF1),
115  /* F2 : MEM_CH_SEL */
116  PAD_CFG_GPI(GPP_F2, NONE, PLTRST),
117  /* F11 : PCH_MEM_STRAP2 */
118  PAD_CFG_GPI(GPP_F11, NONE, PLTRST),
119  /* F20 : PCH_MEM_STRAP0 */
120  PAD_CFG_GPI(GPP_F20, NONE, PLTRST),
121  /* F21 : PCH_MEM_STRAP1 */
122  PAD_CFG_GPI(GPP_F21, NONE, PLTRST),
123  /* F22 : PCH_MEM_STRAP3 */
124  PAD_CFG_GPI(GPP_F22, NONE, PLTRST),
125 };
126 
127 const struct pad_config *variant_early_gpio_table(size_t *num)
128 {
130  return early_gpio_table;
131 }
132 
133 /*
134  * Default GPIO settings before entering non-S5 sleep states.
135  * Configure A12: FPMCU_RST_ODL as GPO before entering sleep.
136  * This guarantees that A12's native3 function is disabled.
137  * See https://review.coreboot.org/c/coreboot/+/32111 .
138  */
139 static const struct pad_config default_sleep_gpio_table[] = {
140  PAD_CFG_GPO(GPP_A12, 1, DEEP), /* FPMCU_RST_ODL */
141 };
142 
143 /*
144  * GPIO settings before entering S5, which are same as
145  * default_sleep_gpio_table but also, turn off FPMCU.
146  */
147 static const struct pad_config s5_sleep_gpio_table[] = {
148  PAD_CFG_GPO(GPP_A12, 0, DEEP), /* FPMCU_RST_ODL */
149  PAD_CFG_GPO(GPP_C11, 0, DEEP), /* PCH_FP_PWR_EN */
150 };
151 
152 const struct pad_config *variant_sleep_gpio_table(u8 slp_typ, size_t *num)
153 {
154  if (slp_typ == ACPI_S5) {
156  return s5_sleep_gpio_table;
157  }
160 }
#define GPP_C15
#define GPP_A18
#define GPP_F21
#define GPP_C12
#define GPP_F20
#define GPP_B16
Definition: gpio_soc_defs.h:69
#define GPP_A19
#define GPP_C9
#define GPP_C22
#define GPP_B15
Definition: gpio_soc_defs.h:68
#define GPP_C23
#define GPP_C8
#define GPP_C11
#define GPP_C13
#define GPP_E23
#define GPP_E5
#define GPP_B8
Definition: gpio_soc_defs.h:61
#define GPP_C20
#define GPP_A20
#define GPP_A16
#define GPP_F1
#define GPP_A12
#define GPP_H5
#define GPP_C21
#define GPP_H3
#define GPP_A8
#define GPP_B18
Definition: gpio_soc_defs.h:71
#define GPP_A11
#define GPP_C14
#define GPP_C1
#define GPP_F2
#define GPP_A22
#define GPP_F22
#define GPP_F11
#define GPP_D16
#define GPP_A17
#define GPP_B17
Definition: gpio_soc_defs.h:70
#define GPP_E1
#define GPP_H4
#define GPP_C7
#define ARRAY_SIZE(a)
Definition: helpers.h:12
#define GPP_G1
Definition: gpio_soc_defs.h:89
#define GPP_G4
Definition: gpio_soc_defs.h:92
#define GPP_G2
Definition: gpio_soc_defs.h:90
#define GPP_G6
Definition: gpio_soc_defs.h:94
#define GPP_G0
Definition: gpio_soc_defs.h:88
#define GPP_G3
Definition: gpio_soc_defs.h:91
#define GPP_G5
Definition: gpio_soc_defs.h:93
@ ACPI_S5
Definition: acpi.h:1385
const struct pad_config * variant_early_gpio_table(size_t *num)
Definition: gpio.c:204
const struct pad_config *__weak variant_sleep_gpio_table(size_t *num)
Definition: gpio.c:466
const struct pad_config * override_gpio_table(size_t *num)
Definition: gpio.c:124
static const struct pad_config default_sleep_gpio_table[]
Definition: gpio.c:139
static const struct pad_config gpio_table[]
Definition: gpio.c:8
static const struct pad_config s5_sleep_gpio_table[]
Definition: gpio.c:147
static const struct pad_config early_gpio_table[]
Definition: gpio.c:90
#define PAD_NC(pin)
Definition: gpio_defs.h:263
#define PAD_CFG_GPI(pad, pull, rst)
Definition: gpio_defs.h:284
#define PAD_CFG_NF(pad, pull, rst, func)
Definition: gpio_defs.h:197
#define PAD_CFG_GPI_APIC(pad, pull, rst, trig, inv)
Definition: gpio_defs.h:376
#define PAD_CFG_GPO(pad, val, rst)
Definition: gpio_defs.h:247
#define PAD_CFG_GPI_SCI(pad, pull, rst, trig, inv)
Definition: gpio_defs.h:432
#define PAD_CFG_GPI_GPIO_DRIVER(pad, pull, rst)
Definition: gpio_defs.h:323
uint8_t u8
Definition: stdint.h:45