tools/iio/iio_utils.h

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