summaryrefslogtreecommitdiffstats
path: root/src/soc/intel/fsp_broadwell_de/include/soc/gpio.h
blob: 1159d03910d71e7e32e2e7dab3ee92fe80f2d0f9 (plain)
1
2
3
4
5
6
7
8
9
10
11
12
13
14
15
16
17
18
19
20
21
22
23
24
25
26
27
28
29
30
31
32
33
34
35
36
37
38
39
40
41
42
43
44
45
46
47
48
49
50
51
52
53
54
55
56
57
58
59
60
61
62
63
64
65
66
67
68
69
70
71
72
73
74
75
76
77
78
79
80
81
82
83
84
85
86
87
88
89
90
91
92
93
94
95
96
97
98
99
100
101
102
103
104
105
106
107
108
109
110
111
112
113
114
115
116
117
118
119
120
121
122
123
124
125
126
127
128
129
/*
 * This file is part of the coreboot project.
 *
 * Copyright (C) 2017 Siemens AG
 *
 * This program is free software; you can redistribute it and/or modify
 * it under the terms of the GNU General Public License as published by
 * the Free Software Foundation; version 2 of the License.
 *
 * This program is distributed in the hope that it will be useful,
 * but WITHOUT ANY WARRANTY; without even the implied warranty of
 * MERCHANTABILITY or FITNESS FOR A PARTICULAR PURPOSE.  See the
 * GNU General Public License for more details.
 */
#ifndef FSP_BROADWELL_DE_GPIO_H_
#define FSP_BROADWELL_DE_GPIO_H_

#include <stdint.h>

/* Chipset owned GPIO configuration registers */
#define GPIO_1_USE_SEL		0x00
#define GPIO_1_IO_SEL		0x04
#define GPIO_1_LVL		0x0c
#define GPIO_1_BLINK		0x18
#define GPIO_1_NMI_EN		0x28
#define GPIO_1_INVERT		0x2c
#define GPIO_2_USE_SEL		0x30
#define GPIO_2_IO_SEL		0x34
#define GPIO_2_LVL		0x38
#define GPIO_2_NMI_EN		0x3c
#define GPIO_3_USE_SEL		0x40
#define GPIO_3_IO_SEL		0x44
#define GPIO_3_LVL		0x48
#define GPIO_3_NMI_EN		0x50
#define REG_INVALID		0xff

/* The pin can either be a GPIO or connected to the native function. */
#define GPIO_MODE_NATIVE	0
#define GPIO_MODE_GPIO		1
/* Once configured as GPIO the pin can be an input or an output. */
#define GPIO_OUTPUT		0
#define GPIO_INPUT		1
#define GPIO_NMI_EN		1
/* For output GPIO mode the pin can either drive high or low level. */
#define GPIO_OUT_LEVEL_LOW	0
#define GPIO_OUT_LEVEL_HIGH	1
/* The following functions are only valid for GPIO bank 1. */
#define GPIO_OUT_BLINK		1
#define GPIO_IN_INVERT		1

#define GPIO_NUM_BANKS		3
#define MAX_GPIO_NUM		75	/* 0 based GPIO number */
#define GPIO_LIST_END		0xff

/* Define possible GPIO configurations. */
#define PCH_GPIO_END \
	{ .use_sel = GPIO_LIST_END }

#define PCH_GPIO_NATIVE(gpio) { \
	 .num = (gpio), \
	 .use_sel = GPIO_MODE_NATIVE }

#define PCH_GPIO_INPUT(gpio) { \
	.num = (gpio), \
	.use_sel = GPIO_MODE_GPIO, \
	.io_sel = GPIO_INPUT }

#define PCH_GPIO_INPUT_INVERT(gpio) { \
	.num = (gpio), \
	.use_sel = GPIO_MODE_GPIO, \
	.io_sel = GPIO_INPUT, \
	.invert_input = GPIO_IN_INVERT }

#define PCH_GPIO_INPUT_NMI(gpio) { \
	.num = (gpio), \
	.use_sel = GPIO_MODE_GPIO, \
	.io_sel = GPIO_INPUT, \
	.nmi_en = GPIO_NMI_EN }

#define PCH_GPIO_OUT_LOW(gpio) { \
	.num = (gpio), \
	.use_sel = GPIO_MODE_GPIO, \
	.io_sel = GPIO_OUTPUT, \
	.level = GPIO_OUT_LEVEL_LOW }

#define PCH_GPIO_OUT_HIGH(gpio) { \
	.num = (gpio), \
	.use_sel = GPIO_MODE_GPIO, \
	.io_sel = GPIO_OUTPUT, \
	.level = GPIO_OUT_LEVEL_HIGH }

#define PCH_GPIO_OUT_BLINK(gpio) { \
	.num = (gpio), \
	.use_sel = GPIO_MODE_GPIO, \
	.io_sel = GPIO_OUTPUT, \
	.blink_en = GPIO_OUT_BLINK }

struct gpio_config {
	uint8_t num;
	uint8_t use_sel;
	uint8_t io_sel;
	uint8_t level;
	uint8_t blink_en;
	uint8_t nmi_en;
	uint8_t invert_input;
} __packed;

/* Unfortunately the register layout is not linear between different GPIO banks.
 * In addition not every bank has all the functions so that some registers might
 * be missing on a particular bank. To make the code better readable introduce a
 * wrapper structure for the register addresses for every bank.
 */
struct gpio_config_regs {
	uint8_t use_sel;
	uint8_t io_sel;
	uint8_t level;
	uint8_t nmi_en;
	uint8_t blink_en;
	uint8_t invert_input;
};

/* Define gpio_t here to be able to use src/include/gpio.h for gpio_set() and
   gpio_get().*/
typedef uint8_t gpio_t;

/* Configure GPIOs with mainboard provided settings */
void init_gpios(const struct gpio_config config[]);

#endif /* FSP_BROADWELL_DE_GPIO_H_ */