mirror of
https://git.kernel.org/pub/scm/linux/kernel/git/torvalds/linux.git
synced 2026-08-30 06:29:06 -04:00
a82fb629ce
Introduce a new generic fallback compatible string 'cdns,cdnsp' for
Cadence USBSSP controllers to support hardware configurations where
the Dual-Role Device (DRD) register block is missing or inaccessible.
Following the maintainer's feedback, avoid generic property-like naming
(such as "-no-drd") and use a clean generic fallback. To keep the schema
resource-driven and strictly validated, define a two-string compatible
matrix using an empty schema ({}) wildcard. This allows future vendor
SoC compatibles to be prepended while safely falling back to the 2-resource
USBSSP configuration.
When 'cdns,cdnsp' is matched:
- The 'otg' register and interrupt resources are not required.
- The 'reg' and 'interrupts' properties are restricted to 2 items
(host and device).
- 'dr_mode' must be explicitly set to either 'host' or 'peripheral'.
The standard 'cdns,usb3' compatible remains unchanged, maintaining
backward compatibility by requiring all 3 resource sets (otg, host, dev).
Signed-off-by: Pawel Laszczak <pawell@cadence.com>
Acked-by: Conor Dooley <conor.dooley@microchip.com>
Link: https://patch.msgid.link/20260521-no_drd_config_v9-v9-1-2512cef10104@cadence.com
Signed-off-by: Greg Kroah-Hartman <gregkh@linuxfoundation.org>
162 lines
3.8 KiB
YAML
162 lines
3.8 KiB
YAML
# SPDX-License-Identifier: GPL-2.0-only OR BSD-2-Clause
|
|
%YAML 1.2
|
|
---
|
|
$id: http://devicetree.org/schemas/usb/cdns,usb3.yaml#
|
|
$schema: http://devicetree.org/meta-schemas/core.yaml#
|
|
|
|
title: Cadence USBSS and USBSSP DRD controller
|
|
|
|
maintainers:
|
|
- Pawel Laszczak <pawell@cadence.com>
|
|
|
|
description:
|
|
Cadence USB dual-role controller. Covers USBSS (SuperSpeed, USB 3.0) and
|
|
USBSSP (SuperSpeed Plus, USB 3.1 gen2x1). Both variants share the same
|
|
DRD/OTG register interface, so the driver auto-detects the controller
|
|
version at runtime.
|
|
|
|
properties:
|
|
compatible:
|
|
oneOf:
|
|
- const: cdns,usb3
|
|
- items:
|
|
- {}
|
|
- const: cdns,cdnsp
|
|
|
|
reg:
|
|
minItems: 2
|
|
maxItems: 3
|
|
|
|
reg-names:
|
|
minItems: 2
|
|
maxItems: 3
|
|
items:
|
|
enum: [ otg, xhci, dev ]
|
|
|
|
interrupts:
|
|
minItems: 2
|
|
items:
|
|
- description: XHCI host controller interrupt
|
|
- description: Device controller interrupt
|
|
- description: OTG/DRD controller interrupt
|
|
- description: interrupt used to wake up core, e.g when usbcmd.rs is
|
|
cleared by xhci core, this interrupt is optional
|
|
|
|
interrupt-names:
|
|
minItems: 2
|
|
items:
|
|
- const: host
|
|
- const: peripheral
|
|
- const: otg
|
|
- const: wakeup
|
|
|
|
port:
|
|
$ref: /schemas/graph.yaml#/properties/port
|
|
description:
|
|
This port is used with the 'usb-role-switch' property to connect the
|
|
cdns3 to type C connector.
|
|
|
|
maximum-speed:
|
|
enum: [super-speed-plus, super-speed, high-speed, full-speed]
|
|
|
|
phys:
|
|
minItems: 1
|
|
maxItems: 2
|
|
|
|
phy-names:
|
|
minItems: 1
|
|
maxItems: 2
|
|
items:
|
|
anyOf:
|
|
- const: cdns3,usb2-phy
|
|
- const: cdns3,usb3-phy
|
|
|
|
cdns,on-chip-buff-size:
|
|
description:
|
|
size of memory intended as internal memory for endpoints
|
|
buffers expressed in KB
|
|
$ref: /schemas/types.yaml#/definitions/uint16
|
|
|
|
cdns,phyrst-a-enable:
|
|
description: Enable resetting of PHY if Rx fail is detected
|
|
type: boolean
|
|
|
|
dependencies:
|
|
port: [ usb-role-switch ]
|
|
|
|
required:
|
|
- compatible
|
|
- reg
|
|
- reg-names
|
|
- interrupts
|
|
- interrupt-names
|
|
|
|
allOf:
|
|
- $ref: usb-drd.yaml#
|
|
- $ref: usb-xhci.yaml#
|
|
|
|
- if:
|
|
properties:
|
|
compatible:
|
|
contains:
|
|
const: cdns,cdnsp
|
|
then:
|
|
properties:
|
|
reg:
|
|
items:
|
|
- description: XHCI Host controller registers
|
|
- description: DEVICE controller registers
|
|
reg-names:
|
|
items:
|
|
- const: xhci
|
|
- const: dev
|
|
interrupts:
|
|
maxItems: 2
|
|
interrupt-names:
|
|
items:
|
|
- const: host
|
|
- const: peripheral
|
|
dr_mode:
|
|
enum: [host, peripheral]
|
|
else:
|
|
properties:
|
|
reg:
|
|
items:
|
|
- description: OTG controller registers
|
|
- description: XHCI Host controller registers
|
|
- description: DEVICE controller registers
|
|
reg-names:
|
|
items:
|
|
- const: otg
|
|
- const: xhci
|
|
- const: dev
|
|
interrupts:
|
|
minItems: 3
|
|
maxItems: 4
|
|
interrupt-names:
|
|
minItems: 3
|
|
|
|
unevaluatedProperties: false
|
|
|
|
examples:
|
|
- |
|
|
#include <dt-bindings/interrupt-controller/arm-gic.h>
|
|
bus {
|
|
#address-cells = <2>;
|
|
#size-cells = <2>;
|
|
|
|
usb@6000000 {
|
|
compatible = "cdns,usb3";
|
|
reg = <0x00 0x6000000 0x00 0x10000>,
|
|
<0x00 0x6010000 0x00 0x10000>,
|
|
<0x00 0x6020000 0x00 0x10000>;
|
|
reg-names = "otg", "xhci", "dev";
|
|
interrupts = <GIC_SPI 96 IRQ_TYPE_LEVEL_HIGH>,
|
|
<GIC_SPI 102 IRQ_TYPE_LEVEL_HIGH>,
|
|
<GIC_SPI 120 IRQ_TYPE_LEVEL_HIGH>;
|
|
interrupt-names = "host", "peripheral", "otg";
|
|
maximum-speed = "super-speed";
|
|
dr_mode = "otg";
|
|
};
|
|
};
|