Re: [PATCH v4 12/17] iio: cros_ec: Move function description to .c file

[Enric Balletbo i Serra]

On 10/11/19 14:08, Jonathan Cameron wrote:
> On Tue,  5 Nov 2019 14:26:47 -0800
> Gwendal Grignou <gwendal@xxxxxxxxxxxx> wrote:
> 
>> To prevent comment rot, move function description to
>> cros_ec_sensors_core.c.
>>
>> Signed-off-by: Gwendal Grignou <gwendal@xxxxxxxxxxxx>
> Thanks for tidying this up.
> 
> Acked-by: Jonathan Cameron <Jonathan.Cameron@xxxxxxxxxx>
> 

Acked-by: Enric Balletbo i Serra <enric.balletbo@xxxxxxxxxxxxx>

Thanks,
 Enric

>> ---
>> No changes in v4.
>> Changes in v3:
>>   fix spelling.
>> New in v2.
>>
>>  .../cros_ec_sensors/cros_ec_sensors_core.c    | 69 ++++++++++++++++
>>  .../linux/iio/common/cros_ec_sensors_core.h   | 80 -------------------
>>  2 files changed, 69 insertions(+), 80 deletions(-)
>>
>> diff --git a/drivers/iio/common/cros_ec_sensors/cros_ec_sensors_core.c b/drivers/iio/common/cros_ec_sensors/cros_ec_sensors_core.c
>> index 81a7f692de2f..b47da497a3c3 100644
>> --- a/drivers/iio/common/cros_ec_sensors/cros_ec_sensors_core.c
>> +++ b/drivers/iio/common/cros_ec_sensors/cros_ec_sensors_core.c
>> @@ -83,6 +83,14 @@ static void get_default_min_max_freq(enum motionsensor_type type,
>>  	}
>>  }
>>  
>> +/**
>> + * cros_ec_sensors_core_init() - basic initialization of the core structure
>> + * @pdev:		platform device created for the sensors
>> + * @indio_dev:		iio device structure of the device
>> + * @physical_device:	true if the device refers to a physical device
>> + *
>> + * Return: 0 on success, -errno on failure.
>> + */
>>  int cros_ec_sensors_core_init(struct platform_device *pdev,
>>  			      struct iio_dev *indio_dev,
>>  			      bool physical_device)
>> @@ -160,6 +168,16 @@ int cros_ec_sensors_core_init(struct platform_device *pdev,
>>  }
>>  EXPORT_SYMBOL_GPL(cros_ec_sensors_core_init);
>>  
>> +/**
>> + * cros_ec_motion_send_host_cmd() - send motion sense host command
>> + * @state:		pointer to state information for device
>> + * @opt_length:	optional length to reduce the response size, useful on the data
>> + *		path. Otherwise, the maximal allowed response size is used
>> + *
>> + * When called, the sub-command is assumed to be set in param->cmd.
>> + *
>> + * Return: 0 on success, -errno on failure.
>> + */
>>  int cros_ec_motion_send_host_cmd(struct cros_ec_sensors_core_state *state,
>>  				 u16 opt_length)
>>  {
>> @@ -422,6 +440,14 @@ int cros_ec_sensors_read_lpc(struct iio_dev *indio_dev,
>>  }
>>  EXPORT_SYMBOL_GPL(cros_ec_sensors_read_lpc);
>>  
>> +/**
>> + * cros_ec_sensors_read_cmd() - retrieve data using the EC command protocol
>> + * @indio_dev:	pointer to IIO device
>> + * @scan_mask:	bitmap of the sensor indices to scan
>> + * @data:	location to store data
>> + *
>> + * Return: 0 on success, -errno on failure.
>> + */
>>  int cros_ec_sensors_read_cmd(struct iio_dev *indio_dev,
>>  			     unsigned long scan_mask, s16 *data)
>>  {
>> @@ -446,6 +472,18 @@ int cros_ec_sensors_read_cmd(struct iio_dev *indio_dev,
>>  }
>>  EXPORT_SYMBOL_GPL(cros_ec_sensors_read_cmd);
>>  
>> +/**
>> + * cros_ec_sensors_capture() - the trigger handler function
>> + * @irq:	the interrupt number.
>> + * @p:		a pointer to the poll function.
>> + *
>> + * On a trigger event occurring, if the pollfunc is attached then this
>> + * handler is called as a threaded interrupt (and hence may sleep). It
>> + * is responsible for grabbing data from the device and pushing it into
>> + * the associated buffer.
>> + *
>> + * Return: IRQ_HANDLED
>> + */
>>  irqreturn_t cros_ec_sensors_capture(int irq, void *p)
>>  {
>>  	struct iio_poll_func *pf = p;
>> @@ -481,6 +519,16 @@ irqreturn_t cros_ec_sensors_capture(int irq, void *p)
>>  }
>>  EXPORT_SYMBOL_GPL(cros_ec_sensors_capture);
>>  
>> +/**
>> + * cros_ec_sensors_core_read() - function to request a value from the sensor
>> + * @st:		pointer to state information for device
>> + * @chan:	channel specification structure table
>> + * @val:	will contain one element making up the returned value
>> + * @val2:	will contain another element making up the returned value
>> + * @mask:	specifies which values to be requested
>> + *
>> + * Return:	the type of value returned by the device
>> + */
>>  int cros_ec_sensors_core_read(struct cros_ec_sensors_core_state *st,
>>  			  struct iio_chan_spec const *chan,
>>  			  int *val, int *val2, long mask)
>> @@ -521,6 +569,17 @@ int cros_ec_sensors_core_read(struct cros_ec_sensors_core_state *st,
>>  }
>>  EXPORT_SYMBOL_GPL(cros_ec_sensors_core_read);
>>  
>> +/**
>> + * cros_ec_sensors_core_read_avail() - get available values
>> + * @indio_dev:		pointer to state information for device
>> + * @chan:	channel specification structure table
>> + * @vals:	list of available values
>> + * @type:	type of data returned
>> + * @length:	number of data returned in the array
>> + * @mask:	specifies which values to be requested
>> + *
>> + * Return:	an error code, IIO_AVAIL_RANGE or IIO_AVAIL_LIST
>> + */
>>  int cros_ec_sensors_core_read_avail(struct iio_dev *indio_dev,
>>  				    struct iio_chan_spec const *chan,
>>  				    const int **vals,
>> @@ -542,6 +601,16 @@ int cros_ec_sensors_core_read_avail(struct iio_dev *indio_dev,
>>  }
>>  EXPORT_SYMBOL_GPL(cros_ec_sensors_core_read_avail);
>>  
>> +/**
>> + * cros_ec_sensors_core_write() - function to write a value to the sensor
>> + * @st:		pointer to state information for device
>> + * @chan:	channel specification structure table
>> + * @val:	first part of value to write
>> + * @val2:	second part of value to write
>> + * @mask:	specifies which values to write
>> + *
>> + * Return:	the type of value returned by the device
>> + */
>>  int cros_ec_sensors_core_write(struct cros_ec_sensors_core_state *st,
>>  			       struct iio_chan_spec const *chan,
>>  			       int val, int val2, long mask)
>> diff --git a/include/linux/iio/common/cros_ec_sensors_core.h b/include/linux/iio/common/cros_ec_sensors_core.h
>> index bb331e6356a9..0af918978f97 100644
>> --- a/include/linux/iio/common/cros_ec_sensors_core.h
>> +++ b/include/linux/iio/common/cros_ec_sensors_core.h
>> @@ -79,95 +79,25 @@ struct cros_ec_sensors_core_state {
>>  	int frequencies[3];
>>  };
>>  
>> -/**
>> - * cros_ec_sensors_read_lpc() - retrieve data from EC shared memory
>> - * @indio_dev:	pointer to IIO device
>> - * @scan_mask:	bitmap of the sensor indices to scan
>> - * @data:	location to store data
>> - *
>> - * This is the safe function for reading the EC data. It guarantees that the
>> - * data sampled was not modified by the EC while being read.
>> - *
>> - * Return: 0 on success, -errno on failure.
>> - */
>>  int cros_ec_sensors_read_lpc(struct iio_dev *indio_dev, unsigned long scan_mask,
>>  			     s16 *data);
>>  
>> -/**
>> - * cros_ec_sensors_read_cmd() - retrieve data using the EC command protocol
>> - * @indio_dev:	pointer to IIO device
>> - * @scan_mask:	bitmap of the sensor indices to scan
>> - * @data:	location to store data
>> - *
>> - * Return: 0 on success, -errno on failure.
>> - */
>>  int cros_ec_sensors_read_cmd(struct iio_dev *indio_dev, unsigned long scan_mask,
>>  			     s16 *data);
>>  
>>  struct platform_device;
>> -/**
>> - * cros_ec_sensors_core_init() - basic initialization of the core structure
>> - * @pdev:		platform device created for the sensors
>> - * @indio_dev:		iio device structure of the device
>> - * @physical_device:	true if the device refers to a physical device
>> - *
>> - * Return: 0 on success, -errno on failure.
>> - */
>>  int cros_ec_sensors_core_init(struct platform_device *pdev,
>>  			      struct iio_dev *indio_dev, bool physical_device);
>>  
>> -/**
>> - * cros_ec_sensors_capture() - the trigger handler function
>> - * @irq:	the interrupt number.
>> - * @p:		a pointer to the poll function.
>> - *
>> - * On a trigger event occurring, if the pollfunc is attached then this
>> - * handler is called as a threaded interrupt (and hence may sleep). It
>> - * is responsible for grabbing data from the device and pushing it into
>> - * the associated buffer.
>> - *
>> - * Return: IRQ_HANDLED
>> - */
>>  irqreturn_t cros_ec_sensors_capture(int irq, void *p);
>>  
>> -/**
>> - * cros_ec_motion_send_host_cmd() - send motion sense host command
>> - * @st:		pointer to state information for device
>> - * @opt_length:	optional length to reduce the response size, useful on the data
>> - *		path. Otherwise, the maximal allowed response size is used
>> - *
>> - * When called, the sub-command is assumed to be set in param->cmd.
>> - *
>> - * Return: 0 on success, -errno on failure.
>> - */
>>  int cros_ec_motion_send_host_cmd(struct cros_ec_sensors_core_state *st,
>>  				 u16 opt_length);
>>  
>> -/**
>> - * cros_ec_sensors_core_read() - function to request a value from the sensor
>> - * @st:		pointer to state information for device
>> - * @chan:	channel specification structure table
>> - * @val:	will contain one element making up the returned value
>> - * @val2:	will contain another element making up the returned value
>> - * @mask:	specifies which values to be requested
>> - *
>> - * Return:	the type of value returned by the device
>> - */
>>  int cros_ec_sensors_core_read(struct cros_ec_sensors_core_state *st,
>>  			      struct iio_chan_spec const *chan,
>>  			      int *val, int *val2, long mask);
>>  
>> -/**
>> - * cros_ec_sensors_core_read_avail() - get available values
>> - * @indio_dev:		pointer to state information for device
>> - * @chan:	channel specification structure table
>> - * @vals:	list of available values
>> - * @type:	type of data returned
>> - * @length:	number of data returned in the array
>> - * @mask:	specifies which values to be requested
>> - *
>> - * Return:	an error code, IIO_AVAIL_RANGE or IIO_AVAIL_LIST
>> - */
>>  int cros_ec_sensors_core_read_avail(struct iio_dev *indio_dev,
>>  				    struct iio_chan_spec const *chan,
>>  				    const int **vals,
>> @@ -175,16 +105,6 @@ int cros_ec_sensors_core_read_avail(struct iio_dev *indio_dev,
>>  				    int *length,
>>  				    long mask);
>>  
>> -/**
>> - * cros_ec_sensors_core_write() - function to write a value to the sensor
>> - * @st:		pointer to state information for device
>> - * @chan:	channel specification structure table
>> - * @val:	first part of value to write
>> - * @val2:	second part of value to write
>> - * @mask:	specifies which values to write
>> - *
>> - * Return:	the type of value returned by the device
>> - */
>>  int cros_ec_sensors_core_write(struct cros_ec_sensors_core_state *st,
>>  			       struct iio_chan_spec const *chan,
>>  			       int val, int val2, long mask);
>