mirror of
https://github.com/torvalds/linux.git
synced 2026-04-21 08:13:56 -04:00
39bd2b6a37
The 'phandle-array' type is a bit ambiguous. It can be either just an
array of phandles or an array of phandles plus args. Many schemas for
phandle-array properties aren't clear in the schema which case applies
though the description usually describes it.
The array of phandles case boils down to needing:
items:
maxItems: 1
The phandle plus args cases should typically take this form:
items:
- items:
- description: A phandle
- description: 1st arg cell
- description: 2nd arg cell
With this change, some examples need updating so that the bracketing of
property values matches the schema.
Signed-off-by: Rob Herring <robh@kernel.org>
Acked-by: Viresh Kumar <viresh.kumar@linaro.org>
Acked-by: Vinod Koul <vkoul@kernel.org>
Acked-by: Ulf Hansson <ulf.hansson@linaro.org>
Acked-by: Georgi Djakov <djakov@kernel.org>
Reviewed-by: Geert Uytterhoeven <geert+renesas@glider.be>
Acked-by: Mark Brown <broonie@kernel.org>
Acked-by: Krzysztof Kozlowski <krzysztof.kozlowski@canonical.com>
Acked-by: Stephen Boyd <sboyd@kernel.org>
Acked-by: Greg Kroah-Hartman <gregkh@linuxfoundation.org>
Acked-by: Marc Kleine-Budde <mkl@pengutronix.de>
Link: https://lore.kernel.org/r/20220119015038.2433585-1-robh@kernel.org
120 lines
2.6 KiB
YAML
120 lines
2.6 KiB
YAML
# SPDX-License-Identifier: (GPL-2.0-only OR BSD-2-Clause)
|
|
%YAML 1.2
|
|
---
|
|
$id: http://devicetree.org/schemas/net/can/bosch,c_can.yaml#
|
|
$schema: http://devicetree.org/meta-schemas/core.yaml#
|
|
|
|
title: Bosch C_CAN/D_CAN controller Device Tree Bindings
|
|
|
|
description: Bosch C_CAN/D_CAN controller for CAN bus
|
|
|
|
maintainers:
|
|
- Dario Binacchi <dariobin@libero.it>
|
|
|
|
allOf:
|
|
- $ref: can-controller.yaml#
|
|
|
|
properties:
|
|
compatible:
|
|
oneOf:
|
|
- enum:
|
|
- bosch,c_can
|
|
- bosch,d_can
|
|
- ti,dra7-d_can
|
|
- ti,am3352-d_can
|
|
- items:
|
|
- enum:
|
|
- ti,am4372-d_can
|
|
- const: ti,am3352-d_can
|
|
|
|
reg:
|
|
maxItems: 1
|
|
|
|
interrupts:
|
|
minItems: 1
|
|
maxItems: 4
|
|
|
|
power-domains:
|
|
description: |
|
|
Should contain a phandle to a PM domain provider node and an args
|
|
specifier containing the DCAN device id value. It's mandatory for
|
|
Keystone 2 66AK2G SoCs only.
|
|
maxItems: 1
|
|
|
|
clocks:
|
|
description: |
|
|
CAN functional clock phandle.
|
|
maxItems: 1
|
|
|
|
clock-names:
|
|
maxItems: 1
|
|
|
|
syscon-raminit:
|
|
description: |
|
|
Handle to system control region that contains the RAMINIT register,
|
|
register offset to the RAMINIT register and the CAN instance number (0
|
|
offset).
|
|
$ref: /schemas/types.yaml#/definitions/phandle-array
|
|
items:
|
|
- items:
|
|
- description: The phandle to the system control region.
|
|
- description: The register offset.
|
|
- description: The CAN instance number.
|
|
|
|
resets:
|
|
maxItems: 1
|
|
|
|
required:
|
|
- compatible
|
|
- reg
|
|
- interrupts
|
|
- clocks
|
|
|
|
if:
|
|
properties:
|
|
compatible:
|
|
contains:
|
|
enum:
|
|
- bosch,d_can
|
|
|
|
then:
|
|
properties:
|
|
interrupts:
|
|
minItems: 4
|
|
maxItems: 4
|
|
items:
|
|
- description: Error and status IRQ
|
|
- description: Message object IRQ
|
|
- description: RAM ECC correctable error IRQ
|
|
- description: RAM ECC non-correctable error IRQ
|
|
|
|
else:
|
|
properties:
|
|
interrupts:
|
|
maxItems: 1
|
|
items:
|
|
- description: Error and status IRQ
|
|
|
|
additionalProperties: false
|
|
|
|
examples:
|
|
- |
|
|
#include <dt-bindings/reset/altr,rst-mgr.h>
|
|
|
|
can@ffc00000 {
|
|
compatible = "bosch,d_can";
|
|
reg = <0xffc00000 0x1000>;
|
|
interrupts = <0 131 4>, <0 132 4>, <0 133 4>, <0 134 4>;
|
|
clocks = <&can0_clk>;
|
|
resets = <&rst CAN0_RESET>;
|
|
};
|
|
- |
|
|
can@0 {
|
|
compatible = "ti,am3352-d_can";
|
|
reg = <0x0 0x2000>;
|
|
clocks = <&dcan1_fck>;
|
|
clock-names = "fck";
|
|
syscon-raminit = <&scm_conf 0x644 1>;
|
|
interrupts = <55>;
|
|
};
|