From mboxrd@z Thu Jan 1 00:00:00 1970 Received: from mail-pj1-f53.google.com (mail-pj1-f53.google.com [209.85.216.53]) (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 CD8944FDA5F for ; Fri, 16 Oct 2026 16:39:16 +0000 (UTC) Authentication-Results: smtp.subspace.kernel.org; arc=none smtp.client-ip=209.85.216.53 ARC-Seal:i=1; a=rsa-sha256; d=subspace.kernel.org; s=arc-20240116; t=1792168758; cv=none; b=IUzOBwZSbOCHZQocRjUbGlmXTBueyKwtkUOKsiDsiGfuBMkIgtEfXHRzy8rukUJ3z+mLw6QXXvYH+2A8UB64fpTeBFBigpNI3mYvGeY2QozvhOzPEe0itOTLZDKUho//tzY6HwEhyCqyXvEw3oMGGY7XU6D/hI25HBVqAQgdC7I= ARC-Message-Signature:i=1; a=rsa-sha256; d=subspace.kernel.org; s=arc-20240116; t=1792168758; c=relaxed/simple; bh=UrTqk122fjuebPWIsFomjpVopXMMpyx77gW8QHNBKy8=; h=From:To:Cc:Subject:Date:Message-ID:In-Reply-To:References: MIME-Version; b=Q1R3u0eUcuY3QzfAlw+bRLo+W4Jte4FahnTdbYgqjmShXoEc+Dact7rI9lrgU7eiHdGVqnHUaJXfxpUILs2QohGvh2CR31FZJHb2iWtjxjMMprtHrstYOTzd32U1+EmnUL43dtrJJOJnCnkkHttOLypOU1PayIaBBQ04lpMGbfY= ARC-Authentication-Results:i=1; smtp.subspace.kernel.org; dmarc=pass (p=none dis=none) header.from=gmail.com; spf=pass smtp.mailfrom=gmail.com; dkim=pass (2048-bit key) header.d=gmail.com header.i=@gmail.com header.b=F3HemHWh; arc=none smtp.client-ip=209.85.216.53 Authentication-Results: smtp.subspace.kernel.org; dmarc=pass (p=none dis=none) header.from=gmail.com Authentication-Results: smtp.subspace.kernel.org; spf=pass smtp.mailfrom=gmail.com Authentication-Results: smtp.subspace.kernel.org; dkim=pass (2048-bit key) header.d=gmail.com header.i=@gmail.com header.b="F3HemHWh" Received: by mail-pj1-f53.google.com with SMTP id 98e67ed59e1d1-3ac77270fbfso140043a91.2 for ; Fri, 16 Oct 2026 09:39:16 -0700 (PDT) DKIM-Signature: v=1; a=rsa-sha256; c=relaxed/relaxed; d=gmail.com; s=20251104; t=1792168756; x=1792773556; 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:content-type; bh=/wY/9oiidFbXYRxIGG8QjryQPb39skOLzlzrFQAD6iw=; b=F3HemHWhnWekLc5+hQFG3ju1iGmDLkxlxMAtkOFntz7Zmc3F84/H7PtJMLBWRQCZsn GG4KQJePPNN+bq5SuCPuiwmNjkegeEHfH0K8cJNaHiWbwdOvkCGfwDqclr0o25ASA7Cw +c6OC3J58IwP4xnOHFL4E4izzKpdwh3Xoqoj9CcxsOxye3RYU1QA1qqi2dGfKnXqqA97 kS55GPvO8DjzBt4dFEGeilKzas+9nmxiZCByr/SfmA/4ejgoAY7G1MNa6fP/b6kIv8gc 6KrsXE2DyAlG2NoiZmzyQ3HXBzPyo1+wPqARaTCyJvf178H1SNeFXpZed84BBiws896R K/kQ== X-Google-DKIM-Signature: v=1; a=rsa-sha256; c=relaxed/relaxed; d=1e100.net; s=20260707; t=1792168756; x=1792773556; 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:content-type; bh=/wY/9oiidFbXYRxIGG8QjryQPb39skOLzlzrFQAD6iw=; b=BCVLvnu+TtL1UvcpAKUKkhHRhonhMOAhw4jzLMNY6OfCQFWAFgO/Br5v1mYDCHoqul 7px4xrbl/xVljeeRP/nDnvR8zJuhIoiEAdt5bVPgmxzNULQ1UIZOq8bs4cO2Avy/chWF FKW35l4G55UUex6a9SUflI9yCYXJCPNrSVpRpc+vwFpbhzfI0uiuTJ5nPaeTsd3uCCeT MSwmV0RxYIhnP4r2/mIpboMlEnL1292ejmw9bAk+AJprAe98QdDop3yXwtCmkepcxbUe 8R95dS3sYdv7BuocKFZbjozs4kDYGotSn6y0ioqXJTQpWKsU5uJ6yNFmVl7YhAWkdXsE lHVg== X-Forwarded-Encrypted: i=1; AKwUvBxHtZlfBkJgHpY6BEw9PQ7BbePccb0g39VeKiPmjOtBRLHWw8OkaNq4ZZeZlPlcZtUea4acM3I97Eug@vger.kernel.org X-Gm-Message-State: AFq9FYKBXdHEo0X6ZAWWtXpSDaigVqtaX5M6brM5KxIhbfl52wMRoC5C oQe9AGdQdVqxEes/hewKFuElJdUIIp6i6lTkSoRgb1Cc+iQelLEMLfpQ X-Gm-Gg: AYBFou0lPFc/Eym3WOZZtE8LxxoqqNOCkiWEkPsmYOspxR8yd4OtLopmMMivkRWbGUH Cjg8Lo/J2BG0p700tNJbp6r9eWXU3R+mGHROj7DcYhbowkaghLcKyICyvhdbPWfCh6XfC6j9QBK VQfDL5Ng126c7jahOyk8rs0tAO5boNHEx/OS8esgRYTIug1ZtrJ6T/enHdRDAjQ62JTE8SOswrN 8aTW/wU4eWgQTa/tjLHZaPWX9/rk4WMPLRhxq4CS7IgySPh1CpnP6bP0Gbqm97IeiBa/n51NfMB hzY30N85zA/U2kIE5kQdOko3axbVoQB/57FiG/eZMORxFhNPdksMrmKy2EiwRK5638wV8y1y2LJ 2EbtjrNrFwVxm6Vd6trG4V+iQdubQiikk9H3rQk14d/TmqzR7W69bQokLSvzW7YqSqqo6drs/fo lX3wuPZL74zswnjpAYNCcQt03knFG2CL97z167AxGEs9EKfv2poDeD+aMFmy5fyTD9O3M= X-Received: by 2002:a17:90b:4a03:b0:3ac:8dfe:8ec9 with SMTP id 98e67ed59e1d1-3acef50676emr284431a91.47.1792168755967; Fri, 16 Oct 2026 09:39:15 -0700 (PDT) Received: from wyb-ms7e59 ([38.55.195.146]) by smtp.gmail.com with ESMTPSA id 98e67ed59e1d1-3acc46ecd32sm4899797a91.3.2026.10.16.09.39.13 (version=TLS1_3 cipher=TLS_AES_256_GCM_SHA384 bits=256/256); Fri, 16 Oct 2026 09:39:15 -0700 (PDT) From: wyibo6109@gmail.com To: Dmitry Torokhov , linux-input@vger.kernel.org Cc: Krzysztof Kozlowski , Rob Herring , Conor Dooley , devicetree@vger.kernel.org, linux-kernel@vger.kernel.org, Yibo Wang Subject: [PATCH v6 1/2] dt-bindings: input: add OnePlus pogo-pin keyboard Date: Fri, 16 Oct 2026 11:38:58 -0500 Message-ID: <20261016163859.1070138-2-wyibo6109@gmail.com> X-Mailer: git-send-email 2.53.0 In-Reply-To: <20261016163859.1070138-1-wyibo6109@gmail.com> References: <20261016163859.1070138-1-wyibo6109@gmail.com> Precedence: bulk X-Mailing-List: devicetree@vger.kernel.org List-Id: List-Subscribe: List-Unsubscribe: MIME-Version: 1.0 Content-Transfer-Encoding: 8bit From: Yibo Wang Binding for the OnePlus Pad 3 Pro / Pad 4 and OPPO Pad 5 Pro pogo-pin smart keyboards, built around a Tinno keyboard MCU and attached to a tablet UART. Describes the supply, TX-gate and wake GPIOs, with a MAINTAINERS entry. The compatible names the tablet project the pogo port belongs to (caihong, erhai or iceland), which pins the keyboard generation and with it the protocol extensions the host may use: the 0x3A general sub-commands grew over time, from the caihong (sm8650 era) keyboards with neither wake notification nor backlight, through erhai (sm8750 era, wake notification) to iceland (sm8850 era, keyboard backlight). The keyboard is a fixed physical device, so the touchpad geometry and the product names are per-project constants and live in the driver; the common touchscreen properties (touchscreen-size-x/y, touchscreen-x-mm/y-mm) remain as an optional override if a variant ever needs one. The binding documentation was prepared with the assistance of an AI language model; the technical content was reviewed, adjusted and validated by the author. Assisted-by: Z.ai:GLM-5.3 Signed-off-by: Yibo Wang --- .../bindings/input/oneplus,pogo-keyboard.yaml | 76 +++++++++++++++++++ MAINTAINERS | 6 ++ 2 files changed, 82 insertions(+) create mode 100644 Documentation/devicetree/bindings/input/oneplus,pogo-keyboard.yaml diff --git a/Documentation/devicetree/bindings/input/oneplus,pogo-keyboard.yaml b/Documentation/devicetree/bindings/input/oneplus,pogo-keyboard.yaml new file mode 100644 index 000000000..78d398912 --- /dev/null +++ b/Documentation/devicetree/bindings/input/oneplus,pogo-keyboard.yaml @@ -0,0 +1,76 @@ +# SPDX-License-Identifier: (GPL-2.0-only OR BSD-2-Clause) +# Copyright (c) 2026 Yibo Wang +%YAML 1.2 +--- +$id: http://devicetree.org/schemas/input/oneplus,pogo-keyboard.yaml# +$schema: http://devicetree.org/meta-schemas/core.yaml# + +title: OnePlus / OPPO Pad pogo-pin smart keyboard + +maintainers: + - Yibo Wang + +description: + The OnePlus Pad 3 Pro / Pad 4 and OPPO Pad 5 Pro pogo-pin smart + keyboards, built around a Tinno keyboard MCU. The keyboard is + attached to a tablet UART and speaks a framed half-duplex protocol + over a shared single wire; host transmission is gated onto the wire + by a PMIC GPIO for the duration of a frame. It provides a keyboard + matrix, a touchpad and a keyboard backlight. + +allOf: + - $ref: /schemas/serial/serial-peripheral-props.yaml# + - $ref: /schemas/input/touchscreen/touchscreen.yaml# + +properties: + compatible: + description: | + Names the tablet project the pogo port belongs to, which pins the + keyboard generation and the protocol extensions the host may + use: caihong (sm8650 era) supports neither the wake notification + nor a backlight, erhai (sm8750 era) adds the wake notification, + iceland (sm8850 era) adds the keyboard backlight. + enum: + - oneplus,caihong-pogo-keyboard + - oneplus,erhai-pogo-keyboard + - oneplus,iceland-pogo-keyboard + + power-gpios: + description: + GPIO enabling the keyboard supply, held high while attached. + maxItems: 1 + + tx-enable-gpios: + description: GPIO gating host TX onto the shared one-wire bus. + maxItems: 1 + + wake-gpios: + description: GPIO signalling attach/detach, also used as the wake line. + maxItems: 1 + + touchscreen-size-x: true + touchscreen-size-y: true + touchscreen-x-mm: true + touchscreen-y-mm: true + +required: + - compatible + - power-gpios + - tx-enable-gpios + - wake-gpios + +unevaluatedProperties: false + +examples: + - | + #include + + serial { + keyboard { + compatible = "oneplus,iceland-pogo-keyboard"; + power-gpios = <&pmic_gpios 12 GPIO_ACTIVE_HIGH>; + tx-enable-gpios = <&pmic2_gpios 6 GPIO_ACTIVE_HIGH>; + wake-gpios = <&tlmm 151 GPIO_ACTIVE_LOW>; + }; + }; +... diff --git a/MAINTAINERS b/MAINTAINERS index 8014b9f82..9c29eb961 100644 --- a/MAINTAINERS +++ b/MAINTAINERS @@ -20156,6 +20156,12 @@ S: Maintained F: Documentation/ABI/testing/sysfs-bus-platform-onboard-usb-dev F: drivers/usb/misc/onboard_usb_dev.c +ONEPLUS POGO-PIN KEYBOARD DRIVER +M: Yibo Wang +L: linux-input@vger.kernel.org +S: Maintained +F: Documentation/devicetree/bindings/input/oneplus,pogo-keyboard.yaml + ONENAND FLASH DRIVER M: Kyungmin Park L: linux-mtd@lists.infradead.org -- 2.53.0