ti,sci-clk.txt 1.6 KB

1234567891011121314151617181920212223242526272829303132333435363738394041424344454647484950515253
  1. Texas Instruments TI SCI Clock Controller
  2. =========================================
  3. All clocks on Texas Instruments' SoCs that contain a System Controller,
  4. are only controlled by this entity. Communication between a host processor
  5. running an OS and the System Controller happens through a protocol known
  6. as TI SCI[1]. This clock implementation plugs into the common clock
  7. framework and makes use of the TI SCI protocol on clock API requests.
  8. [1] http://processors.wiki.ti.com/index.php/TISCI
  9. Clock Controller Node
  10. =====================
  11. The clock controller node represents the clocks managed by the SYSFW. Because
  12. this relies on the TI SCI protocol to communicate with the SYSFW it must be a
  13. child of the sysfw node.
  14. Required Properties:
  15. --------------------
  16. - compatible: Must be "ti,k2g-sci-clk"
  17. - #clock-cells: Must be be 2. In clock consumers, this cell represents the
  18. device ID and clock ID exposed by the SYSFW firmware.
  19. Example (AM65x):
  20. ----------------
  21. dmsc: dmsc {
  22. compatible = "ti,k2g-sci";
  23. ...
  24. k3_clks: clocks {
  25. compatible = "ti,k2g-sci-clk";
  26. #clock-cells = <2>;
  27. };
  28. };
  29. Clock Consumers
  30. ===============
  31. Hardware blocks supplied by a clock should contain a "clocks" property that is
  32. a phandle pointing to the clock controller node along with an index representing
  33. the device id together with a clock ID to be passed to the SYSFW for device
  34. control.
  35. Required Properties:
  36. --------------------
  37. - clocks: phandle pointing to the corresponding clock node, an ID representing
  38. the device, and an index representing a clock.
  39. Example (AM65x):
  40. ----------------
  41. uart2: serial@02800000 {
  42. compatible = "ti,omap4-uart";
  43. ...
  44. clocks = <&k3_clks 0x0007 1>;
  45. };