Documentation/devicetree/bindings/serial/8250_omap.yaml

   1 # SPDX-License-Identifier: (GPL-2.0-only OR BSD-2-Clause)
   2 %YAML 1.2
   3 ---
   4 $id: http://devicetree.org/schemas/serial/8250_omap.yaml#
   5 $schema: http://devicetree.org/meta-schemas/core.yaml#
   6
   7 title: 8250 compliant UARTs on TI's OMAP2+ and K3 SoCs
   8
   9 maintainers:
  10   - Vignesh Raghavendra <vigneshr@ti.com>
  11
  12 allOf:
  13   - $ref: /schemas/serial/serial.yaml#
  14   - $ref: /schemas/serial/rs485.yaml#
  15
  16 properties:
  17   compatible:
  18     oneOf:
  19       - enum:
  20           - ti,am3352-uart
  21           - ti,am4372-uart
  22           - ti,am654-uart
  23           - ti,dra742-uart
  24           - ti,omap2-uart
  25           - ti,omap3-uart
  26           - ti,omap4-uart
  27       - items:
  28           - enum:
  29               - ti,am64-uart
  30               - ti,j721e-uart
  31           - const: ti,am654-uart
  32
  33   ti,hwmods:
  34     description:
  35       Must be "uart<n>", n being the instance number (1-based)
  36       This property is applicable only on legacy platforms mainly omap2/3
  37       and ti81xx and should not be used on other platforms.
  38     $ref: /schemas/types.yaml#/definitions/string
  39     deprecated: true
  40
  41   dmas:
  42     minItems: 1
  43     maxItems: 2
  44
  45   dma-names:
  46     items:
  47       - const: tx
  48       - const: rx
  49
  50   reg:
  51     maxItems: 1
  52
  53   interrupts:
  54     minItems: 1
  55     maxItems: 2
  56     description:
  57       First entry is module IRQ required for normal IO operation.
  58       Second entry is optional and corresponds to system wakeup IRQ
  59       where supported.
  60
  61   clocks:
  62     maxItems: 1
  63
  64   clock-names:
  65     const: fclk
  66
  67   rts-gpios: true
  68   cts-gpios: true
  69   dtr-gpios: true
  70   dsr-gpios: true
  71   rng-gpios: true
  72   dcd-gpios: true
  73   rs485-rts-active-high: true
  74   rts-gpio: true
  75   power-domains: true
  76   clock-frequency: true
  77   current-speed: true
  78   overrun-throttle-ms: true
  79
  80 required:
  81   - compatible
  82   - reg
  83   - interrupts
  84
  85 unevaluatedProperties: false
  86
  87 if:
  88   properties:
  89     compatible:
  90       contains:
  91         enum:
  92           - ti,omap2-uart
  93           - ti,omap3-uart
  94           - ti,omap4-uart
  95
  96 then:
  97   properties:
  98     ti,hwmods:
  99       items:
 100         - pattern: "^uart([1-9])$"
 101
 102 else:
 103   properties:
 104     ti,hwmods: false
 105
 106 examples:
 107   - |
 108     serial@49042000 {
 109         compatible = "ti,omap3-uart";
 110         reg = <0x49042000 0x400>;
 111         interrupts = <80>;
 112         dmas = <&sdma 81 &sdma 82>;
 113         dma-names = "tx", "rx";
 114         ti,hwmods = "uart4";
 115         clock-frequency = <48000000>;
 116     };