From nobody Fri Dec 19 22:06:04 2025 Received: from mail-io1-f67.google.com (mail-io1-f67.google.com [209.85.166.67]) (using TLSv1.2 with cipher ECDHE-RSA-AES128-GCM-SHA256 (128/128 bits)) (No client certificate requested) by smtp.subspace.kernel.org (Postfix) with ESMTPS id BABBE2F99A6 for ; Fri, 7 Nov 2025 19:16:07 +0000 (UTC) Authentication-Results: smtp.subspace.kernel.org; arc=none smtp.client-ip=209.85.166.67 ARC-Seal: i=1; a=rsa-sha256; d=subspace.kernel.org; s=arc-20240116; t=1762542969; cv=none; b=WQrSfBLpbm76Hu8swEqi/2bjvV4/rdAhj+WwgbM01WtdISKjj793+2YFRztdhdoWCLbXGQaeir7TUDTwrwY32dk87/KHvU2WCjwZzK3whmByzIImFwC+ZobiUs9iB6GGtf51x1tYQYEW4ANJ+ta4//nyhFM74jbf34EnfPdEr40= ARC-Message-Signature: i=1; a=rsa-sha256; d=subspace.kernel.org; s=arc-20240116; t=1762542969; c=relaxed/simple; bh=w4sH8gKES/QyK5DTu18MOerFvzDp7pfH5YwAuXgh+W4=; h=From:To:Cc:Subject:Date:Message-ID:In-Reply-To:References: MIME-Version; b=OX4le17rSjkK2Vc8F2SVLz/ABRYbdwmPoygpUJtJBxLnzHoTpGtKQ5q3bPEFmeX0nr7lJkf2D0r7ddPAI6owZIFz+7fgqedEfB2CUJ1ie4676K1LkAZD1z2/bdsaq/e7Oc/fM9Ak3uwA6SKQPtIMCXZoebSWo2C0K3OQMjNrd1c= ARC-Authentication-Results: i=1; smtp.subspace.kernel.org; dmarc=pass (p=none dis=none) header.from=riscstar.com; spf=pass smtp.mailfrom=riscstar.com; dkim=pass (2048-bit key) header.d=riscstar-com.20230601.gappssmtp.com header.i=@riscstar-com.20230601.gappssmtp.com header.b=JO7SK/eO; arc=none smtp.client-ip=209.85.166.67 Authentication-Results: smtp.subspace.kernel.org; dmarc=pass (p=none dis=none) header.from=riscstar.com Authentication-Results: smtp.subspace.kernel.org; spf=pass smtp.mailfrom=riscstar.com Authentication-Results: smtp.subspace.kernel.org; dkim=pass (2048-bit key) header.d=riscstar-com.20230601.gappssmtp.com header.i=@riscstar-com.20230601.gappssmtp.com header.b="JO7SK/eO" Received: by mail-io1-f67.google.com with SMTP id ca18e2360f4ac-9487bde3d07so29001739f.1 for ; Fri, 07 Nov 2025 11:16:07 -0800 (PST) DKIM-Signature: v=1; a=rsa-sha256; c=relaxed/relaxed; d=riscstar-com.20230601.gappssmtp.com; s=20230601; t=1762542966; x=1763147766; darn=vger.kernel.org; h=content-transfer-encoding:mime-version:references:in-reply-to :message-id:date:subject:cc:to:from:from:to:cc:subject:date :message-id:reply-to; bh=Jj6J8lcepG5DYDhxKSNWV2cRY6QtdiZGtrhbDPkQq8E=; b=JO7SK/eOEhiir2AZ1/7cl+4lmy/IZeZ/o4sOHbEJ/LPzfIjNvAOyGg//Wcq7HAl7x3 gK+10t+ayZxMLF+fX7SjmvTQx6qvQzEZnS+F1WGTKa9DGE7wEUueAM/6Hpqdn7+aGwCH odEyg8l47DQj0UizRcJDCxV4YdaGX7x4sL2Sms5p75uPXl1B3y6bU8JAI0U2gWV8bP0p NNux0s1yOTSETNwjN/psScgHQmVXftV5qhCSdk+98Mrtd5+LB5Jw3Y2LPq363sraVWV4 ulIBMjEws2+G8xrSpgEcgAqE4k39yTyuVahsfGSOthlD9rQZGq7Ed8ApJ4T8cRWrlxVa Z40A== X-Google-DKIM-Signature: v=1; a=rsa-sha256; c=relaxed/relaxed; d=1e100.net; s=20230601; t=1762542966; x=1763147766; h=content-transfer-encoding:mime-version:references:in-reply-to :message-id:date:subject:cc:to:from:x-gm-gg:x-gm-message-state:from :to:cc:subject:date:message-id:reply-to; bh=Jj6J8lcepG5DYDhxKSNWV2cRY6QtdiZGtrhbDPkQq8E=; b=COOZx7rcH4CMfg5uz+I/NUKb03AHjChRT+YTZnZMXOTNshBdZrdD71Fh5s9o6GEYwg 1S7Y1RLc7Cafc3lATcsfw2oRRXr5lyWX3hQ1TOi2zLWG0qtyZBYDuGpFW8Ob731IZl4N YQF1AP3O21VGZitqGF5OGGcGCHJZ5clNrl11MaotEi4Q4zLLShFfe+/wneN/N2AK7Zwd P/T6/88V/N6lvDkNwqhVUl1iPE8qr2EibVuuRSd32nUOL4aJ5DphugD+EUVVyb2fG7Ke hYs98nKjLkig2SO97+mFisNKKTjWPFiGLxlUt1PSLmwH4lc4l5vIXuN55WBBHdQXK4YW xflA== X-Forwarded-Encrypted: i=1; AJvYcCWT6Qcx59h3bBjGrwjgN1wQAOd6fbZk+KorKJrabtDNrXoOpOC3GG3CsNZhp19n3ugLudPVs4o+xt6MnlA=@vger.kernel.org X-Gm-Message-State: AOJu0YyUMYjKzsQzokDf+d+qmq7yOyl4Xs0VQgviUq+IND5JGwl5/ewX lhHv1Y/7NSCiqCXObSsnusABv0WyczZiPp+tIaNB5ZwOS3BhpUZQG2UiCU5WNJ5XIhE= X-Gm-Gg: ASbGncv7EMlW3Z1rbYH4V0qixZonOI7yGYw7z9W5wn55LjsiGpyaZaG9PLOhNy2ux1B HVO8cUWDLHZB9dNgURvz67TFWBB6h2JZcFlv+Bruw3s0hhSkO1mKSAFWFnfK+7fRFaWfsgg9y/d rBKOhaXa/v2xsJTw1kQQGXLp4QwnPsGM9XAkmsy1Bbt85xffbj7OsECsTpNaqDe551Rq/jue+cL fgBgeGKmC/lYS5KkNjirETdwZjJf6OCKZrwr9GtndcJSe/L5wAu9GEaZnkGtWbU5Zn4Zg22MqbJ kSk1PtfDe21qOlSgZJQXCTo/0mplxvHLhew2Lfnk+2wXbdniRYIrcyUYDe47eE+zf892lD4IKWz w4mRo+d7hOM+voBC8p9iVCBvVwzDBQlL8Uh0Px33NaLL/HBBAZmTYNJjLd96+ndUjPLSuCRuFnc HhfqMPBvF4Z2bk6CGSSxes97zloSAxLJRl5Gtw5MHT2yg= X-Google-Smtp-Source: AGHT+IG3g8x7X0Y0yy71Bz2h5XJh9oY9SaN95TpKTAIMsM9Iq0JL0TPx0mxVDPbKsKxl/ezWXxR6VQ== X-Received: by 2002:a05:6602:3418:b0:948:3f60:a625 with SMTP id ca18e2360f4ac-94895fb109cmr59742139f.3.1762542966451; Fri, 07 Nov 2025 11:16:06 -0800 (PST) Received: from zippy.localdomain (c-75-72-117-212.hsd1.mn.comcast.net. [75.72.117.212]) by smtp.gmail.com with ESMTPSA id ca18e2360f4ac-94888c34c6asm118772939f.10.2025.11.07.11.16.05 (version=TLS1_3 cipher=TLS_AES_256_GCM_SHA384 bits=256/256); Fri, 07 Nov 2025 11:16:06 -0800 (PST) From: Alex Elder To: vkoul@kernel.org, kishon@kernel.org, robh@kernel.org, krzk+dt@kernel.org, conor+dt@kernel.org Cc: ziyao@disroot.org, dlan@gentoo.org, guodong@riscstar.com, devicetree@vger.kernel.org, linux-phy@lists.infradead.org, spacemit@lists.linux.dev, linux-riscv@lists.infradead.org, linux-kernel@vger.kernel.org Subject: [PATCH v5 2/7] dt-bindings: phy: spacemit: Introduce PCIe PHY Date: Fri, 7 Nov 2025 13:15:51 -0600 Message-ID: <20251107191557.1827677-3-elder@riscstar.com> X-Mailer: git-send-email 2.48.1 In-Reply-To: <20251107191557.1827677-1-elder@riscstar.com> References: <20251107191557.1827677-1-elder@riscstar.com> Precedence: bulk X-Mailing-List: linux-kernel@vger.kernel.org List-Id: List-Subscribe: List-Unsubscribe: MIME-Version: 1.0 Content-Transfer-Encoding: quoted-printable Content-Type: text/plain; charset="utf-8" Add the Device Tree binding for two PCIe PHYs present on the SpacemiT K1 SoC. These PHYs are dependent on a separate combo PHY, which determines at probe time the calibration values used by the PCIe-only PHYs. Reviewed-by: Rob Herring (Arm) Signed-off-by: Alex Elder --- v5: - Wrap lines at 80 columns .../bindings/phy/spacemit,k1-pcie-phy.yaml | 71 +++++++++++++++++++ 1 file changed, 71 insertions(+) create mode 100644 Documentation/devicetree/bindings/phy/spacemit,k1-pcie-= phy.yaml diff --git a/Documentation/devicetree/bindings/phy/spacemit,k1-pcie-phy.yam= l b/Documentation/devicetree/bindings/phy/spacemit,k1-pcie-phy.yaml new file mode 100644 index 0000000000000..019b28349be75 --- /dev/null +++ b/Documentation/devicetree/bindings/phy/spacemit,k1-pcie-phy.yaml @@ -0,0 +1,71 @@ +# SPDX-License-Identifier: (GPL-2.0-only OR BSD-2-Clause) +%YAML 1.2 +--- +$id: http://devicetree.org/schemas/phy/spacemit,k1-pcie-phy.yaml# +$schema: http://devicetree.org/meta-schemas/core.yaml# + +title: SpacemiT K1 PCIe PHY + +maintainers: + - Alex Elder + +description: > + Two PHYs on the SpacemiT K1 SoC used for only for PCIe. These + PHYs must be configured using calibration values that are + determined by a third "combo PHY". The combo PHY determines + these calibration values during probe so they can be used for + the two PCIe-only PHYs. + + The PHY uses an external oscillator as a reference clock. During + normal operation, the PCIe host driver is responsible for ensuring + all other clocks needed by a PHY are enabled, and all resets + affecting the PHY are deasserted. + +properties: + compatible: + const: spacemit,k1-pcie-phy + + reg: + items: + - description: PHY control registers + + clocks: + items: + - description: External oscillator used by the PHY PLL + + clock-names: + const: refclk + + resets: + items: + - description: PHY reset; remains deasserted after initialization + + reset-names: + const: phy + + "#phy-cells": + const: 0 + +required: + - compatible + - reg + - clocks + - clock-names + - resets + - reset-names + - "#phy-cells" + +additionalProperties: false + +examples: + - | + #include + phy@c0c10000 { + compatible =3D "spacemit,k1-pcie-phy"; + reg =3D <0xc0c10000 0x1000>; + clocks =3D <&vctcxo_24m>; + clock-names =3D "refclk"; + resets =3D <&syscon_apmu RESET_PCIE1_GLOBAL>; + reset-names =3D "phy"; + #phy-cells =3D <0>; + }; --=20 2.48.1