Message ID | 20221123142009.594781-1-abel.vesa@linaro.org |
---|---|
Headers | show |
Series | clk: qcom: Add support for SM8550 | expand |
On Wed, 23 Nov 2022 16:20:02 +0200, Abel Vesa wrote: > Add bindings documentation for clock TCSR driver on SM8550. > > Signed-off-by: Abel Vesa <abel.vesa@linaro.org> > --- > > Changes since v1: > * based on recent bindings, like Krzysztof asked > * used qcom,gcc.yaml and dropped redundant properties > * used additionalProperties instead unevaluatedProperties > * renamed qcom,tcsrcc-sm8550.h to qcom,sm8550-tcsrcc.h, to match > compatible > * added dual lincese to qcom,sm8550-tcsrcc.h > * moved patch to the beginning of patchset > * dropped redundant "bindings" from subject line > > .../bindings/clock/qcom,sm8550-tcsrcc.yaml | 39 +++++++++++++++++++ > .../dt-bindings/clock/qcom,sm8550-tcsrcc.h | 18 +++++++++ > 2 files changed, 57 insertions(+) > create mode 100644 Documentation/devicetree/bindings/clock/qcom,sm8550-tcsrcc.yaml > create mode 100644 include/dt-bindings/clock/qcom,sm8550-tcsrcc.h > My bot found errors running 'make DT_CHECKER_FLAGS=-m dt_binding_check' on your patch (DT_CHECKER_FLAGS is new in v5.13): yamllint warnings/errors: dtschema/dtc warnings/errors: /builds/robherring/dt-review-ci/linux/Documentation/devicetree/bindings/clock/qcom,sm8550-tcsrcc.yaml: allOf:0: '$ref qcom,gcc.yaml#' is not of type 'object', 'boolean' from schema $id: http://json-schema.org/draft-07/schema# /builds/robherring/dt-review-ci/linux/Documentation/devicetree/bindings/clock/qcom,sm8550-tcsrcc.yaml: ignoring, error in schema: allOf: 0 Documentation/devicetree/bindings/clock/qcom,sm8550-tcsrcc.example.dtb:0:0: /example-0/clock-controller@1fc0000: failed to match any schema with compatible: ['qcom,sm8550-tcsrcc'] doc reference errors (make refcheckdocs): See https://patchwork.ozlabs.org/project/devicetree-bindings/patch/20221123142009.594781-3-abel.vesa@linaro.org This check can fail if there are any dependencies. The base for a patch series is generally the most recent rc1. If you already ran 'make dt_binding_check' and didn't see the above error(s), then make sure 'yamllint' is installed and dt-schema is up to date: pip3 install dtschema --upgrade Please check and re-submit after running the above command.
On 23/11/2022 15:20, Abel Vesa wrote: > Add device tree bindings for global clock controller on SM8550 SoCs. > > Signed-off-by: Abel Vesa <abel.vesa@linaro.org> > --- > > Changes since v1: > * dropped clock-names since driver uses IDs now > * based on recent bindings, like Krzysztof asked > * used qcom,gcc.yaml and dropped redundant properties > * renamed qcom,gcc-sm8550.h to qcom,sm8550-gcc.h, to match > compatible > * dropped "Optional", like Krzysztof asked > > .../bindings/clock/qcom,sm8550-gcc.yaml | 56 +++++ > include/dt-bindings/clock/qcom,sm8550-gcc.h | 231 ++++++++++++++++++ > 2 files changed, 287 insertions(+) > create mode 100644 Documentation/devicetree/bindings/clock/qcom,sm8550-gcc.yaml > create mode 100644 include/dt-bindings/clock/qcom,sm8550-gcc.h > > diff --git a/Documentation/devicetree/bindings/clock/qcom,sm8550-gcc.yaml b/Documentation/devicetree/bindings/clock/qcom,sm8550-gcc.yaml > new file mode 100644 > index 000000000000..acc540aa137d > --- /dev/null > +++ b/Documentation/devicetree/bindings/clock/qcom,sm8550-gcc.yaml > @@ -0,0 +1,56 @@ > +# SPDX-License-Identifier: (GPL-2.0-only OR BSD-2-Clause) > +%YAML 1.2 > +--- > +$id: http://devicetree.org/schemas/clock/qcom,sm8550-gcc.yaml# > +$schema: http://devicetree.org/meta-schemas/core.yaml# > + > +title: Qualcomm Global Clock & Reset Controller on SM8550 > + > +maintainers: > + - Bjorn Andersson <andersson@kernel.org> > + > +description: | > + Qualcomm global clock control module provides the clocks, resets and power > + domains on SM8550 > + > + See also:: include/dt-bindings/clock/qcom,sm8550-gcc.h > + > +properties: > + compatible: > + const: qcom,sm8550-gcc > + > + clocks: > + items: > + - description: Board XO source > + - description: Sleep clock source > + - description: PCIE 0 Pipe clock source > + - description: PCIE 1 Pipe clock source > + - description: PCIE 1 Phy Auxiliary clock source > + - description: UFS Phy Rx symbol 0 clock source > + - description: UFS Phy Rx symbol 1 clock source > + - description: UFS Phy Tx symbol 0 clock source > + - description: USB3 Phy wrapper pipe clock source > + minItems: 2 I didn't mention in your v1 this explicitly (although I asked Melody to drop it), so apologies for this. Based on my understand and our IRC discussion, these clocks are needed for the driver (even if optional in some states of hardware). If driver needs them, let's make them required, so please drop "minItems: 2". Best regards, Krzysztof