dos2unix conversion
Signed-off-by: Patrick Williams <patrick@stwcx.xyz>
Change-Id: I78a4c2f28285ea30d66895b352402bfd12f95c00
diff --git a/libpldm/firmware_update.c b/libpldm/firmware_update.c
index fd66549..1aa0ed1 100644
--- a/libpldm/firmware_update.c
+++ b/libpldm/firmware_update.c
@@ -1,1565 +1,1565 @@
-#include "firmware_update.h"
-#include <endian.h>
-#include <string.h>
-
-/** @brief Check whether string type value is valid
- *
- * @return true if string type value is valid, false if not
- */
-static bool is_string_type_valid(uint8_t string_type)
-{
- switch (string_type) {
- case PLDM_STR_TYPE_UNKNOWN:
- return false;
- case PLDM_STR_TYPE_ASCII:
- case PLDM_STR_TYPE_UTF_8:
- case PLDM_STR_TYPE_UTF_16:
- case PLDM_STR_TYPE_UTF_16LE:
- case PLDM_STR_TYPE_UTF_16BE:
- return true;
- default:
- return false;
- }
-}
-
-/** @brief Return the length of the descriptor type described in firmware update
- * specification
- *
- * @return length of the descriptor type if descriptor type is valid else
- * return 0
- */
-static uint16_t get_descriptor_type_length(uint16_t descriptor_type)
-{
- switch (descriptor_type) {
-
- case PLDM_FWUP_PCI_VENDOR_ID:
- return PLDM_FWUP_PCI_VENDOR_ID_LENGTH;
- case PLDM_FWUP_IANA_ENTERPRISE_ID:
- return PLDM_FWUP_IANA_ENTERPRISE_ID_LENGTH;
- case PLDM_FWUP_UUID:
- return PLDM_FWUP_UUID_LENGTH;
- case PLDM_FWUP_PNP_VENDOR_ID:
- return PLDM_FWUP_PNP_VENDOR_ID_LENGTH;
- case PLDM_FWUP_ACPI_VENDOR_ID:
- return PLDM_FWUP_ACPI_VENDOR_ID_LENGTH;
- case PLDM_FWUP_IEEE_ASSIGNED_COMPANY_ID:
- return PLDM_FWUP_IEEE_ASSIGNED_COMPANY_ID_LENGTH;
- case PLDM_FWUP_SCSI_VENDOR_ID:
- return PLDM_FWUP_SCSI_VENDOR_ID_LENGTH;
- case PLDM_FWUP_PCI_DEVICE_ID:
- return PLDM_FWUP_PCI_DEVICE_ID_LENGTH;
- case PLDM_FWUP_PCI_SUBSYSTEM_VENDOR_ID:
- return PLDM_FWUP_PCI_SUBSYSTEM_VENDOR_ID_LENGTH;
- case PLDM_FWUP_PCI_SUBSYSTEM_ID:
- return PLDM_FWUP_PCI_SUBSYSTEM_ID_LENGTH;
- case PLDM_FWUP_PCI_REVISION_ID:
- return PLDM_FWUP_PCI_REVISION_ID_LENGTH;
- case PLDM_FWUP_PNP_PRODUCT_IDENTIFIER:
- return PLDM_FWUP_PNP_PRODUCT_IDENTIFIER_LENGTH;
- case PLDM_FWUP_ACPI_PRODUCT_IDENTIFIER:
- return PLDM_FWUP_ACPI_PRODUCT_IDENTIFIER_LENGTH;
- case PLDM_FWUP_ASCII_MODEL_NUMBER_LONG_STRING:
- return PLDM_FWUP_ASCII_MODEL_NUMBER_LONG_STRING_LENGTH;
- case PLDM_FWUP_ASCII_MODEL_NUMBER_SHORT_STRING:
- return PLDM_FWUP_ASCII_MODEL_NUMBER_SHORT_STRING_LENGTH;
- case PLDM_FWUP_SCSI_PRODUCT_ID:
- return PLDM_FWUP_SCSI_PRODUCT_ID_LENGTH;
- case PLDM_FWUP_UBM_CONTROLLER_DEVICE_CODE:
- return PLDM_FWUP_UBM_CONTROLLER_DEVICE_CODE_LENGTH;
- default:
- return 0;
- }
-}
-
-/** @brief Check whether ComponentResponse is valid
- *
- * @return true if ComponentResponse is valid, false if not
- */
-static bool is_comp_resp_valid(uint8_t comp_resp)
-{
- switch (comp_resp) {
- case PLDM_CR_COMP_CAN_BE_UPDATED:
- case PLDM_CR_COMP_MAY_BE_UPDATEABLE:
- return true;
-
- default:
- return false;
- }
-}
-
-/** @brief Check whether ComponentResponseCode is valid
- *
- * @return true if ComponentResponseCode is valid, false if not
- */
-static bool is_comp_resp_code_valid(uint8_t comp_resp_code)
-{
- switch (comp_resp_code) {
- case PLDM_CRC_COMP_CAN_BE_UPDATED:
- case PLDM_CRC_COMP_COMPARISON_STAMP_IDENTICAL:
- case PLDM_CRC_COMP_COMPARISON_STAMP_LOWER:
- case PLDM_CRC_INVALID_COMP_COMPARISON_STAMP:
- case PLDM_CRC_COMP_CONFLICT:
- case PLDM_CRC_COMP_PREREQUISITES_NOT_MET:
- case PLDM_CRC_COMP_NOT_SUPPORTED:
- case PLDM_CRC_COMP_SECURITY_RESTRICTIONS:
- case PLDM_CRC_INCOMPLETE_COMP_IMAGE_SET:
- case PLDM_CRC_ACTIVE_IMAGE_NOT_UPDATEABLE_SUBSEQUENTLY:
- case PLDM_CRC_COMP_VER_STR_IDENTICAL:
- case PLDM_CRC_COMP_VER_STR_LOWER:
- return true;
-
- default:
- if (comp_resp_code >=
- PLDM_CRC_VENDOR_COMP_RESP_CODE_RANGE_MIN &&
- comp_resp_code <=
- PLDM_CRC_VENDOR_COMP_RESP_CODE_RANGE_MAX) {
- return true;
- }
- return false;
- }
-}
-
-/** @brief Check whether ComponentCompatibilityResponse is valid
- *
- * @return true if ComponentCompatibilityResponse is valid, false if not
- */
-static bool is_comp_compatibility_resp_valid(uint8_t comp_compatibility_resp)
-{
- switch (comp_compatibility_resp) {
- case PLDM_CCR_COMP_CAN_BE_UPDATED:
- case PLDM_CCR_COMP_CANNOT_BE_UPDATED:
- return true;
-
- default:
- return false;
- }
-}
-
-/** @brief Check whether ComponentCompatibilityResponse Code is valid
- *
- * @return true if ComponentCompatibilityResponse Code is valid, false if not
- */
-static bool
-is_comp_compatibility_resp_code_valid(uint8_t comp_compatibility_resp_code)
-{
- switch (comp_compatibility_resp_code) {
- case PLDM_CCRC_NO_RESPONSE_CODE:
- case PLDM_CCRC_COMP_COMPARISON_STAMP_IDENTICAL:
- case PLDM_CCRC_COMP_COMPARISON_STAMP_LOWER:
- case PLDM_CCRC_INVALID_COMP_COMPARISON_STAMP:
- case PLDM_CCRC_COMP_CONFLICT:
- case PLDM_CCRC_COMP_PREREQUISITES_NOT_MET:
- case PLDM_CCRC_COMP_NOT_SUPPORTED:
- case PLDM_CCRC_COMP_SECURITY_RESTRICTIONS:
- case PLDM_CRC_INCOMPLETE_COMP_IMAGE_SET:
- case PLDM_CCRC_COMP_INFO_NO_MATCH:
- case PLDM_CCRC_COMP_VER_STR_IDENTICAL:
- case PLDM_CCRC_COMP_VER_STR_LOWER:
- return true;
-
- default:
- if (comp_compatibility_resp_code >=
- PLDM_CCRC_VENDOR_COMP_RESP_CODE_RANGE_MIN &&
- comp_compatibility_resp_code <=
- PLDM_CCRC_VENDOR_COMP_RESP_CODE_RANGE_MAX) {
- return true;
- }
- return false;
- }
-}
-
-/** @brief Check whether SelfContainedActivationRequest is valid
- *
- * @return true if SelfContainedActivationRequest is valid, false if not
- */
-static bool
-is_self_contained_activation_req_valid(bool8_t self_contained_activation_req)
-{
- switch (self_contained_activation_req) {
- case PLDM_NOT_ACTIVATE_SELF_CONTAINED_COMPONENTS:
- case PLDM_ACTIVATE_SELF_CONTAINED_COMPONENTS:
- return true;
-
- default:
- return false;
- }
-}
-
-/** @brief Check if current or previous status in GetStatus command response is
- * valid
- *
- * @param[in] state - current or previous different state machine state of
- * the FD
- * @return true if state is valid, false if not
- */
-static bool is_state_valid(uint8_t state)
-{
- switch (state) {
- case PLDM_FD_STATE_IDLE:
- case PLDM_FD_STATE_LEARN_COMPONENTS:
- case PLDM_FD_STATE_READY_XFER:
- case PLDM_FD_STATE_DOWNLOAD:
- case PLDM_FD_STATE_VERIFY:
- case PLDM_FD_STATE_APPLY:
- case PLDM_FD_STATE_ACTIVATE:
- return true;
-
- default:
- return false;
- }
-}
-
-/** @brief Check if aux state in GetStatus command response is valid
- *
- * @param[in] aux_state - provides additional information to the UA to describe
- * the current operation state of the FD/FDP
- *
- * @return true if aux state is valid, false if not
- */
-static bool is_aux_state_valid(uint8_t aux_state)
-{
- switch (aux_state) {
- case PLDM_FD_OPERATION_IN_PROGRESS:
- case PLDM_FD_OPERATION_SUCCESSFUL:
- case PLDM_FD_OPERATION_FAILED:
- case PLDM_FD_IDLE_LEARN_COMPONENTS_READ_XFER:
- return true;
-
- default:
- return false;
- }
-}
-
-/** @brief Check if aux state status in GetStatus command response is valid
- *
- * @param[in] aux_state_status - aux state status
- *
- * @return true if aux state status is valid, false if not
- */
-static bool is_aux_state_status_valid(uint8_t aux_state_status)
-{
- if (aux_state_status == PLDM_FD_AUX_STATE_IN_PROGRESS_OR_SUCCESS ||
- aux_state_status == PLDM_FD_TIMEOUT ||
- aux_state_status == PLDM_FD_GENERIC_ERROR) {
- return true;
- } else if (aux_state_status >=
- PLDM_FD_VENDOR_DEFINED_STATUS_CODE_START &&
- aux_state_status <= PLDM_FD_VENDOR_DEFINED_STATUS_CODE_END) {
- return true;
- }
-
- return false;
-}
-
-/** @brief Check if reason code in GetStatus command response is valid
- *
- * @param[in] reason_code - provides the reason for why the current state
- * entered the IDLE state
- *
- * @return true if reason code is valid, false if not
- */
-static bool is_reason_code_valid(uint8_t reason_code)
-{
-
- switch (reason_code) {
- case PLDM_FD_INITIALIZATION:
- case PLDM_FD_ACTIVATE_FW:
- case PLDM_FD_CANCEL_UPDATE:
- case PLDM_FD_TIMEOUT_LEARN_COMPONENT:
- case PLDM_FD_TIMEOUT_READY_XFER:
- case PLDM_FD_TIMEOUT_DOWNLOAD:
- case PLDM_FD_TIMEOUT_VERIFY:
- case PLDM_FD_TIMEOUT_APPLY:
- return true;
-
- default:
- if (reason_code >= PLDM_FD_STATUS_VENDOR_DEFINED_MIN) {
- return true;
- }
- return false;
- }
-}
-
-/** @brief Check if non functioning component indication in CancelUpdate
- * response is valid
- *
- * @return true if non functioning component indication is valid, false if not
- */
-static bool is_non_functioning_component_indication_valid(
- bool8_t non_functioning_component_indication)
-{
- switch (non_functioning_component_indication) {
- case PLDM_FWUP_COMPONENTS_FUNCTIONING:
- case PLDM_FWUP_COMPONENTS_NOT_FUNCTIONING:
- return true;
-
- default:
- return false;
- }
-}
-
-int decode_pldm_package_header_info(
- const uint8_t *data, size_t length,
- struct pldm_package_header_information *package_header_info,
- struct variable_field *package_version_str)
-{
- if (data == NULL || package_header_info == NULL ||
- package_version_str == NULL) {
- return PLDM_ERROR_INVALID_DATA;
- }
-
- if (length < sizeof(struct pldm_package_header_information)) {
- return PLDM_ERROR_INVALID_LENGTH;
- }
-
- struct pldm_package_header_information *data_header =
- (struct pldm_package_header_information *)(data);
-
- if (!is_string_type_valid(data_header->package_version_string_type) ||
- (data_header->package_version_string_length == 0)) {
- return PLDM_ERROR_INVALID_DATA;
- }
-
- if (length < sizeof(struct pldm_package_header_information) +
- data_header->package_version_string_length) {
- return PLDM_ERROR_INVALID_LENGTH;
- }
-
- if ((data_header->component_bitmap_bit_length %
- PLDM_FWUP_COMPONENT_BITMAP_MULTIPLE) != 0) {
- return PLDM_ERROR_INVALID_DATA;
- }
-
- memcpy(package_header_info->uuid, data_header->uuid,
- sizeof(data_header->uuid));
- package_header_info->package_header_format_version =
- data_header->package_header_format_version;
- package_header_info->package_header_size =
- le16toh(data_header->package_header_size);
- memcpy(package_header_info->timestamp104, data_header->timestamp104,
- sizeof(data_header->timestamp104));
- package_header_info->component_bitmap_bit_length =
- le16toh(data_header->component_bitmap_bit_length);
- package_header_info->package_version_string_type =
- data_header->package_version_string_type;
- package_header_info->package_version_string_length =
- data_header->package_version_string_length;
- package_version_str->ptr =
- data + sizeof(struct pldm_package_header_information);
- package_version_str->length =
- package_header_info->package_version_string_length;
-
- return PLDM_SUCCESS;
-}
-
-int decode_firmware_device_id_record(
- const uint8_t *data, size_t length, uint16_t component_bitmap_bit_length,
- struct pldm_firmware_device_id_record *fw_device_id_record,
- struct variable_field *applicable_components,
- struct variable_field *comp_image_set_version_str,
- struct variable_field *record_descriptors,
- struct variable_field *fw_device_pkg_data)
-{
- if (data == NULL || fw_device_id_record == NULL ||
- applicable_components == NULL ||
- comp_image_set_version_str == NULL || record_descriptors == NULL ||
- fw_device_pkg_data == NULL) {
- return PLDM_ERROR_INVALID_DATA;
- }
-
- if (length < sizeof(struct pldm_firmware_device_id_record)) {
- return PLDM_ERROR_INVALID_LENGTH;
- }
-
- if ((component_bitmap_bit_length %
- PLDM_FWUP_COMPONENT_BITMAP_MULTIPLE) != 0) {
- return PLDM_ERROR_INVALID_DATA;
- }
-
- struct pldm_firmware_device_id_record *data_record =
- (struct pldm_firmware_device_id_record *)(data);
-
- if (!is_string_type_valid(
- data_record->comp_image_set_version_string_type) ||
- (data_record->comp_image_set_version_string_length == 0)) {
- return PLDM_ERROR_INVALID_DATA;
- }
-
- fw_device_id_record->record_length =
- le16toh(data_record->record_length);
- fw_device_id_record->descriptor_count = data_record->descriptor_count;
- fw_device_id_record->device_update_option_flags.value =
- le32toh(data_record->device_update_option_flags.value);
- fw_device_id_record->comp_image_set_version_string_type =
- data_record->comp_image_set_version_string_type;
- fw_device_id_record->comp_image_set_version_string_length =
- data_record->comp_image_set_version_string_length;
- fw_device_id_record->fw_device_pkg_data_length =
- le16toh(data_record->fw_device_pkg_data_length);
-
- if (length < fw_device_id_record->record_length) {
- return PLDM_ERROR_INVALID_LENGTH;
- }
-
- uint16_t applicable_components_length =
- component_bitmap_bit_length / PLDM_FWUP_COMPONENT_BITMAP_MULTIPLE;
- uint16_t calc_min_record_length =
- sizeof(struct pldm_firmware_device_id_record) +
- applicable_components_length +
- data_record->comp_image_set_version_string_length +
- PLDM_FWUP_DEVICE_DESCRIPTOR_MIN_LEN +
- fw_device_id_record->fw_device_pkg_data_length;
-
- if (fw_device_id_record->record_length < calc_min_record_length) {
- return PLDM_ERROR_INVALID_LENGTH;
- }
-
- applicable_components->ptr =
- data + sizeof(struct pldm_firmware_device_id_record);
- applicable_components->length = applicable_components_length;
-
- comp_image_set_version_str->ptr =
- applicable_components->ptr + applicable_components->length;
- comp_image_set_version_str->length =
- fw_device_id_record->comp_image_set_version_string_length;
-
- record_descriptors->ptr = comp_image_set_version_str->ptr +
- comp_image_set_version_str->length;
- record_descriptors->length =
- fw_device_id_record->record_length -
- sizeof(struct pldm_firmware_device_id_record) -
- applicable_components_length -
- fw_device_id_record->comp_image_set_version_string_length -
- fw_device_id_record->fw_device_pkg_data_length;
-
- if (fw_device_id_record->fw_device_pkg_data_length) {
- fw_device_pkg_data->ptr =
- record_descriptors->ptr + record_descriptors->length;
- fw_device_pkg_data->length =
- fw_device_id_record->fw_device_pkg_data_length;
- }
-
- return PLDM_SUCCESS;
-}
-
-int decode_descriptor_type_length_value(const uint8_t *data, size_t length,
- uint16_t *descriptor_type,
- struct variable_field *descriptor_data)
-{
- uint16_t descriptor_length = 0;
-
- if (data == NULL || descriptor_type == NULL ||
- descriptor_data == NULL) {
- return PLDM_ERROR_INVALID_DATA;
- }
-
- if (length < PLDM_FWUP_DEVICE_DESCRIPTOR_MIN_LEN) {
- return PLDM_ERROR_INVALID_LENGTH;
- }
-
- struct pldm_descriptor_tlv *entry =
- (struct pldm_descriptor_tlv *)(data);
-
- *descriptor_type = le16toh(entry->descriptor_type);
- descriptor_length = le16toh(entry->descriptor_length);
- if (*descriptor_type != PLDM_FWUP_VENDOR_DEFINED) {
- if (descriptor_length !=
- get_descriptor_type_length(*descriptor_type)) {
- return PLDM_ERROR_INVALID_LENGTH;
- }
- }
-
- if (length < (sizeof(*descriptor_type) + sizeof(descriptor_length) +
- descriptor_length)) {
- return PLDM_ERROR_INVALID_LENGTH;
- }
-
- descriptor_data->ptr = entry->descriptor_data;
- descriptor_data->length = descriptor_length;
-
- return PLDM_SUCCESS;
-}
-
-int decode_vendor_defined_descriptor_value(
- const uint8_t *data, size_t length, uint8_t *descriptor_title_str_type,
- struct variable_field *descriptor_title_str,
- struct variable_field *descriptor_data)
-{
- if (data == NULL || descriptor_title_str_type == NULL ||
- descriptor_title_str == NULL || descriptor_data == NULL) {
- return PLDM_ERROR_INVALID_DATA;
- }
-
- if (length < sizeof(struct pldm_vendor_defined_descriptor_title_data)) {
- return PLDM_ERROR_INVALID_LENGTH;
- }
-
- struct pldm_vendor_defined_descriptor_title_data *entry =
- (struct pldm_vendor_defined_descriptor_title_data *)(data);
- if (!is_string_type_valid(
- entry->vendor_defined_descriptor_title_str_type) ||
- (entry->vendor_defined_descriptor_title_str_len == 0)) {
- return PLDM_ERROR_INVALID_DATA;
- }
-
- // Assuming atleast 1 byte of VendorDefinedDescriptorData
- if (length < (sizeof(struct pldm_vendor_defined_descriptor_title_data) +
- entry->vendor_defined_descriptor_title_str_len)) {
- return PLDM_ERROR_INVALID_LENGTH;
- }
-
- *descriptor_title_str_type =
- entry->vendor_defined_descriptor_title_str_type;
- descriptor_title_str->ptr = entry->vendor_defined_descriptor_title_str;
- descriptor_title_str->length =
- entry->vendor_defined_descriptor_title_str_len;
-
- descriptor_data->ptr =
- descriptor_title_str->ptr + descriptor_title_str->length;
- descriptor_data->length =
- length - sizeof(entry->vendor_defined_descriptor_title_str_type) -
- sizeof(entry->vendor_defined_descriptor_title_str_len) -
- descriptor_title_str->length;
-
- return PLDM_SUCCESS;
-}
-
-int decode_pldm_comp_image_info(
- const uint8_t *data, size_t length,
- struct pldm_component_image_information *pldm_comp_image_info,
- struct variable_field *comp_version_str)
-{
- if (data == NULL || pldm_comp_image_info == NULL ||
- comp_version_str == NULL) {
- return PLDM_ERROR_INVALID_DATA;
- }
-
- if (length < sizeof(struct pldm_component_image_information)) {
- return PLDM_ERROR_INVALID_LENGTH;
- }
-
- struct pldm_component_image_information *data_header =
- (struct pldm_component_image_information *)(data);
-
- if (!is_string_type_valid(data_header->comp_version_string_type) ||
- (data_header->comp_version_string_length == 0)) {
- return PLDM_ERROR_INVALID_DATA;
- }
-
- if (length < sizeof(struct pldm_component_image_information) +
- data_header->comp_version_string_length) {
- return PLDM_ERROR_INVALID_LENGTH;
- }
-
- pldm_comp_image_info->comp_classification =
- le16toh(data_header->comp_classification);
- pldm_comp_image_info->comp_identifier =
- le16toh(data_header->comp_identifier);
- pldm_comp_image_info->comp_comparison_stamp =
- le32toh(data_header->comp_comparison_stamp);
- pldm_comp_image_info->comp_options.value =
- le16toh(data_header->comp_options.value);
- pldm_comp_image_info->requested_comp_activation_method.value =
- le16toh(data_header->requested_comp_activation_method.value);
- pldm_comp_image_info->comp_location_offset =
- le32toh(data_header->comp_location_offset);
- pldm_comp_image_info->comp_size = le32toh(data_header->comp_size);
- pldm_comp_image_info->comp_version_string_type =
- data_header->comp_version_string_type;
- pldm_comp_image_info->comp_version_string_length =
- data_header->comp_version_string_length;
-
- if ((pldm_comp_image_info->comp_options.bits.bit1 == false &&
- pldm_comp_image_info->comp_comparison_stamp !=
- PLDM_FWUP_INVALID_COMPONENT_COMPARISON_TIMESTAMP)) {
- return PLDM_ERROR_INVALID_DATA;
- }
-
- if (pldm_comp_image_info->comp_location_offset == 0 ||
- pldm_comp_image_info->comp_size == 0) {
- return PLDM_ERROR_INVALID_DATA;
- }
-
- comp_version_str->ptr =
- data + sizeof(struct pldm_component_image_information);
- comp_version_str->length =
- pldm_comp_image_info->comp_version_string_length;
-
- return PLDM_SUCCESS;
-}
-
-int encode_query_device_identifiers_req(uint8_t instance_id,
- size_t payload_length,
- struct pldm_msg *msg)
-{
- if (msg == NULL) {
- return PLDM_ERROR_INVALID_DATA;
- }
-
- if (payload_length != PLDM_QUERY_DEVICE_IDENTIFIERS_REQ_BYTES) {
- return PLDM_ERROR_INVALID_LENGTH;
- }
-
- return encode_pldm_header_only(PLDM_REQUEST, instance_id, PLDM_FWUP,
- PLDM_QUERY_DEVICE_IDENTIFIERS, msg);
-}
-
-int decode_query_device_identifiers_resp(const struct pldm_msg *msg,
- size_t payload_length,
- uint8_t *completion_code,
- uint32_t *device_identifiers_len,
- uint8_t *descriptor_count,
- uint8_t **descriptor_data)
-{
- if (msg == NULL || completion_code == NULL ||
- device_identifiers_len == NULL || descriptor_count == NULL ||
- descriptor_data == NULL) {
- return PLDM_ERROR_INVALID_DATA;
- }
-
- *completion_code = msg->payload[0];
- if (PLDM_SUCCESS != *completion_code) {
- return PLDM_SUCCESS;
- }
-
- if (payload_length <
- sizeof(struct pldm_query_device_identifiers_resp)) {
- return PLDM_ERROR_INVALID_LENGTH;
- }
-
- struct pldm_query_device_identifiers_resp *response =
- (struct pldm_query_device_identifiers_resp *)msg->payload;
- *device_identifiers_len = le32toh(response->device_identifiers_len);
-
- if (*device_identifiers_len < PLDM_FWUP_DEVICE_DESCRIPTOR_MIN_LEN) {
- return PLDM_ERROR_INVALID_LENGTH;
- }
-
- if (payload_length !=
- sizeof(struct pldm_query_device_identifiers_resp) +
- *device_identifiers_len) {
- return PLDM_ERROR_INVALID_LENGTH;
- }
- *descriptor_count = response->descriptor_count;
-
- if (*descriptor_count == 0) {
- return PLDM_ERROR_INVALID_DATA;
- }
- *descriptor_data =
- (uint8_t *)(msg->payload +
- sizeof(struct pldm_query_device_identifiers_resp));
- return PLDM_SUCCESS;
-}
-
-int encode_get_firmware_parameters_req(uint8_t instance_id,
- size_t payload_length,
- struct pldm_msg *msg)
-{
- if (msg == NULL) {
- return PLDM_ERROR_INVALID_DATA;
- }
-
- if (payload_length != PLDM_GET_FIRMWARE_PARAMETERS_REQ_BYTES) {
- return PLDM_ERROR_INVALID_LENGTH;
- }
-
- return encode_pldm_header_only(PLDM_REQUEST, instance_id, PLDM_FWUP,
- PLDM_GET_FIRMWARE_PARAMETERS, msg);
-}
-
-int decode_get_firmware_parameters_resp(
- const struct pldm_msg *msg, size_t payload_length,
- struct pldm_get_firmware_parameters_resp *resp_data,
- struct variable_field *active_comp_image_set_ver_str,
- struct variable_field *pending_comp_image_set_ver_str,
- struct variable_field *comp_parameter_table)
-{
- if (msg == NULL || resp_data == NULL ||
- active_comp_image_set_ver_str == NULL ||
- pending_comp_image_set_ver_str == NULL ||
- comp_parameter_table == NULL || !payload_length) {
- return PLDM_ERROR_INVALID_DATA;
- }
-
- resp_data->completion_code = msg->payload[0];
- if (PLDM_SUCCESS != resp_data->completion_code) {
- return PLDM_SUCCESS;
- }
-
- if (payload_length < sizeof(struct pldm_get_firmware_parameters_resp)) {
- return PLDM_ERROR_INVALID_LENGTH;
- }
-
- struct pldm_get_firmware_parameters_resp *response =
- (struct pldm_get_firmware_parameters_resp *)msg->payload;
-
- if (!is_string_type_valid(
- response->active_comp_image_set_ver_str_type) ||
- (response->active_comp_image_set_ver_str_len == 0)) {
- return PLDM_ERROR_INVALID_DATA;
- }
-
- if (response->pending_comp_image_set_ver_str_len == 0) {
- if (response->pending_comp_image_set_ver_str_type !=
- PLDM_STR_TYPE_UNKNOWN) {
- return PLDM_ERROR_INVALID_DATA;
- }
- } else {
- if (!is_string_type_valid(
- response->pending_comp_image_set_ver_str_type)) {
- return PLDM_ERROR_INVALID_DATA;
- }
- }
-
- size_t partial_response_length =
- sizeof(struct pldm_get_firmware_parameters_resp) +
- response->active_comp_image_set_ver_str_len +
- response->pending_comp_image_set_ver_str_len;
-
- if (payload_length < partial_response_length) {
- return PLDM_ERROR_INVALID_LENGTH;
- }
-
- resp_data->capabilities_during_update.value =
- le32toh(response->capabilities_during_update.value);
- resp_data->comp_count = le16toh(response->comp_count);
- resp_data->active_comp_image_set_ver_str_type =
- response->active_comp_image_set_ver_str_type;
- resp_data->active_comp_image_set_ver_str_len =
- response->active_comp_image_set_ver_str_len;
- resp_data->pending_comp_image_set_ver_str_type =
- response->pending_comp_image_set_ver_str_type;
- resp_data->pending_comp_image_set_ver_str_len =
- response->pending_comp_image_set_ver_str_len;
-
- active_comp_image_set_ver_str->ptr =
- msg->payload + sizeof(struct pldm_get_firmware_parameters_resp);
- active_comp_image_set_ver_str->length =
- resp_data->active_comp_image_set_ver_str_len;
-
- if (resp_data->pending_comp_image_set_ver_str_len != 0) {
- pending_comp_image_set_ver_str->ptr =
- msg->payload +
- sizeof(struct pldm_get_firmware_parameters_resp) +
- resp_data->active_comp_image_set_ver_str_len;
- pending_comp_image_set_ver_str->length =
- resp_data->pending_comp_image_set_ver_str_len;
- } else {
- pending_comp_image_set_ver_str->ptr = NULL;
- pending_comp_image_set_ver_str->length = 0;
- }
-
- if (payload_length > partial_response_length && resp_data->comp_count) {
- comp_parameter_table->ptr =
- msg->payload +
- sizeof(struct pldm_get_firmware_parameters_resp) +
- resp_data->active_comp_image_set_ver_str_len +
- resp_data->pending_comp_image_set_ver_str_len;
- comp_parameter_table->length =
- payload_length - partial_response_length;
- } else {
- comp_parameter_table->ptr = NULL;
- comp_parameter_table->length = 0;
- }
-
- return PLDM_SUCCESS;
-}
-
-int decode_get_firmware_parameters_resp_comp_entry(
- const uint8_t *data, size_t length,
- struct pldm_component_parameter_entry *component_data,
- struct variable_field *active_comp_ver_str,
- struct variable_field *pending_comp_ver_str)
-{
- if (data == NULL || component_data == NULL ||
- active_comp_ver_str == NULL || pending_comp_ver_str == NULL) {
- return PLDM_ERROR_INVALID_DATA;
- }
-
- if (length < sizeof(struct pldm_component_parameter_entry)) {
- return PLDM_ERROR_INVALID_LENGTH;
- }
-
- struct pldm_component_parameter_entry *entry =
- (struct pldm_component_parameter_entry *)(data);
- if (entry->active_comp_ver_str_len == 0) {
- return PLDM_ERROR_INVALID_LENGTH;
- }
-
- size_t entry_length = sizeof(struct pldm_component_parameter_entry) +
- entry->active_comp_ver_str_len +
- entry->pending_comp_ver_str_len;
-
- if (length < entry_length) {
- return PLDM_ERROR_INVALID_LENGTH;
- }
-
- component_data->comp_classification =
- le16toh(entry->comp_classification);
- component_data->comp_identifier = le16toh(entry->comp_identifier);
- component_data->comp_classification_index =
- entry->comp_classification_index;
- component_data->active_comp_comparison_stamp =
- le32toh(entry->active_comp_comparison_stamp);
- component_data->active_comp_ver_str_type =
- entry->active_comp_ver_str_type;
- component_data->active_comp_ver_str_len =
- entry->active_comp_ver_str_len;
- memcpy(component_data->active_comp_release_date,
- entry->active_comp_release_date,
- sizeof(entry->active_comp_release_date));
- component_data->pending_comp_comparison_stamp =
- le32toh(entry->pending_comp_comparison_stamp);
- component_data->pending_comp_ver_str_type =
- entry->pending_comp_ver_str_type;
- component_data->pending_comp_ver_str_len =
- entry->pending_comp_ver_str_len;
- memcpy(component_data->pending_comp_release_date,
- entry->pending_comp_release_date,
- sizeof(entry->pending_comp_release_date));
- component_data->comp_activation_methods.value =
- le16toh(entry->comp_activation_methods.value);
- component_data->capabilities_during_update.value =
- le32toh(entry->capabilities_during_update.value);
-
- active_comp_ver_str->ptr =
- data + sizeof(struct pldm_component_parameter_entry);
- active_comp_ver_str->length = entry->active_comp_ver_str_len;
-
- if (entry->pending_comp_ver_str_len != 0) {
-
- pending_comp_ver_str->ptr =
- data + sizeof(struct pldm_component_parameter_entry) +
- entry->active_comp_ver_str_len;
- pending_comp_ver_str->length = entry->pending_comp_ver_str_len;
- } else {
- pending_comp_ver_str->ptr = NULL;
- pending_comp_ver_str->length = 0;
- }
- return PLDM_SUCCESS;
-}
-
-int encode_request_update_req(uint8_t instance_id, uint32_t max_transfer_size,
- uint16_t num_of_comp,
- uint8_t max_outstanding_transfer_req,
- uint16_t pkg_data_len,
- uint8_t comp_image_set_ver_str_type,
- uint8_t comp_image_set_ver_str_len,
- const struct variable_field *comp_img_set_ver_str,
- struct pldm_msg *msg, size_t payload_length)
-{
- if (comp_img_set_ver_str == NULL || comp_img_set_ver_str->ptr == NULL ||
- msg == NULL) {
- return PLDM_ERROR_INVALID_DATA;
- }
-
- if (payload_length != sizeof(struct pldm_request_update_req) +
- comp_img_set_ver_str->length) {
- return PLDM_ERROR_INVALID_LENGTH;
- }
-
- if ((comp_image_set_ver_str_len == 0) ||
- (comp_image_set_ver_str_len != comp_img_set_ver_str->length)) {
- return PLDM_ERROR_INVALID_DATA;
- }
-
- if ((max_transfer_size < PLDM_FWUP_BASELINE_TRANSFER_SIZE) ||
- (max_outstanding_transfer_req < PLDM_FWUP_MIN_OUTSTANDING_REQ)) {
- return PLDM_ERROR_INVALID_DATA;
- }
-
- if (!is_string_type_valid(comp_image_set_ver_str_type)) {
- return PLDM_ERROR_INVALID_DATA;
- }
-
- struct pldm_header_info header = {0};
- header.instance = instance_id;
- header.msg_type = PLDM_REQUEST;
- header.pldm_type = PLDM_FWUP;
- header.command = PLDM_REQUEST_UPDATE;
- uint8_t rc = pack_pldm_header(&header, &(msg->hdr));
- if (rc) {
- return rc;
- }
-
- struct pldm_request_update_req *request =
- (struct pldm_request_update_req *)msg->payload;
-
- request->max_transfer_size = htole32(max_transfer_size);
- request->num_of_comp = htole16(num_of_comp);
- request->max_outstanding_transfer_req = max_outstanding_transfer_req;
- request->pkg_data_len = htole16(pkg_data_len);
- request->comp_image_set_ver_str_type = comp_image_set_ver_str_type;
- request->comp_image_set_ver_str_len = comp_image_set_ver_str_len;
-
- memcpy(msg->payload + sizeof(struct pldm_request_update_req),
- comp_img_set_ver_str->ptr, comp_img_set_ver_str->length);
-
- return PLDM_SUCCESS;
-}
-
-int decode_request_update_resp(const struct pldm_msg *msg,
- size_t payload_length, uint8_t *completion_code,
- uint16_t *fd_meta_data_len,
- uint8_t *fd_will_send_pkg_data)
-{
- if (msg == NULL || completion_code == NULL ||
- fd_meta_data_len == NULL || fd_will_send_pkg_data == NULL ||
- !payload_length) {
- return PLDM_ERROR_INVALID_DATA;
- }
-
- *completion_code = msg->payload[0];
- if (*completion_code != PLDM_SUCCESS) {
- return PLDM_SUCCESS;
- }
-
- if (payload_length != sizeof(struct pldm_request_update_resp)) {
- return PLDM_ERROR_INVALID_LENGTH;
- }
-
- struct pldm_request_update_resp *response =
- (struct pldm_request_update_resp *)msg->payload;
-
- *fd_meta_data_len = le16toh(response->fd_meta_data_len);
- *fd_will_send_pkg_data = response->fd_will_send_pkg_data;
-
- return PLDM_SUCCESS;
-}
-
-int encode_pass_component_table_req(
- uint8_t instance_id, uint8_t transfer_flag, uint16_t comp_classification,
- uint16_t comp_identifier, uint8_t comp_classification_index,
- uint32_t comp_comparison_stamp, uint8_t comp_ver_str_type,
- uint8_t comp_ver_str_len, const struct variable_field *comp_ver_str,
- struct pldm_msg *msg, size_t payload_length)
-{
- if (comp_ver_str == NULL || comp_ver_str->ptr == NULL || msg == NULL) {
- return PLDM_ERROR_INVALID_DATA;
- }
-
- if (payload_length != sizeof(struct pldm_pass_component_table_req) +
- comp_ver_str->length) {
- return PLDM_ERROR_INVALID_LENGTH;
- }
-
- if ((comp_ver_str_len == 0) ||
- (comp_ver_str_len != comp_ver_str->length)) {
- return PLDM_ERROR_INVALID_DATA;
- }
-
- if (!is_transfer_flag_valid(transfer_flag)) {
- return PLDM_INVALID_TRANSFER_OPERATION_FLAG;
- }
-
- if (!is_string_type_valid(comp_ver_str_type)) {
- return PLDM_ERROR_INVALID_DATA;
- }
-
- struct pldm_header_info header = {0};
- header.instance = instance_id;
- header.msg_type = PLDM_REQUEST;
- header.pldm_type = PLDM_FWUP;
- header.command = PLDM_PASS_COMPONENT_TABLE;
- uint8_t rc = pack_pldm_header(&header, &(msg->hdr));
- if (rc) {
- return rc;
- }
-
- struct pldm_pass_component_table_req *request =
- (struct pldm_pass_component_table_req *)msg->payload;
-
- request->transfer_flag = transfer_flag;
- request->comp_classification = htole16(comp_classification);
- request->comp_identifier = htole16(comp_identifier);
- request->comp_classification_index = comp_classification_index;
- request->comp_comparison_stamp = htole32(comp_comparison_stamp);
- request->comp_ver_str_type = comp_ver_str_type;
- request->comp_ver_str_len = comp_ver_str_len;
-
- memcpy(msg->payload + sizeof(struct pldm_pass_component_table_req),
- comp_ver_str->ptr, comp_ver_str->length);
-
- return PLDM_SUCCESS;
-}
-
-int decode_pass_component_table_resp(const struct pldm_msg *msg,
- const size_t payload_length,
- uint8_t *completion_code,
- uint8_t *comp_resp,
- uint8_t *comp_resp_code)
-{
- if (msg == NULL || completion_code == NULL || comp_resp == NULL ||
- comp_resp_code == NULL || !payload_length) {
- return PLDM_ERROR_INVALID_DATA;
- }
-
- *completion_code = msg->payload[0];
- if (*completion_code != PLDM_SUCCESS) {
- return PLDM_SUCCESS;
- }
-
- if (payload_length != sizeof(struct pldm_pass_component_table_resp)) {
- return PLDM_ERROR_INVALID_LENGTH;
- }
-
- struct pldm_pass_component_table_resp *response =
- (struct pldm_pass_component_table_resp *)msg->payload;
-
- if (!is_comp_resp_valid(response->comp_resp)) {
- return PLDM_ERROR_INVALID_DATA;
- }
-
- if (!is_comp_resp_code_valid(response->comp_resp_code)) {
- return PLDM_ERROR_INVALID_DATA;
- }
-
- *comp_resp = response->comp_resp;
- *comp_resp_code = response->comp_resp_code;
-
- return PLDM_SUCCESS;
-}
-
-int encode_update_component_req(
- uint8_t instance_id, uint16_t comp_classification, uint16_t comp_identifier,
- uint8_t comp_classification_index, uint32_t comp_comparison_stamp,
- uint32_t comp_image_size, bitfield32_t update_option_flags,
- uint8_t comp_ver_str_type, uint8_t comp_ver_str_len,
- const struct variable_field *comp_ver_str, struct pldm_msg *msg,
- size_t payload_length)
-{
- if (comp_ver_str == NULL || comp_ver_str->ptr == NULL || msg == NULL) {
- return PLDM_ERROR_INVALID_DATA;
- }
-
- if (payload_length !=
- sizeof(struct pldm_update_component_req) + comp_ver_str->length) {
- return PLDM_ERROR_INVALID_LENGTH;
- }
-
- if (!comp_image_size) {
- return PLDM_ERROR_INVALID_DATA;
- }
-
- if ((comp_ver_str_len == 0) ||
- (comp_ver_str_len != comp_ver_str->length)) {
- return PLDM_ERROR_INVALID_DATA;
- }
-
- if (!is_string_type_valid(comp_ver_str_type)) {
- return PLDM_ERROR_INVALID_DATA;
- }
-
- struct pldm_header_info header = {0};
- header.instance = instance_id;
- header.msg_type = PLDM_REQUEST;
- header.pldm_type = PLDM_FWUP;
- header.command = PLDM_UPDATE_COMPONENT;
- uint8_t rc = pack_pldm_header(&header, &(msg->hdr));
- if (rc) {
- return rc;
- }
-
- struct pldm_update_component_req *request =
- (struct pldm_update_component_req *)msg->payload;
-
- request->comp_classification = htole16(comp_classification);
- request->comp_identifier = htole16(comp_identifier);
- request->comp_classification_index = comp_classification_index;
- request->comp_comparison_stamp = htole32(comp_comparison_stamp);
- request->comp_image_size = htole32(comp_image_size);
- request->update_option_flags.value = htole32(update_option_flags.value);
- request->comp_ver_str_type = comp_ver_str_type;
- request->comp_ver_str_len = comp_ver_str_len;
-
- memcpy(msg->payload + sizeof(struct pldm_update_component_req),
- comp_ver_str->ptr, comp_ver_str->length);
-
- return PLDM_SUCCESS;
-}
-
-int decode_update_component_resp(const struct pldm_msg *msg,
- size_t payload_length,
- uint8_t *completion_code,
- uint8_t *comp_compatability_resp,
- uint8_t *comp_compatability_resp_code,
- bitfield32_t *update_option_flags_enabled,
- uint16_t *time_before_req_fw_data)
-{
- if (msg == NULL || completion_code == NULL ||
- comp_compatability_resp == NULL ||
- comp_compatability_resp_code == NULL ||
- update_option_flags_enabled == NULL ||
- time_before_req_fw_data == NULL || !payload_length) {
- return PLDM_ERROR_INVALID_DATA;
- }
-
- *completion_code = msg->payload[0];
- if (*completion_code != PLDM_SUCCESS) {
- return PLDM_SUCCESS;
- }
-
- if (payload_length != sizeof(struct pldm_update_component_resp)) {
- return PLDM_ERROR_INVALID_LENGTH;
- }
-
- struct pldm_update_component_resp *response =
- (struct pldm_update_component_resp *)msg->payload;
-
- if (!is_comp_compatibility_resp_valid(
- response->comp_compatability_resp)) {
- return PLDM_ERROR_INVALID_DATA;
- }
-
- if (!is_comp_compatibility_resp_code_valid(
- response->comp_compatability_resp_code)) {
- return PLDM_ERROR_INVALID_DATA;
- }
-
- *comp_compatability_resp = response->comp_compatability_resp;
- *comp_compatability_resp_code = response->comp_compatability_resp_code;
- update_option_flags_enabled->value =
- le32toh(response->update_option_flags_enabled.value);
- *time_before_req_fw_data = le16toh(response->time_before_req_fw_data);
-
- return PLDM_SUCCESS;
-}
-
-int decode_request_firmware_data_req(const struct pldm_msg *msg,
- size_t payload_length, uint32_t *offset,
- uint32_t *length)
-{
- if (msg == NULL || offset == NULL || length == NULL) {
- return PLDM_ERROR_INVALID_DATA;
- }
- if (payload_length != sizeof(struct pldm_request_firmware_data_req)) {
- return PLDM_ERROR_INVALID_LENGTH;
- }
- struct pldm_request_firmware_data_req *request =
- (struct pldm_request_firmware_data_req *)msg->payload;
- *offset = le32toh(request->offset);
- *length = le32toh(request->length);
-
- if (*length < PLDM_FWUP_BASELINE_TRANSFER_SIZE) {
- return PLDM_FWUP_INVALID_TRANSFER_LENGTH;
- }
-
- return PLDM_SUCCESS;
-}
-
-int encode_request_firmware_data_resp(uint8_t instance_id,
- uint8_t completion_code,
- struct pldm_msg *msg,
- size_t payload_length)
-{
- if (msg == NULL || !payload_length) {
- return PLDM_ERROR_INVALID_DATA;
- }
-
- struct pldm_header_info header = {0};
- header.instance = instance_id;
- header.msg_type = PLDM_RESPONSE;
- header.pldm_type = PLDM_FWUP;
- header.command = PLDM_REQUEST_FIRMWARE_DATA;
- uint8_t rc = pack_pldm_header(&header, &(msg->hdr));
- if (rc) {
- return rc;
- }
-
- msg->payload[0] = completion_code;
-
- return PLDM_SUCCESS;
-}
-
-int decode_transfer_complete_req(const struct pldm_msg *msg,
- size_t payload_length,
- uint8_t *transfer_result)
-{
- if (msg == NULL || transfer_result == NULL) {
- return PLDM_ERROR_INVALID_DATA;
- }
-
- if (payload_length != sizeof(*transfer_result)) {
- return PLDM_ERROR_INVALID_LENGTH;
- }
-
- *transfer_result = msg->payload[0];
- return PLDM_SUCCESS;
-}
-
-int encode_transfer_complete_resp(uint8_t instance_id, uint8_t completion_code,
- struct pldm_msg *msg, size_t payload_length)
-{
- if (msg == NULL) {
- return PLDM_ERROR_INVALID_DATA;
- }
-
- if (payload_length != sizeof(completion_code)) {
- return PLDM_ERROR_INVALID_LENGTH;
- }
-
- struct pldm_header_info header = {0};
- header.instance = instance_id;
- header.msg_type = PLDM_RESPONSE;
- header.pldm_type = PLDM_FWUP;
- header.command = PLDM_TRANSFER_COMPLETE;
- uint8_t rc = pack_pldm_header(&header, &(msg->hdr));
- if (rc) {
- return rc;
- }
-
- msg->payload[0] = completion_code;
-
- return PLDM_SUCCESS;
-}
-
-int decode_verify_complete_req(const struct pldm_msg *msg,
- size_t payload_length, uint8_t *verify_result)
-{
- if (msg == NULL || verify_result == NULL) {
- return PLDM_ERROR_INVALID_DATA;
- }
-
- if (payload_length != sizeof(*verify_result)) {
- return PLDM_ERROR_INVALID_LENGTH;
- }
-
- *verify_result = msg->payload[0];
- return PLDM_SUCCESS;
-}
-
-int encode_verify_complete_resp(uint8_t instance_id, uint8_t completion_code,
- struct pldm_msg *msg, size_t payload_length)
-{
- if (msg == NULL) {
- return PLDM_ERROR_INVALID_DATA;
- }
-
- if (payload_length != sizeof(completion_code)) {
- return PLDM_ERROR_INVALID_LENGTH;
- }
-
- struct pldm_header_info header = {0};
- header.instance = instance_id;
- header.msg_type = PLDM_RESPONSE;
- header.pldm_type = PLDM_FWUP;
- header.command = PLDM_VERIFY_COMPLETE;
- uint8_t rc = pack_pldm_header(&header, &(msg->hdr));
- if (rc) {
- return rc;
- }
-
- msg->payload[0] = completion_code;
-
- return PLDM_SUCCESS;
-}
-
-int decode_apply_complete_req(
- const struct pldm_msg *msg, size_t payload_length, uint8_t *apply_result,
- bitfield16_t *comp_activation_methods_modification)
-{
- if (msg == NULL || apply_result == NULL ||
- comp_activation_methods_modification == NULL) {
- return PLDM_ERROR_INVALID_DATA;
- }
-
- if (payload_length != sizeof(struct pldm_apply_complete_req)) {
- return PLDM_ERROR_INVALID_LENGTH;
- }
-
- struct pldm_apply_complete_req *request =
- (struct pldm_apply_complete_req *)msg->payload;
-
- *apply_result = request->apply_result;
- comp_activation_methods_modification->value =
- le16toh(request->comp_activation_methods_modification.value);
-
- if ((*apply_result != PLDM_FWUP_APPLY_SUCCESS_WITH_ACTIVATION_METHOD) &&
- comp_activation_methods_modification->value) {
- return PLDM_ERROR_INVALID_DATA;
- }
-
- return PLDM_SUCCESS;
-}
-
-int encode_apply_complete_resp(uint8_t instance_id, uint8_t completion_code,
- struct pldm_msg *msg, size_t payload_length)
-{
- if (msg == NULL) {
- return PLDM_ERROR_INVALID_DATA;
- }
-
- if (payload_length != sizeof(completion_code)) {
- return PLDM_ERROR_INVALID_LENGTH;
- }
-
- struct pldm_header_info header = {0};
- header.instance = instance_id;
- header.msg_type = PLDM_RESPONSE;
- header.pldm_type = PLDM_FWUP;
- header.command = PLDM_APPLY_COMPLETE;
- uint8_t rc = pack_pldm_header(&header, &(msg->hdr));
- if (rc) {
- return rc;
- }
-
- msg->payload[0] = completion_code;
-
- return PLDM_SUCCESS;
-}
-
-int encode_activate_firmware_req(uint8_t instance_id,
- bool8_t self_contained_activation_req,
- struct pldm_msg *msg, size_t payload_length)
-{
- if (msg == NULL) {
- return PLDM_ERROR_INVALID_DATA;
- }
-
- if (payload_length != sizeof(struct pldm_activate_firmware_req)) {
- return PLDM_ERROR_INVALID_LENGTH;
- }
-
- if (!is_self_contained_activation_req_valid(
- self_contained_activation_req)) {
- return PLDM_ERROR_INVALID_DATA;
- }
-
- struct pldm_header_info header = {0};
- header.instance = instance_id;
- header.msg_type = PLDM_REQUEST;
- header.pldm_type = PLDM_FWUP;
- header.command = PLDM_ACTIVATE_FIRMWARE;
- uint8_t rc = pack_pldm_header(&header, &(msg->hdr));
- if (rc) {
- return rc;
- }
-
- struct pldm_activate_firmware_req *request =
- (struct pldm_activate_firmware_req *)msg->payload;
-
- request->self_contained_activation_req = self_contained_activation_req;
-
- return PLDM_SUCCESS;
-}
-
-int decode_activate_firmware_resp(const struct pldm_msg *msg,
- size_t payload_length,
- uint8_t *completion_code,
- uint16_t *estimated_time_activation)
-{
- if (msg == NULL || completion_code == NULL ||
- estimated_time_activation == NULL || !payload_length) {
- return PLDM_ERROR_INVALID_DATA;
- }
-
- *completion_code = msg->payload[0];
- if (*completion_code != PLDM_SUCCESS) {
- return PLDM_SUCCESS;
- }
-
- if (payload_length != sizeof(struct pldm_activate_firmware_resp)) {
- return PLDM_ERROR_INVALID_LENGTH;
- }
-
- struct pldm_activate_firmware_resp *response =
- (struct pldm_activate_firmware_resp *)msg->payload;
-
- *estimated_time_activation =
- le16toh(response->estimated_time_activation);
-
- return PLDM_SUCCESS;
-}
-
-int encode_get_status_req(uint8_t instance_id, struct pldm_msg *msg,
- size_t payload_length)
-{
- if (msg == NULL) {
- return PLDM_ERROR_INVALID_DATA;
- }
-
- if (payload_length != PLDM_GET_STATUS_REQ_BYTES) {
- return PLDM_ERROR_INVALID_LENGTH;
- }
-
- struct pldm_header_info header = {0};
- header.instance = instance_id;
- header.msg_type = PLDM_REQUEST;
- header.pldm_type = PLDM_FWUP;
- header.command = PLDM_GET_STATUS;
- uint8_t rc = pack_pldm_header(&header, &(msg->hdr));
- if (rc) {
- return rc;
- }
-
- return PLDM_SUCCESS;
-}
-
-int decode_get_status_resp(const struct pldm_msg *msg, size_t payload_length,
- uint8_t *completion_code, uint8_t *current_state,
- uint8_t *previous_state, uint8_t *aux_state,
- uint8_t *aux_state_status, uint8_t *progress_percent,
- uint8_t *reason_code,
- bitfield32_t *update_option_flags_enabled)
-{
- if (msg == NULL || completion_code == NULL || current_state == NULL ||
- previous_state == NULL || aux_state == NULL ||
- aux_state_status == NULL || progress_percent == NULL ||
- reason_code == NULL || update_option_flags_enabled == NULL ||
- !payload_length) {
- return PLDM_ERROR_INVALID_DATA;
- }
-
- *completion_code = msg->payload[0];
- if (*completion_code != PLDM_SUCCESS) {
- return PLDM_SUCCESS;
- }
-
- if (payload_length != sizeof(struct pldm_get_status_resp)) {
- return PLDM_ERROR_INVALID_LENGTH;
- }
- struct pldm_get_status_resp *response =
- (struct pldm_get_status_resp *)msg->payload;
-
- if (!is_state_valid(response->current_state)) {
- return PLDM_ERROR_INVALID_DATA;
- }
- if (!is_state_valid(response->previous_state)) {
- return PLDM_ERROR_INVALID_DATA;
- }
- if (!is_aux_state_valid(response->aux_state)) {
- return PLDM_ERROR_INVALID_DATA;
- }
- if (!is_aux_state_status_valid(response->aux_state_status)) {
- return PLDM_ERROR_INVALID_DATA;
- }
- if (response->progress_percent > PLDM_FWUP_MAX_PROGRESS_PERCENT) {
- return PLDM_ERROR_INVALID_DATA;
- }
- if (!is_reason_code_valid(response->reason_code)) {
- return PLDM_ERROR_INVALID_DATA;
- }
-
- if ((response->current_state == PLDM_FD_STATE_IDLE) ||
- (response->current_state == PLDM_FD_STATE_LEARN_COMPONENTS) ||
- (response->current_state == PLDM_FD_STATE_READY_XFER)) {
- if (response->aux_state !=
- PLDM_FD_IDLE_LEARN_COMPONENTS_READ_XFER) {
- return PLDM_ERROR_INVALID_DATA;
- }
- }
-
- *current_state = response->current_state;
- *previous_state = response->previous_state;
- *aux_state = response->aux_state;
- *aux_state_status = response->aux_state_status;
- *progress_percent = response->progress_percent;
- *reason_code = response->reason_code;
- update_option_flags_enabled->value =
- le32toh(response->update_option_flags_enabled.value);
-
- return PLDM_SUCCESS;
-}
-
-int encode_cancel_update_component_req(uint8_t instance_id,
- struct pldm_msg *msg,
- size_t payload_length)
-{
- if (msg == NULL) {
- return PLDM_ERROR_INVALID_DATA;
- }
-
- if (payload_length != PLDM_CANCEL_UPDATE_COMPONENT_REQ_BYTES) {
- return PLDM_ERROR_INVALID_LENGTH;
- }
-
- struct pldm_header_info header = {0};
- header.instance = instance_id;
- header.msg_type = PLDM_REQUEST;
- header.pldm_type = PLDM_FWUP;
- header.command = PLDM_CANCEL_UPDATE_COMPONENT;
- uint8_t rc = pack_pldm_header(&header, &(msg->hdr));
- if (rc) {
- return rc;
- }
-
- return PLDM_SUCCESS;
-}
-
-int decode_cancel_update_component_resp(const struct pldm_msg *msg,
- size_t payload_length,
- uint8_t *completion_code)
-{
- if (msg == NULL || completion_code == NULL) {
- return PLDM_ERROR_INVALID_DATA;
- }
-
- if (payload_length != sizeof(*completion_code)) {
- return PLDM_ERROR_INVALID_LENGTH;
- }
-
- *completion_code = msg->payload[0];
- return PLDM_SUCCESS;
-}
-
-int encode_cancel_update_req(uint8_t instance_id, struct pldm_msg *msg,
- size_t payload_length)
-{
- if (msg == NULL) {
- return PLDM_ERROR_INVALID_DATA;
- }
-
- if (payload_length != PLDM_CANCEL_UPDATE_REQ_BYTES) {
- return PLDM_ERROR_INVALID_LENGTH;
- }
-
- struct pldm_header_info header = {0};
- header.instance = instance_id;
- header.msg_type = PLDM_REQUEST;
- header.pldm_type = PLDM_FWUP;
- header.command = PLDM_CANCEL_UPDATE;
- uint8_t rc = pack_pldm_header(&header, &(msg->hdr));
- if (rc) {
- return rc;
- }
-
- return PLDM_SUCCESS;
-}
-
-int decode_cancel_update_resp(const struct pldm_msg *msg, size_t payload_length,
- uint8_t *completion_code,
- bool8_t *non_functioning_component_indication,
- bitfield64_t *non_functioning_component_bitmap)
-{
- if (msg == NULL || completion_code == NULL ||
- non_functioning_component_indication == NULL ||
- non_functioning_component_bitmap == NULL || !payload_length) {
- return PLDM_ERROR_INVALID_DATA;
- }
-
- *completion_code = msg->payload[0];
- if (*completion_code != PLDM_SUCCESS) {
- return PLDM_SUCCESS;
- }
-
- if (payload_length != sizeof(struct pldm_cancel_update_resp)) {
- return PLDM_ERROR_INVALID_LENGTH;
- }
- struct pldm_cancel_update_resp *response =
- (struct pldm_cancel_update_resp *)msg->payload;
-
- if (!is_non_functioning_component_indication_valid(
- response->non_functioning_component_indication)) {
- return PLDM_ERROR_INVALID_DATA;
- }
-
- *non_functioning_component_indication =
- response->non_functioning_component_indication;
-
- if (*non_functioning_component_indication) {
- non_functioning_component_bitmap->value =
- le64toh(response->non_functioning_component_bitmap);
- }
-
- return PLDM_SUCCESS;
-}
+#include "firmware_update.h"
+#include <endian.h>
+#include <string.h>
+
+/** @brief Check whether string type value is valid
+ *
+ * @return true if string type value is valid, false if not
+ */
+static bool is_string_type_valid(uint8_t string_type)
+{
+ switch (string_type) {
+ case PLDM_STR_TYPE_UNKNOWN:
+ return false;
+ case PLDM_STR_TYPE_ASCII:
+ case PLDM_STR_TYPE_UTF_8:
+ case PLDM_STR_TYPE_UTF_16:
+ case PLDM_STR_TYPE_UTF_16LE:
+ case PLDM_STR_TYPE_UTF_16BE:
+ return true;
+ default:
+ return false;
+ }
+}
+
+/** @brief Return the length of the descriptor type described in firmware update
+ * specification
+ *
+ * @return length of the descriptor type if descriptor type is valid else
+ * return 0
+ */
+static uint16_t get_descriptor_type_length(uint16_t descriptor_type)
+{
+ switch (descriptor_type) {
+
+ case PLDM_FWUP_PCI_VENDOR_ID:
+ return PLDM_FWUP_PCI_VENDOR_ID_LENGTH;
+ case PLDM_FWUP_IANA_ENTERPRISE_ID:
+ return PLDM_FWUP_IANA_ENTERPRISE_ID_LENGTH;
+ case PLDM_FWUP_UUID:
+ return PLDM_FWUP_UUID_LENGTH;
+ case PLDM_FWUP_PNP_VENDOR_ID:
+ return PLDM_FWUP_PNP_VENDOR_ID_LENGTH;
+ case PLDM_FWUP_ACPI_VENDOR_ID:
+ return PLDM_FWUP_ACPI_VENDOR_ID_LENGTH;
+ case PLDM_FWUP_IEEE_ASSIGNED_COMPANY_ID:
+ return PLDM_FWUP_IEEE_ASSIGNED_COMPANY_ID_LENGTH;
+ case PLDM_FWUP_SCSI_VENDOR_ID:
+ return PLDM_FWUP_SCSI_VENDOR_ID_LENGTH;
+ case PLDM_FWUP_PCI_DEVICE_ID:
+ return PLDM_FWUP_PCI_DEVICE_ID_LENGTH;
+ case PLDM_FWUP_PCI_SUBSYSTEM_VENDOR_ID:
+ return PLDM_FWUP_PCI_SUBSYSTEM_VENDOR_ID_LENGTH;
+ case PLDM_FWUP_PCI_SUBSYSTEM_ID:
+ return PLDM_FWUP_PCI_SUBSYSTEM_ID_LENGTH;
+ case PLDM_FWUP_PCI_REVISION_ID:
+ return PLDM_FWUP_PCI_REVISION_ID_LENGTH;
+ case PLDM_FWUP_PNP_PRODUCT_IDENTIFIER:
+ return PLDM_FWUP_PNP_PRODUCT_IDENTIFIER_LENGTH;
+ case PLDM_FWUP_ACPI_PRODUCT_IDENTIFIER:
+ return PLDM_FWUP_ACPI_PRODUCT_IDENTIFIER_LENGTH;
+ case PLDM_FWUP_ASCII_MODEL_NUMBER_LONG_STRING:
+ return PLDM_FWUP_ASCII_MODEL_NUMBER_LONG_STRING_LENGTH;
+ case PLDM_FWUP_ASCII_MODEL_NUMBER_SHORT_STRING:
+ return PLDM_FWUP_ASCII_MODEL_NUMBER_SHORT_STRING_LENGTH;
+ case PLDM_FWUP_SCSI_PRODUCT_ID:
+ return PLDM_FWUP_SCSI_PRODUCT_ID_LENGTH;
+ case PLDM_FWUP_UBM_CONTROLLER_DEVICE_CODE:
+ return PLDM_FWUP_UBM_CONTROLLER_DEVICE_CODE_LENGTH;
+ default:
+ return 0;
+ }
+}
+
+/** @brief Check whether ComponentResponse is valid
+ *
+ * @return true if ComponentResponse is valid, false if not
+ */
+static bool is_comp_resp_valid(uint8_t comp_resp)
+{
+ switch (comp_resp) {
+ case PLDM_CR_COMP_CAN_BE_UPDATED:
+ case PLDM_CR_COMP_MAY_BE_UPDATEABLE:
+ return true;
+
+ default:
+ return false;
+ }
+}
+
+/** @brief Check whether ComponentResponseCode is valid
+ *
+ * @return true if ComponentResponseCode is valid, false if not
+ */
+static bool is_comp_resp_code_valid(uint8_t comp_resp_code)
+{
+ switch (comp_resp_code) {
+ case PLDM_CRC_COMP_CAN_BE_UPDATED:
+ case PLDM_CRC_COMP_COMPARISON_STAMP_IDENTICAL:
+ case PLDM_CRC_COMP_COMPARISON_STAMP_LOWER:
+ case PLDM_CRC_INVALID_COMP_COMPARISON_STAMP:
+ case PLDM_CRC_COMP_CONFLICT:
+ case PLDM_CRC_COMP_PREREQUISITES_NOT_MET:
+ case PLDM_CRC_COMP_NOT_SUPPORTED:
+ case PLDM_CRC_COMP_SECURITY_RESTRICTIONS:
+ case PLDM_CRC_INCOMPLETE_COMP_IMAGE_SET:
+ case PLDM_CRC_ACTIVE_IMAGE_NOT_UPDATEABLE_SUBSEQUENTLY:
+ case PLDM_CRC_COMP_VER_STR_IDENTICAL:
+ case PLDM_CRC_COMP_VER_STR_LOWER:
+ return true;
+
+ default:
+ if (comp_resp_code >=
+ PLDM_CRC_VENDOR_COMP_RESP_CODE_RANGE_MIN &&
+ comp_resp_code <=
+ PLDM_CRC_VENDOR_COMP_RESP_CODE_RANGE_MAX) {
+ return true;
+ }
+ return false;
+ }
+}
+
+/** @brief Check whether ComponentCompatibilityResponse is valid
+ *
+ * @return true if ComponentCompatibilityResponse is valid, false if not
+ */
+static bool is_comp_compatibility_resp_valid(uint8_t comp_compatibility_resp)
+{
+ switch (comp_compatibility_resp) {
+ case PLDM_CCR_COMP_CAN_BE_UPDATED:
+ case PLDM_CCR_COMP_CANNOT_BE_UPDATED:
+ return true;
+
+ default:
+ return false;
+ }
+}
+
+/** @brief Check whether ComponentCompatibilityResponse Code is valid
+ *
+ * @return true if ComponentCompatibilityResponse Code is valid, false if not
+ */
+static bool
+is_comp_compatibility_resp_code_valid(uint8_t comp_compatibility_resp_code)
+{
+ switch (comp_compatibility_resp_code) {
+ case PLDM_CCRC_NO_RESPONSE_CODE:
+ case PLDM_CCRC_COMP_COMPARISON_STAMP_IDENTICAL:
+ case PLDM_CCRC_COMP_COMPARISON_STAMP_LOWER:
+ case PLDM_CCRC_INVALID_COMP_COMPARISON_STAMP:
+ case PLDM_CCRC_COMP_CONFLICT:
+ case PLDM_CCRC_COMP_PREREQUISITES_NOT_MET:
+ case PLDM_CCRC_COMP_NOT_SUPPORTED:
+ case PLDM_CCRC_COMP_SECURITY_RESTRICTIONS:
+ case PLDM_CRC_INCOMPLETE_COMP_IMAGE_SET:
+ case PLDM_CCRC_COMP_INFO_NO_MATCH:
+ case PLDM_CCRC_COMP_VER_STR_IDENTICAL:
+ case PLDM_CCRC_COMP_VER_STR_LOWER:
+ return true;
+
+ default:
+ if (comp_compatibility_resp_code >=
+ PLDM_CCRC_VENDOR_COMP_RESP_CODE_RANGE_MIN &&
+ comp_compatibility_resp_code <=
+ PLDM_CCRC_VENDOR_COMP_RESP_CODE_RANGE_MAX) {
+ return true;
+ }
+ return false;
+ }
+}
+
+/** @brief Check whether SelfContainedActivationRequest is valid
+ *
+ * @return true if SelfContainedActivationRequest is valid, false if not
+ */
+static bool
+is_self_contained_activation_req_valid(bool8_t self_contained_activation_req)
+{
+ switch (self_contained_activation_req) {
+ case PLDM_NOT_ACTIVATE_SELF_CONTAINED_COMPONENTS:
+ case PLDM_ACTIVATE_SELF_CONTAINED_COMPONENTS:
+ return true;
+
+ default:
+ return false;
+ }
+}
+
+/** @brief Check if current or previous status in GetStatus command response is
+ * valid
+ *
+ * @param[in] state - current or previous different state machine state of
+ * the FD
+ * @return true if state is valid, false if not
+ */
+static bool is_state_valid(uint8_t state)
+{
+ switch (state) {
+ case PLDM_FD_STATE_IDLE:
+ case PLDM_FD_STATE_LEARN_COMPONENTS:
+ case PLDM_FD_STATE_READY_XFER:
+ case PLDM_FD_STATE_DOWNLOAD:
+ case PLDM_FD_STATE_VERIFY:
+ case PLDM_FD_STATE_APPLY:
+ case PLDM_FD_STATE_ACTIVATE:
+ return true;
+
+ default:
+ return false;
+ }
+}
+
+/** @brief Check if aux state in GetStatus command response is valid
+ *
+ * @param[in] aux_state - provides additional information to the UA to describe
+ * the current operation state of the FD/FDP
+ *
+ * @return true if aux state is valid, false if not
+ */
+static bool is_aux_state_valid(uint8_t aux_state)
+{
+ switch (aux_state) {
+ case PLDM_FD_OPERATION_IN_PROGRESS:
+ case PLDM_FD_OPERATION_SUCCESSFUL:
+ case PLDM_FD_OPERATION_FAILED:
+ case PLDM_FD_IDLE_LEARN_COMPONENTS_READ_XFER:
+ return true;
+
+ default:
+ return false;
+ }
+}
+
+/** @brief Check if aux state status in GetStatus command response is valid
+ *
+ * @param[in] aux_state_status - aux state status
+ *
+ * @return true if aux state status is valid, false if not
+ */
+static bool is_aux_state_status_valid(uint8_t aux_state_status)
+{
+ if (aux_state_status == PLDM_FD_AUX_STATE_IN_PROGRESS_OR_SUCCESS ||
+ aux_state_status == PLDM_FD_TIMEOUT ||
+ aux_state_status == PLDM_FD_GENERIC_ERROR) {
+ return true;
+ } else if (aux_state_status >=
+ PLDM_FD_VENDOR_DEFINED_STATUS_CODE_START &&
+ aux_state_status <= PLDM_FD_VENDOR_DEFINED_STATUS_CODE_END) {
+ return true;
+ }
+
+ return false;
+}
+
+/** @brief Check if reason code in GetStatus command response is valid
+ *
+ * @param[in] reason_code - provides the reason for why the current state
+ * entered the IDLE state
+ *
+ * @return true if reason code is valid, false if not
+ */
+static bool is_reason_code_valid(uint8_t reason_code)
+{
+
+ switch (reason_code) {
+ case PLDM_FD_INITIALIZATION:
+ case PLDM_FD_ACTIVATE_FW:
+ case PLDM_FD_CANCEL_UPDATE:
+ case PLDM_FD_TIMEOUT_LEARN_COMPONENT:
+ case PLDM_FD_TIMEOUT_READY_XFER:
+ case PLDM_FD_TIMEOUT_DOWNLOAD:
+ case PLDM_FD_TIMEOUT_VERIFY:
+ case PLDM_FD_TIMEOUT_APPLY:
+ return true;
+
+ default:
+ if (reason_code >= PLDM_FD_STATUS_VENDOR_DEFINED_MIN) {
+ return true;
+ }
+ return false;
+ }
+}
+
+/** @brief Check if non functioning component indication in CancelUpdate
+ * response is valid
+ *
+ * @return true if non functioning component indication is valid, false if not
+ */
+static bool is_non_functioning_component_indication_valid(
+ bool8_t non_functioning_component_indication)
+{
+ switch (non_functioning_component_indication) {
+ case PLDM_FWUP_COMPONENTS_FUNCTIONING:
+ case PLDM_FWUP_COMPONENTS_NOT_FUNCTIONING:
+ return true;
+
+ default:
+ return false;
+ }
+}
+
+int decode_pldm_package_header_info(
+ const uint8_t *data, size_t length,
+ struct pldm_package_header_information *package_header_info,
+ struct variable_field *package_version_str)
+{
+ if (data == NULL || package_header_info == NULL ||
+ package_version_str == NULL) {
+ return PLDM_ERROR_INVALID_DATA;
+ }
+
+ if (length < sizeof(struct pldm_package_header_information)) {
+ return PLDM_ERROR_INVALID_LENGTH;
+ }
+
+ struct pldm_package_header_information *data_header =
+ (struct pldm_package_header_information *)(data);
+
+ if (!is_string_type_valid(data_header->package_version_string_type) ||
+ (data_header->package_version_string_length == 0)) {
+ return PLDM_ERROR_INVALID_DATA;
+ }
+
+ if (length < sizeof(struct pldm_package_header_information) +
+ data_header->package_version_string_length) {
+ return PLDM_ERROR_INVALID_LENGTH;
+ }
+
+ if ((data_header->component_bitmap_bit_length %
+ PLDM_FWUP_COMPONENT_BITMAP_MULTIPLE) != 0) {
+ return PLDM_ERROR_INVALID_DATA;
+ }
+
+ memcpy(package_header_info->uuid, data_header->uuid,
+ sizeof(data_header->uuid));
+ package_header_info->package_header_format_version =
+ data_header->package_header_format_version;
+ package_header_info->package_header_size =
+ le16toh(data_header->package_header_size);
+ memcpy(package_header_info->timestamp104, data_header->timestamp104,
+ sizeof(data_header->timestamp104));
+ package_header_info->component_bitmap_bit_length =
+ le16toh(data_header->component_bitmap_bit_length);
+ package_header_info->package_version_string_type =
+ data_header->package_version_string_type;
+ package_header_info->package_version_string_length =
+ data_header->package_version_string_length;
+ package_version_str->ptr =
+ data + sizeof(struct pldm_package_header_information);
+ package_version_str->length =
+ package_header_info->package_version_string_length;
+
+ return PLDM_SUCCESS;
+}
+
+int decode_firmware_device_id_record(
+ const uint8_t *data, size_t length, uint16_t component_bitmap_bit_length,
+ struct pldm_firmware_device_id_record *fw_device_id_record,
+ struct variable_field *applicable_components,
+ struct variable_field *comp_image_set_version_str,
+ struct variable_field *record_descriptors,
+ struct variable_field *fw_device_pkg_data)
+{
+ if (data == NULL || fw_device_id_record == NULL ||
+ applicable_components == NULL ||
+ comp_image_set_version_str == NULL || record_descriptors == NULL ||
+ fw_device_pkg_data == NULL) {
+ return PLDM_ERROR_INVALID_DATA;
+ }
+
+ if (length < sizeof(struct pldm_firmware_device_id_record)) {
+ return PLDM_ERROR_INVALID_LENGTH;
+ }
+
+ if ((component_bitmap_bit_length %
+ PLDM_FWUP_COMPONENT_BITMAP_MULTIPLE) != 0) {
+ return PLDM_ERROR_INVALID_DATA;
+ }
+
+ struct pldm_firmware_device_id_record *data_record =
+ (struct pldm_firmware_device_id_record *)(data);
+
+ if (!is_string_type_valid(
+ data_record->comp_image_set_version_string_type) ||
+ (data_record->comp_image_set_version_string_length == 0)) {
+ return PLDM_ERROR_INVALID_DATA;
+ }
+
+ fw_device_id_record->record_length =
+ le16toh(data_record->record_length);
+ fw_device_id_record->descriptor_count = data_record->descriptor_count;
+ fw_device_id_record->device_update_option_flags.value =
+ le32toh(data_record->device_update_option_flags.value);
+ fw_device_id_record->comp_image_set_version_string_type =
+ data_record->comp_image_set_version_string_type;
+ fw_device_id_record->comp_image_set_version_string_length =
+ data_record->comp_image_set_version_string_length;
+ fw_device_id_record->fw_device_pkg_data_length =
+ le16toh(data_record->fw_device_pkg_data_length);
+
+ if (length < fw_device_id_record->record_length) {
+ return PLDM_ERROR_INVALID_LENGTH;
+ }
+
+ uint16_t applicable_components_length =
+ component_bitmap_bit_length / PLDM_FWUP_COMPONENT_BITMAP_MULTIPLE;
+ uint16_t calc_min_record_length =
+ sizeof(struct pldm_firmware_device_id_record) +
+ applicable_components_length +
+ data_record->comp_image_set_version_string_length +
+ PLDM_FWUP_DEVICE_DESCRIPTOR_MIN_LEN +
+ fw_device_id_record->fw_device_pkg_data_length;
+
+ if (fw_device_id_record->record_length < calc_min_record_length) {
+ return PLDM_ERROR_INVALID_LENGTH;
+ }
+
+ applicable_components->ptr =
+ data + sizeof(struct pldm_firmware_device_id_record);
+ applicable_components->length = applicable_components_length;
+
+ comp_image_set_version_str->ptr =
+ applicable_components->ptr + applicable_components->length;
+ comp_image_set_version_str->length =
+ fw_device_id_record->comp_image_set_version_string_length;
+
+ record_descriptors->ptr = comp_image_set_version_str->ptr +
+ comp_image_set_version_str->length;
+ record_descriptors->length =
+ fw_device_id_record->record_length -
+ sizeof(struct pldm_firmware_device_id_record) -
+ applicable_components_length -
+ fw_device_id_record->comp_image_set_version_string_length -
+ fw_device_id_record->fw_device_pkg_data_length;
+
+ if (fw_device_id_record->fw_device_pkg_data_length) {
+ fw_device_pkg_data->ptr =
+ record_descriptors->ptr + record_descriptors->length;
+ fw_device_pkg_data->length =
+ fw_device_id_record->fw_device_pkg_data_length;
+ }
+
+ return PLDM_SUCCESS;
+}
+
+int decode_descriptor_type_length_value(const uint8_t *data, size_t length,
+ uint16_t *descriptor_type,
+ struct variable_field *descriptor_data)
+{
+ uint16_t descriptor_length = 0;
+
+ if (data == NULL || descriptor_type == NULL ||
+ descriptor_data == NULL) {
+ return PLDM_ERROR_INVALID_DATA;
+ }
+
+ if (length < PLDM_FWUP_DEVICE_DESCRIPTOR_MIN_LEN) {
+ return PLDM_ERROR_INVALID_LENGTH;
+ }
+
+ struct pldm_descriptor_tlv *entry =
+ (struct pldm_descriptor_tlv *)(data);
+
+ *descriptor_type = le16toh(entry->descriptor_type);
+ descriptor_length = le16toh(entry->descriptor_length);
+ if (*descriptor_type != PLDM_FWUP_VENDOR_DEFINED) {
+ if (descriptor_length !=
+ get_descriptor_type_length(*descriptor_type)) {
+ return PLDM_ERROR_INVALID_LENGTH;
+ }
+ }
+
+ if (length < (sizeof(*descriptor_type) + sizeof(descriptor_length) +
+ descriptor_length)) {
+ return PLDM_ERROR_INVALID_LENGTH;
+ }
+
+ descriptor_data->ptr = entry->descriptor_data;
+ descriptor_data->length = descriptor_length;
+
+ return PLDM_SUCCESS;
+}
+
+int decode_vendor_defined_descriptor_value(
+ const uint8_t *data, size_t length, uint8_t *descriptor_title_str_type,
+ struct variable_field *descriptor_title_str,
+ struct variable_field *descriptor_data)
+{
+ if (data == NULL || descriptor_title_str_type == NULL ||
+ descriptor_title_str == NULL || descriptor_data == NULL) {
+ return PLDM_ERROR_INVALID_DATA;
+ }
+
+ if (length < sizeof(struct pldm_vendor_defined_descriptor_title_data)) {
+ return PLDM_ERROR_INVALID_LENGTH;
+ }
+
+ struct pldm_vendor_defined_descriptor_title_data *entry =
+ (struct pldm_vendor_defined_descriptor_title_data *)(data);
+ if (!is_string_type_valid(
+ entry->vendor_defined_descriptor_title_str_type) ||
+ (entry->vendor_defined_descriptor_title_str_len == 0)) {
+ return PLDM_ERROR_INVALID_DATA;
+ }
+
+ // Assuming atleast 1 byte of VendorDefinedDescriptorData
+ if (length < (sizeof(struct pldm_vendor_defined_descriptor_title_data) +
+ entry->vendor_defined_descriptor_title_str_len)) {
+ return PLDM_ERROR_INVALID_LENGTH;
+ }
+
+ *descriptor_title_str_type =
+ entry->vendor_defined_descriptor_title_str_type;
+ descriptor_title_str->ptr = entry->vendor_defined_descriptor_title_str;
+ descriptor_title_str->length =
+ entry->vendor_defined_descriptor_title_str_len;
+
+ descriptor_data->ptr =
+ descriptor_title_str->ptr + descriptor_title_str->length;
+ descriptor_data->length =
+ length - sizeof(entry->vendor_defined_descriptor_title_str_type) -
+ sizeof(entry->vendor_defined_descriptor_title_str_len) -
+ descriptor_title_str->length;
+
+ return PLDM_SUCCESS;
+}
+
+int decode_pldm_comp_image_info(
+ const uint8_t *data, size_t length,
+ struct pldm_component_image_information *pldm_comp_image_info,
+ struct variable_field *comp_version_str)
+{
+ if (data == NULL || pldm_comp_image_info == NULL ||
+ comp_version_str == NULL) {
+ return PLDM_ERROR_INVALID_DATA;
+ }
+
+ if (length < sizeof(struct pldm_component_image_information)) {
+ return PLDM_ERROR_INVALID_LENGTH;
+ }
+
+ struct pldm_component_image_information *data_header =
+ (struct pldm_component_image_information *)(data);
+
+ if (!is_string_type_valid(data_header->comp_version_string_type) ||
+ (data_header->comp_version_string_length == 0)) {
+ return PLDM_ERROR_INVALID_DATA;
+ }
+
+ if (length < sizeof(struct pldm_component_image_information) +
+ data_header->comp_version_string_length) {
+ return PLDM_ERROR_INVALID_LENGTH;
+ }
+
+ pldm_comp_image_info->comp_classification =
+ le16toh(data_header->comp_classification);
+ pldm_comp_image_info->comp_identifier =
+ le16toh(data_header->comp_identifier);
+ pldm_comp_image_info->comp_comparison_stamp =
+ le32toh(data_header->comp_comparison_stamp);
+ pldm_comp_image_info->comp_options.value =
+ le16toh(data_header->comp_options.value);
+ pldm_comp_image_info->requested_comp_activation_method.value =
+ le16toh(data_header->requested_comp_activation_method.value);
+ pldm_comp_image_info->comp_location_offset =
+ le32toh(data_header->comp_location_offset);
+ pldm_comp_image_info->comp_size = le32toh(data_header->comp_size);
+ pldm_comp_image_info->comp_version_string_type =
+ data_header->comp_version_string_type;
+ pldm_comp_image_info->comp_version_string_length =
+ data_header->comp_version_string_length;
+
+ if ((pldm_comp_image_info->comp_options.bits.bit1 == false &&
+ pldm_comp_image_info->comp_comparison_stamp !=
+ PLDM_FWUP_INVALID_COMPONENT_COMPARISON_TIMESTAMP)) {
+ return PLDM_ERROR_INVALID_DATA;
+ }
+
+ if (pldm_comp_image_info->comp_location_offset == 0 ||
+ pldm_comp_image_info->comp_size == 0) {
+ return PLDM_ERROR_INVALID_DATA;
+ }
+
+ comp_version_str->ptr =
+ data + sizeof(struct pldm_component_image_information);
+ comp_version_str->length =
+ pldm_comp_image_info->comp_version_string_length;
+
+ return PLDM_SUCCESS;
+}
+
+int encode_query_device_identifiers_req(uint8_t instance_id,
+ size_t payload_length,
+ struct pldm_msg *msg)
+{
+ if (msg == NULL) {
+ return PLDM_ERROR_INVALID_DATA;
+ }
+
+ if (payload_length != PLDM_QUERY_DEVICE_IDENTIFIERS_REQ_BYTES) {
+ return PLDM_ERROR_INVALID_LENGTH;
+ }
+
+ return encode_pldm_header_only(PLDM_REQUEST, instance_id, PLDM_FWUP,
+ PLDM_QUERY_DEVICE_IDENTIFIERS, msg);
+}
+
+int decode_query_device_identifiers_resp(const struct pldm_msg *msg,
+ size_t payload_length,
+ uint8_t *completion_code,
+ uint32_t *device_identifiers_len,
+ uint8_t *descriptor_count,
+ uint8_t **descriptor_data)
+{
+ if (msg == NULL || completion_code == NULL ||
+ device_identifiers_len == NULL || descriptor_count == NULL ||
+ descriptor_data == NULL) {
+ return PLDM_ERROR_INVALID_DATA;
+ }
+
+ *completion_code = msg->payload[0];
+ if (PLDM_SUCCESS != *completion_code) {
+ return PLDM_SUCCESS;
+ }
+
+ if (payload_length <
+ sizeof(struct pldm_query_device_identifiers_resp)) {
+ return PLDM_ERROR_INVALID_LENGTH;
+ }
+
+ struct pldm_query_device_identifiers_resp *response =
+ (struct pldm_query_device_identifiers_resp *)msg->payload;
+ *device_identifiers_len = le32toh(response->device_identifiers_len);
+
+ if (*device_identifiers_len < PLDM_FWUP_DEVICE_DESCRIPTOR_MIN_LEN) {
+ return PLDM_ERROR_INVALID_LENGTH;
+ }
+
+ if (payload_length !=
+ sizeof(struct pldm_query_device_identifiers_resp) +
+ *device_identifiers_len) {
+ return PLDM_ERROR_INVALID_LENGTH;
+ }
+ *descriptor_count = response->descriptor_count;
+
+ if (*descriptor_count == 0) {
+ return PLDM_ERROR_INVALID_DATA;
+ }
+ *descriptor_data =
+ (uint8_t *)(msg->payload +
+ sizeof(struct pldm_query_device_identifiers_resp));
+ return PLDM_SUCCESS;
+}
+
+int encode_get_firmware_parameters_req(uint8_t instance_id,
+ size_t payload_length,
+ struct pldm_msg *msg)
+{
+ if (msg == NULL) {
+ return PLDM_ERROR_INVALID_DATA;
+ }
+
+ if (payload_length != PLDM_GET_FIRMWARE_PARAMETERS_REQ_BYTES) {
+ return PLDM_ERROR_INVALID_LENGTH;
+ }
+
+ return encode_pldm_header_only(PLDM_REQUEST, instance_id, PLDM_FWUP,
+ PLDM_GET_FIRMWARE_PARAMETERS, msg);
+}
+
+int decode_get_firmware_parameters_resp(
+ const struct pldm_msg *msg, size_t payload_length,
+ struct pldm_get_firmware_parameters_resp *resp_data,
+ struct variable_field *active_comp_image_set_ver_str,
+ struct variable_field *pending_comp_image_set_ver_str,
+ struct variable_field *comp_parameter_table)
+{
+ if (msg == NULL || resp_data == NULL ||
+ active_comp_image_set_ver_str == NULL ||
+ pending_comp_image_set_ver_str == NULL ||
+ comp_parameter_table == NULL || !payload_length) {
+ return PLDM_ERROR_INVALID_DATA;
+ }
+
+ resp_data->completion_code = msg->payload[0];
+ if (PLDM_SUCCESS != resp_data->completion_code) {
+ return PLDM_SUCCESS;
+ }
+
+ if (payload_length < sizeof(struct pldm_get_firmware_parameters_resp)) {
+ return PLDM_ERROR_INVALID_LENGTH;
+ }
+
+ struct pldm_get_firmware_parameters_resp *response =
+ (struct pldm_get_firmware_parameters_resp *)msg->payload;
+
+ if (!is_string_type_valid(
+ response->active_comp_image_set_ver_str_type) ||
+ (response->active_comp_image_set_ver_str_len == 0)) {
+ return PLDM_ERROR_INVALID_DATA;
+ }
+
+ if (response->pending_comp_image_set_ver_str_len == 0) {
+ if (response->pending_comp_image_set_ver_str_type !=
+ PLDM_STR_TYPE_UNKNOWN) {
+ return PLDM_ERROR_INVALID_DATA;
+ }
+ } else {
+ if (!is_string_type_valid(
+ response->pending_comp_image_set_ver_str_type)) {
+ return PLDM_ERROR_INVALID_DATA;
+ }
+ }
+
+ size_t partial_response_length =
+ sizeof(struct pldm_get_firmware_parameters_resp) +
+ response->active_comp_image_set_ver_str_len +
+ response->pending_comp_image_set_ver_str_len;
+
+ if (payload_length < partial_response_length) {
+ return PLDM_ERROR_INVALID_LENGTH;
+ }
+
+ resp_data->capabilities_during_update.value =
+ le32toh(response->capabilities_during_update.value);
+ resp_data->comp_count = le16toh(response->comp_count);
+ resp_data->active_comp_image_set_ver_str_type =
+ response->active_comp_image_set_ver_str_type;
+ resp_data->active_comp_image_set_ver_str_len =
+ response->active_comp_image_set_ver_str_len;
+ resp_data->pending_comp_image_set_ver_str_type =
+ response->pending_comp_image_set_ver_str_type;
+ resp_data->pending_comp_image_set_ver_str_len =
+ response->pending_comp_image_set_ver_str_len;
+
+ active_comp_image_set_ver_str->ptr =
+ msg->payload + sizeof(struct pldm_get_firmware_parameters_resp);
+ active_comp_image_set_ver_str->length =
+ resp_data->active_comp_image_set_ver_str_len;
+
+ if (resp_data->pending_comp_image_set_ver_str_len != 0) {
+ pending_comp_image_set_ver_str->ptr =
+ msg->payload +
+ sizeof(struct pldm_get_firmware_parameters_resp) +
+ resp_data->active_comp_image_set_ver_str_len;
+ pending_comp_image_set_ver_str->length =
+ resp_data->pending_comp_image_set_ver_str_len;
+ } else {
+ pending_comp_image_set_ver_str->ptr = NULL;
+ pending_comp_image_set_ver_str->length = 0;
+ }
+
+ if (payload_length > partial_response_length && resp_data->comp_count) {
+ comp_parameter_table->ptr =
+ msg->payload +
+ sizeof(struct pldm_get_firmware_parameters_resp) +
+ resp_data->active_comp_image_set_ver_str_len +
+ resp_data->pending_comp_image_set_ver_str_len;
+ comp_parameter_table->length =
+ payload_length - partial_response_length;
+ } else {
+ comp_parameter_table->ptr = NULL;
+ comp_parameter_table->length = 0;
+ }
+
+ return PLDM_SUCCESS;
+}
+
+int decode_get_firmware_parameters_resp_comp_entry(
+ const uint8_t *data, size_t length,
+ struct pldm_component_parameter_entry *component_data,
+ struct variable_field *active_comp_ver_str,
+ struct variable_field *pending_comp_ver_str)
+{
+ if (data == NULL || component_data == NULL ||
+ active_comp_ver_str == NULL || pending_comp_ver_str == NULL) {
+ return PLDM_ERROR_INVALID_DATA;
+ }
+
+ if (length < sizeof(struct pldm_component_parameter_entry)) {
+ return PLDM_ERROR_INVALID_LENGTH;
+ }
+
+ struct pldm_component_parameter_entry *entry =
+ (struct pldm_component_parameter_entry *)(data);
+ if (entry->active_comp_ver_str_len == 0) {
+ return PLDM_ERROR_INVALID_LENGTH;
+ }
+
+ size_t entry_length = sizeof(struct pldm_component_parameter_entry) +
+ entry->active_comp_ver_str_len +
+ entry->pending_comp_ver_str_len;
+
+ if (length < entry_length) {
+ return PLDM_ERROR_INVALID_LENGTH;
+ }
+
+ component_data->comp_classification =
+ le16toh(entry->comp_classification);
+ component_data->comp_identifier = le16toh(entry->comp_identifier);
+ component_data->comp_classification_index =
+ entry->comp_classification_index;
+ component_data->active_comp_comparison_stamp =
+ le32toh(entry->active_comp_comparison_stamp);
+ component_data->active_comp_ver_str_type =
+ entry->active_comp_ver_str_type;
+ component_data->active_comp_ver_str_len =
+ entry->active_comp_ver_str_len;
+ memcpy(component_data->active_comp_release_date,
+ entry->active_comp_release_date,
+ sizeof(entry->active_comp_release_date));
+ component_data->pending_comp_comparison_stamp =
+ le32toh(entry->pending_comp_comparison_stamp);
+ component_data->pending_comp_ver_str_type =
+ entry->pending_comp_ver_str_type;
+ component_data->pending_comp_ver_str_len =
+ entry->pending_comp_ver_str_len;
+ memcpy(component_data->pending_comp_release_date,
+ entry->pending_comp_release_date,
+ sizeof(entry->pending_comp_release_date));
+ component_data->comp_activation_methods.value =
+ le16toh(entry->comp_activation_methods.value);
+ component_data->capabilities_during_update.value =
+ le32toh(entry->capabilities_during_update.value);
+
+ active_comp_ver_str->ptr =
+ data + sizeof(struct pldm_component_parameter_entry);
+ active_comp_ver_str->length = entry->active_comp_ver_str_len;
+
+ if (entry->pending_comp_ver_str_len != 0) {
+
+ pending_comp_ver_str->ptr =
+ data + sizeof(struct pldm_component_parameter_entry) +
+ entry->active_comp_ver_str_len;
+ pending_comp_ver_str->length = entry->pending_comp_ver_str_len;
+ } else {
+ pending_comp_ver_str->ptr = NULL;
+ pending_comp_ver_str->length = 0;
+ }
+ return PLDM_SUCCESS;
+}
+
+int encode_request_update_req(uint8_t instance_id, uint32_t max_transfer_size,
+ uint16_t num_of_comp,
+ uint8_t max_outstanding_transfer_req,
+ uint16_t pkg_data_len,
+ uint8_t comp_image_set_ver_str_type,
+ uint8_t comp_image_set_ver_str_len,
+ const struct variable_field *comp_img_set_ver_str,
+ struct pldm_msg *msg, size_t payload_length)
+{
+ if (comp_img_set_ver_str == NULL || comp_img_set_ver_str->ptr == NULL ||
+ msg == NULL) {
+ return PLDM_ERROR_INVALID_DATA;
+ }
+
+ if (payload_length != sizeof(struct pldm_request_update_req) +
+ comp_img_set_ver_str->length) {
+ return PLDM_ERROR_INVALID_LENGTH;
+ }
+
+ if ((comp_image_set_ver_str_len == 0) ||
+ (comp_image_set_ver_str_len != comp_img_set_ver_str->length)) {
+ return PLDM_ERROR_INVALID_DATA;
+ }
+
+ if ((max_transfer_size < PLDM_FWUP_BASELINE_TRANSFER_SIZE) ||
+ (max_outstanding_transfer_req < PLDM_FWUP_MIN_OUTSTANDING_REQ)) {
+ return PLDM_ERROR_INVALID_DATA;
+ }
+
+ if (!is_string_type_valid(comp_image_set_ver_str_type)) {
+ return PLDM_ERROR_INVALID_DATA;
+ }
+
+ struct pldm_header_info header = {0};
+ header.instance = instance_id;
+ header.msg_type = PLDM_REQUEST;
+ header.pldm_type = PLDM_FWUP;
+ header.command = PLDM_REQUEST_UPDATE;
+ uint8_t rc = pack_pldm_header(&header, &(msg->hdr));
+ if (rc) {
+ return rc;
+ }
+
+ struct pldm_request_update_req *request =
+ (struct pldm_request_update_req *)msg->payload;
+
+ request->max_transfer_size = htole32(max_transfer_size);
+ request->num_of_comp = htole16(num_of_comp);
+ request->max_outstanding_transfer_req = max_outstanding_transfer_req;
+ request->pkg_data_len = htole16(pkg_data_len);
+ request->comp_image_set_ver_str_type = comp_image_set_ver_str_type;
+ request->comp_image_set_ver_str_len = comp_image_set_ver_str_len;
+
+ memcpy(msg->payload + sizeof(struct pldm_request_update_req),
+ comp_img_set_ver_str->ptr, comp_img_set_ver_str->length);
+
+ return PLDM_SUCCESS;
+}
+
+int decode_request_update_resp(const struct pldm_msg *msg,
+ size_t payload_length, uint8_t *completion_code,
+ uint16_t *fd_meta_data_len,
+ uint8_t *fd_will_send_pkg_data)
+{
+ if (msg == NULL || completion_code == NULL ||
+ fd_meta_data_len == NULL || fd_will_send_pkg_data == NULL ||
+ !payload_length) {
+ return PLDM_ERROR_INVALID_DATA;
+ }
+
+ *completion_code = msg->payload[0];
+ if (*completion_code != PLDM_SUCCESS) {
+ return PLDM_SUCCESS;
+ }
+
+ if (payload_length != sizeof(struct pldm_request_update_resp)) {
+ return PLDM_ERROR_INVALID_LENGTH;
+ }
+
+ struct pldm_request_update_resp *response =
+ (struct pldm_request_update_resp *)msg->payload;
+
+ *fd_meta_data_len = le16toh(response->fd_meta_data_len);
+ *fd_will_send_pkg_data = response->fd_will_send_pkg_data;
+
+ return PLDM_SUCCESS;
+}
+
+int encode_pass_component_table_req(
+ uint8_t instance_id, uint8_t transfer_flag, uint16_t comp_classification,
+ uint16_t comp_identifier, uint8_t comp_classification_index,
+ uint32_t comp_comparison_stamp, uint8_t comp_ver_str_type,
+ uint8_t comp_ver_str_len, const struct variable_field *comp_ver_str,
+ struct pldm_msg *msg, size_t payload_length)
+{
+ if (comp_ver_str == NULL || comp_ver_str->ptr == NULL || msg == NULL) {
+ return PLDM_ERROR_INVALID_DATA;
+ }
+
+ if (payload_length != sizeof(struct pldm_pass_component_table_req) +
+ comp_ver_str->length) {
+ return PLDM_ERROR_INVALID_LENGTH;
+ }
+
+ if ((comp_ver_str_len == 0) ||
+ (comp_ver_str_len != comp_ver_str->length)) {
+ return PLDM_ERROR_INVALID_DATA;
+ }
+
+ if (!is_transfer_flag_valid(transfer_flag)) {
+ return PLDM_INVALID_TRANSFER_OPERATION_FLAG;
+ }
+
+ if (!is_string_type_valid(comp_ver_str_type)) {
+ return PLDM_ERROR_INVALID_DATA;
+ }
+
+ struct pldm_header_info header = {0};
+ header.instance = instance_id;
+ header.msg_type = PLDM_REQUEST;
+ header.pldm_type = PLDM_FWUP;
+ header.command = PLDM_PASS_COMPONENT_TABLE;
+ uint8_t rc = pack_pldm_header(&header, &(msg->hdr));
+ if (rc) {
+ return rc;
+ }
+
+ struct pldm_pass_component_table_req *request =
+ (struct pldm_pass_component_table_req *)msg->payload;
+
+ request->transfer_flag = transfer_flag;
+ request->comp_classification = htole16(comp_classification);
+ request->comp_identifier = htole16(comp_identifier);
+ request->comp_classification_index = comp_classification_index;
+ request->comp_comparison_stamp = htole32(comp_comparison_stamp);
+ request->comp_ver_str_type = comp_ver_str_type;
+ request->comp_ver_str_len = comp_ver_str_len;
+
+ memcpy(msg->payload + sizeof(struct pldm_pass_component_table_req),
+ comp_ver_str->ptr, comp_ver_str->length);
+
+ return PLDM_SUCCESS;
+}
+
+int decode_pass_component_table_resp(const struct pldm_msg *msg,
+ const size_t payload_length,
+ uint8_t *completion_code,
+ uint8_t *comp_resp,
+ uint8_t *comp_resp_code)
+{
+ if (msg == NULL || completion_code == NULL || comp_resp == NULL ||
+ comp_resp_code == NULL || !payload_length) {
+ return PLDM_ERROR_INVALID_DATA;
+ }
+
+ *completion_code = msg->payload[0];
+ if (*completion_code != PLDM_SUCCESS) {
+ return PLDM_SUCCESS;
+ }
+
+ if (payload_length != sizeof(struct pldm_pass_component_table_resp)) {
+ return PLDM_ERROR_INVALID_LENGTH;
+ }
+
+ struct pldm_pass_component_table_resp *response =
+ (struct pldm_pass_component_table_resp *)msg->payload;
+
+ if (!is_comp_resp_valid(response->comp_resp)) {
+ return PLDM_ERROR_INVALID_DATA;
+ }
+
+ if (!is_comp_resp_code_valid(response->comp_resp_code)) {
+ return PLDM_ERROR_INVALID_DATA;
+ }
+
+ *comp_resp = response->comp_resp;
+ *comp_resp_code = response->comp_resp_code;
+
+ return PLDM_SUCCESS;
+}
+
+int encode_update_component_req(
+ uint8_t instance_id, uint16_t comp_classification, uint16_t comp_identifier,
+ uint8_t comp_classification_index, uint32_t comp_comparison_stamp,
+ uint32_t comp_image_size, bitfield32_t update_option_flags,
+ uint8_t comp_ver_str_type, uint8_t comp_ver_str_len,
+ const struct variable_field *comp_ver_str, struct pldm_msg *msg,
+ size_t payload_length)
+{
+ if (comp_ver_str == NULL || comp_ver_str->ptr == NULL || msg == NULL) {
+ return PLDM_ERROR_INVALID_DATA;
+ }
+
+ if (payload_length !=
+ sizeof(struct pldm_update_component_req) + comp_ver_str->length) {
+ return PLDM_ERROR_INVALID_LENGTH;
+ }
+
+ if (!comp_image_size) {
+ return PLDM_ERROR_INVALID_DATA;
+ }
+
+ if ((comp_ver_str_len == 0) ||
+ (comp_ver_str_len != comp_ver_str->length)) {
+ return PLDM_ERROR_INVALID_DATA;
+ }
+
+ if (!is_string_type_valid(comp_ver_str_type)) {
+ return PLDM_ERROR_INVALID_DATA;
+ }
+
+ struct pldm_header_info header = {0};
+ header.instance = instance_id;
+ header.msg_type = PLDM_REQUEST;
+ header.pldm_type = PLDM_FWUP;
+ header.command = PLDM_UPDATE_COMPONENT;
+ uint8_t rc = pack_pldm_header(&header, &(msg->hdr));
+ if (rc) {
+ return rc;
+ }
+
+ struct pldm_update_component_req *request =
+ (struct pldm_update_component_req *)msg->payload;
+
+ request->comp_classification = htole16(comp_classification);
+ request->comp_identifier = htole16(comp_identifier);
+ request->comp_classification_index = comp_classification_index;
+ request->comp_comparison_stamp = htole32(comp_comparison_stamp);
+ request->comp_image_size = htole32(comp_image_size);
+ request->update_option_flags.value = htole32(update_option_flags.value);
+ request->comp_ver_str_type = comp_ver_str_type;
+ request->comp_ver_str_len = comp_ver_str_len;
+
+ memcpy(msg->payload + sizeof(struct pldm_update_component_req),
+ comp_ver_str->ptr, comp_ver_str->length);
+
+ return PLDM_SUCCESS;
+}
+
+int decode_update_component_resp(const struct pldm_msg *msg,
+ size_t payload_length,
+ uint8_t *completion_code,
+ uint8_t *comp_compatability_resp,
+ uint8_t *comp_compatability_resp_code,
+ bitfield32_t *update_option_flags_enabled,
+ uint16_t *time_before_req_fw_data)
+{
+ if (msg == NULL || completion_code == NULL ||
+ comp_compatability_resp == NULL ||
+ comp_compatability_resp_code == NULL ||
+ update_option_flags_enabled == NULL ||
+ time_before_req_fw_data == NULL || !payload_length) {
+ return PLDM_ERROR_INVALID_DATA;
+ }
+
+ *completion_code = msg->payload[0];
+ if (*completion_code != PLDM_SUCCESS) {
+ return PLDM_SUCCESS;
+ }
+
+ if (payload_length != sizeof(struct pldm_update_component_resp)) {
+ return PLDM_ERROR_INVALID_LENGTH;
+ }
+
+ struct pldm_update_component_resp *response =
+ (struct pldm_update_component_resp *)msg->payload;
+
+ if (!is_comp_compatibility_resp_valid(
+ response->comp_compatability_resp)) {
+ return PLDM_ERROR_INVALID_DATA;
+ }
+
+ if (!is_comp_compatibility_resp_code_valid(
+ response->comp_compatability_resp_code)) {
+ return PLDM_ERROR_INVALID_DATA;
+ }
+
+ *comp_compatability_resp = response->comp_compatability_resp;
+ *comp_compatability_resp_code = response->comp_compatability_resp_code;
+ update_option_flags_enabled->value =
+ le32toh(response->update_option_flags_enabled.value);
+ *time_before_req_fw_data = le16toh(response->time_before_req_fw_data);
+
+ return PLDM_SUCCESS;
+}
+
+int decode_request_firmware_data_req(const struct pldm_msg *msg,
+ size_t payload_length, uint32_t *offset,
+ uint32_t *length)
+{
+ if (msg == NULL || offset == NULL || length == NULL) {
+ return PLDM_ERROR_INVALID_DATA;
+ }
+ if (payload_length != sizeof(struct pldm_request_firmware_data_req)) {
+ return PLDM_ERROR_INVALID_LENGTH;
+ }
+ struct pldm_request_firmware_data_req *request =
+ (struct pldm_request_firmware_data_req *)msg->payload;
+ *offset = le32toh(request->offset);
+ *length = le32toh(request->length);
+
+ if (*length < PLDM_FWUP_BASELINE_TRANSFER_SIZE) {
+ return PLDM_FWUP_INVALID_TRANSFER_LENGTH;
+ }
+
+ return PLDM_SUCCESS;
+}
+
+int encode_request_firmware_data_resp(uint8_t instance_id,
+ uint8_t completion_code,
+ struct pldm_msg *msg,
+ size_t payload_length)
+{
+ if (msg == NULL || !payload_length) {
+ return PLDM_ERROR_INVALID_DATA;
+ }
+
+ struct pldm_header_info header = {0};
+ header.instance = instance_id;
+ header.msg_type = PLDM_RESPONSE;
+ header.pldm_type = PLDM_FWUP;
+ header.command = PLDM_REQUEST_FIRMWARE_DATA;
+ uint8_t rc = pack_pldm_header(&header, &(msg->hdr));
+ if (rc) {
+ return rc;
+ }
+
+ msg->payload[0] = completion_code;
+
+ return PLDM_SUCCESS;
+}
+
+int decode_transfer_complete_req(const struct pldm_msg *msg,
+ size_t payload_length,
+ uint8_t *transfer_result)
+{
+ if (msg == NULL || transfer_result == NULL) {
+ return PLDM_ERROR_INVALID_DATA;
+ }
+
+ if (payload_length != sizeof(*transfer_result)) {
+ return PLDM_ERROR_INVALID_LENGTH;
+ }
+
+ *transfer_result = msg->payload[0];
+ return PLDM_SUCCESS;
+}
+
+int encode_transfer_complete_resp(uint8_t instance_id, uint8_t completion_code,
+ struct pldm_msg *msg, size_t payload_length)
+{
+ if (msg == NULL) {
+ return PLDM_ERROR_INVALID_DATA;
+ }
+
+ if (payload_length != sizeof(completion_code)) {
+ return PLDM_ERROR_INVALID_LENGTH;
+ }
+
+ struct pldm_header_info header = {0};
+ header.instance = instance_id;
+ header.msg_type = PLDM_RESPONSE;
+ header.pldm_type = PLDM_FWUP;
+ header.command = PLDM_TRANSFER_COMPLETE;
+ uint8_t rc = pack_pldm_header(&header, &(msg->hdr));
+ if (rc) {
+ return rc;
+ }
+
+ msg->payload[0] = completion_code;
+
+ return PLDM_SUCCESS;
+}
+
+int decode_verify_complete_req(const struct pldm_msg *msg,
+ size_t payload_length, uint8_t *verify_result)
+{
+ if (msg == NULL || verify_result == NULL) {
+ return PLDM_ERROR_INVALID_DATA;
+ }
+
+ if (payload_length != sizeof(*verify_result)) {
+ return PLDM_ERROR_INVALID_LENGTH;
+ }
+
+ *verify_result = msg->payload[0];
+ return PLDM_SUCCESS;
+}
+
+int encode_verify_complete_resp(uint8_t instance_id, uint8_t completion_code,
+ struct pldm_msg *msg, size_t payload_length)
+{
+ if (msg == NULL) {
+ return PLDM_ERROR_INVALID_DATA;
+ }
+
+ if (payload_length != sizeof(completion_code)) {
+ return PLDM_ERROR_INVALID_LENGTH;
+ }
+
+ struct pldm_header_info header = {0};
+ header.instance = instance_id;
+ header.msg_type = PLDM_RESPONSE;
+ header.pldm_type = PLDM_FWUP;
+ header.command = PLDM_VERIFY_COMPLETE;
+ uint8_t rc = pack_pldm_header(&header, &(msg->hdr));
+ if (rc) {
+ return rc;
+ }
+
+ msg->payload[0] = completion_code;
+
+ return PLDM_SUCCESS;
+}
+
+int decode_apply_complete_req(
+ const struct pldm_msg *msg, size_t payload_length, uint8_t *apply_result,
+ bitfield16_t *comp_activation_methods_modification)
+{
+ if (msg == NULL || apply_result == NULL ||
+ comp_activation_methods_modification == NULL) {
+ return PLDM_ERROR_INVALID_DATA;
+ }
+
+ if (payload_length != sizeof(struct pldm_apply_complete_req)) {
+ return PLDM_ERROR_INVALID_LENGTH;
+ }
+
+ struct pldm_apply_complete_req *request =
+ (struct pldm_apply_complete_req *)msg->payload;
+
+ *apply_result = request->apply_result;
+ comp_activation_methods_modification->value =
+ le16toh(request->comp_activation_methods_modification.value);
+
+ if ((*apply_result != PLDM_FWUP_APPLY_SUCCESS_WITH_ACTIVATION_METHOD) &&
+ comp_activation_methods_modification->value) {
+ return PLDM_ERROR_INVALID_DATA;
+ }
+
+ return PLDM_SUCCESS;
+}
+
+int encode_apply_complete_resp(uint8_t instance_id, uint8_t completion_code,
+ struct pldm_msg *msg, size_t payload_length)
+{
+ if (msg == NULL) {
+ return PLDM_ERROR_INVALID_DATA;
+ }
+
+ if (payload_length != sizeof(completion_code)) {
+ return PLDM_ERROR_INVALID_LENGTH;
+ }
+
+ struct pldm_header_info header = {0};
+ header.instance = instance_id;
+ header.msg_type = PLDM_RESPONSE;
+ header.pldm_type = PLDM_FWUP;
+ header.command = PLDM_APPLY_COMPLETE;
+ uint8_t rc = pack_pldm_header(&header, &(msg->hdr));
+ if (rc) {
+ return rc;
+ }
+
+ msg->payload[0] = completion_code;
+
+ return PLDM_SUCCESS;
+}
+
+int encode_activate_firmware_req(uint8_t instance_id,
+ bool8_t self_contained_activation_req,
+ struct pldm_msg *msg, size_t payload_length)
+{
+ if (msg == NULL) {
+ return PLDM_ERROR_INVALID_DATA;
+ }
+
+ if (payload_length != sizeof(struct pldm_activate_firmware_req)) {
+ return PLDM_ERROR_INVALID_LENGTH;
+ }
+
+ if (!is_self_contained_activation_req_valid(
+ self_contained_activation_req)) {
+ return PLDM_ERROR_INVALID_DATA;
+ }
+
+ struct pldm_header_info header = {0};
+ header.instance = instance_id;
+ header.msg_type = PLDM_REQUEST;
+ header.pldm_type = PLDM_FWUP;
+ header.command = PLDM_ACTIVATE_FIRMWARE;
+ uint8_t rc = pack_pldm_header(&header, &(msg->hdr));
+ if (rc) {
+ return rc;
+ }
+
+ struct pldm_activate_firmware_req *request =
+ (struct pldm_activate_firmware_req *)msg->payload;
+
+ request->self_contained_activation_req = self_contained_activation_req;
+
+ return PLDM_SUCCESS;
+}
+
+int decode_activate_firmware_resp(const struct pldm_msg *msg,
+ size_t payload_length,
+ uint8_t *completion_code,
+ uint16_t *estimated_time_activation)
+{
+ if (msg == NULL || completion_code == NULL ||
+ estimated_time_activation == NULL || !payload_length) {
+ return PLDM_ERROR_INVALID_DATA;
+ }
+
+ *completion_code = msg->payload[0];
+ if (*completion_code != PLDM_SUCCESS) {
+ return PLDM_SUCCESS;
+ }
+
+ if (payload_length != sizeof(struct pldm_activate_firmware_resp)) {
+ return PLDM_ERROR_INVALID_LENGTH;
+ }
+
+ struct pldm_activate_firmware_resp *response =
+ (struct pldm_activate_firmware_resp *)msg->payload;
+
+ *estimated_time_activation =
+ le16toh(response->estimated_time_activation);
+
+ return PLDM_SUCCESS;
+}
+
+int encode_get_status_req(uint8_t instance_id, struct pldm_msg *msg,
+ size_t payload_length)
+{
+ if (msg == NULL) {
+ return PLDM_ERROR_INVALID_DATA;
+ }
+
+ if (payload_length != PLDM_GET_STATUS_REQ_BYTES) {
+ return PLDM_ERROR_INVALID_LENGTH;
+ }
+
+ struct pldm_header_info header = {0};
+ header.instance = instance_id;
+ header.msg_type = PLDM_REQUEST;
+ header.pldm_type = PLDM_FWUP;
+ header.command = PLDM_GET_STATUS;
+ uint8_t rc = pack_pldm_header(&header, &(msg->hdr));
+ if (rc) {
+ return rc;
+ }
+
+ return PLDM_SUCCESS;
+}
+
+int decode_get_status_resp(const struct pldm_msg *msg, size_t payload_length,
+ uint8_t *completion_code, uint8_t *current_state,
+ uint8_t *previous_state, uint8_t *aux_state,
+ uint8_t *aux_state_status, uint8_t *progress_percent,
+ uint8_t *reason_code,
+ bitfield32_t *update_option_flags_enabled)
+{
+ if (msg == NULL || completion_code == NULL || current_state == NULL ||
+ previous_state == NULL || aux_state == NULL ||
+ aux_state_status == NULL || progress_percent == NULL ||
+ reason_code == NULL || update_option_flags_enabled == NULL ||
+ !payload_length) {
+ return PLDM_ERROR_INVALID_DATA;
+ }
+
+ *completion_code = msg->payload[0];
+ if (*completion_code != PLDM_SUCCESS) {
+ return PLDM_SUCCESS;
+ }
+
+ if (payload_length != sizeof(struct pldm_get_status_resp)) {
+ return PLDM_ERROR_INVALID_LENGTH;
+ }
+ struct pldm_get_status_resp *response =
+ (struct pldm_get_status_resp *)msg->payload;
+
+ if (!is_state_valid(response->current_state)) {
+ return PLDM_ERROR_INVALID_DATA;
+ }
+ if (!is_state_valid(response->previous_state)) {
+ return PLDM_ERROR_INVALID_DATA;
+ }
+ if (!is_aux_state_valid(response->aux_state)) {
+ return PLDM_ERROR_INVALID_DATA;
+ }
+ if (!is_aux_state_status_valid(response->aux_state_status)) {
+ return PLDM_ERROR_INVALID_DATA;
+ }
+ if (response->progress_percent > PLDM_FWUP_MAX_PROGRESS_PERCENT) {
+ return PLDM_ERROR_INVALID_DATA;
+ }
+ if (!is_reason_code_valid(response->reason_code)) {
+ return PLDM_ERROR_INVALID_DATA;
+ }
+
+ if ((response->current_state == PLDM_FD_STATE_IDLE) ||
+ (response->current_state == PLDM_FD_STATE_LEARN_COMPONENTS) ||
+ (response->current_state == PLDM_FD_STATE_READY_XFER)) {
+ if (response->aux_state !=
+ PLDM_FD_IDLE_LEARN_COMPONENTS_READ_XFER) {
+ return PLDM_ERROR_INVALID_DATA;
+ }
+ }
+
+ *current_state = response->current_state;
+ *previous_state = response->previous_state;
+ *aux_state = response->aux_state;
+ *aux_state_status = response->aux_state_status;
+ *progress_percent = response->progress_percent;
+ *reason_code = response->reason_code;
+ update_option_flags_enabled->value =
+ le32toh(response->update_option_flags_enabled.value);
+
+ return PLDM_SUCCESS;
+}
+
+int encode_cancel_update_component_req(uint8_t instance_id,
+ struct pldm_msg *msg,
+ size_t payload_length)
+{
+ if (msg == NULL) {
+ return PLDM_ERROR_INVALID_DATA;
+ }
+
+ if (payload_length != PLDM_CANCEL_UPDATE_COMPONENT_REQ_BYTES) {
+ return PLDM_ERROR_INVALID_LENGTH;
+ }
+
+ struct pldm_header_info header = {0};
+ header.instance = instance_id;
+ header.msg_type = PLDM_REQUEST;
+ header.pldm_type = PLDM_FWUP;
+ header.command = PLDM_CANCEL_UPDATE_COMPONENT;
+ uint8_t rc = pack_pldm_header(&header, &(msg->hdr));
+ if (rc) {
+ return rc;
+ }
+
+ return PLDM_SUCCESS;
+}
+
+int decode_cancel_update_component_resp(const struct pldm_msg *msg,
+ size_t payload_length,
+ uint8_t *completion_code)
+{
+ if (msg == NULL || completion_code == NULL) {
+ return PLDM_ERROR_INVALID_DATA;
+ }
+
+ if (payload_length != sizeof(*completion_code)) {
+ return PLDM_ERROR_INVALID_LENGTH;
+ }
+
+ *completion_code = msg->payload[0];
+ return PLDM_SUCCESS;
+}
+
+int encode_cancel_update_req(uint8_t instance_id, struct pldm_msg *msg,
+ size_t payload_length)
+{
+ if (msg == NULL) {
+ return PLDM_ERROR_INVALID_DATA;
+ }
+
+ if (payload_length != PLDM_CANCEL_UPDATE_REQ_BYTES) {
+ return PLDM_ERROR_INVALID_LENGTH;
+ }
+
+ struct pldm_header_info header = {0};
+ header.instance = instance_id;
+ header.msg_type = PLDM_REQUEST;
+ header.pldm_type = PLDM_FWUP;
+ header.command = PLDM_CANCEL_UPDATE;
+ uint8_t rc = pack_pldm_header(&header, &(msg->hdr));
+ if (rc) {
+ return rc;
+ }
+
+ return PLDM_SUCCESS;
+}
+
+int decode_cancel_update_resp(const struct pldm_msg *msg, size_t payload_length,
+ uint8_t *completion_code,
+ bool8_t *non_functioning_component_indication,
+ bitfield64_t *non_functioning_component_bitmap)
+{
+ if (msg == NULL || completion_code == NULL ||
+ non_functioning_component_indication == NULL ||
+ non_functioning_component_bitmap == NULL || !payload_length) {
+ return PLDM_ERROR_INVALID_DATA;
+ }
+
+ *completion_code = msg->payload[0];
+ if (*completion_code != PLDM_SUCCESS) {
+ return PLDM_SUCCESS;
+ }
+
+ if (payload_length != sizeof(struct pldm_cancel_update_resp)) {
+ return PLDM_ERROR_INVALID_LENGTH;
+ }
+ struct pldm_cancel_update_resp *response =
+ (struct pldm_cancel_update_resp *)msg->payload;
+
+ if (!is_non_functioning_component_indication_valid(
+ response->non_functioning_component_indication)) {
+ return PLDM_ERROR_INVALID_DATA;
+ }
+
+ *non_functioning_component_indication =
+ response->non_functioning_component_indication;
+
+ if (*non_functioning_component_indication) {
+ non_functioning_component_bitmap->value =
+ le64toh(response->non_functioning_component_bitmap);
+ }
+
+ return PLDM_SUCCESS;
+}