Documentation/devicetree/bindings/soc/aspeed/uart-routing.yaml

   1 # SPDX-License-Identifier: (GPL-2.0-only OR BSD-2-Clause)
   2 # # Copyright (c) 2018 Google LLC
   3 # # Copyright (c) 2021 Aspeed Technology Inc.
   4 %YAML 1.2
   5 ---
   6 $id: "http://devicetree.org/schemas/soc/aspeed/uart-routing.yaml#"
   7 $schema: "http://devicetree.org/meta-schemas/core.yaml#"
   8
   9 title: Aspeed UART Routing Controller
  10
  11 maintainers:
  12   - Oskar Senft <osk@google.com>
  13   - Chia-Wei Wang <chiawei_wang@aspeedtech.com>
  14
  15 description:
  16   The Aspeed UART routing control allow to dynamically route the inputs for
  17   the built-in UARTS and physical serial I/O ports.
  18
  19   This allows, for example, to connect the output of UART to another UART.
  20   This can be used to enable Host <-> BMC communication via UARTs, e.g. to
  21   allow access to the Host's serial console.
  22
  23   This driver is for the BMC side. The sysfs files allow the BMC userspace
  24   which owns the system configuration policy, to configure how UARTs and
  25   physical serial I/O ports are routed.
  26
  27 properties:
  28   compatible:
  29     items:
  30       - enum:
  31           - aspeed,ast2400-uart-routing
  32           - aspeed,ast2500-uart-routing
  33           - aspeed,ast2600-uart-routing
  34   reg:
  35     maxItems: 1
  36
  37 required:
  38   - compatible
  39
  40 additionalProperties: false
  41
  42 examples:
  43   - |
  44     lpc: lpc@1e789000 {
  45         compatible = "aspeed,ast2600-lpc-v2", "simple-mfd", "syscon";
  46         reg = <0x1e789000 0x1000>;
  47
  48         #address-cells = <1>;
  49         #size-cells = <1>;
  50         ranges = <0x0 0x1e789000 0x1000>;
  51
  52         uart_routing: uart-routing@98 {
  53             compatible = "aspeed,ast2600-uart-routing";
  54             reg = <0x98 0x8>;
  55         };
  56     };