[v5,02/11] dt-bindings: treewide: add access-controller description
Commit Message
access-controller is an optional property that allows a peripheral to
refer to one or more domain access controller(s).
Description of this property is added to all peripheral binding files of
the peripheral under the STM32 firewall controllers. It allows an accurate
representation of the hardware, where various peripherals are connected
to this firewall bus. The firewall can then check the peripheral accesses
before allowing it to probe.
Signed-off-by: Gatien Chevallier <gatien.chevallier@foss.st.com>
---
Changes in V5:
- Discarded review tags as the content has changed
- Renamed feature-domains to access-controller
- Removed extra blank line in st,stm32-timers.yaml
Changes in V4:
- Added Jonathan's tag for IIO
Changes in V2:
- Add missing "feature-domains" property declaration
in bosch,m_can.yaml and st,stm32-cryp.yaml files
Documentation/devicetree/bindings/crypto/st,stm32-cryp.yaml | 4 ++++
Documentation/devicetree/bindings/crypto/st,stm32-hash.yaml | 4 ++++
Documentation/devicetree/bindings/dma/st,stm32-dma.yaml | 4 ++++
Documentation/devicetree/bindings/dma/st,stm32-dmamux.yaml | 4 ++++
Documentation/devicetree/bindings/i2c/st,stm32-i2c.yaml | 4 ++++
Documentation/devicetree/bindings/iio/adc/st,stm32-adc.yaml | 4 ++++
.../devicetree/bindings/iio/adc/st,stm32-dfsdm-adc.yaml | 4 ++++
Documentation/devicetree/bindings/iio/dac/st,stm32-dac.yaml | 4 ++++
Documentation/devicetree/bindings/media/cec/st,stm32-cec.yaml | 4 ++++
Documentation/devicetree/bindings/media/st,stm32-dcmi.yaml | 4 ++++
.../bindings/memory-controllers/st,stm32-fmc2-ebi.yaml | 4 ++++
Documentation/devicetree/bindings/mfd/st,stm32-lptimer.yaml | 4 ++++
Documentation/devicetree/bindings/mfd/st,stm32-timers.yaml | 4 ++++
Documentation/devicetree/bindings/mmc/arm,pl18x.yaml | 4 ++++
Documentation/devicetree/bindings/net/can/bosch,m_can.yaml | 4 ++++
Documentation/devicetree/bindings/net/stm32-dwmac.yaml | 4 ++++
Documentation/devicetree/bindings/phy/phy-stm32-usbphyc.yaml | 4 ++++
.../devicetree/bindings/regulator/st,stm32-vrefbuf.yaml | 4 ++++
Documentation/devicetree/bindings/rng/st,stm32-rng.yaml | 4 ++++
Documentation/devicetree/bindings/serial/st,stm32-uart.yaml | 4 ++++
Documentation/devicetree/bindings/sound/st,stm32-i2s.yaml | 4 ++++
Documentation/devicetree/bindings/sound/st,stm32-sai.yaml | 4 ++++
Documentation/devicetree/bindings/sound/st,stm32-spdifrx.yaml | 4 ++++
Documentation/devicetree/bindings/spi/st,stm32-qspi.yaml | 4 ++++
Documentation/devicetree/bindings/spi/st,stm32-spi.yaml | 4 ++++
Documentation/devicetree/bindings/usb/dwc2.yaml | 4 ++++
26 files changed, 104 insertions(+)
Comments
On Fri, 29 Sep 2023 16:28:43 +0200, Gatien Chevallier wrote:
> access-controller is an optional property that allows a peripheral to
> refer to one or more domain access controller(s).
>
> Description of this property is added to all peripheral binding files of
> the peripheral under the STM32 firewall controllers. It allows an accurate
> representation of the hardware, where various peripherals are connected
> to this firewall bus. The firewall can then check the peripheral accesses
> before allowing it to probe.
>
> Signed-off-by: Gatien Chevallier <gatien.chevallier@foss.st.com>
> ---
>
> Changes in V5:
> - Discarded review tags as the content has changed
> - Renamed feature-domains to access-controller
> - Removed extra blank line in st,stm32-timers.yaml
>
> Changes in V4:
> - Added Jonathan's tag for IIO
>
> Changes in V2:
> - Add missing "feature-domains" property declaration
> in bosch,m_can.yaml and st,stm32-cryp.yaml files
>
> Documentation/devicetree/bindings/crypto/st,stm32-cryp.yaml | 4 ++++
> Documentation/devicetree/bindings/crypto/st,stm32-hash.yaml | 4 ++++
> Documentation/devicetree/bindings/dma/st,stm32-dma.yaml | 4 ++++
> Documentation/devicetree/bindings/dma/st,stm32-dmamux.yaml | 4 ++++
> Documentation/devicetree/bindings/i2c/st,stm32-i2c.yaml | 4 ++++
> Documentation/devicetree/bindings/iio/adc/st,stm32-adc.yaml | 4 ++++
> .../devicetree/bindings/iio/adc/st,stm32-dfsdm-adc.yaml | 4 ++++
> Documentation/devicetree/bindings/iio/dac/st,stm32-dac.yaml | 4 ++++
> Documentation/devicetree/bindings/media/cec/st,stm32-cec.yaml | 4 ++++
> Documentation/devicetree/bindings/media/st,stm32-dcmi.yaml | 4 ++++
> .../bindings/memory-controllers/st,stm32-fmc2-ebi.yaml | 4 ++++
> Documentation/devicetree/bindings/mfd/st,stm32-lptimer.yaml | 4 ++++
> Documentation/devicetree/bindings/mfd/st,stm32-timers.yaml | 4 ++++
> Documentation/devicetree/bindings/mmc/arm,pl18x.yaml | 4 ++++
> Documentation/devicetree/bindings/net/can/bosch,m_can.yaml | 4 ++++
> Documentation/devicetree/bindings/net/stm32-dwmac.yaml | 4 ++++
> Documentation/devicetree/bindings/phy/phy-stm32-usbphyc.yaml | 4 ++++
> .../devicetree/bindings/regulator/st,stm32-vrefbuf.yaml | 4 ++++
> Documentation/devicetree/bindings/rng/st,stm32-rng.yaml | 4 ++++
> Documentation/devicetree/bindings/serial/st,stm32-uart.yaml | 4 ++++
> Documentation/devicetree/bindings/sound/st,stm32-i2s.yaml | 4 ++++
> Documentation/devicetree/bindings/sound/st,stm32-sai.yaml | 4 ++++
> Documentation/devicetree/bindings/sound/st,stm32-spdifrx.yaml | 4 ++++
> Documentation/devicetree/bindings/spi/st,stm32-qspi.yaml | 4 ++++
> Documentation/devicetree/bindings/spi/st,stm32-spi.yaml | 4 ++++
> Documentation/devicetree/bindings/usb/dwc2.yaml | 4 ++++
> 26 files changed, 104 insertions(+)
>
My bot found errors running 'make DT_CHECKER_FLAGS=-m dt_binding_check'
on your patch (DT_CHECKER_FLAGS is new in v5.13):
yamllint warnings/errors:
dtschema/dtc warnings/errors:
/builds/robherring/dt-review-ci/linux/Documentation/devicetree/bindings/phy/phy-stm32-usbphyc.yaml: access-controller: missing type definition
doc reference errors (make refcheckdocs):
See https://patchwork.ozlabs.org/project/devicetree-bindings/patch/20230929142852.578394-3-gatien.chevallier@foss.st.com
The base for the series is generally the latest rc1. A different dependency
should be noted in *this* patch.
If you already ran 'make dt_binding_check' and didn't see the above
error(s), then make sure 'yamllint' is installed and dt-schema is up to
date:
pip3 install dtschema --upgrade
Please check and re-submit after running the above command yourself. Note
that DT_SCHEMA_FILES can be set to your schema file to speed up checking
your schema. However, it must be unset to test all examples with your schema.
@@ -46,6 +46,10 @@ properties:
power-domains:
maxItems: 1
+ access-controller:
+ minItems: 1
+ maxItems: 2
+
required:
- compatible
- reg
@@ -51,6 +51,10 @@ properties:
power-domains:
maxItems: 1
+ access-controller:
+ minItems: 1
+ maxItems: 2
+
required:
- compatible
- reg
@@ -82,6 +82,10 @@ properties:
description: if defined, it indicates that the controller
supports memory-to-memory transfer
+ access-controller:
+ minItems: 1
+ maxItems: 2
+
required:
- compatible
- reg
@@ -28,6 +28,10 @@ properties:
resets:
maxItems: 1
+ access-controller:
+ minItems: 1
+ maxItems: 2
+
required:
- compatible
- reg
@@ -99,6 +99,10 @@ properties:
wakeup-source: true
+ access-controller:
+ minItems: 1
+ maxItems: 2
+
required:
- compatible
- reg
@@ -93,6 +93,10 @@ properties:
'#size-cells':
const: 0
+ access-controller:
+ minItems: 1
+ maxItems: 2
+
allOf:
- if:
properties:
@@ -59,6 +59,10 @@ properties:
If not, SPI CLKOUT frequency will not be accurate.
maximum: 20000000
+ access-controller:
+ minItems: 1
+ maxItems: 2
+
required:
- compatible
- reg
@@ -45,6 +45,10 @@ properties:
'#size-cells':
const: 0
+ access-controller:
+ minItems: 1
+ maxItems: 2
+
additionalProperties: false
required:
@@ -29,6 +29,10 @@ properties:
- const: cec
- const: hdmi-cec
+ access-controller:
+ minItems: 1
+ maxItems: 2
+
required:
- compatible
- reg
@@ -36,6 +36,10 @@ properties:
resets:
maxItems: 1
+ access-controller:
+ minItems: 1
+ maxItems: 2
+
port:
$ref: /schemas/graph.yaml#/$defs/port-base
unevaluatedProperties: false
@@ -45,6 +45,10 @@ properties:
Reflects the memory layout with four integer values per bank. Format:
<bank-number> 0 <address of the bank> <size>
+ access-controller:
+ minItems: 1
+ maxItems: 2
+
patternProperties:
"^.*@[0-4],[a-f0-9]+$":
additionalProperties: true
@@ -44,6 +44,10 @@ properties:
wakeup-source: true
+ access-controller:
+ minItems: 1
+ maxItems: 2
+
pwm:
type: object
additionalProperties: false
@@ -67,6 +67,10 @@ properties:
"#size-cells":
const: 0
+ access-controller:
+ minItems: 1
+ maxItems: 2
+
pwm:
type: object
additionalProperties: false
@@ -79,6 +79,10 @@ properties:
- const: rx
- const: tx
+ access-controller:
+ minItems: 1
+ maxItems: 2
+
power-domains: true
resets:
@@ -118,6 +118,10 @@ properties:
phys:
maxItems: 1
+ access-controller:
+ minItems: 1
+ maxItems: 2
+
required:
- compatible
- reg
@@ -93,6 +93,10 @@ properties:
select RCC clock instead of ETH_REF_CLK.
type: boolean
+ access-controller:
+ minItems: 1
+ maxItems: 2
+
required:
- compatible
- clocks
@@ -55,6 +55,10 @@ properties:
description: number of clock cells for ck_usbo_48m consumer
const: 0
+ access-controller:
+ minItems: 1
+ maxItems: 2
+
# Required child nodes:
patternProperties:
@@ -30,6 +30,10 @@ properties:
vdda-supply:
description: phandle to the vdda input analog voltage.
+ access-controller:
+ minItems: 1
+ maxItems: 2
+
required:
- compatible
- reg
@@ -30,6 +30,10 @@ properties:
type: boolean
description: If set enable the clock detection management
+ access-controller:
+ minItems: 1
+ maxItems: 2
+
required:
- compatible
- reg
@@ -70,6 +70,10 @@ properties:
enum: [1, 2, 4, 8, 12, 14, 16]
default: 8
+ access-controller:
+ minItems: 1
+ maxItems: 2
+
allOf:
- $ref: rs485.yaml#
- $ref: serial.yaml#
@@ -65,6 +65,10 @@ properties:
$ref: audio-graph-port.yaml#
unevaluatedProperties: false
+ access-controller:
+ minItems: 1
+ maxItems: 2
+
required:
- compatible
- "#sound-dai-cells"
@@ -48,6 +48,10 @@ properties:
clock-names:
maxItems: 3
+ access-controller:
+ minItems: 1
+ maxItems: 2
+
required:
- compatible
- reg
@@ -50,6 +50,10 @@ properties:
resets:
maxItems: 1
+ access-controller:
+ minItems: 1
+ maxItems: 2
+
required:
- compatible
- "#sound-dai-cells"
@@ -46,6 +46,10 @@ properties:
- const: tx
- const: rx
+ access-controller:
+ minItems: 1
+ maxItems: 2
+
required:
- compatible
- reg
@@ -59,6 +59,10 @@ properties:
- const: rx
- const: tx
+ access-controller:
+ minItems: 1
+ maxItems: 2
+
patternProperties:
"^[a-zA-Z][a-zA-Z0-9,+\\-._]{0,63}@[0-9a-f]+$":
type: object
@@ -172,6 +172,10 @@ properties:
tpl-support: true
+ access-controller:
+ minItems: 1
+ maxItems: 2
+
dependencies:
port: [ usb-role-switch ]
role-switch-default-mode: [ usb-role-switch ]