summaryrefslogtreecommitdiffstats
path: root/drivers/gpio/gpio-i8255.h
blob: 3daa0b1458908b90bc4109bf6e3bccaccd531138 (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
/* SPDX-License-Identifier: GPL-2.0 */
/* Copyright 2022 William Breathitt Gray */
#ifndef _I8255_H_
#define _I8255_H_

#include <linux/spinlock.h>
#include <linux/types.h>

/**
 * struct i8255 - Intel 8255 register structure
 * @port:	Port A, B, and C
 * @control:	Control register
 */
struct i8255 {
	u8 port[3];
	u8 control;
};

/**
 * struct i8255_state - Intel 8255 state structure
 * @lock:		synchronization lock for accessing device state
 * @control_state:	Control register state
 */
struct i8255_state {
	spinlock_t lock;
	u8 control_state;
};

struct device;
struct irq_domain;
struct regmap;

#define i8255_volatile_regmap_range(_base) regmap_reg_range(_base, _base + 0x2)

/**
 * struct i8255_regmap_config - Configuration for the register map of an i8255
 * @parent:	parent device
 * @map:	regmap for the i8255
 * @num_ppi:	number of i8255 Programmable Peripheral Interface
 * @names:	(optional) array of names for gpios
 * @domain:	(optional) IRQ domain if the controller is interrupt-capable
 *
 * Note: The regmap is expected to have cache enabled and i8255 control
 * registers not marked as volatile.
 */
struct i8255_regmap_config {
	struct device *parent;
	struct regmap *map;
	int num_ppi;
	const char *const *names;
	struct irq_domain *domain;
};

int devm_i8255_regmap_register(struct device *dev,
			       const struct i8255_regmap_config *config);

void i8255_direction_input(struct i8255 __iomem *ppi, struct i8255_state *state,
			   unsigned long offset);
void i8255_direction_output(struct i8255 __iomem *ppi,
			    struct i8255_state *state, unsigned long offset,
			    unsigned long value);
int i8255_get(struct i8255 __iomem *ppi, unsigned long offset);
int i8255_get_direction(const struct i8255_state *state, unsigned long offset);
void i8255_get_multiple(struct i8255 __iomem *ppi, const unsigned long *mask,
			unsigned long *bits, unsigned long ngpio);
void i8255_mode0_output(struct i8255 __iomem *const ppi);
void i8255_set(struct i8255 __iomem *ppi, struct i8255_state *state,
	       unsigned long offset, unsigned long value);
void i8255_set_multiple(struct i8255 __iomem *ppi, struct i8255_state *state,
			const unsigned long *mask, const unsigned long *bits,
			unsigned long ngpio);
void i8255_state_init(struct i8255_state *const state, unsigned long nbanks);

#endif /* _I8255_H_ */