xref: /freebsd-src/sys/contrib/device-tree/Bindings/soc/aspeed/uart-routing.yaml (revision aa1a8ff2d6dbc51ef058f46f3db5a8bb77967145)
18cc087a1SEmmanuel Vadot# SPDX-License-Identifier: (GPL-2.0-only OR BSD-2-Clause)
28cc087a1SEmmanuel Vadot# # Copyright (c) 2018 Google LLC
38cc087a1SEmmanuel Vadot# # Copyright (c) 2021 Aspeed Technology Inc.
48cc087a1SEmmanuel Vadot%YAML 1.2
58cc087a1SEmmanuel Vadot---
6*aa1a8ff2SEmmanuel Vadot$id: http://devicetree.org/schemas/soc/aspeed/uart-routing.yaml#
7*aa1a8ff2SEmmanuel Vadot$schema: http://devicetree.org/meta-schemas/core.yaml#
88cc087a1SEmmanuel Vadot
98cc087a1SEmmanuel Vadottitle: Aspeed UART Routing Controller
108cc087a1SEmmanuel Vadot
118cc087a1SEmmanuel Vadotmaintainers:
128cc087a1SEmmanuel Vadot  - Oskar Senft <osk@google.com>
138cc087a1SEmmanuel Vadot  - Chia-Wei Wang <chiawei_wang@aspeedtech.com>
148cc087a1SEmmanuel Vadot
158cc087a1SEmmanuel Vadotdescription:
168cc087a1SEmmanuel Vadot  The Aspeed UART routing control allow to dynamically route the inputs for
178cc087a1SEmmanuel Vadot  the built-in UARTS and physical serial I/O ports.
188cc087a1SEmmanuel Vadot
198cc087a1SEmmanuel Vadot  This allows, for example, to connect the output of UART to another UART.
208cc087a1SEmmanuel Vadot  This can be used to enable Host <-> BMC communication via UARTs, e.g. to
218cc087a1SEmmanuel Vadot  allow access to the Host's serial console.
228cc087a1SEmmanuel Vadot
238cc087a1SEmmanuel Vadot  This driver is for the BMC side. The sysfs files allow the BMC userspace
248cc087a1SEmmanuel Vadot  which owns the system configuration policy, to configure how UARTs and
258cc087a1SEmmanuel Vadot  physical serial I/O ports are routed.
268cc087a1SEmmanuel Vadot
278cc087a1SEmmanuel Vadotproperties:
288cc087a1SEmmanuel Vadot  compatible:
298cc087a1SEmmanuel Vadot    items:
308cc087a1SEmmanuel Vadot      - enum:
318cc087a1SEmmanuel Vadot          - aspeed,ast2400-uart-routing
328cc087a1SEmmanuel Vadot          - aspeed,ast2500-uart-routing
338cc087a1SEmmanuel Vadot          - aspeed,ast2600-uart-routing
348cc087a1SEmmanuel Vadot  reg:
358cc087a1SEmmanuel Vadot    maxItems: 1
368cc087a1SEmmanuel Vadot
378cc087a1SEmmanuel Vadotrequired:
388cc087a1SEmmanuel Vadot  - compatible
398cc087a1SEmmanuel Vadot
408cc087a1SEmmanuel VadotadditionalProperties: false
418cc087a1SEmmanuel Vadot
428cc087a1SEmmanuel Vadotexamples:
438cc087a1SEmmanuel Vadot  - |
448cc087a1SEmmanuel Vadot    lpc: lpc@1e789000 {
458cc087a1SEmmanuel Vadot        compatible = "aspeed,ast2600-lpc-v2", "simple-mfd", "syscon";
468cc087a1SEmmanuel Vadot        reg = <0x1e789000 0x1000>;
478cc087a1SEmmanuel Vadot
488cc087a1SEmmanuel Vadot        #address-cells = <1>;
498cc087a1SEmmanuel Vadot        #size-cells = <1>;
508cc087a1SEmmanuel Vadot        ranges = <0x0 0x1e789000 0x1000>;
518cc087a1SEmmanuel Vadot
528cc087a1SEmmanuel Vadot        uart_routing: uart-routing@98 {
538cc087a1SEmmanuel Vadot            compatible = "aspeed,ast2600-uart-routing";
548cc087a1SEmmanuel Vadot            reg = <0x98 0x8>;
558cc087a1SEmmanuel Vadot        };
568cc087a1SEmmanuel Vadot    };
57