fsl,qoriq-mc.txt 4.3 KB

123456789101112131415161718192021222324252627282930313233343536373839404142434445464748495051525354555657585960616263646566676869707172737475767778798081828384858687888990919293949596979899100101102103104105106107108109110111112113114115116117118119
  1. * Freescale Management Complex
  2. The Freescale Management Complex (fsl-mc) is a hardware resource
  3. manager that manages specialized hardware objects used in
  4. network-oriented packet processing applications. After the fsl-mc
  5. block is enabled, pools of hardware resources are available, such as
  6. queues, buffer pools, I/O interfaces. These resources are building
  7. blocks that can be used to create functional hardware objects/devices
  8. such as network interfaces, crypto accelerator instances, L2 switches,
  9. etc.
  10. Required properties:
  11. - compatible
  12. Value type: <string>
  13. Definition: Must be "fsl,qoriq-mc". A Freescale Management Complex
  14. compatible with this binding must have Block Revision
  15. Registers BRR1 and BRR2 at offset 0x0BF8 and 0x0BFC in
  16. the MC control register region.
  17. - reg
  18. Value type: <prop-encoded-array>
  19. Definition: A standard property. Specifies one or two regions
  20. defining the MC's registers:
  21. -the first region is the command portal for the
  22. this machine and must always be present
  23. -the second region is the MC control registers. This
  24. region may not be present in some scenarios, such
  25. as in the device tree presented to a virtual machine.
  26. - msi-parent
  27. Value type: <phandle>
  28. Definition: Must be present and point to the MSI controller node
  29. handling message interrupts for the MC.
  30. - ranges
  31. Value type: <prop-encoded-array>
  32. Definition: A standard property. Defines the mapping between the child
  33. MC address space and the parent system address space.
  34. The MC address space is defined by 3 components:
  35. <region type> <offset hi> <offset lo>
  36. Valid values for region type are
  37. 0x0 - MC portals
  38. 0x1 - QBMAN portals
  39. - #address-cells
  40. Value type: <u32>
  41. Definition: Must be 3. (see definition in 'ranges' property)
  42. - #size-cells
  43. Value type: <u32>
  44. Definition: Must be 1.
  45. Sub-nodes:
  46. The fsl-mc node may optionally have dpmac sub-nodes that describe
  47. the relationship between the Ethernet MACs which belong to the MC
  48. and the Ethernet PHYs on the system board.
  49. The dpmac nodes must be under a node named "dpmacs" which contains
  50. the following properties:
  51. - #address-cells
  52. Value type: <u32>
  53. Definition: Must be present if dpmac sub-nodes are defined and must
  54. have a value of 1.
  55. - #size-cells
  56. Value type: <u32>
  57. Definition: Must be present if dpmac sub-nodes are defined and must
  58. have a value of 0.
  59. These nodes must have the following properties:
  60. - compatible
  61. Value type: <string>
  62. Definition: Must be "fsl,qoriq-mc-dpmac".
  63. - reg
  64. Value type: <prop-encoded-array>
  65. Definition: Specifies the id of the dpmac.
  66. - phy-handle
  67. Value type: <phandle>
  68. Definition: Specifies the phandle to the PHY device node associated
  69. with the this dpmac.
  70. Example:
  71. fsl_mc: fsl-mc@80c000000 {
  72. compatible = "fsl,qoriq-mc";
  73. reg = <0x00000008 0x0c000000 0 0x40>, /* MC portal base */
  74. <0x00000000 0x08340000 0 0x40000>; /* MC control reg */
  75. msi-parent = <&its>;
  76. #address-cells = <3>;
  77. #size-cells = <1>;
  78. /*
  79. * Region type 0x0 - MC portals
  80. * Region type 0x1 - QBMAN portals
  81. */
  82. ranges = <0x0 0x0 0x0 0x8 0x0c000000 0x4000000
  83. 0x1 0x0 0x0 0x8 0x18000000 0x8000000>;
  84. dpmacs {
  85. #address-cells = <1>;
  86. #size-cells = <0>;
  87. dpmac@1 {
  88. compatible = "fsl,qoriq-mc-dpmac";
  89. reg = <1>;
  90. phy-handle = <&mdio0_phy0>;
  91. }
  92. }
  93. };