mirror of
https://github.com/AuxXxilium/linux_dsm_epyc7002.git
synced 2025-02-05 22:45:10 +07:00
dt-bindings: serial: Convert snps,dw-apb-uart to json-schema
Convert the snps,dw-apb-uart binding to DT schema using json-schema. The Rockchip and Broadcom compatible strings were not documented, so add them here. Cc: Greg Kroah-Hartman <gregkh@linuxfoundation.org> Cc: linux-serial@vger.kernel.org Reviewed-by: Simon Horman <horms+renesas@verge.net.au> Signed-off-by: Rob Herring <robh@kernel.org> Signed-off-by: Greg Kroah-Hartman <gregkh@linuxfoundation.org>
This commit is contained in:
Rob Herring
Greg Kroah-Hartman
parent
defe3b6d70
commit
df23007914
@ -1,76 +0,0 @@
|
||||
* Synopsys DesignWare ABP UART
|
||||
|
||||
Required properties:
|
||||
- compatible : "snps,dw-apb-uart"
|
||||
- reg : offset and length of the register set for the device.
|
||||
- interrupts : should contain uart interrupt.
|
||||
|
||||
Clock handling:
|
||||
The clock rate of the input clock needs to be supplied by one of
|
||||
- clock-frequency : the input clock frequency for the UART.
|
||||
- clocks : phandle to the input clock
|
||||
|
||||
The supplying peripheral clock can also be handled, needing a second property
|
||||
- clock-names: tuple listing input clock names.
|
||||
Required elements: "baudclk", "apb_pclk"
|
||||
|
||||
Optional properties:
|
||||
- snps,uart-16550-compatible : reflects the value of UART_16550_COMPATIBLE
|
||||
configuration parameter. Define this if your UART does not implement the busy
|
||||
functionality.
|
||||
- resets : phandle to the parent reset controller.
|
||||
- reg-shift : quantity to shift the register offsets by. If this property is
|
||||
not present then the register offsets are not shifted.
|
||||
- reg-io-width : the size (in bytes) of the IO accesses that should be
|
||||
performed on the device. If this property is not present then single byte
|
||||
accesses are used.
|
||||
- dcd-override : Override the DCD modem status signal. This signal will always
|
||||
be reported as active instead of being obtained from the modem status
|
||||
register. Define this if your serial port does not use this pin.
|
||||
- dsr-override : Override the DTS modem status signal. This signal will always
|
||||
be reported as active instead of being obtained from the modem status
|
||||
register. Define this if your serial port does not use this pin.
|
||||
- cts-override : Override the CTS modem status signal. This signal will always
|
||||
be reported as active instead of being obtained from the modem status
|
||||
register. Define this if your serial port does not use this pin.
|
||||
- ri-override : Override the RI modem status signal. This signal will always be
|
||||
reported as inactive instead of being obtained from the modem status register.
|
||||
Define this if your serial port does not use this pin.
|
||||
|
||||
Example:
|
||||
|
||||
uart@80230000 {
|
||||
compatible = "snps,dw-apb-uart";
|
||||
reg = <0x80230000 0x100>;
|
||||
clock-frequency = <3686400>;
|
||||
interrupts = <10>;
|
||||
reg-shift = <2>;
|
||||
reg-io-width = <4>;
|
||||
dcd-override;
|
||||
dsr-override;
|
||||
cts-override;
|
||||
ri-override;
|
||||
};
|
||||
|
||||
Example with one clock:
|
||||
|
||||
uart@80230000 {
|
||||
compatible = "snps,dw-apb-uart";
|
||||
reg = <0x80230000 0x100>;
|
||||
clocks = <&baudclk>;
|
||||
interrupts = <10>;
|
||||
reg-shift = <2>;
|
||||
reg-io-width = <4>;
|
||||
};
|
||||
|
||||
Example with two clocks:
|
||||
|
||||
uart@80230000 {
|
||||
compatible = "snps,dw-apb-uart";
|
||||
reg = <0x80230000 0x100>;
|
||||
clocks = <&baudclk>, <&apb_pclk>;
|
||||
clock-names = "baudclk", "apb_pclk";
|
||||
interrupts = <10>;
|
||||
reg-shift = <2>;
|
||||
reg-io-width = <4>;
|
||||
};
|
||||
135
Documentation/devicetree/bindings/serial/snps-dw-apb-uart.yaml
Normal file
135
Documentation/devicetree/bindings/serial/snps-dw-apb-uart.yaml
Normal file
@ -0,0 +1,135 @@
|
||||
# SPDX-License-Identifier: GPL-2.0
|
||||
%YAML 1.2
|
||||
---
|
||||
$id: http://devicetree.org/schemas/serial/snps-dw-apb-uart.yaml#
|
||||
$schema: http://devicetree.org/meta-schemas/core.yaml#
|
||||
|
||||
title: Synopsys DesignWare ABP UART
|
||||
|
||||
maintainers:
|
||||
- Rob Herring <robh@kernel.org>
|
||||
|
||||
allOf:
|
||||
- $ref: /schemas/serial.yaml#
|
||||
|
||||
properties:
|
||||
compatible:
|
||||
oneOf:
|
||||
- items:
|
||||
- enum:
|
||||
- rockchip,px30-uart
|
||||
- rockchip,rk3036-uart
|
||||
- rockchip,rk3066-uart
|
||||
- rockchip,rk3188-uart
|
||||
- rockchip,rk3288-uart
|
||||
- rockchip,rk3328-uart
|
||||
- rockchip,rk3368-uart
|
||||
- rockchip,rk3399-uart
|
||||
- rockchip,rv1108-uart
|
||||
- const: snps,dw-apb-uart
|
||||
- items:
|
||||
- enum:
|
||||
- brcm,bcm11351-dw-apb-uart
|
||||
- brcm,bcm21664-dw-apb-uart
|
||||
- const: snps,dw-apb-uart
|
||||
- const: snps,dw-apb-uart
|
||||
|
||||
reg:
|
||||
maxItems: 1
|
||||
|
||||
interrupts:
|
||||
maxItems: 1
|
||||
|
||||
clock-frequency: true
|
||||
|
||||
clocks:
|
||||
minItems: 1
|
||||
maxItems: 2
|
||||
|
||||
clock-names:
|
||||
items:
|
||||
- const: baudclk
|
||||
- const: apb_pclk
|
||||
|
||||
snps,uart-16550-compatible:
|
||||
description: reflects the value of UART_16550_COMPATIBLE configuration
|
||||
parameter. Define this if your UART does not implement the busy functionality.
|
||||
type: boolean
|
||||
|
||||
resets:
|
||||
maxItems: 1
|
||||
|
||||
reg-shift: true
|
||||
|
||||
reg-io-width: true
|
||||
|
||||
dcd-override:
|
||||
description: Override the DCD modem status signal. This signal will
|
||||
always be reported as active instead of being obtained from the modem
|
||||
status register. Define this if your serial port does not use this
|
||||
pin.
|
||||
type: boolean
|
||||
|
||||
dsr-override:
|
||||
description: Override the DTS modem status signal. This signal will
|
||||
always be reported as active instead of being obtained from the modem
|
||||
status register. Define this if your serial port does not use this
|
||||
pin.
|
||||
type: boolean
|
||||
|
||||
cts-override:
|
||||
description: Override the CTS modem status signal. This signal will
|
||||
always be reported as active instead of being obtained from the modem
|
||||
status register. Define this if your serial port does not use this
|
||||
pin.
|
||||
type: boolean
|
||||
|
||||
ri-override:
|
||||
description: Override the RI modem status signal. This signal will always
|
||||
be reported as inactive instead of being obtained from the modem status
|
||||
register. Define this if your serial port does not use this pin.
|
||||
type: boolean
|
||||
|
||||
required:
|
||||
- compatible
|
||||
- reg
|
||||
- interrupts
|
||||
|
||||
examples:
|
||||
- |
|
||||
serial@80230000 {
|
||||
compatible = "snps,dw-apb-uart";
|
||||
reg = <0x80230000 0x100>;
|
||||
clock-frequency = <3686400>;
|
||||
interrupts = <10>;
|
||||
reg-shift = <2>;
|
||||
reg-io-width = <4>;
|
||||
dcd-override;
|
||||
dsr-override;
|
||||
cts-override;
|
||||
ri-override;
|
||||
};
|
||||
|
||||
- |
|
||||
// Example with one clock:
|
||||
serial@80230000 {
|
||||
compatible = "snps,dw-apb-uart";
|
||||
reg = <0x80230000 0x100>;
|
||||
clocks = <&baudclk>;
|
||||
interrupts = <10>;
|
||||
reg-shift = <2>;
|
||||
reg-io-width = <4>;
|
||||
};
|
||||
|
||||
- |
|
||||
// Example with two clocks:
|
||||
serial@80230000 {
|
||||
compatible = "snps,dw-apb-uart";
|
||||
reg = <0x80230000 0x100>;
|
||||
clocks = <&baudclk>, <&apb_pclk>;
|
||||
clock-names = "baudclk", "apb_pclk";
|
||||
interrupts = <10>;
|
||||
reg-shift = <2>;
|
||||
reg-io-width = <4>;
|
||||
};
|
||||
...
|
||||
Loading…
Reference in New Issue
Block a user