dt-bindings: mfd: Convert atmel-flexcom to json-schema

Convert the Atmel flexcom device tree bindings to json schema.

Signed-off-by: Kavyasree Kotagiri <kavyasree.kotagiri@microchip.com>
Reviewed-by: Rob Herring <robh@kernel.org>
Acked-by: Krzysztof Kozlowski <krzysztof.kozlowski@linaro.org>
Signed-off-by: Balakrishnan Sambath <balakrishnan.s@microchip.com>
Link: https://lore.kernel.org/r/20240223-b4-sama5d2-flexcom-yaml-v2-2-7e96c60c7701@microchip.com
Signed-off-by: Lee Jones <lee@kernel.org>
This commit is contained in:
Balakrishnan Sambath 2024-02-23 14:46:23 +05:30 committed by Lee Jones
parent 87bfb48f34
commit ec01319163
2 changed files with 99 additions and 64 deletions

View File

@ -0,0 +1,99 @@
# SPDX-License-Identifier: (GPL-2.0-only OR BSD-2-Clause)
%YAML 1.2
---
$id: http://devicetree.org/schemas/mfd/atmel,sama5d2-flexcom.yaml#
$schema: http://devicetree.org/meta-schemas/core.yaml#
title: Microchip Flexcom (Flexible Serial Communication Unit)
maintainers:
- Kavyasree Kotagiri <kavyasree.kotagiri@microchip.com>
description:
The Microchip Flexcom is just a wrapper which embeds a SPI controller,
an I2C controller and an USART. Only one function can be used at a
time and is chosen at boot time according to the device tree.
properties:
compatible:
oneOf:
- const: atmel,sama5d2-flexcom
- items:
- const: microchip,sam9x7-flexcom
- const: atmel,sama5d2-flexcom
- items:
- const: microchip,sama7g5-flexcom
- const: atmel,sama5d2-flexcom
reg:
maxItems: 1
clocks:
maxItems: 1
"#address-cells":
const: 1
"#size-cells":
const: 1
ranges:
description:
One range for the full I/O register region. (including USART,
TWI and SPI registers).
items:
maxItems: 3
atmel,flexcom-mode:
description: |
Specifies the flexcom mode as follows:
1: USART
2: SPI
3: I2C.
$ref: /schemas/types.yaml#/definitions/uint32
enum: [1, 2, 3]
patternProperties:
"^serial@[0-9a-f]+$":
type: object
description:
Child node describing USART. See atmel-usart.txt for details
of USART bindings.
"^spi@[0-9a-f]+$":
type: object
description:
Child node describing SPI. See ../spi/spi_atmel.txt for details
of SPI bindings.
"^i2c@[0-9a-f]+$":
$ref: /schemas/i2c/atmel,at91sam-i2c.yaml
description:
Child node describing I2C.
required:
- compatible
- reg
- clocks
- "#address-cells"
- "#size-cells"
- ranges
- atmel,flexcom-mode
additionalProperties: false
examples:
- |
#include <dt-bindings/interrupt-controller/arm-gic.h>
flx0: flexcom@f8034000 {
compatible = "atmel,sama5d2-flexcom";
reg = <0xf8034000 0x200>;
clocks = <&flx0_clk>;
#address-cells = <1>;
#size-cells = <1>;
ranges = <0x0 0xf8034000 0x800>;
atmel,flexcom-mode = <2>;
};
...

View File

@ -1,64 +0,0 @@
* Device tree bindings for Atmel Flexcom (Flexible Serial Communication Unit)
The Atmel Flexcom is just a wrapper which embeds a SPI controller, an I2C
controller and an USART. Only one function can be used at a time and is chosen
at boot time according to the device tree.
Required properties:
- compatible: Should be "atmel,sama5d2-flexcom"
or "microchip,sam9x7-flexcom", "atmel,sama5d2-flexcom"
- reg: Should be the offset/length value for Flexcom dedicated
I/O registers (without USART, TWI or SPI registers).
- clocks: Should be the Flexcom peripheral clock from PMC.
- #address-cells: Should be <1>
- #size-cells: Should be <1>
- ranges: Should be one range for the full I/O register region
(including USART, TWI and SPI registers).
- atmel,flexcom-mode: Should be one of the following values:
- <1> for USART
- <2> for SPI
- <3> for I2C
Required child:
A single available child device of type matching the "atmel,flexcom-mode"
property.
The phandle provided by the clocks property of the child is the same as one for
the Flexcom parent.
For other properties, please refer to the documentations of the respective
device:
- ../serial/atmel-usart.txt
- ../spi/spi_atmel.txt
- ../i2c/i2c-at91.txt
Example:
flexcom@f8034000 {
compatible = "atmel,sama5d2-flexcom";
reg = <0xf8034000 0x200>;
clocks = <&flx0_clk>;
#address-cells = <1>;
#size-cells = <1>;
ranges = <0x0 0xf8034000 0x800>;
atmel,flexcom-mode = <2>;
spi@400 {
compatible = "atmel,at91rm9200-spi";
reg = <0x400 0x200>;
interrupts = <19 IRQ_TYPE_LEVEL_HIGH 7>;
pinctrl-names = "default";
pinctrl-0 = <&pinctrl_flx0_default>;
#address-cells = <1>;
#size-cells = <0>;
clocks = <&flx0_clk>;
clock-names = "spi_clk";
atmel,fifo-size = <32>;
flash@0 {
compatible = "atmel,at25f512b";
reg = <0>;
spi-max-frequency = <20000000>;
};
};
};