#ifndef _MAX1363_H_ #define _MAX1363_H_ #define MAX1363_SETUP_BYTE(a) ((a) | 0x80) /* There is a fair bit more defined here than currently * used, but the intention is to support everything these * chips do in the long run */ /* see data sheets */ /* max1363 and max1236, max1237, max1238, max1239 */ #define MAX1363_SETUP_AIN3_IS_AIN3_REF_IS_VDD 0x00 #define MAX1363_SETUP_AIN3_IS_REF_EXT_TO_REF 0x20 #define MAX1363_SETUP_AIN3_IS_AIN3_REF_IS_INT 0x40 #define MAX1363_SETUP_AIN3_IS_REF_REF_IS_INT 0x60 #define MAX1363_SETUP_POWER_UP_INT_REF 0x10 #define MAX1363_SETUP_POWER_DOWN_INT_REF 0x00 /* think about includeing max11600 etc - more settings */ #define MAX1363_SETUP_EXT_CLOCK 0x08 #define MAX1363_SETUP_INT_CLOCK 0x00 #define MAX1363_SETUP_UNIPOLAR 0x00 #define MAX1363_SETUP_BIPOLAR 0x04 #define MAX1363_SETUP_RESET 0x00 #define MAX1363_SETUP_NORESET 0x02 /* max1363 only - though don't care on others. * For now monitor modes are not implemented as the relevant * line is not connected on my test board. * The definitions are here as I intend to add this soon. */ #define MAX1363_SETUP_MONITOR_SETUP 0x01 /* Specific to the max1363 */ #define MAX1363_MON_RESET_CHAN(a) (1 << ((a) + 4)) #define MAX1363_MON_CONV_RATE_133ksps 0 #define MAX1363_MON_CONV_RATE_66_5ksps 0x02 #define MAX1363_MON_CONV_RATE_33_3ksps 0x04 #define MAX1363_MON_CONV_RATE_16_6ksps 0x06 #define MAX1363_MON_CONV_RATE_8_3ksps 0x08 #define MAX1363_MON_CONV_RATE_4_2ksps 0x0A #define MAX1363_MON_CONV_RATE_2_0ksps 0x0C #define MAX1363_MON_CONV_RATE_1_0ksps 0x0E #define MAX1363_MON_INT_ENABLE 0x01 /* defined for readability reasons */ /* All chips */ #define MAX1363_CONFIG_BYTE(a) ((a)) #define MAX1363_CONFIG_SE 0x01 #define MAX1363_CONFIG_DE 0x00 #define MAX1363_CONFIG_SCAN_TO_CS 0x00 #define MAX1363_CONFIG_SCAN_SINGLE_8 0x20 #define MAX1363_CONFIG_SCAN_MONITOR_MODE 0x40 #define MAX1363_CONFIG_SCAN_SINGLE_1 0x60 /* max123{6-9} only */ #define MAX1236_SCAN_MID_TO_CHANNEL 0x40 /* max1363 only - merely part of channel selects or don't care for others*/ #define MAX1363_CONFIG_EN_MON_MODE_READ 0x18 #define MAX1363_CHANNEL_SEL(a) ((a) << 1) /* max1363 strictly 0x06 - but doesn't matter */ #define MAX1363_CHANNEL_SEL_MASK 0x1E #define MAX1363_SCAN_MASK 0x60 #define MAX1363_SE_DE_MASK 0x01 /** * struct max1363_mode - scan mode information * @name: Name used to identify the scan mode. * @conf: The corresponding value of the configuration register * @numvals: The number of values returned by a single scan */ struct max1363_mode { const char *name; int8_t conf; int numvals; }; #define MAX1363_MODE_SINGLE(_num) { \ .name = #_num, \ .conf = MAX1363_CHANNEL_SEL(_num) \ | MAX1363_CONFIG_SCAN_SINGLE_1 \ | MAX1363_CONFIG_SE, \ .numvals = 1, \ } #define MAX1363_MODE_SINGLE_TIMES_8(_num) { \ .name = #_num"x8", \ .conf = MAX1363_CHANNEL_SEL(_num) \ | MAX1363_CONFIG_SCAN_SINGLE_8 \ | MAX1363_CONFIG_SE, \ .numvals = 8, \ } #define MAX1363_MODE_SCAN_TO_CHANNEL(_num) { \ .name = "0..."#_num, \ .conf = MAX1363_CHANNEL_SEL(_num) \ | MAX1363_CONFIG_SCAN_TO_CS \ | MAX1363_CONFIG_SE, \ .numvals = _num + 1, \ } /* note not available for max1363 hence naming */ #define MAX1236_MODE_SCAN_MID_TO_CHANNEL(_mid, _num) { \ .name = #_mid"..."#_num, \ .conf = MAX1363_CHANNEL_SEL(_num) \ | MAX1236_SCAN_MID_TO_CHANNEL \ | MAX1363_CONFIG_SE, \ .numvals = _num - _mid + 1 \ } #define MAX1363_MODE_DIFF_SINGLE(_nump, _numm) { \ .name = #_nump"-"#_numm, \ .conf = MAX1363_CHANNEL_SEL(_nump) \ | MAX1363_CONFIG_SCAN_SINGLE_1 \ | MAX1363_CONFIG_DE, \ .numvals = 1, \ } #define MAX1363_MODE_DIFF_SINGLE_TIMES_8(_nump, _numm) { \ .name = #_nump"-"#_numm, \ .conf = MAX1363_CHANNEL_SEL(_nump) \ | MAX1363_CONFIG_SCAN_SINGLE_8 \ | MAX1363_CONFIG_DE, \ .numvals = 1, \ } /* Can't think how to automate naming so specify for now */ #define MAX1363_MODE_DIFF_SCAN_TO_CHANNEL_NAMED(_name, _num, _numvals) { \ .name = #_name, \ .conf = MAX1363_CHANNEL_SEL(_num) \ | MAX1363_CONFIG_SCAN_TO_CS \ | MAX1363_CONFIG_DE, \ .numvals = _numvals, \ } /* note only available for max1363 hence naming */ #define MAX1236_MODE_DIFF_SCAN_MID_TO_CHANNEL_NAMED(_name, _num, _numvals) { \ .name = #_name, \ .conf = MAX1363_CHANNEL_SEL(_num) \ | MAX1236_SCAN_MID_TO_CHANNEL \ | MAX1363_CONFIG_SE, \ .numvals = _numvals, \ } /* Not currently handled */ #define MAX1363_MODE_MONITOR { \ .name = "monitor", \ .conf = MAX1363_CHANNEL_SEL(3) \ | MAX1363_CONFIG_SCAN_MONITOR_MODE \ | MAX1363_CONFIG_SE, \ .numvals = 10, \ } /* This may seem an overly long winded way to do this, but at least it makes * clear what all the various options actually do. Alternative suggestions * that don't require user to have intimate knowledge of the chip welcomed. */ /* This must be maintained along side the max1363_mode_table in max1363_core */ enum max1363_modes { /* Single read of a single channel */ _s0, _s1, _s2, _s3, _s4, _s5, _s6, _s7, _s8, _s9, _s10, _s11, /* Eight reads of a single channel */ se0, se1, se2, se3, se4, se5, se6, se7, se8, se9, se10, se11, /* Scan to channel */ s0to1, s0to2, s0to3, s0to4, s0to5, s0to6, s0to7, s0to8, s0to9, s0to10, s0to11, /* Differential single read */ d0m1, d2m3, d4m5, d6m7, d8m9, d10m11, d1m0, d3m2, d5m4, d7m6, d9m8, d11m10, /* Differential single read 8 times */ de0m1, de2m3, de4m5, de6m7, de8m9, de10m11, de1m0, de3m2, de5m4, de7m6, de9m8, de11m10, /* Differential scan to channel */ d0m1to2m3, d0m1to4m5, d0m1to6m7, d0m1to8m9, d0m1to10m11, d1m0to3m2, d1m0to5m4, d1m0to7m6, d1m0to9m8, d1m0to11m10, /* Scan mid to channel max123{6-9} only */ s2to3, s6to7, s6to8, s6to9, s6to10, s6to11, /* Differential scan mid to channel */ s6m7to8m9, s6m7to10m11, s7m6to9m8, s7m6to11m10, }; /** * struct max1363_chip_info - chip specifc information * @name: indentification string for chip * @num_inputs: number of physical inputs on chip * @int_vref_mv: the internal reference voltage * @monitor_mode: whether the chip supports monitor interrupts * @mode_list: array of available scan modes * @num_modes: the number of scan modes available * @default_mode: the scan mode in which the chip starts up */ struct max1363_chip_info { const char *name; u8 num_inputs; u16 int_vref_mv; bool monitor_mode; const enum max1363_modes *mode_list; int num_modes; enum max1363_modes default_mode; }; /** * struct max1363_state - driver instance specific data * @indio_dev: the industrial I/O device * @client: i2c_client * @setupbyte: cache of current device setup byte * @configbyte: cache of current device config byte * @chip_info: chip model specific constants, available modes etc * @current_mode: the scan mode of this chip * @poll_work: bottom half of polling interrupt handler * @protect_ring: used to ensure only one polling bh running at a time * @reg: supply regulator */ struct max1363_state { struct iio_dev *indio_dev; struct i2c_client *client; char setupbyte; char configbyte; const struct max1363_chip_info *chip_info; const struct max1363_mode *current_mode; struct work_struct poll_work; atomic_t protect_ring; struct iio_trigger *trig; struct regulator *reg; }; #ifdef CONFIG_MAX1363_RING_BUFFER ssize_t max1363_scan_from_ring(struct device *dev, struct device_attribute *attr, char *buf); int max1363_register_ring_funcs_and_init(struct iio_dev *indio_dev); void max1363_ring_cleanup(struct iio_dev *indio_dev); int max1363_initialize_ring(struct iio_ring_buffer *ring); void max1363_uninitialize_ring(struct iio_ring_buffer *ring); #else /* CONFIG_MAX1363_RING_BUFFER */ static inline void max1363_uninitialize_ring(struct iio_ring_buffer *ring) { }; static inline int max1363_initialize_ring(struct iio_ring_buffer *ring) { return 0; }; static inline ssize_t max1363_scan_from_ring(struct device *dev, struct device_attribute *attr, char *buf) { return 0; }; static inline int max1363_register_ring_funcs_and_init(struct iio_dev *indio_dev) { return 0; }; static inline void max1363_ring_cleanup(struct iio_dev *indio_dev) {}; #endif /* CONFIG_MAX1363_RING_BUFFER */ #endif /* _MAX1363_H_ */