Thanks Rob for the review,
On 28/07/2021 18:36, Rob Herring wrote:
On Wed, Jul 14, 2021 at 04:30:27PM +0100, Srinivas Kandagatla wrote:
This patch adds bindings support for Qualcomm Audio Processing Manager service in Audio DSP.
Audio Process Manager is one of the static service in DSP which is responsible for Command/response handling, graph Management and Control/Event management between modules.
This all looks fairly similar to the prior Qcom audio binding(s). It would be nice to not see this all re-invented.
AudioReach is a new DSP signal processing framework Which is different to its previous DSP firmware(aka Elite). It makes use of ASoC Topology to load audio graphs on to the DSP which is then managed by APM (Audio Processing Manager) service.
So internals are not exactly same.
From device tree side we might end up with similar layout, but there are some subtle differences like clocks are managed by q6prm service instead of q6afe service in old firmware, front-end pcm dais definitions come from ASoC topology.
Are you suggesting that we should reuse the old bindings (q6afe, q6asm) by add new compatible strings along with differences ?
Signed-off-by: Srinivas Kandagatla srinivas.kandagatla@linaro.org
.../devicetree/bindings/sound/qcom,q6apm.yaml | 87 +++++++++++++++++++ include/dt-bindings/sound/qcom,q6apm.h | 8 ++ 2 files changed, 95 insertions(+) create mode 100644 Documentation/devicetree/bindings/sound/qcom,q6apm.yaml create mode 100644 include/dt-bindings/sound/qcom,q6apm.h
diff --git a/Documentation/devicetree/bindings/sound/qcom,q6apm.yaml b/Documentation/devicetree/bindings/sound/qcom,q6apm.yaml new file mode 100644 index 000000000000..6f27567523a9 --- /dev/null +++ b/Documentation/devicetree/bindings/sound/qcom,q6apm.yaml @@ -0,0 +1,87 @@ +# SPDX-License-Identifier: (GPL-2.0 OR BSD-2-Clause) +%YAML 1.2 +--- +$id: "http://devicetree.org/schemas/sound/qcom,q6apm.yaml#" +$schema: "http://devicetree.org/meta-schemas/core.yaml#"
+title: Qualcomm Audio Process Manager binding
+maintainers:
- Srinivas Kandagatla srinivas.kandagatla@linaro.org
+description: |
- This binding describes the Qualcomm Audio Process Manager service in DSP
+properties:
- compatible:
- const: qcom,q6apm
- reg:
- maxItems: 1
- '#address-cells':
- const: 1
- '#size-cells':
- const: 0
+#APM Services +patternProperties:
- 'apm@[0-9]+$':
This means '.*apm' for the node name. Did you need a '^'?
yes we need begins with '^' , will add that in next version.
- type: object
- description:
APM devices use subnodes for services.
- properties:
compatible:
enum:
- qcom,q6apm-dais
- qcom,q6apm-bedais
iommus:
maxItems: 1
"#sound-dai-cells":
const: 1
reg:
maxItems: 1
- required:
- compatible
- reg
- '#sound-dai-cells'
- additionalProperties: false
+required:
- compatible
- reg
+additionalProperties: false
+examples:
- |
- gpr {
#address-cells = <1>;
#size-cells = <0>;
gprservice@1 {
compatible = "qcom,q6apm";
reg = <1>;
#address-cells = <1>;
#size-cells = <0>;
apm@1 {
compatible = "qcom,q6apm-dais";
#sound-dai-cells = <1>;
reg = <1>;
};
apm@2 {
compatible = "qcom,q6apm-bedais";
#sound-dai-cells = <1>;
reg = <2>;
};
};
- };
diff --git a/include/dt-bindings/sound/qcom,q6apm.h b/include/dt-bindings/sound/qcom,q6apm.h new file mode 100644 index 000000000000..3c3987eb6e95 --- /dev/null +++ b/include/dt-bindings/sound/qcom,q6apm.h @@ -0,0 +1,8 @@ +/* SPDX-License-Identifier: GPL-2.0 */ +#ifndef __DT_BINDINGS_Q6_APM_H__ +#define __DT_BINDINGS_Q6_APM_H__
+/* Audio Process Manager (APM) virtual ports IDs */ +#include <dt-bindings/sound/qcom,q6afe.h>
Why add this indirection? Rename the file if you need something to cover both.
Thats a good idea,
These are basically audio endpoint device ids which should be same across different audio firmwares.
I can rename this to dt-bindings/sound/qcom,adsp-audio-ports.h or something more generic to be able to reuse.
--srini
+#endif /* __DT_BINDINGS_Q6_APM_H__ */
2.21.0