15d6298f2SSam Protsenko# SPDX-License-Identifier: (GPL-2.0-only OR BSD-2-Clause) 25d6298f2SSam Protsenko%YAML 1.2 35d6298f2SSam Protsenko--- 45d6298f2SSam Protsenko$id: http://devicetree.org/schemas/clock/samsung,exynos850-clock.yaml# 55d6298f2SSam Protsenko$schema: http://devicetree.org/meta-schemas/core.yaml# 65d6298f2SSam Protsenko 75d6298f2SSam Protsenkotitle: Samsung Exynos850 SoC clock controller 85d6298f2SSam Protsenko 95d6298f2SSam Protsenkomaintainers: 105d6298f2SSam Protsenko - Sam Protsenko <semen.protsenko@linaro.org> 115d6298f2SSam Protsenko - Chanwoo Choi <cw00.choi@samsung.com> 128a1e6bb3SKrzysztof Kozlowski - Krzysztof Kozlowski <krzk@kernel.org> 135d6298f2SSam Protsenko - Sylwester Nawrocki <s.nawrocki@samsung.com> 145d6298f2SSam Protsenko - Tomasz Figa <tomasz.figa@gmail.com> 155d6298f2SSam Protsenko 165d6298f2SSam Protsenkodescription: | 175d6298f2SSam Protsenko Exynos850 clock controller is comprised of several CMU units, generating 185d6298f2SSam Protsenko clocks for different domains. Those CMU units are modeled as separate device 195d6298f2SSam Protsenko tree nodes, and might depend on each other. Root clocks in that clock tree are 205d6298f2SSam Protsenko two external clocks:: OSCCLK (26 MHz) and RTCCLK (32768 Hz). Those external 215d6298f2SSam Protsenko clocks must be defined as fixed-rate clocks in dts. 225d6298f2SSam Protsenko 235d6298f2SSam Protsenko CMU_TOP is a top-level CMU, where all base clocks are prepared using PLLs and 245d6298f2SSam Protsenko dividers; all other leaf clocks (other CMUs) are usually derived from CMU_TOP. 255d6298f2SSam Protsenko 265d6298f2SSam Protsenko Each clock is assigned an identifier and client nodes can use this identifier 275d6298f2SSam Protsenko to specify the clock which they consume. All clocks available for usage 285d6298f2SSam Protsenko in clock consumer nodes are defined as preprocessor macros in 295d6298f2SSam Protsenko 'dt-bindings/clock/exynos850.h' header. 305d6298f2SSam Protsenko 315d6298f2SSam Protsenkoproperties: 325d6298f2SSam Protsenko compatible: 335d6298f2SSam Protsenko enum: 345d6298f2SSam Protsenko - samsung,exynos850-cmu-top 3516e0c247SSam Protsenko - samsung,exynos850-cmu-apm 36*45bbf4d7SSam Protsenko - samsung,exynos850-cmu-aud 37c2afeb79SSam Protsenko - samsung,exynos850-cmu-cmgp 385d6298f2SSam Protsenko - samsung,exynos850-cmu-core 395d6298f2SSam Protsenko - samsung,exynos850-cmu-dpu 405d6298f2SSam Protsenko - samsung,exynos850-cmu-hsi 415d6298f2SSam Protsenko - samsung,exynos850-cmu-peri 425d6298f2SSam Protsenko 435d6298f2SSam Protsenko clocks: 445d6298f2SSam Protsenko minItems: 1 455d6298f2SSam Protsenko maxItems: 5 465d6298f2SSam Protsenko 475d6298f2SSam Protsenko clock-names: 485d6298f2SSam Protsenko minItems: 1 495d6298f2SSam Protsenko maxItems: 5 505d6298f2SSam Protsenko 515d6298f2SSam Protsenko "#clock-cells": 525d6298f2SSam Protsenko const: 1 535d6298f2SSam Protsenko 545d6298f2SSam Protsenko reg: 555d6298f2SSam Protsenko maxItems: 1 565d6298f2SSam Protsenko 575d6298f2SSam ProtsenkoallOf: 585d6298f2SSam Protsenko - if: 595d6298f2SSam Protsenko properties: 605d6298f2SSam Protsenko compatible: 615d6298f2SSam Protsenko contains: 625d6298f2SSam Protsenko const: samsung,exynos850-cmu-top 635d6298f2SSam Protsenko 645d6298f2SSam Protsenko then: 655d6298f2SSam Protsenko properties: 665d6298f2SSam Protsenko clocks: 675d6298f2SSam Protsenko items: 685d6298f2SSam Protsenko - description: External reference clock (26 MHz) 695d6298f2SSam Protsenko 705d6298f2SSam Protsenko clock-names: 715d6298f2SSam Protsenko items: 725d6298f2SSam Protsenko - const: oscclk 735d6298f2SSam Protsenko 745d6298f2SSam Protsenko - if: 755d6298f2SSam Protsenko properties: 765d6298f2SSam Protsenko compatible: 775d6298f2SSam Protsenko contains: 7816e0c247SSam Protsenko const: samsung,exynos850-cmu-apm 7916e0c247SSam Protsenko 8016e0c247SSam Protsenko then: 8116e0c247SSam Protsenko properties: 8216e0c247SSam Protsenko clocks: 8316e0c247SSam Protsenko items: 8416e0c247SSam Protsenko - description: External reference clock (26 MHz) 8516e0c247SSam Protsenko - description: CMU_APM bus clock (from CMU_TOP) 8616e0c247SSam Protsenko 8716e0c247SSam Protsenko clock-names: 8816e0c247SSam Protsenko items: 8916e0c247SSam Protsenko - const: oscclk 9016e0c247SSam Protsenko - const: dout_clkcmu_apm_bus 9116e0c247SSam Protsenko 9216e0c247SSam Protsenko - if: 9316e0c247SSam Protsenko properties: 9416e0c247SSam Protsenko compatible: 9516e0c247SSam Protsenko contains: 96*45bbf4d7SSam Protsenko const: samsung,exynos850-cmu-aud 97*45bbf4d7SSam Protsenko 98*45bbf4d7SSam Protsenko then: 99*45bbf4d7SSam Protsenko properties: 100*45bbf4d7SSam Protsenko clocks: 101*45bbf4d7SSam Protsenko items: 102*45bbf4d7SSam Protsenko - description: External reference clock (26 MHz) 103*45bbf4d7SSam Protsenko - description: AUD clock (from CMU_TOP) 104*45bbf4d7SSam Protsenko 105*45bbf4d7SSam Protsenko clock-names: 106*45bbf4d7SSam Protsenko items: 107*45bbf4d7SSam Protsenko - const: oscclk 108*45bbf4d7SSam Protsenko - const: dout_aud 109*45bbf4d7SSam Protsenko 110*45bbf4d7SSam Protsenko - if: 111*45bbf4d7SSam Protsenko properties: 112*45bbf4d7SSam Protsenko compatible: 113*45bbf4d7SSam Protsenko contains: 114c2afeb79SSam Protsenko const: samsung,exynos850-cmu-cmgp 115c2afeb79SSam Protsenko 116c2afeb79SSam Protsenko then: 117c2afeb79SSam Protsenko properties: 118c2afeb79SSam Protsenko clocks: 119c2afeb79SSam Protsenko items: 120c2afeb79SSam Protsenko - description: External reference clock (26 MHz) 121c2afeb79SSam Protsenko - description: CMU_CMGP bus clock (from CMU_APM) 122c2afeb79SSam Protsenko 123c2afeb79SSam Protsenko clock-names: 124c2afeb79SSam Protsenko items: 125c2afeb79SSam Protsenko - const: oscclk 126c2afeb79SSam Protsenko - const: gout_clkcmu_cmgp_bus 127c2afeb79SSam Protsenko 128c2afeb79SSam Protsenko - if: 129c2afeb79SSam Protsenko properties: 130c2afeb79SSam Protsenko compatible: 131c2afeb79SSam Protsenko contains: 1325d6298f2SSam Protsenko const: samsung,exynos850-cmu-core 1335d6298f2SSam Protsenko 1345d6298f2SSam Protsenko then: 1355d6298f2SSam Protsenko properties: 1365d6298f2SSam Protsenko clocks: 1375d6298f2SSam Protsenko items: 1385d6298f2SSam Protsenko - description: External reference clock (26 MHz) 1395d6298f2SSam Protsenko - description: CMU_CORE bus clock (from CMU_TOP) 1405d6298f2SSam Protsenko - description: CCI clock (from CMU_TOP) 1415d6298f2SSam Protsenko - description: eMMC clock (from CMU_TOP) 1425d6298f2SSam Protsenko - description: SSS clock (from CMU_TOP) 1435d6298f2SSam Protsenko 1445d6298f2SSam Protsenko clock-names: 1455d6298f2SSam Protsenko items: 1465d6298f2SSam Protsenko - const: oscclk 1475d6298f2SSam Protsenko - const: dout_core_bus 1485d6298f2SSam Protsenko - const: dout_core_cci 1495d6298f2SSam Protsenko - const: dout_core_mmc_embd 1505d6298f2SSam Protsenko - const: dout_core_sss 1515d6298f2SSam Protsenko 1525d6298f2SSam Protsenko - if: 1535d6298f2SSam Protsenko properties: 1545d6298f2SSam Protsenko compatible: 1555d6298f2SSam Protsenko contains: 1565d6298f2SSam Protsenko const: samsung,exynos850-cmu-dpu 1575d6298f2SSam Protsenko 1585d6298f2SSam Protsenko then: 1595d6298f2SSam Protsenko properties: 1605d6298f2SSam Protsenko clocks: 1615d6298f2SSam Protsenko items: 1625d6298f2SSam Protsenko - description: External reference clock (26 MHz) 1635d6298f2SSam Protsenko - description: DPU clock (from CMU_TOP) 1645d6298f2SSam Protsenko 1655d6298f2SSam Protsenko clock-names: 1665d6298f2SSam Protsenko items: 1675d6298f2SSam Protsenko - const: oscclk 1685d6298f2SSam Protsenko - const: dout_dpu 1695d6298f2SSam Protsenko 1705d6298f2SSam Protsenko - if: 1715d6298f2SSam Protsenko properties: 1725d6298f2SSam Protsenko compatible: 1735d6298f2SSam Protsenko contains: 1745d6298f2SSam Protsenko const: samsung,exynos850-cmu-hsi 1755d6298f2SSam Protsenko 1765d6298f2SSam Protsenko then: 1775d6298f2SSam Protsenko properties: 1785d6298f2SSam Protsenko clocks: 1795d6298f2SSam Protsenko items: 1805d6298f2SSam Protsenko - description: External reference clock (26 MHz) 1815d6298f2SSam Protsenko - description: External RTC clock (32768 Hz) 1825d6298f2SSam Protsenko - description: CMU_HSI bus clock (from CMU_TOP) 1835d6298f2SSam Protsenko - description: SD card clock (from CMU_TOP) 1845d6298f2SSam Protsenko - description: "USB 2.0 DRD clock (from CMU_TOP)" 1855d6298f2SSam Protsenko 1865d6298f2SSam Protsenko clock-names: 1875d6298f2SSam Protsenko items: 1885d6298f2SSam Protsenko - const: oscclk 1895d6298f2SSam Protsenko - const: rtcclk 1905d6298f2SSam Protsenko - const: dout_hsi_bus 1915d6298f2SSam Protsenko - const: dout_hsi_mmc_card 1925d6298f2SSam Protsenko - const: dout_hsi_usb20drd 1935d6298f2SSam Protsenko 1945d6298f2SSam Protsenko - if: 1955d6298f2SSam Protsenko properties: 1965d6298f2SSam Protsenko compatible: 1975d6298f2SSam Protsenko contains: 1985d6298f2SSam Protsenko const: samsung,exynos850-cmu-peri 1995d6298f2SSam Protsenko 2005d6298f2SSam Protsenko then: 2015d6298f2SSam Protsenko properties: 2025d6298f2SSam Protsenko clocks: 2035d6298f2SSam Protsenko items: 2045d6298f2SSam Protsenko - description: External reference clock (26 MHz) 2055d6298f2SSam Protsenko - description: CMU_PERI bus clock (from CMU_TOP) 2065d6298f2SSam Protsenko - description: UART clock (from CMU_TOP) 2075d6298f2SSam Protsenko - description: Parent clock for HSI2C and SPI (from CMU_TOP) 2085d6298f2SSam Protsenko 2095d6298f2SSam Protsenko clock-names: 2105d6298f2SSam Protsenko items: 2115d6298f2SSam Protsenko - const: oscclk 2125d6298f2SSam Protsenko - const: dout_peri_bus 2135d6298f2SSam Protsenko - const: dout_peri_uart 2145d6298f2SSam Protsenko - const: dout_peri_ip 2155d6298f2SSam Protsenko 2165d6298f2SSam Protsenkorequired: 2175d6298f2SSam Protsenko - compatible 2185d6298f2SSam Protsenko - "#clock-cells" 2195d6298f2SSam Protsenko - clocks 2205d6298f2SSam Protsenko - clock-names 2215d6298f2SSam Protsenko - reg 2225d6298f2SSam Protsenko 2235d6298f2SSam ProtsenkoadditionalProperties: false 2245d6298f2SSam Protsenko 2255d6298f2SSam Protsenkoexamples: 2265d6298f2SSam Protsenko # Clock controller node for CMU_PERI 2275d6298f2SSam Protsenko - | 2285d6298f2SSam Protsenko #include <dt-bindings/clock/exynos850.h> 2295d6298f2SSam Protsenko 2305d6298f2SSam Protsenko cmu_peri: clock-controller@10030000 { 2315d6298f2SSam Protsenko compatible = "samsung,exynos850-cmu-peri"; 2325d6298f2SSam Protsenko reg = <0x10030000 0x8000>; 2335d6298f2SSam Protsenko #clock-cells = <1>; 2345d6298f2SSam Protsenko 2355d6298f2SSam Protsenko clocks = <&oscclk>, <&cmu_top CLK_DOUT_PERI_BUS>, 2365d6298f2SSam Protsenko <&cmu_top CLK_DOUT_PERI_UART>, 2375d6298f2SSam Protsenko <&cmu_top CLK_DOUT_PERI_IP>; 2385d6298f2SSam Protsenko clock-names = "oscclk", "dout_peri_bus", 2395d6298f2SSam Protsenko "dout_peri_uart", "dout_peri_ip"; 2405d6298f2SSam Protsenko }; 2415d6298f2SSam Protsenko 2425d6298f2SSam Protsenko... 243