0a1231dfea
Changes since V2: * Moved to new registration methodology. Signed-off-by: Jonathan Cameron <jic23@cam.ac.uk> Signed-off-by: Greg Kroah-Hartman <gregkh@suse.de>
270 lines
8.3 KiB
C
270 lines
8.3 KiB
C
#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_IIO_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_IIO_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_IIO_RING_BUFFER */
|
|
#endif /* _MAX1363_H_ */
|