dt-bindings: soc: qcom: Add binding for adsp_sleepmon driver
Add binding for adsp_sleepmon driver in YAML. Change-Id: Ifa285e4a4fb38ab83a354cb23bb1c6a3a65ba47b Signed-off-by: Madhu Pagadoju <quic_mpagadoj@quicinc.com>
This commit is contained in:
Madhu Pagadoju
202
bindings/soc/qcom/adsp_sleepmon.yaml
Normal file
202
bindings/soc/qcom/adsp_sleepmon.yaml
Normal file
@@ -0,0 +1,202 @@
|
||||
# SPDX-License-Identifier: (GPL-2.0-only OR BSD-2-Clause)
|
||||
%YAML 1.2
|
||||
---
|
||||
$id: "http://devicetree.org/schemas/soc/qcom/adsp_sleepmon.yaml#"
|
||||
$schema: "http://devicetree.org/meta-schemas/core.yaml#"
|
||||
|
||||
title: Qualcomm Technologies, Inc. ADSP Sleep Monitor
|
||||
|
||||
description:
|
||||
The ADSP Sleep monitor driver tracks ADSP sleep statistics stored in SMEM region
|
||||
and establishes an interface with different userspace clients which make use of
|
||||
ADSP subsystem. Based on the activity notifications from the userspace clients
|
||||
for activity start and stop notifications, the driver detects and logs an error
|
||||
message in kernel logs and creates a kernel/ADSP panic (when enabled) upon detecting
|
||||
a violation in ADSP sleep/LPI state after the configured monitoring duration.
|
||||
By default the driver emits out kernel message on detecting these violations,
|
||||
optionally a kernel/ADSP panic can be enabled separately for ADSP sleep or LPI
|
||||
issues via this config. When enabled, corresponding panics can be
|
||||
disabled/re-enabled runtime via debugfs node exposed from the driver.
|
||||
|
||||
"echo 0 > /d/adspsleepmon/panic-state"
|
||||
Disables kernel panic for ADSP sleep and LPI voilations.
|
||||
|
||||
"echo 1 > /d/adspsleepmon/panic-state"
|
||||
Enables kernel panic for ADSP sleep voilations.
|
||||
|
||||
"echo 2 > /d/adspsleepmon/panic-state"
|
||||
Enables kernel panic for ADSP LPI voilations.
|
||||
|
||||
"echo 3 > /d/adspsleepmon/panic-state"
|
||||
Enables kernel panic for ADSP Sleep and LPI voilations.
|
||||
|
||||
"cat /d/adspsleepmon/read_panic_state"
|
||||
Displays the current panic enablement status
|
||||
|
||||
"echo 0 > /d/adspsleepmon/adsp_panic_state"
|
||||
Disables ADSP panic for ADSP sleep and LPI voilations.
|
||||
|
||||
"echo 1 > /d/adspsleepmon/adsp_panic_state"
|
||||
Enables ADSP panic for ADSP sleep voilations.
|
||||
|
||||
"echo 2 > /d/adspsleepmon/adsp_panic_state"
|
||||
Enables ADSP panic for ADSP LPI voilations.
|
||||
|
||||
"echo 3 > /d/adspsleepmon/adsp_panic_state"
|
||||
Enables ADSP panic for ADSP Sleep and LPI voilations.
|
||||
|
||||
"echo 4 > /d/adspsleepmon/adsp_panic_state"
|
||||
Enable ADSP panic on ADSP sleep monitor detecting
|
||||
continuous ADSP sleep violation for qcom,wait_time_lpm_overall
|
||||
duration over qcom,min_required_resumes CPU resumes when there
|
||||
is no audio activity.
|
||||
|
||||
"echo 7 > /d/adspsleepmon/adsp_panic_state"
|
||||
Enable ADSP panic on ADSP sleep monitor detecting
|
||||
continuous ADSP sleep violation for qcom,wait_time_lpm_overall
|
||||
duration over qcom,min_required_resumes CPU resumes when there
|
||||
is no audio activity along with ADSP panic for ADSP sleep and LPI
|
||||
voilations for audio clients.
|
||||
|
||||
"cat /d/adspsleepmon/read_adsp_panic_state"
|
||||
Displays the current ADSP panic enablement status
|
||||
|
||||
"cat /d/adspsleepmon/read_panic_state"
|
||||
|
||||
>Panic State: LPM and LPI panics Disabled
|
||||
|
||||
"cat /d/adspsleepmon/read_panic_state"
|
||||
|
||||
>Panic State: LPI Panic enabled
|
||||
|
||||
maintainers:
|
||||
- Madhu Pagadoju<quic_mpagadoj@quicinc.com>
|
||||
- Rakesh Kundaram<quic_krakeshk@quicinc.com>
|
||||
|
||||
properties:
|
||||
required:
|
||||
compatible:
|
||||
const: qcom,adsp-sleepmon
|
||||
optional:
|
||||
qcom,wait_time_lpm:
|
||||
$ref: /schemas/types.yaml#/definitions/uint32
|
||||
maxItems: 1
|
||||
default: 5
|
||||
description:
|
||||
wait time in seconds for LPM violation detections.
|
||||
The ADSP sleep monitor would wait for the specified
|
||||
duration after all the activities are done
|
||||
(based on user space clients activity notifications)
|
||||
before checking ADSP state.
|
||||
|
||||
qcom,wait_time_lpi:
|
||||
$ref: /schemas/types.yaml#/definitions/uint32
|
||||
maxItems: 1
|
||||
default: 15
|
||||
description:
|
||||
wait time in seconds for LPI violation detections.
|
||||
The ADSP sleep monitor would wait for the specified
|
||||
duration after the start of an LPI only activity
|
||||
(based on user space clients activity notifications)
|
||||
before checking ADSP state.
|
||||
|
||||
qcom,wait_time_lpm_overall:
|
||||
$ref: /schemas/types.yaml#/definitions/uint32
|
||||
maxItems: 1
|
||||
default: 60
|
||||
description:
|
||||
Minimum monitoring duration in seconds required for sleep
|
||||
violation detection when there is no audio activity.
|
||||
ADSP sleep monitor raises ADSP panic (if enabled via
|
||||
qcom,enable_adsp_panic_lpm_overall) on detecting sleep
|
||||
violation continuously for a minimum of this specified
|
||||
duration over qcom,min_required_resumes number of CPU resumes.
|
||||
|
||||
qcom,min_required_resumes:
|
||||
$ref: /schemas/types.yaml#/definitions/uint32
|
||||
maxItems: 1
|
||||
default: 5
|
||||
description:
|
||||
Minimum number of CPU resumes required for sleep violation detection
|
||||
and action when there is no audio activity. ADSP sleep monitor raises
|
||||
ADSP panic (if enabled via qcom,enable_adsp_panic_lpm_overall)
|
||||
on detecting sleep violation continuously for a minimum of
|
||||
qcom,wait_time_lpm_overall duration over the specified number
|
||||
of CPU resumes.
|
||||
|
||||
qcom,enable_panic_lpm:
|
||||
type: boolean
|
||||
default: false
|
||||
description:
|
||||
Enables kernel panic on detecting ADSP sleep violations.
|
||||
|
||||
qcom,enable_panic_lpi:
|
||||
type: boolean
|
||||
default: false
|
||||
description:
|
||||
Enables kernel panic on detecting ADSP LPI violations.
|
||||
|
||||
qcom,enable_adsp_panic_lpm:
|
||||
type: boolean
|
||||
default: false
|
||||
description:
|
||||
Enables ADSP panic on detecting ADSP sleep violations.
|
||||
|
||||
qcom,enable_adsp_panic_lpi:
|
||||
type: boolean
|
||||
default: false
|
||||
description:
|
||||
Enables ADSP panic on detecting ADSP LPI violations.
|
||||
|
||||
qcom,enable_adsp_panic_lpm_overall:
|
||||
type: boolean
|
||||
default: false
|
||||
description:
|
||||
Enable ADSP panic on ADSP sleep monitor detecting
|
||||
continuous ADSP sleep violation for qcom,wait_time_lpm_overall
|
||||
duration over qcom,min_required_resumes CPU resumes when there
|
||||
is no audio activity.
|
||||
ADSP sleep monitor doesn't track non-audio activities on ADSP.
|
||||
The panic can result in false positives if ADSP is kept active for
|
||||
the specified duration by a non-audio entity
|
||||
(sensors, camera, charger, wifi paging etc.). When enabling, the
|
||||
minimum duration and number of CPU resumes should be fine tuned based
|
||||
on the expected non-audio use case scenarios on ADSP.
|
||||
|
||||
qcom,rproc-handle:
|
||||
$ref: /schemas/types.yaml#/definitions/phandle
|
||||
description:
|
||||
ADSP rproc handle.
|
||||
Providing the rproc handle converts any ADSP panics, if enabled
|
||||
via enable panic options, into ADSP subsystem restarts (SSR).
|
||||
|
||||
examples:
|
||||
adsp_sleepmon: adsp-sleepmon {
|
||||
compatible = "qcom,adsp-sleepmon";
|
||||
qcom,wait_time_lpm = <5>;
|
||||
qcom,wait_time_lpi = <15>;
|
||||
qcom,enable_adsp_panic_lpm;
|
||||
qcom,enable_adsp_panic_lpi;
|
||||
qcom,wait_time_lpm_overall = <60>;
|
||||
qcom,enable_adsp_panic_lpm_overall;
|
||||
qcom,min_required_resumes = <5>;
|
||||
qcom,rproc-handle = <&adsp_pas>;
|
||||
};
|
||||
|
||||
properties:
|
||||
required:
|
||||
compatible:
|
||||
const: qcom,msm-adspsleepmon-rpmsg
|
||||
qcom,glink-channels:
|
||||
description:
|
||||
Glink channel for communication with ADSP
|
||||
qcom,intents:
|
||||
description:
|
||||
A list of <size of each intent, number of intents>
|
||||
|
||||
examples:
|
||||
qcom,msm_adspsleepmon_rpmsg {
|
||||
compatible = "qcom,msm-adspsleepmon-rpmsg";
|
||||
qcom,glink-channels = "sleepmonglink-apps-adsp";
|
||||
qcom,intents = <0x1000 8>;
|
||||
};
|
||||
Reference in New Issue
Block a user