drivers/spi/atmel-quadspi.c:244: warning: Function parameter or struct member 'pclk_div' not described in 'atmel_qspi_pcal'

From: kernel test robot
Date: Fri Jan 31 2025 - 04:31:54 EST


Hi Tudor,

FYI, the error/warning still remains.

tree: https://git.kernel.org/pub/scm/linux/kernel/git/torvalds/linux.git master
head: 69e858e0b8b2ea07759e995aa383e8780d9d140c
commit: 5af42209a4d23adc9a09e59e586d1b47fef3cc86 spi: atmel-quadspi: Add support for sama7g5 QSPI
date: 6 weeks ago
config: mips-randconfig-r024-20220830 (https://download.01.org/0day-ci/archive/20250131/202501311707.Ltj0qXse-lkp@xxxxxxxxx/config)
compiler: mips-linux-gcc (GCC) 12.3.0
reproduce (this is a W=1 build): (https://download.01.org/0day-ci/archive/20250131/202501311707.Ltj0qXse-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/202501311707.Ltj0qXse-lkp@xxxxxxxxx/

All warnings (new ones prefixed by >>):

>> drivers/spi/atmel-quadspi.c:244: warning: Function parameter or struct member 'pclk_div' not described in 'atmel_qspi_pcal'
>> drivers/spi/atmel-quadspi.c:244: warning: Excess struct member 'pclkdiv' description in 'atmel_qspi_pcal'


vim +244 drivers/spi/atmel-quadspi.c

232
233 /* Use PIO for small transfers. */
234 #define ATMEL_QSPI_DMA_MIN_BYTES 16
235 /**
236 * struct atmel_qspi_pcal - Pad Calibration Clock Division
237 * @pclk_rate: peripheral clock rate.
238 * @pclkdiv: calibration clock division. The clock applied to the calibration
239 * cell is divided by pclkdiv + 1.
240 */
241 struct atmel_qspi_pcal {
242 u32 pclk_rate;
243 u8 pclk_div;
> 244 };
245

--
0-DAY CI Kernel Test Service
https://github.com/intel/lkp-tests/wiki