i2c: pcf8584: Fix errors and warnings reported by checkpatch
v7 cover i2c: pcf8584: Fix errors and warnings reported by checkpatch
Hello maintainers,
This patch series fixes 18 errors and multiple warnings reported by checkpatch.pl on drivers/i2c/algos/i2c-algo-pcf.c file.
The series v1->v4 is a response to the discussion on the mailing list with Markus Elfring who had comments on my earlier submissions. He suggested:
-to split my initial submission in a patch series
-had some valid points on imperative mood usage in commit messages -wrapping commit message to 75 columns per line
-change some of the commit message to point usage of checkpatch.pl
The series v4->v6 is a response to the discussion on the mailing list with I2C SUBSYSTEM maintainer Wolfram Sang who requested some changes:
He requested:
- to remove debug macros from i2c-algo-pcf.c as no code change was done for almost 16 years.
- remove wrapping paranthesis from value assigned of '(0)''.
- resolve conficts caused by debug macros removal.
- remove also printk and dev_dbg function calls related to DEB macros.
The series v6->v7 was a result of feedback received from Andi Shyti:
- Remove not useful information from commit message
- use better the 'ret' variable by moving it inside for loop of pcf_xfer function and inside of loop check if ret < 0 then break;
Here is a brief summary and order of patches to be applied:
Patch 1/3: i2c: pcf8584: Remove debug macros from i2c-algo-pcf.c This patch remove the define of debug macros and also their usage from code along with printk and dev_dbg function calls. Removes also i2c_debug parameter as its implementation was removed.
Patch 2/3: i2c: pcf8584: Fix do not use assignment inside if conditional This patch takes the assignement from if conditional and moves it by 1 line up.
Patch 3/3: i2c: pcf8584: Move 'ret' variable inside for loop, break if ret < 0.
This patch adds space(s) around some binary operators. Also moves ret variable inside for loop and check in the loop if (ret < 0) break;
Testing:
*built kernel and modules with I2C_ALGOPCF=m and my 3 patches applied on top of 6.18.0-rc1.
*installed kernel and external modules generated by build on my laptop *rebooted and loaded i2c-algo-pcf.ko without i2c_debug parameter. *when loading the .ko with i2c_debug parameter an error is seen in dmesg and this is expected as the parameter was removed.
*No success message related to i2c_algo_pcf was seen in dmesg but also no failures.
*Module loading and unloading successful.
*No PCF8584 Hardware was available.
Cezar Chiru (3):
i2c: pcf8584: Remove debug macros from i2c-algo-pcf.c
i2c: pcf8584: Fix do not use assignment inside if conditional
i2c: pcf8584: Move 'ret' variable inside for loop, break if ret < 0.
drivers/i2c/algos/i2c-algo-pcf.c | 99 ++++++++------------------------ 1 file changed, 23 insertions(+), 76 deletions(-)
--
2.43.0
PATCH v7 1/3 i2c: pcf8584: Remove debug macros from i2c-algo-pcf.c
Remove debug macros and printk and dev_dbg function calls from file as no change was done for long time.
Remove i2c_debug module parameter also as its implementation, the debug macros, has been removed.
--- drivers/i2c/algos/i2c-algo-pcf.c | 59 -------------------------------- 1 file changed, 59 deletions(-)
drivers/i2c/algos/i2c-algo-pcf.c +0 -59
@@ -23,17 +23,8 @@#include "i2c-algo-pcf.h" -#define DEB2 (x) if (i2c_debug >= 2) x -#define DEB3 (x) if (i2c_debug >= 3) x/* print several statistical values */ -#define DEBPROTO (x) if (i2c_debug >= 9) x; -/* debug the protocol by showing transferred bits */ #define DEF_TIMEOUT 16 -/* -* module parameters: -*/ -static int i2c_debug; -/* setting states on the bus with the right timing: */ #define set_pcf (adap, ctl, val) adap->setpcf(adap->data, ctl, val)
@@ -47,27 +38,21 @@ static int i2c_debug;static void i2c_start (struct i2c_algo_pcf_data *adap) { -DEBPROTO (printk (KERN_DEBUG "S " ));set_pcf (adap,1 ,I2C_PCF_START ); }static void i2c_repstart (struct i2c_algo_pcf_data *adap) { -DEBPROTO (printk (" Sr " ));set_pcf (adap,1 ,I2C_PCF_REPSTART ); }static void i2c_stop (struct i2c_algo_pcf_data *adap) { -DEBPROTO (printk ("P\n" ));set_pcf (adap,1 ,I2C_PCF_STOP ); }static void handle_lab (struct i2c_algo_pcf_data *adap,const int *status) { -DEB2 (printk (KERN_INFO -"i2c-algo-pcf.o: lost arbitration (CSR 0x%02x)\n" , - *status));/* * Cleanup from LAB -- reset and enable ESO. * This resets the PCF8584; since we've lost the bus, no
@@ -88,9 +73,6 @@ static void handle_lab(struct i2c_algo_pcf_data *adap, const int *status)if (adap->lab_mdelay)mdelay (adap->lab_mdelay); -DEB2 (printk (KERN_INFO -"i2c-algo-pcf.o: reset LAB condition (CSR 0x%02x)\n" , -get_pcf (adap,1 ))); }static int wait_for_bb (struct i2c_algo_pcf_data *adap)
@@ -151,9 +133,6 @@ static int pcf_init_8584 (struct i2c_algo_pcf_data *adap) {unsigned char temp; -DEB3 (printk (KERN_DEBUG "i2c-algo-pcf.o: PCF state 0x%02x\n" , -get_pcf (adap,1 ))); -/* S1=0x80: S0 selected, serial interface off */ set_pcf (adap,1 ,I2C_PCF_PIN );/*
@@ -161,7 +140,6 @@ static int pcf_init_8584 (struct i2c_algo_pcf_data *adap)* PCF8584 does that when ESO is zero */ if (((temp =get_pcf (adap,1 )) &0x7f ) != (0 )) { -DEB2 (printk (KERN_ERR "i2c-algo-pcf.o: PCF detection failed -- can't select S0 (0x%02x).\n" , temp));return -ENXIO ;/* definitely not PCF8584 */ }
@@ -169,7 +147,6 @@ static int pcf_init_8584 (struct i2c_algo_pcf_data *adap)i2c_outb (adap,get_own (adap));/* check it's really written */ if ((temp =i2c_inb (adap)) !=get_own (adap)) { -DEB2 (printk (KERN_ERR "i2c-algo-pcf.o: PCF detection failed -- can't set S0 (0x%02x).\n" , temp));return -ENXIO ; }
@@ -177,7 +154,6 @@ static int pcf_init_8584 (struct i2c_algo_pcf_data *adap)set_pcf (adap,1 ,I2C_PCF_PIN |I2C_PCF_ES1 );/* check to see S2 now selected */ if (((temp =get_pcf (adap,1 )) &0x7f ) !=I2C_PCF_ES1 ) { -DEB2 (printk (KERN_ERR "i2c-algo-pcf.o: PCF detection failed -- can't select S2 (0x%02x).\n" , temp));return -ENXIO ; }
@@ -185,7 +161,6 @@ static int pcf_init_8584 (struct i2c_algo_pcf_data *adap)i2c_outb (adap,get_clock (adap));/* check it's really written, the only 5 lowest bits does matter */ if (((temp =i2c_inb (adap)) &0x1f ) !=get_clock (adap)) { -DEB2 (printk (KERN_ERR "i2c-algo-pcf.o: PCF detection failed -- can't set S2 (0x%02x).\n" , temp));return -ENXIO ; }
@@ -194,7 +169,6 @@ static int pcf_init_8584 (struct i2c_algo_pcf_data *adap)/* check to see PCF is really idled and we can access status register */ if ((temp =get_pcf (adap,1 )) != (I2C_PCF_PIN |I2C_PCF_BB )) { -DEB2 (printk (KERN_ERR "i2c-algo-pcf.o: PCF detection failed -- can't select S1` (0x%02x).\n" , temp));return -ENXIO ; }
@@ -210,8 +184,6 @@ static int pcf_sendbytes(struct i2c_adapter *i2c_adap, const char *buf,int wrcount, status, timeout;for (wrcount=0 ; wrcount<count; ++wrcount) { -DEB2 (dev_dbg (&i2c_adap->dev,"i2c_write: writing %2.2X\n" , - buf[wrcount] &0xff ));i2c_outb (adap, buf[wrcount]); timeout =wait_for_pin (adap, &status);if (timeout) {
@@ -307,8 +279,6 @@ static int pcf_xfer(struct i2c_adapter *i2c_adap,/* Check for bus busy */ timeout =wait_for_bb (adap);if (timeout) { -DEB2 (printk (KERN_ERR "i2c-algo-pcf.o: " - "Timeout waiting for BB in pcf_xfer\n");) i = -EIO ; goto out; }
@@ -316,10 +286,6 @@ static int pcf_xfer(struct i2c_adapter *i2c_adap,for (i =0 ;ret >=0 && i < num; i++) { pmsg = &msgs[i]; -DEB2 (printk (KERN_DEBUG "i2c-algo-pcf.o: Doing %s %d bytes to 0x%02x - %d of %d messages\n" , -str_read_write (pmsg->flags &I2C_M_RD ), - pmsg->len, pmsg->addr, i + 1, num);) - ret =pcf_doAddress (adap, pmsg);/* Send START */
@@ -335,8 +301,6 @@ static int pcf_xfer(struct i2c_adapter *i2c_adap, goto out; }i2c_stop (adap); -DEB2 (printk (KERN_ERR "i2c-algo-pcf.o: Timeout waiting " - "for PIN(1) in pcf_xfer\n");) i = -EREMOTEIO ; goto out; }
@@ -344,34 +308,17 @@ static int pcf_xfer(struct i2c_adapter *i2c_adap,/* Check LRB (last rcvd bit - slave ack) */ if (status &I2C_PCF_LRB ) {i2c_stop (adap); - DEB2(printk(KERN_ERR "i2c-algo-pcf.o: No LRB(1) in pcf_xfer\n");) i = -EREMOTEIO ; goto out; } -DEB3 (printk (KERN_DEBUG "i2c-algo-pcf.o: Msg %d, addr=0x%x, flags=0x%x, len=%d\n" , - i, msgs[i].addr, msgs[i].flags, msgs[i].len);)if (pmsg->flags &I2C_M_RD ) { ret =pcf_readbytes (i2c_adap, pmsg->buf, pmsg->len, (i +1 == num)); - -if (ret != pmsg->len) { -DEB2 (printk (KERN_DEBUG "i2c-algo-pcf.o: fail: " -"only read %d bytes.\n" ,ret)); - }else { -DEB2 (printk (KERN_DEBUG "i2c-algo-pcf.o: read %d bytes.\n" ,ret)); - } }else { ret =pcf_sendbytes (i2c_adap, pmsg->buf, pmsg->len, (i +1 == num)); - -if (ret != pmsg->len) { -DEB2 (printk (KERN_DEBUG "i2c-algo-pcf.o: fail: " -"only wrote %d bytes.\n" ,ret)); - }else { -DEB2 (printk (KERN_DEBUG "i2c-algo-pcf.o: wrote %d bytes.\n" ,ret)); - } } }
@@ -401,8 +348,6 @@ int i2c_pcf_add_bus(struct i2c_adapter *adap)struct i2c_algo_pcf_data *pcf_adap = adap->algo_data;int rval; -DEB2 (dev_dbg (&adap->dev,"hw routines registered.\n" )); -/* register new adapter to i2c module... */ adap->algo = &pcf_algo;
@@ -418,7 +363,3 @@ EXPORT_SYMBOL(i2c_pcf_add_bus);MODULE_AUTHOR ("Hans Berglund <[email protected]>" );MODULE_DESCRIPTION ("I2C-Bus PCF8584 algorithm" );MODULE_LICENSE ("GPL" ); - -module_param (i2c_debug, int,S_IRUGO |S_IWUSR ); -MODULE_PARM_DESC (i2c_debug, -"debug level - 0 off; 1 normal; 2,3 more verbose; 9 pcf-protocol" );
Signature · 1 line
2.43.0
PATCH v7 2/3 i2c: pcf8584: Fix do not use assignment inside if conditional
In reply to Cezar ChiruAssign inside of 'if' conditional is not allowed. Move assignment from inside 'if' conditional, to one line before each 'if'conditional statement that caused errors.
Enforce errors fixing based on checkpatch.pl output on file.
--- drivers/i2c/algos/i2c-algo-pcf.c | 28 +++++++++++++++------------- 1 file changed, 15 insertions(+), 13 deletions(-)
drivers/i2c/algos/i2c-algo-pcf.c +15 -13
@@ -129,7 +129,7 @@ static int wait_for_pin(struct i2c_algo_pcf_data *adap, int *status)* * vdovikin: added detect code for PCF8584 */ -static int pcf_init_8584 (struct i2c_algo_pcf_data *adap) +static int pcf_init_8584 (struct i2c_algo_pcf_data *adap) {unsigned char temp;
@@ -139,38 +139,38 @@ static int pcf_init_8584 (struct i2c_algo_pcf_data *adap)* check to see S1 now used as R/W ctrl - * PCF8584 does that when ESO is zero */ -if (((temp =get_pcf (adap,1 )) &0x7f ) != (0 )) { + temp =get_pcf (adap,1 ); +if ((temp &0x7f ) !=0 )return -ENXIO ;/* definitely not PCF8584 */ - }/* load own address in S0, effective address is (own << 1) */ i2c_outb (adap,get_own (adap));/* check it's really written */ -if ((temp =i2c_inb (adap)) !=get_own (adap)) { + temp =i2c_inb (adap); +if (temp !=get_own (adap))return -ENXIO ; - }/* S1=0xA0, next byte in S2 */ set_pcf (adap,1 ,I2C_PCF_PIN |I2C_PCF_ES1 );/* check to see S2 now selected */ -if (((temp =get_pcf (adap,1 )) &0x7f ) !=I2C_PCF_ES1 ) { + temp =get_pcf (adap,1 ); +if ((temp &0x7f ) !=I2C_PCF_ES1 )return -ENXIO ; - }/* load clock register S2 */ i2c_outb (adap,get_clock (adap));/* check it's really written, the only 5 lowest bits does matter */ -if (((temp =i2c_inb (adap)) &0x1f ) !=get_clock (adap)) { + temp =i2c_inb (adap); +if ((temp &0x1f ) !=get_clock (adap))return -ENXIO ; - }/* Enable serial interface, idle, S0 selected */ set_pcf (adap,1 ,I2C_PCF_IDLE );/* check to see PCF is really idled and we can access status register */ -if ((temp =get_pcf (adap,1 )) != (I2C_PCF_PIN |I2C_PCF_BB )) { + temp =get_pcf (adap,1 ); +if (temp != (I2C_PCF_PIN |I2C_PCF_BB ))return -ENXIO ; - }printk (KERN_DEBUG "i2c-algo-pcf.o: detected and initialized PCF8584.\n" );
@@ -218,7 +218,8 @@ static int pcf_readbytes(struct i2c_adapter *i2c_adap, char *buf,/* increment number of bytes to read by one -- read dummy byte */ for (i =0 ; i <= count; i++) { -if ((wfp =wait_for_pin (adap, &status))) { + wfp =wait_for_pin (adap, &status); +if (wfp) {if (wfp == -EINTR )return -EINTR ;/* arbitration lost */
@@ -351,7 +352,8 @@ int i2c_pcf_add_bus(struct i2c_adapter *adap)/* register new adapter to i2c module... */ adap->algo = &pcf_algo; -if ((rval =pcf_init_8584 (pcf_adap))) + rval =pcf_init_8584 (pcf_adap); +if (rval)return rval; rval =i2c_add_adapter (adap);
Signature · 1 line
2.43.0
PATCH v7 3/3 i2c: pcf8584: Move 'ret' variable inside for loop, break if ret < 0.
In reply to Cezar ChiruRequire spaces around '=', '>' and '<'. Add space(s) around binary operators.
Move 'ret' variable inside for loop. Then check if (ret < 0) break. This improves usage of ret variable.
Enforce errors fixing based on checkpatch.pl output on file.
--- drivers/i2c/algos/i2c-algo-pcf.c | 12 ++++++++---- 1 file changed, 8 insertions(+), 4 deletions(-)
drivers/i2c/algos/i2c-algo-pcf.c +8 -4
@@ -183,7 +183,7 @@ static int pcf_sendbytes(struct i2c_adapter *i2c_adap, const char *buf,struct i2c_algo_pcf_data *adap = i2c_adap->algo_data;int wrcount, status, timeout; -for (wrcount=0 ; wrcount<count; ++wrcount) { +for (wrcount =0 ; wrcount < count; ++wrcount) {i2c_outb (adap, buf[wrcount]); timeout =wait_for_pin (adap, &status);if (timeout) {
@@ -272,7 +272,7 @@ static int pcf_xfer(struct i2c_adapter *i2c_adap,struct i2c_algo_pcf_data *adap = i2c_adap->algo_data;struct i2c_msg *pmsg;int i; -int ret=0 , timeout, status; +int timeout, status;if (adap->xfer_begin) adap->xfer_begin (adap->data);
@@ -284,9 +284,10 @@ static int pcf_xfer(struct i2c_adapter *i2c_adap, goto out; } -for (i =0 ;ret >=0 && i < num; i++) { - pmsg = &msgs[i]; +for (i =0 ; i < num; i++) { +int ret =0 ; + pmsg = &msgs[i]; ret =pcf_doAddress (adap, pmsg);/* Send START */
@@ -321,6 +322,9 @@ static int pcf_xfer(struct i2c_adapter *i2c_adap, ret =pcf_sendbytes (i2c_adap, pmsg->buf, pmsg->len, (i +1 == num)); } + +if (ret <0 ) +break ; } out:
Signature · 1 line
2.43.0
Re: [PATCH v7 3/3] i2c: pcf8584: Move 'ret' variable inside for loop, break if ret < 0.
Quoted 4 lines
Require spaces around '=', '>' and '<'. Add space(s) around binary operators.
Move 'ret' variable inside for loop. Then check if (ret < 0) break. This improves usage of ret variable.
…
Is there a need to split desirable adjustments into two update steps?
https://git.kernel.org/pub/scm/linux/kernel/git/torvalds/linux.git/tree/Documentation/process/submitting-patches.rst?h=v6.18-rc1#n81
Regards,
Markus
Andi Shyti
maintainerRe: [PATCH v7 3/3] i2c: pcf8584: Move 'ret' variable inside for loop, break if ret < 0.
In reply to Cezar ChiruHi Cezar,
Quoted 5 lines · Cezar Chiru
Require spaces around '=', '>' and '<'. Add space(s) around binary operators.
Move 'ret' variable inside for loop. Then check if (ret < 0) break. This improves usage of ret variable.
Enforce errors fixing based on checkpatch.pl output on file.
Thanks for following up.
drivers/i2c/algos/i2c-algo-pcf.c static int pcf_xfer(struct i2c_adapter *i2c_adap, · line 288
Quoted 8 lines
drivers/i2c/algos/i2c-algo-pcf.c +2
-2@@ -284,9 +284,10 @@ static int pcf_xfer(struct i2c_adapter *i2c_adap, goto out; } -for (i =0 ;ret >=0 && i < num; i++) { - pmsg = &msgs[i]; +for (i =0 ; i < num; i++) { +int ret =0 ;
there is no need for initialization here.
drivers/i2c/algos/i2c-algo-pcf.c static int pcf_xfer(struct i2c_adapter *i2c_adap, · line 291
Quoted 3 lines
drivers/i2c/algos/i2c-algo-pcf.c +1
-0+ pmsg = &msgs[i]; ret =pcf_doAddress (adap, pmsg);
as a folloing patch you can make pcf_doAddress of the void type and avoid this extra assignment.
Andi
Quoted 2 lines
drivers/i2c/algos/i2c-algo-pcf.c +0
-0/* Send START */
Hi Cezar,
Quoted 3 lines
Cezar Chiru (3):
i2c: pcf8584: Remove debug macros fromi2c-algo-pcf.c
i2c: pcf8584: Fix do not use assignment inside if conditional
I applied these two patches into i2c/i2c-host.
Quoted 1 line
i2c: pcf8584: Move 'ret' variable inside for loop, break if ret < 0.
I left you with two comments here in this patch.
Thanks for following up.
Andi
Andi Shyti
maintainerHi Wolfram,
Quoted 5 lines · Andi Shyti
Quoted 3 lines
Cezar Chiru (3):
i2c: pcf8584: Remove debug macros fromi2c-algo-pcf.c
i2c: pcf8584: Fix do not use assignment inside if conditionalI applied these two patches into i2c/i2c-host.
Sorry, I took these patches in my branch without talking with you. Please, let me know if you want me to take them off.
Andi