From patchwork Wed Feb 5 23:30:14 2025 Content-Type: text/plain; charset="utf-8" MIME-Version: 1.0 Content-Transfer-Encoding: 7bit X-Patchwork-Submitter: Stephen Boyd X-Patchwork-Id: 862616 Received: from mail-pl1-f172.google.com (mail-pl1-f172.google.com [209.85.214.172]) (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 DF09513D897 for ; Wed, 5 Feb 2025 23:30:22 +0000 (UTC) Authentication-Results: smtp.subspace.kernel.org; arc=none smtp.client-ip=209.85.214.172 ARC-Seal: i=1; a=rsa-sha256; d=subspace.kernel.org; s=arc-20240116; t=1738798224; cv=none; b=AiJ6e2MlX1ld1duVTP7SbealJC+z0yG/t8+0RQoG33iacMpJKtgZP0Lc5+8IEnmJ7VR4stOMf2l8oS62hPQDXFxriETvuovVLap5jJGLqtiVpczcxqOmtqGZ3aNwXiVD5XknKoFR6qBAozdtdwldJoil/I8MndHN6sihUyV3TkY= ARC-Message-Signature: i=1; a=rsa-sha256; d=subspace.kernel.org; s=arc-20240116; t=1738798224; c=relaxed/simple; bh=/4MVACIsm4mxXNiJSYO9O9WP/zDnD65LIiLgfNT+Jv4=; h=From:To:Cc:Subject:Date:Message-ID:In-Reply-To:References: MIME-Version; b=NZAzhwjr0TkcHGz/K0lmxfHeVa6YGwpg7sWzGYm6KOqeqk24bkrnH/3/v1WkbY6psk1u6g6TZQLuwTan/qY0dYew8x6rNW40k4i8rZgNUxJ8mZ37kM5sx/2u/zz6m6zwqu5uiJAtc8IXDBU4Isu9Lo7AeKZYs0oWiSAUeT5w3No= ARC-Authentication-Results: i=1; smtp.subspace.kernel.org; dmarc=pass (p=none dis=none) header.from=chromium.org; spf=pass smtp.mailfrom=chromium.org; dkim=pass (1024-bit key) header.d=chromium.org header.i=@chromium.org header.b=Pw7lTsgB; arc=none smtp.client-ip=209.85.214.172 Authentication-Results: smtp.subspace.kernel.org; dmarc=pass (p=none dis=none) header.from=chromium.org Authentication-Results: smtp.subspace.kernel.org; spf=pass smtp.mailfrom=chromium.org Authentication-Results: smtp.subspace.kernel.org; dkim=pass (1024-bit key) header.d=chromium.org header.i=@chromium.org header.b="Pw7lTsgB" Received: by mail-pl1-f172.google.com with SMTP id d9443c01a7336-21f0c4275a1so5120985ad.2 for ; Wed, 05 Feb 2025 15:30:22 -0800 (PST) DKIM-Signature: v=1; a=rsa-sha256; c=relaxed/relaxed; d=chromium.org; s=google; t=1738798222; x=1739403022; 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=ENYD7Jqf2Ry9h9YG/MAy2Qwl7UQB5Doq6yEYLu32Qi0=; b=Pw7lTsgBYl/515XJoKkhUNOpCBO91Y11c4OYld34HqrpbFfmxdcUQ3iLLvHLRwDac/ PFOUIACTO3oOdXOy2EIg2UxxH2XF3t0+rksRn3eXHcLqsz14FsGY5AvAMbbuyMZIpBXS MyqA0EsYXK12x/cy0bFzfNZmkKhFt8vdGPSbU= X-Google-DKIM-Signature: v=1; a=rsa-sha256; c=relaxed/relaxed; d=1e100.net; s=20230601; t=1738798222; x=1739403022; h=content-transfer-encoding:mime-version:references:in-reply-to :message-id:date:subject:cc:to:from:x-gm-message-state:from:to:cc :subject:date:message-id:reply-to; bh=ENYD7Jqf2Ry9h9YG/MAy2Qwl7UQB5Doq6yEYLu32Qi0=; b=EsxnIGmSMX77WdHxpjYLA7dSgra2trOblBqiSZjJwhoa3WskN4PUAOuQV7JNOY6lHB 0aq3583pXoHwFI2LuOi66IP0CbSXIwzfkIzPe4IV5BqDV2K0R17fosYI988enj4RvkjX 9Ex4DeqcCYHWNEy4kbuLkCPmxeMuLpKHTDpYaSWr5Q//nW6JOv6zXupbNxx8OchZVPEG Xuv2eDsTdV6rveutOEVNKSgHGP3/Wf2KYHrgJvSQVl9fuYaIQ4GeDlOpnuCT3Gfxzjme 0fpK8wLAe0sEqZeVivn61wsL/EzvkICSnww8ah/E2YVK/akPioNMfk55+kKZRvjgwSlq EsKw== X-Forwarded-Encrypted: i=1; AJvYcCXRKLjFvuhw2BA5pspPACqLpxnOlkIxue5CNXMrTKoHINbUN7aaPPOb6KxdZkzXcL3g6Fy7sBG523qDdy3p@vger.kernel.org X-Gm-Message-State: AOJu0YyxUFZpvo8YxaOI7xhKM8UvcGsWd+rWt5mibQESSOnBShOEVScd 3sNx7XAjppirii7GD6O8EJ9zSeWTt59V0BU4BqOiHVGLD+8AHfXbsZGhRSFypg== X-Gm-Gg: ASbGnctm2f6IjgTyeq36nvhyqxOS8t8+ynCp2KrRNiZn+EBqgGZ2PAwCJo7QkEjPYkc MKhjlX6r71S9nle4H2BIZI+x6WeU6OyclZvS60JPg0Ul22dKJCQ6qi9cVdJrU/zfD657xkUr7aj aHI8FtTio2ajBEfF7/XwD/uwfj7/SAqiFu+HPgRLSBYZwbPLsH+g4qX3hAEVWAgOyduZmmOX4nv bzC9EG5fdHt0OaGvr9WIA9O0Klxu69JsDRKQAYb/P4hn7MOuuFbzh6nmzerL9QEH1goPBIbEkZT b4liBYHjY2LoAqA7rFgxvFyCsKE6awBcocw3F8FmibR4g1cx/QHdsj4= X-Google-Smtp-Source: AGHT+IEZ4n+Jd53BNMcbz3qeJy5aLqWtFVqnGwoigd8TEJYu9DWYm8+Vg9ly6TVuMdEWwx88axmwQQ== X-Received: by 2002:a17:902:cf12:b0:216:48f4:4f1a with SMTP id d9443c01a7336-21f17e4ca85mr82422235ad.16.1738798222190; Wed, 05 Feb 2025 15:30:22 -0800 (PST) Received: from localhost (129.135.125.34.bc.googleusercontent.com. [34.125.135.129]) by smtp.gmail.com with UTF8SMTPSA id 41be03b00d2f7-acec0a69b3bsm12388570a12.71.2025.02.05.15.30.21 (version=TLS1_3 cipher=TLS_AES_128_GCM_SHA256 bits=128/128); Wed, 05 Feb 2025 15:30:21 -0800 (PST) From: Stephen Boyd To: Konrad Dybcio , Bjorn Andersson Cc: linux-kernel@vger.kernel.org, linux-arm-msm@vger.kernel.org, patches@lists.linux.dev, cros-qcom-dts-watchers@chromium.org, Rob Herring , Krzysztof Kozlowski , Conor Dooley , Benson Leung , devicetree@vger.kernel.org, chrome-platform@lists.linux.dev, Pin-yen Lin Subject: [PATCH v2 1/2] dt-bindings: chrome: Add binding for ChromeOS Pogo pin connector Date: Wed, 5 Feb 2025 15:30:14 -0800 Message-ID: <20250205233016.1600517-2-swboyd@chromium.org> X-Mailer: git-send-email 2.48.1.362.g079036d154-goog In-Reply-To: <20250205233016.1600517-1-swboyd@chromium.org> References: <20250205233016.1600517-1-swboyd@chromium.org> Precedence: bulk X-Mailing-List: linux-arm-msm@vger.kernel.org List-Id: List-Subscribe: List-Unsubscribe: MIME-Version: 1.0 Describe the set of pins used to connect the detachable keyboard on detachable ChromeOS devices. The set of pins is called the "pogo pins". It's basically USB 2.0 with an extra pin for base detection. We expect to find a keyboard on the other side of this connector with a specific vid/pid, so describe that as a child device at the port of the usb device connected upstream. Cc: Rob Herring Cc: Krzysztof Kozlowski Cc: Conor Dooley Cc: Benson Leung Cc: Cc: Cc: Pin-yen Lin Signed-off-by: Stephen Boyd --- .../chrome/google,pogo-pin-connector.yaml | 68 +++++++++++++++++++ 1 file changed, 68 insertions(+) create mode 100644 Documentation/devicetree/bindings/chrome/google,pogo-pin-connector.yaml diff --git a/Documentation/devicetree/bindings/chrome/google,pogo-pin-connector.yaml b/Documentation/devicetree/bindings/chrome/google,pogo-pin-connector.yaml new file mode 100644 index 000000000000..622e171b6b08 --- /dev/null +++ b/Documentation/devicetree/bindings/chrome/google,pogo-pin-connector.yaml @@ -0,0 +1,68 @@ +# SPDX-License-Identifier: (GPL-2.0-only OR BSD-2-Clause) +%YAML 1.2 +--- +$id: http://devicetree.org/schemas/chrome/google,pogo-pin-connector.yaml# +$schema: http://devicetree.org/meta-schemas/core.yaml# + +title: Google Pogo Pin Connector + +maintainers: + - Stephen Boyd + +description: + ChromeOS devices with a detachable keyboard have a set of five pins called + pogo pins that are the typical four pins for USB (D+/D-, vbus, ground) and an + extra pin for base detection. The detachable keyboard is a USB device that + connects to the pogo pins. + +properties: + compatible: + const: google,pogo-pin-connector + + '#address-cells': + const: 1 + + '#size-cells': + const: 0 + + port: + $ref: /schemas/graph.yaml#/properties/port + description: Connection to USB2 port providing USB signals + required: + - endpoint + +patternProperties: + "^keyboard@[0-9a-f]{1,2}$": + description: The detachable keyboard + type: object + $ref: /schemas/usb/usb-device.yaml + unevaluatedProperties: false + +required: + - compatible + - '#address-cells' + - '#size-cells' + - port + +additionalProperties: false + +examples: + - | + connector { + compatible = "google,pogo-pin-connector"; + #address-cells = <1>; + #size-cells = <0>; + + keyboard@2 { + compatible = "usb18d1,504c"; + reg = <2>; + }; + + port { + pogo_connector_in: endpoint { + remote-endpoint = <&usb_hub_dsp3_hs>; + }; + }; + }; + +...