sound/soc/codecs/wsa883x.c:1402: warning: This comment starts with '/**', but isn't a kernel-doc comment. Refer Documentation/doc-guide/kernel-doc.rst

sound/soc/codecs/wsa883x.c:1402: warning: This comment starts with '/**', but isn't a kernel-doc comment. Refer Documentation/doc-guide/kernel-doc.rst

[kernel test robot]

tree:   https://git.kernel.org/pub/scm/linux/kernel/git/torvalds/linux.git master
head:   02ddfb981de88a2c15621115dd7be2431252c568
commit: 1cf3295bd108abbd7f128071ae9775fd18394ca9 ASoC: codecs: wsa883x: parse port-mapping information
date:   10 months ago
config: sh-randconfig-002-20250426 (https://download.01.org/0day-ci/archive/20250426/202504261851.TJGZIvtl-lkp@intel.com/config)
compiler: sh4-linux-gcc (GCC) 12.4.0
reproduce (this is a W=1 build): (https://download.01.org/0day-ci/archive/20250426/202504261851.TJGZIvtl-lkp@intel.com/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@intel.com>
| Closes: https://lore.kernel.org/oe-kbuild-all/202504261851.TJGZIvtl-lkp@intel.com/

All warnings (new ones prefixed by >>):

>> sound/soc/codecs/wsa883x.c:1402: warning: This comment starts with '/**', but isn't a kernel-doc comment. Refer Documentation/doc-guide/kernel-doc.rst
            * Port map index starts with 0, however the data port for this codec


vim +1402 sound/soc/codecs/wsa883x.c

  1364	
  1365	static int wsa883x_probe(struct sdw_slave *pdev,
  1366				 const struct sdw_device_id *id)
  1367	{
  1368		struct wsa883x_priv *wsa883x;
  1369		struct device *dev = &pdev->dev;
  1370		int ret;
  1371	
  1372		wsa883x = devm_kzalloc(dev, sizeof(*wsa883x), GFP_KERNEL);
  1373		if (!wsa883x)
  1374			return -ENOMEM;
  1375	
  1376		wsa883x->vdd = devm_regulator_get(dev, "vdd");
  1377		if (IS_ERR(wsa883x->vdd))
  1378			return dev_err_probe(dev, PTR_ERR(wsa883x->vdd),
  1379					     "No vdd regulator found\n");
  1380	
  1381		ret = regulator_enable(wsa883x->vdd);
  1382		if (ret)
  1383			return dev_err_probe(dev, ret, "Failed to enable vdd regulator\n");
  1384	
  1385		wsa883x->sd_n = devm_gpiod_get_optional(dev, "powerdown",
  1386							GPIOD_FLAGS_BIT_NONEXCLUSIVE | GPIOD_OUT_HIGH);
  1387		if (IS_ERR(wsa883x->sd_n)) {
  1388			ret = dev_err_probe(dev, PTR_ERR(wsa883x->sd_n),
  1389					    "Shutdown Control GPIO not found\n");
  1390			goto err;
  1391		}
  1392	
  1393		dev_set_drvdata(dev, wsa883x);
  1394		wsa883x->slave = pdev;
  1395		wsa883x->dev = dev;
  1396		wsa883x->sconfig.ch_count = 1;
  1397		wsa883x->sconfig.bps = 1;
  1398		wsa883x->sconfig.direction = SDW_DATA_DIR_RX;
  1399		wsa883x->sconfig.type = SDW_STREAM_PDM;
  1400	
  1401		/**
> 1402		 * Port map index starts with 0, however the data port for this codec
  1403		 * are from index 1
  1404		 */
  1405		if (of_property_read_u32_array(dev->of_node, "qcom,port-mapping", &pdev->m_port_map[1],
  1406						WSA883X_MAX_SWR_PORTS))
  1407			dev_dbg(dev, "Static Port mapping not specified\n");
  1408	
  1409		pdev->prop.sink_ports = GENMASK(WSA883X_MAX_SWR_PORTS, 0);
  1410		pdev->prop.simple_clk_stop_capable = true;
  1411		pdev->prop.sink_dpn_prop = wsa_sink_dpn_prop;
  1412		pdev->prop.scp_int1_mask = SDW_SCP_INT1_BUS_CLASH | SDW_SCP_INT1_PARITY;
  1413		gpiod_direction_output(wsa883x->sd_n, 0);
  1414	
  1415		wsa883x->regmap = devm_regmap_init_sdw(pdev, &wsa883x_regmap_config);
  1416		if (IS_ERR(wsa883x->regmap)) {
  1417			gpiod_direction_output(wsa883x->sd_n, 1);
  1418			ret = dev_err_probe(dev, PTR_ERR(wsa883x->regmap),
  1419					    "regmap_init failed\n");
  1420			goto err;
  1421		}
  1422		pm_runtime_set_autosuspend_delay(dev, 3000);
  1423		pm_runtime_use_autosuspend(dev);
  1424		pm_runtime_mark_last_busy(dev);
  1425		pm_runtime_set_active(dev);
  1426		pm_runtime_enable(dev);
  1427	
  1428		ret = devm_snd_soc_register_component(dev,
  1429						      &wsa883x_component_drv,
  1430						       wsa883x_dais,
  1431						       ARRAY_SIZE(wsa883x_dais));
  1432	err:
  1433		if (ret)
  1434			regulator_disable(wsa883x->vdd);
  1435	
  1436		return ret;
  1437	

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