1#ifndef __LINUX_GPIO_MACHINE_H
2#define __LINUX_GPIO_MACHINE_H
3
4#include <linux/types.h>
5#include <linux/list.h>
6
7enum gpio_lookup_flags {
8	GPIO_ACTIVE_HIGH = (0 << 0),
9	GPIO_ACTIVE_LOW = (1 << 0),
10	GPIO_OPEN_DRAIN = (1 << 1),
11	GPIO_OPEN_SOURCE = (1 << 2),
12};
13
14/**
15 * struct gpiod_lookup - lookup table
16 * @chip_label: name of the chip the GPIO belongs to
17 * @chip_hwnum: hardware number (i.e. relative to the chip) of the GPIO
18 * @con_id: name of the GPIO from the device's point of view
19 * @idx: index of the GPIO in case several GPIOs share the same name
20 * @flags: mask of GPIO_* values
21 *
22 * gpiod_lookup is a lookup table for associating GPIOs to specific devices and
23 * functions using platform data.
24 */
25struct gpiod_lookup {
26	const char *chip_label;
27	u16 chip_hwnum;
28	const char *con_id;
29	unsigned int idx;
30	enum gpio_lookup_flags flags;
31};
32
33struct gpiod_lookup_table {
34	struct list_head list;
35	const char *dev_id;
36	struct gpiod_lookup table[];
37};
38
39/*
40 * Simple definition of a single GPIO under a con_id
41 */
42#define GPIO_LOOKUP(_chip_label, _chip_hwnum, _con_id, _flags) \
43	GPIO_LOOKUP_IDX(_chip_label, _chip_hwnum, _con_id, 0, _flags)
44
45/*
46 * Use this macro if you need to have several GPIOs under the same con_id.
47 * Each GPIO needs to use a different index and can be accessed using
48 * gpiod_get_index()
49 */
50#define GPIO_LOOKUP_IDX(_chip_label, _chip_hwnum, _con_id, _idx, _flags)  \
51{                                                                         \
52	.chip_label = _chip_label,                                        \
53	.chip_hwnum = _chip_hwnum,                                        \
54	.con_id = _con_id,                                                \
55	.idx = _idx,                                                      \
56	.flags = _flags,                                                  \
57}
58
59void gpiod_add_lookup_table(struct gpiod_lookup_table *table);
60
61#endif /* __LINUX_GPIO_MACHINE_H */
62