Setting 'additionalProperties: false' is frequently omitted, but is important in order to check that there aren't extra undocumented properties in a binding. Ideally, we'd just add this automatically and make this the default, but there's some cases where it doesn't work. For example, if a common schema is referenced, then properties in the common schema aren't part of what's considered for 'additionalProperties'. Also, sometimes there are bus specific properties such as 'spi-max-frequency' that go into bus child nodes, but aren't defined in the child node's schema. So let's stick with the json-schema defined default and add 'additionalProperties: false' where needed. This will be a continual review comment and game of wack-a-mole. Signed-off-by: Rob Herring <robh@kernel.org> Reviewed-by: Neil Armstrong <narmstrong@baylibre.com> Acked-by: Mark Brown <broonie@kernel.org> Acked-by: Jonathan Cameron <Jonathan.Cameron@huawei.com> Acked-by: Alexandru Ardelean <alexandru.ardelean@analog.com> Reviewed-by: Benjamin Gaignard <benjamin.gaignard@st.com> Acked-by: Stephen Boyd <sboyd@kernel.org> # clock Acked-by: Lee Jones <lee.jones@linaro.org>
63 lines
1.5 KiB
YAML
63 lines
1.5 KiB
YAML
# SPDX-License-Identifier: GPL-2.0
|
|
%YAML 1.2
|
|
---
|
|
$id: http://devicetree.org/schemas/power/reset/syscon-poweroff.yaml#
|
|
$schema: http://devicetree.org/meta-schemas/core.yaml#
|
|
|
|
title: Generic SYSCON mapped register poweroff driver
|
|
|
|
maintainers:
|
|
- Sebastian Reichel <sre@kernel.org>
|
|
|
|
description: |+
|
|
This is a generic poweroff driver using syscon to map the poweroff register.
|
|
The poweroff is generally performed with a write to the poweroff register
|
|
defined by the register map pointed by syscon reference plus the offset
|
|
with the value and mask defined in the poweroff node.
|
|
Default will be little endian mode, 32 bit access only.
|
|
|
|
properties:
|
|
compatible:
|
|
const: syscon-poweroff
|
|
|
|
mask:
|
|
$ref: /schemas/types.yaml#/definitions/uint32
|
|
description: Update only the register bits defined by the mask (32 bit).
|
|
|
|
offset:
|
|
$ref: /schemas/types.yaml#/definitions/uint32
|
|
description: Offset in the register map for the poweroff register (in bytes).
|
|
|
|
regmap:
|
|
$ref: /schemas/types.yaml#/definitions/phandle
|
|
description: Phandle to the register map node.
|
|
|
|
value:
|
|
$ref: /schemas/types.yaml#/definitions/uint32
|
|
description: The poweroff value written to the poweroff register (32 bit access).
|
|
|
|
required:
|
|
- compatible
|
|
- regmap
|
|
- offset
|
|
|
|
additionalProperties: false
|
|
|
|
allOf:
|
|
- if:
|
|
not:
|
|
required:
|
|
- mask
|
|
then:
|
|
required:
|
|
- value
|
|
|
|
examples:
|
|
- |
|
|
poweroff {
|
|
compatible = "syscon-poweroff";
|
|
regmap = <®mapnode>;
|
|
offset = <0x0>;
|
|
mask = <0x7a>;
|
|
};
|