mirror of
https://github.com/AsahiLinux/u-boot
synced 2024-12-26 13:03:40 +00:00
e585bef17f
Some TI Keystone 2 and K3 family of SoCs contain a system controller (like the Power Management Micro Controller (PMMC) on 66AK2G SoCs and the Device Management and Security Controller on AM65x SoCs) that manage the low-level device control (like clocks, resets etc) for the various hardware modules present on the SoC. These device control operations are provided to the host processor OS through a communication protocol called the TI System Control Interface (TI SCI) protocol. This patch adds a clock driver that communicates to the system controller over the TI SCI protocol for performing clock management of various devices present on the SoC. Various clock functionality is achieved by the means of different TI SCI device operations provided by the TI SCI framework. This code is loosely based on the drivers/clk/keystone/sci-clk.c driver of the Linux kernel. Reviewed-by: Tom Rini <trini@konsulko.com> Signed-off-by: Andreas Dannenberg <dannenberg@ti.com> Signed-off-by: Vignesh R <vigneshr@ti.com> Signed-off-by: Lokesh Vutla <lokeshvutla@ti.com>
53 lines
1.6 KiB
Text
53 lines
1.6 KiB
Text
Texas Instruments TI SCI Clock Controller
|
|
=========================================
|
|
|
|
All clocks on Texas Instruments' SoCs that contain a System Controller,
|
|
are only controlled by this entity. Communication between a host processor
|
|
running an OS and the System Controller happens through a protocol known
|
|
as TI SCI[1]. This clock implementation plugs into the common clock
|
|
framework and makes use of the TI SCI protocol on clock API requests.
|
|
|
|
[1] http://processors.wiki.ti.com/index.php/TISCI
|
|
|
|
Clock Controller Node
|
|
=====================
|
|
The clock controller node represents the clocks managed by the SYSFW. Because
|
|
this relies on the TI SCI protocol to communicate with the SYSFW it must be a
|
|
child of the sysfw node.
|
|
|
|
Required Properties:
|
|
--------------------
|
|
- compatible: Must be "ti,k2g-sci-clk"
|
|
- #clock-cells: Must be be 2. In clock consumers, this cell represents the
|
|
device ID and clock ID exposed by the SYSFW firmware.
|
|
|
|
Example (AM65x):
|
|
----------------
|
|
dmsc: dmsc {
|
|
compatible = "ti,k2g-sci";
|
|
...
|
|
k3_clks: clocks {
|
|
compatible = "ti,k2g-sci-clk";
|
|
#clock-cells = <2>;
|
|
};
|
|
};
|
|
|
|
Clock Consumers
|
|
===============
|
|
Hardware blocks supplied by a clock should contain a "clocks" property that is
|
|
a phandle pointing to the clock controller node along with an index representing
|
|
the device id together with a clock ID to be passed to the SYSFW for device
|
|
control.
|
|
|
|
Required Properties:
|
|
--------------------
|
|
- clocks: phandle pointing to the corresponding clock node, an ID representing
|
|
the device, and an index representing a clock.
|
|
|
|
Example (AM65x):
|
|
----------------
|
|
uart2: serial@02800000 {
|
|
compatible = "ti,omap4-uart";
|
|
...
|
|
clocks = <&k3_clks 0x0007 1>;
|
|
};
|