Merge branch 'for-v3.16/ti-clk-drv' of github.com:t-kristo/linux-pm into clk-next

[2] Documentation/devicetree/bindings/clock/ti/dpll.txt

Required properties:

- compatible : shall be "ti,dra7-apll-clock"

- compatible : shall be "ti,dra7-apll-clock" or "ti,omap2-apll-clock"

- #clock-cells : from common clock binding; shall be set to 0.

- clocks : link phandles of parent clocks (clk-ref and clk-bypass)

- reg : address and length of the register set for controlling the APLL.

  It contains the information of registers in the following order:

	"control" - contains the control register base address

	"idlest" - contains the idlest register base address

	"control" - contains the control register offset

	"idlest" - contains the idlest register offset

	"autoidle" - contains the autoidle register offset (OMAP2 only)

- ti,clock-frequency : static clock frequency for the clock (OMAP2 only)

- ti,idlest-shift : bit-shift for the idlest field (OMAP2 only)

- ti,bit-shift : bit-shift for enable and autoidle fields (OMAP2 only)

Examples:

	apll_pcie_ck: apll_pcie_ck@4a008200 {

	apll_pcie_ck: apll_pcie_ck {

		#clock-cells = <0>;

		clocks = <&apll_pcie_in_clk_mux>, <&dpll_pcie_ref_ck>;

		reg = <0x4a00821c 0x4>, <0x4a008220 0x4>;

		reg = <0x021c>, <0x0220>;

		compatible = "ti,dra7-apll-clock";

	};

	apll96_ck: apll96_ck {

		#clock-cells = <0>;

		compatible = "ti,omap2-apll-clock";

		clocks = <&sys_ck>;

		ti,bit-shift = <2>;

		ti,idlest-shift = <8>;

		ti,clock-frequency = <96000000>;

		reg = <0x0500>, <0x0530>, <0x0520>;

	};

		"ti,omap4-dpll-core-clock",

		"ti,omap4-dpll-m4xen-clock",

		"ti,omap4-dpll-j-type-clock",

		"ti,omap5-mpu-dpll-clock",

		"ti,am3-dpll-no-gate-clock",

		"ti,am3-dpll-j-type-clock",

		"ti,am3-dpll-no-gate-j-type-clock",

		"ti,am3-dpll-clock",

		"ti,am3-dpll-core-clock",

		"ti,am3-dpll-x2-clock",

		"ti,omap2-dpll-core-clock",

- #clock-cells : from common clock binding; shall be set to 0.

- clocks : link phandles of parent clocks, first entry lists reference clock

	"mult-div1" - contains the multiplier / divider register base address

	"autoidle" - contains the autoidle register base address (optional)

  ti,am3-* dpll types do not have autoidle register

  ti,omap2-* dpll type does not support idlest / autoidle registers

Optional properties:

- DPLL mode setting - defining any one or more of the following overrides

		clocks = <&sys_clkin_ck>, <&sys_clkin_ck>;

		reg = <0x90>, <0x5c>, <0x68>;

	};

	dpll_ck: dpll_ck {

		#clock-cells = <0>;

		compatible = "ti,omap2-dpll-core-clock";

		clocks = <&sys_ck>, <&sys_ck>;

		reg = <0x0500>, <0x0540>;

	};

Device Tree Clock bindings for ATL (Audio Tracking Logic) of DRA7 SoC.

The ATL IP is used to generate clock to be used to synchronize baseband and

audio codec. A single ATL IP provides four ATL clock instances sharing the same

functional clock but can be configured to provide different clocks.

ATL can maintain a clock averages to some desired frequency based on the bws/aws

signals - can compensate the drift between the two ws signal.

In order to provide the support for ATL and it's output clocks (which can be used

internally within the SoC or external components) two sets of bindings is needed:

Clock tree binding:

This binding uses the common clock binding[1].

To be able to integrate the ATL clocks with DT clock tree.

Provides ccf level representation of the ATL clocks to be used by drivers.

Since the clock instances are part of a single IP this binding is used as a node

for the DT clock tree, the IP driver is needed to handle the actual configuration

of the IP.

[1] Documentation/devicetree/bindings/clock/clock-bindings.txt

Required properties:

- compatible : shall be "ti,dra7-atl-clock"

- #clock-cells : from common clock binding; shall be set to 0.

- clocks : link phandles to functional clock of ATL

Binding for the IP driver:

This binding is used to configure the IP driver which is going to handle the

configuration of the IP for the ATL clock instances.

Required properties:

- compatible : shall be "ti,dra7-atl"

- reg : base address for the ATL IP

- ti,provided-clocks : List of phandles to the clocks associated with the ATL

- clocks : link phandles to functional clock of ATL

- clock-names : Shall be set to "fck"

- ti,hwmods : Shall be set to "atl"

Optional properties:

Configuration of ATL instances:

- atl{0/1/2/3} {

	- bws : Baseband word select signal selection

	- aws : Audio word select signal selection

};

For valid word select signals, see the dt-bindings/clk/ti-dra7-atl.h include

file.

Examples:

/* clock bindings for atl provided clocks */

atl_clkin0_ck: atl_clkin0_ck {

	#clock-cells = <0>;

	compatible = "ti,dra7-atl-clock";

	clocks = <&atl_gfclk_mux>;

};

atl_clkin1_ck: atl_clkin1_ck {

	#clock-cells = <0>;

	compatible = "ti,dra7-atl-clock";

	clocks = <&atl_gfclk_mux>;

};

atl_clkin2_ck: atl_clkin2_ck {

	#clock-cells = <0>;

	compatible = "ti,dra7-atl-clock";

	clocks = <&atl_gfclk_mux>;

};

atl_clkin3_ck: atl_clkin3_ck {

	#clock-cells = <0>;

	compatible = "ti,dra7-atl-clock";

	clocks = <&atl_gfclk_mux>;

};

/* binding for the IP */

atl: atl@4843c000 {

	compatible = "ti,dra7-atl";

	reg = <0x4843c000 0x3ff>;

	ti,hwmods = "atl";

	ti,provided-clocks = <&atl_clkin0_ck>, <&atl_clkin1_ck>,

				<&atl_clkin2_ck>, <&atl_clkin3_ck>;

	clocks = <&atl_gfclk_mux>;

	clock-names = "fck";

	status = "disabled";

};

#include <dt-bindings/clk/ti-dra7-atl.h>

&atl {

	status = "okay";

	atl2 {

		bws = <DRA7_ATL_WS_MCASP2_FSX>;

		aws = <DRA7_ATL_WS_MCASP3_FSX>;

	};

};

			  to map clockdomains properly

  "ti,hsdiv-gate-clock" - gate clock with OMAP36xx specific hardware handling,

			  required for a hardware errata

  "ti,composite-gate-clock" - composite gate clock, to be part of composite

			      clock

  "ti,composite-no-wait-gate-clock" - composite gate clock that does not wait

				      for clock to be active before returning

				      from clk_enable()

- #clock-cells : from common clock binding; shall be set to 0

- clocks : link to phandle of parent clock

- reg : offset for register controlling adjustable gate, not needed for

		#clock-cells = <0>;

		compatible = "ti,gate-clock";

		clocks = <&core_96m_fck>;

		reg = <0x48004a00 0x4>;

		reg = <0x0a00>;

		ti,bit-shift = <25>;

	};

		#clock-cells = <0>;

		compatible = "ti,dss-gate-clock";

		clocks = <&dpll4_m4x2_ck>;

		reg = <0x48004e00 0x4>;

		reg = <0x0e00>;

		ti,bit-shift = <0>;

	};

		#clock-cells = <0>;

		compatible = "ti,am35xx-gate-clock";

		clocks = <&ipss_ick>;

		reg = <0x4800259c 0x4>;

		reg = <0x059c>;

		ti,bit-shift = <1>;

	};

		compatible = "ti,hsdiv-gate-clock";

		clocks = <&dpll4_m2x2_mul_ck>;

		ti,bit-shift = <0x1b>;

		reg = <0x48004d00 0x4>;

		reg = <0x0d00>;

		ti,set-bit-to-disable;

	};

	vlynq_gate_fck: vlynq_gate_fck {

		#clock-cells = <0>;

		compatible = "ti,composite-gate-clock";

		clocks = <&core_ck>;

		ti,bit-shift = <3>;

		reg = <0x0200>;

	};

	sys_clkout2_src_gate: sys_clkout2_src_gate {

		#clock-cells = <0>;

		compatible = "ti,composite-no-wait-gate-clock";

		clocks = <&core_ck>;

		ti,bit-shift = <15>;

		reg = <0x0070>;

	};

  "ti,omap3-dss-interface-clock" - interface clock with DSS specific HW handling

  "ti,omap3-ssi-interface-clock" - interface clock with SSI specific HW handling

  "ti,am35xx-interface-clock" - interface clock with AM35xx specific HW handling

  "ti,omap2430-interface-clock" - interface clock with OMAP2430 specific HW

				  handling

- #clock-cells : from common clock binding; shall be set to 0

- clocks : link to phandle of parent clock

- reg : base address for the control register