devicetree.vger.kernel.org archive mirror
 help / color / mirror / Atom feed
* [PATCH] arm64: dts: qcom: align gpio-keys label format
@ 2025-03-31 12:10 Caleb Connolly
  2025-03-31 12:20 ` Luca Weiss
  0 siblings, 1 reply; 3+ messages in thread
From: Caleb Connolly @ 2025-03-31 12:10 UTC (permalink / raw)
  To: Bjorn Andersson, Conor Dooley, Konrad Dybcio, Krzysztof Kozlowski,
	Rob Herring
  Cc: Caleb Connolly, devicetree, linux-arm-msm

Most devices follow the practise of capitilising all words in a label,
this seems to be the standard elsewhere too (e.g. run "evtest" on an x86
ThinkPad).

Adjust the stragglers to follow suite, and standardise on "Volume
Buttons" over "Volume keys" as the label for the entire device where
applicable.

Signed-off-by: Caleb Connolly <caleb.connolly@linaro.org>
---

This is really a drop in the ocean, a good next step would be to fix the
pm8941-pwrkey driver so your power button doesn't show up as
"pm8941_pwrkey".
---
 arch/arm64/boot/dts/qcom/msm8998-oneplus-common.dtsi | 4 ++--
 arch/arm64/boot/dts/qcom/msm8998-xiaomi-sagit.dts    | 6 +++---
 arch/arm64/boot/dts/qcom/qcm6490-fairphone-fp5.dts   | 2 +-
 arch/arm64/boot/dts/qcom/qcm6490-shift-otter.dts     | 2 +-
 arch/arm64/boot/dts/qcom/sdm845-lg-common.dtsi       | 2 +-
 arch/arm64/boot/dts/qcom/sdm845-oneplus-common.dtsi  | 6 +++---
 arch/arm64/boot/dts/qcom/sm7325-nothing-spacewar.dts | 2 +-
 7 files changed, 12 insertions(+), 12 deletions(-)

diff --git a/arch/arm64/boot/dts/qcom/msm8998-oneplus-common.dtsi b/arch/arm64/boot/dts/qcom/msm8998-oneplus-common.dtsi
index e6a69d942a4a..452c455294d0 100644
--- a/arch/arm64/boot/dts/qcom/msm8998-oneplus-common.dtsi
+++ b/arch/arm64/boot/dts/qcom/msm8998-oneplus-common.dtsi
@@ -90,17 +90,17 @@ gpio-keys {
 		pinctrl-names = "default";
 		pinctrl-0 = <&vol_keys_default>;
 
 		button-vol-down {
-			label = "Volume down";
+			label = "Volume Down";
 			gpios = <&pm8998_gpios 5 GPIO_ACTIVE_LOW>;
 			linux,code = <KEY_VOLUMEDOWN>;
 			debounce-interval = <15>;
 			wakeup-source;
 		};
 
 		button-vol-up {
-			label = "Volume up";
+			label = "Volume Up";
 			gpios = <&pm8998_gpios 6 GPIO_ACTIVE_LOW>;
 			linux,code = <KEY_VOLUMEUP>;
 			debounce-interval = <15>;
 			wakeup-source;
diff --git a/arch/arm64/boot/dts/qcom/msm8998-xiaomi-sagit.dts b/arch/arm64/boot/dts/qcom/msm8998-xiaomi-sagit.dts
index 0cac06f25a77..2a62d58195fd 100644
--- a/arch/arm64/boot/dts/qcom/msm8998-xiaomi-sagit.dts
+++ b/arch/arm64/boot/dts/qcom/msm8998-xiaomi-sagit.dts
@@ -124,16 +124,16 @@ zap_shader_region: memory@f7900000 {
 	};
 
 	gpio-keys {
 		compatible = "gpio-keys";
-		label = "Volume buttons";
+		label = "Volume Up";
 		autorepeat;
 
 		pinctrl-names = "default";
 		pinctrl-0 = <&vol_up_key_default>;
 
 		key-vol-up {
-			label = "Volume up";
+			label = "Volume Up";
 			gpios = <&pm8998_gpios 6 GPIO_ACTIVE_LOW>;
 			linux,code = <KEY_VOLUMEUP>;
 			debounce-interval = <15>;
 			wakeup-source;
@@ -141,9 +141,9 @@ key-vol-up {
 	};
 
 	gpio-hall-sensor {
 		compatible = "gpio-keys";
-		label = "Hall effect sensor";
+		label = "Hall Effect Sensor";
 
 		pinctrl-names = "default";
 		pinctrl-0 = <&hall_sensor_default_state>;
 
diff --git a/arch/arm64/boot/dts/qcom/qcm6490-fairphone-fp5.dts b/arch/arm64/boot/dts/qcom/qcm6490-fairphone-fp5.dts
index 0f1c83822f66..0333e06227eb 100644
--- a/arch/arm64/boot/dts/qcom/qcm6490-fairphone-fp5.dts
+++ b/arch/arm64/boot/dts/qcom/qcm6490-fairphone-fp5.dts
@@ -54,9 +54,9 @@ gpio-keys {
 		pinctrl-0 = <&volume_down_default>, <&hall_sensor_default>;
 		pinctrl-names = "default";
 
 		key-volume-up {
-			label = "Volume up";
+			label = "Volume Up";
 			gpios = <&pm7325_gpios 6 GPIO_ACTIVE_LOW>;
 			linux,code = <KEY_VOLUMEUP>;
 		};
 
diff --git a/arch/arm64/boot/dts/qcom/qcm6490-shift-otter.dts b/arch/arm64/boot/dts/qcom/qcm6490-shift-otter.dts
index 712f29fbe85e..1b00fd5b2c89 100644
--- a/arch/arm64/boot/dts/qcom/qcm6490-shift-otter.dts
+++ b/arch/arm64/boot/dts/qcom/qcm6490-shift-otter.dts
@@ -56,9 +56,9 @@ gpio-keys {
 		pinctrl-0 = <&volume_down_default>;
 		pinctrl-names = "default";
 
 		key-volume-up {
-			label = "Volume up";
+			label = "Volume Up";
 			gpios = <&pm7325_gpios 6 GPIO_ACTIVE_LOW>;
 			linux,code = <KEY_VOLUMEUP>;
 			debounce-interval = <15>;
 		};
diff --git a/arch/arm64/boot/dts/qcom/sdm845-lg-common.dtsi b/arch/arm64/boot/dts/qcom/sdm845-lg-common.dtsi
index 99dafc6716e7..b60a41f71e29 100644
--- a/arch/arm64/boot/dts/qcom/sdm845-lg-common.dtsi
+++ b/arch/arm64/boot/dts/qcom/sdm845-lg-common.dtsi
@@ -129,9 +129,9 @@ gpio-keys {
 
 		label = "GPIO Buttons";
 
 		key-vol-up {
-			label = "Volume up";
+			label = "Volume Up";
 			linux,code = <KEY_VOLUMEUP>;
 			gpios = <&pm8998_gpios 6 GPIO_ACTIVE_LOW>;
 		};
 	};
diff --git a/arch/arm64/boot/dts/qcom/sdm845-oneplus-common.dtsi b/arch/arm64/boot/dts/qcom/sdm845-oneplus-common.dtsi
index 8a0f154bffc3..535b02d1b12c 100644
--- a/arch/arm64/boot/dts/qcom/sdm845-oneplus-common.dtsi
+++ b/arch/arm64/boot/dts/qcom/sdm845-oneplus-common.dtsi
@@ -48,23 +48,23 @@ event-hall-sensor {
 	};
 
 	gpio-keys {
 		compatible = "gpio-keys";
-		label = "Volume keys";
+		label = "Volume Buttons";
 		autorepeat;
 
 		pinctrl-names = "default";
 		pinctrl-0 = <&volume_down_gpio &volume_up_gpio>;
 
 		key-vol-down {
-			label = "Volume down";
+			label = "Volume Down";
 			linux,code = <KEY_VOLUMEDOWN>;
 			gpios = <&pm8998_gpios 5 GPIO_ACTIVE_LOW>;
 			debounce-interval = <15>;
 		};
 
 		key-vol-up {
-			label = "Volume up";
+			label = "Volume Up";
 			linux,code = <KEY_VOLUMEUP>;
 			gpios = <&pm8998_gpios 6 GPIO_ACTIVE_LOW>;
 			debounce-interval = <15>;
 		};
diff --git a/arch/arm64/boot/dts/qcom/sm7325-nothing-spacewar.dts b/arch/arm64/boot/dts/qcom/sm7325-nothing-spacewar.dts
index 85a928f98077..a7544d8b4fac 100644
--- a/arch/arm64/boot/dts/qcom/sm7325-nothing-spacewar.dts
+++ b/arch/arm64/boot/dts/qcom/sm7325-nothing-spacewar.dts
@@ -68,9 +68,9 @@ gpio-keys {
 		pinctrl-0 = <&kypd_volp_n>;
 		pinctrl-names = "default";
 
 		key-volume-up {
-			label = "Volume up";
+			label = "Volume Up";
 			gpios = <&pm7325_gpios 6 GPIO_ACTIVE_LOW>;
 			linux,code = <KEY_VOLUMEUP>;
 		};
 	};
-- 
2.49.0


^ permalink raw reply related	[flat|nested] 3+ messages in thread

* Re: [PATCH] arm64: dts: qcom: align gpio-keys label format
  2025-03-31 12:10 [PATCH] arm64: dts: qcom: align gpio-keys label format Caleb Connolly
@ 2025-03-31 12:20 ` Luca Weiss
  2025-03-31 12:26   ` Caleb Connolly
  0 siblings, 1 reply; 3+ messages in thread
From: Luca Weiss @ 2025-03-31 12:20 UTC (permalink / raw)
  To: Caleb Connolly, Bjorn Andersson, Conor Dooley, Konrad Dybcio,
	Krzysztof Kozlowski, Rob Herring
  Cc: devicetree, linux-arm-msm

On Mon Mar 31, 2025 at 2:10 PM CEST, Caleb Connolly wrote:
> Most devices follow the practise of capitilising all words in a label,
> this seems to be the standard elsewhere too (e.g. run "evtest" on an x86
> ThinkPad).
>
> Adjust the stragglers to follow suite, and standardise on "Volume
> Buttons" over "Volume keys" as the label for the entire device where
> applicable.

In theory some weird user space could find the correct input node based
on that label, which would 'break' if we change that label?

Not that anyone should really do this I believe, checking the supported
keys on a device is a much better solution.

But good to keep in mind.

>
> Signed-off-by: Caleb Connolly <caleb.connolly@linaro.org>
> ---
>
> This is really a drop in the ocean, a good next step would be to fix the
> pm8941-pwrkey driver so your power button doesn't show up as
> "pm8941_pwrkey".

"Power Button" would be good there, that's what my Intel Dell XPS 15 reports.

> ---
>  arch/arm64/boot/dts/qcom/msm8998-oneplus-common.dtsi | 4 ++--
>  arch/arm64/boot/dts/qcom/msm8998-xiaomi-sagit.dts    | 6 +++---
>  arch/arm64/boot/dts/qcom/qcm6490-fairphone-fp5.dts   | 2 +-
>  arch/arm64/boot/dts/qcom/qcm6490-shift-otter.dts     | 2 +-
>  arch/arm64/boot/dts/qcom/sdm845-lg-common.dtsi       | 2 +-
>  arch/arm64/boot/dts/qcom/sdm845-oneplus-common.dtsi  | 6 +++---
>  arch/arm64/boot/dts/qcom/sm7325-nothing-spacewar.dts | 2 +-
>  7 files changed, 12 insertions(+), 12 deletions(-)
>
> diff --git a/arch/arm64/boot/dts/qcom/msm8998-oneplus-common.dtsi b/arch/arm64/boot/dts/qcom/msm8998-oneplus-common.dtsi
> index e6a69d942a4a..452c455294d0 100644
> --- a/arch/arm64/boot/dts/qcom/msm8998-oneplus-common.dtsi
> +++ b/arch/arm64/boot/dts/qcom/msm8998-oneplus-common.dtsi
> @@ -90,17 +90,17 @@ gpio-keys {
>  		pinctrl-names = "default";
>  		pinctrl-0 = <&vol_keys_default>;
>  
>  		button-vol-down {
> -			label = "Volume down";
> +			label = "Volume Down";
>  			gpios = <&pm8998_gpios 5 GPIO_ACTIVE_LOW>;
>  			linux,code = <KEY_VOLUMEDOWN>;
>  			debounce-interval = <15>;
>  			wakeup-source;
>  		};
>  
>  		button-vol-up {
> -			label = "Volume up";
> +			label = "Volume Up";
>  			gpios = <&pm8998_gpios 6 GPIO_ACTIVE_LOW>;
>  			linux,code = <KEY_VOLUMEUP>;
>  			debounce-interval = <15>;
>  			wakeup-source;
> diff --git a/arch/arm64/boot/dts/qcom/msm8998-xiaomi-sagit.dts b/arch/arm64/boot/dts/qcom/msm8998-xiaomi-sagit.dts
> index 0cac06f25a77..2a62d58195fd 100644
> --- a/arch/arm64/boot/dts/qcom/msm8998-xiaomi-sagit.dts
> +++ b/arch/arm64/boot/dts/qcom/msm8998-xiaomi-sagit.dts
> @@ -124,16 +124,16 @@ zap_shader_region: memory@f7900000 {
>  	};
>  
>  	gpio-keys {
>  		compatible = "gpio-keys";
> -		label = "Volume buttons";
> +		label = "Volume Up";

Not sure where the label from this wrapping node would show up, but you
maybe want to keep this one as "Volume Buttons", like in some of the
other files?

Regards
Luca

^ permalink raw reply	[flat|nested] 3+ messages in thread

* Re: [PATCH] arm64: dts: qcom: align gpio-keys label format
  2025-03-31 12:20 ` Luca Weiss
@ 2025-03-31 12:26   ` Caleb Connolly
  0 siblings, 0 replies; 3+ messages in thread
From: Caleb Connolly @ 2025-03-31 12:26 UTC (permalink / raw)
  To: Luca Weiss, Bjorn Andersson, Conor Dooley, Konrad Dybcio,
	Krzysztof Kozlowski, Rob Herring
  Cc: devicetree, linux-arm-msm



On 3/31/25 14:20, Luca Weiss wrote:
> On Mon Mar 31, 2025 at 2:10 PM CEST, Caleb Connolly wrote:
>> Most devices follow the practise of capitilising all words in a label,
>> this seems to be the standard elsewhere too (e.g. run "evtest" on an x86
>> ThinkPad).
>>
>> Adjust the stragglers to follow suite, and standardise on "Volume
>> Buttons" over "Volume keys" as the label for the entire device where
>> applicable.
> 
> In theory some weird user space could find the correct input node based
> on that label, which would 'break' if we change that label?

heh well part of the motivation for this fix is that we do exactly that 
in U-Boot, so having consistent names helps (though, so will changing 
the strcmp to a strcasecmp in U-Boot).
> 
> Not that anyone should really do this I believe, checking the supported
> keys on a device is a much better solution.

Definitely agreed, I feel like this is better as a "revert if someone 
complains" patch.
> 
> But good to keep in mind.
> 
>>
>> Signed-off-by: Caleb Connolly <caleb.connolly@linaro.org>
>> ---
>>
>> This is really a drop in the ocean, a good next step would be to fix the
>> pm8941-pwrkey driver so your power button doesn't show up as
>> "pm8941_pwrkey".
> 
> "Power Button" would be good there, that's what my Intel Dell XPS 15 reports.
> 
>> ---
>>   arch/arm64/boot/dts/qcom/msm8998-oneplus-common.dtsi | 4 ++--
>>   arch/arm64/boot/dts/qcom/msm8998-xiaomi-sagit.dts    | 6 +++---
>>   arch/arm64/boot/dts/qcom/qcm6490-fairphone-fp5.dts   | 2 +-
>>   arch/arm64/boot/dts/qcom/qcm6490-shift-otter.dts     | 2 +-
>>   arch/arm64/boot/dts/qcom/sdm845-lg-common.dtsi       | 2 +-
>>   arch/arm64/boot/dts/qcom/sdm845-oneplus-common.dtsi  | 6 +++---
>>   arch/arm64/boot/dts/qcom/sm7325-nothing-spacewar.dts | 2 +-
>>   7 files changed, 12 insertions(+), 12 deletions(-)
>>
>> diff --git a/arch/arm64/boot/dts/qcom/msm8998-oneplus-common.dtsi b/arch/arm64/boot/dts/qcom/msm8998-oneplus-common.dtsi
>> index e6a69d942a4a..452c455294d0 100644
>> --- a/arch/arm64/boot/dts/qcom/msm8998-oneplus-common.dtsi
>> +++ b/arch/arm64/boot/dts/qcom/msm8998-oneplus-common.dtsi
>> @@ -90,17 +90,17 @@ gpio-keys {
>>   		pinctrl-names = "default";
>>   		pinctrl-0 = <&vol_keys_default>;
>>   
>>   		button-vol-down {
>> -			label = "Volume down";
>> +			label = "Volume Down";
>>   			gpios = <&pm8998_gpios 5 GPIO_ACTIVE_LOW>;
>>   			linux,code = <KEY_VOLUMEDOWN>;
>>   			debounce-interval = <15>;
>>   			wakeup-source;
>>   		};
>>   
>>   		button-vol-up {
>> -			label = "Volume up";
>> +			label = "Volume Up";
>>   			gpios = <&pm8998_gpios 6 GPIO_ACTIVE_LOW>;
>>   			linux,code = <KEY_VOLUMEUP>;
>>   			debounce-interval = <15>;
>>   			wakeup-source;
>> diff --git a/arch/arm64/boot/dts/qcom/msm8998-xiaomi-sagit.dts b/arch/arm64/boot/dts/qcom/msm8998-xiaomi-sagit.dts
>> index 0cac06f25a77..2a62d58195fd 100644
>> --- a/arch/arm64/boot/dts/qcom/msm8998-xiaomi-sagit.dts
>> +++ b/arch/arm64/boot/dts/qcom/msm8998-xiaomi-sagit.dts
>> @@ -124,16 +124,16 @@ zap_shader_region: memory@f7900000 {
>>   	};
>>   
>>   	gpio-keys {
>>   		compatible = "gpio-keys";
>> -		label = "Volume buttons";
>> +		label = "Volume Up";
> 
> Not sure where the label from this wrapping node would show up, but you
> maybe want to keep this one as "Volume Buttons", like in some of the
> other files?

I was a bit unsure here, but this doesn't contain "volume buttons" it 
contains a single key, volume up. So labelling it as "volume buttons" is 
wrong, right?

I don't suppose it matters much.
> 
> Regards
> Luca

-- 
Caleb (they/them)


^ permalink raw reply	[flat|nested] 3+ messages in thread

end of thread, other threads:[~2025-03-31 12:26 UTC | newest]

Thread overview: 3+ messages (download: mbox.gz follow: Atom feed
-- links below jump to the message on this page --
2025-03-31 12:10 [PATCH] arm64: dts: qcom: align gpio-keys label format Caleb Connolly
2025-03-31 12:20 ` Luca Weiss
2025-03-31 12:26   ` Caleb Connolly

This is a public inbox, see mirroring instructions
for how to clone and mirror all data and code used for this inbox;
as well as URLs for NNTP newsgroup(s).