All of lore.kernel.org
 help / color / mirror / Atom feed
From: Vitor Soares <Vitor.Soares@synopsys.com>
To: Andy Shevchenko <andy.shevchenko@gmail.com>,
	Vitor soares <Vitor.Soares@synopsys.com>
Cc: Boris Brezillon <boris.brezillon@bootlin.com>,
	Wolfram Sang <wsa@the-dreams.de>,
	linux-i2c <linux-i2c@vger.kernel.org>,
	Jonathan Corbet <corbet@lwn.net>,
	Linux Documentation List <linux-doc@vger.kernel.org>,
	Greg Kroah-Hartman <gregkh@linuxfoundation.org>,
	Arnd Bergmann <arnd@arndb.de>,
	Przemyslaw Sroka <psroka@cadence.com>,
	Arkadiusz Golec <agolec@cadence.com>,
	Alan Douglas <adouglas@cadence.com>,
	Bartosz Folta <bfolta@cadence.com>, Damian Kos <dkos@cadence.com>,
	Alicja Jurasik-Urbaniak <alicja@cadence.com>,
	Cyprian Wronka <cwronka@cadence.com>,
	Suresh Punnoose <sureshp@cadence.com>,
	Rafal Ciepiela <rafalc@cadence.com>,
	Thomas Petazzoni <thomas.petazzoni@bootlin.com>,
	Nishanth Menon <nm@ti.com>, Rob Herring <robh+dt@kernel.org>,
	Pawel Moll <pawel.moll@arm.com>,
	Mark Rutland <mark.rutland@arm.com>,
	ijc+devicetree <ijc+devicetree@hellion.org.uk>,
	Kumar Gala <galak@codeaurora.org>,
	devicetree <devicetree@vger.kernel.org>,
	Linux Kernel Mailing List <linux-kernel@vger.kernel.org>,
	"Geert Uytterhoeven" <geert@linux-m68k.org>,
	Linus Walleij <linus.walleij@linaro.org>,
	Xiang Lin <Xiang.Lin@synaptics.com>,
	"open list:GPIO SUBSYSTEM" <linux-gpio@vger.kernel.org>,
	Sekhar Nori <nsekhar@ti.com>, Przemyslaw Gaj <pgaj@cadence.com>,
	Peter Rosin <peda@axentia.se>,
	Joao Pinto <Joao.Pinto@synopsys.com>
Subject: Re: [PATCH 1/3] i3c: master: Add driver for Synopsys DesignWare IP
Date: Wed, 25 Jul 2018 09:43:48 +0100	[thread overview]
Message-ID: <9fdfaf4e-5a20-af81-82ef-0d9e327f9133@synopsys.com> (raw)
In-Reply-To: <CAHp75VfYYmr7o6xkDbjaad3HxyzZgODzKfSNWdPXjM+YjTMANA@mail.gmail.com>

[-- Attachment #1: Type: text/plain, Size: 4251 bytes --]

Hi Andy,


Às 4:35 PM de 7/21/2018, Andy Shevchenko escreveu:
> On Fri, Jul 20, 2018 at 11:57 PM, Vitor soares
> <Vitor.Soares@synopsys.com> wrote:
>> This patch add driver for Synopsys DesignWare IP on top of
>> I3C subsystem patchset proposal V6
> Some of comments below related to style.
> But unaligned helpers I think is good to use.
>
>> +#include <linux/bitops.h>

Bit operations API eg: GENMASK...

>> +#include <linux/clk.h>

Clock API eg: master->core_clk = devm_clk_get(&pdev->dev, "core_clk");

>> +#include <linux/completion.h>

Completion API eg: struct completion

>> +#include <linux/err.h>

Check kernel pointer eg: return PTR_ERR(master->regs);

>> +#include <linux/errno.h>

Error codes eg: return -ENOTSUPP;

>> +#include <linux/i3c/master.h>

I3C Master API eg: i3c_master_register()

>> +#include <linux/init.h>

Not needed.

>> +#include <linux/interrupt.h>

Interrupt API eg: devm_request_irq().

>> +#include <linux/io.h>
>> +#include <linux/ioport.h>

Used to get io resource.

>> +#include <linux/iopoll.h>
 this function: readl_poll_timeout_atomic().

>> +#include <linux/module.h>

Module API.

>> +#include <linux/platform_device.h>

Platform driver API.

>> +#include <linux/reset.h>

Reset API.

> All of them required? Why?

There is some header files that are already included by others header files.
Should I add them too? it there any rule for that?
Thank for the advice.

>> +       default:
> Just return false here?

Yes, it makes more sense.

>> +               break;
>> +       }
>> +
>> +       return false;
>> +       for (i = 0; i < nbytes; i += 4) {
>> +               u32 data = 0;
>> +
>> +               for (j = 0; j < 4 && (i + j) < nbytes; j++)
>> +                       data |= (u32)bytes[i + j] << (j * 8);
> NIH of get_unaligned_le32()
>
>> +
>> +               writel(data, master->regs + RX_TX_DATA_PORT);
>> +       }
>> +}
>> +
>> +static void dw_i3c_master_read_rx_fifo(struct dw_i3c_master *master,
>> +                                      u8 *bytes, int nbytes)
>> +{
>> +       int i, j;
>> +
>> +       for (i = 0; i < nbytes; i += 4) {
>> +               u32 data;
>> +
>> +               data = readl(master->regs + RX_TX_DATA_PORT);
>> +
>> +               for (j = 0; j < 4 && (i + j) < nbytes; j++)
>> +                       bytes[i + j] = data >> (j * 8);
> Ditto put_unaligned_le32() ?
>
>> +       }
>> +}
> I'm wondering what else you open coded instead of using helpers we already have.

I will see how it works to implement.

>> +               writel(cmd->cmd_hi, master->regs + COMMAND_QUEUE_PORT);
>> +               writel(cmd->cmd_lo, master->regs + COMMAND_QUEUE_PORT);
> hmm... writesl()?

Is there any advantage here?

Probably I can use it to fill the TX buffer with this.

>> +       info->pid = (u64)readl(master->regs + SLV_PID_VALUE);
> Why explicit casting?

info->pid is u64 size.

>
>> +       u32 r;
>> +
>> +
>> +       core_rate = clk_get_rate(master->core_clk);
> Too many blank lines in between.

For me in that way it's better to filter code parts. Do you think that is not
readable?

>> +
>> +
> Ditto.
>
>> +       /* Prepare DAT before launching DAA. */
>> +       for (pos = 0; pos < master->maxdevs; pos++) {
>> +               if (olddevs & BIT(pos))
>> +                       continue;
>> +
>> +               ret = i3c_master_get_free_addr(m, last_addr + 1);
>> +               if (ret < 0)
>> +                       return -ENOSPC;
>> +               master->addrs[pos] = ret;
>> +               p = (ret >> 6) ^ (ret >> 5) ^ (ret >> 4) ^ (ret >> 3) ^
>> +                   (ret >> 2) ^ (ret >> 1) ^ ret ^ 1;
>> +               p = p & 1;
> Is it parity calculus? Do we have something implemented in kernel already?
>
> Btw, https://urldefense.proofpoint.com/v2/url?u=https-3A__graphics.stanford.edu_-7Eseander_bithacks.html-23ParityNaive&d=DwIBaQ&c=DPL6_X_6JkXFx7AXWqB0tg&r=qVuU64u9x77Y0Kd0PhDK_lpxFgg6PK9PateHwjb_DY0&m=5FpGHBbT8tYA6PB4RT_9O6PJk3v-wYcy1MV59xoqK4I&s=FSJ3EcuoxPtRJWmsk9Yt4s_UH9kxFBam01Xvas2ZFdo&e=
> offered this
>
> v ^= v >> 4;
> v &= 0xf;
> v = (0x6996 >> v) & 1;

I search into the kernel and I didn't find any function for that. In your
opinion what shoud I use?


Thanks for your feedback.

Regards,
Vitor Soares


[-- Attachment #2: Type: text/html, Size: 10545 bytes --]

WARNING: multiple messages have this Message-ID (diff)
From: Vitor Soares <Vitor.Soares@synopsys.com>
To: Andy Shevchenko <andy.shevchenko@gmail.com>,
	Vitor soares <Vitor.Soares@synopsys.com>
Cc: Boris Brezillon <boris.brezillon@bootlin.com>,
	Wolfram Sang <wsa@the-dreams.de>,
	linux-i2c <linux-i2c@vger.kernel.org>,
	Jonathan Corbet <corbet@lwn.net>,
	Linux Documentation List <linux-doc@vger.kernel.org>,
	Greg Kroah-Hartman <gregkh@linuxfoundation.org>,
	Arnd Bergmann <arnd@arndb.de>,
	Przemyslaw Sroka <psroka@cadence.com>,
	Arkadiusz Golec <agolec@cadence.com>,
	Alan Douglas <adouglas@cadence.com>,
	Bartosz Folta <bfolta@cadence.com>, Damian Kos <dkos@cadence.com>,
	Alicja Jurasik-Urbaniak <alicja@cadence.com>,
	Cyprian Wronka <cwronka@cadence.com>,
	Suresh Punnoose <sureshp@cadence.com>,
	Rafal Ciepiela <rafalc@cadence.com>,
	Thomas Petazzoni <thomas.petazzoni@bootlin.com>,
	Nishanth Menon <nm@ti.com>, Rob Herring <robh+dt@kernel.org>
Subject: Re: [PATCH 1/3] i3c: master: Add driver for Synopsys DesignWare IP
Date: Wed, 25 Jul 2018 09:43:48 +0100	[thread overview]
Message-ID: <9fdfaf4e-5a20-af81-82ef-0d9e327f9133@synopsys.com> (raw)
In-Reply-To: <CAHp75VfYYmr7o6xkDbjaad3HxyzZgODzKfSNWdPXjM+YjTMANA@mail.gmail.com>

[-- Attachment #1: Type: text/plain, Size: 4251 bytes --]

Hi Andy,


Às 4:35 PM de 7/21/2018, Andy Shevchenko escreveu:
> On Fri, Jul 20, 2018 at 11:57 PM, Vitor soares
> <Vitor.Soares@synopsys.com> wrote:
>> This patch add driver for Synopsys DesignWare IP on top of
>> I3C subsystem patchset proposal V6
> Some of comments below related to style.
> But unaligned helpers I think is good to use.
>
>> +#include <linux/bitops.h>

Bit operations API eg: GENMASK...

>> +#include <linux/clk.h>

Clock API eg: master->core_clk = devm_clk_get(&pdev->dev, "core_clk");

>> +#include <linux/completion.h>

Completion API eg: struct completion

>> +#include <linux/err.h>

Check kernel pointer eg: return PTR_ERR(master->regs);

>> +#include <linux/errno.h>

Error codes eg: return -ENOTSUPP;

>> +#include <linux/i3c/master.h>

I3C Master API eg: i3c_master_register()

>> +#include <linux/init.h>

Not needed.

>> +#include <linux/interrupt.h>

Interrupt API eg: devm_request_irq().

>> +#include <linux/io.h>
>> +#include <linux/ioport.h>

Used to get io resource.

>> +#include <linux/iopoll.h>
 this function: readl_poll_timeout_atomic().

>> +#include <linux/module.h>

Module API.

>> +#include <linux/platform_device.h>

Platform driver API.

>> +#include <linux/reset.h>

Reset API.

> All of them required? Why?

There is some header files that are already included by others header files.
Should I add them too? it there any rule for that?
Thank for the advice.

>> +       default:
> Just return false here?

Yes, it makes more sense.

>> +               break;
>> +       }
>> +
>> +       return false;
>> +       for (i = 0; i < nbytes; i += 4) {
>> +               u32 data = 0;
>> +
>> +               for (j = 0; j < 4 && (i + j) < nbytes; j++)
>> +                       data |= (u32)bytes[i + j] << (j * 8);
> NIH of get_unaligned_le32()
>
>> +
>> +               writel(data, master->regs + RX_TX_DATA_PORT);
>> +       }
>> +}
>> +
>> +static void dw_i3c_master_read_rx_fifo(struct dw_i3c_master *master,
>> +                                      u8 *bytes, int nbytes)
>> +{
>> +       int i, j;
>> +
>> +       for (i = 0; i < nbytes; i += 4) {
>> +               u32 data;
>> +
>> +               data = readl(master->regs + RX_TX_DATA_PORT);
>> +
>> +               for (j = 0; j < 4 && (i + j) < nbytes; j++)
>> +                       bytes[i + j] = data >> (j * 8);
> Ditto put_unaligned_le32() ?
>
>> +       }
>> +}
> I'm wondering what else you open coded instead of using helpers we already have.

I will see how it works to implement.

>> +               writel(cmd->cmd_hi, master->regs + COMMAND_QUEUE_PORT);
>> +               writel(cmd->cmd_lo, master->regs + COMMAND_QUEUE_PORT);
> hmm... writesl()?

Is there any advantage here?

Probably I can use it to fill the TX buffer with this.

>> +       info->pid = (u64)readl(master->regs + SLV_PID_VALUE);
> Why explicit casting?

info->pid is u64 size.

>
>> +       u32 r;
>> +
>> +
>> +       core_rate = clk_get_rate(master->core_clk);
> Too many blank lines in between.

For me in that way it's better to filter code parts. Do you think that is not
readable?

>> +
>> +
> Ditto.
>
>> +       /* Prepare DAT before launching DAA. */
>> +       for (pos = 0; pos < master->maxdevs; pos++) {
>> +               if (olddevs & BIT(pos))
>> +                       continue;
>> +
>> +               ret = i3c_master_get_free_addr(m, last_addr + 1);
>> +               if (ret < 0)
>> +                       return -ENOSPC;
>> +               master->addrs[pos] = ret;
>> +               p = (ret >> 6) ^ (ret >> 5) ^ (ret >> 4) ^ (ret >> 3) ^
>> +                   (ret >> 2) ^ (ret >> 1) ^ ret ^ 1;
>> +               p = p & 1;
> Is it parity calculus? Do we have something implemented in kernel already?
>
> Btw, https://urldefense.proofpoint.com/v2/url?u=https-3A__graphics.stanford.edu_-7Eseander_bithacks.html-23ParityNaive&d=DwIBaQ&c=DPL6_X_6JkXFx7AXWqB0tg&r=qVuU64u9x77Y0Kd0PhDK_lpxFgg6PK9PateHwjb_DY0&m=5FpGHBbT8tYA6PB4RT_9O6PJk3v-wYcy1MV59xoqK4I&s=FSJ3EcuoxPtRJWmsk9Yt4s_UH9kxFBam01Xvas2ZFdo&e=
> offered this
>
> v ^= v >> 4;
> v &= 0xf;
> v = (0x6996 >> v) & 1;

I search into the kernel and I didn't find any function for that. In your
opinion what shoud I use?


Thanks for your feedback.

Regards,
Vitor Soares


[-- Attachment #2: Type: text/html, Size: 10545 bytes --]

  reply	other threads:[~2018-07-25  8:44 UTC|newest]

Thread overview: 50+ messages / expand[flat|nested]  mbox.gz  Atom feed  top
2018-07-20 20:57 [PATCH 0/3] Add driver for Synopsys DesignWare I3C master IP Vitor soares
2018-07-20 20:57 ` Vitor soares
2018-07-20 20:57 ` [PATCH 1/3] i3c: master: Add driver for Synopsys DesignWare IP Vitor soares
2018-07-20 20:57   ` Vitor soares
2018-07-21 15:35   ` Andy Shevchenko
2018-07-21 15:35     ` Andy Shevchenko
2018-07-21 15:35     ` Andy Shevchenko
2018-07-25  8:43     ` Vitor Soares [this message]
2018-07-25  8:43       ` Vitor Soares
2018-07-25 16:56       ` Andy Shevchenko
2018-07-25 16:56         ` Andy Shevchenko
2018-07-25 16:56         ` Andy Shevchenko
2018-08-08 17:01         ` vitor
2018-08-08 17:01           ` vitor
2018-08-08 17:01           ` vitor
2018-07-27 13:38   ` Boris Brezillon
2018-07-27 13:38     ` Boris Brezillon
2018-08-08 17:28     ` vitor
2018-08-08 17:28       ` vitor
2018-08-08 17:28       ` vitor
2018-07-20 20:57 ` [PATCH 2/3] dt-bindings: i3c: Document Synopsys DesignWare I3C master bindings Vitor soares
2018-07-20 20:57   ` Vitor soares
2018-07-25 19:57   ` Rob Herring
2018-07-25 19:57     ` Rob Herring
2018-08-08 16:59     ` vitor
2018-08-08 16:59       ` vitor
2018-08-08 16:59       ` vitor
2018-08-13 14:15       ` Rob Herring
2018-08-13 14:15         ` Rob Herring
2018-07-20 20:57 ` [PATCH 3/3] MAINTAINERS: Add myself as the dw-i3c-master module maintainer Vitor soares
2018-07-20 20:57   ` Vitor soares
2018-07-20 21:58 ` [PATCH 0/3] Add driver for Synopsys DesignWare I3C master IP Wolfram Sang
2018-07-21 17:15   ` Boris Brezillon
2018-07-21 17:15     ` Boris Brezillon
2018-07-21 22:59     ` Wolfram Sang
  -- strict thread matches above, loose matches on Subject: below --
2018-10-29 10:06 Vitor soares
2018-10-29 10:06 ` [PATCH 1/3] i3c: master: Add driver for Synopsys DesignWare IP Vitor soares
2018-10-29 13:41   ` Matthew Wilcox
2018-10-29 13:41     ` Matthew Wilcox
2018-11-07 15:15     ` vitor
2018-11-07 15:15       ` vitor
2018-11-07 15:34       ` Geert Uytterhoeven
2018-11-07 15:34         ` Geert Uytterhoeven
2018-11-07 17:16         ` vitor
2018-11-07 17:16           ` vitor
2018-11-07 17:05   ` Matthew Wilcox
2018-11-07 17:05     ` Matthew Wilcox
2018-11-07 17:30     ` vitor
2018-11-07 17:30       ` vitor
2018-11-07 17:37       ` Matthew Wilcox
2018-11-07 17:37         ` Matthew Wilcox

Reply instructions:

You may reply publicly to this message via plain-text email
using any one of the following methods:

* Save the following mbox file, import it into your mail client,
  and reply-to-all from there: mbox

  Avoid top-posting and favor interleaved quoting:
  https://en.wikipedia.org/wiki/Posting_style#Interleaved_style

* Reply using the --to, --cc, and --in-reply-to
  switches of git-send-email(1):

  git send-email \
    --in-reply-to=9fdfaf4e-5a20-af81-82ef-0d9e327f9133@synopsys.com \
    --to=vitor.soares@synopsys.com \
    --cc=Joao.Pinto@synopsys.com \
    --cc=Xiang.Lin@synaptics.com \
    --cc=adouglas@cadence.com \
    --cc=agolec@cadence.com \
    --cc=alicja@cadence.com \
    --cc=andy.shevchenko@gmail.com \
    --cc=arnd@arndb.de \
    --cc=bfolta@cadence.com \
    --cc=boris.brezillon@bootlin.com \
    --cc=corbet@lwn.net \
    --cc=cwronka@cadence.com \
    --cc=devicetree@vger.kernel.org \
    --cc=dkos@cadence.com \
    --cc=galak@codeaurora.org \
    --cc=geert@linux-m68k.org \
    --cc=gregkh@linuxfoundation.org \
    --cc=ijc+devicetree@hellion.org.uk \
    --cc=linus.walleij@linaro.org \
    --cc=linux-doc@vger.kernel.org \
    --cc=linux-gpio@vger.kernel.org \
    --cc=linux-i2c@vger.kernel.org \
    --cc=linux-kernel@vger.kernel.org \
    --cc=mark.rutland@arm.com \
    --cc=nm@ti.com \
    --cc=nsekhar@ti.com \
    --cc=pawel.moll@arm.com \
    --cc=peda@axentia.se \
    --cc=pgaj@cadence.com \
    --cc=psroka@cadence.com \
    --cc=rafalc@cadence.com \
    --cc=robh+dt@kernel.org \
    --cc=sureshp@cadence.com \
    --cc=thomas.petazzoni@bootlin.com \
    --cc=wsa@the-dreams.de \
    /path/to/YOUR_REPLY

  https://kernel.org/pub/software/scm/git/docs/git-send-email.html

* If your mail client supports setting the In-Reply-To header
  via mailto: links, try the mailto: link
Be sure your reply has a Subject: header at the top and a blank line before the message body.
This is an external index of several public inboxes,
see mirroring instructions on how to clone and mirror
all data and code used by this external index.