From nobody Sat Oct 4 15:55:22 2025 Received: from mail-wr1-f45.google.com (mail-wr1-f45.google.com [209.85.221.45]) (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 66B96191F92; Thu, 14 Aug 2025 13:21:51 +0000 (UTC) Authentication-Results: smtp.subspace.kernel.org; arc=none smtp.client-ip=209.85.221.45 ARC-Seal: i=1; a=rsa-sha256; d=subspace.kernel.org; s=arc-20240116; t=1755177713; cv=none; b=H+KrceytWQ50qyeTJDG2F7QytW/cTy6msRC7SMO3m3hkRhM4BivkBgonRp6pN8RJkhBzkj7xH/j+k+1m2RgYD/Hi1kSDU5tJf7WrTzDpLhf3P9ftpGsmpwJQXrb0gMUbTncip1ixjn6HqgRDCf4hMltvVN+4v3eaKizxudrpTh8= ARC-Message-Signature: i=1; a=rsa-sha256; d=subspace.kernel.org; s=arc-20240116; t=1755177713; c=relaxed/simple; bh=U8FU7FRkRV+/JafGQmV5sFWMXTKJjY8I/thsrRc+ED4=; h=From:To:Cc:Subject:Date:Message-Id:In-Reply-To:References: MIME-Version:Content-Type; b=cVjOqsTykyheC2ajXD7iZviPpgkBa8TYA4hMRHDYwHbF5nRebaT7MAvG0K9Evtq4EuI+VwGKldkKMe03EkVlfSBdG6nOqonbPJdAv2oYQzz0RCxpclsHgLL/jwfOUcGyTOPXukDatoVd0OiPB9cX0TqwMfJ//U1IxzuhwXSLx8Y= 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=IEyVvvqI; arc=none smtp.client-ip=209.85.221.45 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="IEyVvvqI" Received: by mail-wr1-f45.google.com with SMTP id ffacd0b85a97d-3b9e414252dso466370f8f.3; Thu, 14 Aug 2025 06:21:51 -0700 (PDT) DKIM-Signature: v=1; a=rsa-sha256; c=relaxed/relaxed; d=gmail.com; s=20230601; t=1755177709; x=1755782509; 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=JU2Gp9h4czw7MJEaHWu/eIohrSz/v3NRu6dZAti6l6A=; b=IEyVvvqIUnTBLgPLc2EP9DlLuvSMnQW/6zaNYoDpxFwljUk4AvdhXgC9He2CzPJ3Rn l7cujxGhmBv4dGqbQkadcbz8gVNc1aFEzeZunhjkF+yXR1mYZKsO+PElXbs7KyD4p07R +6QfXIVl/4xipVIu7RklMCsSM8tbrTixZ5aVPcAFxP3n9EZhm8wliJdLb3zh/+3yg0e9 csH6nehRmL4gJacXkzeaLdjRWiB834f0rszM6qOEfsWwPl1ZL8kqXTd0MqfWinx/EJnm +O3JRD6vkobA/9uuGjvwdMSN04OTYR5Bx1YLB6b/Ng+u0s+H1irVhLS5oidAOYAaShbC IYrA== X-Google-DKIM-Signature: v=1; a=rsa-sha256; c=relaxed/relaxed; d=1e100.net; s=20230601; t=1755177709; x=1755782509; 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=JU2Gp9h4czw7MJEaHWu/eIohrSz/v3NRu6dZAti6l6A=; b=rUnKBdYDx0/TO3HV+D4mkMfn3qJrr4wn4N0MgGaN0qUEh0s4y1wLiCEIuyZRQvbCDo xj0oMgg86HOsagvgMaSaKZQeiakRRijJjtFYyQA5OR/Vov876t9slqh1z04kBLoEAYjy Vm9CLjoJNoRwIsV2yhindFSQMpqqCSEDGL21xpfAYh6sDgTT+hYZhB8aT5zT4zkM96fI QdT8eoxmhRnZMQuerXxY7kMsq9LLW0WfXkmaa+EL1o88Iiu5An0sPR7V7W9KpfPg9uXF 0Ltu11YqmEM3nFzvgTAnUPxeP26WLdEzBnNxppUYaxTk4D153soiDHqMu8/esHiLXWRv H0gA== X-Forwarded-Encrypted: i=1; AJvYcCVf0SfcxCkaRFZeHHgbdrzh1oBk7drggAQPFyuE0ZUO4jpsPzMF//QvMmj6NoTp8Ci9NhX+6T+ei1dH@vger.kernel.org, AJvYcCVnvJzbEc3FQAtnzy/gkcvUXVZePZ3Go1qOP777V6wNT9oCNJJfhCEcpmyjlD5uS8YjoBSpopT+EsYCSuw=@vger.kernel.org, AJvYcCVtB2L/FntcR697B4yLUKVSQndCB2SNFqwKloboPWyHEOyb2SHMDQ7As5rAFU2JndBHq/pfjtkYDOi4@vger.kernel.org, AJvYcCWCQTiTKhIUDrcqs/9K0KDxSnEEkxyAYesiDtylhNpd1JN1ylwhL8sVyyWBxr72KynepKA9m1xD8nzk@vger.kernel.org, AJvYcCXojChpmnWW7Hboj5GXjxJ0wqkqm168xinN2b4IJQ7YyfgCfrFvGpshezmHbMQE9TmD5ee294mgady52/c=@vger.kernel.org X-Gm-Message-State: AOJu0YwXlv21bxf/XSmeLmPV9TDg/qvR9WC+MCScAgVH6PU5dN1oWXVB Df/GAbXYb2S+J1Kjd4/DQZGpbcdC0TrBYCua7LuEJ1vj5Suz1WkolL//hkwU X-Gm-Gg: ASbGncs2UFI543Y5UEvpAAiR1MIDO2GY368Vm1C6j+VheF24Z3kT30OYMt/UMhWI/IG LuNf/an/NFMysM97sr9Bet1Keel5OB82U1y+lZC1j1B2bG3IA6Mwaml/2hlvWJWbDMjOv31oeSL yAyI/nV97f5gUcZ+gN3t13TB9zCy31p4459D30lD7eREe+iZGcCTkkj65Xt3WlFWrK0/CZE6ZMQ pzoQnsvSFzDVz1r2PVwLDw6jeTigB6TTFr8HXu9u//eWDiTZl4ExaN2HowZZngIwBGsYX0ooAcy XhXwC9HjYjH/N1b2FNRv49c3YmcQp3Jo466nwC2mGsNh3OpMAox4Y/bqSgoOc3TMJkG8vRDozno bpPjTQQ/+78lmlr54ewUOZ3JsYhXHulBANgtNnfRgStsrMTxtGXtybjvB4SbCGYYcJbmHsj+yN8 CPsDdidLgbPWUEMnGCnFH+5g== X-Google-Smtp-Source: AGHT+IFXYxx0HIDKMOOsz0Kg0OfVqALvEwyRBRSw3nB53odh49i2jBiSY+y6VktUaDR4o37S0HDDvQ== X-Received: by 2002:a05:6000:24c2:b0:3b7:974d:537b with SMTP id ffacd0b85a97d-3b9fc3597c2mr2793105f8f.35.1755177709228; Thu, 14 Aug 2025 06:21:49 -0700 (PDT) Received: from localhost.localdomain (lmontsouris-658-1-96-160.w81-250.abo.wanadoo.fr. [81.250.250.160]) by smtp.gmail.com with ESMTPSA id ffacd0b85a97d-3b79c3b9386sm50998831f8f.18.2025.08.14.06.21.48 (version=TLS1_3 cipher=TLS_AES_256_GCM_SHA384 bits=256/256); Thu, 14 Aug 2025 06:21:48 -0700 (PDT) From: Jihed Chaibi To: linux-kernel@vger.kernel.org Cc: andreas@kemnade.info, peter.ujfalusi@gmail.com, dmitry.torokhov@gmail.com, robh@kernel.org, krzk+dt@kernel.org, lgirdwood@gmail.com, tiwai@suse.com, conor+dt@kernel.org, lee@kernel.org, ukleinek@kernel.org, broonie@kernel.org, gregkh@linuxfoundation.org, linux-input@vger.kernel.org, devicetree@vger.kernel.org, linux-pwm@vger.kernel.org, linux-sound@vger.kernel.org, linux-usb@vger.kernel.org, shuah@kernel.org, jihed.chaibi.dev@gmail.com Subject: [PATCH v2 1/9] mfd: dt-bindings: ti,twl4030-audio: convert to DT schema Date: Thu, 14 Aug 2025 15:21:21 +0200 Message-Id: <20250814132129.138943-2-jihed.chaibi.dev@gmail.com> X-Mailer: git-send-email 2.39.5 In-Reply-To: <20250814132129.138943-1-jihed.chaibi.dev@gmail.com> References: <20250814132129.138943-1-jihed.chaibi.dev@gmail.com> 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 Convert the TWL4030 audio module bindings from txt to YAML format and move them to the sound subsystem bindings directory. This patch also refines the schema by adding an enum constraint for ti,enable-vibra and updates the example to remove irrelevant I2C clock-frequency property. Changes in v2: - Moved binding from mfd to sound directory. - Added enum: [0, 1] to ti,enable-vibra for stricter validation. - Removed clock-frequency from the example as it=E2=80=99s not relevant to = the binding. - Simplified example by removing unnecessary I2C node properties. Signed-off-by: Jihed Chaibi --- .../devicetree/bindings/mfd/twl4030-audio.txt | 46 ---------- .../bindings/sound/ti,twl4030-audio.yaml | 90 +++++++++++++++++++ 2 files changed, 90 insertions(+), 46 deletions(-) delete mode 100644 Documentation/devicetree/bindings/mfd/twl4030-audio.txt create mode 100644 Documentation/devicetree/bindings/sound/ti,twl4030-audi= o.yaml diff --git a/Documentation/devicetree/bindings/mfd/twl4030-audio.txt b/Docu= mentation/devicetree/bindings/mfd/twl4030-audio.txt deleted file mode 100644 index 414d2ae0a..000000000 --- a/Documentation/devicetree/bindings/mfd/twl4030-audio.txt +++ /dev/null @@ -1,46 +0,0 @@ -Texas Instruments TWL family (twl4030) audio module - -The audio module inside the TWL family consist of an audio codec and a vib= ra -driver. - -Required properties: -- compatible : must be "ti,twl4030-audio" - -Optional properties, nodes: - -Audio functionality: -- codec { }: Need to be present if the audio functionality is used. Within= this - section the following options can be used: -- ti,digimic_delay: Delay need after enabling the digimic to reduce artifa= cts - from the start of the recorded sample (in ms) --ti,ramp_delay_value: HS ramp delay configuration to reduce pop noise --ti,hs_extmute: Use external mute for HS pop reduction --ti,hs_extmute_gpio: Use external GPIO to control the external mute --ti,offset_cncl_path: Offset cancellation path selection, refer to TRM for= the - valid values. - -Vibra functionality -- ti,enable-vibra: Need to be set to <1> if the vibra functionality is use= d. if - missing or it is 0, the vibra functionality is disabled. - -Example: -&i2c1 { - clock-frequency =3D <2600000>; - - twl: twl@48 { - reg =3D <0x48>; - interrupts =3D <7>; /* SYS_NIRQ cascaded to intc */ - interrupt-parent =3D <&intc>; - - twl_audio: audio { - compatible =3D "ti,twl4030-audio"; - - ti,enable-vibra =3D <1>; - - codec { - ti,ramp_delay_value =3D <3>; - }; - - }; - }; -}; diff --git a/Documentation/devicetree/bindings/sound/ti,twl4030-audio.yaml = b/Documentation/devicetree/bindings/sound/ti,twl4030-audio.yaml new file mode 100644 index 000000000..c9c3f7513 --- /dev/null +++ b/Documentation/devicetree/bindings/sound/ti,twl4030-audio.yaml @@ -0,0 +1,90 @@ +# SPDX-License-Identifier: (GPL-2.0-only OR BSD-2-Clause) +%YAML 1.2 +--- +$id: http://devicetree.org/schemas/sound/ti,twl4030-audio.yaml# +$schema: http://devicetree.org/meta-schemas/core.yaml# + +title: Texas Instruments TWL4030-family Audio Module + +maintainers: + - Peter Ujfalusi + +description: + The audio module within the TWL4030-family of companion chips consists + of an audio codec and a vibra driver. This binding describes the parent + node for these functions. + +properties: + compatible: + const: ti,twl4030-audio + + codec: + type: object + description: Node containing properties for the audio codec functional= ity. + + properties: + ti,digimic_delay: + $ref: /schemas/types.yaml#/definitions/uint32 + description: + Delay in milliseconds after enabling digital microphones to redu= ce + artifacts. + + ti,ramp_delay_value: + $ref: /schemas/types.yaml#/definitions/uint32 + description: + Headset ramp delay configuration to reduce pop noise. + + ti,hs_extmute: + type: boolean + description: + Enable the use of an external mute for headset pop reduction. + + ti,hs_extmute_gpio: + $ref: /schemas/types.yaml#/definitions/phandle-array + description: + The GPIO specifier for the external mute control. + maxItems: 1 + + ti,offset_cncl_path: + $ref: /schemas/types.yaml#/definitions/uint32 + description: + Offset cancellation path selection. Refer to the Technical + Reference Manual for valid values. + + # The 'codec' node itself is optional, but if it exists, it can be empty. + # We don't require any of its sub-properties. + + ti,enable-vibra: + $ref: /schemas/types.yaml#/definitions/uint32 + enum: [0, 1] + description: + Enable or disable the vibra functionality. + +additionalProperties: false + +required: + - compatible + +examples: + - | + i2c { + #address-cells =3D <1>; + #size-cells =3D <0>; + + twl: twl@48 { + reg =3D <0x48>; + interrupts =3D <7>; /* SYS_NIRQ cascaded to intc */ + interrupt-parent =3D <&intc>; + + twl_audio: audio { + compatible =3D "ti,twl4030-audio"; + + ti,enable-vibra =3D <1>; + + codec { + ti,ramp_delay_value =3D <3>; + }; + + }; + }; + }; --=20 2.39.5 From nobody Sat Oct 4 15:55:22 2025 Received: from mail-wm1-f43.google.com (mail-wm1-f43.google.com [209.85.128.43]) (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 A1FF23009F7; Thu, 14 Aug 2025 13:21:53 +0000 (UTC) Authentication-Results: smtp.subspace.kernel.org; arc=none smtp.client-ip=209.85.128.43 ARC-Seal: i=1; a=rsa-sha256; d=subspace.kernel.org; s=arc-20240116; t=1755177716; cv=none; b=sjJ6jMW5u8Uk97cnKSKuKyxbkduWEJYT/qkthksmx3WE+4DjIvhy2O6/QuGVq5xB0H9b+BwfInqlXWSoqFR4vxZuClw4u7Pqe1Xv8sOTQAYpGNTxcD02cBJWqULgvwQEjKyMV7wsetaxr64syg+vMXOFhp01wj4otNkycM5Avpk= ARC-Message-Signature: i=1; a=rsa-sha256; d=subspace.kernel.org; s=arc-20240116; t=1755177716; c=relaxed/simple; bh=YB8gx+mS5u1dIxyZz+GFs2Q1IPHnHTO12wo/rlhuhWE=; h=From:To:Cc:Subject:Date:Message-Id:In-Reply-To:References: MIME-Version; b=U1MOagjXRCKaKSsI4YXZqSQNt+2t59GEYrz/OkwXWn8y1w04xHjKVdmygPhPDX4VWZe/1qlg/vrAYXe3rlzFCJFfzjZqGpPXxIba8fHLi0l0zRFS6T6YnR5UhN0JEYQJwE/lol1afAS1ddgwZb6r0LlTU4hGxT06Y1pvQsYNfkQ= 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=PxR9A70Y; arc=none smtp.client-ip=209.85.128.43 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="PxR9A70Y" Received: by mail-wm1-f43.google.com with SMTP id 5b1f17b1804b1-45a1b0990b2so6203015e9.2; Thu, 14 Aug 2025 06:21:53 -0700 (PDT) DKIM-Signature: v=1; a=rsa-sha256; c=relaxed/relaxed; d=gmail.com; s=20230601; t=1755177712; x=1755782512; 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=4fJmbIv+TtvIhbfGERIJn/WGPFWhZmJ8+BYKnvffDX8=; b=PxR9A70Y97q7rosC6GiwXHYePfqg10K8mQqic6C+8FGfO7c7QdR0HlGYvb4UngSy02 wZD4yvTmRkDygnKTK+VWmms6UExDT/yMbXmkpoDMirQmfxSy22buw8hHnbILuu3dJgc5 fbBKc1LelWQQbtFwlPFXJaUtoqvfdViDeYTB7exnURoynryJuodW2y2z9Ez3HeUMIvX1 S72a/L7M9g88qlEuueCUfFf/Pky76lfevkTwodPKhphlazrjrr/LW+ImfFv2Fy16Zo13 VI3Selnzvj9PVxlNGlJ0HPRuyk6Qa8cvP399nLWzymLKpUjvc06vnFFCYAiGrnpqLHu5 BQIQ== X-Google-DKIM-Signature: v=1; a=rsa-sha256; c=relaxed/relaxed; d=1e100.net; s=20230601; t=1755177712; x=1755782512; 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=4fJmbIv+TtvIhbfGERIJn/WGPFWhZmJ8+BYKnvffDX8=; b=esnPlgdb0oA0kWmz75skClwpNER3Cdq8fWwmbDGQy8BCAnSDTJ1nK6jz5AKXVCvspR cmnbjKsiVPLGCPC04SpJa43k7eZ1f9CWPvqJ65JeccVoIGgOvZCit0wD15CL44UBODs8 FBB2cjdvbrTR0FQbvPpjp2qSrBQnrxVqdX5oq5nmMw1BPRrB7Okkq+UNsgzoGd/vnbH1 aBR/BBsTgYfiKWRAYN2nu4fKivhOWCJICyyfy5RDEPcZ9Cb72vlwpWHdC1tlDt0g9Smv eHIcRE8OGEVFHk9ABcp/awD0u3SaDvKuSaYv74KVkxy7K6PUk3j9ycZ2dbAytlccoPC3 TnkA== X-Forwarded-Encrypted: i=1; AJvYcCVzHvuRBuj6+yzRtcwLaZChC4vjKZCJF8/2eoPwn1DcG7lFCwofKVo2FCWm1wSDckdKBht8Z7LKkx81QYY=@vger.kernel.org, AJvYcCWTFSQyYGzW6wXP11azrj7+RiQdFbWEdl9WkB0EYMCaZrzOCR2uiKA6xpWHwRXVMbLfIkguHwcmeHSQ@vger.kernel.org, AJvYcCWf+XsH+W7qGesRpbLmkAPMqfFsj5rc08oE0Ia5rxhia/1nW68H22wF+QvIiZfJzw9BWt9iSz9AkDL1tbk=@vger.kernel.org, AJvYcCX3Choe5OWeJL0QdtIr6/xyE8/G+M4wMo0yRHBhTM8Ze2CwTG+pFUkm748GFc6BOri0YsK2EIYG72SI@vger.kernel.org, AJvYcCXd8q79slrgTEwqGfAUbZny879gi9JKQH//5IS2lx92dE1mf6ypAc4mv0FO+Y0kZEx9Fwwg+NPXYita@vger.kernel.org X-Gm-Message-State: AOJu0Ywp9fZCG5+z9o7Od3r4hOlJCaTmxYl+MBPr6JMUwTFTbtR4UfwJ U4uVHqTteL49fLd+7NQwr5C3EAMUx6ciwRHB94rCxW1L74Kaf8yYPP2NvvSN X-Gm-Gg: ASbGnctPoWdJfVIzQt9Y/rw2hujgMi5O7scFhJz/U8A1zWnfTLAbIrqwxVOhLxtNcZa SfkYVYy+pdrnlXJfXrfG7259wN45unwAW1UsL7JlBTReS+GxIhaMujh7n0q1PYoayYQ7mW3tFRG MSqmkLbdRUXSWSpfNPku4ZF5VxczepEXymyvS7Y1JsRY4n9U9wcUiSxb0AyiTqqXs06MpIv5QDe 4MhgGbMuUfk/b1vx0FEGESok0nicFnImwie+PdKpSvpgZsDRSDKtW+TQQ7xNk5ypINv7e3OOkA4 yiPThKjtsWilboDVS9CX5PkY0ncCipoaPMY8hp8aVKsv4g7N1/NoaeDshgsod8gNv3bdN5Ionxz G+mQxk3b3CfVPsTnZnAKS2VxDhBRYPREPGnDx8ubfoI1l/VRM5QZdHDzmHqChYKMjjBWxRF+qXk 0h8diXD/N63hxolgoHvRMzRg== X-Google-Smtp-Source: AGHT+IFiL+1Umnq+fmKeKNZMcktyIW0wkdHd0uXEMP4yqlT4LWOeF3NNGRX5nUW9RkO4906ovxoWgg== X-Received: by 2002:a5d:5d09:0:b0:3b5:f0af:4bb0 with SMTP id ffacd0b85a97d-3b9e417d8bamr2571123f8f.23.1755177711455; Thu, 14 Aug 2025 06:21:51 -0700 (PDT) Received: from localhost.localdomain (lmontsouris-658-1-96-160.w81-250.abo.wanadoo.fr. [81.250.250.160]) by smtp.gmail.com with ESMTPSA id ffacd0b85a97d-3b79c3b9386sm50998831f8f.18.2025.08.14.06.21.50 (version=TLS1_3 cipher=TLS_AES_256_GCM_SHA384 bits=256/256); Thu, 14 Aug 2025 06:21:50 -0700 (PDT) From: Jihed Chaibi To: linux-kernel@vger.kernel.org Cc: andreas@kemnade.info, peter.ujfalusi@gmail.com, dmitry.torokhov@gmail.com, robh@kernel.org, krzk+dt@kernel.org, lgirdwood@gmail.com, tiwai@suse.com, conor+dt@kernel.org, lee@kernel.org, ukleinek@kernel.org, broonie@kernel.org, gregkh@linuxfoundation.org, linux-input@vger.kernel.org, devicetree@vger.kernel.org, linux-pwm@vger.kernel.org, linux-sound@vger.kernel.org, linux-usb@vger.kernel.org, shuah@kernel.org, jihed.chaibi.dev@gmail.com Subject: [PATCH v2 2/9] mfd: dt-bindings: ti,twl6040: convert to DT schema Date: Thu, 14 Aug 2025 15:21:22 +0200 Message-Id: <20250814132129.138943-3-jihed.chaibi.dev@gmail.com> X-Mailer: git-send-email 2.39.5 In-Reply-To: <20250814132129.138943-1-jihed.chaibi.dev@gmail.com> References: <20250814132129.138943-1-jihed.chaibi.dev@gmail.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" Convert the legacy TXT binding for the TWL6040 MFD to the modern YAML DT schema format. This adds formal validation and improves documentation for the TWL6040/TWL6041 audio codec, which provides audio, vibra, and GPO functionality on OMAP4+ platforms. Changes in v2: - Renamed twl6040,audpwron-gpio to ti,audpwron-gpio for consistency with TI naming, this fixes the dt_binding_check vendor name error. - Minor description clarifications for improved readability. Signed-off-by: Jihed Chaibi --- .../devicetree/bindings/mfd/ti,twl6040.yaml | 155 ++++++++++++++++++ .../devicetree/bindings/mfd/twl6040.txt | 67 -------- 2 files changed, 155 insertions(+), 67 deletions(-) create mode 100644 Documentation/devicetree/bindings/mfd/ti,twl6040.yaml delete mode 100644 Documentation/devicetree/bindings/mfd/twl6040.txt diff --git a/Documentation/devicetree/bindings/mfd/ti,twl6040.yaml b/Docume= ntation/devicetree/bindings/mfd/ti,twl6040.yaml new file mode 100644 index 000000000..7365e4c04 --- /dev/null +++ b/Documentation/devicetree/bindings/mfd/ti,twl6040.yaml @@ -0,0 +1,155 @@ +# SPDX-License-Identifier: (GPL-2.0-only OR BSD-2-Clause) +%YAML 1.2 +--- +$id: http://devicetree.org/schemas/mfd/ti,twl6040.yaml# +$schema: http://devicetree.org/meta-schemas/core.yaml# + +title: Texas Instruments TWL6040/TWL6041 Audio Codec + +maintainers: + - Peter Ujfalusi + +description: + The TWL6040s are 8-channel high quality low-power audio codecs providing + audio, vibra and GPO functionality on OMAP4+ platforms. + They are connected to the host processor via i2c for commands, McPDM for + audio data and commands. + +properties: + compatible: + enum: + - ti,twl6040 + - ti,twl6041 + + reg: + const: 0x4b + + interrupts: + maxItems: 1 + + gpio-controller: true + + '#gpio-cells': + const: 1 + + '#clock-cells': + description: TWL6040 is a provider of PDMCLK which is used by McPDM. + const: 0 + + ti,audpwron-gpio: + description: The GPIO specifier for the audio power-on line. + maxItems: 1 + + vio-supply: + description: Regulator for the VIO supply. + + v2v1-supply: + description: Regulator for the V2V1 supply. + + enable-active-high: + type: boolean + description: If present, powers on the device during boot. + + clocks: + minItems: 1 + maxItems: 2 + + clock-names: + minItems: 1 + maxItems: 2 + items: + enum: [clk32k, mclk] + + # Vibra functionality : + + vddvibl-supply: + description: Regulator for the left vibra motor supply. + + vddvibr-supply: + description: Regulator for the right vibra motor supply. + + vibra: + type: object + description: Node for vibra motor configuration parameters. + properties: + ti,vibldrv-res: + $ref: /schemas/types.yaml#/definitions/uint32 + description: Resistance parameter for the left driver. + + ti,vibrdrv-res: + $ref: /schemas/types.yaml#/definitions/uint32 + description: Resistance parameter for the right driver. + + ti,viblmotor-res: + $ref: /schemas/types.yaml#/definitions/uint32 + description: Resistance parameter for the left motor. + + ti,vibrmotor-res: + $ref: /schemas/types.yaml#/definitions/uint32 + description: Resistance parameter for the right motor. + + vddvibl_uV: + $ref: /schemas/types.yaml#/definitions/uint32 + description: Optional override for the VDDVIBL default voltage (in= uV). + + vddvibr_uV: + $ref: /schemas/types.yaml#/definitions/uint32 + description: Optional override for the VDDVIBR default voltage (in= uV). + required: + - ti,vibldrv-res + - ti,vibrdrv-res + - ti,viblmotor-res + - ti,vibrmotor-res + additionalProperties: false + +required: + - compatible + - reg + - interrupts + - gpio-controller + - '#gpio-cells' + - '#clock-cells' + - ti,audpwron-gpio + - vio-supply + - v2v1-supply + - vddvibl-supply + - vddvibr-supply + - vibra + +additionalProperties: false + +examples: + - | + i2c { + #address-cells =3D <1>; + #size-cells =3D <0>; + + twl6040: twl@4b { + compatible =3D "ti,twl6040"; + reg =3D <0x4b>; + + interrupts =3D <0 119 4>; + interrupt-parent =3D <&gic>; + + gpio-controller; + #gpio-cells =3D <1>; + #clock-cells =3D <0>; + ti,audpwron-gpio =3D <&gpio4 31 0>; + + vio-supply =3D <&v1v8>; + v2v1-supply =3D <&v2v1>; + enable-active-high; + + /* regulators for vibra motor */ + vddvibl-supply =3D <&vbat>; + vddvibr-supply =3D <&vbat>; + + vibra { + /* Vibra driver, motor resistance parameters */ + ti,vibldrv-res =3D <8>; + ti,vibrdrv-res =3D <3>; + ti,viblmotor-res =3D <10>; + ti,vibrmotor-res =3D <10>; + }; + }; + }; diff --git a/Documentation/devicetree/bindings/mfd/twl6040.txt b/Documentat= ion/devicetree/bindings/mfd/twl6040.txt deleted file mode 100644 index dfd8683ed..000000000 --- a/Documentation/devicetree/bindings/mfd/twl6040.txt +++ /dev/null @@ -1,67 +0,0 @@ -Texas Instruments TWL6040 family - -The TWL6040s are 8-channel high quality low-power audio codecs providing a= udio, -vibra and GPO functionality on OMAP4+ platforms. -They are connected to the host processor via i2c for commands, McPDM for a= udio -data and commands. - -Required properties: -- compatible : "ti,twl6040" for twl6040, "ti,twl6041" for twl6041 -- reg: must be 0x4b for i2c address -- interrupts: twl6040 has one interrupt line connecteded to the main SoC -- gpio-controller: -- #gpio-cells =3D <1>: twl6040 provides GPO lines. -- #clock-cells =3D <0>; twl6040 is a provider of pdmclk which is used by M= cPDM -- twl6040,audpwron-gpio: Power on GPIO line for the twl6040 - -- vio-supply: Regulator for the twl6040 VIO supply -- v2v1-supply: Regulator for the twl6040 V2V1 supply - -Optional properties, nodes: -- enable-active-high: To power on the twl6040 during boot. -- clocks: phandle to the clk32k and/or to mclk clock provider -- clock-names: Must be "clk32k" for the 32K clock and "mclk" for the MCLK. - -Vibra functionality -Required properties: -- vddvibl-supply: Regulator for the left vibra motor -- vddvibr-supply: Regulator for the right vibra motor -- vibra { }: Configuration section for vibra parameters containing the fol= lowing - properties: -- ti,vibldrv-res: Resistance parameter for left driver -- ti,vibrdrv-res: Resistance parameter for right driver -- ti,viblmotor-res: Resistance parameter for left motor -- ti,viblmotor-res: Resistance parameter for right motor - -Optional properties within vibra { } section: -- vddvibl_uV: If the vddvibl default voltage need to be changed -- vddvibr_uV: If the vddvibr default voltage need to be changed - -Example: -&i2c1 { - twl6040: twl@4b { - compatible =3D "ti,twl6040"; - - interrupts =3D <0 119 4>; - interrupt-parent =3D <&gic>; - twl6040,audpwron-gpio =3D <&gpio4 31 0>; - - vio-supply =3D <&v1v8>; - v2v1-supply =3D <&v2v1>; - enable-active-high; - - /* regulators for vibra motor */ - vddvibl-supply =3D <&vbat>; - vddvibr-supply =3D <&vbat>; - - vibra { - /* Vibra driver, motor resistance parameters */ - ti,vibldrv-res =3D <8>; - ti,vibrdrv-res =3D <3>; - ti,viblmotor-res =3D <10>; - ti,vibrmotor-res =3D <10>; - }; - }; -}; - -/include/ "twl6040.dtsi" --=20 2.39.5 From nobody Sat Oct 4 15:55:22 2025 Received: from mail-wr1-f54.google.com (mail-wr1-f54.google.com [209.85.221.54]) (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 C3DED3009FE; Thu, 14 Aug 2025 13:21:55 +0000 (UTC) Authentication-Results: smtp.subspace.kernel.org; arc=none smtp.client-ip=209.85.221.54 ARC-Seal: i=1; a=rsa-sha256; d=subspace.kernel.org; s=arc-20240116; t=1755177717; cv=none; b=XonHUKZX8YgEBN15BndStP5GgzM2ZcTeX0umWlDUTt9vnaDzWPtDy+oE4iVdyb293TmZO9V+eLGHGQKEtXUg6GidKvtsQgFWLTlLPeLfIc8AQmy1vKUq2uAinkFSwGC7JtFPMdlPNQ6bFGG9CQZIcrPU5up8n+B7ePzFBZWMYJI= ARC-Message-Signature: i=1; a=rsa-sha256; d=subspace.kernel.org; s=arc-20240116; t=1755177717; c=relaxed/simple; bh=x0kOk8eWAry6DbH4ndyacx/LzJHveDzrowCBPYfPE3k=; h=From:To:Cc:Subject:Date:Message-Id:In-Reply-To:References: MIME-Version; b=kjWwtGm+gHzlK99diWnQydsCFk6Xul/lB8K3mw+BHIbUuY6KhskqDs32XFdEYEAIipYZ57hrK95KgT5yY/e6382wZgU8o6QNG/jsvLatUc2RFjjzMX7m0uSswkb/CLX79za7zNj+8qHXAhMTzzZ37Tj7C+fMPnK/u29WKdFJnV8= 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=PrrPSywt; arc=none smtp.client-ip=209.85.221.54 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="PrrPSywt" Received: by mail-wr1-f54.google.com with SMTP id ffacd0b85a97d-3b9e418ba08so445566f8f.3; Thu, 14 Aug 2025 06:21:55 -0700 (PDT) DKIM-Signature: v=1; a=rsa-sha256; c=relaxed/relaxed; d=gmail.com; s=20230601; t=1755177713; x=1755782513; 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=g/Z5I6dWyMwjN9MucQxrz1rMb+esFAduYn7apBZYxxE=; b=PrrPSywtlLfzaUv+T/vhn08oq9xDz21lLeVvVVRYFzQsfzF0Cx40KivVpXQQld9b9q A5s1t4+BghNrHjh+J5G9Gi4/bD50uqUg0LA6DFOrFERnuZC30i/FqvlTfrg1S1j4gaP0 2MJ/BmpcDURoMbBs3WiUJvy903EALHL3uofMqX8DBkb4/25/NqYmdQGFT6h1kBBSaBD2 L5lTK/cCi23ijcStKdfb1YWciy/bUT4sbWFLuz9VZO+WrW/KVHFFPT2Libe0FnnNqvza l7WvnyBHgOb8VYeqdlxDBt2QFazBnJgt1DFTmP1yNK8iRlYRXx/aAI78OqEwwrBXcx+g Z5yQ== X-Google-DKIM-Signature: v=1; a=rsa-sha256; c=relaxed/relaxed; d=1e100.net; s=20230601; t=1755177713; x=1755782513; 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=g/Z5I6dWyMwjN9MucQxrz1rMb+esFAduYn7apBZYxxE=; b=RR7ZRKXaQEMUHIQQ26A63XwwH15KFcCauSldr2t/kmVoR1C4ZwjdmM+Kao5fGUVdWI JFk8ruzQ2BFQQhAdMP9gmiW/cbt+E2xqVEEfOZrI4uin8l9QJHSRCfbKJxfXnF3AblTM oFZzc00qoKpAjr+yczt/FeAAwWodmOvu0isI3VRHkA2/t8ildUrv78pXRT6ya3vkNZk3 Y0JF5qUG7M23BxtSqcIOak8eyhvqeXaCY85VJXuV9yO4MwRrJINoKBM0dIUGvUXhXS+X mZ5mjdmZq88mMJmWVWA5p89JemzK3RtuaBRGp+gkbZHbaREJMnbGoAeQAanvcLxlc6lT Immw== X-Forwarded-Encrypted: i=1; AJvYcCU5Ma5N+uRbBZdJyA/1yL5PL8X7MneCOOo+oyZdIQUYoOR3E5dot4zjZWPpZJnD9bkJT881oAnfP6JxEP8=@vger.kernel.org, AJvYcCUF7xK0Stliw22aIUDK93NzOjKfx/84FecmVb50RXUTBYEmCYXdCKI/JXXOCWCFC+PouSngnqxoZQz4@vger.kernel.org, AJvYcCWl7pbP/p2cdd43GdesdrWuBe89p40HtPynUTKBJFHo6TWBsYWs9V1zRUXocGvcA64xncroBPj/A3lVV5E=@vger.kernel.org, AJvYcCWrAcjXLVxYxwXk3eRiLDwdJD6X386Naq3AP3m+MYk7bGcm9WapttY5XB1DovTkhGRGSXC+xdmO7aWm@vger.kernel.org, AJvYcCXH6mGVqxF+MZGVd8VmEK0BXo3DmgFbBrCnhSzvGeTZ+doJfSA/Wn+chzz0Cu1cEzseaBgXD43LoHFd@vger.kernel.org X-Gm-Message-State: AOJu0YxkctLEn78VgaRjG6jFK2zjRNW9EjCN3G7wWEAuX7fAIzhG63Ew quOhTRjSG9hks6nX9BWzQYfCJpORF989bfDBTVk2KSuSBqWaA7/JZTX0DJpb X-Gm-Gg: ASbGncus5v7OQ5DJqMkKk0Zt3L13utaK2g5wLJ8N1G+t+BMdQOMM6NZfiZv2PYPB5R0 CVsL+P88dgnCrrJJsOaEpr2BYgV1ZQdl22zYnnNiOuCo8U2vY6wVUN4UvVXyP/LSObokBOPN90y R0AR0qoLgxAWzP9V/ZL8MfmKgp5ZyBidmk0BrFRVuYqGWdwVZTU1UEKSimF6u3eYidCNVLz58N4 HX0ANaUvrflFeSA/B8wb9N8S50u0pvtoSoMUoUZS1hqwXTaIk9p7zp5lJ5uaZl/PtkM6K3P8pL/ cNX4cpSAZ1ZukmeMEU7ZiQH2sadf5uylPNFdFRooD46QBpDBev6jMCHu1ma9oPendVwIrT/k8Jt iXnN/zwFs4syKHZg+E3liqsKP7AksqOqv31JERaXl0e6lp7spimuVaeQbu31o5o94ycbRMdKvf9 i2q3IqKqsF1uu2XEN0P7qHK2mxzAFTSav6 X-Google-Smtp-Source: AGHT+IHVFoiXUIreKvxXRO3Krsynr7hhwOktTnYSxjgR2e504nGc/2IHEseX0AV0D31qm2NqO/HVXQ== X-Received: by 2002:a05:6000:26ce:b0:3b9:2960:bf3b with SMTP id ffacd0b85a97d-3b9edfbc9demr2001463f8f.50.1755177713341; Thu, 14 Aug 2025 06:21:53 -0700 (PDT) Received: from localhost.localdomain (lmontsouris-658-1-96-160.w81-250.abo.wanadoo.fr. [81.250.250.160]) by smtp.gmail.com with ESMTPSA id ffacd0b85a97d-3b79c3b9386sm50998831f8f.18.2025.08.14.06.21.52 (version=TLS1_3 cipher=TLS_AES_256_GCM_SHA384 bits=256/256); Thu, 14 Aug 2025 06:21:52 -0700 (PDT) From: Jihed Chaibi To: linux-kernel@vger.kernel.org Cc: andreas@kemnade.info, peter.ujfalusi@gmail.com, dmitry.torokhov@gmail.com, robh@kernel.org, krzk+dt@kernel.org, lgirdwood@gmail.com, tiwai@suse.com, conor+dt@kernel.org, lee@kernel.org, ukleinek@kernel.org, broonie@kernel.org, gregkh@linuxfoundation.org, linux-input@vger.kernel.org, devicetree@vger.kernel.org, linux-pwm@vger.kernel.org, linux-sound@vger.kernel.org, linux-usb@vger.kernel.org, shuah@kernel.org, jihed.chaibi.dev@gmail.com Subject: [PATCH v2 3/9] input: dt-bindings: ti,twl4030-keypad: convert to DT schema Date: Thu, 14 Aug 2025 15:21:23 +0200 Message-Id: <20250814132129.138943-4-jihed.chaibi.dev@gmail.com> X-Mailer: git-send-email 2.39.5 In-Reply-To: <20250814132129.138943-1-jihed.chaibi.dev@gmail.com> References: <20250814132129.138943-1-jihed.chaibi.dev@gmail.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" Convert the legacy TXT binding for the TWL4030 keypad module to the modern YAML DT schema format. This adds formal validation and improves documentation by inheriting from the matrix-keymap schema. Changes in v2: Simplified the description field by removing redundant '|' as it does not affect formatting in this context. Signed-off-by: Jihed Chaibi --- .../bindings/input/ti,twl4030-keypad.yaml | 44 +++++++++++++++++++ .../bindings/input/twl4030-keypad.txt | 27 ------------ 2 files changed, 44 insertions(+), 27 deletions(-) create mode 100644 Documentation/devicetree/bindings/input/ti,twl4030-keyp= ad.yaml delete mode 100644 Documentation/devicetree/bindings/input/twl4030-keypad.= txt diff --git a/Documentation/devicetree/bindings/input/ti,twl4030-keypad.yaml= b/Documentation/devicetree/bindings/input/ti,twl4030-keypad.yaml new file mode 100644 index 000000000..2efc88b89 --- /dev/null +++ b/Documentation/devicetree/bindings/input/ti,twl4030-keypad.yaml @@ -0,0 +1,44 @@ +# SPDX-License-Identifier: (GPL-2.0-only OR BSD-2-Clause) +%YAML 1.2 +--- +$id: http://devicetree.org/schemas/input/ti,twl4030-keypad.yaml# +$schema: http://devicetree.org/meta-schemas/core.yaml# + +title: Texas Instruments TWL4030-family Keypad Controller + +maintainers: + - Peter Ujfalusi + +description: + TWL4030's Keypad controller is used to interface a SoC with a matrix-type + keypad device. The keypad controller supports multiple row and column li= nes. + A key can be placed at each intersection of a unique row and a unique co= lumn. + The keypad controller can sense a key-press and key-release and report t= he + event using a interrupt to the cpu. + +allOf: + - $ref: matrix-keymap.yaml# + +properties: + compatible: + const: ti,twl4030-keypad + + interrupts: + maxItems: 1 + +required: + - compatible + - interrupts + - keypad,num-rows + - keypad,num-columns + +unevaluatedProperties: false + +examples: + - | + keypad { + compatible =3D "ti,twl4030-keypad"; + interrupts =3D <1>; + keypad,num-rows =3D <8>; + keypad,num-columns =3D <8>; + }; diff --git a/Documentation/devicetree/bindings/input/twl4030-keypad.txt b/D= ocumentation/devicetree/bindings/input/twl4030-keypad.txt deleted file mode 100644 index e4be2f76a..000000000 --- a/Documentation/devicetree/bindings/input/twl4030-keypad.txt +++ /dev/null @@ -1,27 +0,0 @@ -* TWL4030's Keypad Controller device tree bindings - -TWL4030's Keypad controller is used to interface a SoC with a matrix-type -keypad device. The keypad controller supports multiple row and column line= s. -A key can be placed at each intersection of a unique row and a unique colu= mn. -The keypad controller can sense a key-press and key-release and report the -event using a interrupt to the cpu. - -This binding is based on the matrix-keymap binding with the following -changes: - - * keypad,num-rows and keypad,num-columns are required. - -Required SoC Specific Properties: -- compatible: should be one of the following - - "ti,twl4030-keypad": For controllers compatible with twl4030 keypad - controller. -- interrupt: should be one of the following - - <1>: For controllers compatible with twl4030 keypad controller. - -Example: - twl_keypad: keypad { - compatible =3D "ti,twl4030-keypad"; - interrupts =3D <1>; - keypad,num-rows =3D <8>; - keypad,num-columns =3D <8>; - }; --=20 2.39.5 From nobody Sat Oct 4 15:55:22 2025 Received: from mail-wr1-f49.google.com (mail-wr1-f49.google.com [209.85.221.49]) (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 81E4A301023; Thu, 14 Aug 2025 13:21:57 +0000 (UTC) Authentication-Results: smtp.subspace.kernel.org; arc=none smtp.client-ip=209.85.221.49 ARC-Seal: i=1; a=rsa-sha256; d=subspace.kernel.org; s=arc-20240116; t=1755177719; cv=none; b=HoATa8bpw5wRNHiF9aFJ4LhfBmXnlYsVPVHXwyEhHK5DgFxULuNFf0m+2EoSJ2fasgnurwLzExkWcUyrUXQxSeMhKfB2n68KCk7Gwb8pTFU+GFojVqP8JUsqV76a5QZ75J5BmZbDckKdaHA7aXt0Zr+jkTeIe5LPiasGuj37qB8= ARC-Message-Signature: i=1; a=rsa-sha256; d=subspace.kernel.org; s=arc-20240116; t=1755177719; c=relaxed/simple; bh=+NSDll+hNxWRQ00a+/KSaxMfFkFtPTeDZ0v7kppqz7Y=; h=From:To:Cc:Subject:Date:Message-Id:In-Reply-To:References: MIME-Version; b=g4VVjnTU0WHzFPFooaWQwzjM/5vEnzrvdRf4/RxE4oOlbaDWRHuoG4eaHbe7BnTzsvZnWgNDj7FOj0wCz0Rv3QauzenAvzYWBaaPUSb5/tyi2gwmv5q9FUK5AtGeQCD3lMfYFgoft3eb4L1ZxB+6JkqkDTCWEvSGZdwNyIDFqPM= 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=FmqH3Ut1; arc=none smtp.client-ip=209.85.221.49 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="FmqH3Ut1" Received: by mail-wr1-f49.google.com with SMTP id ffacd0b85a97d-3b9edf0e4efso523965f8f.2; Thu, 14 Aug 2025 06:21:57 -0700 (PDT) DKIM-Signature: v=1; a=rsa-sha256; c=relaxed/relaxed; d=gmail.com; s=20230601; t=1755177715; x=1755782515; 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=rFntgdu7BGuuqufTBZF2uZX15xbuiq4/LkniuWTnia8=; b=FmqH3Ut1ItcOzL/cuMu4JppFPHIL/7QjCT8zc3XB1Npa4Y5tt3vQWjEQeliT/rp1kf CtAmMWRlZFFcI4Y/7H2MRIHpPGuYJTWjGLAoUodoZNK7DBjuQQZjXgbhcl1JRVPJwWGh noAxhnLvgmdI63WeeyEhXg4X9PCGq+FrzAyhs9qxjZy8lKK+pt51P4WibGMUEO4RWWGA 3T03EYbxyfz/puFwvltY+sNho4sFuZeUr+bfLRt2AaovHtI1S495NvzOYLVRPBP6oTIq +uwqru8mZ5Wp59hppzkEzrU/hgqb68pXhrO0nALVmzGX678VjOhUO/wJXIKbUMf8oVvl euJA== X-Google-DKIM-Signature: v=1; a=rsa-sha256; c=relaxed/relaxed; d=1e100.net; s=20230601; t=1755177715; x=1755782515; 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=rFntgdu7BGuuqufTBZF2uZX15xbuiq4/LkniuWTnia8=; b=UUR0smZfSJZvc1RrktjFERD1hUD56r7G2hGvv3peXdUusD5Gp6Df6I1UULgv0e4o29 3fr2aB0LRF1SjtzSkBXd1QdcltJzJRIEgymtg+5Uxf5RurVn7EwynS2pPBj/vSLNiWrU 4RmhUegNzbI96VKGycZlHCQDaZgtuxsoHLwzkbJZfBL2JU+zxSpydQw7bzv2OB+BPE2A 5E8isd0EQHPgtOF0onW0ZjpN4gTshs1jczduOkoQ8eQQvwTvrfJd9bAJzbV2kZMnKRjM LGOq2KhYzpQIpAI/lVakcpVf0l6ebLV2q4nmUu9yBD39kptMUWAtmNr7P8A+rTGdXgbf dkMw== X-Forwarded-Encrypted: i=1; AJvYcCVCywFQ1XrFbpHzr4DDzGWqXzz1Q4GVnoXFZSi64rB65g12II3RvTafGVulpSOOKddEAV0Uk8fYZEcX@vger.kernel.org, AJvYcCVVmHkEwb6VcpYXvfgCsWLkFwPTuN2s7P8/RMLfcHzTm+DssYXw96ezxiWbvtW+kvwaH/m06t4uKcVlPaw=@vger.kernel.org, AJvYcCVpwFqXi2dTatiLJAlodvMYE9VIPEPfVqUAbxHyZ+IQseVnhXvlRSTUKJpB/gqVVgbfQnv0r0RqATk0eJ0=@vger.kernel.org, AJvYcCXZzS7urNub1XhP99nelHK/IpmtoePJ2UKlm/cCnoU1zXWxGNkSpJZrH3zl0TfQU+ira3ThL8Qn1mqo@vger.kernel.org, AJvYcCXdIxAHyQtIrg8DG+kNTsaJaOJBoTljvlK7GLCVy6nA3QQXXNGLfUVARnt7IfeaZUIwll994Mc5rYV0@vger.kernel.org X-Gm-Message-State: AOJu0YyklYANSGr5VWWWkiHZVMu9RkfzdBU53qsdRlAuCPU7xekc6wJm kAe1AZEnuPQSusm6+JYwQ4kFDz5h02TKNW9MHXr49rFn4918pzTD5NbxVAJK X-Gm-Gg: ASbGnctvIG9PZ86+fsmNIHX7jTf9UzoGdDgks5yDHoHJP0+bhpah0zmNrxvUxGGcOBT /dOOX8OM6Jg5pchYCvwXUUQU4j7mM5ehS43hSJdN0dti4/sp6Nx526NbeftHdzi9a5opS5xfEgv iWWRDHg9KH4d5nYBGQA0As+O6ZVzVttQsBFm81Jm3cjUDE5PKsexX26pNk1SJ4DjJTMOuxfwHyJ SaSJucZ00iAGVyA8kbUoR/pGB9rUd+BcJL0i0uQMj1gxf1QT1X7fYC48UO9E8lGOiyqL37HIRPk DKe0gGog8XTWyyqN0pJokZ3hFn4Xv/pEtEGnu5gi5LpPkYRmS1qTDPq5MyDCJupFEVsptRSt9oy MpMOBwK1h0+SpmXxB6iHjVddAhldexpnDWDvbCUnaNzwgm4FURQk6HAdllv6/XLNQ/yYJ4Dwg3E 87aH60+EB1nv7FpJgMBr7R5A== X-Google-Smtp-Source: AGHT+IFO4PzPgSSV86iTyYC0NTzQfHea5OJvZ+Lhd7w31g2opoaACae5hmzYH0OXpgY32pQ+AvesXg== X-Received: by 2002:a05:6000:144f:b0:3b7:9ae1:eb9 with SMTP id ffacd0b85a97d-3ba50cc8e1emr2060413f8f.23.1755177715345; Thu, 14 Aug 2025 06:21:55 -0700 (PDT) Received: from localhost.localdomain (lmontsouris-658-1-96-160.w81-250.abo.wanadoo.fr. [81.250.250.160]) by smtp.gmail.com with ESMTPSA id ffacd0b85a97d-3b79c3b9386sm50998831f8f.18.2025.08.14.06.21.54 (version=TLS1_3 cipher=TLS_AES_256_GCM_SHA384 bits=256/256); Thu, 14 Aug 2025 06:21:54 -0700 (PDT) From: Jihed Chaibi To: linux-kernel@vger.kernel.org Cc: andreas@kemnade.info, peter.ujfalusi@gmail.com, dmitry.torokhov@gmail.com, robh@kernel.org, krzk+dt@kernel.org, lgirdwood@gmail.com, tiwai@suse.com, conor+dt@kernel.org, lee@kernel.org, ukleinek@kernel.org, broonie@kernel.org, gregkh@linuxfoundation.org, linux-input@vger.kernel.org, devicetree@vger.kernel.org, linux-pwm@vger.kernel.org, linux-sound@vger.kernel.org, linux-usb@vger.kernel.org, shuah@kernel.org, jihed.chaibi.dev@gmail.com Subject: [PATCH v2 4/9] mfd: dt-bindings: ti,twl4030-power: convert to DT schema Date: Thu, 14 Aug 2025 15:21:24 +0200 Message-Id: <20250814132129.138943-5-jihed.chaibi.dev@gmail.com> X-Mailer: git-send-email 2.39.5 In-Reply-To: <20250814132129.138943-1-jihed.chaibi.dev@gmail.com> References: <20250814132129.138943-1-jihed.chaibi.dev@gmail.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" Convert the legacy TXT binding for the TWL4030 power module to the modern YAML DT schema format. This adds formal validation and improves documentation. Changes in v2: Simplified the description field by removing redundant '|' as it does not affect formatting in this context. Signed-off-by: Jihed Chaibi --- .../bindings/mfd/ti,twl4030-power.yaml | 69 +++++++++++++++++++ .../devicetree/bindings/mfd/twl4030-power.txt | 48 ------------- 2 files changed, 69 insertions(+), 48 deletions(-) create mode 100644 Documentation/devicetree/bindings/mfd/ti,twl4030-power.= yaml delete mode 100644 Documentation/devicetree/bindings/mfd/twl4030-power.txt diff --git a/Documentation/devicetree/bindings/mfd/ti,twl4030-power.yaml b/= Documentation/devicetree/bindings/mfd/ti,twl4030-power.yaml new file mode 100644 index 000000000..713e2facf --- /dev/null +++ b/Documentation/devicetree/bindings/mfd/ti,twl4030-power.yaml @@ -0,0 +1,69 @@ +# SPDX-License-Identifier: (GPL-2.0-only OR BSD-2-Clause) +%YAML 1.2 +--- +$id: http://devicetree.org/schemas/mfd/ti,twl4030-power.yaml# +$schema: http://devicetree.org/meta-schemas/core.yaml# + +title: Texas Instruments TWL4030-family Power Management Module + +maintainers: + - Peter Ujfalusi + +description: + The power management module inside the TWL family provides several facil= ities + to control the power resources, including power scripts. For now, the + binding only supports the complete shutdown of the system after poweroff. + +properties: + compatible: + description: | + The compatible string determines the specific power configuration. + "ti,twl4030-power": Standard power control. + "ti,twl4030-power-reset": Recommended for OMAP3530 and similar SoCs + that require a special configuration for warm reset to work corr= ectly. + "ti,twl4030-power-idle": Loads the TI-recommended configuration for + idle modes into the PMIC. + "ti,twl4030-power-idle-osc-off": Uses the recommended idle configu= ration + but also shuts down the external oscillator. This may not work o= n all + boards depending on the oscillator wiring. + + enum: + - ti,twl4030-power + - ti,twl4030-power-reset + - ti,twl4030-power-idle + - ti,twl4030-power-idle-osc-off + + ti,system-power-controller: + type: boolean + description: + Indicates that the TWL4030 is the power supply master of the system, + allowing it to initiate system power-off. + + ti,use_poweroff: + type: boolean + description: Deprecated name for ti,system-power-controller. + deprecated: true + +required: + - compatible + +additionalProperties: false + +examples: + - | + i2c { + clock-frequency =3D <2600000>; + #address-cells =3D <1>; + #size-cells =3D <0>; + + twl: twl@48 { + reg =3D <0x48>; + interrupts =3D <7>; /* SYS_NIRQ cascaded to intc */ + interrupt-parent =3D <&intc>; + + twl_power: power { + compatible =3D "ti,twl4030-power"; + ti,use_poweroff; + }; + }; + }; diff --git a/Documentation/devicetree/bindings/mfd/twl4030-power.txt b/Docu= mentation/devicetree/bindings/mfd/twl4030-power.txt deleted file mode 100644 index 3d1996331..000000000 --- a/Documentation/devicetree/bindings/mfd/twl4030-power.txt +++ /dev/null @@ -1,48 +0,0 @@ -Texas Instruments TWL family (twl4030) reset and power management module - -The power management module inside the TWL family provides several facilit= ies -to control the power resources, including power scripts. For now, the -binding only supports the complete shutdown of the system after poweroff. - -Required properties: -- compatible : must be one of the following - "ti,twl4030-power" - "ti,twl4030-power-reset" - "ti,twl4030-power-idle" - "ti,twl4030-power-idle-osc-off" - -The use of ti,twl4030-power-reset is recommended at least on -3530 that needs a special configuration for warm reset to work. - -When using ti,twl4030-power-idle, the TI recommended configuration -for idle modes is loaded to the tlw4030 PMIC. - -When using ti,twl4030-power-idle-osc-off, the TI recommended -configuration is used with the external oscillator being shut -down during off-idle. Note that this does not work on all boards -depending on how the external oscillator is wired. - -Optional properties: - -- ti,system-power-controller: This indicates that TWL4030 is the - power supply master of the system. With this flag, the chip will - initiate an ACTIVE-to-OFF or SLEEP-to-OFF transition when the - system poweroffs. - -- ti,use_poweroff: Deprecated name for ti,system-power-controller - -Example: -&i2c1 { - clock-frequency =3D <2600000>; - - twl: twl@48 { - reg =3D <0x48>; - interrupts =3D <7>; /* SYS_NIRQ cascaded to intc */ - interrupt-parent =3D <&intc>; - - twl_power: power { - compatible =3D "ti,twl4030-power"; - ti,use_poweroff; - }; - }; -}; --=20 2.39.5 From nobody Sat Oct 4 15:55:22 2025 Received: from mail-wr1-f51.google.com (mail-wr1-f51.google.com [209.85.221.51]) (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 3407C30147F; Thu, 14 Aug 2025 13:21:59 +0000 (UTC) Authentication-Results: smtp.subspace.kernel.org; arc=none smtp.client-ip=209.85.221.51 ARC-Seal: i=1; a=rsa-sha256; d=subspace.kernel.org; s=arc-20240116; t=1755177720; cv=none; b=K5xFtvWJpAI2pCdLx/bYLtfjYCauzBYxaX3QVD8vL2S32cJUdVGV/nfpYsd+WK6q/tyPUAN7Dj74YiJ+mW93ukTqaxM+rIGtPYc+Zv4+tv+5hqxqXnIWdN+01HOu/GcP5dMnk6E2slME/TnLj/S57y3OtB/jh7szOBKO4a4cTd0= ARC-Message-Signature: i=1; a=rsa-sha256; d=subspace.kernel.org; s=arc-20240116; t=1755177720; c=relaxed/simple; bh=gY4ipD8wWPl1M6+6JrqYSWAvtJI6laAGzkb+xdQRfv8=; h=From:To:Cc:Subject:Date:Message-Id:In-Reply-To:References: MIME-Version; b=Seb8HXFfSy9ap/ZuHhHVLh9ph4BH9qaxmWBMG7flQ2BzammNoAFBOKa9nfAjLuEnEzgAVYXdQzz99uwaBJhchmbpmV+KpDcg7zJo6kJDdf3MyrEqRjsr0hpOJ1eVGqxLOSqNxCpr50g0iB6AjoGZ63xaIr0SsitwfO2prkjTqJ4= 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=OVvL8fbY; arc=none smtp.client-ip=209.85.221.51 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="OVvL8fbY" Received: by mail-wr1-f51.google.com with SMTP id ffacd0b85a97d-3b9dc52c430so469888f8f.0; Thu, 14 Aug 2025 06:21:58 -0700 (PDT) DKIM-Signature: v=1; a=rsa-sha256; c=relaxed/relaxed; d=gmail.com; s=20230601; t=1755177717; x=1755782517; 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=r3zYiSbWa/8gFr74O4y8591kMrUTTGd8r0VSLaU0hTQ=; b=OVvL8fbYouASrLKughJOCG+NzzVNUpzU7nRe4l35JXC6onUsyYGZAynjdpnXlvB0Zt eyg2zu3/WUjrp7kEY2BoZEOiua6HtXvnH2qdschVuMmicdwah5OOIt89QFA0c4ZQPmC2 hDggnoZi34Ug1XqGJjNGP0yvGs61i/IyWGD0gBMYSkyOj5ULzbVQLkpwxpSjhILW6DfY 2X1XKL4K2oZxp/IHAnz/mKpO2ZBUsjKGf9iBrCeRxMEGT3b/MZcfrxX3HdaA8FIgQV1k gvWasw3Z2vtVTlFGdHtgcy+0d14lsW51R3AmUtpI8YsTjQhTbCI3NqwZIgxFeD7N4+3W i/Xg== X-Google-DKIM-Signature: v=1; a=rsa-sha256; c=relaxed/relaxed; d=1e100.net; s=20230601; t=1755177717; x=1755782517; 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=r3zYiSbWa/8gFr74O4y8591kMrUTTGd8r0VSLaU0hTQ=; b=ssR7yrktRICgKtbFxTodxJ9Cv2244gDdO/NhGQzKHNpIz9KISAvFgJnaFMXD8pmLZH uu2d8PTO+fmrB2RnVd034NYUcF2av4FbEUvCHg+wHBOxZPWzK8fFWtjuLga4nLGkFnht fQWdYf0WMqeSIeYYiYJzV6T34PTr34+ovhaqNSRCgrCEHASKVJeSHc3ituPfir6qzK1X K5KfrjNKm5HOGomz8srrE1g/cunn3KYJqxB+9eoazkmedRaf976+kMg8Vl52rvTDwMHq lqFsCuKAtVY/XMlQ5V40N4u3gMBFDu+EpTDViCFUwX6S2kX+WoSLpNp91StiKUI5N/SB D9eQ== X-Forwarded-Encrypted: i=1; AJvYcCUDHtdIJJbPSPue816isfPD1mE4oLx6X9EO3BaAM69z+aILVSqAgxzwtfmwB9rV/8xTkcgD9bhnnFiLUJE=@vger.kernel.org, AJvYcCWBKhodPBHofqo9GwW7vZY4EEJPrFfp2OYwwk8A/VnmO2esEQ5p7mTUc6+kT+fDZ086DH3jRo9yfaLq@vger.kernel.org, AJvYcCWS7JYcWQh9dpHYjUh3mT4f8DGx6k1QUfvfCJ2JJSmOgtQJbSLmGVqKvIhjzBFPWD49zXZX7pC11MXD@vger.kernel.org, AJvYcCXOlKHk7zKwgJ3KKq3vGcW8yVrmg5zuhJvggrgn3EKrE3mUs1Wgyyd5Zk19ZMZcfnQHGY3rMa4sPSw0VY8=@vger.kernel.org, AJvYcCXQw+ytoflnjvjtanHL+rBtSB5OlJ1eg+1QPRaccMoNXfyRmpd0LKDyXLQs+9QpaeYMT9KwIpjdYskz@vger.kernel.org X-Gm-Message-State: AOJu0YxsUXWTSQp7bbxPsv7uryeQxWWUX5MELzmRFw5drx064rlVb59v WHFwIdqH8j/wmk+IsMjKsJ/B97RusBN/5KPeV3GoY3KEuF4qyOv3/0hkjvuZ X-Gm-Gg: ASbGnctWmi2yY+SQDHmjysNoZtuDrpay363GfS/FvCUdfqvz+cc8LnMgEkBkGBdhdsG iS1AQOne+kRcLIyNRx+rnltFFK49XlQHXhyZGiTvr0VaSa7h7LRNquFnwR0BJFBfihCRpURD0Y0 9ymVZPb+jRDdEPLMOEeD7LECFHmP3Qh8RxZSLjpaFehBZWxfqV9hC6wmrqYbv0VZxXE9B+U0M+0 s3WMPecZUOPCFPa1i+IoWUOCHYL9T1B/ZQRdzgzU6NaGDg7EicPMrfJwYVmp25hx32ltz4vWetz FKqjPBDhGjdbWZNUzDvJh7c5SteY0TStL0i9NXeUMu0oMEqg84Zyz/4wJv01/HiKp4nC7ZvQkMR ETnxZA0rA8MNLlgQzDMLUtPwhFP9aoYTEGyvX3HUVQwU54N+LXAV2hbWohtlyBEWhe7LS/spWcq YnzuYJEUpqPngsCLCs5sN/4w== X-Google-Smtp-Source: AGHT+IHgGhFs8cSuMf4qweZoF+v6DINXFMJXX2lXCahskB/Rjoe0LzYw/gxXtHKVqO38o+C4nZ0+Qg== X-Received: by 2002:a05:6000:40c9:b0:3b7:905e:2a32 with SMTP id ffacd0b85a97d-3ba50c8e0a4mr2109502f8f.12.1755177717177; Thu, 14 Aug 2025 06:21:57 -0700 (PDT) Received: from localhost.localdomain (lmontsouris-658-1-96-160.w81-250.abo.wanadoo.fr. [81.250.250.160]) by smtp.gmail.com with ESMTPSA id ffacd0b85a97d-3b79c3b9386sm50998831f8f.18.2025.08.14.06.21.56 (version=TLS1_3 cipher=TLS_AES_256_GCM_SHA384 bits=256/256); Thu, 14 Aug 2025 06:21:56 -0700 (PDT) From: Jihed Chaibi To: linux-kernel@vger.kernel.org Cc: andreas@kemnade.info, peter.ujfalusi@gmail.com, dmitry.torokhov@gmail.com, robh@kernel.org, krzk+dt@kernel.org, lgirdwood@gmail.com, tiwai@suse.com, conor+dt@kernel.org, lee@kernel.org, ukleinek@kernel.org, broonie@kernel.org, gregkh@linuxfoundation.org, linux-input@vger.kernel.org, devicetree@vger.kernel.org, linux-pwm@vger.kernel.org, linux-sound@vger.kernel.org, linux-usb@vger.kernel.org, shuah@kernel.org, jihed.chaibi.dev@gmail.com Subject: [PATCH v2 5/9] pwm: dt-bindings: ti,twl-pwm: convert to DT schema Date: Thu, 14 Aug 2025 15:21:25 +0200 Message-Id: <20250814132129.138943-6-jihed.chaibi.dev@gmail.com> X-Mailer: git-send-email 2.39.5 In-Reply-To: <20250814132129.138943-1-jihed.chaibi.dev@gmail.com> References: <20250814132129.138943-1-jihed.chaibi.dev@gmail.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" Convert the legacy TXT binding for the TWL-family PWM controller to the modern YAML DT schema format. This adds formal validation and improves documentation by inheriting from the base pwm schema. Signed-off-by: Jihed Chaibi --- .../devicetree/bindings/pwm/ti,twl-pwm.txt | 17 ------- .../devicetree/bindings/pwm/ti,twl-pwm.yaml | 46 +++++++++++++++++++ 2 files changed, 46 insertions(+), 17 deletions(-) delete mode 100644 Documentation/devicetree/bindings/pwm/ti,twl-pwm.txt create mode 100644 Documentation/devicetree/bindings/pwm/ti,twl-pwm.yaml diff --git a/Documentation/devicetree/bindings/pwm/ti,twl-pwm.txt b/Documen= tation/devicetree/bindings/pwm/ti,twl-pwm.txt deleted file mode 100644 index d97ca1964..000000000 --- a/Documentation/devicetree/bindings/pwm/ti,twl-pwm.txt +++ /dev/null @@ -1,17 +0,0 @@ -Texas Instruments TWL series PWM drivers - -Supported PWMs: -On TWL4030 series: PWM1 and PWM2 -On TWL6030 series: PWM0 and PWM1 - -Required properties: -- compatible: "ti,twl4030-pwm" or "ti,twl6030-pwm" -- #pwm-cells: should be 2. See pwm.yaml in this directory for a descriptio= n of - the cells format. - -Example: - -twl_pwm: pwm { - compatible =3D "ti,twl6030-pwm"; - #pwm-cells =3D <2>; -}; diff --git a/Documentation/devicetree/bindings/pwm/ti,twl-pwm.yaml b/Docume= ntation/devicetree/bindings/pwm/ti,twl-pwm.yaml new file mode 100644 index 000000000..5bbbdc13a --- /dev/null +++ b/Documentation/devicetree/bindings/pwm/ti,twl-pwm.yaml @@ -0,0 +1,46 @@ +# SPDX-License-Identifier: (GPL-2.0-only OR BSD-2-Clause) +%YAML 1.2 +--- +$id: http://devicetree.org/schemas/pwm/ti,twl-pwm.yaml# +$schema: http://devicetree.org/meta-schemas/core.yaml# + +title: Texas Instruments TWL4030/TWL6030 family PWM controller + +maintainers: + - Peter Ujfalusi + +description: | + Bindings for the following PWM controllers : + TWL4030 series: PWMA and PWMB (connected to LEDA and LEDB terminals) + TWL6030 series: LED PWM (mainly used as charging indicator LED) + +allOf: + - $ref: /schemas/pwm/pwm.yaml# + +properties: + compatible: + enum: + - ti,twl4030-pwm + - ti,twl6030-pwm + + '#pwm-cells': + const: 2 + +required: + - compatible + - '#pwm-cells' + +unevaluatedProperties: false + +examples: + - | + pwm { + compatible =3D "ti,twl4030-pwm"; + #pwm-cells =3D <2>; + }; + + - | + pwm { + compatible =3D "ti,twl6030-pwm"; + #pwm-cells =3D <2>; + }; --=20 2.39.5 From nobody Sat Oct 4 15:55:22 2025 Received: from mail-wr1-f45.google.com (mail-wr1-f45.google.com [209.85.221.45]) (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 4E0943019CE; Thu, 14 Aug 2025 13:22:01 +0000 (UTC) Authentication-Results: smtp.subspace.kernel.org; arc=none smtp.client-ip=209.85.221.45 ARC-Seal: i=1; a=rsa-sha256; d=subspace.kernel.org; s=arc-20240116; t=1755177723; cv=none; b=oNeo16QrfsAgujZJPN1wk3qfUuG96EeE+Y6Q6lFK3YB7YF5ELJnkqsV9E93FSW4XXbkUcjOIoNcF9MtdoX9OD/cYsAGa9kjYrvwAT0YwGbTK/U6jLbQ8xcjEqIlzmfKRdfaF0q9egJ9IPn2o0miU54nwHSSeMt0z7GgEuRhg5i4= ARC-Message-Signature: i=1; a=rsa-sha256; d=subspace.kernel.org; s=arc-20240116; t=1755177723; c=relaxed/simple; bh=Rnl8w+SH/nw2JPdcQ0erKjjymCdj0uvkgeVYoBTMisA=; h=From:To:Cc:Subject:Date:Message-Id:In-Reply-To:References: MIME-Version; b=G7ahw0G4mLvbI1hbviK0He+/9VEFe0XPunyYYvZvcFzN9n2eMOslvWOjlaHMa1E0dqOFdp5aaGCxmFV4699E3CF9wPyWDPtx14atF7yhrrOS4Rby5Yz/J5Tzzm5InMbGrsVPjJWxDvTKf7UgW+jH4JlW6Yf65uKmSv6IvjS3slo= 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=ZhvErttA; arc=none smtp.client-ip=209.85.221.45 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="ZhvErttA" Received: by mail-wr1-f45.google.com with SMTP id ffacd0b85a97d-3b9dc52c430so469899f8f.0; Thu, 14 Aug 2025 06:22:00 -0700 (PDT) DKIM-Signature: v=1; a=rsa-sha256; c=relaxed/relaxed; d=gmail.com; s=20230601; t=1755177719; x=1755782519; 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=BT6KB9uJF//5o0bC4Hfp3voC6koE6Q4zGOMWpbC4QzA=; b=ZhvErttAPheMOkpjI9Uowq3OvyX97GMUZP1ZeTC0i2zYsUs+qsPlbhP+EemHElsjLz 5lWaZrSXMIo/7ETnm/8Tjm9+aeSBzBCzOMou7F+JTHQLZClVi4Asr/4T7zVLDP9KOP4g ge7TBXjkuv3QUeVB2qKX5MnK5hXvB3uuTjiOmwYhakk9bT9K9f5GUppKynWDzlzitaBN 2h92vn/60tV7BLaXvn4LaAqJ1Nq05Mr90pydWUO4e+rj7dR8Bj4UHUmLdPPWWlseReRT X8r6zfdIBsT+ZfNWQwlxf/QvzggMe4FIXPbVaGPVvDSejJJozxNpzjrGEVJpAaE0xQHE 4xJA== X-Google-DKIM-Signature: v=1; a=rsa-sha256; c=relaxed/relaxed; d=1e100.net; s=20230601; t=1755177719; x=1755782519; 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=BT6KB9uJF//5o0bC4Hfp3voC6koE6Q4zGOMWpbC4QzA=; b=FgoG1xyQXdF8GkdFa6g8/XlIVllSbQcF40F7w4wyiWWKPDgHtuNevHR759l4Lm2cJ/ HNn1AOuiePQqbBoz0oqhF/x9Nr2lgCzyonPxg5AaUpyjVNIb85pY5YT2xXdGCKFXxMs6 jxoDbzM+PB0AemAVLJKHcpBlDD1vC/Llz+zjFfTYHGMCTF3DGqP/NsB8ywW9f9HxpDxy oTDPLMPABmVItlW9ei5GKIf/mZhRqI3AY+GNfbxJTS2GLILku/ZL4xYKkHRLTJpD6p6T A7/YOeDb2upzGk4wVvYZGzLKOMnPdGRA0smHawR5jFst/6d/McL1Jk5AB1rFcCjwwHvj oFtw== X-Forwarded-Encrypted: i=1; AJvYcCUWOJKcE+1+0SAg0YVKRagFvxahnY+Qoj1+7fmI0EyYWmeuvGi38+YvMQbb0ZJRWNh6KZFCtYlXuhNTk1Y=@vger.kernel.org, AJvYcCVWCBuyQrSQv4NyXwb+tXMA5qYii3aN2hNtFb3NcIlqIPcL0NTIxHYhbNGzzuBJ26vz1YEcZnk3zFtD@vger.kernel.org, AJvYcCWqifmulKsfGzlZ+2knAOoArRRp6luBIkZgLvCsNyUZlDhecDPiIYAfQNnwKx5SqdPdXml9YMLiZmBF@vger.kernel.org, AJvYcCX/8Us2mRD/VUUWs2D+KxSM7dFByYYDsx/+kC85th74+dREerd5cWJTsbBzUiS9A/BSQ+f66tk+t17n@vger.kernel.org, AJvYcCXzS/xHi+OfP9yA0ZTAL8mg5+SrTtry5O+9jmrownOJLamkmfe5bI/Yi73lDIDRip3eGWlos+/jUrgeW6M=@vger.kernel.org X-Gm-Message-State: AOJu0YxMuW1+JvwbrTpRtuBsXTaK4X/0tN+wi9wpc6rshwD0BOhH7cl+ pyd9X9QB1hD7eLgWCzELZwTnVFg1x6iKeHd9d9w0fECaMipUywiECyWeJyFj X-Gm-Gg: ASbGncsmwReiT2gk+JR30nJ+FAJX/JufzrRPhJKMANFjRQ0U2EuwqV5GiUGEsk7y21V AEmedx5aS1WmezLMMZH4xlsQSfNmQcxXdAEkl2EXCu/uhU6bLm6jHXELx5FMpBly9MRWnkrphW2 o0AJQHPP6+mEFN/YRALqhEqC+YavZs58eOhapBKryqfMYaCO5fht2pwuigYBrTshol61cEilN7p bg1HPIdMeI601vGa0u3ztJhbjM0Iiaqai7fl1QbuNs4+L0ZzvIw6eQf3A8MJwgEW+eqKZHwWQTz 5ngWKk3V0w5DmLKUUW/DQgt2YO0vViQoqx9Yny0n09LUdhALmzFfl27P/OGO6LvT2qPh7XdgIKz NSPrnZ19ULoQsOAS6PRKXZNbNkF+VmeF2Ww1Aw6fseitSVwtyDPEIm7xMrRm8TR08NB0/S2ixLZ qmvQmTYwiSnlhT+j57Mj9c4A== X-Google-Smtp-Source: AGHT+IG4bFMPBZfDJuCxmQMh7yt7kKJurWok08IzwpwnCbwB4739ifTjCd73R1fEe04W6bs6xOZ3bg== X-Received: by 2002:a05:6000:430b:b0:3b9:6e:5242 with SMTP id ffacd0b85a97d-3ba50c8ed1emr2223388f8f.4.1755177719127; Thu, 14 Aug 2025 06:21:59 -0700 (PDT) Received: from localhost.localdomain (lmontsouris-658-1-96-160.w81-250.abo.wanadoo.fr. [81.250.250.160]) by smtp.gmail.com with ESMTPSA id ffacd0b85a97d-3b79c3b9386sm50998831f8f.18.2025.08.14.06.21.58 (version=TLS1_3 cipher=TLS_AES_256_GCM_SHA384 bits=256/256); Thu, 14 Aug 2025 06:21:58 -0700 (PDT) From: Jihed Chaibi To: linux-kernel@vger.kernel.org Cc: andreas@kemnade.info, peter.ujfalusi@gmail.com, dmitry.torokhov@gmail.com, robh@kernel.org, krzk+dt@kernel.org, lgirdwood@gmail.com, tiwai@suse.com, conor+dt@kernel.org, lee@kernel.org, ukleinek@kernel.org, broonie@kernel.org, gregkh@linuxfoundation.org, linux-input@vger.kernel.org, devicetree@vger.kernel.org, linux-pwm@vger.kernel.org, linux-sound@vger.kernel.org, linux-usb@vger.kernel.org, shuah@kernel.org, jihed.chaibi.dev@gmail.com Subject: [PATCH v2 6/9] pwm: dt-bindings: ti,twl-pwmled: convert to DT schema Date: Thu, 14 Aug 2025 15:21:26 +0200 Message-Id: <20250814132129.138943-7-jihed.chaibi.dev@gmail.com> X-Mailer: git-send-email 2.39.5 In-Reply-To: <20250814132129.138943-1-jihed.chaibi.dev@gmail.com> References: <20250814132129.138943-1-jihed.chaibi.dev@gmail.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" Convert the legacy TXT binding for the TWL-family PWMLED controller to the modern YAML DT schema format. This adds formal validation and improves documentation by inheriting from the base pwm schema. Signed-off-by: Jihed Chaibi --- .../devicetree/bindings/pwm/ti,twl-pwmled.txt | 17 ------- .../bindings/pwm/ti,twl-pwmled.yaml | 46 +++++++++++++++++++ 2 files changed, 46 insertions(+), 17 deletions(-) delete mode 100644 Documentation/devicetree/bindings/pwm/ti,twl-pwmled.txt create mode 100644 Documentation/devicetree/bindings/pwm/ti,twl-pwmled.yaml diff --git a/Documentation/devicetree/bindings/pwm/ti,twl-pwmled.txt b/Docu= mentation/devicetree/bindings/pwm/ti,twl-pwmled.txt deleted file mode 100644 index 31ca1b032..000000000 --- a/Documentation/devicetree/bindings/pwm/ti,twl-pwmled.txt +++ /dev/null @@ -1,17 +0,0 @@ -Texas Instruments TWL series PWM drivers connected to LED terminals - -Supported PWMs: -On TWL4030 series: PWMA and PWMB (connected to LEDA and LEDB terminals) -On TWL6030 series: LED PWM (mainly used as charging indicator LED) - -Required properties: -- compatible: "ti,twl4030-pwmled" or "ti,twl6030-pwmled" -- #pwm-cells: should be 2. See pwm.yaml in this directory for a descriptio= n of - the cells format. - -Example: - -twl_pwmled: pwmled { - compatible =3D "ti,twl6030-pwmled"; - #pwm-cells =3D <2>; -}; diff --git a/Documentation/devicetree/bindings/pwm/ti,twl-pwmled.yaml b/Doc= umentation/devicetree/bindings/pwm/ti,twl-pwmled.yaml new file mode 100644 index 000000000..411cc4c8c --- /dev/null +++ b/Documentation/devicetree/bindings/pwm/ti,twl-pwmled.yaml @@ -0,0 +1,46 @@ +# SPDX-License-Identifier: (GPL-2.0-only OR BSD-2-Clause) +%YAML 1.2 +--- +$id: http://devicetree.org/schemas/pwm/ti,twl-pwmled.yaml# +$schema: http://devicetree.org/meta-schemas/core.yaml# + +title: Texas Instruments TWL4030/TWL6030 family PWM LED controller + +maintainers: + - Peter Ujfalusi + +description: | + Bindings for the following PWM controllers : + TWL4030 series: PWMA and PWMB (connected to LEDA and LEDB terminals) + TWL6030 series: LED PWM (mainly used as charging indicator LED) + +allOf: + - $ref: /schemas/pwm/pwm.yaml# + +properties: + compatible: + enum: + - ti,twl4030-pwmled + - ti,twl6030-pwmled + + '#pwm-cells': + const: 2 + +required: + - compatible + - '#pwm-cells' + +unevaluatedProperties: false + +examples: + - | + pwm { + compatible =3D "ti,twl4030-pwmled"; + #pwm-cells =3D <2>; + }; + + - | + pwm { + compatible =3D "ti,twl6030-pwmled"; + #pwm-cells =3D <2>; + }; --=20 2.39.5 From nobody Sat Oct 4 15:55:22 2025 Received: from mail-wm1-f53.google.com (mail-wm1-f53.google.com [209.85.128.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 5DEBD302773; Thu, 14 Aug 2025 13:22:03 +0000 (UTC) Authentication-Results: smtp.subspace.kernel.org; arc=none smtp.client-ip=209.85.128.53 ARC-Seal: i=1; a=rsa-sha256; d=subspace.kernel.org; s=arc-20240116; t=1755177725; cv=none; b=m6RsQGn52jqdbVd3BCWwP4Owj3zmq86EOlxRld9RaFqtX8fz2wy7Nqg/MVKLN8GSzOzM01TF/5UU3VlblnsLB3YzhZiMcwKEwVIckxpdRn+Y7oiX4ClmkKMWlFOslL50bM8Zh5hAh5nPNCe5uIucWXY54ahFJVWQdTRO/ldqMpE= ARC-Message-Signature: i=1; a=rsa-sha256; d=subspace.kernel.org; s=arc-20240116; t=1755177725; c=relaxed/simple; bh=jqnXnZp7RhpL1YMBGZScNoAkw+LmKGjT5H9FKCka2hw=; h=From:To:Cc:Subject:Date:Message-Id:In-Reply-To:References: MIME-Version; b=ITqT8mwt/Jonk/HRFBtbHcGhbIpisiEy+RU+NnpkqbFCx8CztBJz3qyhLxhlDsz+cg6WK0zgKghYMbe9EFsWLfqvRLlT9dLE88RW1LdJ2QFTA/M3Eyqo87pxNCytdcikmJShJmTgIygj2wu0Gd9JyvTfiTUBDj+uowEwNkoQ5hA= 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=Wj0AGD4l; arc=none smtp.client-ip=209.85.128.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="Wj0AGD4l" Received: by mail-wm1-f53.google.com with SMTP id 5b1f17b1804b1-45a1b0d231eso5124035e9.3; Thu, 14 Aug 2025 06:22:03 -0700 (PDT) DKIM-Signature: v=1; a=rsa-sha256; c=relaxed/relaxed; d=gmail.com; s=20230601; t=1755177721; x=1755782521; 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=FMz0z0NTwoZNKGW97tiHCixZ/UdB6VOtCFJYznUWSlI=; b=Wj0AGD4lyKn45YgYVpTvrUK6/MrusNG8GvH+5BALBqtQEDFCWzfg1CX4f6fhH32q98 qeGAIWmtBrsynn1nT9NmGO0nRyJA9EOJVwEjmpxCLTZ27PIaCzzfS3NT3lCXuAPtNcwz 5Uohl5hojHTgrZO+XtGAqt6LlU5PdwI1EcF9asp40IiCbS8y/4mi/FYgfyDL75nuaCjM y23hJypIaWdYWP1nxMpYD1WrLFcCjJCF2YD2/E9rQ8cUC6gmn05JyBJxr+wrjyKZT7qM 3Aa4cqSv5MBrFbXuhqVAm9c3fXjhQRHwdyrBvHx/tkfImiguegw/zMUsf6oG+NUPf8rh hSoA== X-Google-DKIM-Signature: v=1; a=rsa-sha256; c=relaxed/relaxed; d=1e100.net; s=20230601; t=1755177721; x=1755782521; 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=FMz0z0NTwoZNKGW97tiHCixZ/UdB6VOtCFJYznUWSlI=; b=Aib/3GClHXYHQK2fRALxvOmJ+0I9OE1hM8r41pcYQzHMrM+GfLaUPd4dMi/MR4ex1m Wr8EUFyZR+RUQaxyudxauaMGIBpISc5XXjq36xTsc5SAh9u6aYOsOXTRGOfiAkEqNdLh mmH+h325irF7l0/95G0mo0HfwZ6CLipfOODgUE7EpKCP4eTEKasnMLrbfUMsKqB0lSDE 4EBC0/0PWTxsVZG89IAoyCIkiw+tyw/43yB15UxucnzE9xnDq294JOFPWx+kIQGwxw6+ yHQWgzjJuBaDG6cdDXEaduG0K/LvMtrlBpD+v3UhutDw4FA4pFWxtVmXmodsQvTQBSb8 FkdQ== X-Forwarded-Encrypted: i=1; AJvYcCVFupDUrXs5WsImSsDBmIIkXc6kuM7H6xHPjZzVQsSCrGKGLlMKrwqClFwLdNi8GGCGSYSnF7MVBgEFqUg=@vger.kernel.org, AJvYcCWT0dMcb0oPgQ4RKKyBGqYHkhNRzb/pElj2BUOBisGUwasBxt9GiyXhLpDYnewmoWatJuZt6i9ZScLJ@vger.kernel.org, AJvYcCXU4lwt1rvfn+1H8dvNLLUEd0wpDxXfrDjD2A4NTqh5ntsRyuuC9yezEb8MYIvdQ9dXvm6N4b6yJS2p@vger.kernel.org, AJvYcCXl3WGGjLszSBhXPMq8XwiVWkQZ7AYNOIz03jrfY0onB1Jl2Ww9vQgEd0dlA1G8/yDqhMTgpBUbavOVDyo=@vger.kernel.org, AJvYcCXlA4cV3yR4c87Y7z3DmFlQ8X4awuRmV/jllEpnYbrbqJxUAJ5rPMIcoXMUvIYIcU8qE2h+hNjDnttg@vger.kernel.org X-Gm-Message-State: AOJu0YzKjOsi8y993u+7e/AishprKgE0CKT6Uizh6aFh8ankmTwxppl3 ZryqMmJ7ylG/kHe8Oy224i5RDU9LN0HdkYu+Xe7xFV3kPxFcBsog6gf9dmHT X-Gm-Gg: ASbGncsVhYh0qjI6L8oOdR3wgMKhfO8WUg7JECAlf4q+cmI3l35lUfdLGo8pCZyk+Wa nCLfKsAqkWSyr9tk9deWZj7/QJqknQ26YkWh1bRh0bjCCqk8fbeYI0hPEQbhzNjs4pioxgL5rK7 T7d/rQjE4Ov6MWSbsHbTmb9lkfFHB/Imt+ZF9zFiyeNtYLsbMQnhACKd/QuDL35q6yVO2kPqZjx +aasxc4CzVBaa86b1r7gJ1PwWHDUdPnNlnXWSmMb8JJmDvEWet2daCDqkvR+YwUduKWHmoqWTtP +1QyeX6XZdjpt85jW10ruh8P6uQTW2A5GywS785MFFym/L0qcgO959cgwyd9vbTomwMhrw6r6ed jgDGKqY7hyd5LvbNQwrK+0758Hm1ehp+TEkmz8KWtLlvOVzPY6b6mmJkY/3c7D4sF0hceJ8F2Th srRpSDHOhEDP5p/TxQdllvink995c4QkZP X-Google-Smtp-Source: AGHT+IEhoPp/GvoE0/G8qvem1zpvto20Ky61lY0ZUidud4Xnsxob/d04gPyLQTwmNSdaWYCSyuFzQg== X-Received: by 2002:a05:600c:8b62:b0:456:1560:7c5f with SMTP id 5b1f17b1804b1-45a1ce34c75mr19212705e9.14.1755177721062; Thu, 14 Aug 2025 06:22:01 -0700 (PDT) Received: from localhost.localdomain (lmontsouris-658-1-96-160.w81-250.abo.wanadoo.fr. [81.250.250.160]) by smtp.gmail.com with ESMTPSA id ffacd0b85a97d-3b79c3b9386sm50998831f8f.18.2025.08.14.06.22.00 (version=TLS1_3 cipher=TLS_AES_256_GCM_SHA384 bits=256/256); Thu, 14 Aug 2025 06:22:00 -0700 (PDT) From: Jihed Chaibi To: linux-kernel@vger.kernel.org Cc: andreas@kemnade.info, peter.ujfalusi@gmail.com, dmitry.torokhov@gmail.com, robh@kernel.org, krzk+dt@kernel.org, lgirdwood@gmail.com, tiwai@suse.com, conor+dt@kernel.org, lee@kernel.org, ukleinek@kernel.org, broonie@kernel.org, gregkh@linuxfoundation.org, linux-input@vger.kernel.org, devicetree@vger.kernel.org, linux-pwm@vger.kernel.org, linux-sound@vger.kernel.org, linux-usb@vger.kernel.org, shuah@kernel.org, jihed.chaibi.dev@gmail.com Subject: [PATCH v2 7/9] Documentation: omap-twl4030: convert to DT schema Date: Thu, 14 Aug 2025 15:21:27 +0200 Message-Id: <20250814132129.138943-8-jihed.chaibi.dev@gmail.com> X-Mailer: git-send-email 2.39.5 In-Reply-To: <20250814132129.138943-1-jihed.chaibi.dev@gmail.com> References: <20250814132129.138943-1-jihed.chaibi.dev@gmail.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" Convert the legacy TXT binding for the OMAP TWL4030 sound card to the modern YAML DT schema format. This adds formal validation and improves documentation. Changes in v2: - Fixed comment formatting (added spaces for better alignment). - Updated commit subject to align with subsystem style. - Retained Acked-by from v1 as changes are cosmetic. Acked-by: Mark Brown Signed-off-by: Jihed Chaibi --- .../bindings/sound/omap-twl4030.txt | 62 ----------- .../bindings/sound/ti,omap-twl4030.yaml | 102 ++++++++++++++++++ 2 files changed, 102 insertions(+), 62 deletions(-) delete mode 100644 Documentation/devicetree/bindings/sound/omap-twl4030.txt create mode 100644 Documentation/devicetree/bindings/sound/ti,omap-twl4030= .yaml diff --git a/Documentation/devicetree/bindings/sound/omap-twl4030.txt b/Doc= umentation/devicetree/bindings/sound/omap-twl4030.txt deleted file mode 100644 index f6a715e4e..000000000 --- a/Documentation/devicetree/bindings/sound/omap-twl4030.txt +++ /dev/null @@ -1,62 +0,0 @@ -* Texas Instruments SoC with twl4030 based audio setups - -Required properties: -- compatible: "ti,omap-twl4030" -- ti,model: Name of the sound card (for example "omap3beagle") -- ti,mcbsp: phandle for the McBSP node - -Optional properties: -- ti,codec: phandle for the twl4030 audio node -- ti,mcbsp-voice: phandle for the McBSP node connected to the voice port o= f twl -- ti, jack-det-gpio: Jack detect GPIO -- ti,audio-routing: List of connections between audio components. - Each entry is a pair of strings, the first being the connection's sink, - the second being the connection's source. - If the routing is not provided all possible connection will be available - -Available audio endpoints for the audio-routing table: - -Board connectors: - * Headset Stereophone - * Earpiece Spk - * Handsfree Spk - * Ext Spk - * Main Mic - * Sub Mic - * Headset Mic - * Carkit Mic - * Digital0 Mic - * Digital1 Mic - * Line In - -twl4030 pins: - * HSOL - * HSOR - * EARPIECE - * HFL - * HFR - * PREDRIVEL - * PREDRIVER - * CARKITL - * CARKITR - * MAINMIC - * SUBMIC - * HSMIC - * DIGIMIC0 - * DIGIMIC1 - * CARKITMIC - * AUXL - * AUXR - - * Headset Mic Bias - * Mic Bias 1 /* Used for Main Mic or Digimic0 */ - * Mic Bias 2 /* Used for Sub Mic or Digimic1 */ - -Example: - -sound { - compatible =3D "ti,omap-twl4030"; - ti,model =3D "omap3beagle"; - - ti,mcbsp =3D <&mcbsp2>; -}; diff --git a/Documentation/devicetree/bindings/sound/ti,omap-twl4030.yaml b= /Documentation/devicetree/bindings/sound/ti,omap-twl4030.yaml new file mode 100644 index 000000000..7c9371860 --- /dev/null +++ b/Documentation/devicetree/bindings/sound/ti,omap-twl4030.yaml @@ -0,0 +1,102 @@ +# SPDX-License-Identifier: GPL-2.0-only OR BSD-2-Clause +%YAML 1.2 +--- +$id: http://devicetree.org/schemas/sound/ti,omap-twl4030.yaml# +$schema: http://devicetree.org/meta-schemas/core.yaml# + +title: Texas Instruments SoC with twl4030 based audio setups + +maintainers: + - Peter Ujfalusi + +description: + Bindings for audio setups on TI OMAP SoCs using TWL4030-family audio + codec connected via a McBSP port. + +properties: + compatible: + const: ti,omap-twl4030 + + ti,model: + $ref: /schemas/types.yaml#/definitions/string + description: Name of the sound card (for example "omap3beagle"). + + ti,mcbsp: + $ref: /schemas/types.yaml#/definitions/phandle + description: phandle for the McBSP node. + + ti,codec: + $ref: /schemas/types.yaml#/definitions/phandle + description: phandle for the twl4030 audio node. + + ti,mcbsp-voice: + $ref: /schemas/types.yaml#/definitions/phandle + description: phandle to the McBSP node connected to the voice port. + + ti,jack-det-gpio: + description: GPIO specifier for jack detection. + maxItems: 1 + + ti,audio-routing: + description: | + A list of audio routing connections. Each entry is a pair of strings, + with the first being the connection's sink and the second being the + source. If not provided, all possible connections are available. + + Available TWL4030 Pins: "HFL", "HFR", + "PREDRIVEL", "PREDRIVER", "CARKITL", "CARKITR", "MAINMIC", "SUBMIC= ", + "HSMIC", "DIGIMIC0", "DIGIMIC1", "CARKITMIC", "AUXL", "AUXR", + "Headset Mic Bias", "Mic Bias 1", "Mic Bias 2" + $ref: /schemas/types.yaml#/definitions/non-unique-string-array + items: + enum: + # Board Connectors + - Headset Stereophone + - Earpiece Spk + - Handsfree Spk + - Ext Spk + - Main Mic + - Sub Mic + - Headset Mic + - Carkit Mic + - Digital0 Mic + - Digital1 Mic + - Line In + + # CODEC Pins + - HSOL + - HSOR + - EARPIECE + - HFL + - HFR + - PREDRIVEL + - PREDRIVER + - CARKITL + - CARKITR + - MAINMIC + - SUBMIC + - HSMIC + - DIGIMIC0 + - DIGIMIC1 + - CARKITMIC + - AUXL + - AUXR + + # Headset Mic Bias + - Mic Bias 1 # Used for Main Mic or Digimic0 + - Mic Bias 2 # Used for Sub Mic or Digimic1 + +required: + - compatible + - ti,model + - ti,mcbsp + +additionalProperties: false + +examples: + - | + sound { + compatible =3D "ti,omap-twl4030"; + ti,model =3D "omap3beagle"; + ti,mcbsp =3D <&mcbsp2>; + }; --=20 2.39.5 From nobody Sat Oct 4 15:55:22 2025 Received: from mail-wr1-f54.google.com (mail-wr1-f54.google.com [209.85.221.54]) (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 AE0CD302778; Thu, 14 Aug 2025 13:22:05 +0000 (UTC) Authentication-Results: smtp.subspace.kernel.org; arc=none smtp.client-ip=209.85.221.54 ARC-Seal: i=1; a=rsa-sha256; d=subspace.kernel.org; s=arc-20240116; t=1755177727; cv=none; b=qz8jK7TSn+GzmGQziTgf65n8qBF+5Nl8S87U+3+YohqWYfYmCSA0RM4mE5fTM/LVawDaLaF34JUIo+qlg7u5JEMQfe/bLhwgiMYZdP7oVeI5tNqnX/CIeNmnQJrBqzCWDr1o/y6NdK8M8LVMHVh/jWPAbCiJlSCrbW38AmrvMoU= ARC-Message-Signature: i=1; a=rsa-sha256; d=subspace.kernel.org; s=arc-20240116; t=1755177727; c=relaxed/simple; bh=ttF0rBMZYYb3PkLndM6PHBPM7PDCgmMp+SUcSU6Gcbg=; h=From:To:Cc:Subject:Date:Message-Id:In-Reply-To:References: MIME-Version; b=ZVrKNT1aECcNPbDIY+bNGY6vTq8o4Mxi3LcpENS/A1CbZiTl+3ejOC1i54nNNjhe3ynffymv8t/w8lsc0iFYgDGmW5QrH/R8Ib9WFejxMEZiUHbk1ZLn1+wT1u8ytJ26ouuPP8YQdJCD6unVqY7FKc0Phtp4S2jFVI2mJdFtYYI= 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=jJph/G7J; arc=none smtp.client-ip=209.85.221.54 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="jJph/G7J" Received: by mail-wr1-f54.google.com with SMTP id ffacd0b85a97d-3b9edfba75bso412219f8f.3; Thu, 14 Aug 2025 06:22:05 -0700 (PDT) DKIM-Signature: v=1; a=rsa-sha256; c=relaxed/relaxed; d=gmail.com; s=20230601; t=1755177724; x=1755782524; 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=KPhvOj0vcqOs4hostSr3/eg4Eaucd/avEKAcPTcqmOw=; b=jJph/G7JqcKhJa2DhTc94UwsbkhpeTWaAdMUHvjFFMzU7g3tmEBnGR/RjCvofRIKIH 6a4AAbu9ullpzwiOpAQCc1BM6Dp3dtsdhkd8k9E5MbWdhs09pY5rObhwHYsdJmdcBh3N q9m9egiCVmpmqjhZ1JAj42TwelFgDaE9GciQSxxLS3JYThADzBM5v+UkhalTFC+PXA0f FRJ32VnQa1tgTmLu1ArWz9pxF4AVUgYkhyVFsF4Olzx6Cp+pzu8Y5iqwIDO+VMbaBbC1 CrO24bKnFA9m/3tp//ctkx2e5He3+4u20QS+jeB89axi19ZcJbTgR7muUoOGV8avWMqr L/vA== X-Google-DKIM-Signature: v=1; a=rsa-sha256; c=relaxed/relaxed; d=1e100.net; s=20230601; t=1755177724; x=1755782524; 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=KPhvOj0vcqOs4hostSr3/eg4Eaucd/avEKAcPTcqmOw=; b=XLpBw2clfZWScEZgyqziGvjG8mukXQr5GAj1MpKXnus+eg3H+Yvqi4jEbsxHIKcx1w VgLTARt+8HE5kTAWcX+7HdRf+vyNAZymZ2Ct2IZVYvmonXkfndKJNFS6yEKeqO+VbF09 ii8FxDRrxbIoYh5Q2a2gdcGbNa12RQtp6NIDVNvnGRs4e944Y0tvqnoQONHPBAitH1hB ORqMX3IqIV7aa6F+iQWB0Sz2z+f1dTogxraOg6QLcJJBP9IJgH2+XHl7lRU7TC2bWGH9 C5q5qyvQTAzXwH4Ts/YngCQ/WrdBnudSfszbHF9c/JDX0IBZ3l5mNZwArGJJqbvjdDVD 311w== X-Forwarded-Encrypted: i=1; AJvYcCVOEbqbISQF5hmsCosrfPtCF64L75ibZhVuKueFjEa+4cDir3XY8ludFx7dAd/3z0Vwmz8hj6lcLMJu@vger.kernel.org, AJvYcCVlYIEjY1lX3rkQo7r8ibsGJrF4laeKBq96L9T9d7s9gKiPdMEw5eGFEL8MzdLdI7++f94ef6JQeeZP9Dg=@vger.kernel.org, AJvYcCWJiCv7zI9aN+ZTibBciYtxhUtVfbb6Gi1xhbw64FR67vO5GCdwqjTaxqk1r+2O4dOUv45QhH32yDFPl4c=@vger.kernel.org, AJvYcCX6QtwMC6B4USNmoKbTMjA/7vyEd+vpYJM4ckh98ZfaVV15pcT8+6IUGFEiA0xMXUslo/t2CWJZCGYY@vger.kernel.org, AJvYcCXE+LROq1yG5euv2iLOmxzVM/NJnpPmu4Ij3NO2xNe7tBqn3MU2bVZYcpiHK6xE6PSeioMJLrfIi8c0@vger.kernel.org X-Gm-Message-State: AOJu0YxJLzfFEz+VB9fOhtu4LtWsUSj2NBG5pK7hqG/EoFrurAIbAE4k XyZuGgEwhdmKK6BbqUP/xnrzCDfhTjsBSisMWS8LR4OVb9ay8pWbovd0edX4 X-Gm-Gg: ASbGncsGZ2W1N1Yk3WOXZmOkz+cnMxzm6eo7FXvYIosdkiUex+aaCmZSETRTvSZTyK9 S73qK43Ttj/uTezslhmpUc6JaPRmR4ikn0Sy0FeX0y5Q4wpuf0wXs5+oL9pguqNQEkCFf+CF+qX qeIdExPhvwlNk5vSk2lSOUX1s+r9yjYCYPrnbP8B+r2HWwQsnCMX1Nf5A0QkRxBznWJd40LTxio vZ8PsDDZNtIw46WkI2sxIhrObQ+IArPOUjBHm2UGdf6RywZm4JZEOt79xa/C/hNlHO2MAELN2VT 3I1XAd5odduVQ1r0zUDTHVvcAo1yq8OeVzy+jliXLv5i+93YIhDjmrbIGSK6IL5UBgQcZ+wg6Hk a13Cot8SPwHLUyKM+5spgRGtGBkS2lglymrWI8HNMAKcEWnN1aJ4ZEZTWNfpJw6yyH15WQkku2i zpJI3R4qjyg0YmEBstWtFx5e3HgPonKpsJ X-Google-Smtp-Source: AGHT+IEDiNwjwbKGhqrtPSNbm7ZvnFQK5iC/6/SqCP0SvFuwTlU0elXKRGvv48bAjGCVY6IX/E3vIQ== X-Received: by 2002:a05:6000:144f:b0:3b7:9ae1:eb9 with SMTP id ffacd0b85a97d-3ba50cc8e1emr2060796f8f.23.1755177723440; Thu, 14 Aug 2025 06:22:03 -0700 (PDT) Received: from localhost.localdomain (lmontsouris-658-1-96-160.w81-250.abo.wanadoo.fr. [81.250.250.160]) by smtp.gmail.com with ESMTPSA id ffacd0b85a97d-3b79c3b9386sm50998831f8f.18.2025.08.14.06.22.02 (version=TLS1_3 cipher=TLS_AES_256_GCM_SHA384 bits=256/256); Thu, 14 Aug 2025 06:22:02 -0700 (PDT) From: Jihed Chaibi To: linux-kernel@vger.kernel.org Cc: andreas@kemnade.info, peter.ujfalusi@gmail.com, dmitry.torokhov@gmail.com, robh@kernel.org, krzk+dt@kernel.org, lgirdwood@gmail.com, tiwai@suse.com, conor+dt@kernel.org, lee@kernel.org, ukleinek@kernel.org, broonie@kernel.org, gregkh@linuxfoundation.org, linux-input@vger.kernel.org, devicetree@vger.kernel.org, linux-pwm@vger.kernel.org, linux-sound@vger.kernel.org, linux-usb@vger.kernel.org, shuah@kernel.org, jihed.chaibi.dev@gmail.com Subject: [PATCH v2 8/9] usb: dt-bindings: ti,twlxxxx-usb: convert to DT schema Date: Thu, 14 Aug 2025 15:21:28 +0200 Message-Id: <20250814132129.138943-9-jihed.chaibi.dev@gmail.com> X-Mailer: git-send-email 2.39.5 In-Reply-To: <20250814132129.138943-1-jihed.chaibi.dev@gmail.com> References: <20250814132129.138943-1-jihed.chaibi.dev@gmail.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" Convert the legacy TXT binding for the TWL4030/6030 USB module to the modern YAML DT schema format. This adds formal validation and improves documentation using a conditional schema. Changes in v2: - Added '#phy-cells' property to support PHY framework integration. Signed-off-by: Jihed Chaibi --- .../bindings/usb/ti,twlxxxx-usb.yaml | 125 ++++++++++++++++++ .../devicetree/bindings/usb/twlxxxx-usb.txt | 43 ------ 2 files changed, 125 insertions(+), 43 deletions(-) create mode 100644 Documentation/devicetree/bindings/usb/ti,twlxxxx-usb.ya= ml delete mode 100644 Documentation/devicetree/bindings/usb/twlxxxx-usb.txt diff --git a/Documentation/devicetree/bindings/usb/ti,twlxxxx-usb.yaml b/Do= cumentation/devicetree/bindings/usb/ti,twlxxxx-usb.yaml new file mode 100644 index 000000000..48ff5b732 --- /dev/null +++ b/Documentation/devicetree/bindings/usb/ti,twlxxxx-usb.yaml @@ -0,0 +1,125 @@ +# SPDX-License-Identifier: (GPL-2.0-only OR BSD-2-Clause) +%YAML 1.2 +--- +$id: http://devicetree.org/schemas/usb/ti,twlxxxx-usb.yaml# +$schema: http://devicetree.org/meta-schemas/core.yaml# + +title: Texas Instruments TWL4030/6030 USB PHY and Comparator + +maintainers: + - Peter Ujfalusi + +description: | + Bindings for the USB PHY and comparator module found within the + TWL4030 and TWL6030 family of companion chips. + + TWL6030: USB COMPARATOR + TWL4030: USB COMPARATOR & PHY + + If a sibling node is compatible with "ti,twl4030-bci", the driver for + that node will query this device for USB power status. + +properties: + compatible: + enum: + - ti,twl4030-usb + - ti,twl6030-usb + + interrupts: + description: | + Interrupts for ID and VBUS events. + For "ti,twl6030-usb", two interrupts must be specified: + - The first is the OTG interrupt for ID events (host mode). + - The second is the USB interrupt for VBUS events (device mode). + For "ti,twl4030-usb", one or two interrupts can be specified: + - The first is the OTG interrupt for both ID and VBUS events. + - The second is optional. + minItems: 1 + maxItems: 2 + + usb-supply: + description: + Phandle to the VUSB regulator. For TWL6030, this should be the 'vusb' + regulator. For TWL6032 subclass, it should be the 'ldousb' regulator. + + usb1v5-supply: + description: Phandle to the VUSB1V5 regulator (for TWL4030). + + usb1v8-supply: + description: Phandle to the VUSB1V8 regulator (for TWL4030). + + usb3v1-supply: + description: Phandle to the USB3V1 regulator (for TWL4030). + + usb_mode: + description: | + The mode used by the PHY (TWL4030 ONLY) to connect to the controller: + 1: ULPI mode + 2: CEA2011_3PIN mode + $ref: /schemas/types.yaml#/definitions/uint32 + enum: [1, 2] + + '#phy-cells': + const: 0 + +required: + - compatible + - interrupts + +additionalProperties: false + +if: + properties: + compatible: + contains: + const: ti,twl6030-usb +then: + required: + - usb-supply + properties: + interrupts: + minItems: 2 +else: + required: + - usb1v5-supply + - usb1v8-supply + - usb3v1-supply + - usb_mode + +examples: + - | + i2c { + #address-cells =3D <1>; + #size-cells =3D <0>; + + twl@48 { + reg =3D <0x48>; + + usb_phy: twl4030-usb { + compatible =3D "ti,twl4030-usb"; + interrupts =3D <10 4>; // 1 interrupt: OTG (ID & VBUS eve= nts) + interrupt-parent =3D <&gic>; + usb1v5-supply =3D <®_vusb1v5>; + usb1v8-supply =3D <®_vusb1v8>; + usb3v1-supply =3D <®_vusb3v1>; + usb_mode =3D <1>; + #phy-cells =3D <0>; + }; + }; + }; + - | + i2c { + #address-cells =3D <1>; + #size-cells =3D <0>; + + twl@48 { + reg =3D <0x48>; + + usb_comp: twl6030-usb { + compatible =3D "ti,twl6030-usb"; + interrupts =3D <4 4>, <10 4>; // 2 interrupts: OTG & USB + interrupt-parent =3D <&gic>; + usb-supply =3D <®_vusb>; + }; + }; + }; diff --git a/Documentation/devicetree/bindings/usb/twlxxxx-usb.txt b/Docume= ntation/devicetree/bindings/usb/twlxxxx-usb.txt deleted file mode 100644 index 17327a296..000000000 --- a/Documentation/devicetree/bindings/usb/twlxxxx-usb.txt +++ /dev/null @@ -1,43 +0,0 @@ -USB COMPARATOR OF TWL CHIPS - -TWL6030 USB COMPARATOR - - compatible : Should be "ti,twl6030-usb" - - interrupts : Two interrupt numbers to the cpu should be specified. First - interrupt number is the otg interrupt number that raises ID interrupts = when - the controller has to act as host and the second interrupt number is the - usb interrupt number that raises VBUS interrupts when the controller ha= s to - act as device - - usb-supply : phandle to the regulator device tree node. It should be vu= sb - if it is twl6030 or ldousb if it is twl6032 subclass. - -twl6030-usb { - compatible =3D "ti,twl6030-usb"; - interrupts =3D < 4 10 >; -}; - -Board specific device node entry -&twl6030-usb { - usb-supply =3D <&vusb>; -}; - -TWL4030 USB PHY AND COMPARATOR - - compatible : Should be "ti,twl4030-usb" - - interrupts : The interrupt numbers to the cpu should be specified. First - interrupt number is the otg interrupt number that raises ID interrupts - and VBUS interrupts. The second interrupt number is optional. - - -supply : phandle to the regulator device tree node. - should be vusb1v5, vusb1v8 and vusb3v1 - - usb_mode : The mode used by the phy to connect to the controller. "1" - specifies "ULPI" mode and "2" specifies "CEA2011_3PIN" mode. - -If a sibling node is compatible "ti,twl4030-bci", then it will find -this device and query it for USB power status. - -twl4030-usb { - compatible =3D "ti,twl4030-usb"; - interrupts =3D < 10 4 >; - usb1v5-supply =3D <&vusb1v5>; - usb1v8-supply =3D <&vusb1v8>; - usb3v1-supply =3D <&vusb3v1>; - usb_mode =3D <1>; -}; --=20 2.39.5 From nobody Sat Oct 4 15:55:22 2025 Received: from mail-wr1-f42.google.com (mail-wr1-f42.google.com [209.85.221.42]) (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 EB13A303CA0; Thu, 14 Aug 2025 13:22:07 +0000 (UTC) Authentication-Results: smtp.subspace.kernel.org; arc=none smtp.client-ip=209.85.221.42 ARC-Seal: i=1; a=rsa-sha256; d=subspace.kernel.org; s=arc-20240116; t=1755177729; cv=none; b=eiRjK/jcUMbvIULBX9sVTllHThdP3AlNqUrkt3lvi2WCX+cIbUV8c0QrJOIKUPk2DVVRM4LNnqcB6kwrFpElvjvuvX+kWrRO1m7j1n3yAsaJT9C/P4dsGNz9TPhaY9wDUpgxwErlZnyFYS/+QkdHqt8gi2oJfXudXe+ds3gcqGo= ARC-Message-Signature: i=1; a=rsa-sha256; d=subspace.kernel.org; s=arc-20240116; t=1755177729; c=relaxed/simple; bh=qLrLbJ8AJh3khNsEkYSawcE/YIrXHGXesmQXIlAtOdY=; h=From:To:Cc:Subject:Date:Message-Id:In-Reply-To:References: MIME-Version; b=EDlfoR+6GYjCH13wR2JbXJb2L5DbtaNWfZ/x5wDT/XS3nwa9lINRQPDsJPkgoICCLZ+PO79thHM1O18WSbUn6ZGFDFo0ksFER8mfrAyVgxNx/jj4OVB98yf3ffRxh4Ai4R8ctudl0WBtmqTQU8E2onj+epCNIZFIQQMyvK+ZsFQ= 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=RhqqC1m/; arc=none smtp.client-ip=209.85.221.42 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="RhqqC1m/" Received: by mail-wr1-f42.google.com with SMTP id ffacd0b85a97d-3b9dc56ff66so470937f8f.1; Thu, 14 Aug 2025 06:22:07 -0700 (PDT) DKIM-Signature: v=1; a=rsa-sha256; c=relaxed/relaxed; d=gmail.com; s=20230601; t=1755177726; x=1755782526; 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=V9gf+UMX7IgdZsLYIXWD9mcyJlocdIHrenFz3ChndAE=; b=RhqqC1m/eu53Cqu5dd3DoCuWmH6xAXlcVJ6IMBdmSxHPT3h7APmH9vqKhadNsZkEaP +0tUDgyGcuNrU9IdRRNDWYSO7IG0mki8gzIIvsS/rwGADDjJyllVXfr9dbHqmaK2LoU8 oHrMNBqvKPqj528QryTQiyaHP2X+7wHhpbpcZpvsEd5YacyUVVBj2a5C1gZ/bCF3wN1S ymH4IbnW+8wCipNMOAzZfNFZ34TDdgqEKcQtN9vdVmD35aFwLPDMqzIbHJ4xwwidOufv BJiMP5IdItj1f5CWrlB31MfqBo5b4iE/4g+pIAee4TWMU9ZE1gjymraZ2G/wERc2mMtf eQBA== X-Google-DKIM-Signature: v=1; a=rsa-sha256; c=relaxed/relaxed; d=1e100.net; s=20230601; t=1755177726; x=1755782526; 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=V9gf+UMX7IgdZsLYIXWD9mcyJlocdIHrenFz3ChndAE=; b=BXdolWrxGLypZWXu6RhiPX5+2vqj4nntp0Lkje6SwEU+LkGPj30Vcu4wGBobWXYcek buxbUgMxA2i8IdPa+Y5I+IfteOQbIOGiXfb8sCAHwpw+QscCh/wG+3ivBeOGLgSiAC3W DziYbsIS64EdfiFJ5DF1CBtBlWaEnAuGthSmEgS9cAevKOpDrtFBr7nxAi95gm4cM5kb aecT0zNCgUjmOYV3MxZvWlxjVDcBTH4DiDqs69c7kauTkffAnORNwgz18RyDlqCmLNG4 bq7/MSc2K22f5l8DijkNB8RwiEfB8868YuclHP6RGAQhNzguSn79wBbnB4Z7T/E96S0G sALg== X-Forwarded-Encrypted: i=1; AJvYcCU7f9hx5JsuqvxA9LTLg2yYKKMs/7WcBWm8pH4Ry04CGGuc5cwqU8xXL6SY/ICaFPX1MaYLFtfbVPAcIB4=@vger.kernel.org, AJvYcCUt7koTD+OZ76lILYWOuJEevOzlKSxxZbT3ijPKh+Wp/6yAwA0F4RtbhoQzSknJ6E9Dkh4Wj7ziuS16rsM=@vger.kernel.org, AJvYcCW9eKrV8Xo1X2XDqSToiyB0dDO3StyWmJPyEMpbqxuCUKg8Icw652eZyPcdvj1au+fAjvqlW1yFq/hK@vger.kernel.org, AJvYcCWQ2jJ/TGzi2/EzHdOtuBrk0vEZhLfRGXNbH/vC4Ndnpt2QP45VZMmPrQT1y/Br+oqXKW2SltqLa9xT@vger.kernel.org, AJvYcCXaF6eebn6KXRA6vQRXUbLU2IjfFwlBYH5VxXqgLwaUlrLtcu/+5vl0ghW4Ebe88NUrLj+11N4fRZ7x@vger.kernel.org X-Gm-Message-State: AOJu0YxfwriwQUwneCaj79vyuhiUubVIt/Roe6T35CYkCzBNW6r8c5j5 ndXh5PveSXiUeLwx5wGYzDMQNXO6SA+4dPXG8261BBpAt6Ehj574exJKku1+ X-Gm-Gg: ASbGncvsguQ6cLyPlLqMgPp/xSyHEJdSE+e+b6kW6szO6O3RIZ1F8q+iDGsMCXv+dhP nhxwnLTdSkKubagkC2U1gMIUoBgq7ctXf4vPG+QuU+l9BDlaPSgLWQJzOLP2iAyx+cEZVNT5FHO duqug+ugmA2tg5KejPCdRmyW5ZAcI7qVJGCeDvFrcrw0bAKHOar/qYFfM01idi9habJWPg/Fn42 pZCxggWePo6u8aWP9mu1oj0fACoKwFZtZMDABUa+Lq+eWCoWZj8WQ3FwGLTDj+PWJjFbltf/FSS 3KC4CcVVpr2lTD/gqIcef6dlthb3uAun2BMJ6blCD24aUKaLkSwUrBjTajmle1gjINCV6Gx3jiN PWt/ESnwhz1zRo2+da6LVSk0IzYVROSYaeGMRLOG/FUN3bTkLVkOOuLoLj6wiYommut9PhLDhf4 lw39Jd3SupUHtqs6qvTOCSwA== X-Google-Smtp-Source: AGHT+IHohGHq9qZiuSxAAi0iS3zzrY+43TieWM5WbOF8kEuQD7ciIQoQ6ArH7H4J9Z8aFPKu1d7O3g== X-Received: by 2002:a5d:5f53:0:b0:3b8:d900:fa79 with SMTP id ffacd0b85a97d-3b9edfd2161mr2331716f8f.5.1755177725766; Thu, 14 Aug 2025 06:22:05 -0700 (PDT) Received: from localhost.localdomain (lmontsouris-658-1-96-160.w81-250.abo.wanadoo.fr. [81.250.250.160]) by smtp.gmail.com with ESMTPSA id ffacd0b85a97d-3b79c3b9386sm50998831f8f.18.2025.08.14.06.22.04 (version=TLS1_3 cipher=TLS_AES_256_GCM_SHA384 bits=256/256); Thu, 14 Aug 2025 06:22:05 -0700 (PDT) From: Jihed Chaibi To: linux-kernel@vger.kernel.org Cc: andreas@kemnade.info, peter.ujfalusi@gmail.com, dmitry.torokhov@gmail.com, robh@kernel.org, krzk+dt@kernel.org, lgirdwood@gmail.com, tiwai@suse.com, conor+dt@kernel.org, lee@kernel.org, ukleinek@kernel.org, broonie@kernel.org, gregkh@linuxfoundation.org, linux-input@vger.kernel.org, devicetree@vger.kernel.org, linux-pwm@vger.kernel.org, linux-sound@vger.kernel.org, linux-usb@vger.kernel.org, shuah@kernel.org, jihed.chaibi.dev@gmail.com Subject: [PATCH v2 9/9] dt-bindings: mfd: twl: Add missing sub-nodes for TWL4030 & TWL603x Date: Thu, 14 Aug 2025 15:21:29 +0200 Message-Id: <20250814132129.138943-10-jihed.chaibi.dev@gmail.com> X-Mailer: git-send-email 2.39.5 In-Reply-To: <20250814132129.138943-1-jihed.chaibi.dev@gmail.com> References: <20250814132129.138943-1-jihed.chaibi.dev@gmail.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" Update the TI TWL family Device Tree binding to include additional subnodes for TWL4030, TWL6030, and TWL6032 devices. This patch enhances the schema by adding support for audio, GPIO, power, keypad, PWM, PWM LED, and USB subnodes, referencing their respective YAML schemas where applicable. These additions improve the schema's completeness, enabling better validation and documentation of the TWL multi-function device's capabilities. The changes ensure proper handling of TWL4030-specific features (audio, keypad, PWM, PWM LED, USB, GPIO, and power) and TWL6030/TWL6032-specific features (PWM, PWM LED, and USB), with appropriate schema references to prevent unevaluated properties. Signed-off-by: Jihed Chaibi --- .../devicetree/bindings/mfd/ti,twl.yaml | 63 +++++++++++++++++++ 1 file changed, 63 insertions(+) diff --git a/Documentation/devicetree/bindings/mfd/ti,twl.yaml b/Documentat= ion/devicetree/bindings/mfd/ti,twl.yaml index f162ab60c..81f9d8f72 100644 --- a/Documentation/devicetree/bindings/mfd/ti,twl.yaml +++ b/Documentation/devicetree/bindings/mfd/ti,twl.yaml @@ -76,6 +76,38 @@ allOf: properties: compatible: const: ti,twl4030-wdt + + audio: + type: object + $ref: /schemas/sound/ti,twl4030-audio.yaml# + unevaluatedProperties: false + + keypad: + type: object + $ref: /schemas/input/ti,twl4030-keypad.yaml# + unevaluatedProperties: false + + pwm: + type: object + $ref: /schemas/pwm/ti,twl-pwm.yaml# + unevaluatedProperties: false + + pwmled: + type: object + $ref: /schemas/pwm/ti,twl-pwmled.yaml# + unevaluatedProperties: false + + 'twl4030-usb': + type: object + $ref: /schemas/usb/ti,twlxxxx-usb.yaml# + unevaluatedProperties: false + + gpio: + type: object + + power: + type: object + - if: properties: compatible: @@ -115,6 +147,22 @@ allOf: properties: compatible: const: ti,twl6030-gpadc + + pwm: + type: object + $ref: /schemas/pwm/ti,twl-pwm.yaml# + unevaluatedProperties: false + + pwmled: + type: object + $ref: /schemas/pwm/ti,twl-pwmled.yaml# + unevaluatedProperties: false + + 'twl6030-usb': + type: object + $ref: /schemas/usb/ti,twlxxxx-usb.yaml# + unevaluatedProperties: false + - if: properties: compatible: @@ -154,6 +202,21 @@ allOf: compatible: const: ti,twl6032-gpadc =20 + pwm: + type: object + $ref: /schemas/pwm/ti,twl-pwm.yaml# + unevaluatedProperties: false + + pwmled: + type: object + $ref: /schemas/pwm/ti,twl-pwmled.yaml# + unevaluatedProperties: false + + 'twl6030-usb': + type: object + $ref: /schemas/usb/ti,twlxxxx-usb.yaml + unevaluatedProperties: false + properties: compatible: description: --=20 2.39.5