From f55597c8d19375d4a2c14b4aa82ccb1182064b8f Mon Sep 17 00:00:00 2001 From: David Collins Date: Fri, 21 Jul 2023 16:53:48 -0700 Subject: [PATCH] dt-bindings: soc: qcom: add PMIC PON log bindings Add Qualcomm Technologies, Inc. PMIC PON log device bindings. The PMIC PON log device parses power-on, power-off, and fault messages stored in a binary log within the SDAM memory found on some QTI PMIC devices. This is a snapshot of the file qcom,pmic-pon-log.txt taken as of qcom-6.1 branch commit 8e58283f0a59 ("dt-bindings: soc: qcom: pmic-pon-log: define bindings for multiple nvmem") which was then converted to yaml format. Change-Id: I6256c17a8334e5ae721427c5d4f1d3352dc72daf Signed-off-by: David Collins --- bindings/soc/qcom/qcom,pmic-pon-log.yaml | 58 ++++++++++++++++++++++++ 1 file changed, 58 insertions(+) create mode 100644 bindings/soc/qcom/qcom,pmic-pon-log.yaml diff --git a/bindings/soc/qcom/qcom,pmic-pon-log.yaml b/bindings/soc/qcom/qcom,pmic-pon-log.yaml new file mode 100644 index 00000000..e944b49b --- /dev/null +++ b/bindings/soc/qcom/qcom,pmic-pon-log.yaml @@ -0,0 +1,58 @@ +# SPDX-License-Identifier: (GPL-2.0-only OR BSD-2-Clause) +%YAML 1.2 +--- +$id: http://devicetree.org/schemas/soc/qcom/qcom,pmic-pon-log.yaml# +$schema: http://devicetree.org/meta-schemas/core.yaml# + +title: Qualcomm Technologies, Inc. PMIC PON Log + +maintainers: + - David Collins + +description: | + Certain Qualcomm Technologies, Inc. PMIC devices capture power-on, power-off, + and fault information in a binary log found within SDAM peripherals. The PMIC + PON Log device accesses this log and parses it into a human readable format. + +$ref: /schemas/nvmem/nvmem-consumer.yaml# + +properties: + compatible: + const: qcom,pmic-pon-log + + nvmem: + oneOf: + - items: + - description: PON log NVMEM phandle + - items: + - description: PON log 0 NVMEM phandle + - description: PON log 1 NVMEM phandle + + nvmem-names: + oneOf: + - items: + - const: pon_log + - items: + - const: pon_log0 + - const: pon_log1 + + qcom,pmic-fault-panic: + description: | + Boolean flag indicating that the device should trigger a controlled panic + shutdown if the preceding restart was caused by a PMIC fault. + type: boolean + +required: + - compatible + - nvmem + - nvmem-names + +additionalProperties: false + +examples: + - | + pmic-pon-log { + compatible = "qcom,pmic-pon-log"; + nvmem = <&pmk8550_sdam_5>, <&pmk8550_sdam_6>; + nvmem-names = "pon_log0", "pon_log1"; + };