linux-kernel - Re: [PATCH v2 04/11] clk: at91: add slow clk documentation

lists.openwall.net		lists / announce owl-users owl-dev john-users john-dev passwdqc-users yescrypt popa3d-users / oss-security kernel-hardening musl sabotage tlsify passwords / crypt-dev xvendor / Bugtraq Full-Disclosure linux-kernel linux-netdev linux-ext4 linux-hardening linux-cve-announce PHC
Open Source and information security mailing list archives

Hash Suite: Windows password security audit tool. GUI, reports in PDF.

[<prev] [next>] [<thread-prev] [day] [month] [year] [list]

Message-ID: <535123ED.9070303@atmel.com>
Date:	Fri, 18 Apr 2014 15:09:01 +0200
From:	Nicolas Ferre <nicolas.ferre@...el.com>
To:	Boris BREZILLON <brezillonboris@...il.com>,
	Mike Turquette <mturquette@...aro.org>,
	Alexandre Belloni <alexandre.belloni@...e-electrons.com>,
	Jean-Jacques Hiblot <jjhiblot@...phandler.com>,
	Jean-Christophe PLAGNIOL-VILLARD <plagnioj@...osoft.com>
CC:	<devicetree@...r.kernel.org>, <linux-doc@...r.kernel.org>,
	<linux-kernel@...r.kernel.org>,
	<linux-arm-kernel@...ts.infradead.org>,
	"Boris BREZILLON" <b.brezillon.dev@...il.com>
Subject: Re: [PATCH v2 04/11] clk: at91: add slow clk documentation

On 24/03/2014 09:27, Boris BREZILLON :
> Add slow clk, and slow oscillators documentation.
> 
> Signed-off-by: Boris BREZILLON <b.brezillon.dev@...il.com>
> ---
>  .../devicetree/bindings/clock/at91-clock.txt       |   72 ++++++++++++++++++++
>  1 file changed, 72 insertions(+)
> 
> diff --git a/Documentation/devicetree/bindings/clock/at91-clock.txt b/Documentation/devicetree/bindings/clock/at91-clock.txt
> index 9a7025b..820061c 100644
> --- a/Documentation/devicetree/bindings/clock/at91-clock.txt
> +++ b/Documentation/devicetree/bindings/clock/at91-clock.txt
> @@ -6,6 +6,16 @@ This binding uses the common clock binding[1].
>  
>  Required properties:
>  - compatible : shall be one of the following:
> +	"atmel,at91sam9x5-sckc":
> +		at91 SCKC (Slow Clock Controller)
> +		This node contains the slow clock definitions.
> +
> +	"atmel,at91sam9x5-clk-slow-osc":
> +		at91 slow oscillator
> +
> +	"atmel,at91sam9x5-clk-slow-rc-osc":
> +		at91 internal slow RC oscillator
> +
>  	"atmel,at91rm9200-pmc" or
>  	"atmel,at91sam9g45-pmc" or
>  	"atmel,at91sam9n12-pmc" or
> @@ -15,6 +25,11 @@ Required properties:
>  		All at91 specific clocks (clocks defined below) must be child
>  		node of the PMC node.
>  
> +	"atmel,at91sam9x5-clk-slow" (under sckc node)
> +	or
> +	"atmel,at91sam9260-clk-slow" (under pmc node):
> +		at91 slow clk
> +
>  	"atmel,at91rm9200-clk-main-osc"
>  	"atmel,at91sam9x5-clk-main-rc-osc"
>  		at91 main clk sources
> @@ -59,6 +74,63 @@ Required properties:
>  	"atmel,at91sam9x5-clk-utmi":
>  		at91 utmi clock
>  
> +Required properties for SCKC node:
> +- reg : defines the IO memory reserved for the SCKC.
> +- #size-cells : shall be 0 (reg is used to encode clk id).
> +- #address-cells : shall be 1 (reg is used to encode clk id).
> +
> +
> +For example:
> +	ckc: sckc@...ffe50 {

s/ckc/sckc/ ?


> +		compatible = "atmel,sama5d3-pmc";
> +		reg = <0xfffffe50 0x4>
> +		#size-cells = <0>;
> +		#address-cells = <1>;
> +
> +		/* put at91 slow clocks here */
> +	};
> +
> +
> +Required properties for internal slow RC oscillator:
> +- #clock-cells : from common clock binding; shall be set to 0.
> +- clock-frequency : define the internal RC oscillator frequency.
> +
> +Optional properties:
> +- clock-accuracy : define the internal RC oscillator accuracy.
> +
> +For example:
> +	slow_rc_osc: slow_rc_osc {
> +		compatible = "atmel,at91sam9x5-clk-slow-rc-osc";
> +		clock-frequency = <32768>;
> +		clock-accuracy = <50000000>;
> +	};
> +
> +Required properties for slow oscillator:
> +- #clock-cells : from common clock binding; shall be set to 0.
> +- clocks : shall encode the main osc source clk sources (see atmel datasheet).
> +
> +Optional properties:
> +- atmel,osc-bypass : boolean property. Set this when a clock signal is directly
> +  provided on XIN.
> +
> +For example:
> +	slow_osc: slow_osc {
> +		compatible = "atmel,at91rm9200-clk-slow-osc";
> +		#clock-cells = <0>;
> +		clocks = <&slow_xtal>;
> +	};
> +
> +Required properties for slow clock:
> +- #clock-cells : from common clock binding; shall be set to 0.
> +- clocks : shall encode the slow clk sources (see atmel datasheet).
> +
> +For example:
> +	clk32k: slck {
> +		compatible = "atmel,at91sam9x5-clk-slow";
> +		#clock-cells = <0>;
> +		clocks = <&slow_rc_osc &slow_osc>;
> +	};
> +
>  Required properties for PMC node:
>  - reg : defines the IO memory reserved for the PMC.
>  - #size-cells : shall be 0 (reg is used to encode clk id).
> 


-- 
Nicolas Ferre
--
To unsubscribe from this list: send the line "unsubscribe linux-kernel" in
the body of a message to majordomo@...r.kernel.org
More majordomo info at  http://vger.kernel.org/majordomo-info.html
Please read the FAQ at  http://www.tux.org/lkml/