From patchwork Wed Feb 19 13:32:21 2025 Content-Type: text/plain; charset="utf-8" MIME-Version: 1.0 Content-Transfer-Encoding: 7bit X-Patchwork-Submitter: "Florin Leotescu (OSS)" X-Patchwork-Id: 13982208 Received: from EUR03-AM7-obe.outbound.protection.outlook.com (mail-am7eur03on2073.outbound.protection.outlook.com [40.107.105.73]) (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 36AEC1EB5D4 for ; Wed, 19 Feb 2025 13:25:14 +0000 (UTC) Authentication-Results: smtp.subspace.kernel.org; arc=fail smtp.client-ip=40.107.105.73 ARC-Seal: i=2; a=rsa-sha256; d=subspace.kernel.org; s=arc-20240116; t=1739971517; cv=fail; b=ba0oVsYnPIRNVLoScbIEgySygeN/5pyynpQcqaCSYxOc0xTSfODQIcGgyoQzENEYGOGcDypBeUWSjLLdSLIMoilrHgBaDwG1nuJ8py8WNGRT1qxqvediDKNnZGl9yMU+KjA+kBQi0OZLIMUPBeZMhrl5GwRXS0WOxWFope42QhY= ARC-Message-Signature: i=2; a=rsa-sha256; d=subspace.kernel.org; s=arc-20240116; t=1739971517; c=relaxed/simple; bh=xIgw2+eL8ODswzKm6W5fB/BXnzUktpNZoWPzfbe1qTs=; h=From:To:Cc:Subject:Date:Message-Id:In-Reply-To:References: Content-Type:MIME-Version; b=i1lfHWUGwlfTxEhVVqp3s922bjib0V+CKIsvTw5P3icvAxgcEv8Rd/gr8PtgwJTLRrHVxAWwbs0dzyVK/PEM+kQfCxBW/69R+35p2UjQSsII0jV0l5sNvM1X6hal6eYk3gb/pRFBz5rOV4WYs1r1ybDRQ5SDDp+WDZbhLz8URro= ARC-Authentication-Results: i=2; smtp.subspace.kernel.org; dmarc=pass (p=none dis=none) header.from=oss.nxp.com; spf=pass smtp.mailfrom=oss.nxp.com; dkim=pass (2048-bit key) header.d=NXP1.onmicrosoft.com header.i=@NXP1.onmicrosoft.com header.b=Q3HCftJf; arc=fail smtp.client-ip=40.107.105.73 Authentication-Results: smtp.subspace.kernel.org; dmarc=pass (p=none dis=none) header.from=oss.nxp.com Authentication-Results: smtp.subspace.kernel.org; spf=pass smtp.mailfrom=oss.nxp.com Authentication-Results: smtp.subspace.kernel.org; dkim=pass (2048-bit key) header.d=NXP1.onmicrosoft.com header.i=@NXP1.onmicrosoft.com header.b="Q3HCftJf" ARC-Seal: i=1; a=rsa-sha256; s=arcselector10001; d=microsoft.com; cv=none; b=G3fYUKxmlAmonPWIeAdMzw3sOOUvuSAOeJLR6foKyk85kApIPGRk9roFiOBdMhbpvd4T30c123nHOjyM0yAHHxuYg378pnPAddghBF/igt8WyBQ/Cem8Do5WEtDFpekSqhGbEMmOI2jdaXnkgEMdpSPN1rysmeflS1136iWZ4FulAxvDHYsXon7/4Bc+169OT9gGL+ZKjQBUgGLDS9E7PJuLQwgtuNbUiz+OTFW0wojs7TC71igC+KWdcMTdEqOZBPbdjO1lCRsGILRFyIo9FR9cOok2KJoeainR8YwBs9l4wj5Qr+SYwDxc/ghKeLG5XQN19fJcmR5pGQ+QcrPDeA== ARC-Message-Signature: i=1; a=rsa-sha256; c=relaxed/relaxed; d=microsoft.com; s=arcselector10001; h=From:Date:Subject:Message-ID:Content-Type:MIME-Version:X-MS-Exchange-AntiSpam-MessageData-ChunkCount:X-MS-Exchange-AntiSpam-MessageData-0:X-MS-Exchange-AntiSpam-MessageData-1; bh=N/XGQLfUCI0PztX2Lwl607VDPtxV3dWv1OLmp4kurYw=; b=y6AI11JpLXei+2bO9c6G1afCd7MBjRODS9mJGun7xpk86MyHZh0Y4iPd5uVuBYUSQEbZIW20fijS0lVaayBXljUTVnah9DzPj/iJoRpYt1HEIQmRIak7eJgqhubv4UpJ2W/uNg9Ia/Lo+aF9kZEg0RSqz89CPm5hFOFlR1MYmyTxaQwf9ivTvi29fFfn4VKnjSJDtz9zmeyoeShUNVqsMHOtnsxnX0eunx9ohxKXbT/zMxG0YUiMGXgIClG0+oZfzqlByGvxZvoN/s0ZKRuQMlie8lYwgOtcrSft081NBUD5CuaXaJj362yo7bHFH9T0+ZHSIVxlz3Xb7vtaRjrE7A== ARC-Authentication-Results: i=1; mx.microsoft.com 1; spf=pass smtp.mailfrom=oss.nxp.com; dmarc=pass action=none header.from=oss.nxp.com; dkim=pass header.d=oss.nxp.com; arc=none DKIM-Signature: v=1; a=rsa-sha256; c=relaxed/relaxed; d=NXP1.onmicrosoft.com; s=selector1-NXP1-onmicrosoft-com; h=From:Date:Subject:Message-ID:Content-Type:MIME-Version:X-MS-Exchange-SenderADCheck; bh=N/XGQLfUCI0PztX2Lwl607VDPtxV3dWv1OLmp4kurYw=; b=Q3HCftJfGlo7EzWzHh39eJfXWto4vyzEQwxf658QnxRiFsVRSZNscOnDxa/0LxJ4VWaBllMCQXzOH7w3DMOP7Fc1fuaHyWF+BSMH0T6JxtmmfcIeG/tx4JHQjiedw4P47JJiJmmCUGMaEG4v3fOd2AHgdl3+k1FYlfmJealu45F0+35G+AD7t5b11ZTwclmzt0eOnwwQ5rXkpX7AqR+CjTTNF8eIm08JtMfO3Y65M6/VfHj9VcYZTgNrlsrflmK3+GNe1l7+VUllT4fDGPqrvCXHagkN0gXPaTogPpB6OGBkB2/es1nod1Ob2aSPghorRgHFTNObVPfaw9FEPnt5iQ== Authentication-Results: dkim=none (message not signed) header.d=none;dmarc=none action=none header.from=oss.nxp.com; Received: from DU7PR04MB11163.eurprd04.prod.outlook.com (2603:10a6:10:5b3::14) by PA1PR04MB10841.eurprd04.prod.outlook.com (2603:10a6:102:487::17) with Microsoft SMTP Server (version=TLS1_2, cipher=TLS_ECDHE_RSA_WITH_AES_256_GCM_SHA384) id 15.20.8422.19; Wed, 19 Feb 2025 13:25:12 +0000 Received: from DU7PR04MB11163.eurprd04.prod.outlook.com ([fe80::3a74:80e4:4144:62db]) by DU7PR04MB11163.eurprd04.prod.outlook.com ([fe80::3a74:80e4:4144:62db%2]) with mapi id 15.20.8398.021; Wed, 19 Feb 2025 13:25:12 +0000 From: florin.leotescu@oss.nxp.com To: Jean Delvare , Guenter Roeck , Rob Herring , Krzysztof Kozlowski , Conor Dooley , Michael Shych , linux-hwmon@vger.kernel.org, devicetree@vger.kernel.org, linux-kernel@vger.kernel.org Cc: viorel.suman@nxp.com, carlos.song@nxp.com, linux-arm-kernel@lists.infradead.org, imx@lists.linux.dev, Florin Leotescu Subject: [PATCH v2 3/3] dt-bindings: hwmon: emc2305: Add YAML binding documentation for emc2305 driver Date: Wed, 19 Feb 2025 15:32:21 +0200 Message-Id: <20250219133221.2641041-4-florin.leotescu@oss.nxp.com> X-Mailer: git-send-email 2.34.1 In-Reply-To: <20250219133221.2641041-1-florin.leotescu@oss.nxp.com> References: <20250219133221.2641041-1-florin.leotescu@oss.nxp.com> X-ClientProxiedBy: MN2PR08CA0011.namprd08.prod.outlook.com (2603:10b6:208:239::16) To DU7PR04MB11163.eurprd04.prod.outlook.com (2603:10a6:10:5b3::14) Precedence: bulk X-Mailing-List: imx@lists.linux.dev List-Id: List-Subscribe: List-Unsubscribe: MIME-Version: 1.0 X-MS-Exchange-MessageSentRepresentingType: 1 X-MS-PublicTrafficType: Email X-MS-TrafficTypeDiagnostic: DU7PR04MB11163:EE_|PA1PR04MB10841:EE_ X-MS-Office365-Filtering-Correlation-Id: c5fe2077-734c-4074-e1d9-08dd50e8d6b4 X-MS-Exchange-SharedMailbox-RoutingAgent-Processed: True X-MS-Exchange-SenderADCheck: 1 X-MS-Exchange-AntiSpam-Relay: 0 X-Microsoft-Antispam: BCL:0;ARA:13230040|376014|7416014|1800799024|366016; X-Microsoft-Antispam-Message-Info: =?iso-8859-1?q?5wLe5bmSU8WbWuJ/CpsulhpnZo?= =?iso-8859-1?q?ajP8tqYrWCxPrzlMJGDf98cP1JLp23MHUDj5pAZMNFOSsxIxReExpVmHe9nu?= =?iso-8859-1?q?MmeRn9Djy4bqx/if4qH2dyaPpmued5xqNAd7PLmUxAyihrx97qvcvCIDFIg9?= =?iso-8859-1?q?XKIFDWKWDE/kPQ2AZVZY9WGR4Tki6uOq5QRnvkk7t5Ey+Z74HA0qG5BDgYgw?= =?iso-8859-1?q?uYkAAecY40cj83a8quQS86kBZUP8LsmDaJbL8Pj7VMTC/+5NCqBdUDFLvdM+?= =?iso-8859-1?q?cj2voc2AJnuhEGeSE5Vop0sDMv2u5HzrIO7Y5o4Bs7U1Ie7iSurFx8vak7dB?= =?iso-8859-1?q?urL7zHUoJxaBS2bFmJ0Ic4gwS4u3U415ThyEgxr19jgg+lYHV2V598qkT//c?= =?iso-8859-1?q?1oYhAIAaM08M0DKfi1Xopx+VtInAR7zvBJp6i2QvvBEFibUDJ1++bwD9pDhg?= =?iso-8859-1?q?2eIOQp9ZNZnh2n+PtE9f5+usC/2Kavz7qkM9Z5G3rjq8fXNVECl6owFS0j/a?= =?iso-8859-1?q?SUVRusDcS6TFQugiHoCeUrkBCrQRnbkBNIdYjlqSQaG/mYYZ+gWtGKH5Wvxb?= =?iso-8859-1?q?pD4vXMP02T0ya2KFDeDQn2sxKHoXGpMS2hix7dcd21LxZBeDVG0of39v0JNd?= =?iso-8859-1?q?bw8CKpeBdU5FW1ufAGtJjQaA5YiP13wIozW2/HJ3mJV3XDePyy7g4Gw03MDe?= =?iso-8859-1?q?T4K6q3G6Q1Lvtoj5N5kPjbWSzUZvYxG4z1ZqtokKJBotisKupk4YZf+Zqyb+?= =?iso-8859-1?q?iHEjkolh9pBWm3X3bGubbQnmGsoMvmEdv0v+6048lxdXSb8VWCaIjZz5UF/R?= =?iso-8859-1?q?busMGXDiKuwfHbv/BvnKqY1RyXYtMeLCKxP4NYErikUg+jHdnhUN79g4nZ+G?= =?iso-8859-1?q?ItCgy3cBazkFnWgBklpmL+K75W6v9jBYCRgnpwVgwcZMbr2FmVTOz47IaAiG?= =?iso-8859-1?q?MCGpMr7//R6rsuPY0wzDkrYVzrXcXl8LbRHK/jc7/ujF0SkMf5I2QTMhKPRY?= =?iso-8859-1?q?klK9lT9eQ8aJKJuRhoDnc+PE4FZaPUeE8+Wyr6JtUqeSa1lfoXFxJjnpuBCt?= =?iso-8859-1?q?7imjRYC+RYd27aIg9CHIwbL+pVyC1ZzJp/evkB1bnY/hUmCpotH0MCPotDe3?= =?iso-8859-1?q?HnuamUZMxSRmdJzrbjHYdgT+iXqdYyLL5hgxWfrWKS4aTf3TKyoUeQ6cPExX?= =?iso-8859-1?q?thiDa+r8PZig+OdiU/DTf9lSLufwxIRDwkwxsskjsbgF9yZGhRmxnATyqnY3?= =?iso-8859-1?q?y96FvOm3g+/78+h/6CLJqDQbI4uTp1PckRmKHZJvCsPqLJe5qOOAUUixVdhw?= =?iso-8859-1?q?qGMHWT1wFQgdl/fATRrKLpJv7vrAY9G1ha2ivb/BytOF9G5Gqtxgm2PBpQ?= X-Forefront-Antispam-Report: CIP:255.255.255.255;CTRY:;LANG:en;SCL:1;SRV:;IPV:NLI;SFV:NSPM;H:DU7PR04MB11163.eurprd04.prod.outlook.com;PTR:;CAT:NONE;SFS:(13230040)(376014)(7416014)(1800799024)(366016);DIR:OUT;SFP:1101; X-MS-Exchange-AntiSpam-MessageData-ChunkCount: 1 X-MS-Exchange-AntiSpam-MessageData-0: =?iso-8859-1?q?1OAiZWYpyNZO4ZD3fCv6Afq?= =?iso-8859-1?q?2Yfg7MyJrhaAS1b+l2toSUAmjVHy4WKh/N5kufY8Uv4xRNZIi+LjO1hq3l2X?= =?iso-8859-1?q?4fbfRp7ioYfZKielxoHXC4PgT8Kg2Ud0vFYf/s5l1+uhMT/VpYj9rAiYvduA?= =?iso-8859-1?q?HSxaG1jYMSiNFLOUOf1SUPHIY278igBVxeLs6oGhj1I60CE/s6s0rCj6jHRW?= =?iso-8859-1?q?xJLgj9sf0G7Hjeb3QZ5SSapQS5pQsR/+54jZ7JMCUTHOng/SseYde3Un8Kqr?= =?iso-8859-1?q?A9pYj6Y+ir5g9CCdHXYrtyc2Riv3uQh7rUBa1ZCb9vIg5A1WKHzYIBj+BQUW?= =?iso-8859-1?q?tSmluGSAHgGqMdvIKFzIRi5RGp/VYKEFco0B150+ApQoRKD7kOIu90w1Ztsz?= =?iso-8859-1?q?N5ptLuyCJlaJZMYZae5DWUddTsKn891pvgBcXoeUWxGiUjDhUlQaSHESLn6M?= =?iso-8859-1?q?dJOIoFTlquqM+nOrEuoMX7E3Y0hg/P9DhiOIQmj1tr6kT1l4M19TZWcq9hSu?= =?iso-8859-1?q?38Bc7605+/l+0W+kij+y2j6OC80kcSjdLB/ifN6jK6og14HH0BZ+wEWydVcV?= =?iso-8859-1?q?C2HIA6PN56eyfzP1leNhXueNNzXz7lieowx70Um0gNVmpu0ZT5/pJRh/Gpiv?= =?iso-8859-1?q?WnaysVrJ4LUjepsFPFVKTQFfE6QOrAZi3pdHhu5WPyKwipHldfO+Rb7jJWh1?= =?iso-8859-1?q?7GcGJotWJmOvzTOcR6e/GaSFS/PVnwuoourCHYljo5LrmQm4z7iiUlwquhhF?= =?iso-8859-1?q?VaEfu8yq/igqgJiSrSwhA+segBU+XN2wu6FbWZXgMqHb/etgiYbTy3h87E7Q?= =?iso-8859-1?q?1zQEI/D9wgYtt+/1gzBuXGqMvHQVEYcLjNZaHSuPt7uoosFIvV56wqNLG2I+?= =?iso-8859-1?q?Rm7oXs3+IUtRP0MDpjCygyju+xfCV7bphFq7TYbRkgrkp+eKTyu9t7MPyTvQ?= =?iso-8859-1?q?c498kkdNstqx6AYBC/js1l/tgHSbpom0lK4O05k4nzF+mhlZht3X4DdcWaTP?= =?iso-8859-1?q?vrdHFH5PKR76nOeszqUI/1eztjB/D/NHMW7dUBYNz3Sk8akGakbirznP0awc?= =?iso-8859-1?q?G7c2Pz+2JLGT5Eapt3GYQBMmt8OO9mjSx7z2rUYtCYyBW3Xp0CzMJHSP4XO+?= =?iso-8859-1?q?QS+hDXUtmdeSO80vw1/fCwGOuMpHEg47L+Vj0+ziHPATLMB410Z/AqT54aq8?= =?iso-8859-1?q?b9GZ/i2dl5FvzyX3phj7vJq6wQd0A95A0+Uvv1EoWsHrXGQq8Aofg9XBD2lR?= =?iso-8859-1?q?khSScuN57EUH9GHRiTQ9aoKAfLCXj6+Q75O08u5HeisTBqcWilmqTwuz7Yfd?= =?iso-8859-1?q?NV+6pobeOmF0KoSLU8M2sQlNWnzwIAf/aDQmmbXCEn8E7yqPzVwthq2y5OOu?= =?iso-8859-1?q?k/cHlgc4yVA7pemEM6dW4om3krB0s+I1e5QU2ZMDK1FeheYNPoRh0SzIOIGQ?= =?iso-8859-1?q?84o2Qj1tvI2FVTModrunilb59AqJ4SUZLK98UZt4knbVF7UhVitziECbHHu1?= =?iso-8859-1?q?QcgRqIPQXORRiyDVzBiAIqpo4WGXcWxblW8CC+HpktWmvX79FBHJgphCnp9c?= =?iso-8859-1?q?Zqmmp4EmI0D1UchQTQ+KIQ9vbw8pZssU9XAwyZt0sRxAn4L0mDMrPh7S+CzE?= =?iso-8859-1?q?jinHp0eWCbZZGH2ZwDP91eaOVO8hsYwSZzCWZ5Q=3D=3D?= X-OriginatorOrg: oss.nxp.com X-MS-Exchange-CrossTenant-Network-Message-Id: c5fe2077-734c-4074-e1d9-08dd50e8d6b4 X-MS-Exchange-CrossTenant-AuthSource: DU7PR04MB11163.eurprd04.prod.outlook.com X-MS-Exchange-CrossTenant-AuthAs: Internal X-MS-Exchange-CrossTenant-OriginalArrivalTime: 19 Feb 2025 13:25:12.2572 (UTC) X-MS-Exchange-CrossTenant-FromEntityHeader: Hosted X-MS-Exchange-CrossTenant-Id: 686ea1d3-bc2b-4c6f-a92c-d99c5c301635 X-MS-Exchange-CrossTenant-MailboxType: HOSTED X-MS-Exchange-CrossTenant-UserPrincipalName: gN3bLgK1m6JUy4WKaL4kKZxxnw1oa+jhKnNS8WkuZeRDqYI3b9sxOrVOAsWfEvwAiXXTX7q7IpdZT4VbyTJbrg== X-MS-Exchange-Transport-CrossTenantHeadersStamped: PA1PR04MB10841 From: Florin Leotescu Add yaml-based Device Tree bindings documentation for emc2305 driver The file provides the necessary structure, configuration and other parameters for Device Tree definition. Signed-off-by: Florin Leotescu --- .../devicetree/bindings/hwmon/emc2305.yaml | 95 +++++++++++++++++++ 1 file changed, 95 insertions(+) create mode 100644 Documentation/devicetree/bindings/hwmon/emc2305.yaml diff --git a/Documentation/devicetree/bindings/hwmon/emc2305.yaml b/Documentation/devicetree/bindings/hwmon/emc2305.yaml new file mode 100644 index 000000000000..51e2a82d8f25 --- /dev/null +++ b/Documentation/devicetree/bindings/hwmon/emc2305.yaml @@ -0,0 +1,95 @@ +# SPDX-License-Identifier: (GPL-2.0-only OR BSD-2-Clause) +%YAML 1.2 +--- +$id: http://devicetree.org/schemas/hwmon/emc2305.yaml# +$schema: http://devicetree.org/meta-schemas/core.yaml# + +title: EMC2305 i2c pwm fan controller + +maintainers: + - Michael Shych + +description: | + The driver implements support for Microchip EMC2301/2/3/5 PWM Fan Controller. + The EMC2301 Fan Controller supports only one controlled PWM fan channel. + The EMC2305 Fan Controller supports up to 5 independently + controlled PWM fan drives. + +properties: + compatible: + enum: + - hwmon,emc2301 + - hwmon,emc2302 + - hwmon,emc2303 + - hwmon,emc2305 + + reg: + description: I2C address of the emc2305 device + + pwm_output: + description: "PWM output type Push-Pull/ Open Drain" + maxItems: 1 + + pwm_polarity: + description: "PWM polarity" + maxItems: 1 + + '#cooling-cells': + description: "cooling state range" + +required: + - compatible + - reg + +additionalProperties: false + +examples: + - | + thermal_zones { + a55-thermal { + trips { + atrip0: trip0 { + temperature = <55000>; + hysteresis = <2000>; + type = "active"; + }; + + atrip1: trip1 { + temperature = <65000>; + hysteresis = <2000>; + type = "active"; + }; + + atrip2: trip2 { + temperature = <75000>; + hysteresis = <2000>; + type = "active"; + }; + }; + + cooling-maps { + map1 { + trip = <&atrip0>; + cooling-device = <&emc2301 4 6>; + }; + + map2 { + trip = <&atrip1>; + cooling-device = <&emc2301 6 8>; + }; + + map3 { + trip = <&atrip2>; + cooling-device = <&emc2301 8 10>; + }; + }; + }; + + } + emc2301: pwm@2f { + compatible = "hwmon,emc2301"; + reg = <0x2f>; + #cooling-cells = <2>; + pwm_output = <0x1>; + pwm_polarity = <0x1>; + };