[mirror_ubuntu-focal-kernel.git] / Documentation / devicetree / bindings / timer / renesas,tmu.txt

* Renesas R-Mobile/R-Car Timer Unit (TMU)

The TMU is a 32-bit timer/counter with configurable clock inputs and
programmable compare match.

Channels share hardware resources but their counter and compare match value
are independent. The TMU hardware supports up to three channels.

Required Properties:

  - compatible: must contain one or more of the following:
    - "renesas,tmu-r8a7740" for the r8a7740 TMU
    - "renesas,tmu-r8a7778" for the r8a7778 TMU
    - "renesas,tmu-r8a7779" for the r8a7779 TMU
    - "renesas,tmu" for any TMU.
      This is a fallback for the above renesas,tmu-* entries

  - reg: base address and length of the registers block for the timer module.

  - interrupts: interrupt-specifier for the timer, one per channel.

  - clocks: a list of phandle + clock-specifier pairs, one for each entry
    in clock-names.
  - clock-names: must contain "fck" for the functional clock.

Optional Properties:

  - #renesas,channels: number of channels implemented by the timer, must be 2
    or 3 (if not specified the value defaults to 3).


Example: R8A7779 (R-Car H1) TMU0 node

	tmu0: timer@ffd80000 {
		compatible = "renesas,tmu-r8a7779", "renesas,tmu";
		reg = <0xffd80000 0x30>;
		interrupts = <0 32 IRQ_TYPE_LEVEL_HIGH>,
			     <0 33 IRQ_TYPE_LEVEL_HIGH>,
			     <0 34 IRQ_TYPE_LEVEL_HIGH>;
		clocks = <&mstp0_clks R8A7779_CLK_TMU0>;
		clock-names = "fck";

		#renesas,channels = <3>;
	};
Commit	Line	Data
ec95a345	1	* Renesas R-Mobile/R-Car Timer Unit (TMU)
3e29b554 LP	2
	3	The TMU is a 32-bit timer/counter with configurable clock inputs and
	4	programmable compare match.
	5
	6	Channels share hardware resources but their counter and compare match value
	7	are independent. The TMU hardware supports up to three channels.
	8
	9	Required Properties:
	10
fb0eee2f	11	- compatible: must contain one or more of the following:
ec95a345	12	- "renesas,tmu-r8a7740" for the r8a7740 TMU
f9d6ec6f	13	- "renesas,tmu-r8a7778" for the r8a7778 TMU
fb0eee2f SH	14	- "renesas,tmu-r8a7779" for the r8a7779 TMU
	15	- "renesas,tmu" for any TMU.
	16	This is a fallback for the above renesas,tmu-* entries
3e29b554 LP	17
	18	- reg: base address and length of the registers block for the timer module.
	19
	20	- interrupts: interrupt-specifier for the timer, one per channel.
	21
	22	- clocks: a list of phandle + clock-specifier pairs, one for each entry
	23	in clock-names.
	24	- clock-names: must contain "fck" for the functional clock.
	25
	26	Optional Properties:
	27
	28	- #renesas,channels: number of channels implemented by the timer, must be 2
	29	or 3 (if not specified the value defaults to 3).
	30
	31
	32	Example: R8A7779 (R-Car H1) TMU0 node
	33
	34	tmu0: timer@ffd80000 {
fb0eee2f	35	compatible = "renesas,tmu-r8a7779", "renesas,tmu";
3e29b554 LP	36	reg = <0xffd80000 0x30>;
	37	interrupts = <0 32 IRQ_TYPE_LEVEL_HIGH>,
	38	<0 33 IRQ_TYPE_LEVEL_HIGH>,
	39	<0 34 IRQ_TYPE_LEVEL_HIGH>;
	40	clocks = <&mstp0_clks R8A7779_CLK_TMU0>;
	41	clock-names = "fck";
	42
	43	#renesas,channels = <3>;
	44	};