1/* 2 * Driver for the Analog Devices digital potentiometers 3 * 4 * Copyright (C) 2010 Michael Hennerich, Analog Devices Inc. 5 * 6 * Licensed under the GPL-2 or later. 7 */ 8 9#ifndef _AD_DPOT_H_ 10#define _AD_DPOT_H_ 11 12#include <linux/types.h> 13 14#define DPOT_CONF(features, wipers, max_pos, uid) \ 15 (((features) << 18) | (((wipers) & 0xFF) << 10) | \ 16 ((max_pos & 0xF) << 6) | (uid & 0x3F)) 17 18#define DPOT_UID(conf) (conf & 0x3F) 19#define DPOT_MAX_POS(conf) ((conf >> 6) & 0xF) 20#define DPOT_WIPERS(conf) ((conf >> 10) & 0xFF) 21#define DPOT_FEAT(conf) (conf >> 18) 22 23#define BRDAC0 (1 << 0) 24#define BRDAC1 (1 << 1) 25#define BRDAC2 (1 << 2) 26#define BRDAC3 (1 << 3) 27#define BRDAC4 (1 << 4) 28#define BRDAC5 (1 << 5) 29#define MAX_RDACS 6 30 31#define F_CMD_INC (1 << 0) /* Features INC/DEC ALL, 6dB */ 32#define F_CMD_EEP (1 << 1) /* Features EEPROM */ 33#define F_CMD_OTP (1 << 2) /* Features OTP */ 34#define F_CMD_TOL (1 << 3) /* RDACS feature Tolerance REG */ 35#define F_RDACS_RW (1 << 4) /* RDACS are Read/Write */ 36#define F_RDACS_WONLY (1 << 5) /* RDACS are Write only */ 37#define F_AD_APPDATA (1 << 6) /* RDAC Address append to data */ 38#define F_SPI_8BIT (1 << 7) /* All SPI XFERS are 8-bit */ 39#define F_SPI_16BIT (1 << 8) /* All SPI XFERS are 16-bit */ 40#define F_SPI_24BIT (1 << 9) /* All SPI XFERS are 24-bit */ 41 42#define F_RDACS_RW_TOL (F_RDACS_RW | F_CMD_EEP | F_CMD_TOL) 43#define F_RDACS_RW_EEP (F_RDACS_RW | F_CMD_EEP) 44#define F_SPI (F_SPI_8BIT | F_SPI_16BIT | F_SPI_24BIT) 45 46enum dpot_devid { 47 AD5258_ID = DPOT_CONF(F_RDACS_RW_TOL, BRDAC0, 6, 0), /* I2C */ 48 AD5259_ID = DPOT_CONF(F_RDACS_RW_TOL, BRDAC0, 8, 1), 49 AD5251_ID = DPOT_CONF(F_RDACS_RW_TOL | F_CMD_INC, 50 BRDAC0 | BRDAC3, 6, 2), 51 AD5252_ID = DPOT_CONF(F_RDACS_RW_TOL | F_CMD_INC, 52 BRDAC0 | BRDAC3, 8, 3), 53 AD5253_ID = DPOT_CONF(F_RDACS_RW_TOL | F_CMD_INC, 54 BRDAC0 | BRDAC1 | BRDAC2 | BRDAC3, 6, 4), 55 AD5254_ID = DPOT_CONF(F_RDACS_RW_TOL | F_CMD_INC, 56 BRDAC0 | BRDAC1 | BRDAC2 | BRDAC3, 8, 5), 57 AD5255_ID = DPOT_CONF(F_RDACS_RW_TOL | F_CMD_INC, 58 BRDAC0 | BRDAC1 | BRDAC2, 9, 6), 59 AD5160_ID = DPOT_CONF(F_RDACS_WONLY | F_AD_APPDATA | F_SPI_8BIT, 60 BRDAC0, 8, 7), /* SPI */ 61 AD5161_ID = DPOT_CONF(F_RDACS_WONLY | F_AD_APPDATA | F_SPI_8BIT, 62 BRDAC0, 8, 8), 63 AD5162_ID = DPOT_CONF(F_RDACS_WONLY | F_AD_APPDATA | F_SPI_16BIT, 64 BRDAC0 | BRDAC1, 8, 9), 65 AD5165_ID = DPOT_CONF(F_RDACS_WONLY | F_AD_APPDATA | F_SPI_8BIT, 66 BRDAC0, 8, 10), 67 AD5200_ID = DPOT_CONF(F_RDACS_WONLY | F_AD_APPDATA | F_SPI_8BIT, 68 BRDAC0, 8, 11), 69 AD5201_ID = DPOT_CONF(F_RDACS_WONLY | F_AD_APPDATA | F_SPI_8BIT, 70 BRDAC0, 5, 12), 71 AD5203_ID = DPOT_CONF(F_RDACS_WONLY | F_AD_APPDATA | F_SPI_8BIT, 72 BRDAC0 | BRDAC1 | BRDAC2 | BRDAC3, 6, 13), 73 AD5204_ID = DPOT_CONF(F_RDACS_WONLY | F_AD_APPDATA | F_SPI_16BIT, 74 BRDAC0 | BRDAC1 | BRDAC2 | BRDAC3, 8, 14), 75 AD5206_ID = DPOT_CONF(F_RDACS_WONLY | F_AD_APPDATA | F_SPI_16BIT, 76 BRDAC0 | BRDAC1 | BRDAC2 | BRDAC3 | BRDAC4 | BRDAC5, 77 8, 15), 78 AD5207_ID = DPOT_CONF(F_RDACS_WONLY | F_AD_APPDATA | F_SPI_16BIT, 79 BRDAC0 | BRDAC1, 8, 16), 80 AD5231_ID = DPOT_CONF(F_RDACS_RW_EEP | F_CMD_INC | F_SPI_24BIT, 81 BRDAC0, 10, 17), 82 AD5232_ID = DPOT_CONF(F_RDACS_RW_EEP | F_CMD_INC | F_SPI_16BIT, 83 BRDAC0 | BRDAC1, 8, 18), 84 AD5233_ID = DPOT_CONF(F_RDACS_RW_EEP | F_CMD_INC | F_SPI_16BIT, 85 BRDAC0 | BRDAC1 | BRDAC2 | BRDAC3, 6, 19), 86 AD5235_ID = DPOT_CONF(F_RDACS_RW_EEP | F_CMD_INC | F_SPI_24BIT, 87 BRDAC0 | BRDAC1, 10, 20), 88 AD5260_ID = DPOT_CONF(F_RDACS_WONLY | F_AD_APPDATA | F_SPI_8BIT, 89 BRDAC0, 8, 21), 90 AD5262_ID = DPOT_CONF(F_RDACS_WONLY | F_AD_APPDATA | F_SPI_16BIT, 91 BRDAC0 | BRDAC1, 8, 22), 92 AD5263_ID = DPOT_CONF(F_RDACS_WONLY | F_AD_APPDATA | F_SPI_16BIT, 93 BRDAC0 | BRDAC1 | BRDAC2 | BRDAC3, 8, 23), 94 AD5290_ID = DPOT_CONF(F_RDACS_WONLY | F_AD_APPDATA | F_SPI_8BIT, 95 BRDAC0, 8, 24), 96 AD5291_ID = DPOT_CONF(F_RDACS_RW | F_SPI_16BIT, BRDAC0, 8, 25), 97 AD5292_ID = DPOT_CONF(F_RDACS_RW | F_SPI_16BIT, BRDAC0, 10, 26), 98 AD5293_ID = DPOT_CONF(F_RDACS_RW | F_SPI_16BIT, BRDAC0, 10, 27), 99 AD7376_ID = DPOT_CONF(F_RDACS_WONLY | F_AD_APPDATA | F_SPI_8BIT, 100 BRDAC0, 7, 28), 101 AD8400_ID = DPOT_CONF(F_RDACS_WONLY | F_AD_APPDATA | F_SPI_8BIT, 102 BRDAC0, 8, 29), 103 AD8402_ID = DPOT_CONF(F_RDACS_WONLY | F_AD_APPDATA | F_SPI_16BIT, 104 BRDAC0 | BRDAC1, 8, 30), 105 AD8403_ID = DPOT_CONF(F_RDACS_WONLY | F_AD_APPDATA | F_SPI_16BIT, 106 BRDAC0 | BRDAC1 | BRDAC2, 8, 31), 107 ADN2850_ID = DPOT_CONF(F_RDACS_RW_EEP | F_CMD_INC | F_SPI_24BIT, 108 BRDAC0 | BRDAC1, 10, 32), 109 AD5241_ID = DPOT_CONF(F_RDACS_RW, BRDAC0, 8, 33), 110 AD5242_ID = DPOT_CONF(F_RDACS_RW, BRDAC0 | BRDAC1, 8, 34), 111 AD5243_ID = DPOT_CONF(F_RDACS_RW, BRDAC0 | BRDAC1, 8, 35), 112 AD5245_ID = DPOT_CONF(F_RDACS_RW, BRDAC0, 8, 36), 113 AD5246_ID = DPOT_CONF(F_RDACS_RW, BRDAC0, 7, 37), 114 AD5247_ID = DPOT_CONF(F_RDACS_RW, BRDAC0, 7, 38), 115 AD5248_ID = DPOT_CONF(F_RDACS_RW, BRDAC0 | BRDAC1, 8, 39), 116 AD5280_ID = DPOT_CONF(F_RDACS_RW, BRDAC0, 8, 40), 117 AD5282_ID = DPOT_CONF(F_RDACS_RW, BRDAC0 | BRDAC1, 8, 41), 118 ADN2860_ID = DPOT_CONF(F_RDACS_RW_TOL | F_CMD_INC, 119 BRDAC0 | BRDAC1 | BRDAC2, 9, 42), 120 AD5273_ID = DPOT_CONF(F_RDACS_RW | F_CMD_OTP, BRDAC0, 6, 43), 121 AD5171_ID = DPOT_CONF(F_RDACS_RW | F_CMD_OTP, BRDAC0, 6, 44), 122 AD5170_ID = DPOT_CONF(F_RDACS_RW | F_CMD_OTP, BRDAC0, 8, 45), 123 AD5172_ID = DPOT_CONF(F_RDACS_RW | F_CMD_OTP, BRDAC0 | BRDAC1, 8, 46), 124 AD5173_ID = DPOT_CONF(F_RDACS_RW | F_CMD_OTP, BRDAC0 | BRDAC1, 8, 47), 125}; 126 127#define DPOT_RDAC0 0 128#define DPOT_RDAC1 1 129#define DPOT_RDAC2 2 130#define DPOT_RDAC3 3 131#define DPOT_RDAC4 4 132#define DPOT_RDAC5 5 133 134#define DPOT_RDAC_MASK 0x1F 135 136#define DPOT_REG_TOL 0x18 137#define DPOT_TOL_RDAC0 (DPOT_REG_TOL | DPOT_RDAC0) 138#define DPOT_TOL_RDAC1 (DPOT_REG_TOL | DPOT_RDAC1) 139#define DPOT_TOL_RDAC2 (DPOT_REG_TOL | DPOT_RDAC2) 140#define DPOT_TOL_RDAC3 (DPOT_REG_TOL | DPOT_RDAC3) 141#define DPOT_TOL_RDAC4 (DPOT_REG_TOL | DPOT_RDAC4) 142#define DPOT_TOL_RDAC5 (DPOT_REG_TOL | DPOT_RDAC5) 143 144/* RDAC-to-EEPROM Interface Commands */ 145#define DPOT_ADDR_RDAC (0x0 << 5) 146#define DPOT_ADDR_EEPROM (0x1 << 5) 147#define DPOT_ADDR_OTP (0x1 << 6) 148#define DPOT_ADDR_CMD (0x1 << 7) 149#define DPOT_ADDR_OTP_EN (0x1 << 9) 150 151#define DPOT_DEC_ALL_6DB (DPOT_ADDR_CMD | (0x4 << 3)) 152#define DPOT_INC_ALL_6DB (DPOT_ADDR_CMD | (0x9 << 3)) 153#define DPOT_DEC_ALL (DPOT_ADDR_CMD | (0x6 << 3)) 154#define DPOT_INC_ALL (DPOT_ADDR_CMD | (0xB << 3)) 155 156#define DPOT_SPI_RDAC 0xB0 157#define DPOT_SPI_EEPROM 0x30 158#define DPOT_SPI_READ_RDAC 0xA0 159#define DPOT_SPI_READ_EEPROM 0x90 160#define DPOT_SPI_DEC_ALL_6DB 0x50 161#define DPOT_SPI_INC_ALL_6DB 0xD0 162#define DPOT_SPI_DEC_ALL 0x70 163#define DPOT_SPI_INC_ALL 0xF0 164 165/* AD5291/2/3 use special commands */ 166#define DPOT_AD5291_RDAC 0x01 167#define DPOT_AD5291_READ_RDAC 0x02 168 169/* AD524x use special commands */ 170#define DPOT_AD5291_RDAC_AB 0x80 171 172#define DPOT_AD5273_FUSE 0x80 173#define DPOT_AD5270_2_3_FUSE 0x20 174#define DPOT_AD5270_2_3_OW 0x08 175#define DPOT_AD5272_3_A0 0x08 176#define DPOT_AD5270_2FUSE 0x80 177 178struct dpot_data; 179 180struct ad_dpot_bus_ops { 181 int (*read_d8) (void *client); 182 int (*read_r8d8) (void *client, u8 reg); 183 int (*read_r8d16) (void *client, u8 reg); 184 int (*write_d8) (void *client, u8 val); 185 int (*write_r8d8) (void *client, u8 reg, u8 val); 186 int (*write_r8d16) (void *client, u8 reg, u16 val); 187}; 188 189struct ad_dpot_bus_data { 190 void *client; 191 const struct ad_dpot_bus_ops *bops; 192}; 193 194struct ad_dpot_id { 195 char *name; 196 unsigned long devid; 197}; 198 199int ad_dpot_probe(struct device *dev, struct ad_dpot_bus_data *bdata, const struct ad_dpot_id *id); 200int ad_dpot_remove(struct device *dev); 201 202#endif 203