linux_dsm_epyc7002/Documentation/devicetree/bindings/clock
Tony Lindgren 35395a9c52 Documentation: dt-bindings: Add binding documentation for TI clkctrl clocks
Texas Instruments omap variant SoCs starting with omap4 have a clkctrl
clock controller instance for each interconnect target module. The clkctrl
controls functional and interface clocks for the module.

The clkctrl clocks are currently handled by arch/arm/mach-omap2 hwmod code.
With this binding and a related clock device driver we can start moving the
clkctrl clock handling to live in drivers/clk/ti.

Note that this binding allows keeping the clockdomain related parts out of
drivers/clock. The CLKCTCTRL and DYNAMICDEP registers can be handled by
a separate driver in drivers/soc/ti and genpd. If the clockdomain driver
needs to know it's clocks, we can just set the the clkctrl device
instances to be children of the related clockdomain device.

Each clkctrl clock can have multiple optional gate clocks, and multiple
optional mux clocks. To represent this in device tree, it seems that
it is best done using four clock cells #clock-cells = <2> property.

The reasons for using #clock-cells = <2> are:

1. We need to specify the clkctrl offset from the instance base. Otherwise
   we end up with a large number of device tree nodes that need to be
   patched when new clocks are discovered in a clkctrl clock with minor
   hardware revision changes for example

2. On omap5 CM_L3INIT_USB_HOST_HS_CLKCTRL has ten OPTFCLKEN bits. So we
   need to use a separate cell for optional gate clocks to avoid address
   space conflicts

There is probably no need to list input clocks for each clkctrl clock
instance in the binding. If we want to add them, the standard clocks
binding can be used for that.

For hardware reference, see omap4430 TRM "Table 3-1312. L4PER_CM2 Registers
Mapping Summary" for example. It shows one instance of a clkctrl clock
controller with multiple clkctrl registers.

Cc: Paul Walmsley <paul@pwsan.com>
Acked-by: Rob Herring <robh@kernel.org>
Signed-off-by: Tony Lindgren <tony@atomide.com>
Signed-off-by: Tero Kristo <t-kristo@ti.com>
2017-06-15 10:47:13 +03:00
..
st drivers: clk: st: Handle clk synchronous mode for video clocks 2016-09-16 16:01:41 -07:00
ti clk: ti: Add support for dm814x ADPLL 2016-03-01 16:21:25 -08:00
alphascale,acc.txt ARM: add alphascale,acc.txt bindings documentation 2015-01-19 16:29:48 -08:00
altr_socfpga.txt ARM: socfpga: dts: Add div-reg to the main_pll clocks 2014-05-05 22:33:18 -05:00
amlogic,gxbb-aoclkc.txt dt-bindings: clock: reset: Add GXBB AO Clock and Reset Bindings 2016-08-19 12:49:00 -07:00
amlogic,gxbb-clkc.txt dt-bindings: clock: gxbb-clkc: Add GXL compatible variant 2017-04-04 11:00:07 -07:00
amlogic,meson8b-clkc.txt clk: meson: Document bindings for Meson8b clock controller 2015-06-05 17:22:09 -07:00
arm-integrator.txt Merge branch 'for-linus' of git://git.kernel.org/pub/scm/linux/kernel/git/jikos/trivial 2014-10-07 21:16:26 -04:00
arm-syscon-icst.txt clk: versatile add DT bindings for the ICST CM variants 2016-08-25 13:03:37 -07:00
armada3700-periph-clock.txt dt-bindings: clock: add DT binding for the peripheral clocks on Armada 3700 2016-08-15 14:10:25 -07:00
armada3700-tbg-clock.txt dt-bindings: clock: add DT binding for the TBG clocks on Armada 3700 2016-08-15 14:07:40 -07:00
armada3700-xtal-clock.txt pinctrl: dt-bindings: Add documentation for Armada 37xx pin controllers 2017-04-24 11:28:09 +02:00
artpec6.txt clk: add device tree binding for Artpec-6 clock controller 2016-04-15 16:00:37 -07:00
at91-clock.txt clk: at91: Add sama5d4 sckc support 2016-09-20 17:02:58 -07:00
axi-clkgen.txt clk: axi-clkgen: Add multi-parent support 2016-01-29 17:06:14 -08:00
axs10x-i2s-pll-clock.txt clk/axs10x: Add I2S PLL clock driver 2016-05-06 10:35:04 -07:00
brcm,bcm2835-aux-clock.txt clk: bcm2835: Add bindings for the auxiliary peripheral clock gates. 2015-12-22 16:46:58 -08:00
brcm,bcm2835-cprman.txt clk: bcm2835: Register the DSI0/DSI1 pixel clocks. 2017-01-20 16:22:55 -08:00
brcm,bcm53573-ilp.txt clk: bcm: Add driver for BCM53573 ILP clock 2016-09-16 16:31:29 -07:00
brcm,iproc-clocks.txt Documentation: dt-bindings: Add DT bindings for Cygnus audio clock 2016-01-29 16:31:36 -08:00
brcm,kona-ccu.txt dt-bindings: brcm: rationalize Broadcom documentation naming 2015-03-26 12:14:11 -05:00
calxeda.txt
clk-exynos-audss.txt clk: samsung: clk-exynos-audss: Add exynos5410 compatible 2016-09-09 17:35:11 +02:00
clk-palmas-clk32kg-clocks.txt dt/bindings: Binding documentation for Palmas clk32kg and clk32kgaudio clocks 2014-07-01 21:37:57 -07:00
clk-s5pv210-audss.txt clk: samsung: Add S5PV210 Audio Subsystem clock driver 2014-07-19 04:25:08 +09:00
clock-bindings.txt clk: bindings: Fix assigned-clock-rates description 2015-05-13 12:32:51 -07:00
clps711x-clock.txt clk: clps711x: Changing the compatibility string to match with the smallest supported chip 2016-07-06 17:38:13 +02:00
cs2000-cp.txt clk: add CS2000 Fractional-N driver 2015-11-30 16:33:38 -08:00
csr,atlas7-car.txt clk: sirf: add CSR atlas7 clk and reset support 2015-05-20 15:43:28 -07:00
dove-divider-clock.txt dt-bindings: add Marvell core PLL and clock divider PMU documentation 2015-12-07 18:37:03 +01:00
efm32-clock.txt
emev2-clock.txt clk: emev2: Use generic names for device nodes 2015-05-07 11:32:41 -07:00
exynos4-clock.txt
exynos7-clock.txt clk: samsung: exynos7: add clocks for audio block 2015-01-15 15:18:51 +01:00
exynos3250-clock.txt clk: samsung: exynos3250: Add driver for CMU_ISP clock domain 2015-03-30 15:18:53 -07:00
exynos5250-clock.txt
exynos5260-clock.txt clk/exynos5260: add macros and documentation for exynos5260 2014-05-14 19:16:55 +02:00
exynos5410-clock.txt clk: samsung: Add support for EPLL on exynos5410 2016-09-09 17:35:13 +02:00
exynos5420-clock.txt clk: exynos5420: Add 5800 specific clocks 2014-05-19 22:15:08 +09:00
exynos5433-clock.txt clk: exynos5433: Add documentation for the audio block parent clocks 2016-11-17 13:58:49 +01:00
exynos5440-clock.txt
fixed-clock.txt Documentation: clock: fixed-clock: Remove unsupported 'gpios' property 2014-05-14 23:43:54 -07:00
fixed-factor-clock.txt clk: fixed-factor: Allow for a few clocks to change the parent rate 2016-07-01 17:16:59 -07:00
fujitsu,mb86s70-crg11.txt clk: Add clock driver for mb86s7x 2015-04-10 13:51:55 -07:00
gpio-gate-clock.txt clk: add gpio gated clock 2014-09-26 16:51:42 -07:00
gpio-mux-clock.txt clk: add gpio controlled clock multiplexer 2015-07-06 17:20:52 -07:00
hi3620-clock.txt
hi3660-clock.txt dt-bindings: Document the hi3660 clock bindings 2017-01-09 16:13:38 -08:00
hi6220-clock.txt dt-bindings: clk: Hi6220: Document stub clock driver 2015-08-24 16:49:10 -07:00
hisi-crg.txt clk: hisilicon: add CRG driver for Hi3798CV200 SoC 2016-11-11 15:43:49 -08:00
hix5hd2-clock.txt clk: hisi: add clk-hix5hd2.c 2014-05-12 11:30:32 +08:00
idt,versaclock5.txt clk: vc5: Add bindings for IDT VersaClock 5P49V5935 2017-04-19 09:08:48 -07:00
imx1-clock.txt ARM: i.MX1 clk: Add devicetree support 2014-07-18 16:10:03 +08:00
imx5-clock.txt
imx6q-clock.txt ARM: imx6qdl: switch to use macro for clock ID 2014-07-18 16:11:23 +08:00
imx6sl-clock.txt
imx6sx-clock.txt ARM: imx: add clock driver for imx6sx 2014-05-16 15:35:19 +08:00
imx6ul-clock.txt Document: dt: binding: imx: update document for imx6ul support 2015-08-11 23:15:16 +08:00
imx7d-clock.txt Document: dt: binding: imx: update document for imx7d support 2015-06-03 15:03:59 +08:00
imx21-clock.txt ARM: i.MX21 clk: Add devicetree support 2014-07-18 16:11:32 +08:00
imx23-clock.txt
imx25-clock.txt ARM: mx25: Add CLKO support 2014-05-16 22:51:34 +08:00
imx27-clock.txt ARM: i.MX27 clk: Introduce DT include for clock provider 2014-07-18 16:11:38 +08:00
imx28-clock.txt
imx31-clock.txt ARM: dts: imx31: fix clock control module interrupts description 2016-11-01 16:42:41 +08:00
imx35-clock.txt ARM: dts: imx35: restore existing used clock enumeration 2016-04-18 12:37:21 +08:00
ingenic,cgu.txt DEVICETREE: Add Ingenic CGU binding documentation 2015-06-21 21:53:13 +02:00
keystone-gate.txt
keystone-pll.txt clk: keystone: add support for post divider register for main pll 2015-06-18 15:36:33 -07:00
lpc1850-ccu.txt doc: dt: add documentation for lpc1850-ccu clk driver 2015-06-18 15:44:48 -07:00
lpc1850-cgu.txt doc: dt: add documentation for lpc1850-cgu clk driver 2015-06-18 15:44:47 -07:00
lpc1850-creg-clk.txt doc: dt: add documentation for lpc1850-creg-clk driver 2016-03-04 12:53:20 -08:00
lsi,axm5516-clks.txt clk: Add clock driver for AXM55xx SoC 2014-05-22 22:06:14 -07:00
marvell,berlin.txt Documentation: bindings: move the Berlin clock documentation 2015-05-16 00:07:47 +02:00
marvell,mmp2.txt clk: mmp: add mmp2 DT support for clock driver 2014-11-12 16:34:22 -08:00
marvell,pxa168.txt clk: mmp: add pxa168 DT support for clock driver 2014-11-12 16:34:14 -08:00
marvell,pxa910.txt clk: mmp: add pxa910 DT support for clock driver 2014-11-12 16:34:18 -08:00
marvell,pxa1928.txt dt-bindings: Add pxa1928 clock binding 2015-05-15 12:31:38 -07:00
maxim,max77686.txt clk: max77686: Add DT binding details for PMIC MAX77620 2016-08-15 15:33:14 -07:00
microchip,pic32.txt dt/bindings/clk: Add PIC32 clock binding documentation. 2016-05-13 15:30:25 +02:00
moxa,moxart-clock.txt
mt8173-cpu-dvfs.txt dt-bindings: mediatek: Add MT8173 CPU DVFS clock bindings 2015-09-01 15:50:11 +02:00
mvebu-core-clock.txt ARM: dts: mvebu: Move mv98dx3236 clock bindings 2017-03-08 09:52:54 +01:00
mvebu-corediv-clock.txt clk: mvebu: support for 98DX3236 SoC 2017-01-27 10:48:03 -08:00
mvebu-cpu-clock.txt clk: mvebu: support for 98DX3236 SoC 2017-01-27 10:48:03 -08:00
mvebu-gated-clock.txt ARM: dts: mvebu: Move mv98dx3236 clock bindings 2017-03-08 09:52:54 +01:00
nspire-clock.txt
nvidia,tegra20-car.txt
nvidia,tegra30-car.txt
nvidia,tegra114-car.txt
nvidia,tegra124-car.txt of: document external-memory-controller property in tegra124-car 2015-05-13 15:17:10 +02:00
nvidia,tegra124-dfll.txt dt-bindings: tegra: Remove 0, prefix from unit-addresses 2016-04-19 17:25:18 -05:00
nvidia,tegra210-car.txt clk: tegra: Add Tegra210 device tree binding 2015-11-16 08:21:56 +01:00
nxp,lpc3220-clk.txt dt-bindings: clock: add description of LPC32xx clock controller 2015-12-24 12:31:19 -08:00
nxp,lpc3220-usb-clk.txt dt-bindings: clock: add description of LPC32xx USB clock controller 2015-12-24 12:31:21 -08:00
oxnas,stdclk.txt dt-bindings: clk: oxnas,stdclk: Add OX820 bindings 2016-10-23 10:19:03 -07:00
pistachio-clock.txt CLK: Add binding document for Pistachio clock controllers 2015-03-27 18:51:31 +01:00
prima2-clock.txt
pwm-clock.txt clk: Add PWM clock driver 2015-04-10 14:44:43 -07:00
pxa-clock.txt clk: dts: document pxa clock binding 2014-09-30 12:31:31 -07:00
qca,ath79-pll.txt dt-bindings: clock: qca,ath79-pll: fix copy-paste typos 2016-04-03 12:32:09 +02:00
qcom,gcc.txt dt-bindings: qcom: clocks: Add msm8994 clock bindings 2016-11-10 14:27:29 -08:00
qcom,lcc.txt dt-bindings: clock: Update bindings for MDM9615 GCC and LCC 2016-08-15 16:06:40 -07:00
qcom,mmcc.txt clk: qcom: Add MSM8996 Multimedia Clock Controller (MMCC) driver 2015-11-30 18:24:30 -08:00
qcom,rpmcc.txt clk: qcom: smd-rpmcc: Add msm8974 clocks 2016-12-21 16:04:35 -08:00
qoriq-clock.txt dt-bindings: clockgen: Add compatible string for LS1088A 2017-04-04 20:57:02 +08:00
renesas,cpg-div6-clocks.txt clk: shmobile: div6: Make clock-output-names optional 2015-12-08 14:32:58 +01:00
renesas,cpg-mssr.txt dt-bindings: clock: renesas: cpg-mssr: Document reset control support 2017-01-27 08:58:58 +01:00
renesas,cpg-mstp-clocks.txt clk: renesas: mstp: Document R8A7792 support 2016-06-21 09:19:29 +02:00
renesas,h8s2678-pll-clock.txt h8300: clock driver 2015-06-23 13:35:55 +09:00
renesas,h8300-div-clock.txt clk: h8300: Remove "sh73a0-" part from compatible value 2016-01-20 22:43:26 +09:00
renesas,r8a73a4-cpg-clocks.txt clk: shmobile: r8a73a4 common clock framework implementation 2015-01-08 16:14:30 +01:00
renesas,r8a7740-cpg-clocks.txt clk: shmobile: Add R8A7740-specific clock support 2014-05-23 13:38:25 -07:00
renesas,r8a7778-cpg-clocks.txt clk: shmobile: r8a7778: Add CPG/MSTP Clock Domain support 2015-08-12 10:31:27 +09:00
renesas,r8a7779-cpg-clocks.txt clk: shmobile: r8a7779: Add CPG/MSTP Clock Domain support 2015-08-12 10:31:27 +09:00
renesas,rcar-gen2-cpg-clocks.txt clk: renesas: rcar-gen2: Document R8A7792 support 2016-06-21 09:19:00 +02:00
renesas,rz-cpg-clocks.txt clk: shmobile: rz: Add CPG/MSTP Clock Domain support 2015-08-12 10:31:28 +09:00
renesas,sh73a0-cpg-clocks.txt clk: shmobile: sh73a0 common clock framework implementation 2014-12-21 17:09:20 +09:00
rockchip,rk3036-cru.txt clk: rockchip: rk3036: rename emac ext source clock 2016-01-16 16:01:21 +01:00
rockchip,rk3188-cru.txt Documentation: dt: clock: fix spelling mistakes 2016-04-25 08:40:35 -05:00
rockchip,rk3228-cru.txt dt-bindings: add documentation of rk3228 clock controller 2015-12-12 20:04:51 +01:00
rockchip,rk3288-cru.txt Documentation: dt: clock: fix spelling mistakes 2016-04-25 08:40:35 -05:00
rockchip,rk3328-cru.txt dt-bindings: add bindings for rk3328 clock controller 2017-01-05 13:07:59 +01:00
rockchip,rk3368-cru.txt dt-bindings: add documentation of rk3668 clock controller 2015-07-06 15:08:24 -07:00
rockchip,rk3399-cru.txt dt-bindings: clk: add rockchip,grf property for RK3399 2017-01-13 20:02:27 +01:00
rockchip,rv1108-cru.txt dt-bindings: rk1108-cru: rename RK1108 to RV1108 2017-03-22 18:02:57 +01:00
rockchip.txt dt-bindings: add documentation for rk3188 clock and reset unit 2014-07-13 12:17:08 -07:00
samsung,s2mps11.txt dt-bindings: regulator/clock/mfd: Reorganize S2MPS-family bindings 2016-01-14 08:43:48 +00:00
samsung,s3c64xx-clock.txt
samsung,s3c2410-clock.txt ARM: S3C24XX: Remove omitted Kconfig selects and conditionals 2014-05-14 19:41:14 +02:00
samsung,s3c2412-clock.txt dt-bindings: add documentation for s3c2412 clock controller 2014-04-15 02:11:36 +09:00
samsung,s3c2443-clock.txt dt-bindings: add binding for clock-controller of s3c2443 and following 2014-04-15 02:11:07 +09:00
samsung,s5pv210-clock.txt clk: samsung: Add clock driver for S5PV210 and compatible SoCs 2014-07-19 04:24:42 +09:00
silabs,si514.txt Add driver for the si514 clock generator chip 2015-10-08 23:52:55 -07:00
silabs,si570.txt
silabs,si5351.txt clk: si5351: Mention clock-names in the binding documentation 2015-05-08 11:22:29 -07:00
st,nomadik.txt
st,stm32-rcc.txt clk: stm32f7: Add stm32f7 clock DT bindings for STM32F746 boards 2017-01-20 16:37:43 -08:00
ste-u300-syscon-clock.txt
stericsson,abx500.txt clk: ux500: Add device tree bindings for ABx500 clocks 2017-01-26 16:10:01 -08:00
sun9i-de.txt clk: sunxi-ng: Add A80 Display Engine CCU 2017-01-30 08:38:30 +01:00
sun9i-usb.txt clk: sunxi-ng: Add A80 USB CCU 2017-01-30 08:37:51 +01:00
sunxi-ccu.txt dt-bindings: update device tree binding for Allwinner PRCM CCUs 2017-04-04 17:43:45 +02:00
sunxi.txt clk: sunxi: Add display and TCON0 clocks driver 2016-05-12 14:47:52 -07:00
tango4-clock.txt clk: tango4: clkgen driver for Tango4 platforms 2015-11-16 11:07:06 -08:00
ti-clkctrl.txt Documentation: dt-bindings: Add binding documentation for TI clkctrl clocks 2017-06-15 10:47:13 +03:00
ti-keystone-pllctrl.txt Documentation: dt: add bindings for keystone pll control controller 2014-05-27 09:46:39 -04:00
ti,cdce706.txt clk: TI CDCE706 clock synthesizer driver 2015-01-17 13:52:40 -08:00
ti,cdce925.txt clk: cdce925: add support for CDCE913, CDCE937, and CDCE949 2017-01-09 16:38:30 -08:00
uniphier-clock.txt clk: uniphier: rename MIO clock to SD clock for Pro5, PXs2, LD20 SoCs 2016-10-19 13:15:05 -07:00
ux500.txt clk: add bindings for the Ux500 clocks 2015-08-24 16:49:15 -07:00
vf610-clock.txt ARM: dts: vf610: assign oscillator to clock module 2014-11-23 15:08:09 +08:00
vt8500.txt
xgene.txt Documentation: dt: xgene: Add PMD clock binding 2016-09-14 13:53:53 -07:00
zx296702-clk.txt ARM: dts: zx: add an initial zx296702 dts and doc 2015-06-11 16:18:30 -07:00
zx296718-clk.txt dt-bindings: zx296718-clk: add compatible for audio clock controller 2017-01-09 16:06:42 -08:00
zynq-7000.txt