63 lines
		
	
	
		
			1.8 KiB
		
	
	
	
		
			Plaintext
		
	
	
	
			
		
		
	
	
			63 lines
		
	
	
		
			1.8 KiB
		
	
	
	
		
			Plaintext
		
	
	
	
ADC device binding
 | 
						|
 | 
						|
There are no mandatory properties for ADC. However, if Voltage info is required,
 | 
						|
then there are two options:
 | 
						|
- use microvolts constraint or
 | 
						|
- use regulator phandle to enable/read supply's Voltage
 | 
						|
 | 
						|
Properties and constraints:
 | 
						|
*optional and always checked, Voltage polarity info:
 | 
						|
- vdd-polarity-negative:  positive reference Voltage has a negative polarity
 | 
						|
- vss-polarity-negative:  negative reference Voltage has a negative polarity
 | 
						|
 | 
						|
Chose one option, for each supply (Vdd/Vss):
 | 
						|
 | 
						|
*optional and always checked, supply Voltage constants:
 | 
						|
- vdd-supply:            phandle to Vdd regulator's node
 | 
						|
- vss-supply:            phandle to Vss regulator's node
 | 
						|
 | 
						|
*optional and checked only if the above corresponding, doesn't exist:
 | 
						|
- vdd-microvolts:        positive reference Voltage value [uV]
 | 
						|
- vss-microvolts:        negative reference Voltage value [uV]
 | 
						|
 | 
						|
Example with constant 'Vdd' value:
 | 
						|
adc@1000000 {
 | 
						|
	compatible = "some-adc";
 | 
						|
	reg = <0xaabb000 0x100>;
 | 
						|
	status = "enabled";
 | 
						|
	vdd-microvolts = <1800000>;
 | 
						|
};
 | 
						|
 | 
						|
Example of supply phandle usage, for the ADC's VDD/VSS references as below:
 | 
						|
   _______         _______
 | 
						|
  |Sandbox|       |Sandbox|
 | 
						|
  : PMIC  :       :  ADC  :
 | 
						|
  .       .       .       .
 | 
						|
  |       | (Vdd) |   AIN0|-->
 | 
						|
  |  BUCK2|-------|VDDref |
 | 
						|
  | (3.3V)|      _|VSSref |
 | 
						|
  |_______|     | |_______|
 | 
						|
               _|_
 | 
						|
 | 
						|
For the above PMIC, the node can be defined as follows:
 | 
						|
sandbox_pmic {
 | 
						|
	compatible = "sandbox,pmic";
 | 
						|
	...
 | 
						|
	buck2: buck2 {
 | 
						|
		regulator-name = "SUPPLY_3.3V";
 | 
						|
		regulator-min-microvolt = <3300000>;
 | 
						|
		regulator-max-microvolt = <3300000>;
 | 
						|
	};
 | 
						|
	...
 | 
						|
};
 | 
						|
 | 
						|
For the above ADC, the node can be defined as follows:
 | 
						|
adc@0 {
 | 
						|
	compatible = "sandbox,adc";
 | 
						|
	vdd-supply = <&buck2>;
 | 
						|
	vss-microvolts = <0>;
 | 
						|
};
 | 
						|
 | 
						|
The ADC uclass code, will enable the supply before start of the conversion,
 | 
						|
but it will not configure the regulator settings.
 |