Skip to content

Commit

Permalink
dt-bindings: serial: Convert Samsung UART bindings to json-schema
Browse files Browse the repository at this point in the history
Convert Samsung S3C/S5P/Exynos Serial/UART bindings to DT schema format
using json-schema.

Signed-off-by: Krzysztof Kozlowski <krzk@kernel.org>
Signed-off-by: Rob Herring <robh@kernel.org>
  • Loading branch information
Krzysztof Kozlowski authored and Rob Herring committed Nov 5, 2019
1 parent 23c091d commit 6a24490
Show file tree
Hide file tree
Showing 3 changed files with 119 additions and 59 deletions.
Original file line number Diff line number Diff line change
Expand Up @@ -18,7 +18,7 @@ an optional sub-node. For "samsung,exynos5433-lpass" compatible this includes:
UART, SLIMBUS, PCM, I2S, DMAC, Timers 0...4, VIC, WDT 0...1 devices.

Bindings of the sub-nodes are described in:
../serial/samsung_uart.txt
../serial/samsung_uart.yaml
../sound/samsung-i2s.txt
../dma/arm-pl330.txt

Expand Down
58 changes: 0 additions & 58 deletions Documentation/devicetree/bindings/serial/samsung_uart.txt

This file was deleted.

118 changes: 118 additions & 0 deletions Documentation/devicetree/bindings/serial/samsung_uart.yaml
Original file line number Diff line number Diff line change
@@ -0,0 +1,118 @@
# SPDX-License-Identifier: GPL-2.0
%YAML 1.2
---
$id: http://devicetree.org/schemas/serial/samsung_uart.yaml#
$schema: http://devicetree.org/meta-schemas/core.yaml#

title: Samsung S3C, S5P and Exynos SoC UART Controller

maintainers:
- Krzysztof Kozlowski <krzk@kernel.org>
- Greg Kroah-Hartman <gregkh@linuxfoundation.org>

description: |+
Each Samsung UART should have an alias correctly numbered in the "aliases"
node, according to serialN format, where N is the port number (non-negative
decimal integer) as specified by User's Manual of respective SoC.
properties:
compatible:
items:
- enum:
- samsung,s3c2410-uart
- samsung,s3c2412-uart
- samsung,s3c2440-uart
- samsung,s3c6400-uart
- samsung,s5pv210-uart
- samsung,exynos4210-uart

reg:
maxItems: 1

clocks:
minItems: 2
maxItems: 5

clock-names:
description: N = 0 is allowed for SoCs without internal baud clock mux.
minItems: 2
maxItems: 5
items:
- const: uart
- pattern: '^clk_uart_baud[0-3]$'
- pattern: '^clk_uart_baud[0-3]$'
- pattern: '^clk_uart_baud[0-3]$'
- pattern: '^clk_uart_baud[0-3]$'

interrupts:
description: RX interrupt and optionally TX interrupt.
minItems: 1
maxItems: 2

samsung,uart-fifosize:
description: The fifo size supported by the UART channel.
allOf:
- $ref: /schemas/types.yaml#/definitions/uint32
- enum: [16, 64, 256]

required:
- compatible
- clocks
- clock-names
- interrupts
- reg

allOf:
- if:
properties:
compatible:
contains:
enum:
- samsung,s3c2410-uart
- samsung,s5pv210-uart
then:
properties:
clocks:
minItems: 2
maxItems: 3
clock-names:
minItems: 2
maxItems: 3
items:
- const: uart
- pattern: '^clk_uart_baud[0-1]$'
- pattern: '^clk_uart_baud[0-1]$'

- if:
properties:
compatible:
contains:
enum:
- samsung,exynos4210-uart
then:
properties:
clocks:
minItems: 2
maxItems: 2
clock-names:
minItems: 2
maxItems: 2
items:
- const: uart
- const: clk_uart_baud0

examples:
- |
#include <dt-bindings/clock/samsung,s3c64xx-clock.h>
uart0: serial@7f005000 {
compatible = "samsung,s3c6400-uart";
reg = <0x7f005000 0x100>;
interrupt-parent = <&vic1>;
interrupts = <5>;
clock-names = "uart", "clk_uart_baud2",
"clk_uart_baud3";
clocks = <&clocks PCLK_UART0>, <&clocks PCLK_UART0>,
<&clocks SCLK_UART>;
samsung,uart-fifosize = <16>;
};

0 comments on commit 6a24490

Please sign in to comment.