1/* $NetBSD: gpio.h,v 1.15 2015/11/21 09:06:03 mlelstv Exp $ */
2/* $OpenBSD: gpio.h,v 1.7 2008/11/26 14:51:20 mbalmer Exp $ */
3/*
4 * Copyright (c) 2009, 2011 Marc Balmer <marc@msys.ch>
5 * Copyright (c) 2004 Alexander Yurchenko <grange@openbsd.org>
6 *
7 * Permission to use, copy, modify, and distribute this software for any
8 * purpose with or without fee is hereby granted, provided that the above
9 * copyright notice and this permission notice appear in all copies.
10 *
11 * THE SOFTWARE IS PROVIDED "AS IS" AND THE AUTHOR DISCLAIMS ALL WARRANTIES
12 * WITH REGARD TO THIS SOFTWARE INCLUDING ALL IMPLIED WARRANTIES OF
13 * MERCHANTABILITY AND FITNESS. IN NO EVENT SHALL THE AUTHOR BE LIABLE FOR
14 * ANY SPECIAL, DIRECT, INDIRECT, OR CONSEQUENTIAL DAMAGES OR ANY DAMAGES
15 * WHATSOEVER RESULTING FROM LOSS OF USE, DATA OR PROFITS, WHETHER IN AN
16 * ACTION OF CONTRACT, NEGLIGENCE OR OTHER TORTIOUS ACTION, ARISING OUT OF
17 * OR IN CONNECTION WITH THE USE OR PERFORMANCE OF THIS SOFTWARE.
18 */
19
20#ifndef _SYS_GPIO_H_
21#define _SYS_GPIO_H_
22
23#include <sys/ioccom.h>
24#include <sys/time.h>
25
26/* GPIO pin states */
27#define GPIO_PIN_LOW 0x00 /* low level (logical 0) */
28#define GPIO_PIN_HIGH 0x01 /* high level (logical 1) */
29
30/* Max name length of a pin */
31#define GPIOMAXNAME 64
32
33/* GPIO pin configuration flags */
34#define GPIO_PIN_INPUT 0x00000001 /* input direction */
35#define GPIO_PIN_OUTPUT 0x00000002 /* output direction */
36#define GPIO_PIN_INOUT 0x00000004 /* bi-directional */
37#define GPIO_PIN_OPENDRAIN 0x00000008 /* open-drain output */
38#define GPIO_PIN_PUSHPULL 0x00000010 /* push-pull output */
39#define GPIO_PIN_TRISTATE 0x00000020 /* output disabled */
40#define GPIO_PIN_PULLUP 0x00000040 /* internal pull-up enabled */
41#define GPIO_PIN_PULLDOWN 0x00000080 /* internal pull-down enabled */
42#define GPIO_PIN_INVIN 0x00000100 /* invert input */
43#define GPIO_PIN_INVOUT 0x00000200 /* invert output */
44#define GPIO_PIN_USER 0x00000400 /* user != 0 can access */
45#define GPIO_PIN_PULSATE 0x00000800 /* pulsate in hardware */
46#define GPIO_PIN_SET 0x00008000 /* set for securelevel access */
47#define GPIO_PIN_ALT0 0x00010000 /* alternate function 0 */
48#define GPIO_PIN_ALT1 0x00020000 /* alternate function 1 */
49#define GPIO_PIN_ALT2 0x00040000 /* alternate function 2 */
50#define GPIO_PIN_ALT3 0x00080000 /* alternate function 3 */
51#define GPIO_PIN_ALT4 0x00100000 /* alternate function 4 */
52#define GPIO_PIN_ALT5 0x00200000 /* alternate function 5 */
53#define GPIO_PIN_ALT6 0x00400000 /* alternate function 6 */
54#define GPIO_PIN_ALT7 0x00800000 /* alternate function 7 */
55#define GPIO_PIN_EVENTS 0x10000000 /* deliver events */
56#define GPIO_PIN_LEVEL 0x20000000 /* interrupt on level/edge */
57#define GPIO_PIN_FALLING 0x40000000 /* interrupt on falling/rising */
58
59/* GPIO controller description */
60struct gpio_info {
61 int gpio_npins; /* total number of pins available */
62};
63
64/* GPIO pin request (read/write/toggle) */
65struct gpio_req {
66 char gp_name[GPIOMAXNAME]; /* pin name */
67 int gp_pin; /* pin number */
68 int gp_value; /* value */
69};
70
71/* GPIO pin configuration */
72struct gpio_set {
73 char gp_name[GPIOMAXNAME];
74 int gp_pin;
75 int gp_caps;
76 int gp_flags;
77 char gp_name2[GPIOMAXNAME]; /* new name */
78};
79
80/* Attach device drivers that use GPIO pins */
81struct gpio_attach {
82 char ga_dvname[16]; /* device name */
83 int ga_offset; /* pin number */
84 uint32_t ga_mask; /* binary mask */
85 uint32_t ga_flags; /* driver dependent flags */
86};
87
88/* gpio(4) API */
89#define GPIOINFO _IOR('G', 0, struct gpio_info)
90#define GPIOSET _IOWR('G', 5, struct gpio_set)
91#define GPIOUNSET _IOWR('G', 6, struct gpio_set)
92#define GPIOREAD _IOWR('G', 7, struct gpio_req)
93#define GPIOWRITE _IOWR('G', 8, struct gpio_req)
94#define GPIOTOGGLE _IOWR('G', 9, struct gpio_req)
95#define GPIOATTACH _IOWR('G', 10, struct gpio_attach)
96
97#ifdef COMPAT_50
98/* Old structure to attach/detach devices */
99struct gpio_attach50 {
100 char ga_dvname[16]; /* device name */
101 int ga_offset; /* pin number */
102 uint32_t ga_mask; /* binary mask */
103};
104
105/* GPIO pin control (old API) */
106struct gpio_pin_ctl {
107 int gp_pin; /* pin number */
108 int gp_caps; /* pin capabilities (read-only) */
109 int gp_flags; /* pin configuration flags */
110};
111
112/* GPIO pin operation (read/write/toggle) (old API) */
113struct gpio_pin_op {
114 int gp_pin; /* pin number */
115 int gp_value; /* value */
116};
117
118/* the old API */
119#define GPIOPINREAD _IOWR('G', 1, struct gpio_pin_op)
120#define GPIOPINWRITE _IOWR('G', 2, struct gpio_pin_op)
121#define GPIOPINTOGGLE _IOWR('G', 3, struct gpio_pin_op)
122#define GPIOPINCTL _IOWR('G', 4, struct gpio_pin_ctl)
123#define GPIOATTACH50 _IOWR('G', 10, struct gpio_attach50)
124#define GPIODETACH50 _IOWR('G', 11, struct gpio_attach50)
125#define GPIODETACH _IOWR('G', 11, struct gpio_attach)
126#endif /* COMPAT_50 */
127
128#endif /* !_SYS_GPIO_H_ */
129