Re: [PATCH v12 1/7] dt-bindings: net: bluetooth: Add device tree bindings for QTI chip wcn3990

[Matthias Kaehlcke]

On Thu, Aug 02, 2018 at 11:35:54PM +0530, Balakrishna Godavarthi wrote:
> Hi Matthias,
> 
> On 2018-08-02 23:24, Balakrishna Godavarthi wrote:
> > Hi Matthias,
> > 
> > On 2018-08-02 22:50, Matthias Kaehlcke wrote:
> > > On Thu, Aug 02, 2018 at 06:55:12PM +0530, Balakrishna Godavarthi
> > > wrote:
> > > > This patch enables regulators for the Qualcomm Bluetooth wcn3990
> > > > controller.
> > > > 
> > > > Signed-off-by: Balakrishna Godavarthi <bgodavar@xxxxxxxxxxxxxx>
> > > > Reviewed-by: Rob Herring <robh@xxxxxxxxxx>
> > > > ---
> > > >  .../bindings/net/qualcomm-bluetooth.txt       | 26
> > > > +++++++++++++++++--
> > > >  1 file changed, 24 insertions(+), 2 deletions(-)
> > > > 
> > > > diff --git
> > > > a/Documentation/devicetree/bindings/net/qualcomm-bluetooth.txt
> > > > b/Documentation/devicetree/bindings/net/qualcomm-bluetooth.txt
> > > > index 0ea18a53cc29..2175174415ee 100644
> > > > --- a/Documentation/devicetree/bindings/net/qualcomm-bluetooth.txt
> > > > +++ b/Documentation/devicetree/bindings/net/qualcomm-bluetooth.txt
> > > > @@ -10,12 +10,22 @@ device the slave device is attached to.
> > > >  Required properties:
> > > >   - compatible: should contain one of the following:
> > > >     * "qcom,qca6174-bt"
> > > > +   * "qcom,wcn3990-bt"
> > > > +
> > > > +Optional properties for compatible string qcom,qca6174-bt:
> > > > 
> > > > -Optional properties:
> > > >   - enable-gpios: gpio specifier used to enable chip
> > > >   - clocks: clock provided to the controller (SUSCLK_32KHZ)
> > > > 
> > > > -Example:
> > > > +Optional properties for compatible string qcom,wcn3990-bt:
> > > > +
> > > > + - vddio-supply: Bluetooth wcn3990 VDD_IO supply regulator handle.
> > > > + - vddxo-supply: Bluetooth wcn3990 VDD_XO supply regulator handle.
> > > > + - vddrf-supply: Bluetooth wcn3990 VDD_RF supply regulator handle.
> > > > + - vddch0-supply: Bluetooth wcn3990 VDD_CH0 supply regulator handle.
> > > 
> > > Are these really optional? If I understand correctly the driver
> > > expects the regulators to be there. Even if it could do with only some
> > > regulators specified the devm_regulator_bulk_get() call would fail if
> > > not all requested regulators are available.
> > 
> > yes they are required along with compatible string "qcom,wcn3990-bt".
> > i have taken reference wrt compatible string "qcom,qca6174-bt".
> > In which clocks and enable-gpios are required for driver to work, but
> > it was written as optional in doc.
> > 
> > below snippet from hci_qca.c for qcom,qca6174-bt.
> > 
> >  if (IS_ERR(qcadev->bt_en)) {
> >        dev_err(&serdev->dev, "failed to acquire enable gpio\n");
> >        return PTR_ERR(qcadev->bt_en);
> >     }
> > 
> >   qcadev->susclk = devm_clk_get(&serdev->dev, NULL);
> >   if (IS_ERR(qcadev->susclk)) {
> >       dev_err(&serdev->dev, "failed to acquire clk\n");
> >        return PTR_ERR(qcadev->susclk);
> >      }
> 
> technically it is not correct then i will update as below
> 
> Required properties for compatible string qcom,wcn3990-bt:
> 
>  - vddio-supply: Bluetooth wcn3990 VDD_IO supply regulator handle.
>  - vddxo-supply: Bluetooth wcn3990 VDD_XO supply regulator handle.
>  - vddrf-supply: Bluetooth wcn3990 VDD_RF supply regulator handle.
>  - vddch0-supply: Bluetooth wcn3990 VDD_CH0 supply regulator handle.
> 
> Optional properties for compatible string qcom,wcn3990-bt:
> 
>  - max-speed: see Documentation/devicetree/bindings/serial/slave-device.txt
> 
> are they above ok?


Looks good to me.

Optionally you could remove the 'Bluetooth wcn3990' part in the
regulator description, it is a bit redundant since it's already said
that these are properties for the 'Bluetooth wcn3990' compatible
string.