All of lore.kernel.org
 help / color / mirror / Atom feed
From: Jon Hunter <jon-hunter@ti.com>
To: "Mohammed, Afzal" <afzal@ti.com>
Cc: "tony@atomide.com" <tony@atomide.com>,
	"paul@pwsan.com" <paul@pwsan.com>,
	"linux-omap@vger.kernel.org" <linux-omap@vger.kernel.org>,
	"linux-arm-kernel@lists.infradead.org"
	<linux-arm-kernel@lists.infradead.org>
Subject: Re: [PATCH v5 06/14] ARM: OMAP2+: gpmc: CS configuration helper
Date: Wed, 13 Jun 2012 10:39:52 -0500	[thread overview]
Message-ID: <4FD8B448.9090405@ti.com> (raw)
In-Reply-To: <C8443D0743D26F4388EA172BF4E2A7A93E998820@DBDE01.ent.ti.com>

Hi Afzal,

On 06/13/2012 12:50 AM, Mohammed, Afzal wrote:
> Hi Jon,
> 
> On Tue, Jun 12, 2012 at 23:39:32, Hunter, Jon wrote:
>> On 06/12/2012 07:58 AM, Mohammed, Afzal wrote:
> 
>>> Thinking again over it, I am feeling above is sufficient, reason same as
>>> said earlier, to keep code simple & currently this is sufficient to
>>> handle GPMC bit patterns for IPs presently available. What you are
>>> suggesting is to take care of the imaginary case when new GPMC IP happens
>>> with new device type or size, I think that should be handled when such a
>>> scenario happens. Probably, it is better here to add a comment to make
>>> intention clear.
>>
>> That is one possibility but I think that more important reasons are ...
>>
>> 1. Readability, at first it appears that we are always configuring the
>> CS for NAND. However, this is not the case. Maybe a comment here can
>> help as you mentioned.
> 
> As far as the users of GPMC is considered there is no confusion. Eg. For
> device type, they have been provided with two macros,
> 
> GPMC_CONFIG1_DEVICETYPE_NOR, GPMC_CONFIG1_DEVICETYPE_NAND
> 
> So for NOR, user can feel satisfied by giving NOR flag, little does he know
> that driver doesn't do anything with the flag, but he still gets what he want
> NOR flag is defined as zero. Yes even if he doesn't specify any type, device
> type will be set as NOR, but then that is the default - the only other option

Sure, but reviewing the function it still looks odd from a readability
standpoint. At least it made me think "what is going on here ...". So a
comment is definitely needed.

>>
>> 2. A bad setting in the configuration passed. Hopefully, people will
>> stick to the flags but we know that we expect the device type to be a 0
>> or 2 and so should we check?
> 
> Value of device type is something driver has to worry about, not its users,
> they have been provided with two flags, one for NAND & other for NOR.

Yes, but the driver does not seem to worry about it. In other words,
there is no error checking. Ok so not a big deal a comment should suffice.

Jon



WARNING: multiple messages have this Message-ID (diff)
From: jon-hunter@ti.com (Jon Hunter)
To: linux-arm-kernel@lists.infradead.org
Subject: [PATCH v5 06/14] ARM: OMAP2+: gpmc: CS configuration helper
Date: Wed, 13 Jun 2012 10:39:52 -0500	[thread overview]
Message-ID: <4FD8B448.9090405@ti.com> (raw)
In-Reply-To: <C8443D0743D26F4388EA172BF4E2A7A93E998820@DBDE01.ent.ti.com>

Hi Afzal,

On 06/13/2012 12:50 AM, Mohammed, Afzal wrote:
> Hi Jon,
> 
> On Tue, Jun 12, 2012 at 23:39:32, Hunter, Jon wrote:
>> On 06/12/2012 07:58 AM, Mohammed, Afzal wrote:
> 
>>> Thinking again over it, I am feeling above is sufficient, reason same as
>>> said earlier, to keep code simple & currently this is sufficient to
>>> handle GPMC bit patterns for IPs presently available. What you are
>>> suggesting is to take care of the imaginary case when new GPMC IP happens
>>> with new device type or size, I think that should be handled when such a
>>> scenario happens. Probably, it is better here to add a comment to make
>>> intention clear.
>>
>> That is one possibility but I think that more important reasons are ...
>>
>> 1. Readability, at first it appears that we are always configuring the
>> CS for NAND. However, this is not the case. Maybe a comment here can
>> help as you mentioned.
> 
> As far as the users of GPMC is considered there is no confusion. Eg. For
> device type, they have been provided with two macros,
> 
> GPMC_CONFIG1_DEVICETYPE_NOR, GPMC_CONFIG1_DEVICETYPE_NAND
> 
> So for NOR, user can feel satisfied by giving NOR flag, little does he know
> that driver doesn't do anything with the flag, but he still gets what he want
> NOR flag is defined as zero. Yes even if he doesn't specify any type, device
> type will be set as NOR, but then that is the default - the only other option

Sure, but reviewing the function it still looks odd from a readability
standpoint. At least it made me think "what is going on here ...". So a
comment is definitely needed.

>>
>> 2. A bad setting in the configuration passed. Hopefully, people will
>> stick to the flags but we know that we expect the device type to be a 0
>> or 2 and so should we check?
> 
> Value of device type is something driver has to worry about, not its users,
> they have been provided with two flags, one for NAND & other for NOR.

Yes, but the driver does not seem to worry about it. In other words,
there is no error checking. Ok so not a big deal a comment should suffice.

Jon

  reply	other threads:[~2012-06-13 15:39 UTC|newest]

Thread overview: 232+ messages / expand[flat|nested]  mbox.gz  Atom feed  top
2012-06-11 14:25 [PATCH v5 00/14] GPMC driver conversion Afzal Mohammed
2012-06-11 14:25 ` Afzal Mohammed
2012-06-11 14:26 ` [PATCH v5 01/14] ARM: OMAP2+: gpmc: platform definitions Afzal Mohammed
2012-06-11 14:26   ` Afzal Mohammed
2012-06-12 18:58   ` Jon Hunter
2012-06-12 18:58     ` Jon Hunter
2012-06-13  6:25     ` Mohammed, Afzal
2012-06-13  6:25       ` Mohammed, Afzal
2012-06-11 14:26 ` [PATCH v5 02/14] ARM: OMAP2+: gpmc: Adapt to HWMOD Afzal Mohammed
2012-06-11 14:26   ` Afzal Mohammed
2012-06-11 19:56   ` Jon Hunter
2012-06-11 19:56     ` Jon Hunter
2012-06-12  6:53     ` Mohammed, Afzal
2012-06-12  6:53       ` Mohammed, Afzal
2012-06-12 17:40       ` Jon Hunter
2012-06-12 17:40         ` Jon Hunter
2012-06-13  5:20         ` Mohammed, Afzal
2012-06-13  5:20           ` Mohammed, Afzal
2012-06-13 12:02           ` Tony Lindgren
2012-06-13 12:02             ` Tony Lindgren
2012-06-13 13:05             ` Mohammed, Afzal
2012-06-13 13:05               ` Mohammed, Afzal
2012-06-13 13:39               ` Tony Lindgren
2012-06-13 13:39                 ` Tony Lindgren
2012-06-13 13:59                 ` Mohammed, Afzal
2012-06-13 13:59                   ` Mohammed, Afzal
2012-06-13 15:08               ` Jon Hunter
2012-06-13 15:08                 ` Jon Hunter
2012-06-14  7:07                 ` Mohammed, Afzal
2012-06-14  7:07                   ` Mohammed, Afzal
2012-06-13 14:51           ` Jon Hunter
2012-06-13 14:51             ` Jon Hunter
2012-06-14  6:17             ` Mohammed, Afzal
2012-06-14  6:17               ` Mohammed, Afzal
2012-06-14  6:20               ` Mohammed, Afzal
2012-06-14  6:20                 ` Mohammed, Afzal
2012-06-14 20:51               ` Jon Hunter
2012-06-14 20:51                 ` Jon Hunter
2012-06-15  0:20                 ` Paul Walmsley
2012-06-15  0:20                   ` Paul Walmsley
2012-06-15 15:33                   ` Jon Hunter
2012-06-15 15:33                     ` Jon Hunter
2012-06-15 10:40                 ` Mohammed, Afzal
2012-06-15 10:40                   ` Mohammed, Afzal
2012-06-14  7:03             ` Mohammed, Afzal
2012-06-14  7:03               ` Mohammed, Afzal
2012-06-14 13:22               ` Jon Hunter
2012-06-14 13:22                 ` Jon Hunter
2012-06-14 13:32                 ` Mohammed, Afzal
2012-06-14 13:32                   ` Mohammed, Afzal
2012-06-14 18:58                   ` Jon Hunter
2012-06-14 18:58                     ` Jon Hunter
2012-06-15 10:22                     ` Mohammed, Afzal
2012-06-15 10:22                       ` Mohammed, Afzal
2012-06-15 12:45                       ` Tony Lindgren
2012-06-15 12:45                         ` Tony Lindgren
2012-06-16  9:15                         ` Mohammed, Afzal
2012-06-16  9:15                           ` Mohammed, Afzal
2012-06-20 13:28                           ` Tony Lindgren
2012-06-20 13:28                             ` Tony Lindgren
2012-06-20 14:52                             ` Mohammed, Afzal
2012-06-20 14:52                               ` Mohammed, Afzal
2012-06-20 15:12                               ` Tony Lindgren
2012-06-20 15:12                                 ` Tony Lindgren
2012-06-20 23:35                                 ` Jon Hunter
2012-06-20 23:35                                   ` Jon Hunter
2012-06-22 13:29                                   ` Mohammed, Afzal
2012-06-22 13:29                                     ` Mohammed, Afzal
2012-06-11 14:26 ` [PATCH v5 03/14] ARM: OMAP2+: gpmc: driver migration helper Afzal Mohammed
2012-06-11 14:26   ` Afzal Mohammed
2012-06-11 20:30   ` Jon Hunter
2012-06-11 20:30     ` Jon Hunter
2012-06-12  7:09     ` Mohammed, Afzal
2012-06-12  7:09       ` Mohammed, Afzal
2012-06-12 17:46       ` Jon Hunter
2012-06-12 17:46         ` Jon Hunter
2012-06-13  5:25         ` Mohammed, Afzal
2012-06-13  5:25           ` Mohammed, Afzal
2012-06-13 12:04     ` Tony Lindgren
2012-06-13 12:04       ` Tony Lindgren
2012-06-13 12:18       ` Mohammed, Afzal
2012-06-13 12:18         ` Mohammed, Afzal
2012-06-13 13:46         ` Mohammed, Afzal
2012-06-13 13:46           ` Mohammed, Afzal
2012-06-14  6:34           ` Tony Lindgren
2012-06-14  6:34             ` Tony Lindgren
2012-06-11 14:26 ` [PATCH v5 04/14] ARM: OMAP2+: gpmc: minimal driver support Afzal Mohammed
2012-06-11 14:26   ` Afzal Mohammed
2012-06-11 20:43   ` Jon Hunter
2012-06-11 20:43     ` Jon Hunter
2012-06-12  7:16     ` Mohammed, Afzal
2012-06-12  7:16       ` Mohammed, Afzal
2012-06-12 17:57       ` Jon Hunter
2012-06-12 17:57         ` Jon Hunter
2012-06-13 12:07         ` Tony Lindgren
2012-06-13 12:07           ` Tony Lindgren
2012-06-13 13:12           ` Mohammed, Afzal
2012-06-13 13:12             ` Mohammed, Afzal
2012-06-13 13:40             ` Tony Lindgren
2012-06-13 13:40               ` Tony Lindgren
2012-06-13 13:44               ` Tony Lindgren
2012-06-13 13:44                 ` Tony Lindgren
2012-06-13 13:50                 ` Mohammed, Afzal
2012-06-13 13:50                   ` Mohammed, Afzal
2012-06-13 13:52                 ` Mohammed, Afzal
2012-06-13 13:52                   ` Mohammed, Afzal
2012-06-14  6:35                   ` Tony Lindgren
2012-06-14  6:35                     ` Tony Lindgren
2012-06-14  6:40                     ` Mohammed, Afzal
2012-06-14  6:40                       ` Mohammed, Afzal
2012-06-14  8:39                       ` Tony Lindgren
2012-06-14  8:39                         ` Tony Lindgren
2012-06-14  8:42                         ` Mohammed, Afzal
2012-06-14  8:42                           ` Mohammed, Afzal
2012-06-13 17:05               ` Jon Hunter
2012-06-13 17:05                 ` Jon Hunter
2012-06-12 19:19   ` Jon Hunter
2012-06-12 19:19     ` Jon Hunter
2012-06-13  6:29     ` Mohammed, Afzal
2012-06-13  6:29       ` Mohammed, Afzal
2012-06-11 14:26 ` [PATCH v5 05/14] ARM: OMAP2+: gpmc: resource creation helpers Afzal Mohammed
2012-06-11 14:26   ` Afzal Mohammed
2012-06-11 20:57   ` Jon Hunter
2012-06-11 20:57     ` Jon Hunter
2012-06-12  8:30     ` Mohammed, Afzal
2012-06-12  8:30       ` Mohammed, Afzal
2012-06-12 18:02       ` Jon Hunter
2012-06-12 18:02         ` Jon Hunter
2012-06-13  5:29         ` Mohammed, Afzal
2012-06-13  5:29           ` Mohammed, Afzal
2012-06-13 15:33           ` Jon Hunter
2012-06-13 15:33             ` Jon Hunter
2012-06-14  8:44             ` Mohammed, Afzal
2012-06-14  8:44               ` Mohammed, Afzal
2012-06-11 14:26 ` [PATCH v5 06/14] ARM: OMAP2+: gpmc: CS configuration helper Afzal Mohammed
2012-06-11 14:26   ` Afzal Mohammed
2012-06-11 21:43   ` Jon Hunter
2012-06-11 21:43     ` Jon Hunter
2012-06-12  8:40     ` Mohammed, Afzal
2012-06-12  8:40       ` Mohammed, Afzal
2012-06-12 12:58       ` Mohammed, Afzal
2012-06-12 12:58         ` Mohammed, Afzal
2012-06-12 18:09         ` Jon Hunter
2012-06-12 18:09           ` Jon Hunter
2012-06-13  5:50           ` Mohammed, Afzal
2012-06-13  5:50             ` Mohammed, Afzal
2012-06-13 15:39             ` Jon Hunter [this message]
2012-06-13 15:39               ` Jon Hunter
2012-06-14  8:45               ` Mohammed, Afzal
2012-06-14  8:45                 ` Mohammed, Afzal
2012-06-12 18:06       ` Jon Hunter
2012-06-12 18:06         ` Jon Hunter
2012-06-13  5:35         ` Mohammed, Afzal
2012-06-13  5:35           ` Mohammed, Afzal
2012-06-11 14:27 ` [PATCH v5 07/14] ARM: OMAP2+: gpmc: time setting (register#) helper Afzal Mohammed
2012-06-11 14:27   ` Afzal Mohammed
2012-06-12 18:55   ` Jon Hunter
2012-06-12 18:55     ` Jon Hunter
2012-06-13  6:15     ` Mohammed, Afzal
2012-06-13  6:15       ` Mohammed, Afzal
2012-06-11 14:27 ` [PATCH v5 08/14] ARM: OMAP2+: gpmc: bool type timing helper Afzal Mohammed
2012-06-11 14:27   ` Afzal Mohammed
2012-06-11 22:27   ` Jon Hunter
2012-06-11 22:27     ` Jon Hunter
2012-06-12  8:41     ` Mohammed, Afzal
2012-06-12  8:41       ` Mohammed, Afzal
2012-06-11 14:27 ` [PATCH v5 09/14] ARM: OMAP2+: gpmc: holler if no configuration Afzal Mohammed
2012-06-11 14:27   ` Afzal Mohammed
2012-06-11 22:30   ` Jon Hunter
2012-06-11 22:30     ` Jon Hunter
2012-06-12  8:44     ` Mohammed, Afzal
2012-06-12  8:44       ` Mohammed, Afzal
2012-06-12 18:11       ` Jon Hunter
2012-06-12 18:11         ` Jon Hunter
2012-06-11 14:27 ` [PATCH v5 10/14] ARM: OMAP2+: gpmc: waitpin helper Afzal Mohammed
2012-06-11 14:27   ` Afzal Mohammed
2012-06-11 22:59   ` Jon Hunter
2012-06-11 22:59     ` Jon Hunter
2012-06-12  9:00     ` Mohammed, Afzal
2012-06-12  9:00       ` Mohammed, Afzal
2012-06-12 18:15       ` Jon Hunter
2012-06-12 18:15         ` Jon Hunter
2012-06-13  7:37         ` Mohammed, Afzal
2012-06-13  7:37           ` Mohammed, Afzal
2012-06-13 15:44           ` Jon Hunter
2012-06-13 15:44             ` Jon Hunter
2012-06-14  8:48             ` Mohammed, Afzal
2012-06-14  8:48               ` Mohammed, Afzal
2012-06-14 21:06               ` Jon Hunter
2012-06-14 21:06                 ` Jon Hunter
2012-06-15 10:50                 ` Mohammed, Afzal
2012-06-15 10:50                   ` Mohammed, Afzal
2012-06-12 18:37   ` Jon Hunter
2012-06-12 18:37     ` Jon Hunter
2012-06-13  7:47     ` Mohammed, Afzal
2012-06-13  7:47       ` Mohammed, Afzal
2012-06-11 14:27 ` [PATCH v5 11/14] ARM: OMAP2+: gpmc: handle connected peripherals Afzal Mohammed
2012-06-11 14:27   ` Afzal Mohammed
2012-06-13 15:31   ` Jon Hunter
2012-06-13 15:31     ` Jon Hunter
2012-06-14  8:40     ` Mohammed, Afzal
2012-06-14  8:40       ` Mohammed, Afzal
2012-06-11 14:27 ` [PATCH v5 12/14] ARM: OMAP2+: gpmc: cs reconfigure helper Afzal Mohammed
2012-06-11 14:27   ` Afzal Mohammed
2012-06-11 23:04   ` Jon Hunter
2012-06-11 23:04     ` Jon Hunter
2012-06-12  9:01     ` Mohammed, Afzal
2012-06-12  9:01       ` Mohammed, Afzal
2012-06-11 14:27 ` [PATCH v5 13/14] ARM: OMAP2+: gpmc: update nand register info Afzal Mohammed
2012-06-11 14:27   ` Afzal Mohammed
2012-06-11 14:27 ` [PATCH v5 14/14] ARM: OMAP2+: gpmc: writeprotect helper Afzal Mohammed
2012-06-11 14:27   ` Afzal Mohammed
2012-06-12 18:42   ` Jon Hunter
2012-06-12 18:42     ` Jon Hunter
2012-06-13  6:10     ` Mohammed, Afzal
2012-06-13  6:10       ` Mohammed, Afzal
2012-06-13 16:28       ` Jon Hunter
2012-06-13 16:28         ` Jon Hunter
2012-06-14  8:54         ` Mohammed, Afzal
2012-06-14  8:54           ` Mohammed, Afzal
2012-06-14  9:36           ` Tony Lindgren
2012-06-14  9:36             ` Tony Lindgren
2012-06-14 10:21             ` Mohammed, Afzal
2012-06-14 10:21               ` Mohammed, Afzal
2012-06-12 10:39 ` [PATCH v5 00/14] GPMC driver conversion Mohammed, Afzal
2012-06-12 10:39   ` Mohammed, Afzal
2012-06-13 12:33   ` Tony Lindgren
2012-06-13 12:33     ` Tony Lindgren
2012-06-15 10:56     ` Mohammed, Afzal
2012-06-15 10:56       ` Mohammed, Afzal
2012-06-15 12:51       ` Tony Lindgren
2012-06-15 12:51         ` Tony Lindgren

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=4FD8B448.9090405@ti.com \
    --to=jon-hunter@ti.com \
    --cc=afzal@ti.com \
    --cc=linux-arm-kernel@lists.infradead.org \
    --cc=linux-omap@vger.kernel.org \
    --cc=paul@pwsan.com \
    --cc=tony@atomide.com \
    /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.