drivers/i2c/busses/i2c-cadence.c:218: warning: Function parameter or member 'rinfo' not described in 'cdns_i2c'
From: kernel test robot
Date: Thu Aug 17 2023 - 03:55:30 EST
tree: https://git.kernel.org/pub/scm/linux/kernel/git/torvalds/linux.git master
head: 4853c74bd7ab7fdb83f319bd9ace8a08c031e9b6
commit: 58b924241d0a23eee8e86dd9e6f5dacd01c82e62 i2c: cadence: Add standard bus recovery support
date: 11 months ago
config: riscv-randconfig-r002-20230817 (https://download.01.org/0day-ci/archive/20230817/202308171510.bKHBcZQW-lkp@xxxxxxxxx/config)
compiler: clang version 15.0.7 (https://github.com/llvm/llvm-project.git 8dfdcc7b7bf66834a761bd8de445840ef68e4d1a)
reproduce: (https://download.01.org/0day-ci/archive/20230817/202308171510.bKHBcZQW-lkp@xxxxxxxxx/reproduce)
If you fix the issue in a separate patch/commit (i.e. not just a new version of
the same patch/commit), kindly add following tags
| Reported-by: kernel test robot <lkp@xxxxxxxxx>
| Closes: https://lore.kernel.org/oe-kbuild-all/202308171510.bKHBcZQW-lkp@xxxxxxxxx/
All warnings (new ones prefixed by >>):
>> drivers/i2c/busses/i2c-cadence.c:218: warning: Function parameter or member 'rinfo' not described in 'cdns_i2c'
vim +218 drivers/i2c/busses/i2c-cadence.c
1a351b10b9671f Radu Pirea 2020-01-06 163
df8eb5691c48d3 Soren Brinkmann 2014-04-04 164 /**
df8eb5691c48d3 Soren Brinkmann 2014-04-04 165 * struct cdns_i2c - I2C device private data structure
30e31a1fbc1fc0 Shubhrajyoti Datta 2016-03-07 166 *
30e31a1fbc1fc0 Shubhrajyoti Datta 2016-03-07 167 * @dev: Pointer to device structure
df8eb5691c48d3 Soren Brinkmann 2014-04-04 168 * @membase: Base address of the I2C device
df8eb5691c48d3 Soren Brinkmann 2014-04-04 169 * @adap: I2C adapter instance
df8eb5691c48d3 Soren Brinkmann 2014-04-04 170 * @p_msg: Message pointer
df8eb5691c48d3 Soren Brinkmann 2014-04-04 171 * @err_status: Error status in Interrupt Status Register
df8eb5691c48d3 Soren Brinkmann 2014-04-04 172 * @xfer_done: Transfer complete status
df8eb5691c48d3 Soren Brinkmann 2014-04-04 173 * @p_send_buf: Pointer to transmit buffer
df8eb5691c48d3 Soren Brinkmann 2014-04-04 174 * @p_recv_buf: Pointer to receive buffer
df8eb5691c48d3 Soren Brinkmann 2014-04-04 175 * @send_count: Number of bytes still expected to send
df8eb5691c48d3 Soren Brinkmann 2014-04-04 176 * @recv_count: Number of bytes still expected to receive
9fae82e1acda8d Harini Katakam 2014-12-12 177 * @curr_recv_count: Number of bytes to be received in current transfer
df8eb5691c48d3 Soren Brinkmann 2014-04-04 178 * @irq: IRQ number
df8eb5691c48d3 Soren Brinkmann 2014-04-04 179 * @input_clk: Input clock to I2C controller
df8eb5691c48d3 Soren Brinkmann 2014-04-04 180 * @i2c_clk: Maximum I2C clock speed
df8eb5691c48d3 Soren Brinkmann 2014-04-04 181 * @bus_hold_flag: Flag used in repeated start for clearing HOLD bit
df8eb5691c48d3 Soren Brinkmann 2014-04-04 182 * @clk: Pointer to struct clk
df8eb5691c48d3 Soren Brinkmann 2014-04-04 183 * @clk_rate_change_nb: Notifier block for clock rate changes
63cab195bf4986 Anurag Kumar Vulisha 2015-07-10 184 * @quirks: flag for broken hold bit usage in r1p10
8b51a8e64443b9 Shubhrajyoti Datta 2021-07-13 185 * @ctrl_reg: Cached value of the control register.
1a351b10b9671f Radu Pirea 2020-01-06 186 * @ctrl_reg_diva_divb: value of fields DIV_A and DIV_B from CR register
1a351b10b9671f Radu Pirea 2020-01-06 187 * @slave: Registered slave instance.
1a351b10b9671f Radu Pirea 2020-01-06 188 * @dev_mode: I2C operating role(master/slave).
1a351b10b9671f Radu Pirea 2020-01-06 189 * @slave_state: I2C Slave state(idle/read/write).
df8eb5691c48d3 Soren Brinkmann 2014-04-04 190 */
df8eb5691c48d3 Soren Brinkmann 2014-04-04 191 struct cdns_i2c {
7fa32329ca0314 Shubhrajyoti Datta 2015-11-24 192 struct device *dev;
df8eb5691c48d3 Soren Brinkmann 2014-04-04 193 void __iomem *membase;
df8eb5691c48d3 Soren Brinkmann 2014-04-04 194 struct i2c_adapter adap;
df8eb5691c48d3 Soren Brinkmann 2014-04-04 195 struct i2c_msg *p_msg;
df8eb5691c48d3 Soren Brinkmann 2014-04-04 196 int err_status;
df8eb5691c48d3 Soren Brinkmann 2014-04-04 197 struct completion xfer_done;
df8eb5691c48d3 Soren Brinkmann 2014-04-04 198 unsigned char *p_send_buf;
df8eb5691c48d3 Soren Brinkmann 2014-04-04 199 unsigned char *p_recv_buf;
df8eb5691c48d3 Soren Brinkmann 2014-04-04 200 unsigned int send_count;
df8eb5691c48d3 Soren Brinkmann 2014-04-04 201 unsigned int recv_count;
9fae82e1acda8d Harini Katakam 2014-12-12 202 unsigned int curr_recv_count;
df8eb5691c48d3 Soren Brinkmann 2014-04-04 203 int irq;
df8eb5691c48d3 Soren Brinkmann 2014-04-04 204 unsigned long input_clk;
df8eb5691c48d3 Soren Brinkmann 2014-04-04 205 unsigned int i2c_clk;
df8eb5691c48d3 Soren Brinkmann 2014-04-04 206 unsigned int bus_hold_flag;
df8eb5691c48d3 Soren Brinkmann 2014-04-04 207 struct clk *clk;
df8eb5691c48d3 Soren Brinkmann 2014-04-04 208 struct notifier_block clk_rate_change_nb;
63cab195bf4986 Anurag Kumar Vulisha 2015-07-10 209 u32 quirks;
8b51a8e64443b9 Shubhrajyoti Datta 2021-07-13 210 u32 ctrl_reg;
58b924241d0a23 Shubhrajyoti Datta 2022-07-28 211 struct i2c_bus_recovery_info rinfo;
1a351b10b9671f Radu Pirea 2020-01-06 212 #if IS_ENABLED(CONFIG_I2C_SLAVE)
1a351b10b9671f Radu Pirea 2020-01-06 213 u16 ctrl_reg_diva_divb;
1a351b10b9671f Radu Pirea 2020-01-06 214 struct i2c_client *slave;
1a351b10b9671f Radu Pirea 2020-01-06 215 enum cdns_i2c_mode dev_mode;
1a351b10b9671f Radu Pirea 2020-01-06 216 enum cdns_i2c_slave_state slave_state;
1a351b10b9671f Radu Pirea 2020-01-06 217 #endif
63cab195bf4986 Anurag Kumar Vulisha 2015-07-10 @218 };
63cab195bf4986 Anurag Kumar Vulisha 2015-07-10 219
:::::: The code at line 218 was first introduced by commit
:::::: 63cab195bf498676619951e81ad5791e9d47c420 i2c: removed work arounds in i2c driver for Zynq Ultrascale+ MPSoC
:::::: TO: Anurag Kumar Vulisha <anurag.kumar.vulisha@xxxxxxxxxx>
:::::: CC: Wolfram Sang <wsa@xxxxxxxxxxxxx>
--
0-DAY CI Kernel Test Service
https://github.com/intel/lkp-tests/wiki