xref: /linux/tools/gpio/gpio-utils.h (revision 75b1a8f9d62e50f05d0e4e9f3c8bcde32527ffc1)
1 /* SPDX-License-Identifier: GPL-2.0-only */
2 /*
3  * GPIO tools - utility helpers library for the GPIO tools
4  *
5  * Copyright (C) 2015 Linus Walleij
6  *
7  * Portions copied from iio_utils and lssio:
8  * Copyright (c) 2010 Manuel Stahl <manuel.stahl@iis.fraunhofer.de>
9  * Copyright (c) 2008 Jonathan Cameron
10  * *
11  */
12 #ifndef _GPIO_UTILS_H_
13 #define _GPIO_UTILS_H_
14 
15 #include <stdbool.h>
16 #include <string.h>
17 #include <linux/types.h>
18 
19 #define ARRAY_SIZE(arr) (sizeof(arr) / sizeof((arr)[0]))
20 
21 static inline int check_prefix(const char *str, const char *prefix)
22 {
23 	return strlen(str) > strlen(prefix) &&
24 		strncmp(str, prefix, strlen(prefix)) == 0;
25 }
26 
27 int gpiotools_request_linehandle(const char *device_name, unsigned int *lines,
28 				 unsigned int num_lines, unsigned int flag,
29 				 struct gpiohandle_data *data,
30 				 const char *consumer_label);
31 int gpiotools_release_linehandle(const int fd);
32 
33 int gpiotools_request_line(const char *device_name,
34 			   unsigned int *lines,
35 			   unsigned int num_lines,
36 			   struct gpio_v2_line_config *config,
37 			   const char *consumer);
38 int gpiotools_set_values(const int fd, struct gpio_v2_line_values *values);
39 int gpiotools_get_values(const int fd, struct gpio_v2_line_values *values);
40 int gpiotools_release_line(const int fd);
41 
42 int gpiotools_get(const char *device_name, unsigned int line);
43 int gpiotools_gets(const char *device_name, unsigned int *lines,
44 		   unsigned int num_lines, unsigned int *values);
45 int gpiotools_set(const char *device_name, unsigned int line,
46 		  unsigned int value);
47 int gpiotools_sets(const char *device_name, unsigned int *lines,
48 		   unsigned int num_lines, unsigned int *values);
49 
50 /* helper functions for gpio_v2_line_values bits */
51 static inline void gpiotools_set_bit(__u64 *b, int n)
52 {
53 	*b |= _BITULL(n);
54 }
55 
56 static inline void gpiotools_change_bit(__u64 *b, int n)
57 {
58 	*b ^= _BITULL(n);
59 }
60 
61 static inline void gpiotools_clear_bit(__u64 *b, int n)
62 {
63 	*b &= ~_BITULL(n);
64 }
65 
66 static inline int gpiotools_test_bit(__u64 b, int n)
67 {
68 	return !!(b & _BITULL(n));
69 }
70 
71 static inline void gpiotools_assign_bit(__u64 *b, int n, bool value)
72 {
73 	if (value)
74 		gpiotools_set_bit(b, n);
75 	else
76 		gpiotools_clear_bit(b, n);
77 }
78 
79 #endif /* _GPIO_UTILS_H_ */
80