Donate to e Foundation | Murena handsets with /e/OS | Own a part of Murena! Learn more

Commit e581245d authored by Laxman Dewangan's avatar Laxman Dewangan Committed by Stephen Boyd
Browse files

clk: max77686: Add DT binding details for PMIC MAX77620 



Maxim has used the same clock IP on multiple PMICs like MAX77686,
MAX77802, MAX77620. Only differences are the number of clocks
from these PMICs like MAX77686 has 3 clocks output, MAX776802 have
two clock output and MAX77620 has one clock output.

Add clock binding details and DT example for the MAX77620.

Signed-off-by: default avatarLaxman Dewangan <ldewangan@nvidia.com>
CC: Krzysztof Kozlowski <k.kozlowski@samsung.com>
CC: Javier Martinez Canillas <javier@dowhile0.org>
Reviewed-by: default avatarJavier Martinez Canillas <javier@osg.samsung.com>
Reviewed-by: default avatarKrzysztof Kozlowski <k.kozlowski@samsung.com>
Signed-off-by: default avatarStephen Boyd <sboyd@codeaurora.org>
parent 24f668de

Documentation/devicetree/bindings/clock/maxim,max77686.txt

+42 −10
Original line number Original line Diff line number Diff line 
Binding for Maxim MAX77686/MAX77802 32k clock generator block

Binding for Maxim MAX77686/MAX77802/MAX77620 32k clock generator block





This is a part of device tree bindings of MAX77686/MAX77802 multi-function

This is a part of device tree bindings of MAX77686/MAX77802/MAX77620

device. More information can be found in bindings/mfd/max77686.txt file for

multi-function device. More information can be found in MFD DT binding

MAX77686 and bindings/mfd/max77802.txt for MAX77802.

doc as follows:

	bindings/mfd/max77686.txt for MAX77686 and

	bindings/mfd/max77802.txt for MAX77802 and

	bindings/mfd/max77620.txt for MAX77620.





The MAX77686 contains three 32.768khz clock outputs that can be controlled

The MAX77686 contains three 32.768khz clock outputs that can be controlled

(gated/ungated) over I2C.

(gated/ungated) over I2C. Clocks are defined as preprocessor macros in

dt-bindings/clock/maxim,max77686.h.







The MAX77802 contains two 32.768khz clock outputs that can be controlled

The MAX77802 contains two 32.768khz clock outputs that can be controlled

(gated/ungated) over I2C.

(gated/ungated) over I2C. Clocks are defined as preprocessor macros in

dt-bindings/clock/maxim,max77802.h.



The MAX77686 contains one 32.768khz clock outputs that can be controlled

(gated/ungated) over I2C. Clocks are defined as preprocessor macros in

dt-bindings/clock/maxim,max77620.h.





Following properties should be presend in main device node of the MFD chip.

Following properties should be presend in main device node of the MFD chip.
@@ -21,13 +31,12 @@ Optional properties: 




Each clock is assigned an identifier and client nodes can use this identifier

Each clock is assigned an identifier and client nodes can use this identifier

to specify the clock which they consume. Following indices are allowed:

to specify the clock which they consume. Following indices are allowed:

    - 0: 32khz_ap clock (max77686, max77802),

    - 0: 32khz_ap clock (max77686, max77802), 32khz_out0 (max77620)

    - 1: 32khz_cp clock (max77686, max77802),

    - 1: 32khz_cp clock (max77686, max77802),

    - 2: 32khz_pmic clock (max77686).

    - 2: 32khz_pmic clock (max77686).





Clocks are defined as preprocessor macros in dt-bindings/clock/maxim,max77686.h

Clocks are defined as preprocessor macros in above dt-binding header for

header for MAX77686 and dt-bindings/clock/maxim,max77802.h for MAX77802 and can

respective chips.

be used in device tree sources.





Example:

Example:
@@ -80,3 +89,26 @@ Example: 
			clock-names = "my-clock";

			clock-names = "my-clock";

			clocks = <&max77802 MAX77802_CLK_32K_AP>;

			clocks = <&max77802 MAX77802_CLK_32K_AP>;

		};

		};





3. With MAX77620:



#include <dt-bindings/clock/maxim,max77620.h>

/* ... */



	Node of the MFD chip

		max77620: max77620@3c {

			compatible = "maxim,max77620";

			reg = <0x3c>;

			#clock-cells = <1>;

			/* ... */

		};



	Clock consumer node



		foo@0 {

			compatible = "bar,foo";

			/* ... */

			clock-names = "my-clock";

			clocks = <&max77620 MAX77620_CLK_32K_OUT0>;

		};

include/dt-bindings/clock/maxim,max77620.h

0 → 100644
+21 −0
Original line number Original line Diff line number Diff line 
/*

 * Copyright (C) 2016 NVIDIA CORPORATION. All rights reserved.

 *

 * This program is free software; you can redistribute it and/or modify

 * it under the terms of the GNU General Public License version 2 as

 * published by the Free Software Foundation.

 *

 * Device Tree binding constants clocks for the Maxim 77620 PMIC.

 */



#ifndef _DT_BINDINGS_CLOCK_MAXIM_MAX77620_CLOCK_H

#define _DT_BINDINGS_CLOCK_MAXIM_MAX77620_CLOCK_H



/* Fixed rate clocks. */



#define MAX77620_CLK_32K_OUT0		0



/* Total number of clocks. */

#define MAX77620_CLKS_NUM		(MAX77620_CLK_32K_OUT0 + 1)



#endif /* _DT_BINDINGS_CLOCK_MAXIM_MAX77620_CLOCK_H */