Message ID | 20240322132619.6389-53-wsa+renesas@sang-engineering.com |
---|---|
State | Superseded |
Headers | show |
Series | i2c: reword i2c_algorithm according to newest specification | expand |
On 2024/3/22 21:25, Wolfram Sang wrote: > Match the wording of this driver wrt. the newest I2C v7, SMBus 3.2, I3C > specifications and replace "master/slave" with more appropriate terms. > They are also more specific because we distinguish now between a remote > entity ("client") and a local one ("target"). > > Signed-off-by: Wolfram Sang <wsa+renesas@sang-engineering.com> LGTM. Thanks. Reviewed-by: Baolin Wang <baolin.wang@linux.alibaba.com> > --- > drivers/i2c/busses/i2c-sprd.c | 14 +++++++------- > 1 file changed, 7 insertions(+), 7 deletions(-) > > diff --git a/drivers/i2c/busses/i2c-sprd.c b/drivers/i2c/busses/i2c-sprd.c > index 28c88901d9bc..f1a8375ccc17 100644 > --- a/drivers/i2c/busses/i2c-sprd.c > +++ b/drivers/i2c/busses/i2c-sprd.c > @@ -283,7 +283,7 @@ static int sprd_i2c_handle_msg(struct i2c_adapter *i2c_adap, > return i2c_dev->err; > } > > -static int sprd_i2c_master_xfer(struct i2c_adapter *i2c_adap, > +static int sprd_i2c_xfer(struct i2c_adapter *i2c_adap, > struct i2c_msg *msgs, int num) > { > struct sprd_i2c *i2c_dev = i2c_adap->algo_data; > @@ -314,7 +314,7 @@ static u32 sprd_i2c_func(struct i2c_adapter *adap) > } > > static const struct i2c_algorithm sprd_i2c_algo = { > - .master_xfer = sprd_i2c_master_xfer, > + .xfer = sprd_i2c_xfer, > .functionality = sprd_i2c_func, > }; > > @@ -378,12 +378,12 @@ static irqreturn_t sprd_i2c_isr_thread(int irq, void *dev_id) > i2c_tran = i2c_dev->count; > > /* > - * If we got one ACK from slave when writing data, and we did not > + * If we got one ACK from client when writing data, and we did not > * finish this transmission (i2c_tran is not zero), then we should > * continue to write data. > * > * For reading data, ack is always true, if i2c_tran is not 0 which > - * means we still need to contine to read data from slave. > + * means we still need to contine to read data from client. > */ > if (i2c_tran && ack) { > sprd_i2c_data_transfer(i2c_dev); > @@ -393,7 +393,7 @@ static irqreturn_t sprd_i2c_isr_thread(int irq, void *dev_id) > i2c_dev->err = 0; > > /* > - * If we did not get one ACK from slave when writing data, we should > + * If we did not get one ACK from client when writing data, we should > * return -EIO to notify users. > */ > if (!ack) > @@ -422,7 +422,7 @@ static irqreturn_t sprd_i2c_isr(int irq, void *dev_id) > i2c_tran = i2c_dev->count; > > /* > - * If we did not get one ACK from slave when writing data, then we > + * If we did not get one ACK from client when writing data, then we > * should finish this transmission since we got some errors. > * > * When writing data, if i2c_tran == 0 which means we have writen > @@ -653,5 +653,5 @@ static struct platform_driver sprd_i2c_driver = { > > module_platform_driver(sprd_i2c_driver); > > -MODULE_DESCRIPTION("Spreadtrum I2C master controller driver"); > +MODULE_DESCRIPTION("Spreadtrum I2C host controller driver"); > MODULE_LICENSE("GPL v2");
diff --git a/drivers/i2c/busses/i2c-sprd.c b/drivers/i2c/busses/i2c-sprd.c index 28c88901d9bc..f1a8375ccc17 100644 --- a/drivers/i2c/busses/i2c-sprd.c +++ b/drivers/i2c/busses/i2c-sprd.c @@ -283,7 +283,7 @@ static int sprd_i2c_handle_msg(struct i2c_adapter *i2c_adap, return i2c_dev->err; } -static int sprd_i2c_master_xfer(struct i2c_adapter *i2c_adap, +static int sprd_i2c_xfer(struct i2c_adapter *i2c_adap, struct i2c_msg *msgs, int num) { struct sprd_i2c *i2c_dev = i2c_adap->algo_data; @@ -314,7 +314,7 @@ static u32 sprd_i2c_func(struct i2c_adapter *adap) } static const struct i2c_algorithm sprd_i2c_algo = { - .master_xfer = sprd_i2c_master_xfer, + .xfer = sprd_i2c_xfer, .functionality = sprd_i2c_func, }; @@ -378,12 +378,12 @@ static irqreturn_t sprd_i2c_isr_thread(int irq, void *dev_id) i2c_tran = i2c_dev->count; /* - * If we got one ACK from slave when writing data, and we did not + * If we got one ACK from client when writing data, and we did not * finish this transmission (i2c_tran is not zero), then we should * continue to write data. * * For reading data, ack is always true, if i2c_tran is not 0 which - * means we still need to contine to read data from slave. + * means we still need to contine to read data from client. */ if (i2c_tran && ack) { sprd_i2c_data_transfer(i2c_dev); @@ -393,7 +393,7 @@ static irqreturn_t sprd_i2c_isr_thread(int irq, void *dev_id) i2c_dev->err = 0; /* - * If we did not get one ACK from slave when writing data, we should + * If we did not get one ACK from client when writing data, we should * return -EIO to notify users. */ if (!ack) @@ -422,7 +422,7 @@ static irqreturn_t sprd_i2c_isr(int irq, void *dev_id) i2c_tran = i2c_dev->count; /* - * If we did not get one ACK from slave when writing data, then we + * If we did not get one ACK from client when writing data, then we * should finish this transmission since we got some errors. * * When writing data, if i2c_tran == 0 which means we have writen @@ -653,5 +653,5 @@ static struct platform_driver sprd_i2c_driver = { module_platform_driver(sprd_i2c_driver); -MODULE_DESCRIPTION("Spreadtrum I2C master controller driver"); +MODULE_DESCRIPTION("Spreadtrum I2C host controller driver"); MODULE_LICENSE("GPL v2");
Match the wording of this driver wrt. the newest I2C v7, SMBus 3.2, I3C specifications and replace "master/slave" with more appropriate terms. They are also more specific because we distinguish now between a remote entity ("client") and a local one ("target"). Signed-off-by: Wolfram Sang <wsa+renesas@sang-engineering.com> --- drivers/i2c/busses/i2c-sprd.c | 14 +++++++------- 1 file changed, 7 insertions(+), 7 deletions(-)