tjh.dev
Linux kernel mirror (for testing)
git.kernel.org/pub/scm/linux/kernel/git/torvalds/linux.git
kernel
os
linux
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};