Commit 92c3974c authored by David Heidelberg's avatar David Heidelberg Committed by Rob Herring
Browse files

dt-binding: soc: qcom: convert Qualcomm Command DB documentation to yaml



Convert Qualcomm Command DB documentation into yaml format.

Signed-off-by: default avatarDavid Heidelberg <david@ixit.cz>
Signed-off-by: default avatarRob Herring <robh@kernel.org>
Link: https://lore.kernel.org/r/20211218184617.19923-1-david@ixit.cz
parent f3a9f2b2
Loading
Loading
Loading
Loading
+0 −37
Original line number Diff line number Diff line
Command DB
---------

Command DB is a database that provides a mapping between resource key and the
resource address for a system resource managed by a remote processor. The data
is stored in a shared memory region and is loaded by the remote processor.

Some of the Qualcomm Technologies Inc SoC's have hardware accelerators for
controlling shared resources. Depending on the board configuration the shared
resource properties may change. These properties are dynamically probed by the
remote processor and made available in the shared memory.

The bindings for Command DB is specified in the reserved-memory section in
devicetree. The devicetree representation of the command DB driver should be:

Properties:
- compatible:
	Usage: required
	Value type: <string>
	Definition: Should be "qcom,cmd-db"

- reg:
	Usage: required
	Value type: <prop encoded array>
	Definition: The register address that points to the actual location of
		    the Command DB in memory.

Example:

	reserved-memory {
		[...]
		reserved-memory@85fe0000 {
			reg = <0x0 0x85fe0000 0x0 0x20000>;
			compatible = "qcom,cmd-db";
			no-map;
		};
	};
+46 −0
Original line number Diff line number Diff line
# SPDX-License-Identifier: (GPL-2.0-only OR BSD-2-Clause)
%YAML 1.2
---
$id: "http://devicetree.org/schemas/reserved-memory/qcom,cmd-db.yaml#"
$schema: "http://devicetree.org/meta-schemas/core.yaml#"

title: Qualcomm Command DB

description: |
  Command DB is a database that provides a mapping between resource key and the
  resource address for a system resource managed by a remote processor. The data
  is stored in a shared memory region and is loaded by the remote processor.

  Some of the Qualcomm Technologies Inc SoC's have hardware accelerators for
  controlling shared resources. Depending on the board configuration the shared
  resource properties may change. These properties are dynamically probed by the
  remote processor and made available in the shared memory.

maintainers:
  - Bjorn Andersson <bjorn.andersson@linaro.org>

allOf:
  - $ref: "reserved-memory.yaml"

properties:
  compatible:
    const: qcom,cmd-db

required:
  - reg

unevaluatedProperties: false

examples:
  - |
    reserved-memory {
        #address-cells = <1>;
        #size-cells = <1>;
        ranges;

        reserved-memory@85fe0000 {
            reg = <0x85fe0000 0x20000>;
            compatible = "qcom,cmd-db";
            no-map;
        };
    };