i2c: isch: Put the driver into shape
v2 cover i2c: isch: Put the driver into shape
Driver code is quite outdated WRT modern in-kernel APIs and also has one non-critival bug.
The series is to address the above. Has been tested on Minnowboard (Intel Tunnel Creek platform) with connected LM95245 HW monitor chip.
v2:
- dropped applied patch
- fixed format specifier (LKP)
Andy Shevchenko (11):
i2c: isch: Pass pointer to struct i2c_adapter down
i2c: isch: Use string_choices API instead of ternary operator
i2c: isch: Switch to memory mapped IO accessors
i2c: isch: Use custom private data structure
i2c: isch: switch i2c registration to devm functions
i2c: isch: Utilize temporary variable to hold device pointer
i2c: isch: Use read_poll_timeout()
i2c: isch: Unify the name of the variable to hold an error code
i2c: isch: Don't use "proxy" headers
i2c: isch: Prefer to use octal permission
i2c: isch: Convert to kernel-doc
drivers/i2c/busses/i2c-isch.c | 321 +++++++++++++++++----------------- 1 file changed, 164 insertions(+), 157 deletions(-)
Signature · 1 line
2.43.0.rc1.1336.g36b5255a03ac
PATCH v2 1/11 i2c: isch: Pass pointer to struct i2c_adapter down
There are a lot of messaging calls that use global variable of struct i2c_adapter. Instead, to make code better and flexible for further improvements, pass the pointer to the actual adapter used for transfers.
--- drivers/i2c/busses/i2c-isch.c | 53 +++++++++++++++-------------------- 1 file changed, 23 insertions(+), 30 deletions(-)
drivers/i2c/busses/i2c-isch.c +23 -30
@@ -55,14 +55,15 @@ MODULE_PARM_DESC(backbone_speed, "Backbone speed in kHz, (default = 33000)");* and this function will execute it. * return 0 for success and others for failure. */ -static int sch_transaction (void ) +static int sch_transaction (struct i2c_adapter *adap) {int temp;int result =0 ;int retries =0 ; -dev_dbg (&sch_adapter.dev,"Transaction (pre): CNT=%02x, CMD=%02x, " -"ADD=%02x, DAT0=%02x, DAT1=%02x\n" ,inb (SMBHSTCNT ), +dev_dbg (&adap->dev, +"Transaction (pre): CNT=%02x, CMD=%02x, ADD=%02x, DAT0=%02x, DAT1=%02x\n" , +inb (SMBHSTCNT ),inb (SMBHSTCMD ),inb (SMBHSTADD ),inb (SMBHSTDAT0 ),inb (SMBHSTDAT1 ));
@@ -70,19 +71,14 @@ static int sch_transaction(void) temp =inb (SMBHSTSTS ) &0x0f ;if (temp) {/* Can not be busy since we checked it in sch_access */ -if (temp &0x01 ) { -dev_dbg (&sch_adapter.dev,"Completion (%02x). " -"Clear...\n" , temp); - } -if (temp &0x06 ) { -dev_dbg (&sch_adapter.dev,"SMBus error (%02x). " -"Resetting...\n" , temp); - } +if (temp &0x01 ) +dev_dbg (&adap->dev,"Completion (%02x). Clear...\n" , temp); +if (temp &0x06 ) +dev_dbg (&adap->dev,"SMBus error (%02x). Resetting...\n" , temp);outb (temp,SMBHSTSTS ); temp =inb (SMBHSTSTS ) &0x0f ;if (temp) { -dev_err (&sch_adapter.dev, -"SMBus is not ready: (%02x)\n" , temp); +dev_err (&adap->dev,"SMBus is not ready: (%02x)\n" , temp);return -EAGAIN ; } }
@@ -97,31 +93,30 @@ static int sch_transaction(void)/* If the SMBus is still busy, we give up */ if (retries >MAX_RETRIES ) { -dev_err (&sch_adapter.dev,"SMBus Timeout!\n" ); +dev_err (&adap->dev,"SMBus Timeout!\n" ); result = -ETIMEDOUT ; }else if (temp &0x04 ) { result = -EIO ; -dev_dbg (&sch_adapter.dev,"Bus collision! SMBus may be " -"locked until next hard reset. (sorry!)\n" ); +dev_dbg (&adap->dev,"Bus collision! SMBus may be locked until next hard reset. (sorry!)\n" );/* Clock stops and target is stuck in mid-transmission */ }else if (temp &0x02 ) { result = -EIO ; -dev_err (&sch_adapter.dev,"Error: no response!\n" ); +dev_err (&adap->dev,"Error: no response!\n" ); }else if (temp &0x01 ) { -dev_dbg (&sch_adapter.dev,"Post complete!\n" ); +dev_dbg (&adap->dev,"Post complete!\n" );outb (temp,SMBHSTSTS ); temp =inb (SMBHSTSTS ) &0x07 ;if (temp &0x06 ) {/* Completion clear failed */ -dev_dbg (&sch_adapter.dev,"Failed reset at end of " -"transaction (%02x), Bus error!\n" , temp); +dev_dbg (&adap->dev, +"Failed reset at end of transaction (%02x), Bus error!\n" , temp); } }else { result = -ENXIO ; -dev_dbg (&sch_adapter.dev,"No such address.\n" ); +dev_dbg (&adap->dev,"No such address.\n" ); } -dev_dbg (&sch_adapter.dev,"Transaction (post): CNT=%02x, CMD=%02x, " -"ADD=%02x, DAT0=%02x, DAT1=%02x\n" ,inb (SMBHSTCNT ), +dev_dbg (&adap->dev,"Transaction (post): CNT=%02x, CMD=%02x, ADD=%02x, DAT0=%02x, DAT1=%02x\n" , +inb (SMBHSTCNT ),inb (SMBHSTCMD ),inb (SMBHSTADD ),inb (SMBHSTDAT0 ),inb (SMBHSTDAT1 ));return result;
@@ -143,7 +138,7 @@ static s32 sch_access(struct i2c_adapter *adap, u16 addr,/* Make sure the SMBus host is not busy */ temp =inb (SMBHSTSTS ) &0x0f ;if (temp &0x08 ) { -dev_dbg (&sch_adapter.dev,"SMBus busy (%02x)\n" , temp); +dev_dbg (&adap->dev,"SMBus busy (%02x)\n" , temp);return -EAGAIN ; } temp =inw (SMBHSTCLK );
@@ -154,13 +149,11 @@ static s32 sch_access(struct i2c_adapter *adap, u16 addr,* 100 kHz. If we actually run at 25 MHz the bus will be * run ~75 kHz instead which should do no harm. */ -dev_notice (&sch_adapter.dev, -"Clock divider uninitialized. Setting defaults\n" ); +dev_notice (&adap->dev,"Clock divider uninitialized. Setting defaults\n" );outw (backbone_speed / (4 *100 ),SMBHSTCLK ); } -dev_dbg (&sch_adapter.dev,"access size: %d %s\n" , size, - (read_write)?"READ" :"WRITE" ); +dev_dbg (&adap->dev,"access size: %d %s\n" , size, (read_write)?"READ" :"WRITE" );switch (size) {case I2C_SMBUS_QUICK :outb ((addr <<1 ) | read_write,SMBHSTADD );
@@ -205,10 +198,10 @@ static s32 sch_access(struct i2c_adapter *adap, u16 addr,dev_warn (&adap->dev,"Unsupported transaction %d\n" , size);return -EOPNOTSUPP ; } -dev_dbg (&sch_adapter.dev,"write size %d to 0x%04x\n" , size,SMBHSTCNT ); +dev_dbg (&adap->dev,"write size %d to 0x%04x\n" , size,SMBHSTCNT );outb ((inb (SMBHSTCNT ) &0xb0 ) | (size &0x7 ),SMBHSTCNT ); - rc =sch_transaction (); + rc =sch_transaction (adap);if (rc)/* Error in transaction */ return rc;
Signature · 1 line
2.43.0.rc1.1336.g36b5255a03ac
PATCH v2 2/11 i2c: isch: Use string_choices API instead of ternary operator
In reply to Andy ShevchenkoUse modern string_choices API instead of manually determining the output using ternary operator.
--- drivers/i2c/busses/i2c-isch.c | 5 +++-- 1 file changed, 3 insertions(+), 2 deletions(-)
drivers/i2c/busses/i2c-isch.c +3 -2
@@ -19,10 +19,11 @@#include <linux/platform_device.h> #include <linux/kernel.h> #include <linux/delay.h> -#include <linux/stddef.h> #include <linux/ioport.h> #include <linux/i2c.h> #include <linux/io.h> +#include <linux/stddef.h> +#include <linux/string_choices.h> /* SCH SMBus address offsets */ #define SMBHSTCNT (0 + sch_smba)
@@ -153,7 +154,7 @@ static s32 sch_access(struct i2c_adapter *adap, u16 addr,outw (backbone_speed / (4 *100 ),SMBHSTCLK ); } -dev_dbg (&adap->dev,"access size: %d %s\n" , size, (read_write)?"READ" :"WRITE" ); +dev_dbg (&adap->dev,"access size: %d %s\n" , size,str_read_write (read_write));switch (size) {case I2C_SMBUS_QUICK :outb ((addr <<1 ) | read_write,SMBHSTADD );
Signature · 1 line
2.43.0.rc1.1336.g36b5255a03ac
PATCH v2 3/11 i2c: isch: Switch to memory mapped IO accessors
In reply to Andy ShevchenkoConvert driver to use memory mapped IO accessors.
--- drivers/i2c/busses/i2c-isch.c | 133 ++++++++++++++++++++-------------- 1 file changed, 78 insertions(+), 55 deletions(-)
drivers/i2c/busses/i2c-isch.c +78 -55
@@ -24,16 +24,17 @@#include <linux/io.h> #include <linux/stddef.h> #include <linux/string_choices.h> +#include <linux/types.h> /* SCH SMBus address offsets */ -#define SMBHSTCNT (0 + sch_smba) -#define SMBHSTSTS (1 + sch_smba) -#define SMBHSTCLK (2 + sch_smba) -#define SMBHSTADD (4 + sch_smba)/* TSA */ -#define SMBHSTCMD (5 + sch_smba) -#define SMBHSTDAT0 (6 + sch_smba) -#define SMBHSTDAT1 (7 + sch_smba) -#define SMBBLKDAT (0x20 + sch_smba) +#define SMBHSTCNT 0x00 +#define SMBHSTSTS 0x01 +#define SMBHSTCLK 0x02 +#define SMBHSTADD 0x04/* TSA */ +#define SMBHSTCMD 0x05 +#define SMBHSTDAT0 0x06 +#define SMBHSTDAT1 0x07 +#define SMBBLKDAT 0x20/* Other settings */ #define MAX_RETRIES 5000
@@ -45,12 +46,33 @@#define SCH_WORD_DATA 0x03#define SCH_BLOCK_DATA 0x05 -static unsigned short sch_smba;static struct i2c_adapter sch_adapter; +static void __iomem *sch_smba; +static int backbone_speed =33000 ;/* backbone speed in kHz */ module_param (backbone_speed, int,S_IRUSR |S_IWUSR );MODULE_PARM_DESC (backbone_speed,"Backbone speed in kHz, (default = 33000)" ); +static inline u8 sch_io_rd8 (void __iomem *smba,unsigned int offset) +{ +return ioread8 (smba + offset); +} + +static inline void sch_io_wr8 (void __iomem *smba,unsigned int offset,u8 value) +{ +iowrite8 (value, smba + offset); +} + +static inline u16 sch_io_rd16 (void __iomem *smba,unsigned int offset) +{ +return ioread16 (smba + offset); +} + +static inline void sch_io_wr16 (void __iomem *smba,unsigned int offset,u16 value) +{ +iowrite16 (value, smba + offset); +} +/* * Start the i2c transaction -- the i2c_access will prepare the transaction * and this function will execute it.
@@ -64,20 +86,20 @@ static int sch_transaction(struct i2c_adapter *adap)dev_dbg (&adap->dev,"Transaction (pre): CNT=%02x, CMD=%02x, ADD=%02x, DAT0=%02x, DAT1=%02x\n" , -inb (SMBHSTCNT ), -inb (SMBHSTCMD ),inb (SMBHSTADD ),inb (SMBHSTDAT0 ), -inb (SMBHSTDAT1 )); +sch_io_rd8 (sch_smba,SMBHSTCNT ),sch_io_rd8 (sch_smba,SMBHSTCMD ), +sch_io_rd8 (sch_smba,SMBHSTADD ), +sch_io_rd8 (sch_smba,SMBHSTDAT0 ),sch_io_rd8 (sch_smba,SMBHSTDAT1 ));/* Make sure the SMBus host is ready to start transmitting */ - temp =inb (SMBHSTSTS ) &0x0f ; + temp =sch_io_rd8 (sch_smba,SMBHSTSTS ) &0x0f ;if (temp) {/* Can not be busy since we checked it in sch_access */ if (temp &0x01 )dev_dbg (&adap->dev,"Completion (%02x). Clear...\n" , temp);if (temp &0x06 )dev_dbg (&adap->dev,"SMBus error (%02x). Resetting...\n" , temp); -outb (temp,SMBHSTSTS ); - temp =inb (SMBHSTSTS ) &0x0f ; +sch_io_wr8 (sch_smba,SMBHSTSTS , temp); + temp =sch_io_rd8 (sch_smba,SMBHSTSTS ) &0x0f ;if (temp) {dev_err (&adap->dev,"SMBus is not ready: (%02x)\n" , temp);return -EAGAIN ;
@@ -85,11 +107,13 @@ static int sch_transaction(struct i2c_adapter *adap) }/* start the transaction by setting bit 4 */ -outb (inb (SMBHSTCNT ) |0x10 ,SMBHSTCNT ); + temp =sch_io_rd8 (sch_smba,SMBHSTCNT ); + temp |=0x10 ; +sch_io_wr8 (sch_smba,SMBHSTCNT , temp);do {usleep_range (100 ,200 ); - temp =inb (SMBHSTSTS ) &0x0f ; + temp =sch_io_rd8 (sch_smba,SMBHSTSTS ) &0x0f ; }while ((temp &0x08 ) && (retries++ <MAX_RETRIES ));/* If the SMBus is still busy, we give up */
@@ -105,8 +129,8 @@ static int sch_transaction(struct i2c_adapter *adap)dev_err (&adap->dev,"Error: no response!\n" ); }else if (temp &0x01 ) {dev_dbg (&adap->dev,"Post complete!\n" ); -outb (temp,SMBHSTSTS ); - temp =inb (SMBHSTSTS ) &0x07 ; +sch_io_wr8 (sch_smba,SMBHSTSTS , temp); + temp =sch_io_rd8 (sch_smba,SMBHSTSTS ) &0x07 ;if (temp &0x06 ) {/* Completion clear failed */ dev_dbg(&adap->dev,
@@ -117,9 +141,9 @@ static int sch_transaction(struct i2c_adapter *adap)dev_dbg (&adap->dev,"No such address.\n" ); }dev_dbg (&adap->dev,"Transaction (post): CNT=%02x, CMD=%02x, ADD=%02x, DAT0=%02x, DAT1=%02x\n" , -inb (SMBHSTCNT ), -inb (SMBHSTCMD ),inb (SMBHSTADD ),inb (SMBHSTDAT0 ), -inb (SMBHSTDAT1 )); +sch_io_rd8 (sch_smba,SMBHSTCNT ),sch_io_rd8 (sch_smba,SMBHSTCMD ), +sch_io_rd8 (sch_smba,SMBHSTADD ), +sch_io_rd8 (sch_smba,SMBHSTDAT0 ),sch_io_rd8 (sch_smba,SMBHSTDAT1 ));return result; }
@@ -137,12 +161,12 @@ static s32 sch_access(struct i2c_adapter *adap, u16 addr,int i, len, temp, rc;/* Make sure the SMBus host is not busy */ - temp =inb (SMBHSTSTS ) &0x0f ; + temp =sch_io_rd8 (sch_smba,SMBHSTSTS ) &0x0f ;if (temp &0x08 ) {dev_dbg (&adap->dev,"SMBus busy (%02x)\n" , temp);return -EAGAIN ; } - temp =inw (SMBHSTCLK ); + temp =sch_io_rd16 (sch_smba,SMBHSTCLK );if (!temp) {/* * We can't determine if we have 33 or 25 MHz clock for
@@ -151,47 +175,47 @@ static s32 sch_access(struct i2c_adapter *adap, u16 addr,* run ~75 kHz instead which should do no harm. */ dev_notice (&adap->dev,"Clock divider uninitialized. Setting defaults\n" ); -outw (backbone_speed / (4 *100 ),SMBHSTCLK ); +sch_io_wr16 (sch_smba,SMBHSTCLK , backbone_speed / (4 *100 )); }dev_dbg (&adap->dev,"access size: %d %s\n" , size,str_read_write (read_write));switch (size) {case I2C_SMBUS_QUICK : -outb ((addr <<1 ) | read_write,SMBHSTADD ); +sch_io_wr8 (sch_smba,SMBHSTADD , (addr <<1 ) | read_write); size =SCH_QUICK ;break ;case I2C_SMBUS_BYTE : -outb ((addr <<1 ) | read_write,SMBHSTADD ); +sch_io_wr8 (sch_smba,SMBHSTADD , (addr <<1 ) | read_write);if (read_write ==I2C_SMBUS_WRITE ) -outb (command,SMBHSTCMD ); +sch_io_wr8 (sch_smba,SMBHSTCMD , command); size =SCH_BYTE ;break ;case I2C_SMBUS_BYTE_DATA : -outb ((addr <<1 ) | read_write,SMBHSTADD ); -outb (command,SMBHSTCMD ); +sch_io_wr8 (sch_smba,SMBHSTADD , (addr <<1 ) | read_write); +sch_io_wr8 (sch_smba,SMBHSTCMD , command);if (read_write ==I2C_SMBUS_WRITE ) -outb (data->byte,SMBHSTDAT0 ); +sch_io_wr8 (sch_smba,SMBHSTDAT0 , data->byte); size =SCH_BYTE_DATA ;break ;case I2C_SMBUS_WORD_DATA : -outb ((addr <<1 ) | read_write,SMBHSTADD ); -outb (command,SMBHSTCMD ); +sch_io_wr8 (sch_smba,SMBHSTADD , (addr <<1 ) | read_write); +sch_io_wr8 (sch_smba,SMBHSTCMD , command);if (read_write ==I2C_SMBUS_WRITE ) { -outb (data->word &0xff ,SMBHSTDAT0 ); -outb ((data->word &0xff00 ) >>8 ,SMBHSTDAT1 ); +sch_io_wr8 (sch_smba,SMBHSTDAT0 , data->word >>0 ); +sch_io_wr8 (sch_smba,SMBHSTDAT1 , data->word >>8 ); } size =SCH_WORD_DATA ;break ;case I2C_SMBUS_BLOCK_DATA : -outb ((addr <<1 ) | read_write,SMBHSTADD ); -outb (command,SMBHSTCMD ); +sch_io_wr8 (sch_smba,SMBHSTADD , (addr <<1 ) | read_write); +sch_io_wr8 (sch_smba,SMBHSTCMD , command);if (read_write ==I2C_SMBUS_WRITE ) { len = data->block[0 ];if (len ==0 || len >I2C_SMBUS_BLOCK_MAX )return -EINVAL ; -outb (len,SMBHSTDAT0 ); +sch_io_wr8 (sch_smba,SMBHSTDAT0 , len);for (i =1 ; i <= len; i++) -outb (data->block[i],SMBBLKDAT +i-1 ); +sch_io_wr8 (sch_smba,SMBBLKDAT + i -1 , data->block[i]); } size =SCH_BLOCK_DATA ;break ;
@@ -200,7 +224,10 @@ static s32 sch_access(struct i2c_adapter *adap, u16 addr,return -EOPNOTSUPP ; }dev_dbg (&adap->dev,"write size %d to 0x%04x\n" , size,SMBHSTCNT ); -outb ((inb (SMBHSTCNT ) &0xb0 ) | (size &0x7 ),SMBHSTCNT ); + + temp =sch_io_rd8 (sch_smba,SMBHSTCNT ); + temp = (temp &0xb0 ) | (size &0x7 ); +sch_io_wr8 (sch_smba,SMBHSTCNT , temp); rc =sch_transaction (adap);if (rc)/* Error in transaction */
@@ -212,17 +239,18 @@ static s32 sch_access(struct i2c_adapter *adap, u16 addr,switch (size) {case SCH_BYTE :case SCH_BYTE_DATA : - data->byte =inb (SMBHSTDAT0 ); + data->byte =sch_io_rd8 (sch_smba,SMBHSTDAT0 );break ;case SCH_WORD_DATA : - data->word =inb (SMBHSTDAT0 ) + (inb (SMBHSTDAT1 ) <<8 ); + data->word = (sch_io_rd8 (sch_smba,SMBHSTDAT0 ) <<0 ) + + (sch_io_rd8 (sch_smba,SMBHSTDAT1 ) <<8 );break ;case SCH_BLOCK_DATA : - data->block[0 ] =inb (SMBHSTDAT0 ); + data->block[0 ] =sch_io_rd8 (sch_smba,SMBHSTDAT0 );if (data->block[0 ] ==0 || data->block[0 ] >I2C_SMBUS_BLOCK_MAX )return -EPROTO ;for (i =1 ; i <= data->block[0 ]; i++) - data->block[i] =inb (SMBBLKDAT +i-1 ); + data->block[i] =sch_io_rd8 (sch_smba,SMBBLKDAT + i -1 );break ; }return 0 ;
@@ -255,26 +283,21 @@ static int smbus_sch_probe(struct platform_device *dev)if (!res)return -EBUSY ; -if (!devm_request_region (&dev->dev, res->start,resource_size (res), - dev->name)) { -dev_err (&dev->dev,"SMBus region 0x%x already in use!\n" , - sch_smba); + sch_smba =devm_ioport_map (&dev->dev, res->start,resource_size (res)); +if (!sch_smba) { +dev_err (&dev->dev,"SMBus region %pR already in use!\n" , res);return -EBUSY ; } - sch_smba = res->start; - -dev_dbg (&dev->dev,"SMBA = 0x%X\n" , sch_smba); -/* set up the sysfs linkage to our parent device */ sch_adapter.dev.parent = &dev->dev;snprintf (sch_adapter.name,sizeof (sch_adapter.name), -"SMBus SCH adapter at %04x" , sch_smba); +"SMBus SCH adapter at %04x" , (unsigned short )res->start); retval =i2c_add_adapter (&sch_adapter);if (retval) - sch_smba =0 ; + sch_smba =NULL ;return retval; }
@@ -283,7 +306,7 @@ static void smbus_sch_remove(struct platform_device *pdev) {if (sch_smba) {i2c_del_adapter (&sch_adapter); - sch_smba =0 ; + sch_smba =NULL ; } }
Signature · 1 line
2.43.0.rc1.1336.g36b5255a03ac
PATCH v2 4/11 i2c: isch: Use custom private data structure
In reply to Andy ShevchenkoUse custom private data structure instead of global variables. With that, remove not anymore true comment.
--- drivers/i2c/busses/i2c-isch.c | 145 ++++++++++++++++++---------------- 1 file changed, 75 insertions(+), 70 deletions(-)
drivers/i2c/busses/i2c-isch.c +75 -70
@@ -9,16 +9,14 @@*/ -/* -Supports: -Intel SCH chipsets (AF82US15W, AF82US15L, AF82UL11L) -Note: we assume there can only be one device, with one SMBus interface. -*/ +/* Supports: Intel SCH chipsets (AF82US15W, AF82US15L, AF82UL11L) */ #include <linux/module.h> #include <linux/platform_device.h> #include <linux/kernel.h> +#include <linux/container_of.h> #include <linux/delay.h> +#include <linux/device.h> #include <linux/ioport.h> #include <linux/i2c.h> #include <linux/io.h>
@@ -46,31 +44,33 @@#define SCH_WORD_DATA 0x03#define SCH_BLOCK_DATA 0x05 -static struct i2c_adapter sch_adapter; -static void __iomem *sch_smba; +struct sch_i2c { +struct i2c_adapter adapter; +void __iomem *smba; +};static int backbone_speed =33000 ;/* backbone speed in kHz */ module_param (backbone_speed, int,S_IRUSR |S_IWUSR );MODULE_PARM_DESC (backbone_speed,"Backbone speed in kHz, (default = 33000)" ); -static inline u8 sch_io_rd8 (void __iomem *smba,unsigned int offset) +static inline u8 sch_io_rd8 (struct sch_i2c *priv,unsigned int offset) { -return ioread8 (smba + offset); +return ioread8 (priv->smba + offset); } -static inline void sch_io_wr8 (void __iomem *smba,unsigned int offset,u8 value) +static inline void sch_io_wr8 (struct sch_i2c *priv,unsigned int offset,u8 value) { -iowrite8 (value, smba + offset); +iowrite8 (value, priv->smba + offset); } -static inline u16 sch_io_rd16 (void __iomem *smba,unsigned int offset) +static inline u16 sch_io_rd16 (struct sch_i2c *priv,unsigned int offset) { -return ioread16 (smba + offset); +return ioread16 (priv->smba + offset); } -static inline void sch_io_wr16 (void __iomem *smba,unsigned int offset,u16 value) +static inline void sch_io_wr16 (struct sch_i2c *priv,unsigned int offset,u16 value) { -iowrite16 (value, smba + offset); +iowrite16 (value, priv->smba + offset); }/*
@@ -80,26 +80,27 @@ static inline void sch_io_wr16(void __iomem *smba, unsigned int offset, u16 valu*/ static int sch_transaction (struct i2c_adapter *adap) { + struct sch_i2c *priv = container_of(adap, struct sch_i2c, adapter);int temp;int result =0 ;int retries =0 ;dev_dbg (&adap->dev,"Transaction (pre): CNT=%02x, CMD=%02x, ADD=%02x, DAT0=%02x, DAT1=%02x\n" , -sch_io_rd8 (sch_smba,SMBHSTCNT ),sch_io_rd8 (sch_smba,SMBHSTCMD ), -sch_io_rd8 (sch_smba,SMBHSTADD ), -sch_io_rd8 (sch_smba,SMBHSTDAT0 ),sch_io_rd8 (sch_smba,SMBHSTDAT1 )); +sch_io_rd8 (priv,SMBHSTCNT ),sch_io_rd8 (priv,SMBHSTCMD ), +sch_io_rd8 (priv,SMBHSTADD ), +sch_io_rd8 (priv,SMBHSTDAT0 ),sch_io_rd8 (priv,SMBHSTDAT1 ));/* Make sure the SMBus host is ready to start transmitting */ - temp =sch_io_rd8 (sch_smba,SMBHSTSTS ) &0x0f ; + temp =sch_io_rd8 (priv,SMBHSTSTS ) &0x0f ;if (temp) {/* Can not be busy since we checked it in sch_access */ if (temp &0x01 )dev_dbg (&adap->dev,"Completion (%02x). Clear...\n" , temp);if (temp &0x06 )dev_dbg (&adap->dev,"SMBus error (%02x). Resetting...\n" , temp); -sch_io_wr8 (sch_smba,SMBHSTSTS , temp); - temp =sch_io_rd8 (sch_smba,SMBHSTSTS ) &0x0f ; +sch_io_wr8 (priv,SMBHSTSTS , temp); + temp =sch_io_rd8 (priv,SMBHSTSTS ) &0x0f ;if (temp) {dev_err (&adap->dev,"SMBus is not ready: (%02x)\n" , temp);return -EAGAIN ;
@@ -107,13 +108,13 @@ static int sch_transaction(struct i2c_adapter *adap) }/* start the transaction by setting bit 4 */ - temp =sch_io_rd8 (sch_smba,SMBHSTCNT ); + temp =sch_io_rd8 (priv,SMBHSTCNT ); temp |=0x10 ; -sch_io_wr8 (sch_smba,SMBHSTCNT , temp); +sch_io_wr8 (priv,SMBHSTCNT , temp);do {usleep_range (100 ,200 ); - temp =sch_io_rd8 (sch_smba,SMBHSTSTS ) &0x0f ; + temp =sch_io_rd8 (priv,SMBHSTSTS ) &0x0f ; }while ((temp &0x08 ) && (retries++ <MAX_RETRIES ));/* If the SMBus is still busy, we give up */
@@ -129,8 +130,8 @@ static int sch_transaction(struct i2c_adapter *adap)dev_err (&adap->dev,"Error: no response!\n" ); }else if (temp &0x01 ) {dev_dbg (&adap->dev,"Post complete!\n" ); -sch_io_wr8 (sch_smba,SMBHSTSTS , temp); - temp =sch_io_rd8 (sch_smba,SMBHSTSTS ) &0x07 ; +sch_io_wr8 (priv,SMBHSTSTS , temp); + temp =sch_io_rd8 (priv,SMBHSTSTS ) &0x07 ;if (temp &0x06 ) {/* Completion clear failed */ dev_dbg(&adap->dev,
@@ -141,9 +142,9 @@ static int sch_transaction(struct i2c_adapter *adap)dev_dbg (&adap->dev,"No such address.\n" ); }dev_dbg (&adap->dev,"Transaction (post): CNT=%02x, CMD=%02x, ADD=%02x, DAT0=%02x, DAT1=%02x\n" , -sch_io_rd8 (sch_smba,SMBHSTCNT ),sch_io_rd8 (sch_smba,SMBHSTCMD ), -sch_io_rd8 (sch_smba,SMBHSTADD ), -sch_io_rd8 (sch_smba,SMBHSTDAT0 ),sch_io_rd8 (sch_smba,SMBHSTDAT1 )); +sch_io_rd8 (priv,SMBHSTCNT ),sch_io_rd8 (priv,SMBHSTCMD ), +sch_io_rd8 (priv,SMBHSTADD ), +sch_io_rd8 (priv,SMBHSTDAT0 ),sch_io_rd8 (priv,SMBHSTDAT1 ));return result; }
@@ -158,15 +159,16 @@ static s32 sch_access(struct i2c_adapter *adap, u16 addr, unsigned short flags, char read_write, u8 command, int size, union i2c_smbus_data *data) { + struct sch_i2c *priv = container_of(adap, struct sch_i2c, adapter);int i, len, temp, rc;/* Make sure the SMBus host is not busy */ - temp =sch_io_rd8 (sch_smba,SMBHSTSTS ) &0x0f ; + temp =sch_io_rd8 (priv,SMBHSTSTS ) &0x0f ;if (temp &0x08 ) {dev_dbg (&adap->dev,"SMBus busy (%02x)\n" , temp);return -EAGAIN ; } - temp =sch_io_rd16 (sch_smba,SMBHSTCLK ); + temp =sch_io_rd16 (priv,SMBHSTCLK );if (!temp) {/* * We can't determine if we have 33 or 25 MHz clock for
@@ -175,47 +177,47 @@ static s32 sch_access(struct i2c_adapter *adap, u16 addr,* run ~75 kHz instead which should do no harm. */ dev_notice (&adap->dev,"Clock divider uninitialized. Setting defaults\n" ); -sch_io_wr16 (sch_smba,SMBHSTCLK , backbone_speed / (4 *100 )); +sch_io_wr16 (priv,SMBHSTCLK , backbone_speed / (4 *100 )); }dev_dbg (&adap->dev,"access size: %d %s\n" , size,str_read_write (read_write));switch (size) {case I2C_SMBUS_QUICK : -sch_io_wr8 (sch_smba,SMBHSTADD , (addr <<1 ) | read_write); +sch_io_wr8 (priv,SMBHSTADD , (addr <<1 ) | read_write); size =SCH_QUICK ;break ;case I2C_SMBUS_BYTE : -sch_io_wr8 (sch_smba,SMBHSTADD , (addr <<1 ) | read_write); +sch_io_wr8 (priv,SMBHSTADD , (addr <<1 ) | read_write);if (read_write ==I2C_SMBUS_WRITE ) -sch_io_wr8 (sch_smba,SMBHSTCMD , command); +sch_io_wr8 (priv,SMBHSTCMD , command); size =SCH_BYTE ;break ;case I2C_SMBUS_BYTE_DATA : -sch_io_wr8 (sch_smba,SMBHSTADD , (addr <<1 ) | read_write); -sch_io_wr8 (sch_smba,SMBHSTCMD , command); +sch_io_wr8 (priv,SMBHSTADD , (addr <<1 ) | read_write); +sch_io_wr8 (priv,SMBHSTCMD , command);if (read_write ==I2C_SMBUS_WRITE ) -sch_io_wr8 (sch_smba,SMBHSTDAT0 , data->byte); +sch_io_wr8 (priv,SMBHSTDAT0 , data->byte); size =SCH_BYTE_DATA ;break ;case I2C_SMBUS_WORD_DATA : -sch_io_wr8 (sch_smba,SMBHSTADD , (addr <<1 ) | read_write); -sch_io_wr8 (sch_smba,SMBHSTCMD , command); +sch_io_wr8 (priv,SMBHSTADD , (addr <<1 ) | read_write); +sch_io_wr8 (priv,SMBHSTCMD , command);if (read_write ==I2C_SMBUS_WRITE ) { -sch_io_wr8 (sch_smba,SMBHSTDAT0 , data->word >>0 ); -sch_io_wr8 (sch_smba,SMBHSTDAT1 , data->word >>8 ); +sch_io_wr8 (priv,SMBHSTDAT0 , data->word >>0 ); +sch_io_wr8 (priv,SMBHSTDAT1 , data->word >>8 ); } size =SCH_WORD_DATA ;break ;case I2C_SMBUS_BLOCK_DATA : -sch_io_wr8 (sch_smba,SMBHSTADD , (addr <<1 ) | read_write); -sch_io_wr8 (sch_smba,SMBHSTCMD , command); +sch_io_wr8 (priv,SMBHSTADD , (addr <<1 ) | read_write); +sch_io_wr8 (priv,SMBHSTCMD , command);if (read_write ==I2C_SMBUS_WRITE ) { len = data->block[0 ];if (len ==0 || len >I2C_SMBUS_BLOCK_MAX )return -EINVAL ; -sch_io_wr8 (sch_smba,SMBHSTDAT0 , len); +sch_io_wr8 (priv,SMBHSTDAT0 , len);for (i =1 ; i <= len; i++) -sch_io_wr8 (sch_smba,SMBBLKDAT + i -1 , data->block[i]); +sch_io_wr8 (priv,SMBBLKDAT + i -1 , data->block[i]); } size =SCH_BLOCK_DATA ;break ;
@@ -225,9 +227,9 @@ static s32 sch_access(struct i2c_adapter *adap, u16 addr, }dev_dbg (&adap->dev,"write size %d to 0x%04x\n" , size,SMBHSTCNT ); - temp =sch_io_rd8 (sch_smba,SMBHSTCNT ); + temp =sch_io_rd8 (priv,SMBHSTCNT ); temp = (temp &0xb0 ) | (size &0x7 ); -sch_io_wr8 (sch_smba,SMBHSTCNT , temp); +sch_io_wr8 (priv,SMBHSTCNT , temp); rc =sch_transaction (adap);if (rc)/* Error in transaction */
@@ -239,18 +241,18 @@ static s32 sch_access(struct i2c_adapter *adap, u16 addr,switch (size) {case SCH_BYTE :case SCH_BYTE_DATA : - data->byte =sch_io_rd8 (sch_smba,SMBHSTDAT0 ); + data->byte =sch_io_rd8 (priv,SMBHSTDAT0 );break ;case SCH_WORD_DATA : - data->word = (sch_io_rd8 (sch_smba,SMBHSTDAT0 ) <<0 ) + - (sch_io_rd8 (sch_smba,SMBHSTDAT1 ) <<8 ); + data->word = (sch_io_rd8 (priv,SMBHSTDAT0 ) <<0 ) + + (sch_io_rd8 (priv,SMBHSTDAT1 ) <<8 );break ;case SCH_BLOCK_DATA : - data->block[0 ] =sch_io_rd8 (sch_smba,SMBHSTDAT0 ); + data->block[0 ] =sch_io_rd8 (priv,SMBHSTDAT0 );if (data->block[0 ] ==0 || data->block[0 ] >I2C_SMBUS_BLOCK_MAX )return -EPROTO ;for (i =1 ; i <= data->block[0 ]; i++) - data->block[i] =sch_io_rd8 (sch_smba,SMBBLKDAT + i -1 ); + data->block[i] =sch_io_rd8 (priv,SMBBLKDAT + i -1 );break ; }return 0 ;
@@ -268,46 +270,49 @@ static const struct i2c_algorithm smbus_algorithm = { .functionality = sch_func, }; -static struct i2c_adapter sch_adapter = { - .owner =THIS_MODULE , - .class =I2C_CLASS_HWMON , - .algo = &smbus_algorithm, -}; -static int smbus_sch_probe (struct platform_device *dev) { +struct sch_i2c *priv;struct resource *res;int retval; + priv =devm_kzalloc (&dev->dev,sizeof (*priv),GFP_KERNEL ); +if (!priv) +return -ENOMEM ; + res =platform_get_resource (dev,IORESOURCE_IO ,0 );if (!res)return -EBUSY ; - sch_smba =devm_ioport_map (&dev->dev, res->start,resource_size (res)); -if (!sch_smba) { + priv->smba =devm_ioport_map (&dev->dev, res->start,resource_size (res)); +if (!priv->smba) {dev_err (&dev->dev,"SMBus region %pR already in use!\n" , res);return -EBUSY ; }/* set up the sysfs linkage to our parent device */ - sch_adapter.dev.parent = &dev->dev; + priv->adapter.dev.parent = &dev->dev; + priv->adapter.owner =THIS_MODULE , + priv->adapter.class =I2C_CLASS_HWMON , + priv->adapter.algo = &smbus_algorithm, -snprintf (sch_adapter.name,sizeof (sch_adapter.name), +snprintf (priv->adapter.name,sizeof (priv->adapter.name),"SMBus SCH adapter at %04x" , (unsigned short )res->start); - retval =i2c_add_adapter (&sch_adapter); + retval =i2c_add_adapter (&priv->adapter);if (retval) - sch_smba =NULL ; +return retval; -return retval; +platform_set_drvdata (dev, priv); + +return 0 ; }static void smbus_sch_remove (struct platform_device *pdev) { -if (sch_smba) { -i2c_del_adapter (&sch_adapter); - sch_smba =NULL ; - } +struct sch_i2c *priv =platform_get_drvdata (pdev); + +i2c_del_adapter (&priv->adapter); }static struct platform_driver smbus_sch_driver = {
Signature · 1 line
2.43.0.rc1.1336.g36b5255a03ac
PATCH v2 5/11 i2c: isch: switch i2c registration to devm functions
In reply to Andy ShevchenkoSwitch from i2c_add_adapter() to resource managed devm_i2c_add_adapter() for matching rest of driver initialization, and more concise code.
--- drivers/i2c/busses/i2c-isch.c | 17 +---------------- 1 file changed, 1 insertion(+), 16 deletions(-)
drivers/i2c/busses/i2c-isch.c +1 -16
@@ -274,7 +274,6 @@ static int smbus_sch_probe(struct platform_device *dev) {struct sch_i2c *priv;struct resource *res; -int retval; priv =devm_kzalloc (&dev->dev,sizeof (*priv),GFP_KERNEL );if (!priv)
@@ -299,20 +298,7 @@ static int smbus_sch_probe(struct platform_device *dev)snprintf (priv->adapter.name,sizeof (priv->adapter.name),"SMBus SCH adapter at %04x" , (unsigned short )res->start); - retval =i2c_add_adapter (&priv->adapter); -if (retval) -return retval; - -platform_set_drvdata (dev, priv); - -return 0 ; -} - -static void smbus_sch_remove (struct platform_device *pdev) -{ -struct sch_i2c *priv =platform_get_drvdata (pdev); - -i2c_del_adapter (&priv->adapter); +return devm_i2c_add_adapter (&dev->dev, &priv->adapter); }static struct platform_driver smbus_sch_driver = {
@@ -320,7 +306,6 @@ static struct platform_driver smbus_sch_driver = { .name = "isch_smbus", }, .probe = smbus_sch_probe, - .remove_new = smbus_sch_remove, };module_platform_driver (smbus_sch_driver);
Signature · 1 line
2.43.0.rc1.1336.g36b5255a03ac
PATCH v2 6/11 i2c: isch: Utilize temporary variable to hold device pointer
In reply to Andy ShevchenkoIntroduce a temporary variable to hold a device pointer. It can be utilized in the ->probe() and save a bit of LoCs. To make it consistent, rename currently used dev to pdev.
While at it, convert the only error message to dev_err_probe().
--- drivers/i2c/busses/i2c-isch.c | 19 +++++++++---------- 1 file changed, 9 insertions(+), 10 deletions(-)
drivers/i2c/busses/i2c-isch.c +9 -10
@@ -270,27 +270,26 @@ static const struct i2c_algorithm smbus_algorithm = { .functionality = sch_func, }; -static int smbus_sch_probe (struct platform_device *dev) +static int smbus_sch_probe (struct platform_device *pdev) { +struct device *dev = &pdev->dev;struct sch_i2c *priv;struct resource *res; - priv =devm_kzalloc (&dev->dev,sizeof (*priv),GFP_KERNEL ); + priv =devm_kzalloc (dev,sizeof (*priv),GFP_KERNEL );if (!priv)return -ENOMEM ; - res =platform_get_resource (dev,IORESOURCE_IO ,0 ); + res =platform_get_resource (pdev,IORESOURCE_IO ,0 );if (!res)return -EBUSY ; - priv->smba =devm_ioport_map (&dev->dev, res->start,resource_size (res)); -if (!priv->smba) { -dev_err (&dev->dev,"SMBus region %pR already in use!\n" , res); -return -EBUSY ; - } + priv->smba =devm_ioport_map (dev, res->start,resource_size (res)); +if (!priv->smba) +return dev_err_probe (dev, -EBUSY ,"SMBus region %pR already in use!\n" , res);/* set up the sysfs linkage to our parent device */ - priv->adapter.dev.parent = &dev->dev; + priv->adapter.dev.parent = dev; priv->adapter.owner =THIS_MODULE , priv->adapter.class =I2C_CLASS_HWMON , priv->adapter.algo = &smbus_algorithm,
@@ -298,7 +297,7 @@ static int smbus_sch_probe(struct platform_device *dev)snprintf (priv->adapter.name,sizeof (priv->adapter.name),"SMBus SCH adapter at %04x" , (unsigned short )res->start); -return devm_i2c_add_adapter (&dev->dev, &priv->adapter); +return devm_i2c_add_adapter (dev, &priv->adapter); }static struct platform_driver smbus_sch_driver = {
Signature · 1 line
2.43.0.rc1.1336.g36b5255a03ac
PATCH v2 7/11 i2c: isch: Use read_poll_timeout()
In reply to Andy ShevchenkoSimplify the code by using read_poll_timeout().
--- drivers/i2c/busses/i2c-isch.c | 20 ++++++-------------- 1 file changed, 6 insertions(+), 14 deletions(-)
drivers/i2c/busses/i2c-isch.c +6 -14
@@ -17,9 +17,9 @@#include <linux/container_of.h> #include <linux/delay.h> #include <linux/device.h> -#include <linux/ioport.h> #include <linux/i2c.h> -#include <linux/io.h> +#include <linux/iopoll.h> +#include <linux/ioport.h> #include <linux/stddef.h> #include <linux/string_choices.h> #include <linux/types.h>
@@ -34,9 +34,6 @@#define SMBHSTDAT1 0x07#define SMBBLKDAT 0x20 -/* Other settings */ -#define MAX_RETRIES 5000 -/* I2C constants */ #define SCH_QUICK 0x00#define SCH_BYTE 0x01
@@ -83,7 +80,6 @@ static int sch_transaction(struct i2c_adapter *adap) struct sch_i2c *priv = container_of(adap, struct sch_i2c, adapter);int temp;int result =0 ; -int retries =0 ; dev_dbg(&adap->dev, "Transaction (pre): CNT=%02x, CMD=%02x, ADD=%02x, DAT0=%02x, DAT1=%02x\n",
@@ -112,15 +108,11 @@ static int sch_transaction(struct i2c_adapter *adap) temp |=0x10 ;sch_io_wr8 (priv,SMBHSTCNT , temp); -do { -usleep_range (100 ,200 ); - temp =sch_io_rd8 (priv,SMBHSTSTS ) &0x0f ; - }while ((temp &0x08 ) && (retries++ <MAX_RETRIES )); - + result =read_poll_timeout (sch_io_rd8, temp, !(temp &0x08 ),200 ,500000 , true, + priv,SMBHSTSTS );/* If the SMBus is still busy, we give up */ -if (retries >MAX_RETRIES ) { +if (result) {dev_err (&adap->dev,"SMBus Timeout!\n" ); - result = -ETIMEDOUT ; }else if (temp &0x04 ) { result = -EIO ;dev_dbg (&adap->dev,"Bus collision! SMBus may be locked until next hard reset. (sorry!)\n" );
@@ -130,7 +122,7 @@ static int sch_transaction(struct i2c_adapter *adap)dev_err (&adap->dev,"Error: no response!\n" ); }else if (temp &0x01 ) {dev_dbg (&adap->dev,"Post complete!\n" ); -sch_io_wr8 (priv,SMBHSTSTS , temp); +sch_io_wr8 (priv,SMBHSTSTS , temp &0x0f ); temp =sch_io_rd8 (priv,SMBHSTSTS ) &0x07 ;if (temp &0x06 ) {/* Completion clear failed */
Signature · 1 line
2.43.0.rc1.1336.g36b5255a03ac
PATCH v2 8/11 i2c: isch: Unify the name of the variable to hold an error code
In reply to Andy ShevchenkoThere are two different names used for the variable that holds an error code. Unify to use one variant in all cases.
--- drivers/i2c/busses/i2c-isch.c | 15 +++++++-------- 1 file changed, 7 insertions(+), 8 deletions(-)
drivers/i2c/busses/i2c-isch.c +7 -8
@@ -79,7 +79,7 @@ static int sch_transaction(struct i2c_adapter *adap) { struct sch_i2c *priv = container_of(adap, struct sch_i2c, adapter);int temp; -int result =0 ; +int rc; dev_dbg(&adap->dev, "Transaction (pre): CNT=%02x, CMD=%02x, ADD=%02x, DAT0=%02x, DAT1=%02x\n",
@@ -108,17 +108,16 @@ static int sch_transaction(struct i2c_adapter *adap) temp |=0x10 ;sch_io_wr8 (priv,SMBHSTCNT , temp); - result =read_poll_timeout (sch_io_rd8, temp, !(temp &0x08 ),200 ,500000 , true, - priv,SMBHSTSTS ); + rc =read_poll_timeout (sch_io_rd8, temp, !(temp &0x08 ),200 ,500000 , true, priv,SMBHSTSTS );/* If the SMBus is still busy, we give up */ -if (result) { +if (rc) {dev_err (&adap->dev,"SMBus Timeout!\n" ); }else if (temp &0x04 ) { - result = -EIO ; + rc = -EIO ;dev_dbg (&adap->dev,"Bus collision! SMBus may be locked until next hard reset. (sorry!)\n" );/* Clock stops and target is stuck in mid-transmission */ }else if (temp &0x02 ) { - result = -EIO ; + rc = -EIO ;dev_err (&adap->dev,"Error: no response!\n" ); }else if (temp &0x01 ) {dev_dbg (&adap->dev,"Post complete!\n" );
@@ -130,14 +129,14 @@ static int sch_transaction(struct i2c_adapter *adap) "Failed reset at end of transaction (%02x), Bus error!\n", temp); } }else { - result = -ENXIO ; + rc = -ENXIO ;dev_dbg (&adap->dev,"No such address.\n" ); }dev_dbg (&adap->dev,"Transaction (post): CNT=%02x, CMD=%02x, ADD=%02x, DAT0=%02x, DAT1=%02x\n" ,sch_io_rd8 (priv,SMBHSTCNT ),sch_io_rd8 (priv,SMBHSTCMD ),sch_io_rd8 (priv,SMBHSTADD ),sch_io_rd8 (priv,SMBHSTDAT0 ),sch_io_rd8 (priv,SMBHSTDAT1 )); -return result; +return rc; }/*
Signature · 1 line
2.43.0.rc1.1336.g36b5255a03ac
PATCH v2 9/11 i2c: isch: Don't use "proxy" headers
In reply to Andy ShevchenkoUpdate header inclusions to follow IWYU (Include What You Use) principle.
--- drivers/i2c/busses/i2c-isch.c | 8 +++++--- 1 file changed, 5 insertions(+), 3 deletions(-)
drivers/i2c/busses/i2c-isch.c +5 -3
@@ -11,15 +11,17 @@/* Supports: Intel SCH chipsets (AF82US15W, AF82US15L, AF82UL11L) */ -#include <linux/module.h> -#include <linux/platform_device.h> -#include <linux/kernel.h> #include <linux/container_of.h> #include <linux/delay.h> #include <linux/device.h> +#include <linux/errno.h> +#include <linux/gfp_types.h> #include <linux/i2c.h> #include <linux/iopoll.h> #include <linux/ioport.h> +#include <linux/module.h> +#include <linux/platform_device.h> +#include <linux/sprintf.h> #include <linux/stddef.h> #include <linux/string_choices.h> #include <linux/types.h>
Signature · 1 line
2.43.0.rc1.1336.g36b5255a03ac
PATCH v2 10/11 i2c: isch: Prefer to use octal permission
In reply to Andy ShevchenkoOctal permissions are preferred over the symbolics ones for readbility. This ceases warning message pointed by checkpatch.
--- drivers/i2c/busses/i2c-isch.c | 2 +- 1 file changed, 1 insertion(+), 1 deletion(-)
drivers/i2c/busses/i2c-isch.c +1 -1
@@ -49,7 +49,7 @@ struct sch_i2c { };static int backbone_speed =33000 ;/* backbone speed in kHz */ -module_param (backbone_speed, int,S_IRUSR |S_IWUSR ); +module_param (backbone_speed, int,0600 );MODULE_PARM_DESC (backbone_speed,"Backbone speed in kHz, (default = 33000)" );static inline u8 sch_io_rd8 (struct sch_i2c *priv,unsigned int offset)
Signature · 1 line
2.43.0.rc1.1336.g36b5255a03ac
PATCH v2 11/11 i2c: isch: Convert to kernel-doc
In reply to Andy ShevchenkoConvert existing descriptions to kernel-doc format and unify the rest of the comments to follow the modern style.
--- drivers/i2c/busses/i2c-isch.c | 48 ++++++++++++++++++++--------------- 1 file changed, 28 insertions(+), 20 deletions(-)
drivers/i2c/busses/i2c-isch.c +28 -20
@@ -1,13 +1,12 @@// SPDX-License-Identifier: GPL-2.0-only /* -i2c-isch.c - Linux kernel driver for Intel SCH chipset SMBus -- Based on i2c-piix4.c -Copyright (c) 1998 - 2002 Frodo Looijaard <[email protected]> and -Philip Edelbrock <[email protected]> -- Intel SCH support -Copyright (c) 2007 - 2008 Jacob Jun Pan <[email protected]> - -*/ +* Linux kernel driver for Intel SCH chipset SMBus +* - Based on i2c-piix4.c +* Copyright (c) 1998 - 2002 Frodo Looijaard <[email protected]> and +* Philip Edelbrock <[email protected]> +* - Intel SCH support +* Copyright (c) 2007 - 2008 Jacob Jun Pan <[email protected]> +*/ /* Supports: Intel SCH chipsets (AF82US15W, AF82US15L, AF82UL11L) */
@@ -72,10 +71,14 @@ static inline void sch_io_wr16(struct sch_i2c *priv, unsigned int offset, u16 vaiowrite16 (value, priv->smba + offset); } -/* -* Start the i2c transaction -- the i2c_access will prepare the transaction -* and this function will execute it. -* return 0 for success and others for failure. +/** +* sch_transaction - Start the i2c transaction +* @adap: the i2c adapter pointer +* +* The sch_access() will prepare the transaction and +* this function will execute it. +* +* Return: 0 for success and others for failure. */ static int sch_transaction (struct i2c_adapter *adap) {
@@ -105,7 +108,7 @@ static int sch_transaction(struct i2c_adapter *adap) } } -/* start the transaction by setting bit 4 */ +/* Start the transaction by setting bit 4 */ temp =sch_io_rd8 (priv,SMBHSTCNT ); temp |=0x10 ;sch_io_wr8 (priv,SMBHSTCNT , temp);
@@ -141,12 +144,17 @@ static int sch_transaction(struct i2c_adapter *adap)return rc; } -/* -* This is the main access entry for i2c-sch access -* adap is i2c_adapter pointer, addr is the i2c device bus address, read_write -* (0 for read and 1 for write), size is i2c transaction type and data is the -* union of transaction for data to be transferred or data read from bus. -* return 0 for success and others for failure. +/** +* sch_access - the main access entry for i2c-sch access +* @adap: the i2c adapter pointer +* @addr: the i2c device bus address +* @flags: I2C_CLIENT_* flags (usually zero or I2C_CLIENT_PEC) +* @read_write: 0 for read and 1 for write +* @command: Byte interpreted by slave, for protocols which use such bytes +* @size: the i2c transaction type +* @data: the union of transaction for data to be transferred or data read from bus +* +* Return: 0 for success and others for failure. */ static s32 sch_access(struct i2c_adapter *adap, u16 addr, unsigned short flags, char read_write,
@@ -281,7 +289,7 @@ static int smbus_sch_probe(struct platform_device *pdev)if (!priv->smba)return dev_err_probe (dev, -EBUSY ,"SMBus region %pR already in use!\n" , res); -/* set up the sysfs linkage to our parent device */ +/* Set up the sysfs linkage to our parent device */ priv->adapter.dev.parent = dev; priv->adapter.owner =THIS_MODULE , priv->adapter.class = I2C_CLASS_HWMON,
Signature · 1 line
2.43.0.rc1.1336.g36b5255a03ac
Hi Andy,
Quoted 4 lines
Andy Shevchenko (11):
i2c: isch: Pass pointer to structi2c_adapterdown
i2c: isch: Usestring_choicesAPI instead of ternary operator
i2c: isch: Switch to memory mapped IO accessors
Quoted 8 lines
i2c: isch: Use custom private data structure
i2c: isch: switch i2c registration to devm functions
i2c: isch: Utilize temporary variable to hold device pointer
i2c: isch: Useread_poll_timeout()
i2c: isch: Unify the name of the variable to hold an error code
i2c: isch: Don't use "proxy" headers
i2c: isch: Prefer to use octal permission
i2c: isch: Convert to kernel-doc
Applied to i2c/i2c-host-for-6.13. These patches will be moved into i2c/i2c-host after the merge window.
Thanks,
Andi