> -----邮件原件-----
> 发件人: U-Boot <[email protected]> 代表 Marek Vasut
> 发送时间: 2025年10月28日 21:59
> 收件人: [email protected]
> 抄送: Marek Vasut <[email protected]>; Alice Guo
> <[email protected]>; Patrice Chotard <[email protected]>; Peng
> Fan <[email protected]>; Tom Rini <[email protected]>; Valentin Caron
> <[email protected]>; Ye Li <[email protected]>
> 主题: [PATCH v2] firmware: scmi: Fix up code comments
> 
> Fix multiple instances of copy-paste errors. Fill in missing headers for
> CLOCK_GET_PERMISSIONS message and response.
> 
> Signed-off-by: Marek Vasut <[email protected]>
> ---
> Cc: Alice Guo <[email protected]>
> Cc: Patrice Chotard <[email protected]>
> Cc: Peng Fan <[email protected]>
> Cc: Tom Rini <[email protected]>
> Cc: Valentin Caron <[email protected]>
> Cc: Ye Li <[email protected]>
> Cc: [email protected]
> ---
> V2: Fix scmi_base_protocol_attrs, scmi_base_protocol_message_attrs,
>     struct scmi_clk_attribute_out, struct scmi_clk_attribute_out_v2,
>     struct scmi_pinctrl_config_set_in
> ---
>  include/scmi_protocols.h | 20 +++++++++++---------
>  1 file changed, 11 insertions(+), 9 deletions(-)
> 
> diff --git a/include/scmi_protocols.h b/include/scmi_protocols.h index
> bb74a57f79a..bcd8e671149 100644
> --- a/include/scmi_protocols.h
> +++ b/include/scmi_protocols.h
> @@ -399,7 +399,7 @@ int scmi_generic_protocol_version(struct udevice *dev,
> int scmi_base_protocol_version(struct udevice *dev, u32 *version);
> 
>  /**
> - * scmi_protocol_attrs - get protocol attributes
> + * scmi_base_protocol_attrs - get protocol attributes
>   * @dev:             SCMI protocol device
>   * @num_agents:              Number of SCMI agents
>   * @num_protocols:   Number of SCMI protocols
> @@ -414,7 +414,7 @@ int scmi_base_protocol_attrs(struct udevice *dev, u32
> *num_agents,
>                            u32 *num_protocols);
> 
>  /**
> - * scmi_protocol_message_attrs - get message-specific attributes
> + * scmi_base_protocol_message_attrs - get message-specific attributes
>   * @dev:             SCMI protocol device
>   * @message_id:              SCMI message ID
>   * @attributes:              Message-specific attributes
> @@ -754,7 +754,7 @@ enum scmi_clock_message_id {  #define
> SCMI_CLOCK_NAME_LENGTH_MAX 16
> 
>  /**
> - * struct scmi_clk_get_nb_out - Response for SCMI_PROTOCOL_ATTRIBUTES
> command
> + * struct scmi_clk_protocol_attr_out - Response for
> + SCMI_PROTOCOL_ATTRIBUTES command
>   * @status:  SCMI command status
>   * @attributes:      Attributes of the clock protocol, mainly number of 
> clocks
> exposed
>   */
> @@ -772,7 +772,7 @@ struct scmi_clk_attribute_in {  };
> 
>  /**
> - * struct scmi_clk_get_nb_out - Response payload for
> SCMI_CLOCK_ATTRIBUTES command
> + * struct scmi_clk_attribute_out - Response payload for
> + SCMI_CLOCK_ATTRIBUTES command
>   * @status:  SCMI command status
>   * @attributes:      clock attributes
>   * @clock_name:      name of the clock
> @@ -785,7 +785,7 @@ struct scmi_clk_attribute_out {  };
> 
>  /**
> - * struct scmi_clk_get_nb_out_v2 - Response payload for
> SCMI_CLOCK_ATTRIBUTES command
> + * struct scmi_clk_attribute_out_v2 - Response payload for
> + SCMI_CLOCK_ATTRIBUTES command
>   * Clock management Protocol 2.0
>   * @status:  SCMI command status
>   * @attributes:      clock attributes
> @@ -818,7 +818,7 @@ struct scmi_clk_state_out {  };
> 
>  /**
> - * struct scmi_clk_state_in - Message payload for CLOCK_RATE_GET command
> + * struct scmi_clk_rate_get_in - Message payload for CLOCK_RATE_GET
> + command
>   * @clock_id:        SCMI clock ID
>   * @attributes:      Attributes of the targets clock state
>   */
> @@ -839,7 +839,7 @@ struct scmi_clk_rate_get_out {  };
> 
>  /**
> - * struct scmi_clk_state_in - Message payload for CLOCK_RATE_SET command
> + * struct scmi_clk_rate_set_in - Message payload for CLOCK_RATE_SET
> + command
>   * @flags:   Flags for the clock rate set request
>   * @clock_id:        SCMI clock ID
>   * @rate_lsb:        32bit LSB of the clock rate in Hertz
> @@ -861,7 +861,7 @@ struct scmi_clk_rate_set_out {  };
> 
>  /**
> - * struct scmi_clk_parent_state_in - Message payload for CLOCK_PARENT_SET
> command
> + * struct scmi_clk_parent_set_in - Message payload for CLOCK_PARENT_SET
> + command
>   * @clock_id:                SCMI clock ID
>   * @parent_clk:              SCMI clock ID
>   */
> @@ -879,6 +879,7 @@ struct scmi_clk_parent_set_out {  };
> 
>  /**
> + * struct scmi_clk_get_permissions_in - Message payload for
> + CLOCK_GET_PERMISSIONS command
>   * @clock_id:        Identifier for the clock device.
>   */
>  struct scmi_clk_get_permissions_in {
> @@ -886,6 +887,7 @@ struct scmi_clk_get_permissions_in {  };
> 
>  /**
> + * struct scmi_clk_get_permissions_out - Response payload for
> + CLOCK_GET_PERMISSIONS command
>   * @status:  Negative 32-bit integers are used to return error status codes.
>   * @permissions:     Bit[31] Clock state control, Bit[30] Clock parent 
> control,
>   * Bit[29] Clock rate control, Bits[28:0] Reserved, must be zero.
> @@ -1082,7 +1084,7 @@ struct scmi_pin_config {  };
> 
>  /**
> - * struct scmi_pad_config_set_in - Message payload for PAD_CONFIG_SET
> command
> + * struct scmi_pinctrl_config_set_in - Message payload for
> + PAD_CONFIG_SET command
>   * @identifier:              Identifier for the pin or group.
>   * @function_id:     Identifier for the function selected to be enabled
>   *                   for the selected pin or group. This field is set to
> --
> 2.51.0

Reviewed-by: Alice Guo <[email protected]>

Reply via email to