From: Corey Minyard <minyard@acm.org>
To: Benjamin Tissoires <benjamin.tissoires@redhat.com>
Cc: Jean Delvare <jdelvare@suse.com>,
linux-i2c@vger.kernel.org, linux-kernel@vger.kernel.org,
Corey Minyard <cminyard@mvista.com>
Subject: Re: [v2,07/10] i2c-i801: Fix some inconsistent variable names
Date: Fri, 10 Jun 2016 06:12:06 -0500 [thread overview]
Message-ID: <575AA086.1070108@acm.org> (raw)
In-Reply-To: <20160609140140.GI24234@mail.corp.redhat.com>
On 06/09/2016 09:01 AM, Benjamin Tissoires wrote:
> On May 29 2016 or thereabouts, Corey Minyard wrote:
>> From: Corey Minyard <cminyard@mvista.com>
>>
>> The priv->cmd is called subcmd elsewhere, and that's a more
>> appropriate name for it, so rename it.
>>
>> The "size" parameter passed in to i801_access is passed to other
>> functions and those name is "command". This is confusing with the
>> "command" parameter passed in to i801_access. Rename it to "size"
>> everywhere.
> Well, this parameter contains defines that are declared as SMBus
> transaction types in i2c.h. So even if they are passed as the size
> parameter in i2c_access, they actually are commands. So I am not sure it
> is good to rename them as "size".
I looked in the user interfaces of the I2C core, and it's named "protocol"
there. That's a much better name than "size", so I'll use it instead.
-corey
> Cheers,
> Benjamin
>
>> Signed-off-by: Corey Minyard <cminyard@mvista.com>
>> ---
>> drivers/i2c/busses/i2c-i801.c | 29 ++++++++++++++---------------
>> 1 file changed, 14 insertions(+), 15 deletions(-)
>>
>> diff --git a/drivers/i2c/busses/i2c-i801.c b/drivers/i2c/busses/i2c-i801.c
>> index ae1e60a..b415948 100644
>> --- a/drivers/i2c/busses/i2c-i801.c
>> +++ b/drivers/i2c/busses/i2c-i801.c
>> @@ -233,7 +233,7 @@ struct i801_priv {
>> u8 status;
>>
>> /* Command state used by isr for byte-by-byte block transactions */
>> - u8 cmd;
>> + u8 subcmd;
>> bool is_read;
>> int count;
>> int len;
>> @@ -468,7 +468,7 @@ static void i801_isr_byte_done(struct i801_priv *priv)
>> {
>> if (priv->is_read) {
>> /* For SMBus block reads, length is received with first byte */
>> - if (((priv->cmd & 0x1c) == I801_BLOCK_DATA) &&
>> + if (((priv->subcmd & 0x1c) == I801_BLOCK_DATA) &&
>> (priv->count == 0)) {
>> priv->len = inb_p(SMBHSTDAT0(priv));
>> if (priv->len < 1 || priv->len > I2C_SMBUS_BLOCK_MAX) {
>> @@ -494,7 +494,7 @@ static void i801_isr_byte_done(struct i801_priv *priv)
>>
>> /* Set LAST_BYTE for last byte of read transaction */
>> if (priv->count == priv->len - 1)
>> - outb_p(priv->cmd | SMBHSTCNT_LAST_BYTE,
>> + outb_p(priv->subcmd | SMBHSTCNT_LAST_BYTE,
>> SMBHSTCNT(priv));
>> } else if (priv->count < priv->len - 1) {
>> /* Write next byte, except for IRQ after last byte */
>> @@ -555,7 +555,7 @@ static irqreturn_t i801_isr(int irq, void *dev_id)
>> */
>> static int i801_block_transaction_byte_by_byte(struct i801_priv *priv,
>> union i2c_smbus_data *data,
>> - bool is_read, int command)
>> + bool is_read, int size)
>> {
>> int i, len;
>> int smbcmd;
>> @@ -570,7 +570,7 @@ static int i801_block_transaction_byte_by_byte(struct i801_priv *priv,
>> outb_p(data->block[1], SMBBLKDAT(priv));
>> }
>>
>> - if (command == I2C_SMBUS_I2C_BLOCK_DATA && is_read)
>> + if (size == I2C_SMBUS_I2C_BLOCK_DATA && is_read)
>> smbcmd = I801_I2C_BLOCK_DATA;
>> else
>> smbcmd = I801_BLOCK_DATA;
>> @@ -579,12 +579,12 @@ static int i801_block_transaction_byte_by_byte(struct i801_priv *priv,
>> priv->is_read = is_read;
>> if (len == 1 && is_read)
>> smbcmd |= SMBHSTCNT_LAST_BYTE;
>> - priv->cmd = smbcmd | SMBHSTCNT_INTREN;
>> + priv->subcmd = smbcmd | SMBHSTCNT_INTREN;
>> priv->len = len;
>> priv->count = 0;
>> priv->data = &data->block[1];
>>
>> - outb_p(priv->cmd | SMBHSTCNT_START, SMBHSTCNT(priv));
>> + outb_p(priv->subcmd | SMBHSTCNT_START, SMBHSTCNT(priv));
>> result = wait_event_timeout(priv->waitq,
>> (status = priv->status),
>> adap->timeout);
>> @@ -610,8 +610,7 @@ static int i801_block_transaction_byte_by_byte(struct i801_priv *priv,
>> if (status)
>> return status;
>>
>> - if (i == 1 && is_read
>> - && command != I2C_SMBUS_I2C_BLOCK_DATA) {
>> + if (i == 1 && is_read && size != I2C_SMBUS_I2C_BLOCK_DATA) {
>> priv->len = inb_p(SMBHSTDAT0(priv));
>> if (priv->len < 1 || priv->len > I2C_SMBUS_BLOCK_MAX)
>> return -EPROTO;
>> @@ -642,13 +641,13 @@ static int i801_set_block_buffer_mode(struct i801_priv *priv)
>> /* Block transaction function */
>> static int i801_block_transaction(struct i801_priv *priv, unsigned short flags,
>> union i2c_smbus_data *data, bool is_read,
>> - int command)
>> + int size)
>> {
>> int result = 0;
>> int hwpec = (priv->features & FEATURE_SMBUS_PEC)
>> && (flags & I2C_CLIENT_PEC)
>> - && command != I2C_SMBUS_QUICK
>> - && command != I2C_SMBUS_I2C_BLOCK_DATA;
>> + && size != I2C_SMBUS_QUICK
>> + && size != I2C_SMBUS_I2C_BLOCK_DATA;
>>
>> if (hwpec) /* enable/disable hardware PEC */
>> outb_p(inb_p(SMBAUXCTL(priv)) | SMBAUXCTL_CRC,
>> @@ -657,7 +656,7 @@ static int i801_block_transaction(struct i801_priv *priv, unsigned short flags,
>> outb_p(inb_p(SMBAUXCTL(priv)) & (~SMBAUXCTL_CRC),
>> SMBAUXCTL(priv));
>>
>> - if (!is_read || command == I2C_SMBUS_I2C_BLOCK_DATA) {
>> + if (!is_read || size == I2C_SMBUS_I2C_BLOCK_DATA) {
>> if (data->block[0] < 1)
>> data->block[0] = 1;
>> if (data->block[0] > I2C_SMBUS_BLOCK_MAX)
>> @@ -670,13 +669,13 @@ static int i801_block_transaction(struct i801_priv *priv, unsigned short flags,
>> SMBus (not I2C) block transactions, even though the datasheet
>> doesn't mention this limitation. */
>> if ((priv->features & FEATURE_BLOCK_BUFFER)
>> - && command != I2C_SMBUS_I2C_BLOCK_DATA
>> + && size != I2C_SMBUS_I2C_BLOCK_DATA
>> && i801_set_block_buffer_mode(priv) == 0)
>> result = i801_block_transaction_by_block(priv, data, is_read,
>> hwpec);
>> else
>> result = i801_block_transaction_byte_by_byte(priv, data,
>> - is_read, command);
>> + is_read, size);
>>
>> /*
>> * Some BIOSes don't like it when PEC is enabled at reboot or
next prev parent reply other threads:[~2016-06-10 11:12 UTC|newest]
Thread overview: 24+ messages / expand[flat|nested] mbox.gz Atom feed top
2016-05-30 1:08 [PATCH v2 00/10] i2c-i801: Various cleanups minyard
2016-05-30 1:08 ` [PATCH v2 01/10] i2c-i801: Remove hwpec from block byte-by-byte function minyard
2016-06-09 9:36 ` [v2,01/10] " Benjamin Tissoires
2016-05-30 1:08 ` [PATCH v2 02/10] i2c-i801: Move hostcfg set/reset to i801_access() minyard
2016-06-09 9:39 ` [v2,02/10] " Benjamin Tissoires
2016-06-10 10:43 ` Corey Minyard
2016-05-30 1:08 ` [PATCH v2 03/10] i2c-i801: Move hwpec handling into block transaction minyard
2016-06-09 9:42 ` [v2,03/10] " Benjamin Tissoires
2016-05-30 1:08 ` [PATCH v2 04/10] i2c-i801: Consolidate calls to i801_check_pre() minyard
2016-06-09 9:44 ` [v2,04/10] " Benjamin Tissoires
2016-06-10 10:52 ` Corey Minyard
2016-05-30 1:08 ` [PATCH v2 05/10] i2c-i801: Consolidate calls to i801_check_post minyard
2016-06-09 10:03 ` [v2,05/10] " Benjamin Tissoires
2016-06-10 11:09 ` Corey Minyard
2016-05-30 1:09 ` [PATCH v2 06/10] i2c-i801: Pass around a boolean read/write variable minyard
2016-06-09 10:05 ` [v2,06/10] " Benjamin Tissoires
2016-05-30 1:09 ` [PATCH v2 07/10] i2c-i801: Fix some inconsistent variable names minyard
2016-06-09 14:01 ` [v2,07/10] " Benjamin Tissoires
2016-06-10 11:12 ` Corey Minyard [this message]
2016-05-30 1:09 ` [PATCH v2 08/10] i2c-i801: Handle a protocol error in byte-by-byte isr minyard
2016-06-09 14:07 ` [v2,08/10] " Benjamin Tissoires
2016-05-30 1:09 ` [PATCH v2 09/10] i2c-i801: Null isr data buffer when done with it minyard
2016-06-09 14:14 ` [v2,09/10] " Benjamin Tissoires
2016-05-30 1:09 ` [PATCH v2 10/10] i2c-i801: Only write the host control reg when necessary minyard
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=575AA086.1070108@acm.org \
--to=minyard@acm.org \
--cc=benjamin.tissoires@redhat.com \
--cc=cminyard@mvista.com \
--cc=jdelvare@suse.com \
--cc=linux-i2c@vger.kernel.org \
--cc=linux-kernel@vger.kernel.org \
/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 a public inbox, see mirroring instructions
for how to clone and mirror all data and code used for this inbox;
as well as URLs for NNTP newsgroup(s).