- Various kerneldoc script enhancements.
- More RST conversions; those are slowing down as we run out of things to
convert, but we're a ways from done still.
- Dan's "maintainer profile entry" work landed at last. Now we just need
to get maintainers to fill in the profiles...
- A reworking of the parallel build setup to work better with a variety of
systems (and to not take over huge systems entirely in particular).
- The MAINTAINERS file is now converted to RST during the build.
Hopefully nobody ever tries to print this thing, or they will need to
load a lot of paper.
- A script and documentation making it easy for maintainers to add Link:
tags at commit time.
Also included is the removal of a bunch of spurious CR characters.
-----BEGIN PGP SIGNATURE-----
iQFDBAABCAAtFiEEIw+MvkEiF49krdp9F0NaE2wMflgFAl3j5B0PHGNvcmJldEBs
d24ubmV0AAoJEBdDWhNsDH5YtBcH/jIN2cO8/0YW2rjVT+1G6ytSdFUKx5WJ/lpf
5uBeCvuCeYhtCB6+BgnXvjykJ7jDW11/NJNjWqz/gsvD5l5FJK1rXarI/oz2Klyi
kcPtDmBF/ki4wz9qXzEpa0vg8LXdjeys50S1vE75qCzxZoPP7YjuRbPnLrlIJukv
JbDVi4p9kxgeHfRB4+BHOe5rFwA3mMmaxKNIX34Y+UUO2KZ0g/yUi1bAaQwQAdt+
PsORmkVQ8Puh3K9xRIr7dYlcWBlBiPqzYdvDgTVxSjrxdK6wjYjSgVk2VjC5MBUN
mTSTWgyfsIcD/76/s8tq7ZRl2fw+SkCSkFo79Rb/hJwDTb7Vnng=
=LPBr
-----END PGP SIGNATURE-----
Merge tag 'docs-5.5a' of git://git.lwn.net/linux
Pull Documentation updates from Jonathan Corbet:
"Here are the main documentation changes for 5.5:
- Various kerneldoc script enhancements.
- More RST conversions; those are slowing down as we run out of
things to convert, but we're a ways from done still.
- Dan's "maintainer profile entry" work landed at last. Now we just
need to get maintainers to fill in the profiles...
- A reworking of the parallel build setup to work better with a
variety of systems (and to not take over huge systems entirely in
particular).
- The MAINTAINERS file is now converted to RST during the build.
Hopefully nobody ever tries to print this thing, or they will need
to load a lot of paper.
- A script and documentation making it easy for maintainers to add
Link: tags at commit time.
Also included is the removal of a bunch of spurious CR characters"
* tag 'docs-5.5a' of git://git.lwn.net/linux: (91 commits)
docs: remove a bunch of stray CRs
docs: fix up the maintainer profile document
libnvdimm, MAINTAINERS: Maintainer Entry Profile
Maintainer Handbook: Maintainer Entry Profile
MAINTAINERS: Reclaim the P: tag for Maintainer Entry Profile
docs, parallelism: Rearrange how jobserver reservations are made
docs, parallelism: Do not leak blocking mode to other readers
docs, parallelism: Fix failure path and add comment
Documentation: Remove bootmem_debug from kernel-parameters.txt
Documentation: security: core.rst: fix warnings
Documentation/process/howto/kokr: Update for 4.x -> 5.x versioning
Documentation/translation: Use Korean for Korean translation title
docs/memory-barriers.txt: Remove remaining references to mmiowb()
docs/memory-barriers.txt/kokr: Update I/O section to be clearer about CPU vs thread
docs/memory-barriers.txt/kokr: Fix style, spacing and grammar in I/O section
Documentation/kokr: Kill all references to mmiowb()
docs/memory-barriers.txt/kokr: Rewrite "KERNEL I/O BARRIER EFFECTS" section
docs: Add initial documentation for devfreq
Documentation: Document how to get links with git am
docs: Add request_irq() documentation
...
137 lines
3.3 KiB
Text
137 lines
3.3 KiB
Text
Ingenic JZ47xx SoCs Timer/Counter Unit devicetree bindings
|
|
==========================================================
|
|
|
|
For a description of the TCU hardware and drivers, have a look at
|
|
Documentation/mips/ingenic-tcu.rst.
|
|
|
|
Required properties:
|
|
|
|
- compatible: Must be one of:
|
|
* ingenic,jz4740-tcu
|
|
* ingenic,jz4725b-tcu
|
|
* ingenic,jz4770-tcu
|
|
followed by "simple-mfd".
|
|
- reg: Should be the offset/length value corresponding to the TCU registers
|
|
- clocks: List of phandle & clock specifiers for clocks external to the TCU.
|
|
The "pclk", "rtc" and "ext" clocks should be provided. The "tcu" clock
|
|
should be provided if the SoC has it.
|
|
- clock-names: List of name strings for the external clocks.
|
|
- #clock-cells: Should be <1>;
|
|
Clock consumers specify this argument to identify a clock. The valid values
|
|
may be found in <dt-bindings/clock/ingenic,tcu.h>.
|
|
- interrupt-controller : Identifies the node as an interrupt controller
|
|
- #interrupt-cells : Specifies the number of cells needed to encode an
|
|
interrupt source. The value should be 1.
|
|
- interrupts : Specifies the interrupt the controller is connected to.
|
|
|
|
Optional properties:
|
|
|
|
- ingenic,pwm-channels-mask: Bitmask of TCU channels reserved for PWM use.
|
|
Default value is 0xfc.
|
|
|
|
|
|
Children nodes
|
|
==========================================================
|
|
|
|
|
|
PWM node:
|
|
---------
|
|
|
|
Required properties:
|
|
|
|
- compatible: Must be one of:
|
|
* ingenic,jz4740-pwm
|
|
* ingenic,jz4725b-pwm
|
|
- #pwm-cells: Should be 3. See ../pwm/pwm.yaml for a description of the cell
|
|
format.
|
|
- clocks: List of phandle & clock specifiers for the TCU clocks.
|
|
- clock-names: List of name strings for the TCU clocks.
|
|
|
|
|
|
Watchdog node:
|
|
--------------
|
|
|
|
Required properties:
|
|
|
|
- compatible: Must be "ingenic,jz4740-watchdog"
|
|
- clocks: phandle to the WDT clock
|
|
- clock-names: should be "wdt"
|
|
|
|
|
|
OS Timer node:
|
|
---------
|
|
|
|
Required properties:
|
|
|
|
- compatible: Must be one of:
|
|
* ingenic,jz4725b-ost
|
|
* ingenic,jz4770-ost
|
|
- clocks: phandle to the OST clock
|
|
- clock-names: should be "ost"
|
|
- interrupts : Specifies the interrupt the OST is connected to.
|
|
|
|
|
|
Example
|
|
==========================================================
|
|
|
|
#include <dt-bindings/clock/jz4770-cgu.h>
|
|
#include <dt-bindings/clock/ingenic,tcu.h>
|
|
|
|
/ {
|
|
tcu: timer@10002000 {
|
|
compatible = "ingenic,jz4770-tcu", "simple-mfd";
|
|
reg = <0x10002000 0x1000>;
|
|
#address-cells = <1>;
|
|
#size-cells = <1>;
|
|
ranges = <0x0 0x10002000 0x1000>;
|
|
|
|
#clock-cells = <1>;
|
|
|
|
clocks = <&cgu JZ4770_CLK_RTC
|
|
&cgu JZ4770_CLK_EXT
|
|
&cgu JZ4770_CLK_PCLK>;
|
|
clock-names = "rtc", "ext", "pclk";
|
|
|
|
interrupt-controller;
|
|
#interrupt-cells = <1>;
|
|
|
|
interrupt-parent = <&intc>;
|
|
interrupts = <27 26 25>;
|
|
|
|
watchdog: watchdog@0 {
|
|
compatible = "ingenic,jz4740-watchdog";
|
|
reg = <0x0 0xc>;
|
|
|
|
clocks = <&tcu TCU_CLK_WDT>;
|
|
clock-names = "wdt";
|
|
};
|
|
|
|
pwm: pwm@40 {
|
|
compatible = "ingenic,jz4740-pwm";
|
|
reg = <0x40 0x80>;
|
|
|
|
#pwm-cells = <3>;
|
|
|
|
clocks = <&tcu TCU_CLK_TIMER0
|
|
&tcu TCU_CLK_TIMER1
|
|
&tcu TCU_CLK_TIMER2
|
|
&tcu TCU_CLK_TIMER3
|
|
&tcu TCU_CLK_TIMER4
|
|
&tcu TCU_CLK_TIMER5
|
|
&tcu TCU_CLK_TIMER6
|
|
&tcu TCU_CLK_TIMER7>;
|
|
clock-names = "timer0", "timer1", "timer2", "timer3",
|
|
"timer4", "timer5", "timer6", "timer7";
|
|
};
|
|
|
|
ost: timer@e0 {
|
|
compatible = "ingenic,jz4770-ost";
|
|
reg = <0xe0 0x20>;
|
|
|
|
clocks = <&tcu TCU_CLK_OST>;
|
|
clock-names = "ost";
|
|
|
|
interrupts = <15>;
|
|
};
|
|
};
|
|
};
|