tizen 2.4 release
[profile/mobile/platform/kernel/linux-3.10-sc7730.git] / Documentation / devicetree / bindings / arm / atmel-adc.txt
1 * AT91's Analog to Digital Converter (ADC)
2
3 Required properties:
4   - compatible: Should be "atmel,at91sam9260-adc"
5   - reg: Should contain ADC registers location and length
6   - interrupts: Should contain the IRQ line for the ADC
7   - atmel,adc-channel-base: Offset of the first channel data register
8   - atmel,adc-channels-used: Bitmask of the channels muxed and enable for this
9     device
10   - atmel,adc-drdy-mask: Mask of the DRDY interruption in the ADC
11   - atmel,adc-num-channels: Number of channels available in the ADC
12   - atmel,adc-startup-time: Startup Time of the ADC in microseconds as
13     defined in the datasheet
14   - atmel,adc-status-register: Offset of the Interrupt Status Register
15   - atmel,adc-trigger-register: Offset of the Trigger Register
16   - atmel,adc-vref: Reference voltage in millivolts for the conversions
17   - atmel,adc-res: List of resolution in bits supported by the ADC. List size
18                    must be two at least.
19   - atmel,adc-res-names: Contains one identifier string for each resolution
20                          in atmel,adc-res property. "lowres" and "highres"
21                          identifiers are required.
22
23 Optional properties:
24   - atmel,adc-use-external: Boolean to enable of external triggers
25   - atmel,adc-use-res: String corresponding to an identifier from
26                        atmel,adc-res-names property. If not specified, the highest
27                        resolution will be used.
28   - atmel,adc-sleep-mode: Boolean to enable sleep mode when no conversion
29   - atmel,adc-sample-hold-time: Sample and Hold Time in microseconds
30  
31 Optional trigger Nodes:
32   - Required properties:
33     * trigger-name: Name of the trigger exposed to the user
34     * trigger-value: Value to put in the Trigger register
35       to activate this trigger
36   - Optional properties:
37     * trigger-external: Is the trigger an external trigger?
38
39 Examples:
40 adc0: adc@fffb0000 {
41         compatible = "atmel,at91sam9260-adc";
42         reg = <0xfffb0000 0x100>;
43         interrupts = <20 4>;
44         atmel,adc-channel-base = <0x30>;
45         atmel,adc-channels-used = <0xff>;
46         atmel,adc-drdy-mask = <0x10000>;
47         atmel,adc-num-channels = <8>;
48         atmel,adc-startup-time = <40>;
49         atmel,adc-status-register = <0x1c>;
50         atmel,adc-trigger-register = <0x08>;
51         atmel,adc-use-external;
52         atmel,adc-vref = <3300>;
53         atmel,adc-res = <8 10>;
54         atmel,adc-res-names = "lowres", "highres";
55         atmel,adc-use-res = "lowres";
56
57         trigger@0 {
58                 trigger-name = "external-rising";
59                 trigger-value = <0x1>;
60                 trigger-external;
61         };
62         trigger@1 {
63                 trigger-name = "external-falling";
64                 trigger-value = <0x2>;
65                 trigger-external;
66         };
67
68         trigger@2 {
69                 trigger-name = "external-any";
70                 trigger-value = <0x3>;
71                 trigger-external;
72         };
73
74         trigger@3 {
75                 trigger-name = "continuous";
76                 trigger-value = <0x6>;
77         };
78 };