[broonie-ci:v5_20250314_frank_li_regulator_add_new_pmic_pf9453_support 9/9] drivers/regulator/pf9453-regulator.c:304: warning: This comment starts with '/**', but isn't a kernel-doc comment. Refer Documentation/doc-guide/kernel-doc.rst

[Date Prev][Date Next][Thread Prev][Thread Next][Date Index][Thread Index]

 



tree:   https://git.kernel.org/pub/scm/linux/kernel/git/broonie/ci.git v5_20250314_frank_li_regulator_add_new_pmic_pf9453_support
head:   0959b6706325bf147f253841eea312e27a3bf013
commit: 0959b6706325bf147f253841eea312e27a3bf013 [9/9] regulator: pf9453: add PMIC PF9453 support
config: sh-allmodconfig (https://download.01.org/0day-ci/archive/20250317/202503171400.UJKAoYR4-lkp@xxxxxxxxx/config)
compiler: sh4-linux-gcc (GCC) 14.2.0
reproduce (this is a W=1 build): (https://download.01.org/0day-ci/archive/20250317/202503171400.UJKAoYR4-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/202503171400.UJKAoYR4-lkp@xxxxxxxxx/

All warnings (new ones prefixed by >>):

>> drivers/regulator/pf9453-regulator.c:304: warning: This comment starts with '/**', but isn't a kernel-doc comment. Refer Documentation/doc-guide/kernel-doc.rst
    * pf9453_regulator_enable_regmap for regmap users
   drivers/regulator/pf9453-regulator.c:329: warning: This comment starts with '/**', but isn't a kernel-doc comment. Refer Documentation/doc-guide/kernel-doc.rst
    * pf9453_regulator_disable_regmap for regmap users
   drivers/regulator/pf9453-regulator.c:354: warning: This comment starts with '/**', but isn't a kernel-doc comment. Refer Documentation/doc-guide/kernel-doc.rst
    * pf9453_regulator_set_voltage_sel_regmap for regmap users
>> drivers/regulator/pf9453-regulator.c:421: warning: Function parameter or struct member 'ramp_delay' not described in 'pf9453_regulator_set_ramp_delay_regmap'


vim +304 drivers/regulator/pf9453-regulator.c

   302	
   303	/**
 > 304	 * pf9453_regulator_enable_regmap for regmap users
   305	 *
   306	 * @rdev: regulator to operate on
   307	 *
   308	 * Regulators that use regmap for their register I/O can set the
   309	 * enable_reg and enable_mask fields in their descriptor and then use
   310	 * this as their enable() operation, saving some code.
   311	 */
   312	static int pf9453_regulator_enable_regmap(struct regulator_dev *rdev)
   313	{
   314		struct pf9453 *pf9453 = dev_get_drvdata(rdev->dev.parent);
   315		unsigned int val;
   316	
   317		if (rdev->desc->enable_is_inverted) {
   318			val = rdev->desc->disable_val;
   319		} else {
   320			val = rdev->desc->enable_val;
   321			if (!val)
   322				val = rdev->desc->enable_mask;
   323		}
   324	
   325		return pf9453_pmic_write(pf9453, rdev->desc->enable_reg, rdev->desc->enable_mask, val);
   326	}
   327	
   328	/**
   329	 * pf9453_regulator_disable_regmap for regmap users
   330	 *
   331	 * @rdev: regulator to operate on
   332	 *
   333	 * Regulators that use regmap for their register I/O can set the
   334	 * enable_reg and enable_mask fields in their descriptor and then use
   335	 * this as their disable() operation, saving some code.
   336	 */
   337	static int pf9453_regulator_disable_regmap(struct regulator_dev *rdev)
   338	{
   339		struct pf9453 *pf9453 = dev_get_drvdata(rdev->dev.parent);
   340		unsigned int val;
   341	
   342		if (rdev->desc->enable_is_inverted) {
   343			val = rdev->desc->enable_val;
   344			if (!val)
   345				val = rdev->desc->enable_mask;
   346		} else {
   347			val = rdev->desc->disable_val;
   348		}
   349	
   350		return pf9453_pmic_write(pf9453, rdev->desc->enable_reg, rdev->desc->enable_mask, val);
   351	}
   352	
   353	/**
   354	 * pf9453_regulator_set_voltage_sel_regmap for regmap users
   355	 *
   356	 * @rdev: regulator to operate on
   357	 * @sel: Selector to set
   358	 *
   359	 * Regulators that use regmap for their register I/O can set the
   360	 * vsel_reg and vsel_mask fields in their descriptor and then use this
   361	 * as their set_voltage_vsel operation, saving some code.
   362	 */
   363	static int pf9453_regulator_set_voltage_sel_regmap(struct regulator_dev *rdev, unsigned int sel)
   364	{
   365		struct pf9453 *pf9453 = dev_get_drvdata(rdev->dev.parent);
   366		int ret;
   367	
   368		sel <<= ffs(rdev->desc->vsel_mask) - 1;
   369		ret = pf9453_pmic_write(pf9453, rdev->desc->vsel_reg, rdev->desc->vsel_mask, sel);
   370		if (ret)
   371			return ret;
   372	
   373		if (rdev->desc->apply_bit)
   374			ret = pf9453_pmic_write(pf9453, rdev->desc->apply_reg,
   375						rdev->desc->apply_bit, rdev->desc->apply_bit);
   376		return ret;
   377	}
   378	
   379	static int find_closest_bigger(unsigned int target, const unsigned int *table,
   380				       unsigned int num_sel, unsigned int *sel)
   381	{
   382		unsigned int s, tmp, max, maxsel = 0;
   383		bool found = false;
   384	
   385		max = table[0];
   386	
   387		for (s = 0; s < num_sel; s++) {
   388			if (table[s] > max) {
   389				max = table[s];
   390				maxsel = s;
   391			}
   392			if (table[s] >= target) {
   393				if (!found || table[s] - target < tmp - target) {
   394					tmp = table[s];
   395					*sel = s;
   396					found = true;
   397					if (tmp == target)
   398						break;
   399				}
   400			}
   401		}
   402	
   403		if (!found) {
   404			*sel = maxsel;
   405			return -EINVAL;
   406		}
   407	
   408		return 0;
   409	}
   410	
   411	/**
   412	 * pf9453_regulator_set_ramp_delay_regmap
   413	 *
   414	 * @rdev: regulator to operate on
   415	 *
   416	 * Regulators that use regmap for their register I/O can set the ramp_reg
   417	 * and ramp_mask fields in their descriptor and then use this as their
   418	 * set_ramp_delay operation, saving some code.
   419	 */
   420	static int pf9453_regulator_set_ramp_delay_regmap(struct regulator_dev *rdev, int ramp_delay)
 > 421	{
   422		struct pf9453 *pf9453 = dev_get_drvdata(rdev->dev.parent);
   423		unsigned int sel;
   424		int ret;
   425	
   426		if (WARN_ON(!rdev->desc->n_ramp_values || !rdev->desc->ramp_delay_table))
   427			return -EINVAL;
   428	
   429		ret = find_closest_bigger(ramp_delay, rdev->desc->ramp_delay_table,
   430					  rdev->desc->n_ramp_values, &sel);
   431	
   432		if (ret) {
   433			dev_warn(rdev_get_dev(rdev),
   434				 "Can't set ramp-delay %u, setting %u\n", ramp_delay,
   435				 rdev->desc->ramp_delay_table[sel]);
   436		}
   437	
   438		sel <<= ffs(rdev->desc->ramp_mask) - 1;
   439	
   440		return pf9453_pmic_write(pf9453, rdev->desc->ramp_reg,
   441					 rdev->desc->ramp_mask, sel);
   442	}
   443	

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




[Index of Archives]     [Kernel Newbies]     [Security]     [Netfilter]     [Bugtraq]     [Linux FS]     [Yosemite Forum]     [MIPS Linux]     [ARM Linux]     [Linux Security]     [Linux RAID]     [Samba]     [Video 4 Linux]     [Device Mapper]     [Linux Resources]

  Powered by Linux