drivers/hwmon/aht10.c:182: warning: Function parameter or struct member 'data' not described in 'aht10_interval_write'

[kernel test robot]

Hi Johannes,

FYI, the error/warning still remains.

tree:   https://git.kernel.org/pub/scm/linux/kernel/git/torvalds/linux.git master
head:   1a1d569a75f3ab2923cb62daf356d102e4df2b86
commit: 8c78f0dee4371ab3b0422edf08597525c6219512 hwmon: Add AHT10 Temperature and Humidity Sensor Driver
date:   4 years, 3 months ago
config: csky-randconfig-002-20250106 (https://download.01.org/0day-ci/archive/20250416/202504161919.duDL1s2X-lkp@xxxxxxxxx/config)
compiler: csky-linux-gcc (GCC) 14.2.0
reproduce (this is a W=1 build): (https://download.01.org/0day-ci/archive/20250416/202504161919.duDL1s2X-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/202504161919.duDL1s2X-lkp@xxxxxxxxx/

All warnings (new ones prefixed by >>):

   drivers/hwmon/aht10.c:87: warning: Excess function parameter 'client' description in 'aht10_init'
   drivers/hwmon/aht10.c:131: warning: Function parameter or struct member 'data' not described in 'aht10_read_values'
   drivers/hwmon/aht10.c:131: warning: Excess function parameter 'aht10_data' description in 'aht10_read_values'
>> drivers/hwmon/aht10.c:182: warning: Function parameter or struct member 'data' not described in 'aht10_interval_write'
>> drivers/hwmon/aht10.c:182: warning: Function parameter or struct member 'val' not described in 'aht10_interval_write'
>> drivers/hwmon/aht10.c:193: warning: Function parameter or struct member 'data' not described in 'aht10_interval_read'
>> drivers/hwmon/aht10.c:193: warning: Function parameter or struct member 'val' not described in 'aht10_interval_read'
>> drivers/hwmon/aht10.c:202: warning: Function parameter or struct member 'data' not described in 'aht10_temperature1_read'
>> drivers/hwmon/aht10.c:202: warning: Function parameter or struct member 'val' not described in 'aht10_temperature1_read'
>> drivers/hwmon/aht10.c:217: warning: Function parameter or struct member 'data' not described in 'aht10_humidity1_read'
>> drivers/hwmon/aht10.c:217: warning: Function parameter or struct member 'val' not described in 'aht10_humidity1_read'


vim +182 drivers/hwmon/aht10.c

   174	
   175	/**
   176	 * aht10_interval_write() - store the given minimum poll interval.
   177	 * Return: 0 on success, -EINVAL if a value lower than the
   178	 *         AHT10_MIN_POLL_INTERVAL is given
   179	 */
   180	static ssize_t aht10_interval_write(struct aht10_data *data,
   181					    long val)
 > 182	{
   183		data->min_poll_interval = ms_to_ktime(clamp_val(val, 2000, LONG_MAX));
   184		return 0;
   185	}
   186	
   187	/**
   188	 * aht10_interval_read() - read the minimum poll interval
   189	 *                            in milliseconds
   190	 */
   191	static ssize_t aht10_interval_read(struct aht10_data *data,
   192					   long *val)
 > 193	{
   194		*val = ktime_to_ms(data->min_poll_interval);
   195		return 0;
   196	}
   197	
   198	/**
   199	 * aht10_temperature1_read() - read the temperature in millidegrees
   200	 */
   201	static int aht10_temperature1_read(struct aht10_data *data, long *val)
 > 202	{
   203		int res;
   204	
   205		res = aht10_read_values(data);
   206		if (res < 0)
   207			return res;
   208	
   209		*val = data->temperature;
   210		return 0;
   211	}
   212	
   213	/**
   214	 * aht10_humidity1_read() - read the relative humidity in millipercent
   215	 */
   216	static int aht10_humidity1_read(struct aht10_data *data, long *val)
 > 217	{
   218		int res;
   219	
   220		res = aht10_read_values(data);
   221		if (res < 0)
   222			return res;
   223	
   224		*val = data->humidity;
   225		return 0;
   226	}
   227	

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