|
| 1 | +Binding for a type of flexgen structure found on certain |
| 2 | +STMicroelectronics consumer electronics SoC devices |
| 3 | + |
| 4 | +This structure includes: |
| 5 | +- a clock cross bar (represented by a mux element) |
| 6 | +- a pre and final dividers (represented by a divider and gate elements) |
| 7 | + |
| 8 | +Flexgen structure is a part of Clockgen[1]. |
| 9 | + |
| 10 | +Please find an example below: |
| 11 | + |
| 12 | + Clockgen block diagram |
| 13 | + ------------------------------------------------------------------- |
| 14 | + | Flexgen stucture | |
| 15 | + | --------------------------------------------- | |
| 16 | + | | ------- -------- -------- | | |
| 17 | +clk_sysin | | | | | | | | | |
| 18 | +---|-----------------|-->| | | | | | | | |
| 19 | + | | | | | | | | | | | |
| 20 | + | | ------- | | | |Pre | |Final | | | |
| 21 | + | | |PLL0 | | | | |Dividers| |Dividers| | | |
| 22 | + | |->| | | | | | x32 | | x32 | | | |
| 23 | + | | | odf_0|----|-->| | | | | | | | |
| 24 | + | | | | | | | | | | | | | |
| 25 | + | | | | | | | | | | | | | |
| 26 | + | | | | | | | | | | | | | |
| 27 | + | | | | | | | | | | | | | |
| 28 | + | | ------- | | | | | | | | | |
| 29 | + | | | | | | | | | | | |
| 30 | + | | ------- | | Clock | | | | | | | |
| 31 | + | | |PLL1 | | | | | | | | | | |
| 32 | + | |->| | | | Cross | | | | | | | |
| 33 | + | | | odf_0|----|-->| | | | | | CLK_DIV[31:0] |
| 34 | + | | | | | | Bar |====>| |====>| |===|=========> |
| 35 | + | | | | | | | | | | | | | |
| 36 | + | | | | | | | | | | | | | |
| 37 | + | | | | | | | | | | | | | |
| 38 | + | | ------- | | | | | | | | | |
| 39 | + | | | | | | | | | | | |
| 40 | + | | ------- | | | | | | | | | |
| 41 | + | | |QUADFS | | | | | | | | | | |
| 42 | + | |->| ch0|----|-->| | | | | | | | |
| 43 | + | | | | | | | | | | | | |
| 44 | + | | ch1|----|-->| | | | | | | | |
| 45 | + | | | | | | | | | | | | |
| 46 | + | | ch2|----|-->| | | DIV | | DIV | | | |
| 47 | + | | | | | | | 1 to | | 1 to | | | |
| 48 | + | | ch3|----|-->| | | 1024 | | 64 | | | |
| 49 | + | ------- | | | | | | | | | |
| 50 | + | | ------- -------- -------- | | |
| 51 | + | -------------------------------------------- | |
| 52 | + | | |
| 53 | + ------------------------------------------------------------------- |
| 54 | + |
| 55 | +This binding uses the common clock binding[2]. |
| 56 | + |
| 57 | +[1] Documentation/devicetree/bindings/clock/st/st,clkgen.txt |
| 58 | +[2] Documentation/devicetree/bindings/clock/clock-bindings.txt |
| 59 | + |
| 60 | +Required properties: |
| 61 | +- compatible : shall be: |
| 62 | + "st,flexgen" |
| 63 | + |
| 64 | +- #clock-cells : from common clock binding; shall be set to 1 (multiple clock |
| 65 | + outputs). |
| 66 | + |
| 67 | +- clocks : must be set to the parent's phandle. it's could be output clocks of |
| 68 | + a quadsfs or/and a pll or/and clk_sysin (up to 7 clocks) |
| 69 | + |
| 70 | +- clock-output-names : List of strings used to name the clock outputs. |
| 71 | + |
| 72 | +Example: |
| 73 | + |
| 74 | + clk_s_c0_flexgen: clk-s-c0-flexgen { |
| 75 | + |
| 76 | + #clock-cells = <1>; |
| 77 | + compatible = "st,flexgen"; |
| 78 | + |
| 79 | + clocks = <&clk_s_c0_pll0 0>, |
| 80 | + <&clk_s_c0_pll1 0>, |
| 81 | + <&clk_s_c0_quadfs 0>, |
| 82 | + <&clk_s_c0_quadfs 1>, |
| 83 | + <&clk_s_c0_quadfs 2>, |
| 84 | + <&clk_s_c0_quadfs 3>, |
| 85 | + <&clk_sysin>; |
| 86 | + |
| 87 | + clock-output-names = "clk-icn-gpu", |
| 88 | + "clk-fdma", |
| 89 | + "clk-nand", |
| 90 | + "clk-hva", |
| 91 | + "clk-proc-stfe", |
| 92 | + "clk-proc-tp", |
| 93 | + "clk-rx-icn-dmu", |
| 94 | + "clk-rx-icn-hva", |
| 95 | + "clk-icn-cpu", |
| 96 | + "clk-tx-icn-dmu", |
| 97 | + "clk-mmc-0", |
| 98 | + "clk-mmc-1", |
| 99 | + "clk-jpegdec", |
| 100 | + "clk-ext2fa9", |
| 101 | + "clk-ic-bdisp-0", |
| 102 | + "clk-ic-bdisp-1", |
| 103 | + "clk-pp-dmu", |
| 104 | + "clk-vid-dmu", |
| 105 | + "clk-dss-lpc", |
| 106 | + "clk-st231-aud-0", |
| 107 | + "clk-st231-gp-1", |
| 108 | + "clk-st231-dmu", |
| 109 | + "clk-icn-lmi", |
| 110 | + "clk-tx-icn-disp-1", |
| 111 | + "clk-icn-sbc", |
| 112 | + "clk-stfe-frc2", |
| 113 | + "clk-eth-phy", |
| 114 | + "clk-eth-ref-phyclk", |
| 115 | + "clk-flash-promip", |
| 116 | + "clk-main-disp", |
| 117 | + "clk-aux-disp", |
| 118 | + "clk-compo-dvp"; |
| 119 | + }; |
0 commit comments