| 
									
										
										
										
											2008-01-22 23:00:02 +00:00
										 |  |  | Kernel driver ads7828 | 
					
						
							|  |  |  | ===================== | 
					
						
							|  |  |  | 
 | 
					
						
							|  |  |  | Supported chips: | 
					
						
							|  |  |  |   * Texas Instruments/Burr-Brown ADS7828 | 
					
						
							|  |  |  |     Prefix: 'ads7828' | 
					
						
							| 
									
										
										
										
											2012-10-03 16:54:07 -04:00
										 |  |  |     Datasheet: Publicly available at the Texas Instruments website: | 
					
						
							| 
									
										
										
										
											2008-01-22 23:00:02 +00:00
										 |  |  |                http://focus.ti.com/lit/ds/symlink/ads7828.pdf | 
					
						
							|  |  |  | 
 | 
					
						
							| 
									
										
										
										
											2012-10-03 16:54:08 -04:00
										 |  |  |   * Texas Instruments ADS7830 | 
					
						
							|  |  |  |     Prefix: 'ads7830' | 
					
						
							|  |  |  |     Datasheet: Publicly available at the Texas Instruments website: | 
					
						
							|  |  |  |                http://focus.ti.com/lit/ds/symlink/ads7830.pdf | 
					
						
							|  |  |  | 
 | 
					
						
							| 
									
										
										
										
											2008-01-22 23:00:02 +00:00
										 |  |  | Authors: | 
					
						
							| 
									
										
										
										
											2011-01-12 21:55:08 +01:00
										 |  |  |         Steve Hardy <shardy@redhat.com> | 
					
						
							| 
									
										
										
										
											2012-10-03 16:54:07 -04:00
										 |  |  |         Vivien Didelot <vivien.didelot@savoirfairelinux.com> | 
					
						
							| 
									
										
										
										
											2012-10-03 16:54:08 -04:00
										 |  |  |         Guillaume Roguez <guillaume.roguez@savoirfairelinux.com> | 
					
						
							| 
									
										
										
										
											2008-01-22 23:00:02 +00:00
										 |  |  | 
 | 
					
						
							| 
									
										
										
										
											2012-10-03 16:54:07 -04:00
										 |  |  | Platform data | 
					
						
							|  |  |  | ------------- | 
					
						
							| 
									
										
										
										
											2008-01-22 23:00:02 +00:00
										 |  |  | 
 | 
					
						
							| 
									
										
										
										
											2012-10-03 16:54:07 -04:00
										 |  |  | The ads7828 driver accepts an optional ads7828_platform_data structure (defined | 
					
						
							|  |  |  | in include/linux/platform_data/ads7828.h). The structure fields are: | 
					
						
							|  |  |  | 
 | 
					
						
							|  |  |  | * diff_input: (bool) Differential operation | 
					
						
							|  |  |  |   set to true for differential mode, false for default single ended mode. | 
					
						
							|  |  |  | 
 | 
					
						
							|  |  |  | * ext_vref: (bool) External reference | 
					
						
							|  |  |  |   set to true if it operates with an external reference, false for default | 
					
						
							|  |  |  |   internal reference. | 
					
						
							|  |  |  | 
 | 
					
						
							|  |  |  | * vref_mv: (unsigned int) Voltage reference | 
					
						
							|  |  |  |   if using an external reference, set this to the reference voltage in mV, | 
					
						
							|  |  |  |   otherwise it will default to the internal value (2500mV). This value will be | 
					
						
							|  |  |  |   bounded with limits accepted by the chip, described in the datasheet. | 
					
						
							|  |  |  | 
 | 
					
						
							|  |  |  |  If no structure is provided, the configuration defaults to single ended | 
					
						
							|  |  |  |  operation and internal voltage reference (2.5V). | 
					
						
							| 
									
										
										
										
											2008-01-22 23:00:02 +00:00
										 |  |  | 
 | 
					
						
							|  |  |  | Description | 
					
						
							|  |  |  | ----------- | 
					
						
							|  |  |  | 
 | 
					
						
							| 
									
										
										
										
											2012-10-03 16:54:08 -04:00
										 |  |  | This driver implements support for the Texas Instruments ADS7828 and ADS7830. | 
					
						
							| 
									
										
										
										
											2008-01-22 23:00:02 +00:00
										 |  |  | 
 | 
					
						
							| 
									
										
										
										
											2012-10-03 16:54:08 -04:00
										 |  |  | The ADS7828 device is a 12-bit 8-channel A/D converter, while the ADS7830 does | 
					
						
							|  |  |  | 8-bit sampling. | 
					
						
							| 
									
										
										
										
											2008-01-22 23:00:02 +00:00
										 |  |  | 
 | 
					
						
							|  |  |  | It can operate in single ended mode (8 +ve inputs) or in differential mode, | 
					
						
							|  |  |  | where 4 differential pairs can be measured. | 
					
						
							|  |  |  | 
 | 
					
						
							|  |  |  | The chip also has the facility to use an external voltage reference.  This | 
					
						
							|  |  |  | may be required if your hardware supplies the ADS7828 from a 5V supply, see | 
					
						
							|  |  |  | the datasheet for more details. | 
					
						
							| 
									
										
										
										
											2012-10-03 16:54:07 -04:00
										 |  |  | 
 | 
					
						
							|  |  |  | There is no reliable way to identify this chip, so the driver will not scan | 
					
						
							|  |  |  | some addresses to try to auto-detect it. That means that you will have to | 
					
						
							|  |  |  | statically declare the device in the platform support code. |