diff mbox series

[v3,1/6] dt-bindings: arm: qcom: Document qcs8550 SoC and board

Message ID 20231219005007.11644-2-quic_tengfan@quicinc.com
State New
Headers show
Series arm64: qcom: add AIM300 AIoT board support | expand

Commit Message

Tengfei Fan Dec. 19, 2023, 12:50 a.m. UTC
Document the qcs8550 SoC and the AIM300 AIoT board bindings.
AIM300 Series is a highly optimized family of modules designed to support
AIoT applications. The Module is mounted onto Qualcomm AIoT carrier board
to support verification, evaluation and development.
AIM stands for Artificial Intelligence Module. AIoT stands for AI IoT.

Reviewed-by: Krzysztof Kozlowski <krzysztof.kozlowski@linaro.org>
Signed-off-by: Tengfei Fan <quic_tengfan@quicinc.com>
---
 Documentation/devicetree/bindings/arm/qcom.yaml | 7 +++++++
 1 file changed, 7 insertions(+)

Comments

Krzysztof Kozlowski Dec. 19, 2023, 6:56 a.m. UTC | #1
On 19/12/2023 01:50, Tengfei Fan wrote:
> Document the qcs8550 SoC and the AIM300 AIoT board bindings.
> AIM300 Series is a highly optimized family of modules designed to support
> AIoT applications. The Module is mounted onto Qualcomm AIoT carrier board
> to support verification, evaluation and development.
> AIM stands for Artificial Intelligence Module. AIoT stands for AI IoT.
> 
> Reviewed-by: Krzysztof Kozlowski <krzysztof.kozlowski@linaro.org>

Drop

> Signed-off-by: Tengfei Fan <quic_tengfan@quicinc.com>
> ---
>  Documentation/devicetree/bindings/arm/qcom.yaml | 7 +++++++
>  1 file changed, 7 insertions(+)
> 
> diff --git a/Documentation/devicetree/bindings/arm/qcom.yaml b/Documentation/devicetree/bindings/arm/qcom.yaml
> index 1a5fb889a444..a0e3cf271cfe 100644
> --- a/Documentation/devicetree/bindings/arm/qcom.yaml
> +++ b/Documentation/devicetree/bindings/arm/qcom.yaml
> @@ -49,6 +49,7 @@ description: |
>          msm8996
>          msm8998
>          qcs404
> +        qcs8550
>          qcm2290
>          qcm6490
>          qdu1000
> @@ -904,6 +905,12 @@ properties:
>            - const: qcom,qcs404-evb
>            - const: qcom,qcs404
>  
> +      - items:
> +          - enum:
> +              - qcom,qcs8550-aim300-aiot
> +          - const: qcom,qcs8550-aim300
> +          - const: qcom,qcs8550

Missing compatible. Please read previous discussions.

Best regards,
Krzysztof
Krzysztof Kozlowski Dec. 19, 2023, 10:10 a.m. UTC | #2
On 19/12/2023 10:45, Aiqun Yu (Maria) wrote:
>>> +      - items:
>>> +          - enum:
>>> +              - qcom,qcs8550-aim300-aiot
>>> +          - const: qcom,qcs8550-aim300
>>> +          - const: qcom,qcs8550
> Need to add below line here, right?
> +          - const: qcom,sm8550

Yes.

>>
>> Missing compatible. Please read previous discussions.
> The previous comments was missed. Just double confirm here for 
> "fallback" meaning here.
> 
> Could you pls also double confirm for my understandings for the 
> compatible rules?

Compatible rules were expressed in Devicetree specification and also
writing-bindings document.

> As long as sm8550 was designed "hardware compatible"(pin-to-pin 
> compatible) and "software firmware compatible"(firmware also support 
> sm8550) to qcs8550, it is request to add compatible sm8550 to current 
> compatible sequence like: board/SOM/soc/base soc.

I understood before that firmware is not compatible. Are there any
changes now?

The understanding was that your new SoC is stripped down SM8550, thus
you will be using almost all of the SM8550 DTSI. If you use all of
device nodes, the devices are compatible, aren't they? If they are
compatible, then the writing-bindings document asks you to do add
specific compatible.

Please reach internally within Qualcomm for some initial guidance how
DTS and DTSI looks like, so reviewers on mailing list won't need to
explain it.

This week it is third comment like this on mailing lists for three
different patchsets. It is great that you send code upstream. Big
companies however are expected to do some internal work first, instead
of relying on the community.

> 
> Note that, we don't really have hardware like "sm8550 inside aim300".

I really don't know what do you have and I did not find any explanation
of QCS8550 in this commit msg which brings new compatible.

Best regards,
Krzysztof
diff mbox series

Patch

diff --git a/Documentation/devicetree/bindings/arm/qcom.yaml b/Documentation/devicetree/bindings/arm/qcom.yaml
index 1a5fb889a444..a0e3cf271cfe 100644
--- a/Documentation/devicetree/bindings/arm/qcom.yaml
+++ b/Documentation/devicetree/bindings/arm/qcom.yaml
@@ -49,6 +49,7 @@  description: |
         msm8996
         msm8998
         qcs404
+        qcs8550
         qcm2290
         qcm6490
         qdu1000
@@ -904,6 +905,12 @@  properties:
           - const: qcom,qcs404-evb
           - const: qcom,qcs404
 
+      - items:
+          - enum:
+              - qcom,qcs8550-aim300-aiot
+          - const: qcom,qcs8550-aim300
+          - const: qcom,qcs8550
+
       - items:
           - enum:
               - qcom,sa8155p-adp