17ebd8b66SMauro Carvalho ChehabKernel driver ads7828 27ebd8b66SMauro Carvalho Chehab===================== 37ebd8b66SMauro Carvalho Chehab 47ebd8b66SMauro Carvalho ChehabSupported chips: 57ebd8b66SMauro Carvalho Chehab 67ebd8b66SMauro Carvalho Chehab * Texas Instruments/Burr-Brown ADS7828 77ebd8b66SMauro Carvalho Chehab 87ebd8b66SMauro Carvalho Chehab Prefix: 'ads7828' 97ebd8b66SMauro Carvalho Chehab 107ebd8b66SMauro Carvalho Chehab Datasheet: Publicly available at the Texas Instruments website: 117ebd8b66SMauro Carvalho Chehab 127ebd8b66SMauro Carvalho Chehab http://focus.ti.com/lit/ds/symlink/ads7828.pdf 137ebd8b66SMauro Carvalho Chehab 147ebd8b66SMauro Carvalho Chehab * Texas Instruments ADS7830 157ebd8b66SMauro Carvalho Chehab 167ebd8b66SMauro Carvalho Chehab Prefix: 'ads7830' 177ebd8b66SMauro Carvalho Chehab 187ebd8b66SMauro Carvalho Chehab Datasheet: Publicly available at the Texas Instruments website: 197ebd8b66SMauro Carvalho Chehab 207ebd8b66SMauro Carvalho Chehab http://focus.ti.com/lit/ds/symlink/ads7830.pdf 217ebd8b66SMauro Carvalho Chehab 227ebd8b66SMauro Carvalho ChehabAuthors: 237ebd8b66SMauro Carvalho Chehab - Steve Hardy <shardy@redhat.com> 247ebd8b66SMauro Carvalho Chehab - Vivien Didelot <vivien.didelot@savoirfairelinux.com> 257ebd8b66SMauro Carvalho Chehab - Guillaume Roguez <guillaume.roguez@savoirfairelinux.com> 267ebd8b66SMauro Carvalho Chehab 277ebd8b66SMauro Carvalho ChehabPlatform data 287ebd8b66SMauro Carvalho Chehab------------- 297ebd8b66SMauro Carvalho Chehab 307ebd8b66SMauro Carvalho ChehabThe ads7828 driver accepts an optional ads7828_platform_data structure (defined 317ebd8b66SMauro Carvalho Chehabin include/linux/platform_data/ads7828.h). The structure fields are: 327ebd8b66SMauro Carvalho Chehab 337ebd8b66SMauro Carvalho Chehab* diff_input: (bool) Differential operation 347ebd8b66SMauro Carvalho Chehab set to true for differential mode, false for default single ended mode. 357ebd8b66SMauro Carvalho Chehab 367ebd8b66SMauro Carvalho Chehab* ext_vref: (bool) External reference 377ebd8b66SMauro Carvalho Chehab set to true if it operates with an external reference, false for default 387ebd8b66SMauro Carvalho Chehab internal reference. 397ebd8b66SMauro Carvalho Chehab 407ebd8b66SMauro Carvalho Chehab* vref_mv: (unsigned int) Voltage reference 417ebd8b66SMauro Carvalho Chehab if using an external reference, set this to the reference voltage in mV, 427ebd8b66SMauro Carvalho Chehab otherwise it will default to the internal value (2500mV). This value will be 437ebd8b66SMauro Carvalho Chehab bounded with limits accepted by the chip, described in the datasheet. 447ebd8b66SMauro Carvalho Chehab 457ebd8b66SMauro Carvalho Chehab If no structure is provided, the configuration defaults to single ended 467ebd8b66SMauro Carvalho Chehab operation and internal voltage reference (2.5V). 477ebd8b66SMauro Carvalho Chehab 487ebd8b66SMauro Carvalho ChehabDescription 497ebd8b66SMauro Carvalho Chehab----------- 507ebd8b66SMauro Carvalho Chehab 517ebd8b66SMauro Carvalho ChehabThis driver implements support for the Texas Instruments ADS7828 and ADS7830. 527ebd8b66SMauro Carvalho Chehab 537ebd8b66SMauro Carvalho ChehabThe ADS7828 device is a 12-bit 8-channel A/D converter, while the ADS7830 does 547ebd8b66SMauro Carvalho Chehab8-bit sampling. 557ebd8b66SMauro Carvalho Chehab 567ebd8b66SMauro Carvalho ChehabIt can operate in single ended mode (8 +ve inputs) or in differential mode, 577ebd8b66SMauro Carvalho Chehabwhere 4 differential pairs can be measured. 587ebd8b66SMauro Carvalho Chehab 597ebd8b66SMauro Carvalho ChehabThe chip also has the facility to use an external voltage reference. This 607ebd8b66SMauro Carvalho Chehabmay be required if your hardware supplies the ADS7828 from a 5V supply, see 617ebd8b66SMauro Carvalho Chehabthe datasheet for more details. 627ebd8b66SMauro Carvalho Chehab 637ebd8b66SMauro Carvalho ChehabThere is no reliable way to identify this chip, so the driver will not scan 647ebd8b66SMauro Carvalho Chehabsome addresses to try to auto-detect it. That means that you will have to 657ebd8b66SMauro Carvalho Chehabstatically declare the device in the platform support code. 66