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