1Cirrus Logic Lochnagar Audio Development Board 2 3Lochnagar is an evaluation and development board for Cirrus Logic 4Smart CODEC and Amp devices. It allows the connection of most Cirrus 5Logic devices on mini-cards, as well as allowing connection of 6various application processor systems to provide a full evaluation 7platform. Audio system topology, clocking and power can all be 8controlled through the Lochnagar, allowing the device under test 9to be used in a variety of possible use cases. 10 11This binding document describes the binding for the clock portion of 12the driver. 13 14Also see these documents for generic binding information: 15 [1] Clock : ../clock/clock-bindings.txt 16 17And these for relevant defines: 18 [2] include/dt-bindings/clock/lochnagar.h 19 20This binding must be part of the Lochnagar MFD binding: 21 [3] ../mfd/cirrus,lochnagar.txt 22 23Required properties: 24 25 - compatible : One of the following strings: 26 "cirrus,lochnagar1-clk" 27 "cirrus,lochnagar2-clk" 28 29 - #clock-cells : Must be 1. The first cell indicates the clock 30 number, see [2] for available clocks and [1]. 31 32Optional properties: 33 34 - clocks : Must contain an entry for each clock in clock-names. 35 - clock-names : May contain entries for each of the following 36 clocks: 37 - ln-cdc-clkout : Output clock from CODEC card. 38 - ln-dsp-clkout : Output clock from DSP card. 39 - ln-gf-mclk1,ln-gf-mclk2,ln-gf-mclk3,ln-gf-mclk4 : Optional 40 input audio clocks from host system. 41 - ln-psia1-mclk, ln-psia2-mclk : Optional input audio clocks from 42 external connector. 43 - ln-spdif-mclk : Optional input audio clock from SPDIF. 44 - ln-spdif-clkout : Optional input audio clock from SPDIF. 45 - ln-adat-mclk : Optional input audio clock from ADAT. 46 - ln-pmic-32k : On board fixed clock. 47 - ln-clk-12m : On board fixed clock. 48 - ln-clk-11m : On board fixed clock. 49 - ln-clk-24m : On board fixed clock. 50 - ln-clk-22m : On board fixed clock. 51 - ln-clk-8m : On board fixed clock. 52 - ln-usb-clk-24m : On board fixed clock. 53 - ln-usb-clk-12m : On board fixed clock. 54 55 - assigned-clocks : A list of Lochnagar clocks to be reparented, see 56 [2] for available clocks. 57 - assigned-clock-parents : Parents to be assigned to the clocks 58 listed in "assigned-clocks". 59 60Optional nodes: 61 62 - fixed-clock nodes may be registered for the following on board clocks: 63 - ln-pmic-32k : 32768 Hz 64 - ln-clk-12m : 12288000 Hz 65 - ln-clk-11m : 11298600 Hz 66 - ln-clk-24m : 24576000 Hz 67 - ln-clk-22m : 22579200 Hz 68 - ln-clk-8m : 8192000 Hz 69 - ln-usb-clk-24m : 24576000 Hz 70 - ln-usb-clk-12m : 12288000 Hz 71 72Example: 73 74lochnagar { 75 lochnagar-clk { 76 compatible = "cirrus,lochnagar2-clk"; 77 78 #clock-cells = <1>; 79 80 clocks = <&clk-audio>, <&clk_pmic>; 81 clock-names = "ln-gf-mclk2", "ln-pmic-32k"; 82 83 assigned-clocks = <&lochnagar-clk LOCHNAGAR_CDC_MCLK1>, 84 <&lochnagar-clk LOCHNAGAR_CDC_MCLK2>; 85 assigned-clock-parents = <&clk-audio>, 86 <&clk-pmic>; 87 }; 88 89 clk-pmic: clk-pmic { 90 compatible = "fixed-clock"; 91 clock-cells = <0>; 92 clock-frequency = <32768>; 93 }; 94}; 95