xref: /freebsd/sys/contrib/device-tree/Bindings/soc/aspeed/uart-routing.yaml (revision d5b0e70f7e04d971691517ce1304d86a1e367e2e)
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
9title: Aspeed UART Routing Controller
10
11maintainers:
12  - Oskar Senft <osk@google.com>
13  - Chia-Wei Wang <chiawei_wang@aspeedtech.com>
14
15description:
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
27properties:
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
37required:
38  - compatible
39
40additionalProperties: false
41
42examples:
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    };
57