[PATCH V3] schemas: pci: Extend the meaning of 'linux,pci-probe-only'

From: Vidya Sagar
Date: Mon Apr 01 2024 - 03:50:14 EST


Extend the meaning of 'linux,pci-probe-only' to cover the cases where
it is applicable only to a specific PCI host bridge if defined in a
PCI node instead of chosen node. Add the documentation for the same
in schemas/pci/pci-host-bridge.yaml

Signed-off-by: Vidya Sagar <vidyas@xxxxxxxxxx>
---
V3:
* Addressed Rob's review comments

V2:
* Addressed Bjorn's review comments
dtschema/schemas/chosen.yaml | 7 +++++--
dtschema/schemas/pci/pci-host-bridge.yaml | 11 +++++++++++
2 files changed, 16 insertions(+), 2 deletions(-)

diff --git a/dtschema/schemas/chosen.yaml b/dtschema/schemas/chosen.yaml
index 6d5c3f1..f806646 100644
--- a/dtschema/schemas/chosen.yaml
+++ b/dtschema/schemas/chosen.yaml
@@ -142,8 +142,11 @@ properties:
enum: [ 0, 1 ]
description:
Optional property which takes a single-cell argument. If '0', then Linux
- will assign devices in its usual manner, otherwise it will not try to
- assign devices and instead use them as they are configured already.
+ will reassign BARs and bridge windows in its usual manner, otherwise it will
+ not try to reassign BARs and bridge windows, instead use them as they are
+ configured already by the platform firmware.
+ NOTE:- To restrict the applicability of this property to a specific PCI
+ host bridge, please refer to /schemas/pci/pci-host-bridge.yaml

stdout-path:
$ref: types.yaml#/definitions/string
diff --git a/dtschema/schemas/pci/pci-host-bridge.yaml b/dtschema/schemas/pci/pci-host-bridge.yaml
index fbbb829..e6665e7 100644
--- a/dtschema/schemas/pci/pci-host-bridge.yaml
+++ b/dtschema/schemas/pci/pci-host-bridge.yaml
@@ -31,6 +31,17 @@ properties:
number for each host bridge in the system must be unique.
$ref: /schemas/types.yaml#/definitions/uint32

+ linux,pci-probe-only:
+ $ref: types.yaml#/definitions/uint32
+ enum: [ 0, 1 ]
+ description:
+ Optional property which takes a single-cell argument. If '0', then Linux
+ will reassign BARs and bridge windows in its usual manner, otherwise it will
+ not try to reassign BARs and bridge windows, instead use them as they are
+ configured already by the platform firmware.
+ NOTE:- If defined in chosen node, this property has system wide applicability.
+ Please refer to /schemas/chosen.yaml for more info.
+
msi-map:
$ref: /schemas/types.yaml#/definitions/uint32-matrix
items:
--
2.25.1