samsung_sm8750/android_kernel_samsung_sm8750-devicetrees
1
0
Fork 0
Code Issues Pull Requests Actions Packages Projects Releases Wiki Activity

dt-bindings: input: Add bindings for qpnp-power-on driver

Browse Source 
Add devicetree bindings for the qpnp-power-on driver.

Change-Id: I826698a4413ac5ea6f438c238a5d936e0ec4fea7
Signed-off-by: Varshitha H N <quic_vhn@quicinc.com>
This commit is contained in:
Varshitha H N
2024-05-27 12:07:07 +05:30
parent 35032f56da
commit 6b293c7197
1 changed files with 159 additions and 164 deletions
Download Patch File Download Diff File Expand all files Collapse all files

199
bindings/input/qcom,qpnp-power-on.yaml
View File

@@ -9,7 +9,7 @@ title: Qualcomm Technologies, Inc. QPNP Power-on PMIC Peripheral
maintainers:
- David Collins <quic_collinsd@quicinc.com>
description: >
description: |
qpnp-power-on devices support the power-on (PON) peripheral found on
Qualcomm Technologies, Inc. PMICs. The supported functionality includes power
on/off reason, kerelease detection, PMIC reset configurations and other
@@ -22,117 +22,102 @@ properties:
const: qcom,qpnp-power-on
reg:
description: Specifies the SPMI base address for this
PON (power-on) peripheral. For PMICs that have
PON peripheral (GEN3) split into PON_HLOS and
PON_PBS, this can hold addresses of both.
PON_PBS base address needs to be specified for
such devices if "qcom,kdpwr-sw-debounce" is specified.
description: |
Specifies the SPMI base address for this PON (power-on) peripheral.
For PMICs that have PON peripheral (GEN3) split into PON_HLOS and
PON_PBS, this can hold addresses of both. PON_PBS base address needs
to be specified for such devices if "qcom,kdpwr-sw-debounce" is specified.
reg-names:
description: For PON GEN1 and GEN2, it should be "pon".
and for PON GEN3, it should include "pon_hlos" and
optionally "pon_pbs".
description: |
For PON GEN1 and GEN2, it should be "pon". and for PON GEN3, it should
include "pon_hlos" and optionally "pon_pbs".
interrupts:
description: Specifies the interrupts associated with PON.
description: |
Specifies the interrupts associated with PON.
interrupt-names:
description: Specifies the interrupt names associated with
the interrupts property. Must be a subset of
"kpdpwr", "kpdpwr-bark", "resin", "resin-bark",
"cblpwr", "kpdpwr-resin-bark", and
"pmic-wd-bark". Bark interrupts are associated
with system reset configuration to allow default
reset configuration to be activated. If system
reset configuration is not supported then bark
interrupts are nops. Additionally, the
"pmic-wd-bark" interrupt can be added if the
system needs to handle PMIC watchdog barks.
description: |
Specifies the interrupt names associated with the interrupts property.
Must be a subset of "kpdpwr", "kpdpwr-bark", "resin", "resin-bark",
"cblpwr", "kpdpwr-resin-bark", and "pmic-wd-bark". Bark interrupts are
associated with system reset configuration to allow default reset
configuration to be activated. If system reset configuration is not supported
then bark interrupts are nops. Additionally, the "pmic-wd-bark" interrupt
can be added if the system needs to handle PMIC watchdog barks.
qcom,pon-dbc-delay:
description: The debounce delay for the power-key interrupt
specified in us.
Possible values for GEN1 PON are
15625, 31250, 62500, 125000, 250000, 500000,
1000000 and 2000000.
Possible values for GEN2 PON are
62, 123, 245, 489, 977, 1954, 3907, 7813,
15625, 31250, 62500, 125000 and 250000.
Intermediate value is rounded down to the
nearest valid value.
description: |
The debounce delay for the power-key interrupt specified in us.
Possible values for GEN1 PON are 15625, 31250, 62500, 125000, 250000, 500000,
1000000 and 2000000. Possible values for GEN2 PON are 62, 123, 245, 489, 977,
1954, 3907, 7813, 15625, 31250, 62500, 125000 and 250000.
Intermediate value is rounded down to the nearest valid value.
$ref: /schemas/types.yaml#/definitions/uint32
qcom,system-reset:
description: Boolean which specifies that this PON peripheral
can be used to reset the system. This property
can only be used by one device on the system. It
is an error to include it more than once.
description: |
Boolean which specifies that this PON peripheral can be used to reset the system.
This property can only be used by one device on the system. It is an error to
include it more than once.
type: boolean
qcom,modem-reset:
description: Boolean which specifies that this PON peripheral
can be used to reset the attached modem chip.
This property can only be used by one PON device
on the system. qcom,modem-reset and
qcom,system-reset cannot be specified for the
same PON device.
description: |
Boolean which specifies that this PON peripheral can be used to reset the attached
modem chip. This property can only be used by one PON device on the system.
qcom,modem-reset and qcom,system-reset cannot be specified for the same PON device.
type: boolean
qcom,s3-debounce:
description: The debounce delay for stage 3 reset trigger in
secs. The values range from 0 to 128.
description: |
The debounce delay for stage 3 reset trigger in secs. The values range from 0 to 128.
$ref: /schemas/types.yaml#/definitions/uint32
qcom,s3-src:
description: The source for stage 3 reset. It can be one of
"kpdpwr", "resin", "kpdpwr-or-resin" or
description: |
The source for stage 3 reset. It can be one of "kpdpwr", "resin", "kpdpwr-or-resin" or
"kpdpwr-and-resin".
$ref: /schemas/types.yaml#/definitions/uint32
qcom,clear-warm-reset:
description: Boolean which specifies that the WARM_RESET
reason registers need to be cleared for this
target. The property is used for the targets
which have a hardware feature to catch resets
which aren't triggered by the application
processor. In such cases clearing WARM_REASON
registers across processor resets keeps the
registers in a useful state.
description: |
Boolean which specifies that the WARM_RESET reason registers need to be cleared for this
target. The property is used for the targets which have a hardware feature to catch resets
which aren't triggered by the application processor. In such cases clearing WARM_REASON
registers across processor resets keeps the registers in a useful state.
type: boolean
qcom,secondary-pon-reset:
description: Boolean property which indicates that the PON
peripheral is a secondary PON device which
needs to be configured during reset in addition
to the primary PON device that is configured
for system reset through qcom,system-reset
property.
This should not be defined along with the
qcom,system-reset or qcom,modem-reset property.
description: |
Boolean property which indicates that the PON peripheral is a secondary PON device which
needs to be configured during reset in addition to the primary PON device that is configured
for system reset through qcom,system-reset property.
This should not be defined along with the qcom,system-reset or qcom,modem-reset property.
type: boolean
qcom,store-hard-reset-reason:
description: Boolean property which if set will store the
hardware reset reason to SOFT_RB_SPARE register
of the core PMIC PON peripheral.
description: |
Boolean property which if set will store the hardware reset reason to SOFT_RB_SPARE
register of the core PMIC PON peripheral.
type: boolean
qcom,hard-reset-poweroff-type:
description: Same description as
qcom,warm-reset-poweroff-type but this applies
for the system hard reset case.
description: |
Same description as qcom,warm-reset-poweroff-type but this applies for the system
hard reset case.
type: boolean
qcom,kpdpwr-sw-debounce:
description: Boolean property to enable the debounce logic
on the KPDPWR_N rising edge.
description: |
Boolean property to enable the debounce logic on the KPDPWR_N rising edge.
type: boolean
qcom,pon_X:
description: These PON child nodes correspond to features
supported by the PON peripheral including reset
configurations, pushbutton keys, and regulators.
description: |
These PON child nodes correspond to features supported by the PON peripheral
including reset configurations, pushbutton keys, and regulators.
type: boolean
required:
@@ -140,29 +125,31 @@ required:
- reg
patternProperties:
"^pon-[0-9]+$":
'^qcom,pon_[0-9]$':
type: object
$ref: input.yaml#
unevaluatedProperties: false
properties:
regulator-name:
description: Regulator name for the PON regulator that is being configured.
description: |
Regulator name for the PON regulator that is being configured.
qcom,pon-spare-reg-addr:
description: Register offset from the base address of the
PON peripheral that needs to be configured for
the regulator being controlled.
description: |
Register offset from the base address of the PON peripheral that needs to be
configured for the regulator being controlled.
$ref: /schemas/types.yaml#/definitions/uint32
qcom,pon-spare-reg-bit:
description: Bit position in the specified register that
needs to be configured for the regulator being
controlled.
description: |
Bit position in the specified register that needs to be configured for the
regulator being controlled.
$ref: /schemas/types.yaml#/definitions/uint32
qcom,pon-type:
description: The type of PON/RESET source. Supported values are
description: |
The type of PON/RESET source. Supported values are
0 = KPDPWR
1 = RESIN
2 = CBLPWR
@@ -172,12 +159,13 @@ patternProperties:
$ref: /schemas/types.yaml#/definitions/uint32
qcom,pull-up:
description: Boolean flag indicating if a pull-up resistor
should be enabled for the input.
description: |
Boolean flag indicating if a pull-up resistor should be enabled for the input.
type: boolean
qcom,support-reset:
description: Indicates if this PON source supports
description: |
Indicates if this PON source supports
reset functionality.
0 = Not supported
1 = Supported
@@ -186,33 +174,32 @@ patternProperties:
type: boolean
qcom,use-bark:
description: Specify if this PON type needs to handle a bark
interrupt.
description: |
Specify if this PON type needs to handle a bark interrupt.
type: boolean
linux,code:
description: The input key-code associated with the reset
source. The reset source in its default
configuration can be used to support standard keys.
description: |
The input key-code associated with the reset source. The reset source in its
default configuration can be used to support standard keys.
qcom,s1-timer:
description: The debounce timer for the BARK interrupt for
the reset source. Value is specified in ms.
Supported values are
0, 32, 56, 80, 128, 184, 272, 408, 608, 904,
description: |
The debounce timer for the BARK interrupt for the reset source. Value is
specified in ms. Supported values are 0, 32, 56, 80, 128, 184, 272, 408, 608, 904,
1352, 2048, 3072, 4480, 6720, 10256
type: boolean
qcom,s2-timer:
description: The debounce timer for the S2 reset specified
in ms. On the expiry of this timer, the PMIC
executes the reset sequence.
Supported values are
0, 10, 50, 100, 250, 500, 1000, 2000
description: |
The debounce timer for the S2 reset specified in ms. On the expiry of this timer,
the PMIC executes the reset sequence. Supported values are 0, 10, 50, 100, 250,
500, 1000, 2000
type: boolean
qcom,s2-type:
description: The type of reset associated with this source.
description: |
The type of reset associated with this source.
Supported values
0 = SOFT_RESET (legacy)
1 = WARM_RESET
@@ -242,6 +229,10 @@ additionalProperties: false
examples:
- |
#include <dt-bindings/input/qcom,qpnp-power-on.h>
#include <dt-bindings/input/input.h>
#include <dt-bindings/interrupt-controller/irq.h>
qcom,power-on@800 {
compatible = "qcom,qpnp-power-on";
reg = <0x800>;
@@ -257,11 +248,13 @@ examples:
qcom,s3-src = "resin";
qcom,clear-warm-reset;
qcom,store-hard-reset-reason;
qcom,pon_1 {
qcom,pon-type = <PON_POWER_ON_TYPE_KPDPWR>;
qcom,pull-up;
qcom,pull-up = <1>;
linux,code = <KEY_POWER>;
};
qcom,pon_2 {
qcom,pon-type = <PON_POWER_ON_TYPE_RESIN>;
qcom,support-reset = <1>;
@@ -272,6 +265,7 @@ examples:
linux,code = <KEY_VOLUMEDOWN>;
qcom,use-bark;
};
qcom,pon_3 {
qcom,pon-type = <PON_POWER_ON_TYPE_KPDPWR_RESIN>;
qcom,support-reset = <1>;
@@ -300,7 +294,7 @@ examples:
compatible = "qcom,qpnp-power-on";
reg = <0x1300>, <0x800>;
reg-names = "pon_hlos", "pon_pbs";
interrupts = <0x0 0x13 0x7 IRQ_TYPE_EDGE_BOTH>
interrupts = <0x0 0x13 0x7 IRQ_TYPE_EDGE_BOTH>,
<0x0 0x13 0x6 IRQ_TYPE_EDGE_BOTH>;
interrupt-names = "kpdpwr", "resin";
qcom,kpdpwr-sw-debounce;
@@ -309,6 +303,7 @@ examples:
qcom,pon-type = <PON_POWER_ON_TYPE_KPDPWR>;
linux,code = <KEY_POWER>;
};
qcom,pon_2 {
qcom,pon-type = <PON_POWER_ON_TYPE_RESIN>;
linux,code = <KEY_VOLUMEDOWN>;