lkml.org 
[lkml]   [2020]   [May]   [14]   [last100]   RSS Feed
Views: [wrap][no wrap]   [headers]  [forward] 
 
Messages in this thread
    Patch in this message
    /
    From
    Subject[PATCH 01/19] dt-bindings: PCI: Endpoint: Add DT bindings for PCI EPF NTB Device
    Date
    Add device tree schema for PCI endpoint function bus to which
    endpoint function devices should be attached. Then add device tree
    schema for PCI endpoint function device to include bindings thats
    generic to all endpoint functions. Finally add device tree schema
    for PCI endpoint NTB function device by including the generic
    device tree schema for PCIe endpoint function.

    Signed-off-by: Kishon Vijay Abraham I <kishon@ti.com>
    ---
    .../bindings/pci/endpoint/pci-epf-bus.yaml | 42 +++++++++++
    .../bindings/pci/endpoint/pci-epf-device.yaml | 69 +++++++++++++++++++
    .../bindings/pci/endpoint/pci-epf-ntb.yaml | 68 ++++++++++++++++++
    3 files changed, 179 insertions(+)
    create mode 100644 Documentation/devicetree/bindings/pci/endpoint/pci-epf-bus.yaml
    create mode 100644 Documentation/devicetree/bindings/pci/endpoint/pci-epf-device.yaml
    create mode 100644 Documentation/devicetree/bindings/pci/endpoint/pci-epf-ntb.yaml

    diff --git a/Documentation/devicetree/bindings/pci/endpoint/pci-epf-bus.yaml b/Documentation/devicetree/bindings/pci/endpoint/pci-epf-bus.yaml
    new file mode 100644
    index 000000000000..1c504f2e85e4
    --- /dev/null
    +++ b/Documentation/devicetree/bindings/pci/endpoint/pci-epf-bus.yaml
    @@ -0,0 +1,42 @@
    +# SPDX-License-Identifier: (GPL-2.0-only OR BSD-2-Clause)
    +# Copyright (C) 2020 Texas Instruments Incorporated - http://www.ti.com/
    +%YAML 1.2
    +---
    +$id: http://devicetree.org/schemas/pci/endpoint/pci-epf-bus.yaml#
    +$schema: http://devicetree.org/meta-schemas/core.yaml#
    +
    +title: PCI Endpoint Function Bus
    +
    +maintainers:
    + - Kishon Vijay Abraham I <kishon@ti.com>
    +
    +properties:
    + compatible:
    + const: pci-epf-bus
    +
    +patternProperties:
    + "^func@[0-9a-f]+$":
    + type: object
    + description: |
    + PCI Endpoint Function Bus node should have subnodes for each of
    + the implemented endpoint function. It should follow the bindings
    + specified for endpoint function in
    + Documentation/devicetree/bindings/pci/endpoint/
    +
    +examples:
    + - |
    + epf_bus {
    + compatible = "pci-epf-bus";
    +
    + func@0 {
    + compatible = "pci-epf-ntb";
    + epcs = <&pcie0_ep>, <&pcie1_ep>;
    + epc-names = "primary", "secondary";
    + reg = <0>;
    + epf,vendor-id = /bits/ 16 <0x104c>;
    + epf,device-id = /bits/ 16 <0xb00d>;
    + num-mws = <4>;
    + mws-size = <0x0 0x100000>, <0x0 0x100000>, <0x0 0x100000>, <0x0 0x100000>;
    + };
    + };
    +...
    diff --git a/Documentation/devicetree/bindings/pci/endpoint/pci-epf-device.yaml b/Documentation/devicetree/bindings/pci/endpoint/pci-epf-device.yaml
    new file mode 100644
    index 000000000000..cee72864c8ca
    --- /dev/null
    +++ b/Documentation/devicetree/bindings/pci/endpoint/pci-epf-device.yaml
    @@ -0,0 +1,69 @@
    +# SPDX-License-Identifier: (GPL-2.0-only OR BSD-2-Clause)
    +# Copyright (C) 2020 Texas Instruments Incorporated - http://www.ti.com/
    +%YAML 1.2
    +---
    +$id: http://devicetree.org/schemas/pci/endpoint/pci-epf-device.yaml#
    +$schema: http://devicetree.org/meta-schemas/core.yaml#
    +
    +title: PCI Endpoint Function Device
    +
    +maintainers:
    + - Kishon Vijay Abraham I <kishon@ti.com>
    +
    +properties:
    + compatible:
    + const: pci-epf-bus
    +
    +properties:
    + $nodename:
    + pattern: "^func@"
    +
    + epcs:
    + description:
    + Phandle to the endpoint controller device. Should have "2" entries for
    + NTB endpoint function and "1" entry for others.
    + minItems: 1
    + maxItems: 2
    +
    + epc-names:
    + description:
    + Must contain an entry for each entry in "epcs" when "epcs" have more than
    + one entry.
    +
    + reg:
    + maxItems: 0
    + description: Must contain the index number of the function.
    +
    + epf,vendor-id:
    + description:
    + The PCI vendor ID
    + allOf:
    + - $ref: /schemas/types.yaml#/definitions/uint16
    +
    + epf,device-id:
    + description:
    + The PCI device ID
    + allOf:
    + - $ref: /schemas/types.yaml#/definitions/uint16
    +
    + epf,baseclass-code:
    + description: Code to classify the type of operation the function performs
    + allOf:
    + - $ref: /schemas/types.yaml#/definitions/uint8
    +
    + epf,subclass-code:
    + description:
    + Specifies a base class sub-class, which identifies more specifically the
    + operation of the Function
    + allOf:
    + - $ref: /schemas/types.yaml#/definitions/uint8
    +
    + epf,subsys-vendor-id:
    + description: Code to identify vendor of the add-in card or subsystem
    + allOf:
    + - $ref: /schemas/types.yaml#/definitions/uint16
    +
    + epf,subsys-id:
    + description: Code to specify an id that is specific to a vendor
    + allOf:
    + - $ref: /schemas/types.yaml#/definitions/uint16
    diff --git a/Documentation/devicetree/bindings/pci/endpoint/pci-epf-ntb.yaml b/Documentation/devicetree/bindings/pci/endpoint/pci-epf-ntb.yaml
    new file mode 100644
    index 000000000000..92c2e522b9e5
    --- /dev/null
    +++ b/Documentation/devicetree/bindings/pci/endpoint/pci-epf-ntb.yaml
    @@ -0,0 +1,68 @@
    +# SPDX-License-Identifier: (GPL-2.0-only OR BSD-2-Clause)
    +# Copyright (C) 2020 Texas Instruments Incorporated - http://www.ti.com/
    +%YAML 1.2
    +---
    +$id: http://devicetree.org/schemas/pci/endpoint/pci-epf-ntb.yaml#
    +$schema: http://devicetree.org/meta-schemas/core.yaml#
    +
    +title: PCI Endpoint NTB Function Device
    +
    +maintainers:
    + - Kishon Vijay Abraham I <kishon@ti.com>
    +
    +allOf:
    + - $ref: "pci-epf-device.yaml#"
    +
    +properties:
    + compatible:
    + const: pci-epf-ntb
    +
    + epcs:
    + minItems: 2
    + maxItems: 2
    +
    + epc-names:
    + items:
    + - const: primary
    + - const: secondary
    +
    + num-mws:
    + description:
    + Specify the number of memory windows
    + allOf:
    + - $ref: /schemas/types.yaml#/definitions/uint8
    + minimum: 1
    + maximum: 4
    +
    + mws-size:
    + description:
    + List of 'num-mws' entries containing size of each memory window.
    + minItems: 1
    + maxItems: 4
    +
    +required:
    + - compatible
    + - epcs
    + - epc-names
    + - epf,vendor-id
    + - epf,device-id
    + - num-mws
    + - mws-size
    +
    +examples:
    + - |
    + epf_bus {
    + compatible = "pci-epf-bus";
    +
    + func@0 {
    + compatible = "pci-epf-ntb";
    + reg = <0>;
    + epcs = <&pcie0_ep>, <&pcie1_ep>;
    + epc-names = "primary", "secondary";
    + epf,vendor-id = /bits/ 16 <0x104c>;
    + epf,device-id = /bits/ 16 <0xb00d>;
    + num-mws = <4>;
    + mws-size = <0x0 0x100000>, <0x0 0x100000>, <0x0 0x100000>, <0x0 0x100000>;
    + };
    + };
    +...
    --
    2.17.1
    \
     
     \ /
      Last update: 2020-05-14 17:00    [W:4.594 / U:0.200 seconds]
    ©2003-2020 Jasper Spaans|hosted at Digital Ocean and TransIP|Read the blog|Advertise on this site