1 /* SPDX-License-Identifier: GPL-2.0 */
2 /*
3 * Copyright 2008 Openmoko, Inc.
4 * Copyright 2008 Simtec Electronics
5 * http://armlinux.simtec.co.uk/
6 * Ben Dooks <ben@simtec.co.uk>
7 *
8 * Samsung Platform - GPIO pin configuration helper definitions
9 */
10
11 /* This is meant for core cpu support, machine or other driver files
12 * should not be including this header.
13 */
14
15 #ifndef __PLAT_GPIO_CFG_HELPERS_H
16 #define __PLAT_GPIO_CFG_HELPERS_H __FILE__
17
18 /* As a note, all gpio configuration functions are entered exclusively, either
19 * with the relevant lock held or the system prevented from doing anything else
20 * by disabling interrupts.
21 */
22
23 static inline int samsung_gpio_do_setcfg(struct samsung_gpio_chip *chip,
24 unsigned int off, unsigned int config)
25 {
26 return (chip->config->set_config)(chip, off, config);
27 }
28
29 static inline unsigned samsung_gpio_do_getcfg(struct samsung_gpio_chip *chip,
30 unsigned int off)
31 {
32 return (chip->config->get_config)(chip, off);
33 }
34
35 static inline int samsung_gpio_do_setpull(struct samsung_gpio_chip *chip,
36 unsigned int off, samsung_gpio_pull_t pull)
37 {
38 return (chip->config->set_pull)(chip, off, pull);
39 }
40
41 static inline samsung_gpio_pull_t samsung_gpio_do_getpull(struct samsung_gpio_chip *chip,
42 unsigned int off)
43 {
44 return chip->config->get_pull(chip, off);
45 }
46
47 /* Pull-{up,down} resistor controls.
48 *
49 * S3C2410,S3C2440 = Pull-UP,
50 * S3C2412,S3C2413 = Pull-Down
51 * S3C6400,S3C6410 = Pull-Both [None,Down,Up,Undef]
52 * S3C2443 = Pull-Both [not same as S3C6400]
53 */
54
55 /**
56 * s3c24xx_gpio_setpull_1up() - Pull configuration for choice of up or none.
57 * @chip: The gpio chip that is being configured.
58 * @off: The offset for the GPIO being configured.
59 * @param: pull: The pull mode being requested.
60 *
61 * This is a helper function for the case where we have GPIOs with one
62 * bit configuring the presence of a pull-up resistor.
63 */
64 extern int s3c24xx_gpio_setpull_1up(struct samsung_gpio_chip *chip,
65 unsigned int off, samsung_gpio_pull_t pull);
66
67 /**
68 * s3c24xx_gpio_setpull_1down() - Pull configuration for choice of down or none
69 * @chip: The gpio chip that is being configured
70 * @off: The offset for the GPIO being configured
71 * @param: pull: The pull mode being requested
72 *
73 * This is a helper function for the case where we have GPIOs with one
74 * bit configuring the presence of a pull-down resistor.
75 */
76 extern int s3c24xx_gpio_setpull_1down(struct samsung_gpio_chip *chip,
77 unsigned int off, samsung_gpio_pull_t pull);
78
79 /**
80 * samsung_gpio_setpull_upown() - Pull configuration for choice of up,
81 * down or none
82 *
83 * @chip: The gpio chip that is being configured.
84 * @off: The offset for the GPIO being configured.
85 * @param: pull: The pull mode being requested.
86 *
87 * This is a helper function for the case where we have GPIOs with two
88 * bits configuring the presence of a pull resistor, in the following
89 * order:
90 * 00 = No pull resistor connected
91 * 01 = Pull-up resistor connected
92 * 10 = Pull-down resistor connected
93 */
94 extern int samsung_gpio_setpull_updown(struct samsung_gpio_chip *chip,
95 unsigned int off, samsung_gpio_pull_t pull);
96
97 /**
98 * samsung_gpio_getpull_updown() - Get configuration for choice of up,
99 * down or none
100 *
101 * @chip: The gpio chip that the GPIO pin belongs to
102 * @off: The offset to the pin to get the configuration of.
103 *
104 * This helper function reads the state of the pull-{up,down} resistor
105 * for the given GPIO in the same case as samsung_gpio_setpull_upown.
106 */
107 extern samsung_gpio_pull_t samsung_gpio_getpull_updown(struct samsung_gpio_chip *chip,
108 unsigned int off);
109
110 /**
111 * s3c24xx_gpio_getpull_1up() - Get configuration for choice of up or none
112 * @chip: The gpio chip that the GPIO pin belongs to
113 * @off: The offset to the pin to get the configuration of.
114 *
115 * This helper function reads the state of the pull-up resistor for the
116 * given GPIO in the same case as s3c24xx_gpio_setpull_1up.
117 */
118 extern samsung_gpio_pull_t s3c24xx_gpio_getpull_1up(struct samsung_gpio_chip *chip,
119 unsigned int off);
120
121 /**
122 * s3c24xx_gpio_getpull_1down() - Get configuration for choice of down or none
123 * @chip: The gpio chip that the GPIO pin belongs to
124 * @off: The offset to the pin to get the configuration of.
125 *
126 * This helper function reads the state of the pull-down resistor for the
127 * given GPIO in the same case as s3c24xx_gpio_setpull_1down.
128 */
129 extern samsung_gpio_pull_t s3c24xx_gpio_getpull_1down(struct samsung_gpio_chip *chip,
130 unsigned int off);
131
132 /**
133 * s3c2443_gpio_setpull() - Pull configuration for s3c2443.
134 * @chip: The gpio chip that is being configured.
135 * @off: The offset for the GPIO being configured.
136 * @param: pull: The pull mode being requested.
137 *
138 * This is a helper function for the case where we have GPIOs with two
139 * bits configuring the presence of a pull resistor, in the following
140 * order:
141 * 00 = Pull-up resistor connected
142 * 10 = Pull-down resistor connected
143 * x1 = No pull up resistor
144 */
145 extern int s3c2443_gpio_setpull(struct samsung_gpio_chip *chip,
146 unsigned int off, samsung_gpio_pull_t pull);
147
148 /**
149 * s3c2443_gpio_getpull() - Get configuration for s3c2443 pull resistors
150 * @chip: The gpio chip that the GPIO pin belongs to.
151 * @off: The offset to the pin to get the configuration of.
152 *
153 * This helper function reads the state of the pull-{up,down} resistor for the
154 * given GPIO in the same case as samsung_gpio_setpull_upown.
155 */
156 extern samsung_gpio_pull_t s3c2443_gpio_getpull(struct samsung_gpio_chip *chip,
157 unsigned int off);
158
159 #endif /* __PLAT_GPIO_CFG_HELPERS_H */