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   rts-gpio: true
  74   power-domains: true
  75   clock-frequency: true
  76   current-speed: true
  77   overrun-throttle-ms: true
  78
  79 required:
  80   - compatible
  81   - reg
  82   - interrupts
  83
  84 unevaluatedProperties: false
  85
  86 if:
  87   properties:
  88     compatible:
  89       contains:
  90         enum:
  91           - ti,omap2-uart
  92           - ti,omap3-uart
  93           - ti,omap4-uart
  94
  95 then:
  96   properties:
  97     ti,hwmods:
  98       items:
  99         - pattern: "^uart([1-9])$"
 100
 101 else:
 102   properties:
 103     ti,hwmods: false
 104
 105 examples:
 106   - |
 107     serial@49042000 {
 108         compatible = "ti,omap3-uart";
 109         reg = <0x49042000 0x400>;
 110         interrupts = <80>;
 111         dmas = <&sdma 81 &sdma 82>;
 112         dma-names = "tx", "rx";
 113         ti,hwmods = "uart4";
 114         clock-frequency = <48000000>;
 115     };