Home | History | Annotate | Line # | Download | only in gpio
gpiovar.h revision 1.19 
      1 /* $NetBSD: gpiovar.h,v 1.19 2023/11/06 00:35:05 brad Exp $ */
      2 /*	$OpenBSD: gpiovar.h,v 1.3 2006/01/14 12:33:49 grange Exp $	*/
      3 
      4 /*
      5  * Copyright (c) 2004, 2006 Alexander Yurchenko <grange (at) 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 _DEV_GPIO_GPIOVAR_H_
     21 #define _DEV_GPIO_GPIOVAR_H_
     22 
     23 #include <sys/device.h>
     24 
     25 /* GPIO controller description */
     26 typedef struct gpio_chipset_tag {
     27 	void	*gp_cookie;
     28 
     29 	int	(*gp_gc_open)(void *, device_t);
     30 	void    (*gp_gc_close)(void *, device_t);
     31 	int	(*gp_pin_read)(void *, int);
     32 	void	(*gp_pin_write)(void *, int, int);
     33 	void	(*gp_pin_ctl)(void *, int, int);
     34 
     35 	void *	(*gp_intr_establish)(void *, int, int, int,
     36 				     int (*)(void *), void *);
     37 	void	(*gp_intr_disestablish)(void *, void *);
     38 	bool	(*gp_intr_str)(void *, int, int, char *, size_t);
     39 } *gpio_chipset_tag_t;
     40 
     41 /* GPIO pin description */
     42 typedef struct gpio_pin {
     43 	int			pin_num;	/* number */
     44 	int			pin_caps;	/* capabilities */
     45 	int			pin_flags;	/* current configuration */
     46 	int			pin_state;	/* current state */
     47 	int			pin_mapped;	/* is mapped */
     48 	gpio_chipset_tag_t	pin_gc;		/* reference the controller */
     49 	char			pin_defname[GPIOMAXNAME]; /* default name */
     50 	int			pin_intrcaps;	/* interrupt capabilities */
     51 } gpio_pin_t;
     52 
     53 /* Attach GPIO framework to the controller */
     54 struct gpiobus_attach_args {
     55 	gpio_chipset_tag_t	 gba_gc;	/* underlying controller */
     56 	gpio_pin_t		*gba_pins;	/* pins array */
     57 	int			 gba_npins;	/* total number of pins */
     58 };
     59 
     60 int gpiobus_print(void *, const char *);
     61 
     62 /* GPIO framework private methods */
     63 #define gpiobus_open(gc, dev) \
     64     ((gc)->gp_gc_open ? ((gc)->gp_gc_open((gc)->gp_cookie, dev)) : 0)
     65 #define gpiobus_close(gc, dev) \
     66     ((gc)->gp_gc_close ? ((gc)->gp_gc_close((gc)->gp_cookie, dev)), 1 : 0)
     67 #define gpiobus_pin_read(gc, pin) \
     68     ((gc)->gp_pin_read((gc)->gp_cookie, (pin)))
     69 #define gpiobus_pin_write(gc, pin, value) \
     70     ((gc)->gp_pin_write((gc)->gp_cookie, (pin), (value)))
     71 #define gpiobus_pin_ctl(gc, pin, flags) \
     72     ((gc)->gp_pin_ctl((gc)->gp_cookie, (pin), (flags)))
     73 
     74 /* Attach devices connected to the GPIO pins */
     75 struct gpio_attach_args {
     76 	void		*ga_gpio;
     77 	int		 ga_offset;
     78 	uint32_t	 ga_mask;
     79 	char		*ga_dvname;
     80 	uint32_t	 ga_flags;	/* driver-specific flags */
     81 };
     82 
     83 /* GPIO pin map */
     84 struct gpio_pinmap {
     85 	int		*pm_map;		/* pin map */
     86 	int		 pm_size;		/* map size */
     87 };
     88 
     89 struct gpio_dev {
     90 	device_t		sc_dev;	/* the gpio device */
     91 	LIST_ENTRY(gpio_dev)	sc_next;
     92 };
     93 
     94 struct gpio_name {
     95 	char			gp_name[GPIOMAXNAME];
     96 	int			gp_pin;
     97 	LIST_ENTRY(gpio_name)	gp_next;
     98 };
     99 
    100 void *	gpio_find_device(const char *);
    101 const char * gpio_get_name(void *gpio);
    102 int	gpio_pin_can_map(void *, int, uint32_t);
    103 int	gpio_pin_map(void *, int, uint32_t, struct gpio_pinmap *);
    104 void	gpio_pin_unmap(void *, struct gpio_pinmap *);
    105 int	gpio_pin_read(void *, struct gpio_pinmap *, int);
    106 void	gpio_pin_write(void *, struct gpio_pinmap *, int, int);
    107 int	gpio_pin_caps(void *, struct gpio_pinmap *, int);
    108 int	gpio_pin_get_conf(void *, struct gpio_pinmap *, int);
    109 bool	gpio_pin_set_conf(void *, struct gpio_pinmap *, int, int);
    110 void	gpio_pin_ctl(void *, struct gpio_pinmap *, int, int);
    111 int	gpio_pin_intrcaps(void *, struct gpio_pinmap *, int);
    112 bool	gpio_pin_irqmode_issupported(void *, struct gpio_pinmap *, int, int);
    113 int	gpio_pin_wait(void *, int);
    114 int	gpio_npins(uint32_t);
    115 
    116 void *	gpio_intr_establish(void *, struct gpio_pinmap *, int, int, int,
    117 			    int (*)(void *), void *);
    118 void	gpio_intr_disestablish(void *, void *);
    119 bool	gpio_intr_str(void *, struct gpio_pinmap *, int, int,
    120 		      char *, size_t);
    121 int	gpio_pin_to_pin_num(void *, struct gpio_pinmap *, int);
    122 
    123 int	gpio_lock(void *);
    124 void	gpio_unlock(void *);
    125 
    126 #endif	/* !_DEV_GPIO_GPIOVAR_H_ */
    127