Merge tag 'clk-for-linus-3.12' of git://git.linaro.org/people/mturquette/linux
[cascardo/linux.git] / Documentation / devicetree / bindings / pwm / pwm-samsung.txt
index ac67c68..d61fccd 100644 (file)
@@ -19,13 +19,19 @@ Required properties:
 - reg: base address and size of register area
 - interrupts: list of timer interrupts (one interrupt per timer, starting at
   timer 0)
-- #pwm-cells: number of cells used for PWM specifier - must be 3
-   the specifier format is as follows:
-     - phandle to PWM controller node
-     - index of PWM channel (from 0 to 4)
-     - PWM signal period in nanoseconds
-     - bitmask of optional PWM flags:
-        0x1 - invert PWM signal
+- clock-names: should contain all following required clock names:
+    - "timers" - PWM base clock used to generate PWM signals,
+  and any subset of following optional clock names:
+    - "pwm-tclk0" - first external PWM clock source,
+    - "pwm-tclk1" - second external PWM clock source.
+  Note that not all IP variants allow using all external clock sources.
+  Refer to SoC documentation to learn which clock source configurations
+  are available.
+- clocks: should contain clock specifiers of all clocks, which input names
+  have been specified in clock-names property, in same order.
+- #pwm-cells: should be 3. See pwm.txt in this directory for a description of
+  the cells format. The only third cell flag supported by this binding is
+  PWM_POLARITY_INVERTED.
 
 Optional properties:
 - samsung,pwm-outputs: list of PWM channels used as PWM outputs on particular
@@ -38,6 +44,8 @@ Example:
                reg = <0x7f006000 0x1000>;
                interrupt-parent = <&vic0>;
                interrupts = <23>, <24>, <25>, <27>, <28>;
+               clocks = <&clock 67>;
+               clock-names = "timers";
                samsung,pwm-outputs = <0>, <1>;
                #pwm-cells = <3>;
        }