On 23 February 2016 at 19:08, Rob Herring [off-list ref] wrote:

On Sat, Feb 20, 2016 at 07:53:37PM +0100, Joachim Eastwood wrote:

quoted

Add DT binding documentation for lpc1850-creg-clk driver.

Signed-off-by: Joachim Eastwood <redacted>
---
 .../devicetree/bindings/clock/lpc1850-creg-clk.txt | 52 ++++++++++++++++++++++
 1 file changed, 52 insertions(+)
 create mode 100644 Documentation/devicetree/bindings/clock/lpc1850-creg-clk.txt

diff --git a/Documentation/devicetree/bindings/clock/lpc1850-creg-clk.txt b/Documentation/devicetree/bindings/clock/lpc1850-creg-clk.txt
new file mode 100644
index 000000000000..0c83d373b766
--- /dev/null
+++ b/Documentation/devicetree/bindings/clock/lpc1850-creg-clk.txt

@@ -0,0 +1,52 @@
+* NXP LPC1850 CREG clocks
+
+The NXP LPC18xx/43xx CREG (Configuration Registers) block contains
+control registers for two low speed clocks. One of the clocks is a
+32 kHz oscillator driver with power up/down and clock gating. Next
+is a fixed divider that creates a 1 kHz clock from the 32 kHz osc.
+
+These clocks are used by the RTC and the Event Router peripherials.
+The 32 kHz can also be routed to other peripherials to enable low
+power modes.
+
+This binding uses the common clock binding:
+    Documentation/devicetree/bindings/clock/clock-bindings.txt
+
+Required properties:
+- compatible:
+     Should be "nxp,lpc1850-creg-clk"
+- #clock-cells:
+     Shall have value <1>.
+- clocks:
+     Shall contain a phandle to the fix 32 kHz crystall.
+
+The creg-clk node must be a child of the creg syscon node.
+
+The following clocks are available from the clock node.
+
+Clock ID     Name
+   0          1 kHz clock
+   1         32 kHz Oscillator
+
+Example:
+soc {
+     creg: syscon@40043000 {
+             compatible = "nxp,lpc1850-creg", "syscon", "simple-mfd";
+             reg = <0x40043000 0x1000>;
+
+             creg_clk: clock-controller@004 {

What is 4? A unit address should have a corresponding reg prop. and no
leading zeros.

It is the fourth register in the creg syscon block.

Does this look better:
creg_clk: clock-controller@4 {
    compatible = "nxp,lpc1850-creg-clk";
    reg = <0x4>;
    clocks = <&xtal32>;
    #clock-cells = <1>;
};

Note that the reg property isn't really useful in the driver, but I
guess we should have it either way(?).

Alternatively I could drop the unit address and reg property. What do you think?


regards,
Joachim Eastwood