1 /* SPDX-License-Identifier: GPL-2.0-only */ 2 #ifndef _IIO_UTILS_H_ 3 #define _IIO_UTILS_H_ 4 5 /* IIO - useful set of util functionality 6 * 7 * Copyright (c) 2008 Jonathan Cameron 8 */ 9 10 #include <stdint.h> 11 12 /* Made up value to limit allocation sizes */ 13 #define IIO_MAX_NAME_LENGTH 64 14 15 #define FORMAT_SCAN_ELEMENTS_DIR "%s/scan_elements" 16 #define FORMAT_TYPE_FILE "%s_type" 17 18 #define ARRAY_SIZE(arr) (sizeof(arr) / sizeof(arr[0])) 19 20 extern const char *iio_dir; 21 22 /** 23 * struct iio_channel_info - information about a given channel 24 * @name: channel name 25 * @generic_name: general name for channel type 26 * @scale: scale factor to be applied for conversion to si units 27 * @offset: offset to be applied for conversion to si units 28 * @index: the channel index in the buffer output 29 * @bytes: number of bytes occupied in buffer output 30 * @bits_used: number of valid bits of data 31 * @shift: amount of bits to shift right data before applying bit mask 32 * @mask: a bit mask for the raw output 33 * @be: flag if data is big endian 34 * @is_signed: is the raw value stored signed 35 * @location: data offset for this channel inside the buffer (in bytes) 36 **/ 37 struct iio_channel_info { 38 char *name; 39 char *generic_name; 40 float scale; 41 float offset; 42 unsigned index; 43 unsigned bytes; 44 unsigned bits_used; 45 unsigned shift; 46 uint64_t mask; 47 unsigned be; 48 unsigned is_signed; 49 unsigned location; 50 }; 51 52 static inline int iioutils_check_suffix(const char *str, const char *suffix) 53 { 54 return strlen(str) >= strlen(suffix) && 55 strncmp(str+strlen(str)-strlen(suffix), 56 suffix, strlen(suffix)) == 0; 57 } 58 59 int iioutils_break_up_name(const char *full_name, char **generic_name); 60 int iioutils_get_type(unsigned *is_signed, unsigned *bytes, unsigned *bits_used, 61 unsigned *shift, uint64_t *mask, unsigned *be, 62 const char *device_dir, const char *name, 63 const char *generic_name); 64 int iioutils_get_param_float(float *output, const char *param_name, 65 const char *device_dir, const char *name, 66 const char *generic_name); 67 void bsort_channel_array_by_index(struct iio_channel_info *ci_array, int cnt); 68 int build_channel_array(const char *device_dir, 69 struct iio_channel_info **ci_array, int *counter); 70 int find_type_by_name(const char *name, const char *type); 71 int write_sysfs_int(const char *filename, const char *basedir, int val); 72 int write_sysfs_int_and_verify(const char *filename, const char *basedir, 73 int val); 74 int write_sysfs_string_and_verify(const char *filename, const char *basedir, 75 const char *val); 76 int write_sysfs_string(const char *filename, const char *basedir, 77 const char *val); 78 int read_sysfs_posint(const char *filename, const char *basedir); 79 int read_sysfs_float(const char *filename, const char *basedir, float *val); 80 int read_sysfs_string(const char *filename, const char *basedir, char *str); 81 82 #endif /* _IIO_UTILS_H_ */ 83