From nobody Fri Jul 24 22:17:47 2026 Received: from smtp.kernel.org (aws-us-west-2-korg-mail-1.web.codeaurora.org [10.30.226.201]) (using TLSv1.2 with cipher ECDHE-RSA-AES256-GCM-SHA384 (256/256 bits)) (No client certificate requested) by smtp.subspace.kernel.org (Postfix) with ESMTPS id 6CAEE29B781; Fri, 24 Jul 2026 04:48:26 +0000 (UTC) Authentication-Results: smtp.subspace.kernel.org; arc=none smtp.client-ip=10.30.226.201 ARC-Seal: i=1; a=rsa-sha256; d=subspace.kernel.org; s=arc-20240116; t=1784868506; cv=none; b=mGEsKjIUe3Gx+nEs3heFBgS45afS8eF5M4amDI3f44xlnqeKzVKEiFHQGGWYSJ/0dqWT/nKrisE6WgVB36J5WNZ6XKaNTPQ7LNJtohyUWQBMPYGY2BJBPXxT5Ldd0uliQ5u77yUdXl2CyZfc0fGS3QC0VrfHbBl6jl06HzMfrUg= ARC-Message-Signature: i=1; a=rsa-sha256; d=subspace.kernel.org; s=arc-20240116; t=1784868506; c=relaxed/simple; bh=5+JhSO3lod5uW5SYQQlpIautAyctc/gyO6HhnlhirHU=; h=From:Date:Subject:MIME-Version:Content-Type:Message-Id:References: In-Reply-To:To:Cc; b=I9Jx3zrCQP3pdvqIaowMCVS9GoFNQ/lxNMGCBwRZeFRJUgYl10XpQjzbU4f0aXMaeyHlrlgXM+fCO0waVNXjQXVTuBmRaiqwSZQOlWFQbcQZUbkLnsytUdi5u2nuNmlfYToLl2SuyOxtl5gMf5kk8VxNdwwiFkxAp/lgRA3b+/Q= ARC-Authentication-Results: i=1; smtp.subspace.kernel.org; dkim=pass (2048-bit key) header.d=kernel.org header.i=@kernel.org header.b=WZaX+Jzg; arc=none smtp.client-ip=10.30.226.201 Authentication-Results: smtp.subspace.kernel.org; dkim=pass (2048-bit key) header.d=kernel.org header.i=@kernel.org header.b="WZaX+Jzg" Received: by smtp.kernel.org (Postfix) with ESMTPS id F3E24C2BCF6; Fri, 24 Jul 2026 04:48:25 +0000 (UTC) DKIM-Signature: v=1; a=rsa-sha256; c=relaxed/simple; d=kernel.org; s=k20201202; t=1784868506; bh=5+JhSO3lod5uW5SYQQlpIautAyctc/gyO6HhnlhirHU=; h=From:Date:Subject:References:In-Reply-To:To:Cc:Reply-To:From; b=WZaX+JzgkDGPxRIi96cRVEh3HtpsHwJv5X6yelS57v06vvfxNW+dXb6c0oXnp7yJE F46Z8IScgYaxiXinkvZ3RcGeGDUxjzOeben7rMn6LCdlpQOerCAJa4qFGg5APKWoXP wI0HdFx4tCbHsuuRihuk+aVZfxSryz4vXn1FDg9ODZ67aZp6ntV6VplkIILagB7hr5 PqPDku7d0MOttt1NPtbxAylfErHQpz0QMBqq1DCHJG//ilpELUjFuIQ+58K4s9Slqe 0Dp3pL2iT94Y9aKN0fmsLIaPhCtULbjASpCSLYwCOpM8JTH2h7updv/AJFyNObnuv5 bbLcvn3zvqmGQ== Received: from aws-us-west-2-korg-lkml-1.web.codeaurora.org (localhost.localdomain [127.0.0.1]) by smtp.lore.kernel.org (Postfix) with ESMTP id D3A1AC531C9; Fri, 24 Jul 2026 04:48:25 +0000 (UTC) From: Andy Chung via B4 Relay Date: Fri, 24 Jul 2026 12:47:37 +0800 Subject: [PATCH v5 1/4] dt-bindings: Add vendor prefix for Kandou Precedence: bulk X-Mailing-List: linux-kernel@vger.kernel.org List-Id: List-Subscribe: List-Unsubscribe: MIME-Version: 1.0 Content-Type: text/plain; charset="utf-8" Content-Transfer-Encoding: quoted-printable Message-Id: <20260724-kb9002-upstream-v5-1-9523c3ffe83a@amd.com> References: <20260724-kb9002-upstream-v5-0-9523c3ffe83a@amd.com> In-Reply-To: <20260724-kb9002-upstream-v5-0-9523c3ffe83a@amd.com> To: Rob Herring , Krzysztof Kozlowski , Conor Dooley , Andy Chung , Guenter Roeck , Jonathan Corbet , Shuah Khan Cc: devicetree@vger.kernel.org, linux-kernel@vger.kernel.org, linux-hwmon@vger.kernel.org, linux-doc@vger.kernel.org, Andy Chung X-Mailer: b4 0.15.1 X-Developer-Signature: v=1; a=ed25519-sha256; t=1784868474; l=775; i=Andy.Chung@amd.com; s=20260327; h=from:subject:message-id; bh=q6TvzAvTe0szhLuDvDe9XDITXcBW5NjI89sOlniXt5M=; b=11G7/VUAkr34ZtgHlsoDDFb3idgC7ua5yzhFpeKzY2Huq5neZ63cBehfoZgKXIuzATU8AIsPz zbaXpf/WX/lCr+qunAyyLkb6LEhuc3N7McvpNQYUTsY8vFXT0nq4qtQ X-Developer-Key: i=Andy.Chung@amd.com; a=ed25519; pk=X2gaHRnhU2q5hvMjkC6xmIcC03vKNvHY9CQRdsj9ecM= X-Endpoint-Received: by B4 Relay for Andy.Chung@amd.com/20260327 with auth_id=696 X-Original-From: Andy Chung Reply-To: Andy.Chung@amd.com From: Andy Chung Kandou AI is the vendor of the KB9002 PCIe retimer. Signed-off-by: Andy Chung --- Documentation/devicetree/bindings/vendor-prefixes.yaml | 2 ++ 1 file changed, 2 insertions(+) diff --git a/Documentation/devicetree/bindings/vendor-prefixes.yaml b/Docum= entation/devicetree/bindings/vendor-prefixes.yaml index 396044f368e7..224b60686703 100644 --- a/Documentation/devicetree/bindings/vendor-prefixes.yaml +++ b/Documentation/devicetree/bindings/vendor-prefixes.yaml @@ -879,6 +879,8 @@ patternProperties: description: JuTouch Technology Co., Ltd. "^kam,.*": description: Kamstrup A/S + "^kandou,.*": + description: Kandou AI "^karo,.*": description: Ka-Ro electronics GmbH "^keithkoep,.*": --=20 2.34.1 From nobody Fri Jul 24 22:17:47 2026 Received: from smtp.kernel.org (aws-us-west-2-korg-mail-1.web.codeaurora.org [10.30.226.201]) (using TLSv1.2 with cipher ECDHE-RSA-AES256-GCM-SHA384 (256/256 bits)) (No client certificate requested) by smtp.subspace.kernel.org (Postfix) with ESMTPS id 6CA7629B228; Fri, 24 Jul 2026 04:48:26 +0000 (UTC) Authentication-Results: smtp.subspace.kernel.org; arc=none smtp.client-ip=10.30.226.201 ARC-Seal: i=1; a=rsa-sha256; d=subspace.kernel.org; s=arc-20240116; t=1784868506; cv=none; b=ckzPsOrQFdM0P4mzm+DsrEaJ6tqssfl/as/2oujHGhF+yVp0BriiCpRE9lDSLxQXHGJwO+53B2snGitjwlpcYZtnP8+YtY1S6XfWQjeSofT0EW6IWTKTwVa6a9FFu0xiyKsVNHo6AX/BnmGO1PBUcsPPIVFY2OFVQ+Cotr6sXmw= ARC-Message-Signature: i=1; a=rsa-sha256; d=subspace.kernel.org; s=arc-20240116; t=1784868506; c=relaxed/simple; bh=QtvNGTmJu3wnH3/EKrsVJTh7dhIcj6i73e0+4O4P2eA=; h=From:Date:Subject:MIME-Version:Content-Type:Message-Id:References: In-Reply-To:To:Cc; b=rcOhNLrmP6CIqZx0MlCqeSt8VBrvuNu51b1jaKaFHpqZb6oAYOClqRPsAkj3vsHkKAuyDslsnkMp0ebAl47CQJV5CT4Y0GzHuuPmwahgIBpX3HvxLxsDMztneTeBVBFpMKV7XBKSKNmo+IAS+JrcyzWnHtJ1kifzmQBu/E4Sca8= ARC-Authentication-Results: i=1; smtp.subspace.kernel.org; dkim=pass (2048-bit key) header.d=kernel.org header.i=@kernel.org header.b=S5UBuLof; arc=none smtp.client-ip=10.30.226.201 Authentication-Results: smtp.subspace.kernel.org; dkim=pass (2048-bit key) header.d=kernel.org header.i=@kernel.org header.b="S5UBuLof" Received: by smtp.kernel.org (Postfix) with ESMTPS id 0AD6EC2BCF7; Fri, 24 Jul 2026 04:48:26 +0000 (UTC) DKIM-Signature: v=1; a=rsa-sha256; c=relaxed/simple; d=kernel.org; s=k20201202; t=1784868506; bh=QtvNGTmJu3wnH3/EKrsVJTh7dhIcj6i73e0+4O4P2eA=; h=From:Date:Subject:References:In-Reply-To:To:Cc:Reply-To:From; b=S5UBuLoflPQYa0Dm21p7zVQYcdLkb6+Uvj6KhUI50KRPKqEJ6WbPkUK0178E7ADV8 cLlOay7m1jZapEz+ZTIhPrieIK0ThayGs08QlXAb/6OqbNENSMtVQEX0EM3lfvHJWQ tZECLb5lyUJVNcToIl10Eeyqv55MeWbrzEif6ZwWpB7Fgq4slq0tfEjHraP24t+m61 ZPxVxK8qFagVcnLipcWfaglaeCEmtN+9eBgXChPqvwXy5OPze6dgR6X8oVNKtTpCPj J5+SAoWWaVtmQ27gbLByWi2XabqbX0xHIZCSjjKCOBlGjYb3V/y3FSv7Rc2CRG7D+u dVt1UQCLiBH/g== Received: from aws-us-west-2-korg-lkml-1.web.codeaurora.org (localhost.localdomain [127.0.0.1]) by smtp.lore.kernel.org (Postfix) with ESMTP id E0F02C53200; Fri, 24 Jul 2026 04:48:25 +0000 (UTC) From: Andy Chung via B4 Relay Date: Fri, 24 Jul 2026 12:47:38 +0800 Subject: [PATCH v5 2/4] dt-bindings: trivial-devices: Add Kandou KB9002 Precedence: bulk X-Mailing-List: linux-kernel@vger.kernel.org List-Id: List-Subscribe: List-Unsubscribe: MIME-Version: 1.0 Content-Type: text/plain; charset="utf-8" Content-Transfer-Encoding: quoted-printable Message-Id: <20260724-kb9002-upstream-v5-2-9523c3ffe83a@amd.com> References: <20260724-kb9002-upstream-v5-0-9523c3ffe83a@amd.com> In-Reply-To: <20260724-kb9002-upstream-v5-0-9523c3ffe83a@amd.com> To: Rob Herring , Krzysztof Kozlowski , Conor Dooley , Andy Chung , Guenter Roeck , Jonathan Corbet , Shuah Khan Cc: devicetree@vger.kernel.org, linux-kernel@vger.kernel.org, linux-hwmon@vger.kernel.org, linux-doc@vger.kernel.org, Andy Chung X-Mailer: b4 0.15.1 X-Developer-Signature: v=1; a=ed25519-sha256; t=1784868474; l=1062; i=Andy.Chung@amd.com; s=20260327; h=from:subject:message-id; bh=TfOP3I9AnbSWPiG1JcCS6En65Z1EONrNQPwWXvx4lew=; b=fJmuMEykS6vLWiDtBpkZW2fAtJpHVJIT71Mr3ZgGp1vp8HjL28vKRzgprw0GueLumyxRa1FAr E93lYkDygZNDoglXLVobKapTQ8/ENOWHNIXb+F3XxVEKDz9M78y2ob4 X-Developer-Key: i=Andy.Chung@amd.com; a=ed25519; pk=X2gaHRnhU2q5hvMjkC6xmIcC03vKNvHY9CQRdsj9ecM= X-Endpoint-Received: by B4 Relay for Andy.Chung@amd.com/20260327 with auth_id=696 X-Original-From: Andy Chung Reply-To: Andy.Chung@amd.com From: Andy Chung The Kandou KB9002 is an 8-lane PCIe 5.0 retimer exposing an SMBus target that reports an aggregated die temperature. It needs no device-specific device tree properties beyond its address, so add it to trivial-devices. Signed-off-by: Andy Chung --- Documentation/devicetree/bindings/trivial-devices.yaml | 2 ++ 1 file changed, 2 insertions(+) diff --git a/Documentation/devicetree/bindings/trivial-devices.yaml b/Docum= entation/devicetree/bindings/trivial-devices.yaml index 435c4baab436..d93d4caa8ab1 100644 --- a/Documentation/devicetree/bindings/trivial-devices.yaml +++ b/Documentation/devicetree/bindings/trivial-devices.yaml @@ -196,6 +196,8 @@ properties: - isil,isl76682 # JEDEC JESD300 (SPD5118) Hub and Serial Presence Detect - jedec,spd5118 + # Kandou KB9002 PCIe 5.0 retimer + - kandou,kb9002 # Linear Technology LTC2488 - lineartechnology,ltc2488 # Regulated 12V, 860W, Digital DC/DC Power Module --=20 2.34.1 From nobody Fri Jul 24 22:17:47 2026 Received: from smtp.kernel.org (aws-us-west-2-korg-mail-1.web.codeaurora.org [10.30.226.201]) (using TLSv1.2 with cipher ECDHE-RSA-AES256-GCM-SHA384 (256/256 bits)) (No client certificate requested) by smtp.subspace.kernel.org (Postfix) with ESMTPS id 6DBB429D26E; Fri, 24 Jul 2026 04:48:26 +0000 (UTC) Authentication-Results: smtp.subspace.kernel.org; arc=none smtp.client-ip=10.30.226.201 ARC-Seal: i=1; a=rsa-sha256; d=subspace.kernel.org; s=arc-20240116; t=1784868506; cv=none; b=jEqgVc8bEvI0nW+GJUVWZfyJ1j0JhpxFci4J7ynDIOl3pGMgYUHZBsTPsryQxNS2gH6q4HRKNOvFPgQCcvYSlRqE54m+is5xkJe1OpGwGLM+3RTTRsMtFtUo6LjnXpiYQq8w/vx1iOibMKKt3HEEJkHVe46VSfSaOPfRFkdkzmk= ARC-Message-Signature: i=1; a=rsa-sha256; d=subspace.kernel.org; s=arc-20240116; t=1784868506; c=relaxed/simple; bh=i8vTpLjHNF+2LU+oGF+F1EdMI7Umg7SslhxG4TWsji4=; h=From:Date:Subject:MIME-Version:Content-Type:Message-Id:References: In-Reply-To:To:Cc; b=cUTizJGYyTOMx0Xmmfweuh3Je2IkJqozg3bOgIMWQcgh8nxdeFAYhckFaP1i5ryMlJnSCQBqO1piHwmaIGa5n196+wnaaimpF0BDJFk+QWX4naNVsBNYlmL9G+pP6asndTOiWOB85VCR0E5GmTEi66HbQFnwuPBsnW+0F7n4l/k= ARC-Authentication-Results: i=1; smtp.subspace.kernel.org; dkim=pass (2048-bit key) header.d=kernel.org header.i=@kernel.org header.b=NqZx5Ejw; arc=none smtp.client-ip=10.30.226.201 Authentication-Results: smtp.subspace.kernel.org; dkim=pass (2048-bit key) header.d=kernel.org header.i=@kernel.org header.b="NqZx5Ejw" Received: by smtp.kernel.org (Postfix) with ESMTPS id 19A95C2BCFB; Fri, 24 Jul 2026 04:48:26 +0000 (UTC) DKIM-Signature: v=1; a=rsa-sha256; c=relaxed/simple; d=kernel.org; s=k20201202; t=1784868506; bh=i8vTpLjHNF+2LU+oGF+F1EdMI7Umg7SslhxG4TWsji4=; h=From:Date:Subject:References:In-Reply-To:To:Cc:Reply-To:From; b=NqZx5EjwZJ+3PD6IkRsr8f72MoS4LPFh/uftsBWxyNqvCZHNU1OkSQgmjeWLCx/B5 86CMCGZEZG29TUSkWMbuDI06U/402dw56K2DLl/XmjXsMFEok7eetfkncjJqdu2f1g kVTOveRSEfLNICrmnfab+/1A6AWhEj0z/C7jc0KPM0B450+sxsjrjlvmP7/SyEJd4c fb0/hBF4Frg8rKVGQKkupXZ8ZH8AYvw6XxidTyKCYNcJu7D3JhLgLSBdtXKjRe8gLJ liw3wJA2HAZMnQF1RO4ZoJZewH/+8rXstGIgpDeVt6GaF82ZDyKoFu0lNwr7rSmQgd U1TgP4PImKToA== Received: from aws-us-west-2-korg-lkml-1.web.codeaurora.org (localhost.localdomain [127.0.0.1]) by smtp.lore.kernel.org (Postfix) with ESMTP id EF00DC531F9; Fri, 24 Jul 2026 04:48:25 +0000 (UTC) From: Andy Chung via B4 Relay Date: Fri, 24 Jul 2026 12:47:39 +0800 Subject: [PATCH v5 3/4] hwmon: (kb9002) Add driver for Kandou KB9002 retimer Precedence: bulk X-Mailing-List: linux-kernel@vger.kernel.org List-Id: List-Subscribe: List-Unsubscribe: MIME-Version: 1.0 Content-Type: text/plain; charset="utf-8" Content-Transfer-Encoding: quoted-printable Message-Id: <20260724-kb9002-upstream-v5-3-9523c3ffe83a@amd.com> References: <20260724-kb9002-upstream-v5-0-9523c3ffe83a@amd.com> In-Reply-To: <20260724-kb9002-upstream-v5-0-9523c3ffe83a@amd.com> To: Rob Herring , Krzysztof Kozlowski , Conor Dooley , Andy Chung , Guenter Roeck , Jonathan Corbet , Shuah Khan Cc: devicetree@vger.kernel.org, linux-kernel@vger.kernel.org, linux-hwmon@vger.kernel.org, linux-doc@vger.kernel.org, Andy Chung X-Mailer: b4 0.15.1 X-Developer-Signature: v=1; a=ed25519-sha256; t=1784868474; l=15454; i=Andy.Chung@amd.com; s=20260327; h=from:subject:message-id; bh=iHYuCyM/E6Zof3iPTG0+zSSFxOQaT/Izr5DgjImM7CU=; b=ZJcBRHqCTHgIz6566ekAXIx8M0e6wqqGpxo8xnD1xgtcy0n+kDgW1w28Y+pWOHrt4fuY6exBO PRxr4GXZj29DT/3qhlbAYwgcOxQY+YpbGatMwXULiX3ghooqAkwexH4 X-Developer-Key: i=Andy.Chung@amd.com; a=ed25519; pk=X2gaHRnhU2q5hvMjkC6xmIcC03vKNvHY9CQRdsj9ecM= X-Endpoint-Received: by B4 Relay for Andy.Chung@amd.com/20260327 with auth_id=696 X-Original-From: Andy Chung Reply-To: Andy.Chung@amd.com From: Andy Chung The Kandou KB9002 is an 8-lane PCIe 5.0 retimer that exposes an SMBus target with mandatory PEC. Add a hwmon driver reporting the firmware aggregated maximum die temperature as temp1_input, with the firmware version and boot status under debugfs. Signed-off-by: Andy Chung Reviewed-by: Guenter Roeck --- MAINTAINERS | 7 + drivers/hwmon/Kconfig | 11 ++ drivers/hwmon/Makefile | 1 + drivers/hwmon/kb9002.c | 460 +++++++++++++++++++++++++++++++++++++++++++++= ++++ 4 files changed, 479 insertions(+) diff --git a/MAINTAINERS b/MAINTAINERS index 9b4b1575bdbd..d646aea24663 100644 --- a/MAINTAINERS +++ b/MAINTAINERS @@ -13931,6 +13931,13 @@ S: Maintained F: Documentation/hwmon/k8temp.rst F: drivers/hwmon/k8temp.c =20 +KANDOU KB9002 PCIE RETIMER HWMON DRIVER +M: Andy Chung +L: linux-hwmon@vger.kernel.org +S: Maintained +F: Documentation/hwmon/kb9002.rst +F: drivers/hwmon/kb9002.c + KASAN M: Andrey Ryabinin R: Alexander Potapenko diff --git a/drivers/hwmon/Kconfig b/drivers/hwmon/Kconfig index 08c29685126a..300329773e87 100644 --- a/drivers/hwmon/Kconfig +++ b/drivers/hwmon/Kconfig @@ -335,6 +335,17 @@ config SENSORS_K10TEMP This driver can also be built as a module. If so, the module will be called k10temp. =20 +config SENSORS_KB9002 + tristate "Kandou KB9002 PCIe retimer" + depends on I2C + help + If you say yes here you get support for the integrated + temperature sensor and firmware version readout on Kandou + KB9002 PCIe 5.0 retimers, accessed over SMBus. + + This driver can also be built as a module. If so, the module + will be called kb9002. + config SENSORS_KBATT tristate "KEBA battery controller support" depends on KEBA_CP500 diff --git a/drivers/hwmon/Makefile b/drivers/hwmon/Makefile index 63809eeec2f4..0cad7e21634c 100644 --- a/drivers/hwmon/Makefile +++ b/drivers/hwmon/Makefile @@ -113,6 +113,7 @@ obj-$(CONFIG_SENSORS_IT87) +=3D it87.o obj-$(CONFIG_SENSORS_JC42) +=3D jc42.o obj-$(CONFIG_SENSORS_K8TEMP) +=3D k8temp.o obj-$(CONFIG_SENSORS_K10TEMP) +=3D k10temp.o +obj-$(CONFIG_SENSORS_KB9002) +=3D kb9002.o obj-$(CONFIG_SENSORS_KBATT) +=3D kbatt.o obj-$(CONFIG_SENSORS_KFAN) +=3D kfan.o obj-$(CONFIG_SENSORS_LAN966X) +=3D lan966x-hwmon.o diff --git a/drivers/hwmon/kb9002.c b/drivers/hwmon/kb9002.c new file mode 100644 index 000000000000..9f4521630f3a --- /dev/null +++ b/drivers/hwmon/kb9002.c @@ -0,0 +1,460 @@ +// SPDX-License-Identifier: GPL-2.0-or-later +/* + * Kandou KB9002 PCIe 5.0 retimer hwmon driver. + * + * The retimer exposes a system management bus (SMBus 3.0 with PEC) + * target for firmware-managed status registers. This driver assumes + * the chip is strapped to SMBus mode and exports the aggregated + * maximum die temperature as hwmon temp1_input (millidegrees Celsius) + * plus the firmware version and boot status under debugfs. + * + * The raw-I2C path (kb9002_i2c_read/write, used only at probe to switch + * the host interface) carries the 32-bit register address and data + * big-endian. The SMBus path (kb9002_fw_read/kb9002_smbus_hw_read) + * carries the register address and returned data little-endian. + * + * Datasheet: Kandou KB9002 PCIe retimer (KA-015171-PD). + */ + +#include +#include +#include +#include +#include +#include +#include +#include +#include +#include +#include +#include +#include +#include + +#define KB9002_DEV_NAME "kb9002" + +/* + * SMBus read command codes. Each read is a two-phase PEC-protected + * transaction: prime writes the target address, data reads it back with + * the register contents. FW reads use a 16-bit address, HW reads 32-bit. + */ +#define KB9002_CC_FW_READ_PRIME 0x82 +#define KB9002_CC_FW_READ_DATA 0x81 +#define KB9002_CC_HW_READ_PRIME 0x8a +#define KB9002_CC_HW_READ_DATA 0x89 + +/* Firmware register offsets (16-bit). */ +#define KB9002_FW_REG_VID 0x0004 +#define KB9002_FW_REG_FW_VERSION 0x0500 +#define KB9002_FW_REG_TEMP_MAXIMUM 0x0550 + +#define KB9002_VID_MASK GENMASK(31, 16) +#define KB9002_VID_KANDOU 0x1e6f + +/* Firmware boot status: 0xe8 in the top byte means init completed OK. */ +#define KB9002_HW_REG_FW_BOOT_STATUS 0xe0090008 +#define KB9002_FW_BOOT_STATUS_OK_MSB 0xe8 + +/* + * Hardware registers reached over raw I2C (32-bit addressing). The + * host-interface bit selects SMBus (set) vs raw-I2C target; parts + * strapped to raw I2C need it set before SMBus access works. + */ +#define KB9002_HW_REG_REVID 0x00480004 +#define KB9002_HW_REG_HOST_IF 0x00480008 +#define KB9002_HOST_IF_SMBUS BIT(1) + +#define KB9002_REVID_MASK GENMASK(7, 0) +#define KB9002_REVID_B0 0x10 +#define KB9002_REVID_B1 0x11 + +/* Retries to drain a stray leading 0xff from the raw-I2C FIFO. */ +#define KB9002_REVID_READ_RETRIES 16 + +/* Temperature: 32-bit Q16.16 absolute Kelvin. */ +#define KB9002_TEMP_FRAC_BITS 16 +#define KB9002_ABS_ZERO_MILLI_C (-273150) + +/* Firmware takes up to ~2s to respond after a host-interface change. */ +#define KB9002_FW_READY_POLL_US (25 * USEC_PER_MSEC) +#define KB9002_FW_READY_TIMEOUT_US (2 * USEC_PER_SEC) + +struct kb9002_data { + struct i2c_client *client; + struct device *hwmon_dev; +}; + +/* Raw-I2C read: write the 32-bit BE address, then read 4 BE data bytes. */ +static int kb9002_i2c_read(struct i2c_client *client, u32 reg, u32 *val) +{ + u8 addr[4]; + u8 rbuf[4]; + struct i2c_msg msgs[2] =3D { + { + .addr =3D client->addr, + .flags =3D 0, + .len =3D sizeof(addr), + .buf =3D addr, + }, + { + .addr =3D client->addr, + .flags =3D I2C_M_RD, + .len =3D sizeof(rbuf), + .buf =3D rbuf, + }, + }; + int ret; + + put_unaligned_be32(reg, addr); + + ret =3D i2c_transfer(client->adapter, msgs, ARRAY_SIZE(msgs)); + if (ret < 0) + return ret; + if (ret !=3D ARRAY_SIZE(msgs)) + return -EIO; + + *val =3D get_unaligned_be32(rbuf); + return 0; +} + +/* Raw-I2C write: 4 BE address bytes followed by 4 BE data bytes. */ +static int kb9002_i2c_write(struct i2c_client *client, u32 reg, u32 val) +{ + u8 buf[8]; + struct i2c_msg msg =3D { + .addr =3D client->addr, + .flags =3D 0, + .len =3D sizeof(buf), + .buf =3D buf, + }; + int ret; + + put_unaligned_be32(reg, &buf[0]); + put_unaligned_be32(val, &buf[4]); + + ret =3D i2c_transfer(client->adapter, &msg, 1); + if (ret < 0) + return ret; + if (ret !=3D 1) + return -EIO; + + return 0; +} + +/* + * Read the silicon revision ID. A fresh FIFO may start with a stray + * 0xff that shifts the result, so drain one byte between retries until + * the top byte is no longer 0xff. + */ +static int kb9002_read_revid(struct i2c_client *client, u32 *revid) +{ + u8 dummy; + int ret; + int i; + + for (i =3D 0; i < KB9002_REVID_READ_RETRIES; i++) { + ret =3D kb9002_i2c_read(client, KB9002_HW_REG_REVID, revid); + if (ret) + return ret; + if ((*revid >> 24) !=3D 0xff) + return 0; + /* Drain one byte from the chip to re-align the I2C FIFO. */ + i2c_master_recv(client, &dummy, 1); + } + + return -EIO; +} + +/* + * Read a 32-bit firmware register over SMBus: block-write the 16-bit LE + * address, then block-read the echoed address plus 4 LE data bytes. + */ +static int kb9002_fw_read(struct kb9002_data *data, u16 reg, u32 *val) +{ + struct i2c_client *client =3D data->client; + u8 addr[2]; + u8 rbuf[I2C_SMBUS_BLOCK_MAX]; + int ret; + + put_unaligned_le16(reg, addr); + + ret =3D i2c_smbus_write_block_data(client, KB9002_CC_FW_READ_PRIME, + sizeof(addr), addr); + if (ret < 0) + return ret; + + ret =3D i2c_smbus_read_block_data(client, KB9002_CC_FW_READ_DATA, rbuf); + if (ret < 0) + return ret; + if (ret < (int)(sizeof(addr) + sizeof(*val))) + return -EIO; + + *val =3D get_unaligned_le32(&rbuf[sizeof(addr)]); + return 0; +} + +/* Like kb9002_fw_read but for a hardware register (32-bit LE address). */ +static int kb9002_smbus_hw_read(struct kb9002_data *data, u32 reg, u32 *va= l) +{ + struct i2c_client *client =3D data->client; + u8 addr[4]; + u8 rbuf[I2C_SMBUS_BLOCK_MAX]; + int ret; + + put_unaligned_le32(reg, addr); + + ret =3D i2c_smbus_write_block_data(client, KB9002_CC_HW_READ_PRIME, + sizeof(addr), addr); + if (ret < 0) + return ret; + + ret =3D i2c_smbus_read_block_data(client, KB9002_CC_HW_READ_DATA, rbuf); + if (ret < 0) + return ret; + if (ret < (int)(sizeof(addr) + sizeof(*val))) + return -EIO; + + *val =3D get_unaligned_le32(&rbuf[sizeof(addr)]); + return 0; +} + +/* + * Switch the host interface from raw-I2C to SMBus and wait for firmware + * to come back up. Called only when SMBus access failed in probe, i.e. + * the chip is strapped to raw-I2C mode. Confirms the revision, sets the + * SMBus-mode bit, then polls until firmware responds again. + */ +static int kb9002_enable_smbus_target(struct kb9002_data *data) +{ + struct i2c_client *client =3D data->client; + u32 revid; + u32 val; + int op_ret; + int ret; + + if (!i2c_check_functionality(client->adapter, I2C_FUNC_I2C)) + return dev_err_probe(&client->dev, -ENODEV, + "raw I2C required to switch to SMBus mode\n"); + + ret =3D kb9002_read_revid(client, &revid); + if (ret) + return dev_err_probe(&client->dev, ret, + "revision ID read failed\n"); + + switch (FIELD_GET(KB9002_REVID_MASK, revid)) { + case KB9002_REVID_B0: + case KB9002_REVID_B1: + break; + default: + return dev_err_probe(&client->dev, -ENODEV, + "unsupported revision ID 0x%08x\n", revid); + } + + ret =3D kb9002_i2c_read(client, KB9002_HW_REG_HOST_IF, &val); + if (ret) + return dev_err_probe(&client->dev, ret, + "host interface read failed\n"); + + val |=3D KB9002_HOST_IF_SMBUS; + + ret =3D kb9002_i2c_write(client, KB9002_HW_REG_HOST_IF, val); + if (ret) + return dev_err_probe(&client->dev, ret, + "host interface write failed\n"); + + /* Wait until firmware re-initialisation completes. */ + ret =3D read_poll_timeout(kb9002_fw_read, op_ret, op_ret =3D=3D 0, + KB9002_FW_READY_POLL_US, + KB9002_FW_READY_TIMEOUT_US, true, + data, KB9002_FW_REG_VID, &val); + if (ret) + return dev_err_probe(&client->dev, ret, + "firmware not responding over SMBus\n"); + + return 0; +} + +/* Convert Q16.16 absolute Kelvin to millidegrees Celsius. */ +static long kb9002_temp_to_milli_c(u32 raw) +{ + s64 milli_k =3D ((s64)raw * 1000) >> KB9002_TEMP_FRAC_BITS; + + return (long)milli_k + KB9002_ABS_ZERO_MILLI_C; +} + +static int kb9002_read_temp(struct kb9002_data *data, long *val) +{ + u32 raw; + int ret; + + ret =3D kb9002_fw_read(data, KB9002_FW_REG_TEMP_MAXIMUM, &raw); + if (ret) + return ret; + + *val =3D kb9002_temp_to_milli_c(raw); + return 0; +} + +static umode_t kb9002_is_visible(const void *drvdata, + enum hwmon_sensor_types type, + u32 attr, int channel) +{ + return 0444; +} + +static int kb9002_read(struct device *dev, enum hwmon_sensor_types type, + u32 attr, int channel, long *val) +{ + struct kb9002_data *data =3D dev_get_drvdata(dev); + + if (type =3D=3D hwmon_temp && attr =3D=3D hwmon_temp_input) + return kb9002_read_temp(data, val); + + return -EOPNOTSUPP; +} + +static const struct hwmon_ops kb9002_hwmon_ops =3D { + .is_visible =3D kb9002_is_visible, + .read =3D kb9002_read, +}; + +static const struct hwmon_channel_info * const kb9002_hwmon_info[] =3D { + HWMON_CHANNEL_INFO(temp, HWMON_T_INPUT), + NULL, +}; + +static const struct hwmon_chip_info kb9002_chip_info =3D { + .ops =3D &kb9002_hwmon_ops, + .info =3D kb9002_hwmon_info, +}; + +static int kb9002_fw_version_show(struct seq_file *s, void *unused) +{ + struct kb9002_data *data =3D s->private; + u32 ver; + int ret; + + guard(hwmon_lock)(data->hwmon_dev); + + ret =3D kb9002_fw_read(data, KB9002_FW_REG_FW_VERSION, &ver); + if (ret) + return ret; + + seq_printf(s, "%u.%02u.%02u.%u\n", + (ver >> 24) & 0xff, (ver >> 16) & 0xff, + (ver >> 8) & 0xff, (ver >> 0) & 0xff); + return 0; +} +DEFINE_SHOW_ATTRIBUTE(kb9002_fw_version); + +static int kb9002_fw_load_status_show(struct seq_file *s, void *unused) +{ + struct kb9002_data *data =3D s->private; + u32 status; + int ret; + + guard(hwmon_lock)(data->hwmon_dev); + + ret =3D kb9002_smbus_hw_read(data, KB9002_HW_REG_FW_BOOT_STATUS, &status); + if (ret) + return ret; + + seq_printf(s, "%s\n", + (status >> 24) =3D=3D KB9002_FW_BOOT_STATUS_OK_MSB ? + "normal" : "abnormal"); + return 0; +} +DEFINE_SHOW_ATTRIBUTE(kb9002_fw_load_status); + +static void kb9002_debugfs_init(struct kb9002_data *data) +{ + struct dentry *dir =3D data->client->debugfs; + + debugfs_create_file("fw_ver", 0444, dir, data, + &kb9002_fw_version_fops); + debugfs_create_file("fw_load_status", 0444, dir, data, + &kb9002_fw_load_status_fops); +} + +static int kb9002_probe(struct i2c_client *client) +{ + struct device *dev =3D &client->dev; + struct kb9002_data *data; + struct device *hwmon_dev; + u32 vid; + int ret; + + if (!i2c_check_functionality(client->adapter, + I2C_FUNC_SMBUS_BLOCK_DATA | + I2C_FUNC_SMBUS_PEC)) + return -ENODEV; + + data =3D devm_kzalloc(dev, sizeof(*data), GFP_KERNEL); + if (!data) + return -ENOMEM; + + data->client =3D client; + + /* All firmware register accesses are PEC-protected. */ + client->flags |=3D I2C_CLIENT_PEC; + + i2c_set_clientdata(client, data); + + /* + * Try SMBus first. If the chip is strapped to raw-I2C mode it + * will not respond to SMBus framing, so fall back to switching + * the host interface over raw I2C and retry. + */ + ret =3D kb9002_fw_read(data, KB9002_FW_REG_VID, &vid); + if (ret) { + dev_dbg(dev, "SMBus probe failed (%d), trying raw-I2C host-interface swi= tch\n", + ret); + ret =3D kb9002_enable_smbus_target(data); + if (ret) + return ret; + ret =3D kb9002_fw_read(data, KB9002_FW_REG_VID, &vid); + if (ret) + return dev_err_probe(dev, ret, + "VID read failed after host-interface switch\n"); + } + if (FIELD_GET(KB9002_VID_MASK, vid) !=3D KB9002_VID_KANDOU) + return dev_err_probe(dev, -ENODEV, + "unexpected VID 0x%08x\n", vid); + + hwmon_dev =3D devm_hwmon_device_register_with_info(dev, KB9002_DEV_NAME, + data, + &kb9002_chip_info, + NULL); + if (IS_ERR(hwmon_dev)) + return PTR_ERR(hwmon_dev); + + data->hwmon_dev =3D hwmon_dev; + kb9002_debugfs_init(data); + return 0; +} + +static const struct i2c_device_id kb9002_id[] =3D { + { .name =3D KB9002_DEV_NAME }, + { } +}; +MODULE_DEVICE_TABLE(i2c, kb9002_id); + +static const struct of_device_id kb9002_of_match[] =3D { + { .compatible =3D "kandou,kb9002" }, + { } +}; +MODULE_DEVICE_TABLE(of, kb9002_of_match); + +static struct i2c_driver kb9002_driver =3D { + .driver =3D { + .name =3D KB9002_DEV_NAME, + .of_match_table =3D kb9002_of_match, + }, + .probe =3D kb9002_probe, + .id_table =3D kb9002_id, +}; +module_i2c_driver(kb9002_driver); + +MODULE_AUTHOR("Andy Chung "); +MODULE_DESCRIPTION("Kandou KB9002 PCIe retimer hwmon driver"); +MODULE_LICENSE("GPL"); --=20 2.34.1 From nobody Fri Jul 24 22:17:47 2026 Received: from smtp.kernel.org (aws-us-west-2-korg-mail-1.web.codeaurora.org [10.30.226.201]) (using TLSv1.2 with cipher ECDHE-RSA-AES256-GCM-SHA384 (256/256 bits)) (No client certificate requested) by smtp.subspace.kernel.org (Postfix) with ESMTPS id 7D6032BF3F4; Fri, 24 Jul 2026 04:48:26 +0000 (UTC) Authentication-Results: smtp.subspace.kernel.org; arc=none smtp.client-ip=10.30.226.201 ARC-Seal: i=1; a=rsa-sha256; d=subspace.kernel.org; s=arc-20240116; t=1784868506; cv=none; b=VEn7QjOW7VU4PnOk3nn5/VmsDGkL9atFRgaFWrq2BaTYD+6nE5vvIVpff2mHwmzIFyjMj3qIf5+CE2KjjJRXweqY6f1A0uoa5b/JgYjD4a0V44S8LjYjGu4/HxLHJMLa95sdqBN8hPycwBs/UYOmUtxTx5uZwkQqK8ozBcOxhvc= ARC-Message-Signature: i=1; a=rsa-sha256; d=subspace.kernel.org; s=arc-20240116; t=1784868506; c=relaxed/simple; bh=3ZDrDaI/ls3A1gQWBoU7o2OIY5ppFEs6RqqR9Gf0PVg=; h=From:Date:Subject:MIME-Version:Content-Type:Message-Id:References: In-Reply-To:To:Cc; b=qSPWuKeLSUy++L2VNPr0iFDqvryFr6CFSibQzLiaJYNRzhLCd5+tD9nUhDnlo1SL/6m4EA6NRnLSnFd7vMQCt6ZEnC1lQhfDENxCbPbVZk9P6ic6JdXLF/ZNx6loG+v8nFHTObchAoISu4EIK1w4S/QnqaxqgOEVD5cnLMknZbw= ARC-Authentication-Results: i=1; smtp.subspace.kernel.org; dkim=pass (2048-bit key) header.d=kernel.org header.i=@kernel.org header.b=blOZ30X4; arc=none smtp.client-ip=10.30.226.201 Authentication-Results: smtp.subspace.kernel.org; dkim=pass (2048-bit key) header.d=kernel.org header.i=@kernel.org header.b="blOZ30X4" Received: by smtp.kernel.org (Postfix) with ESMTPS id 23703C2BCFF; Fri, 24 Jul 2026 04:48:26 +0000 (UTC) DKIM-Signature: v=1; a=rsa-sha256; c=relaxed/simple; d=kernel.org; s=k20201202; t=1784868506; bh=3ZDrDaI/ls3A1gQWBoU7o2OIY5ppFEs6RqqR9Gf0PVg=; h=From:Date:Subject:References:In-Reply-To:To:Cc:Reply-To:From; b=blOZ30X42406ERw1pVfnTc23E0hc2ahekYw8TzU0B6nbA3rGiRiX7bd3oS4aEUunu 2BwpR009Kw95t6c0JJuuZRiYWJLvUx/+QONpY4nMHGHy54dpzhyJTeU37a23b72fRI oYh91WyeBTMid+1RaYqMNbqS5jodu4q9Di8QRZOr95iuaod1pztb/ucR2ryNrH2lPH hMwtlBCxDXOLaKktBpFZFFEX7eprwvUTjO1krxLesibNWaStSBoahdcvgaNAiqHEIW InSW7mCo9iZFAQE9v6KvyGwV3EqbSnH1a/fkdH7DxO4Wy7WAFiwrbGAFK8bMbr2mgi o5Aelq8Z6UVCg== Received: from aws-us-west-2-korg-lkml-1.web.codeaurora.org (localhost.localdomain [127.0.0.1]) by smtp.lore.kernel.org (Postfix) with ESMTP id 094CBC53213; Fri, 24 Jul 2026 04:48:26 +0000 (UTC) From: Andy Chung via B4 Relay Date: Fri, 24 Jul 2026 12:47:40 +0800 Subject: [PATCH v5 4/4] hwmon: (kb9002) Add documentation Precedence: bulk X-Mailing-List: linux-kernel@vger.kernel.org List-Id: List-Subscribe: List-Unsubscribe: MIME-Version: 1.0 Content-Type: text/plain; charset="utf-8" Content-Transfer-Encoding: quoted-printable Message-Id: <20260724-kb9002-upstream-v5-4-9523c3ffe83a@amd.com> References: <20260724-kb9002-upstream-v5-0-9523c3ffe83a@amd.com> In-Reply-To: <20260724-kb9002-upstream-v5-0-9523c3ffe83a@amd.com> To: Rob Herring , Krzysztof Kozlowski , Conor Dooley , Andy Chung , Guenter Roeck , Jonathan Corbet , Shuah Khan Cc: devicetree@vger.kernel.org, linux-kernel@vger.kernel.org, linux-hwmon@vger.kernel.org, linux-doc@vger.kernel.org, Andy Chung X-Mailer: b4 0.15.1 X-Developer-Signature: v=1; a=ed25519-sha256; t=1784868474; l=3103; i=Andy.Chung@amd.com; s=20260327; h=from:subject:message-id; bh=X7KlZJRpM+tmPVIiJTkz8JxxyjoQXDvY7ETNvVGG+tk=; b=f59i7Yg3QvT0pIiqVK0XkiLHmZdxldbiLNB/D3jXDutvMeKqty/pchkBJezjulQP34DuPq9Of MkE+0INR8YsBFg124L+NCmq5dqShecYEKoWyHvDATS3GrxFBJXDiMCy X-Developer-Key: i=Andy.Chung@amd.com; a=ed25519; pk=X2gaHRnhU2q5hvMjkC6xmIcC03vKNvHY9CQRdsj9ecM= X-Endpoint-Received: by B4 Relay for Andy.Chung@amd.com/20260327 with auth_id=696 X-Original-From: Andy Chung Reply-To: Andy.Chung@amd.com From: Andy Chung Document the sysfs and debugfs interfaces of the Kandou KB9002 hwmon driver. Signed-off-by: Andy Chung Reviewed-by: Guenter Roeck --- Documentation/hwmon/index.rst | 1 + Documentation/hwmon/kb9002.rst | 64 ++++++++++++++++++++++++++++++++++++++= ++++ 2 files changed, 65 insertions(+) diff --git a/Documentation/hwmon/index.rst b/Documentation/hwmon/index.rst index 226789376217..9dc796d087dc 100644 --- a/Documentation/hwmon/index.rst +++ b/Documentation/hwmon/index.rst @@ -112,6 +112,7 @@ Hardware Monitoring Kernel Drivers jc42 k10temp k8temp + kb9002 kbatt kfan lan966x diff --git a/Documentation/hwmon/kb9002.rst b/Documentation/hwmon/kb9002.rst new file mode 100644 index 000000000000..6f8116dde918 --- /dev/null +++ b/Documentation/hwmon/kb9002.rst @@ -0,0 +1,64 @@ +.. SPDX-License-Identifier: GPL-2.0-or-later + +Kernel driver kb9002 +=3D=3D=3D=3D=3D=3D=3D=3D=3D=3D=3D=3D=3D=3D=3D=3D=3D=3D=3D=3D + +Supported chips: + + * Kandou KB9002 + + Prefix: 'kb9002' + + Addresses scanned: - + + Datasheet: KA-015171-PD (available from Kandou under NDA) + +Author: Andy Chung + +Description +----------- + +The Kandou KB9002 is an 8-lane PCIe 5.0 retimer with an integrated +microcontroller. It exposes an SMBus 3.0 target (with mandatory PEC) +on its sideband interface. The internal firmware aggregates per-lane +die temperatures and publishes the maximum value through a 16-bit +addressed register window. + +This driver reports that aggregated maximum as the only hwmon +temperature channel. The running firmware version and the firmware +boot status are exposed under debugfs. + +sysfs interface +--------------- + +=3D=3D=3D=3D=3D=3D=3D=3D=3D=3D=3D=3D=3D=3D=3D=3D=3D=3D =3D=3D=3D=3D=3D=3D= =3D=3D=3D=3D=3D=3D=3D=3D=3D=3D=3D=3D=3D=3D=3D=3D=3D=3D=3D=3D=3D=3D=3D=3D=3D= =3D=3D=3D=3D=3D=3D=3D=3D=3D=3D=3D=3D=3D=3D=3D=3D +temp1_input Aggregated maximum die temperature across all + active lanes (millidegrees Celsius). +=3D=3D=3D=3D=3D=3D=3D=3D=3D=3D=3D=3D=3D=3D=3D=3D=3D=3D =3D=3D=3D=3D=3D=3D= =3D=3D=3D=3D=3D=3D=3D=3D=3D=3D=3D=3D=3D=3D=3D=3D=3D=3D=3D=3D=3D=3D=3D=3D=3D= =3D=3D=3D=3D=3D=3D=3D=3D=3D=3D=3D=3D=3D=3D=3D=3D + +debugfs interface +----------------- + +Files live in the per-client debugfs directory created by the I2C +core: ``/sys/kernel/debug/i2c/i2c-/-/``. + +=3D=3D=3D=3D=3D=3D=3D=3D=3D=3D=3D=3D=3D=3D=3D=3D=3D=3D =3D=3D=3D=3D=3D=3D= =3D=3D=3D=3D=3D=3D=3D=3D=3D=3D=3D=3D=3D=3D=3D=3D=3D=3D=3D=3D=3D=3D=3D=3D=3D= =3D=3D=3D=3D=3D=3D=3D=3D=3D=3D=3D=3D=3D=3D=3D=3D +fw_ver Running firmware version in + "major.minor.patch.suffix" format. Read-only. +fw_load_status Firmware boot status: "normal" once firmware has + finished initialising, "abnormal" otherwise. + Read-only. +=3D=3D=3D=3D=3D=3D=3D=3D=3D=3D=3D=3D=3D=3D=3D=3D=3D=3D =3D=3D=3D=3D=3D=3D= =3D=3D=3D=3D=3D=3D=3D=3D=3D=3D=3D=3D=3D=3D=3D=3D=3D=3D=3D=3D=3D=3D=3D=3D=3D= =3D=3D=3D=3D=3D=3D=3D=3D=3D=3D=3D=3D=3D=3D=3D=3D + +Notes +----- + +The driver requires ``I2C_FUNC_SMBUS_BLOCK_DATA``, +``I2C_FUNC_SMBUS_PEC`` and ``I2C_FUNC_I2C`` from the host adapter. The +last is needed only during probe for the host-interface mode switch; +runtime accesses use SMBus block transactions exclusively. + +The retimer's SMBus address is configurable on three strap pins and +ranges from 0x20 to 0x27. The address is selected through device tree +(or i2c board info) the same way as any other I2C device; the driver +does not auto-detect. --=20 2.34.1