17ebd8b66SMauro Carvalho ChehabKernel driver max197 27ebd8b66SMauro Carvalho Chehab==================== 37ebd8b66SMauro Carvalho Chehab 47ebd8b66SMauro Carvalho ChehabAuthor: 57ebd8b66SMauro Carvalho Chehab 67ebd8b66SMauro Carvalho Chehab * Vivien Didelot <vivien.didelot@savoirfairelinux.com> 77ebd8b66SMauro Carvalho Chehab 87ebd8b66SMauro Carvalho ChehabSupported chips: 97ebd8b66SMauro Carvalho Chehab 107ebd8b66SMauro Carvalho Chehab * Maxim MAX197 117ebd8b66SMauro Carvalho Chehab 127ebd8b66SMauro Carvalho Chehab Prefix: 'max197' 137ebd8b66SMauro Carvalho Chehab 147ebd8b66SMauro Carvalho Chehab Datasheet: http://datasheets.maxim-ic.com/en/ds/MAX197.pdf 157ebd8b66SMauro Carvalho Chehab 167ebd8b66SMauro Carvalho Chehab * Maxim MAX199 177ebd8b66SMauro Carvalho Chehab 187ebd8b66SMauro Carvalho Chehab Prefix: 'max199' 197ebd8b66SMauro Carvalho Chehab 207ebd8b66SMauro Carvalho Chehab Datasheet: http://datasheets.maxim-ic.com/en/ds/MAX199.pdf 217ebd8b66SMauro Carvalho Chehab 227ebd8b66SMauro Carvalho ChehabDescription 237ebd8b66SMauro Carvalho Chehab----------- 247ebd8b66SMauro Carvalho Chehab 257ebd8b66SMauro Carvalho ChehabThe A/D converters MAX197, and MAX199 are both 8-Channel, Multi-Range, 5V, 267ebd8b66SMauro Carvalho Chehab12-Bit DAS with 8+4 Bus Interface and Fault Protection. 277ebd8b66SMauro Carvalho Chehab 287ebd8b66SMauro Carvalho ChehabThe available ranges for the MAX197 are {0,-5V} to 5V, and {0,-10V} to 10V, 297ebd8b66SMauro Carvalho Chehabwhile they are {0,-2V} to 2V, and {0,-4V} to 4V on the MAX199. 307ebd8b66SMauro Carvalho Chehab 317ebd8b66SMauro Carvalho ChehabPlatform data 327ebd8b66SMauro Carvalho Chehab------------- 337ebd8b66SMauro Carvalho Chehab 347ebd8b66SMauro Carvalho ChehabThe MAX197 platform data (defined in linux/platform_data/max197.h) should be 357ebd8b66SMauro Carvalho Chehabfilled with a pointer to a conversion function, defined like:: 367ebd8b66SMauro Carvalho Chehab 377ebd8b66SMauro Carvalho Chehab int convert(u8 ctrl); 387ebd8b66SMauro Carvalho Chehab 397ebd8b66SMauro Carvalho Chehabctrl is the control byte to write to start a new conversion. 407ebd8b66SMauro Carvalho ChehabOn success, the function must return the 12-bit raw value read from the chip, 417ebd8b66SMauro Carvalho Chehabor a negative error code otherwise. 427ebd8b66SMauro Carvalho Chehab 437ebd8b66SMauro Carvalho ChehabControl byte format: 447ebd8b66SMauro Carvalho Chehab 457ebd8b66SMauro Carvalho Chehab======= ========== ============================================ 467ebd8b66SMauro Carvalho ChehabBit Name Description 477ebd8b66SMauro Carvalho Chehab7,6 PD1,PD0 Clock and Power-Down modes 487ebd8b66SMauro Carvalho Chehab5 ACQMOD Internal or External Controlled Acquisition 497ebd8b66SMauro Carvalho Chehab4 RNG Full-scale voltage magnitude at the input 507ebd8b66SMauro Carvalho Chehab3 BIP Unipolar or Bipolar conversion mode 517ebd8b66SMauro Carvalho Chehab2,1,0 A2,A1,A0 Channel 527ebd8b66SMauro Carvalho Chehab======= ========== ============================================ 537ebd8b66SMauro Carvalho Chehab 547ebd8b66SMauro Carvalho ChehabSysfs interface 557ebd8b66SMauro Carvalho Chehab--------------- 567ebd8b66SMauro Carvalho Chehab 577ebd8b66SMauro Carvalho Chehab ============== ============================================================== 587ebd8b66SMauro Carvalho Chehab in[0-7]_input The conversion value for the corresponding channel. 597ebd8b66SMauro Carvalho Chehab RO 607ebd8b66SMauro Carvalho Chehab 617ebd8b66SMauro Carvalho Chehab in[0-7]_min The lower limit (in mV) for the corresponding channel. 627ebd8b66SMauro Carvalho Chehab For the MAX197, it will be adjusted to -10000, -5000, or 0. 637ebd8b66SMauro Carvalho Chehab For the MAX199, it will be adjusted to -4000, -2000, or 0. 647ebd8b66SMauro Carvalho Chehab RW 657ebd8b66SMauro Carvalho Chehab 667ebd8b66SMauro Carvalho Chehab in[0-7]_max The higher limit (in mV) for the corresponding channel. 677ebd8b66SMauro Carvalho Chehab For the MAX197, it will be adjusted to 0, 5000, or 10000. 687ebd8b66SMauro Carvalho Chehab For the MAX199, it will be adjusted to 0, 2000, or 4000. 697ebd8b66SMauro Carvalho Chehab RW 707ebd8b66SMauro Carvalho Chehab ============== ============================================================== 71