new file mode 100644
@@ -0,0 +1,37 @@
+Binding for discoverable-fixed-rate clock sources.
+
+This binding uses the common clock binding[1].
+
+[1] Documentation/devicetree/bindings/clock/clock-bindings.txt
+
+Required properties:
+- compatible : shall be "specified-clock".
+- #clock-cells : from common clock binding; shall be set to 0.
+- reg : Base address of configuration register specifying the frequency.
+- bit-mask : Mask of bits in the field specifying the frequency.
+- table : array of integer pairs defining register field values and
+ corresponding clock frequencies in Hz.
+
+Optional properties:
+- bit-shift : Number of bits to shift the masked register value,
+ defaults to (ffs(bit-mask) - 1) if absent.
+- clock-output-names : From common clock binding.
+
+Example:
+ clock {
+ compatible = "specified-clock";
+ #clock-cells = <0>;
+ reg = <0x02004004 0x4>; /* CR_PERIP_RESET_CFG */
+ bit-mask = <0x00000f00>; /* FXTAL */
+ table = /* FXTAL Frequency */
+ <0 16384000>,
+ <1 19200000>,
+ <2 24000000>,
+ <3 24576000>,
+ <4 26000000>,
+ <5 36000000>,
+ <6 36864000>,
+ <7 38400000>,
+ <8 40000000>;
+ clock-output-names = "xtal1";
+ };
The frequency of some fixed rate external oscillators on some SoCs (for example TZ1090's XTAL1) are specified by the board using pull-ups and pull-downs of configuration pins which are automatically latched on reset and available in an SoC register, so that the boot ROM and OS can automatically discover it. These clocks are very similar to fixed-clocks since the rate never changes, but we still want to be able to automatically discover the frequency, so add a new binding to describe such clocks. Instead of using a "clock-frequency" property, use "reg", "bit-mask", "bit-shift" properties to describe the register field. The mapping from register values to clock frequencies is specified in a "table" property which contains pairs of register values and frequencies. There is scope to extend the binding further in future to handle other mapping types, by using different properties instead of "table". Signed-off-by: James Hogan <james.hogan@imgtec.com> Cc: Mike Turquette <mturquette@linaro.org> Cc: Rob Herring <robh+dt@kernel.org> Cc: Pawel Moll <pawel.moll@arm.com> Cc: Mark Rutland <mark.rutland@arm.com> Cc: Ian Campbell <ijc+devicetree@hellion.org.uk> Cc: Kumar Gala <galak@codeaurora.org> Cc: devicetree@vger.kernel.org --- Changes in v3: * Remove unused & unimplemented gpios property. Not sure why it was there in the first place. I could easily have extended the fixed-rate binding instead, but there'd be no properties in common except the standard common clock properties so it seemed like it deserved a separate binding. I'm open to arguments to the contrary or better compatible string names though. Changes in v2: * Borrow bit-mask and bit-shift bindings from Mike's mux clock binding proposals. --- .../devicetree/bindings/clock/specified-clock.txt | 37 ++++++++++++++++++++++ 1 file changed, 37 insertions(+) create mode 100644 Documentation/devicetree/bindings/clock/specified-clock.txt