xref: /linux/Documentation/devicetree/bindings/net/fsl,fman-port.yaml (revision c532de5a67a70f8533d495f8f2aaa9a0491c3ad0) 
1# SPDX-License-Identifier: (GPL-2.0-only OR BSD-2-Clause)
2%YAML 1.2
3---
4$id: http://devicetree.org/schemas/net/fsl,fman-port.yaml#
5$schema: http://devicetree.org/meta-schemas/core.yaml#
6
7title: Freescale Frame Manager Port Device
8
9maintainers:
10  - Frank Li <Frank.Li@nxp.com>
11
12description: |
13  The Frame Manager (FMan) supports several types of hardware ports:
14    Ethernet receiver (RX)
15    Ethernet transmitter (TX)
16    Offline/Host command (O/H)
17
18properties:
19  compatible:
20    enum:
21      - fsl,fman-v2-port-oh
22      - fsl,fman-v2-port-rx
23      - fsl,fman-v2-port-tx
24      - fsl,fman-v3-port-oh
25      - fsl,fman-v3-port-rx
26      - fsl,fman-v3-port-tx
27
28  cell-index:
29    $ref: /schemas/types.yaml#/definitions/uint32
30    description:
31      Specifies the hardware port id.
32      Each hardware port on the FMan has its own hardware PortID.
33      Super set of all hardware Port IDs available at FMan Reference
34      Manual under "FMan Hardware Ports in Freescale Devices" table.
35
36      Each hardware port is assigned a 4KB, port-specific page in
37      the FMan hardware port memory region (which is part of the
38      FMan memory map). The first 4 KB in the FMan hardware ports
39      memory region is used for what are called common registers.
40      The subsequent 63 4KB pages are allocated to the hardware
41      ports.
42      The page of a specific port is determined by the cell-index.
43
44  reg:
45    items:
46      - description: There is one reg region describing the port
47          configuration registers.
48
49  fsl,fman-10g-port:
50    $ref: /schemas/types.yaml#/definitions/flag
51    description: The default port rate is 1G.
52      If this property exists, the port is s 10G port.
53
54  fsl,fman-best-effort-port:
55    $ref: /schemas/types.yaml#/definitions/flag
56    description: The default port rate is 1G.
57      Can be defined only if 10G-support is set.
58      This property marks a best-effort 10G port (10G port that
59      may not be capable of line rate).
60
61required:
62  - compatible
63  - reg
64  - cell-index
65
66additionalProperties: false
67
68examples:
69  - |
70    port@a8000 {
71        compatible = "fsl,fman-v2-port-tx";
72        reg = <0xa8000 0x1000>;
73        cell-index = <0x28>;
74    };
75
76