* [PATCH] firmware: arm_scpi: Fix kernel doc warnings
@ 2021-07-12 13:08 Sudeep Holla
2021-07-12 13:08 ` [PATCH] firmware: arm_scmi: " Sudeep Holla
0 siblings, 1 reply; 4+ messages in thread
From: Sudeep Holla @ 2021-07-12 13:08 UTC (permalink / raw)
To: linux-arm-kernel; +Cc: Sudeep Holla, Cristian Marussi
Kernel doc validation script is unhappy and complains with the below set
of warnings.
| Function parameter or member 'device_domain_id' not described in 'scpi_ops'
| Function parameter or member 'get_transition_latency' not described in 'scpi_ops'
| Function parameter or member 'add_opps_to_device' not described in 'scpi_ops'
| Function parameter or member 'sensor_get_capability' not described in 'scpi_ops'
| Function parameter or member 'sensor_get_info' not described in 'scpi_ops'
| Function parameter or member 'sensor_get_value' not described in 'scpi_ops'
| Function parameter or member 'device_get_power_state' not described in 'scpi_ops'
| Function parameter or member 'device_set_power_state' not described in 'scpi_ops'
Fix them adding appropriate documents or missing keywords.
Signed-off-by: Sudeep Holla <sudeep.holla@arm.com>
---
include/linux/scpi_protocol.h | 8 ++++++++
1 file changed, 8 insertions(+)
diff --git a/include/linux/scpi_protocol.h b/include/linux/scpi_protocol.h
index afbf8037d8db..d2176a56828a 100644
--- a/include/linux/scpi_protocol.h
+++ b/include/linux/scpi_protocol.h
@@ -51,6 +51,14 @@ struct scpi_sensor_info {
* OPP is an index to the list return by @dvfs_get_info
* @dvfs_get_info: returns the DVFS capabilities of the given power
* domain. It includes the OPP list and the latency information
+ * @device_domain_id: gets the scpi domain id for a given device
+ * @get_transition_latency: gets the DVFS transition latency for a given device
+ * @add_opps_to_device: adds all the OPPs for a given device
+ * @sensor_get_capability: get the list of capabilities for the sensors
+ * @sensor_get_info: get the information of the specified sensor
+ * @sensor_get_value: gets the current value of the sensor
+ * @device_get_power_state: gets the power state of a power domain
+ * @device_set_power_state: sets the power state of a power domain
*/
struct scpi_ops {
u32 (*get_version)(void);
--
2.25.1
_______________________________________________
linux-arm-kernel mailing list
linux-arm-kernel@lists.infradead.org
http://lists.infradead.org/mailman/listinfo/linux-arm-kernel
^ permalink raw reply related [flat|nested] 4+ messages in thread
* [PATCH] firmware: arm_scmi: Fix kernel doc warnings
2021-07-12 13:08 [PATCH] firmware: arm_scpi: Fix kernel doc warnings Sudeep Holla
@ 2021-07-12 13:08 ` Sudeep Holla
2021-07-12 14:32 ` Cristian Marussi
2021-07-14 16:39 ` Sudeep Holla
0 siblings, 2 replies; 4+ messages in thread
From: Sudeep Holla @ 2021-07-12 13:08 UTC (permalink / raw)
To: linux-arm-kernel; +Cc: Sudeep Holla, Cristian Marussi
Kernel doc validation script is unhappy and complains with the below set
of warnings.
| Function parameter or member 'fast_switch_possible' not described in 'scmi_perf_proto_ops'
| Function parameter or member 'power_scale_mw_get' not described in 'scmi_perf_proto_ops'
| cannot understand function prototype: 'struct scmi_sensor_reading '
| cannot understand function prototype: 'struct scmi_range_attrs '
| cannot understand function prototype: 'struct scmi_sensor_axis_info '
| cannot understand function prototype: 'struct scmi_sensor_intervals_info '
Fix them adding appropriate documents or missing keywords.
Signed-off-by: Sudeep Holla <sudeep.holla@arm.com>
---
include/linux/scmi_protocol.h | 14 +++++++++-----
1 file changed, 9 insertions(+), 5 deletions(-)
diff --git a/include/linux/scmi_protocol.h b/include/linux/scmi_protocol.h
index 79d0a1237e6c..80e781c51ddc 100644
--- a/include/linux/scmi_protocol.h
+++ b/include/linux/scmi_protocol.h
@@ -101,6 +101,10 @@ struct scmi_clk_proto_ops {
* to sustained performance level mapping
* @est_power_get: gets the estimated power cost for a given performance domain
* at a given frequency
+ * @fast_switch_possible: indicates if fast DVFS switching is possible or not
+ * for a given device
+ * @power_scale_mw_get: indicates if the power values provided are in milliWatts
+ * or in some other (abstract) scale
*/
struct scmi_perf_proto_ops {
int (*limits_set)(const struct scmi_protocol_handle *ph, u32 domain,
@@ -153,7 +157,7 @@ struct scmi_power_proto_ops {
};
/**
- * scmi_sensor_reading - represent a timestamped read
+ * struct scmi_sensor_reading - represent a timestamped read
*
* Used by @reading_get_timestamped method.
*
@@ -167,7 +171,7 @@ struct scmi_sensor_reading {
};
/**
- * scmi_range_attrs - specifies a sensor or axis values' range
+ * struct scmi_range_attrs - specifies a sensor or axis values' range
* @min_range: The minimum value which can be represented by the sensor/axis.
* @max_range: The maximum value which can be represented by the sensor/axis.
*/
@@ -177,7 +181,7 @@ struct scmi_range_attrs {
};
/**
- * scmi_sensor_axis_info - describes one sensor axes
+ * struct scmi_sensor_axis_info - describes one sensor axes
* @id: The axes ID.
* @type: Axes type. Chosen amongst one of @enum scmi_sensor_class.
* @scale: Power-of-10 multiplier applied to the axis unit.
@@ -205,8 +209,8 @@ struct scmi_sensor_axis_info {
};
/**
- * scmi_sensor_intervals_info - describes number and type of available update
- * intervals
+ * struct scmi_sensor_intervals_info - describes number and type of available
+ * update intervals
* @segmented: Flag for segmented intervals' representation. When True there
* will be exactly 3 intervals in @desc, with each entry
* representing a member of a segment in this order:
--
2.25.1
_______________________________________________
linux-arm-kernel mailing list
linux-arm-kernel@lists.infradead.org
http://lists.infradead.org/mailman/listinfo/linux-arm-kernel
^ permalink raw reply related [flat|nested] 4+ messages in thread
* Re: [PATCH] firmware: arm_scmi: Fix kernel doc warnings
2021-07-12 13:08 ` [PATCH] firmware: arm_scmi: " Sudeep Holla
@ 2021-07-12 14:32 ` Cristian Marussi
2021-07-14 16:39 ` Sudeep Holla
1 sibling, 0 replies; 4+ messages in thread
From: Cristian Marussi @ 2021-07-12 14:32 UTC (permalink / raw)
To: Sudeep Holla; +Cc: linux-arm-kernel
On Mon, Jul 12, 2021 at 02:08:01PM +0100, Sudeep Holla wrote:
> Kernel doc validation script is unhappy and complains with the below set
> of warnings.
>
> | Function parameter or member 'fast_switch_possible' not described in 'scmi_perf_proto_ops'
> | Function parameter or member 'power_scale_mw_get' not described in 'scmi_perf_proto_ops'
> | cannot understand function prototype: 'struct scmi_sensor_reading '
> | cannot understand function prototype: 'struct scmi_range_attrs '
> | cannot understand function prototype: 'struct scmi_sensor_axis_info '
> | cannot understand function prototype: 'struct scmi_sensor_intervals_info '
>
> Fix them adding appropriate documents or missing keywords.
>
Hi,
LGTM.
I've found a few more kernel-doc warning in SCMI stack.
I'll send those in a separate patch if you'd wanna put all together.
FWIW, Reviewed-by: Cristian Marussi <cristian.marussi@arm.com>
Thanks,
Cristian
_______________________________________________
linux-arm-kernel mailing list
linux-arm-kernel@lists.infradead.org
http://lists.infradead.org/mailman/listinfo/linux-arm-kernel
^ permalink raw reply [flat|nested] 4+ messages in thread
* Re: [PATCH] firmware: arm_scmi: Fix kernel doc warnings
2021-07-12 13:08 ` [PATCH] firmware: arm_scmi: " Sudeep Holla
2021-07-12 14:32 ` Cristian Marussi
@ 2021-07-14 16:39 ` Sudeep Holla
1 sibling, 0 replies; 4+ messages in thread
From: Sudeep Holla @ 2021-07-14 16:39 UTC (permalink / raw)
To: Sudeep Holla, linux-arm-kernel; +Cc: Cristian Marussi
On Mon, 12 Jul 2021 14:08:01 +0100, Sudeep Holla wrote:
> Kernel doc validation script is unhappy and complains with the below set
> of warnings.
>
> | Function parameter or member 'fast_switch_possible' not described in 'scmi_perf_proto_ops'
> | Function parameter or member 'power_scale_mw_get' not described in 'scmi_perf_proto_ops'
> | cannot understand function prototype: 'struct scmi_sensor_reading '
> | cannot understand function prototype: 'struct scmi_range_attrs '
> | cannot understand function prototype: 'struct scmi_sensor_axis_info '
> | cannot understand function prototype: 'struct scmi_sensor_intervals_info '
>
> [...]
Applied to sudeep.holla/linux (for-next/scmi), thanks!
[1/1] firmware: arm_scmi: Fix kernel doc warnings
https://git.kernel.org/sudeep.holla/c/52f83955aa
--
Regards,
Sudeep
_______________________________________________
linux-arm-kernel mailing list
linux-arm-kernel@lists.infradead.org
http://lists.infradead.org/mailman/listinfo/linux-arm-kernel
^ permalink raw reply [flat|nested] 4+ messages in thread
end of thread, other threads:[~2021-07-14 16:41 UTC | newest]
Thread overview: 4+ messages (download: mbox.gz / follow: Atom feed)
-- links below jump to the message on this page --
2021-07-12 13:08 [PATCH] firmware: arm_scpi: Fix kernel doc warnings Sudeep Holla
2021-07-12 13:08 ` [PATCH] firmware: arm_scmi: " Sudeep Holla
2021-07-12 14:32 ` Cristian Marussi
2021-07-14 16:39 ` Sudeep Holla
This is an external index of several public inboxes,
see mirroring instructions on how to clone and mirror
all data and code used by this external index.