blob: d570d5c1b7bd4d4aff3422fa984ca50ad4730506 [file] [log] [blame]
Patrick Williams691668f2023-11-01 08:19:10 -05001/* SPDX-License-Identifier: Apache-2.0 OR GPL-2.0-or-later */
Andrew Jeffery830c1eb2024-10-04 10:48:10 +09302#include "api.h"
Chris Wangb6ef35b2024-07-03 09:35:42 +08003#include "dsp/base.h"
Chris Wang4c1f2c72024-03-21 17:09:44 +08004#include "msgbuf.h"
Andrew Jefferyb0c1d202023-11-07 22:08:44 +10305#include <libpldm/firmware_update.h>
6#include <libpldm/utils.h>
7
Andrew Jeffery9c766792022-08-10 23:12:49 +09308#include <endian.h>
Manojkiran Eda9a8e4972022-11-28 16:38:21 +05309#include <stdbool.h>
Andrew Jeffery9c766792022-08-10 23:12:49 +093010#include <string.h>
11
12/** @brief Check whether string type value is valid
13 *
14 * @return true if string type value is valid, false if not
15 */
16static bool is_string_type_valid(uint8_t string_type)
17{
18 switch (string_type) {
19 case PLDM_STR_TYPE_UNKNOWN:
20 return false;
21 case PLDM_STR_TYPE_ASCII:
22 case PLDM_STR_TYPE_UTF_8:
23 case PLDM_STR_TYPE_UTF_16:
24 case PLDM_STR_TYPE_UTF_16LE:
25 case PLDM_STR_TYPE_UTF_16BE:
26 return true;
27 default:
28 return false;
29 }
30}
31
32/** @brief Return the length of the descriptor type described in firmware update
33 * specification
34 *
35 * @return length of the descriptor type if descriptor type is valid else
36 * return 0
37 */
38static uint16_t get_descriptor_type_length(uint16_t descriptor_type)
39{
40 switch (descriptor_type) {
Andrew Jeffery9c766792022-08-10 23:12:49 +093041 case PLDM_FWUP_PCI_VENDOR_ID:
42 return PLDM_FWUP_PCI_VENDOR_ID_LENGTH;
43 case PLDM_FWUP_IANA_ENTERPRISE_ID:
44 return PLDM_FWUP_IANA_ENTERPRISE_ID_LENGTH;
45 case PLDM_FWUP_UUID:
46 return PLDM_FWUP_UUID_LENGTH;
47 case PLDM_FWUP_PNP_VENDOR_ID:
48 return PLDM_FWUP_PNP_VENDOR_ID_LENGTH;
49 case PLDM_FWUP_ACPI_VENDOR_ID:
50 return PLDM_FWUP_ACPI_VENDOR_ID_LENGTH;
51 case PLDM_FWUP_IEEE_ASSIGNED_COMPANY_ID:
52 return PLDM_FWUP_IEEE_ASSIGNED_COMPANY_ID_LENGTH;
53 case PLDM_FWUP_SCSI_VENDOR_ID:
54 return PLDM_FWUP_SCSI_VENDOR_ID_LENGTH;
55 case PLDM_FWUP_PCI_DEVICE_ID:
56 return PLDM_FWUP_PCI_DEVICE_ID_LENGTH;
57 case PLDM_FWUP_PCI_SUBSYSTEM_VENDOR_ID:
58 return PLDM_FWUP_PCI_SUBSYSTEM_VENDOR_ID_LENGTH;
59 case PLDM_FWUP_PCI_SUBSYSTEM_ID:
60 return PLDM_FWUP_PCI_SUBSYSTEM_ID_LENGTH;
61 case PLDM_FWUP_PCI_REVISION_ID:
62 return PLDM_FWUP_PCI_REVISION_ID_LENGTH;
63 case PLDM_FWUP_PNP_PRODUCT_IDENTIFIER:
64 return PLDM_FWUP_PNP_PRODUCT_IDENTIFIER_LENGTH;
65 case PLDM_FWUP_ACPI_PRODUCT_IDENTIFIER:
66 return PLDM_FWUP_ACPI_PRODUCT_IDENTIFIER_LENGTH;
67 case PLDM_FWUP_ASCII_MODEL_NUMBER_LONG_STRING:
68 return PLDM_FWUP_ASCII_MODEL_NUMBER_LONG_STRING_LENGTH;
69 case PLDM_FWUP_ASCII_MODEL_NUMBER_SHORT_STRING:
70 return PLDM_FWUP_ASCII_MODEL_NUMBER_SHORT_STRING_LENGTH;
71 case PLDM_FWUP_SCSI_PRODUCT_ID:
72 return PLDM_FWUP_SCSI_PRODUCT_ID_LENGTH;
73 case PLDM_FWUP_UBM_CONTROLLER_DEVICE_CODE:
74 return PLDM_FWUP_UBM_CONTROLLER_DEVICE_CODE_LENGTH;
75 default:
76 return 0;
77 }
78}
79
Chris Wang4c1f2c72024-03-21 17:09:44 +080080static bool is_downstream_device_update_support_valid(uint8_t resp)
81{
82 switch (resp) {
83 case PLDM_FWUP_DOWNSTREAM_DEVICE_UPDATE_NOT_SUPPORTED:
84 case PLDM_FWUP_DOWNSTREAM_DEVICE_UPDATE_SUPPORTED:
85 return true;
86 default:
87 return false;
88 }
89}
90
Chris Wang458475a2024-03-26 17:59:19 +080091static bool
92is_transfer_operation_flag_valid(enum transfer_op_flag transfer_op_flag)
93{
94 switch (transfer_op_flag) {
95 case PLDM_GET_NEXTPART:
96 case PLDM_GET_FIRSTPART:
97 return true;
98 default:
99 return false;
100 }
101}
102
Andrew Jeffery9c766792022-08-10 23:12:49 +0930103/** @brief Check whether ComponentResponse is valid
104 *
105 * @return true if ComponentResponse is valid, false if not
106 */
107static bool is_comp_resp_valid(uint8_t comp_resp)
108{
109 switch (comp_resp) {
110 case PLDM_CR_COMP_CAN_BE_UPDATED:
111 case PLDM_CR_COMP_MAY_BE_UPDATEABLE:
112 return true;
113
114 default:
115 return false;
116 }
117}
118
119/** @brief Check whether ComponentResponseCode is valid
120 *
121 * @return true if ComponentResponseCode is valid, false if not
122 */
123static bool is_comp_resp_code_valid(uint8_t comp_resp_code)
124{
125 switch (comp_resp_code) {
126 case PLDM_CRC_COMP_CAN_BE_UPDATED:
127 case PLDM_CRC_COMP_COMPARISON_STAMP_IDENTICAL:
128 case PLDM_CRC_COMP_COMPARISON_STAMP_LOWER:
129 case PLDM_CRC_INVALID_COMP_COMPARISON_STAMP:
130 case PLDM_CRC_COMP_CONFLICT:
131 case PLDM_CRC_COMP_PREREQUISITES_NOT_MET:
132 case PLDM_CRC_COMP_NOT_SUPPORTED:
133 case PLDM_CRC_COMP_SECURITY_RESTRICTIONS:
134 case PLDM_CRC_INCOMPLETE_COMP_IMAGE_SET:
135 case PLDM_CRC_ACTIVE_IMAGE_NOT_UPDATEABLE_SUBSEQUENTLY:
136 case PLDM_CRC_COMP_VER_STR_IDENTICAL:
137 case PLDM_CRC_COMP_VER_STR_LOWER:
138 return true;
139
140 default:
141 if (comp_resp_code >=
Andrew Jeffery37dd6a32023-05-12 16:04:06 +0930142 PLDM_CRC_VENDOR_COMP_RESP_CODE_RANGE_MIN &&
Andrew Jeffery9c766792022-08-10 23:12:49 +0930143 comp_resp_code <=
Andrew Jeffery37dd6a32023-05-12 16:04:06 +0930144 PLDM_CRC_VENDOR_COMP_RESP_CODE_RANGE_MAX) {
Andrew Jeffery9c766792022-08-10 23:12:49 +0930145 return true;
146 }
147 return false;
148 }
149}
150
151/** @brief Check whether ComponentCompatibilityResponse is valid
152 *
153 * @return true if ComponentCompatibilityResponse is valid, false if not
154 */
155static bool is_comp_compatibility_resp_valid(uint8_t comp_compatibility_resp)
156{
157 switch (comp_compatibility_resp) {
158 case PLDM_CCR_COMP_CAN_BE_UPDATED:
159 case PLDM_CCR_COMP_CANNOT_BE_UPDATED:
160 return true;
161
162 default:
163 return false;
164 }
165}
166
167/** @brief Check whether ComponentCompatibilityResponse Code is valid
168 *
169 * @return true if ComponentCompatibilityResponse Code is valid, false if not
170 */
171static bool
172is_comp_compatibility_resp_code_valid(uint8_t comp_compatibility_resp_code)
173{
174 switch (comp_compatibility_resp_code) {
175 case PLDM_CCRC_NO_RESPONSE_CODE:
176 case PLDM_CCRC_COMP_COMPARISON_STAMP_IDENTICAL:
177 case PLDM_CCRC_COMP_COMPARISON_STAMP_LOWER:
178 case PLDM_CCRC_INVALID_COMP_COMPARISON_STAMP:
179 case PLDM_CCRC_COMP_CONFLICT:
180 case PLDM_CCRC_COMP_PREREQUISITES_NOT_MET:
181 case PLDM_CCRC_COMP_NOT_SUPPORTED:
182 case PLDM_CCRC_COMP_SECURITY_RESTRICTIONS:
183 case PLDM_CRC_INCOMPLETE_COMP_IMAGE_SET:
184 case PLDM_CCRC_COMP_INFO_NO_MATCH:
185 case PLDM_CCRC_COMP_VER_STR_IDENTICAL:
186 case PLDM_CCRC_COMP_VER_STR_LOWER:
187 return true;
188
189 default:
190 if (comp_compatibility_resp_code >=
Andrew Jeffery37dd6a32023-05-12 16:04:06 +0930191 PLDM_CCRC_VENDOR_COMP_RESP_CODE_RANGE_MIN &&
Andrew Jeffery9c766792022-08-10 23:12:49 +0930192 comp_compatibility_resp_code <=
Andrew Jeffery37dd6a32023-05-12 16:04:06 +0930193 PLDM_CCRC_VENDOR_COMP_RESP_CODE_RANGE_MAX) {
Andrew Jeffery9c766792022-08-10 23:12:49 +0930194 return true;
195 }
196 return false;
197 }
198}
199
200/** @brief Check whether SelfContainedActivationRequest is valid
201 *
202 * @return true if SelfContainedActivationRequest is valid, false if not
203 */
204static bool
205is_self_contained_activation_req_valid(bool8_t self_contained_activation_req)
206{
207 switch (self_contained_activation_req) {
208 case PLDM_NOT_ACTIVATE_SELF_CONTAINED_COMPONENTS:
209 case PLDM_ACTIVATE_SELF_CONTAINED_COMPONENTS:
210 return true;
211
212 default:
213 return false;
214 }
215}
216
217/** @brief Check if current or previous status in GetStatus command response is
218 * valid
219 *
220 * @param[in] state - current or previous different state machine state of
221 * the FD
222 * @return true if state is valid, false if not
223 */
224static bool is_state_valid(uint8_t state)
225{
226 switch (state) {
227 case PLDM_FD_STATE_IDLE:
228 case PLDM_FD_STATE_LEARN_COMPONENTS:
229 case PLDM_FD_STATE_READY_XFER:
230 case PLDM_FD_STATE_DOWNLOAD:
231 case PLDM_FD_STATE_VERIFY:
232 case PLDM_FD_STATE_APPLY:
233 case PLDM_FD_STATE_ACTIVATE:
234 return true;
235
236 default:
237 return false;
238 }
239}
240
241/** @brief Check if aux state in GetStatus command response is valid
242 *
243 * @param[in] aux_state - provides additional information to the UA to describe
244 * the current operation state of the FD/FDP
245 *
246 * @return true if aux state is valid, false if not
247 */
248static bool is_aux_state_valid(uint8_t aux_state)
249{
250 switch (aux_state) {
251 case PLDM_FD_OPERATION_IN_PROGRESS:
252 case PLDM_FD_OPERATION_SUCCESSFUL:
253 case PLDM_FD_OPERATION_FAILED:
254 case PLDM_FD_IDLE_LEARN_COMPONENTS_READ_XFER:
255 return true;
256
257 default:
258 return false;
259 }
260}
261
262/** @brief Check if aux state status in GetStatus command response is valid
263 *
264 * @param[in] aux_state_status - aux state status
265 *
266 * @return true if aux state status is valid, false if not
267 */
268static bool is_aux_state_status_valid(uint8_t aux_state_status)
269{
270 if (aux_state_status == PLDM_FD_AUX_STATE_IN_PROGRESS_OR_SUCCESS ||
271 aux_state_status == PLDM_FD_TIMEOUT ||
Andrew Jeffery67f7ed92023-04-05 14:00:00 +0930272 aux_state_status == PLDM_FD_GENERIC_ERROR ||
273 (aux_state_status >= PLDM_FD_VENDOR_DEFINED_STATUS_CODE_START &&
274 aux_state_status <= PLDM_FD_VENDOR_DEFINED_STATUS_CODE_END)) {
Andrew Jeffery9c766792022-08-10 23:12:49 +0930275 return true;
276 }
277
278 return false;
279}
280
281/** @brief Check if reason code in GetStatus command response is valid
282 *
283 * @param[in] reason_code - provides the reason for why the current state
284 * entered the IDLE state
285 *
286 * @return true if reason code is valid, false if not
287 */
288static bool is_reason_code_valid(uint8_t reason_code)
289{
Andrew Jeffery9c766792022-08-10 23:12:49 +0930290 switch (reason_code) {
291 case PLDM_FD_INITIALIZATION:
292 case PLDM_FD_ACTIVATE_FW:
293 case PLDM_FD_CANCEL_UPDATE:
294 case PLDM_FD_TIMEOUT_LEARN_COMPONENT:
295 case PLDM_FD_TIMEOUT_READY_XFER:
296 case PLDM_FD_TIMEOUT_DOWNLOAD:
297 case PLDM_FD_TIMEOUT_VERIFY:
298 case PLDM_FD_TIMEOUT_APPLY:
299 return true;
300
301 default:
302 if (reason_code >= PLDM_FD_STATUS_VENDOR_DEFINED_MIN) {
303 return true;
304 }
305 return false;
306 }
307}
308
309/** @brief Check if non functioning component indication in CancelUpdate
310 * response is valid
311 *
312 * @return true if non functioning component indication is valid, false if not
313 */
314static bool is_non_functioning_component_indication_valid(
Andrew Jeffery37dd6a32023-05-12 16:04:06 +0930315 bool8_t non_functioning_component_indication)
Andrew Jeffery9c766792022-08-10 23:12:49 +0930316{
317 switch (non_functioning_component_indication) {
318 case PLDM_FWUP_COMPONENTS_FUNCTIONING:
319 case PLDM_FWUP_COMPONENTS_NOT_FUNCTIONING:
320 return true;
321
322 default:
323 return false;
324 }
325}
326
Andrew Jeffery9d2a1c62023-06-05 13:02:16 +0930327LIBPLDM_ABI_STABLE
Andrew Jeffery9c766792022-08-10 23:12:49 +0930328int decode_pldm_package_header_info(
Andrew Jeffery37dd6a32023-05-12 16:04:06 +0930329 const uint8_t *data, size_t length,
330 struct pldm_package_header_information *package_header_info,
331 struct variable_field *package_version_str)
Andrew Jeffery9c766792022-08-10 23:12:49 +0930332{
333 if (data == NULL || package_header_info == NULL ||
334 package_version_str == NULL) {
335 return PLDM_ERROR_INVALID_DATA;
336 }
337
338 if (length < sizeof(struct pldm_package_header_information)) {
339 return PLDM_ERROR_INVALID_LENGTH;
340 }
341
342 struct pldm_package_header_information *data_header =
Andrew Jeffery37dd6a32023-05-12 16:04:06 +0930343 (struct pldm_package_header_information *)(data);
Andrew Jeffery9c766792022-08-10 23:12:49 +0930344
345 if (!is_string_type_valid(data_header->package_version_string_type) ||
346 (data_header->package_version_string_length == 0)) {
347 return PLDM_ERROR_INVALID_DATA;
348 }
349
350 if (length < sizeof(struct pldm_package_header_information) +
Andrew Jeffery37dd6a32023-05-12 16:04:06 +0930351 data_header->package_version_string_length) {
Andrew Jeffery9c766792022-08-10 23:12:49 +0930352 return PLDM_ERROR_INVALID_LENGTH;
353 }
354
355 if ((data_header->component_bitmap_bit_length %
356 PLDM_FWUP_COMPONENT_BITMAP_MULTIPLE) != 0) {
357 return PLDM_ERROR_INVALID_DATA;
358 }
359
360 memcpy(package_header_info->uuid, data_header->uuid,
361 sizeof(data_header->uuid));
362 package_header_info->package_header_format_version =
Andrew Jeffery37dd6a32023-05-12 16:04:06 +0930363 data_header->package_header_format_version;
Andrew Jeffery9c766792022-08-10 23:12:49 +0930364 package_header_info->package_header_size =
Andrew Jeffery37dd6a32023-05-12 16:04:06 +0930365 le16toh(data_header->package_header_size);
Andrew Jeffery9c766792022-08-10 23:12:49 +0930366 memcpy(package_header_info->package_release_date_time,
367 data_header->package_release_date_time,
368 sizeof(data_header->package_release_date_time));
369 package_header_info->component_bitmap_bit_length =
Andrew Jeffery37dd6a32023-05-12 16:04:06 +0930370 le16toh(data_header->component_bitmap_bit_length);
Andrew Jeffery9c766792022-08-10 23:12:49 +0930371 package_header_info->package_version_string_type =
Andrew Jeffery37dd6a32023-05-12 16:04:06 +0930372 data_header->package_version_string_type;
Andrew Jeffery9c766792022-08-10 23:12:49 +0930373 package_header_info->package_version_string_length =
Andrew Jeffery37dd6a32023-05-12 16:04:06 +0930374 data_header->package_version_string_length;
Andrew Jeffery9c766792022-08-10 23:12:49 +0930375 package_version_str->ptr =
Andrew Jeffery37dd6a32023-05-12 16:04:06 +0930376 data + sizeof(struct pldm_package_header_information);
Andrew Jeffery9c766792022-08-10 23:12:49 +0930377 package_version_str->length =
Andrew Jeffery37dd6a32023-05-12 16:04:06 +0930378 package_header_info->package_version_string_length;
Andrew Jeffery9c766792022-08-10 23:12:49 +0930379
380 return PLDM_SUCCESS;
381}
382
Andrew Jeffery9d2a1c62023-06-05 13:02:16 +0930383LIBPLDM_ABI_STABLE
Andrew Jeffery9c766792022-08-10 23:12:49 +0930384int decode_firmware_device_id_record(
Andrew Jeffery37dd6a32023-05-12 16:04:06 +0930385 const uint8_t *data, size_t length,
386 uint16_t component_bitmap_bit_length,
387 struct pldm_firmware_device_id_record *fw_device_id_record,
388 struct variable_field *applicable_components,
389 struct variable_field *comp_image_set_version_str,
390 struct variable_field *record_descriptors,
391 struct variable_field *fw_device_pkg_data)
Andrew Jeffery9c766792022-08-10 23:12:49 +0930392{
393 if (data == NULL || fw_device_id_record == NULL ||
394 applicable_components == NULL ||
395 comp_image_set_version_str == NULL || record_descriptors == NULL ||
396 fw_device_pkg_data == NULL) {
397 return PLDM_ERROR_INVALID_DATA;
398 }
399
400 if (length < sizeof(struct pldm_firmware_device_id_record)) {
401 return PLDM_ERROR_INVALID_LENGTH;
402 }
403
404 if ((component_bitmap_bit_length %
405 PLDM_FWUP_COMPONENT_BITMAP_MULTIPLE) != 0) {
406 return PLDM_ERROR_INVALID_DATA;
407 }
408
409 struct pldm_firmware_device_id_record *data_record =
Andrew Jeffery37dd6a32023-05-12 16:04:06 +0930410 (struct pldm_firmware_device_id_record *)(data);
Andrew Jeffery9c766792022-08-10 23:12:49 +0930411
412 if (!is_string_type_valid(
Andrew Jeffery37dd6a32023-05-12 16:04:06 +0930413 data_record->comp_image_set_version_string_type) ||
Andrew Jeffery9c766792022-08-10 23:12:49 +0930414 (data_record->comp_image_set_version_string_length == 0)) {
415 return PLDM_ERROR_INVALID_DATA;
416 }
417
418 fw_device_id_record->record_length =
Andrew Jeffery37dd6a32023-05-12 16:04:06 +0930419 le16toh(data_record->record_length);
Andrew Jeffery9c766792022-08-10 23:12:49 +0930420 fw_device_id_record->descriptor_count = data_record->descriptor_count;
421 fw_device_id_record->device_update_option_flags.value =
Andrew Jeffery37dd6a32023-05-12 16:04:06 +0930422 le32toh(data_record->device_update_option_flags.value);
Andrew Jeffery9c766792022-08-10 23:12:49 +0930423 fw_device_id_record->comp_image_set_version_string_type =
Andrew Jeffery37dd6a32023-05-12 16:04:06 +0930424 data_record->comp_image_set_version_string_type;
Andrew Jeffery9c766792022-08-10 23:12:49 +0930425 fw_device_id_record->comp_image_set_version_string_length =
Andrew Jeffery37dd6a32023-05-12 16:04:06 +0930426 data_record->comp_image_set_version_string_length;
Andrew Jeffery9c766792022-08-10 23:12:49 +0930427 fw_device_id_record->fw_device_pkg_data_length =
Andrew Jeffery37dd6a32023-05-12 16:04:06 +0930428 le16toh(data_record->fw_device_pkg_data_length);
Andrew Jeffery9c766792022-08-10 23:12:49 +0930429
430 if (length < fw_device_id_record->record_length) {
431 return PLDM_ERROR_INVALID_LENGTH;
432 }
433
434 uint16_t applicable_components_length =
Andrew Jeffery37dd6a32023-05-12 16:04:06 +0930435 component_bitmap_bit_length /
436 PLDM_FWUP_COMPONENT_BITMAP_MULTIPLE;
Andrew Jeffery9c766792022-08-10 23:12:49 +0930437 uint16_t calc_min_record_length =
Andrew Jeffery37dd6a32023-05-12 16:04:06 +0930438 sizeof(struct pldm_firmware_device_id_record) +
439 applicable_components_length +
440 data_record->comp_image_set_version_string_length +
441 PLDM_FWUP_DEVICE_DESCRIPTOR_MIN_LEN +
442 fw_device_id_record->fw_device_pkg_data_length;
Andrew Jeffery9c766792022-08-10 23:12:49 +0930443
444 if (fw_device_id_record->record_length < calc_min_record_length) {
445 return PLDM_ERROR_INVALID_LENGTH;
446 }
447
448 applicable_components->ptr =
Andrew Jeffery37dd6a32023-05-12 16:04:06 +0930449 data + sizeof(struct pldm_firmware_device_id_record);
Andrew Jeffery9c766792022-08-10 23:12:49 +0930450 applicable_components->length = applicable_components_length;
451
452 comp_image_set_version_str->ptr =
Andrew Jeffery37dd6a32023-05-12 16:04:06 +0930453 applicable_components->ptr + applicable_components->length;
Andrew Jeffery9c766792022-08-10 23:12:49 +0930454 comp_image_set_version_str->length =
Andrew Jeffery37dd6a32023-05-12 16:04:06 +0930455 fw_device_id_record->comp_image_set_version_string_length;
Andrew Jeffery9c766792022-08-10 23:12:49 +0930456
457 record_descriptors->ptr = comp_image_set_version_str->ptr +
458 comp_image_set_version_str->length;
459 record_descriptors->length =
Andrew Jeffery37dd6a32023-05-12 16:04:06 +0930460 fw_device_id_record->record_length -
461 sizeof(struct pldm_firmware_device_id_record) -
462 applicable_components_length -
463 fw_device_id_record->comp_image_set_version_string_length -
464 fw_device_id_record->fw_device_pkg_data_length;
Andrew Jeffery9c766792022-08-10 23:12:49 +0930465
466 if (fw_device_id_record->fw_device_pkg_data_length) {
467 fw_device_pkg_data->ptr =
Andrew Jeffery37dd6a32023-05-12 16:04:06 +0930468 record_descriptors->ptr + record_descriptors->length;
Andrew Jeffery9c766792022-08-10 23:12:49 +0930469 fw_device_pkg_data->length =
Andrew Jeffery37dd6a32023-05-12 16:04:06 +0930470 fw_device_id_record->fw_device_pkg_data_length;
Andrew Jeffery9c766792022-08-10 23:12:49 +0930471 }
472
473 return PLDM_SUCCESS;
474}
475
Andrew Jeffery3a2c6582024-11-07 16:30:36 +1030476LIBPLDM_ABI_TESTING
477int decode_pldm_descriptor_from_iter(struct pldm_descriptor_iter *iter,
478 struct pldm_descriptor *desc)
479{
480 struct pldm_msgbuf _buf;
481 struct pldm_msgbuf *buf = &_buf;
482 int rc;
483
484 if (!iter || !iter->field || !desc) {
485 return -EINVAL;
486 }
487
488 rc = pldm_msgbuf_init_errno(buf, PLDM_FWUP_DEVICE_DESCRIPTOR_MIN_LEN,
489 iter->field->ptr, iter->field->length);
490 if (rc) {
491 return rc;
492 }
493
494 pldm_msgbuf_extract(buf, desc->descriptor_type);
495 rc = pldm_msgbuf_extract(buf, desc->descriptor_length);
496 if (rc) {
497 return rc;
498 }
499
500 desc->descriptor_data = NULL;
501 pldm_msgbuf_span_required(buf, desc->descriptor_length,
502 (void **)&desc->descriptor_data);
503 iter->field->ptr = NULL;
504 pldm_msgbuf_span_remaining(buf, (void **)&iter->field->ptr,
505 &iter->field->length);
506
507 return pldm_msgbuf_destroy(buf);
508}
509
Andrew Jeffery9d2a1c62023-06-05 13:02:16 +0930510LIBPLDM_ABI_STABLE
Andrew Jeffery9c766792022-08-10 23:12:49 +0930511int decode_descriptor_type_length_value(const uint8_t *data, size_t length,
512 uint16_t *descriptor_type,
513 struct variable_field *descriptor_data)
514{
515 uint16_t descriptor_length = 0;
516
517 if (data == NULL || descriptor_type == NULL ||
518 descriptor_data == NULL) {
519 return PLDM_ERROR_INVALID_DATA;
520 }
521
522 if (length < PLDM_FWUP_DEVICE_DESCRIPTOR_MIN_LEN) {
523 return PLDM_ERROR_INVALID_LENGTH;
524 }
525
526 struct pldm_descriptor_tlv *entry =
Andrew Jeffery37dd6a32023-05-12 16:04:06 +0930527 (struct pldm_descriptor_tlv *)(data);
Andrew Jeffery9c766792022-08-10 23:12:49 +0930528
529 *descriptor_type = le16toh(entry->descriptor_type);
530 descriptor_length = le16toh(entry->descriptor_length);
531 if (*descriptor_type != PLDM_FWUP_VENDOR_DEFINED) {
532 if (descriptor_length !=
533 get_descriptor_type_length(*descriptor_type)) {
534 return PLDM_ERROR_INVALID_LENGTH;
535 }
536 }
537
538 if (length < (sizeof(*descriptor_type) + sizeof(descriptor_length) +
539 descriptor_length)) {
540 return PLDM_ERROR_INVALID_LENGTH;
541 }
542
543 descriptor_data->ptr = entry->descriptor_data;
544 descriptor_data->length = descriptor_length;
545
546 return PLDM_SUCCESS;
547}
548
Andrew Jeffery9d2a1c62023-06-05 13:02:16 +0930549LIBPLDM_ABI_STABLE
Andrew Jeffery9c766792022-08-10 23:12:49 +0930550int decode_vendor_defined_descriptor_value(
Andrew Jeffery37dd6a32023-05-12 16:04:06 +0930551 const uint8_t *data, size_t length, uint8_t *descriptor_title_str_type,
552 struct variable_field *descriptor_title_str,
553 struct variable_field *descriptor_data)
Andrew Jeffery9c766792022-08-10 23:12:49 +0930554{
555 if (data == NULL || descriptor_title_str_type == NULL ||
556 descriptor_title_str == NULL || descriptor_data == NULL) {
557 return PLDM_ERROR_INVALID_DATA;
558 }
559
560 if (length < sizeof(struct pldm_vendor_defined_descriptor_title_data)) {
561 return PLDM_ERROR_INVALID_LENGTH;
562 }
563
564 struct pldm_vendor_defined_descriptor_title_data *entry =
Andrew Jeffery37dd6a32023-05-12 16:04:06 +0930565 (struct pldm_vendor_defined_descriptor_title_data *)(data);
Andrew Jeffery9c766792022-08-10 23:12:49 +0930566 if (!is_string_type_valid(
Andrew Jeffery37dd6a32023-05-12 16:04:06 +0930567 entry->vendor_defined_descriptor_title_str_type) ||
Andrew Jeffery9c766792022-08-10 23:12:49 +0930568 (entry->vendor_defined_descriptor_title_str_len == 0)) {
569 return PLDM_ERROR_INVALID_DATA;
570 }
571
Manojkiran Eda9e3a5d42024-06-17 16:06:42 +0530572 // Assuming at least 1 byte of VendorDefinedDescriptorData
Andrew Jeffery9c766792022-08-10 23:12:49 +0930573 if (length < (sizeof(struct pldm_vendor_defined_descriptor_title_data) +
574 entry->vendor_defined_descriptor_title_str_len)) {
575 return PLDM_ERROR_INVALID_LENGTH;
576 }
577
578 *descriptor_title_str_type =
Andrew Jeffery37dd6a32023-05-12 16:04:06 +0930579 entry->vendor_defined_descriptor_title_str_type;
Andrew Jeffery9c766792022-08-10 23:12:49 +0930580 descriptor_title_str->ptr = entry->vendor_defined_descriptor_title_str;
581 descriptor_title_str->length =
Andrew Jeffery37dd6a32023-05-12 16:04:06 +0930582 entry->vendor_defined_descriptor_title_str_len;
Andrew Jeffery9c766792022-08-10 23:12:49 +0930583
584 descriptor_data->ptr =
Andrew Jeffery37dd6a32023-05-12 16:04:06 +0930585 descriptor_title_str->ptr + descriptor_title_str->length;
Andrew Jeffery9c766792022-08-10 23:12:49 +0930586 descriptor_data->length =
Andrew Jeffery37dd6a32023-05-12 16:04:06 +0930587 length -
588 sizeof(entry->vendor_defined_descriptor_title_str_type) -
589 sizeof(entry->vendor_defined_descriptor_title_str_len) -
590 descriptor_title_str->length;
Andrew Jeffery9c766792022-08-10 23:12:49 +0930591
592 return PLDM_SUCCESS;
593}
594
Andrew Jeffery9d2a1c62023-06-05 13:02:16 +0930595LIBPLDM_ABI_STABLE
Andrew Jeffery9c766792022-08-10 23:12:49 +0930596int decode_pldm_comp_image_info(
Andrew Jeffery37dd6a32023-05-12 16:04:06 +0930597 const uint8_t *data, size_t length,
598 struct pldm_component_image_information *pldm_comp_image_info,
599 struct variable_field *comp_version_str)
Andrew Jeffery9c766792022-08-10 23:12:49 +0930600{
601 if (data == NULL || pldm_comp_image_info == NULL ||
602 comp_version_str == NULL) {
603 return PLDM_ERROR_INVALID_DATA;
604 }
605
606 if (length < sizeof(struct pldm_component_image_information)) {
607 return PLDM_ERROR_INVALID_LENGTH;
608 }
609
610 struct pldm_component_image_information *data_header =
Andrew Jeffery37dd6a32023-05-12 16:04:06 +0930611 (struct pldm_component_image_information *)(data);
Andrew Jeffery9c766792022-08-10 23:12:49 +0930612
613 if (!is_string_type_valid(data_header->comp_version_string_type) ||
614 (data_header->comp_version_string_length == 0)) {
615 return PLDM_ERROR_INVALID_DATA;
616 }
617
618 if (length < sizeof(struct pldm_component_image_information) +
Andrew Jeffery37dd6a32023-05-12 16:04:06 +0930619 data_header->comp_version_string_length) {
Andrew Jeffery9c766792022-08-10 23:12:49 +0930620 return PLDM_ERROR_INVALID_LENGTH;
621 }
622
623 pldm_comp_image_info->comp_classification =
Andrew Jeffery37dd6a32023-05-12 16:04:06 +0930624 le16toh(data_header->comp_classification);
Andrew Jeffery9c766792022-08-10 23:12:49 +0930625 pldm_comp_image_info->comp_identifier =
Andrew Jeffery37dd6a32023-05-12 16:04:06 +0930626 le16toh(data_header->comp_identifier);
Andrew Jeffery9c766792022-08-10 23:12:49 +0930627 pldm_comp_image_info->comp_comparison_stamp =
Andrew Jeffery37dd6a32023-05-12 16:04:06 +0930628 le32toh(data_header->comp_comparison_stamp);
Andrew Jeffery9c766792022-08-10 23:12:49 +0930629 pldm_comp_image_info->comp_options.value =
Andrew Jeffery37dd6a32023-05-12 16:04:06 +0930630 le16toh(data_header->comp_options.value);
Andrew Jeffery9c766792022-08-10 23:12:49 +0930631 pldm_comp_image_info->requested_comp_activation_method.value =
Andrew Jeffery37dd6a32023-05-12 16:04:06 +0930632 le16toh(data_header->requested_comp_activation_method.value);
Andrew Jeffery9c766792022-08-10 23:12:49 +0930633 pldm_comp_image_info->comp_location_offset =
Andrew Jeffery37dd6a32023-05-12 16:04:06 +0930634 le32toh(data_header->comp_location_offset);
Andrew Jeffery9c766792022-08-10 23:12:49 +0930635 pldm_comp_image_info->comp_size = le32toh(data_header->comp_size);
636 pldm_comp_image_info->comp_version_string_type =
Andrew Jeffery37dd6a32023-05-12 16:04:06 +0930637 data_header->comp_version_string_type;
Andrew Jeffery9c766792022-08-10 23:12:49 +0930638 pldm_comp_image_info->comp_version_string_length =
Andrew Jeffery37dd6a32023-05-12 16:04:06 +0930639 data_header->comp_version_string_length;
Andrew Jeffery9c766792022-08-10 23:12:49 +0930640
641 if ((pldm_comp_image_info->comp_options.bits.bit1 == false &&
642 pldm_comp_image_info->comp_comparison_stamp !=
Andrew Jeffery37dd6a32023-05-12 16:04:06 +0930643 PLDM_FWUP_INVALID_COMPONENT_COMPARISON_TIMESTAMP)) {
Andrew Jeffery9c766792022-08-10 23:12:49 +0930644 return PLDM_ERROR_INVALID_DATA;
645 }
646
647 if (pldm_comp_image_info->comp_location_offset == 0 ||
648 pldm_comp_image_info->comp_size == 0) {
649 return PLDM_ERROR_INVALID_DATA;
650 }
651
652 comp_version_str->ptr =
Andrew Jeffery37dd6a32023-05-12 16:04:06 +0930653 data + sizeof(struct pldm_component_image_information);
Andrew Jeffery9c766792022-08-10 23:12:49 +0930654 comp_version_str->length =
Andrew Jeffery37dd6a32023-05-12 16:04:06 +0930655 pldm_comp_image_info->comp_version_string_length;
Andrew Jeffery9c766792022-08-10 23:12:49 +0930656
657 return PLDM_SUCCESS;
658}
659
Andrew Jeffery9d2a1c62023-06-05 13:02:16 +0930660LIBPLDM_ABI_STABLE
Andrew Jeffery9c766792022-08-10 23:12:49 +0930661int encode_query_device_identifiers_req(uint8_t instance_id,
662 size_t payload_length,
663 struct pldm_msg *msg)
664{
665 if (msg == NULL) {
666 return PLDM_ERROR_INVALID_DATA;
667 }
668
669 if (payload_length != PLDM_QUERY_DEVICE_IDENTIFIERS_REQ_BYTES) {
670 return PLDM_ERROR_INVALID_LENGTH;
671 }
672
673 return encode_pldm_header_only(PLDM_REQUEST, instance_id, PLDM_FWUP,
674 PLDM_QUERY_DEVICE_IDENTIFIERS, msg);
675}
676
Andrew Jeffery9d2a1c62023-06-05 13:02:16 +0930677LIBPLDM_ABI_STABLE
Andrew Jeffery9c766792022-08-10 23:12:49 +0930678int decode_query_device_identifiers_resp(const struct pldm_msg *msg,
679 size_t payload_length,
680 uint8_t *completion_code,
681 uint32_t *device_identifiers_len,
682 uint8_t *descriptor_count,
683 uint8_t **descriptor_data)
684{
685 if (msg == NULL || completion_code == NULL ||
686 device_identifiers_len == NULL || descriptor_count == NULL ||
687 descriptor_data == NULL) {
688 return PLDM_ERROR_INVALID_DATA;
689 }
690
691 *completion_code = msg->payload[0];
692 if (PLDM_SUCCESS != *completion_code) {
693 return PLDM_SUCCESS;
694 }
695
696 if (payload_length <
697 sizeof(struct pldm_query_device_identifiers_resp)) {
698 return PLDM_ERROR_INVALID_LENGTH;
699 }
700
701 struct pldm_query_device_identifiers_resp *response =
Andrew Jeffery37dd6a32023-05-12 16:04:06 +0930702 (struct pldm_query_device_identifiers_resp *)msg->payload;
Andrew Jeffery9c766792022-08-10 23:12:49 +0930703 *device_identifiers_len = le32toh(response->device_identifiers_len);
704
705 if (*device_identifiers_len < PLDM_FWUP_DEVICE_DESCRIPTOR_MIN_LEN) {
706 return PLDM_ERROR_INVALID_LENGTH;
707 }
708
709 if (payload_length !=
710 sizeof(struct pldm_query_device_identifiers_resp) +
Andrew Jeffery37dd6a32023-05-12 16:04:06 +0930711 *device_identifiers_len) {
Andrew Jeffery9c766792022-08-10 23:12:49 +0930712 return PLDM_ERROR_INVALID_LENGTH;
713 }
714 *descriptor_count = response->descriptor_count;
715
716 if (*descriptor_count == 0) {
717 return PLDM_ERROR_INVALID_DATA;
718 }
719 *descriptor_data =
Andrew Jeffery37dd6a32023-05-12 16:04:06 +0930720 (uint8_t *)(msg->payload +
721 sizeof(struct pldm_query_device_identifiers_resp));
Andrew Jeffery9c766792022-08-10 23:12:49 +0930722 return PLDM_SUCCESS;
723}
724
Andrew Jeffery9d2a1c62023-06-05 13:02:16 +0930725LIBPLDM_ABI_STABLE
Andrew Jeffery9c766792022-08-10 23:12:49 +0930726int encode_get_firmware_parameters_req(uint8_t instance_id,
727 size_t payload_length,
728 struct pldm_msg *msg)
729{
730 if (msg == NULL) {
731 return PLDM_ERROR_INVALID_DATA;
732 }
733
734 if (payload_length != PLDM_GET_FIRMWARE_PARAMETERS_REQ_BYTES) {
735 return PLDM_ERROR_INVALID_LENGTH;
736 }
737
738 return encode_pldm_header_only(PLDM_REQUEST, instance_id, PLDM_FWUP,
739 PLDM_GET_FIRMWARE_PARAMETERS, msg);
740}
741
Andrew Jeffery9d2a1c62023-06-05 13:02:16 +0930742LIBPLDM_ABI_STABLE
Andrew Jeffery9c766792022-08-10 23:12:49 +0930743int decode_get_firmware_parameters_resp(
Andrew Jeffery37dd6a32023-05-12 16:04:06 +0930744 const struct pldm_msg *msg, size_t payload_length,
745 struct pldm_get_firmware_parameters_resp *resp_data,
746 struct variable_field *active_comp_image_set_ver_str,
747 struct variable_field *pending_comp_image_set_ver_str,
748 struct variable_field *comp_parameter_table)
Andrew Jeffery9c766792022-08-10 23:12:49 +0930749{
750 if (msg == NULL || resp_data == NULL ||
751 active_comp_image_set_ver_str == NULL ||
752 pending_comp_image_set_ver_str == NULL ||
753 comp_parameter_table == NULL || !payload_length) {
754 return PLDM_ERROR_INVALID_DATA;
755 }
756
757 resp_data->completion_code = msg->payload[0];
758 if (PLDM_SUCCESS != resp_data->completion_code) {
759 return PLDM_SUCCESS;
760 }
761
762 if (payload_length < sizeof(struct pldm_get_firmware_parameters_resp)) {
763 return PLDM_ERROR_INVALID_LENGTH;
764 }
765
766 struct pldm_get_firmware_parameters_resp *response =
Andrew Jeffery37dd6a32023-05-12 16:04:06 +0930767 (struct pldm_get_firmware_parameters_resp *)msg->payload;
Andrew Jeffery9c766792022-08-10 23:12:49 +0930768
769 if (!is_string_type_valid(
Andrew Jeffery37dd6a32023-05-12 16:04:06 +0930770 response->active_comp_image_set_ver_str_type) ||
Andrew Jeffery9c766792022-08-10 23:12:49 +0930771 (response->active_comp_image_set_ver_str_len == 0)) {
772 return PLDM_ERROR_INVALID_DATA;
773 }
774
775 if (response->pending_comp_image_set_ver_str_len == 0) {
776 if (response->pending_comp_image_set_ver_str_type !=
777 PLDM_STR_TYPE_UNKNOWN) {
778 return PLDM_ERROR_INVALID_DATA;
779 }
780 } else {
781 if (!is_string_type_valid(
Andrew Jeffery37dd6a32023-05-12 16:04:06 +0930782 response->pending_comp_image_set_ver_str_type)) {
Andrew Jeffery9c766792022-08-10 23:12:49 +0930783 return PLDM_ERROR_INVALID_DATA;
784 }
785 }
786
787 size_t partial_response_length =
Andrew Jeffery37dd6a32023-05-12 16:04:06 +0930788 sizeof(struct pldm_get_firmware_parameters_resp) +
789 response->active_comp_image_set_ver_str_len +
790 response->pending_comp_image_set_ver_str_len;
Andrew Jeffery9c766792022-08-10 23:12:49 +0930791
792 if (payload_length < partial_response_length) {
793 return PLDM_ERROR_INVALID_LENGTH;
794 }
795
796 resp_data->capabilities_during_update.value =
Andrew Jeffery37dd6a32023-05-12 16:04:06 +0930797 le32toh(response->capabilities_during_update.value);
Andrew Jeffery9c766792022-08-10 23:12:49 +0930798 resp_data->comp_count = le16toh(response->comp_count);
799 resp_data->active_comp_image_set_ver_str_type =
Andrew Jeffery37dd6a32023-05-12 16:04:06 +0930800 response->active_comp_image_set_ver_str_type;
Andrew Jeffery9c766792022-08-10 23:12:49 +0930801 resp_data->active_comp_image_set_ver_str_len =
Andrew Jeffery37dd6a32023-05-12 16:04:06 +0930802 response->active_comp_image_set_ver_str_len;
Andrew Jeffery9c766792022-08-10 23:12:49 +0930803 resp_data->pending_comp_image_set_ver_str_type =
Andrew Jeffery37dd6a32023-05-12 16:04:06 +0930804 response->pending_comp_image_set_ver_str_type;
Andrew Jeffery9c766792022-08-10 23:12:49 +0930805 resp_data->pending_comp_image_set_ver_str_len =
Andrew Jeffery37dd6a32023-05-12 16:04:06 +0930806 response->pending_comp_image_set_ver_str_len;
Andrew Jeffery9c766792022-08-10 23:12:49 +0930807
808 active_comp_image_set_ver_str->ptr =
Andrew Jeffery37dd6a32023-05-12 16:04:06 +0930809 msg->payload + sizeof(struct pldm_get_firmware_parameters_resp);
Andrew Jeffery9c766792022-08-10 23:12:49 +0930810 active_comp_image_set_ver_str->length =
Andrew Jeffery37dd6a32023-05-12 16:04:06 +0930811 resp_data->active_comp_image_set_ver_str_len;
Andrew Jeffery9c766792022-08-10 23:12:49 +0930812
813 if (resp_data->pending_comp_image_set_ver_str_len != 0) {
814 pending_comp_image_set_ver_str->ptr =
Andrew Jeffery37dd6a32023-05-12 16:04:06 +0930815 msg->payload +
816 sizeof(struct pldm_get_firmware_parameters_resp) +
817 resp_data->active_comp_image_set_ver_str_len;
Andrew Jeffery9c766792022-08-10 23:12:49 +0930818 pending_comp_image_set_ver_str->length =
Andrew Jeffery37dd6a32023-05-12 16:04:06 +0930819 resp_data->pending_comp_image_set_ver_str_len;
Andrew Jeffery9c766792022-08-10 23:12:49 +0930820 } else {
821 pending_comp_image_set_ver_str->ptr = NULL;
822 pending_comp_image_set_ver_str->length = 0;
823 }
824
825 if (payload_length > partial_response_length && resp_data->comp_count) {
826 comp_parameter_table->ptr =
Andrew Jeffery37dd6a32023-05-12 16:04:06 +0930827 msg->payload +
828 sizeof(struct pldm_get_firmware_parameters_resp) +
829 resp_data->active_comp_image_set_ver_str_len +
830 resp_data->pending_comp_image_set_ver_str_len;
Andrew Jeffery9c766792022-08-10 23:12:49 +0930831 comp_parameter_table->length =
Andrew Jeffery37dd6a32023-05-12 16:04:06 +0930832 payload_length - partial_response_length;
Andrew Jeffery9c766792022-08-10 23:12:49 +0930833 } else {
834 comp_parameter_table->ptr = NULL;
835 comp_parameter_table->length = 0;
836 }
837
838 return PLDM_SUCCESS;
839}
840
Andrew Jeffery9d2a1c62023-06-05 13:02:16 +0930841LIBPLDM_ABI_STABLE
Andrew Jeffery9c766792022-08-10 23:12:49 +0930842int decode_get_firmware_parameters_resp_comp_entry(
Andrew Jeffery37dd6a32023-05-12 16:04:06 +0930843 const uint8_t *data, size_t length,
844 struct pldm_component_parameter_entry *component_data,
845 struct variable_field *active_comp_ver_str,
846 struct variable_field *pending_comp_ver_str)
Andrew Jeffery9c766792022-08-10 23:12:49 +0930847{
848 if (data == NULL || component_data == NULL ||
849 active_comp_ver_str == NULL || pending_comp_ver_str == NULL) {
850 return PLDM_ERROR_INVALID_DATA;
851 }
852
853 if (length < sizeof(struct pldm_component_parameter_entry)) {
854 return PLDM_ERROR_INVALID_LENGTH;
855 }
856
857 struct pldm_component_parameter_entry *entry =
Andrew Jeffery37dd6a32023-05-12 16:04:06 +0930858 (struct pldm_component_parameter_entry *)(data);
Andrew Jeffery9c766792022-08-10 23:12:49 +0930859
860 size_t entry_length = sizeof(struct pldm_component_parameter_entry) +
861 entry->active_comp_ver_str_len +
862 entry->pending_comp_ver_str_len;
863
864 if (length < entry_length) {
865 return PLDM_ERROR_INVALID_LENGTH;
866 }
867
868 component_data->comp_classification =
Andrew Jeffery37dd6a32023-05-12 16:04:06 +0930869 le16toh(entry->comp_classification);
Andrew Jeffery9c766792022-08-10 23:12:49 +0930870 component_data->comp_identifier = le16toh(entry->comp_identifier);
871 component_data->comp_classification_index =
Andrew Jeffery37dd6a32023-05-12 16:04:06 +0930872 entry->comp_classification_index;
Andrew Jeffery9c766792022-08-10 23:12:49 +0930873 component_data->active_comp_comparison_stamp =
Andrew Jeffery37dd6a32023-05-12 16:04:06 +0930874 le32toh(entry->active_comp_comparison_stamp);
Andrew Jeffery9c766792022-08-10 23:12:49 +0930875 component_data->active_comp_ver_str_type =
Andrew Jeffery37dd6a32023-05-12 16:04:06 +0930876 entry->active_comp_ver_str_type;
Andrew Jeffery9c766792022-08-10 23:12:49 +0930877 component_data->active_comp_ver_str_len =
Andrew Jeffery37dd6a32023-05-12 16:04:06 +0930878 entry->active_comp_ver_str_len;
Andrew Jeffery9c766792022-08-10 23:12:49 +0930879 memcpy(component_data->active_comp_release_date,
880 entry->active_comp_release_date,
881 sizeof(entry->active_comp_release_date));
882 component_data->pending_comp_comparison_stamp =
Andrew Jeffery37dd6a32023-05-12 16:04:06 +0930883 le32toh(entry->pending_comp_comparison_stamp);
Andrew Jeffery9c766792022-08-10 23:12:49 +0930884 component_data->pending_comp_ver_str_type =
Andrew Jeffery37dd6a32023-05-12 16:04:06 +0930885 entry->pending_comp_ver_str_type;
Andrew Jeffery9c766792022-08-10 23:12:49 +0930886 component_data->pending_comp_ver_str_len =
Andrew Jeffery37dd6a32023-05-12 16:04:06 +0930887 entry->pending_comp_ver_str_len;
Andrew Jeffery9c766792022-08-10 23:12:49 +0930888 memcpy(component_data->pending_comp_release_date,
889 entry->pending_comp_release_date,
890 sizeof(entry->pending_comp_release_date));
891 component_data->comp_activation_methods.value =
Andrew Jeffery37dd6a32023-05-12 16:04:06 +0930892 le16toh(entry->comp_activation_methods.value);
Andrew Jeffery9c766792022-08-10 23:12:49 +0930893 component_data->capabilities_during_update.value =
Andrew Jeffery37dd6a32023-05-12 16:04:06 +0930894 le32toh(entry->capabilities_during_update.value);
Andrew Jeffery9c766792022-08-10 23:12:49 +0930895
896 if (entry->active_comp_ver_str_len != 0) {
897 active_comp_ver_str->ptr =
Andrew Jeffery37dd6a32023-05-12 16:04:06 +0930898 data + sizeof(struct pldm_component_parameter_entry);
Andrew Jeffery9c766792022-08-10 23:12:49 +0930899 active_comp_ver_str->length = entry->active_comp_ver_str_len;
900 } else {
901 active_comp_ver_str->ptr = NULL;
902 active_comp_ver_str->length = 0;
903 }
904
905 if (entry->pending_comp_ver_str_len != 0) {
Andrew Jeffery9c766792022-08-10 23:12:49 +0930906 pending_comp_ver_str->ptr =
Andrew Jeffery37dd6a32023-05-12 16:04:06 +0930907 data + sizeof(struct pldm_component_parameter_entry) +
908 entry->active_comp_ver_str_len;
Andrew Jeffery9c766792022-08-10 23:12:49 +0930909 pending_comp_ver_str->length = entry->pending_comp_ver_str_len;
910 } else {
911 pending_comp_ver_str->ptr = NULL;
912 pending_comp_ver_str->length = 0;
913 }
914 return PLDM_SUCCESS;
915}
916
Chris Wang4c1f2c72024-03-21 17:09:44 +0800917LIBPLDM_ABI_TESTING
918int encode_query_downstream_devices_req(uint8_t instance_id,
919 struct pldm_msg *msg)
920{
921 if (msg == NULL) {
922 return PLDM_ERROR_INVALID_DATA;
923 }
924
925 return encode_pldm_header_only(PLDM_REQUEST, instance_id, PLDM_FWUP,
926 PLDM_QUERY_DOWNSTREAM_DEVICES, msg);
927}
928
929LIBPLDM_ABI_TESTING
930int decode_query_downstream_devices_resp(
931 const struct pldm_msg *msg, size_t payload_length,
932 struct pldm_query_downstream_devices_resp *resp_data)
933{
934 struct pldm_msgbuf _buf;
935 struct pldm_msgbuf *buf = &_buf;
936 int rc;
937
938 if (msg == NULL || resp_data == NULL || !payload_length) {
939 return PLDM_ERROR_INVALID_DATA;
940 }
941
Andrew Jeffery830c1eb2024-10-04 10:48:10 +0930942 rc = pldm_msgbuf_init_errno(buf, PLDM_OPTIONAL_COMMAND_RESP_MIN_LEN,
943 msg->payload, payload_length);
Chris Wang4c1f2c72024-03-21 17:09:44 +0800944 if (rc) {
945 return rc;
946 }
947
948 rc = pldm_msgbuf_extract(buf, resp_data->completion_code);
949 if (rc) {
Andrew Jeffery830c1eb2024-10-04 10:48:10 +0930950 return pldm_xlate_errno(rc);
Chris Wang4c1f2c72024-03-21 17:09:44 +0800951 }
952 if (PLDM_SUCCESS != resp_data->completion_code) {
953 // Return the CC directly without decoding the rest of the payload
954 return PLDM_SUCCESS;
955 }
956
957 if (payload_length < PLDM_QUERY_DOWNSTREAM_DEVICES_RESP_BYTES) {
958 return PLDM_ERROR_INVALID_LENGTH;
959 }
960
961 rc = pldm_msgbuf_extract(buf,
962 resp_data->downstream_device_update_supported);
963 if (rc) {
Andrew Jeffery830c1eb2024-10-04 10:48:10 +0930964 return pldm_xlate_errno(rc);
Chris Wang4c1f2c72024-03-21 17:09:44 +0800965 }
966
967 if (!is_downstream_device_update_support_valid(
968 resp_data->downstream_device_update_supported)) {
969 return PLDM_ERROR_INVALID_DATA;
970 }
971
972 pldm_msgbuf_extract(buf, resp_data->number_of_downstream_devices);
973 pldm_msgbuf_extract(buf, resp_data->max_number_of_downstream_devices);
974 pldm_msgbuf_extract(buf, resp_data->capabilities.value);
975
Andrew Jeffery830c1eb2024-10-04 10:48:10 +0930976 rc = pldm_msgbuf_destroy_consumed(buf);
977 if (rc) {
978 pldm_xlate_errno(rc);
979 }
980
981 return PLDM_SUCCESS;
Chris Wang4c1f2c72024-03-21 17:09:44 +0800982}
983
Chris Wang458475a2024-03-26 17:59:19 +0800984LIBPLDM_ABI_TESTING
985int encode_query_downstream_identifiers_req(
986 uint8_t instance_id, uint32_t data_transfer_handle,
987 enum transfer_op_flag transfer_operation_flag, struct pldm_msg *msg,
988 size_t payload_length)
989{
990 struct pldm_msgbuf _buf;
991 struct pldm_msgbuf *buf = &_buf;
992 int rc;
993
994 if (msg == NULL) {
995 return PLDM_ERROR_INVALID_DATA;
996 }
997
998 if (!is_transfer_operation_flag_valid(transfer_operation_flag)) {
999 return PLDM_INVALID_TRANSFER_OPERATION_FLAG;
1000 }
1001
1002 struct pldm_header_info header = { 0 };
1003 header.instance = instance_id;
1004 header.msg_type = PLDM_REQUEST;
1005 header.pldm_type = PLDM_FWUP;
1006 header.command = PLDM_QUERY_DOWNSTREAM_IDENTIFIERS;
1007 rc = pack_pldm_header(&header, &(msg->hdr));
1008 if (rc) {
1009 return rc;
1010 }
1011
Andrew Jeffery830c1eb2024-10-04 10:48:10 +09301012 rc = pldm_msgbuf_init_errno(buf,
1013 PLDM_QUERY_DOWNSTREAM_IDENTIFIERS_REQ_BYTES,
1014 msg->payload, payload_length);
Chris Wang458475a2024-03-26 17:59:19 +08001015 if (rc) {
Andrew Jeffery830c1eb2024-10-04 10:48:10 +09301016 return pldm_xlate_errno(rc);
Chris Wang458475a2024-03-26 17:59:19 +08001017 }
1018
1019 pldm_msgbuf_insert(buf, data_transfer_handle);
1020 // Data correctness has been verified, cast it to 1-byte data directly.
1021 pldm_msgbuf_insert(buf, (uint8_t)transfer_operation_flag);
1022
Andrew Jeffery830c1eb2024-10-04 10:48:10 +09301023 rc = pldm_msgbuf_destroy(buf);
1024 if (rc) {
1025 return pldm_xlate_errno(rc);
1026 }
1027
1028 return PLDM_SUCCESS;
Chris Wang458475a2024-03-26 17:59:19 +08001029}
1030
1031LIBPLDM_ABI_TESTING
1032int decode_query_downstream_identifiers_resp(
1033 const struct pldm_msg *msg, size_t payload_length,
1034 struct pldm_query_downstream_identifiers_resp *resp_data,
Andrew Jeffery3a2c6582024-11-07 16:30:36 +10301035 struct pldm_downstream_device_iter *iter)
Chris Wang458475a2024-03-26 17:59:19 +08001036{
1037 struct pldm_msgbuf _buf;
1038 struct pldm_msgbuf *buf = &_buf;
Andrew Jeffery3a2c6582024-11-07 16:30:36 +10301039 void *remaining = NULL;
Chris Wang458475a2024-03-26 17:59:19 +08001040 int rc = PLDM_ERROR;
1041
Andrew Jeffery3a2c6582024-11-07 16:30:36 +10301042 if (msg == NULL || resp_data == NULL || iter == NULL ||
Chris Wang458475a2024-03-26 17:59:19 +08001043 !payload_length) {
1044 return PLDM_ERROR_INVALID_DATA;
1045 }
1046
Andrew Jeffery830c1eb2024-10-04 10:48:10 +09301047 rc = pldm_msgbuf_init_errno(buf, PLDM_OPTIONAL_COMMAND_RESP_MIN_LEN,
1048 msg->payload, payload_length);
Chris Wang458475a2024-03-26 17:59:19 +08001049 if (rc) {
Andrew Jeffery830c1eb2024-10-04 10:48:10 +09301050 return pldm_xlate_errno(rc);
Chris Wang458475a2024-03-26 17:59:19 +08001051 }
1052
1053 rc = pldm_msgbuf_extract(buf, resp_data->completion_code);
1054 if (rc) {
Andrew Jeffery830c1eb2024-10-04 10:48:10 +09301055 return pldm_xlate_errno(rc);
Chris Wang458475a2024-03-26 17:59:19 +08001056 }
1057 if (PLDM_SUCCESS != resp_data->completion_code) {
1058 return PLDM_SUCCESS;
1059 }
1060
1061 if (payload_length < PLDM_QUERY_DOWNSTREAM_IDENTIFIERS_RESP_MIN_LEN) {
1062 return PLDM_ERROR_INVALID_LENGTH;
1063 }
1064
1065 pldm_msgbuf_extract(buf, resp_data->next_data_transfer_handle);
1066 pldm_msgbuf_extract(buf, resp_data->transfer_flag);
1067
1068 rc = pldm_msgbuf_extract(buf, resp_data->downstream_devices_length);
1069 if (rc) {
Andrew Jeffery830c1eb2024-10-04 10:48:10 +09301070 return pldm_xlate_errno(rc);
Chris Wang458475a2024-03-26 17:59:19 +08001071 }
1072
1073 pldm_msgbuf_extract(buf, resp_data->number_of_downstream_devices);
Andrew Jeffery3a2c6582024-11-07 16:30:36 +10301074 rc = pldm_msgbuf_span_required(
1075 buf, resp_data->downstream_devices_length, &remaining);
Chris Wang458475a2024-03-26 17:59:19 +08001076 if (rc) {
Andrew Jeffery830c1eb2024-10-04 10:48:10 +09301077 return pldm_xlate_errno(rc);
Chris Wang458475a2024-03-26 17:59:19 +08001078 }
Chris Wang458475a2024-03-26 17:59:19 +08001079
Andrew Jeffery830c1eb2024-10-04 10:48:10 +09301080 rc = pldm_msgbuf_destroy(buf);
1081 if (rc) {
1082 return pldm_xlate_errno(rc);
1083 }
1084
Andrew Jeffery3a2c6582024-11-07 16:30:36 +10301085 iter->field.ptr = remaining;
1086 iter->field.length = resp_data->downstream_devices_length;
1087 iter->devs = resp_data->number_of_downstream_devices;
1088
Andrew Jeffery830c1eb2024-10-04 10:48:10 +09301089 return PLDM_SUCCESS;
Chris Wang458475a2024-03-26 17:59:19 +08001090}
1091
Chris Wangb6ef35b2024-07-03 09:35:42 +08001092LIBPLDM_ABI_TESTING
Andrew Jeffery3a2c6582024-11-07 16:30:36 +10301093int decode_pldm_downstream_device_from_iter(
1094 struct pldm_downstream_device_iter *iter,
1095 struct pldm_downstream_device *dev)
1096{
1097 struct pldm_msgbuf _buf;
1098 struct pldm_msgbuf *buf = &_buf;
1099 int rc;
1100
1101 if (!iter || !dev) {
1102 return -EINVAL;
1103 }
1104
1105 rc = pldm_msgbuf_init_errno(buf, 3, iter->field.ptr,
1106 iter->field.length);
1107 if (rc) {
1108 return rc;
1109 }
1110
1111 pldm_msgbuf_extract(buf, dev->downstream_device_index);
1112 pldm_msgbuf_extract(buf, dev->downstream_descriptor_count);
1113 iter->field.ptr = NULL;
1114 pldm_msgbuf_span_remaining(buf, (void **)&iter->field.ptr,
1115 &iter->field.length);
1116
1117 return pldm_msgbuf_destroy(buf);
1118}
1119
1120LIBPLDM_ABI_TESTING
Chris Wangb6ef35b2024-07-03 09:35:42 +08001121int encode_get_downstream_firmware_params_req(
1122 uint8_t instance_id, uint32_t data_transfer_handle,
1123 enum transfer_op_flag transfer_operation_flag, struct pldm_msg *msg,
1124 size_t payload_length)
1125{
1126 struct pldm_msgbuf _buf;
1127 struct pldm_msgbuf *buf = &_buf;
1128 int rc;
1129
1130 if (msg == NULL) {
1131 return -EINVAL;
1132 }
1133
1134 rc = pldm_msgbuf_init_errno(
1135 buf, PLDM_GET_DOWNSTREAM_FIRMWARE_PARAMS_REQ_BYTES,
1136 msg->payload, payload_length);
1137 if (rc < 0) {
1138 return rc;
1139 }
1140
1141 if (!is_transfer_operation_flag_valid(transfer_operation_flag)) {
1142 return -EBADMSG;
1143 }
1144
1145 struct pldm_header_info header = { 0 };
1146 header.instance = instance_id;
1147 header.msg_type = PLDM_REQUEST;
1148 header.pldm_type = PLDM_FWUP;
1149 header.command = PLDM_QUERY_DOWNSTREAM_FIRMWARE_PARAMETERS;
1150 rc = pack_pldm_header_errno(&header, &msg->hdr);
1151 if (rc < 0) {
1152 return rc;
1153 }
1154
1155 pldm_msgbuf_insert(buf, data_transfer_handle);
1156 // Data correctness has been verified, cast it to 1-byte data directly.
1157 pldm_msgbuf_insert(buf, (uint8_t)transfer_operation_flag);
1158
1159 return pldm_msgbuf_destroy(buf);
1160}
1161
1162LIBPLDM_ABI_TESTING
1163int decode_get_downstream_firmware_params_resp(
1164 const struct pldm_msg *msg, size_t payload_length,
1165 struct pldm_get_downstream_firmware_params_resp *resp_data,
1166 struct variable_field *downstream_device_param_table)
1167{
1168 struct pldm_msgbuf _buf;
1169 struct pldm_msgbuf *buf = &_buf;
1170 int rc;
1171
1172 if (msg == NULL || resp_data == NULL ||
1173 downstream_device_param_table == NULL) {
1174 return -EINVAL;
1175 }
1176
1177 rc = pldm_msgbuf_init_errno(buf, PLDM_OPTIONAL_COMMAND_RESP_MIN_LEN,
1178 msg->payload, payload_length);
1179 if (rc < 0) {
1180 return rc;
1181 }
1182
1183 rc = pldm_msgbuf_extract(buf, resp_data->completion_code);
1184 if (rc < 0) {
1185 return rc;
1186 }
1187 if (PLDM_SUCCESS != resp_data->completion_code) {
1188 return 0;
1189 }
1190
1191 if (payload_length < PLDM_GET_DOWNSTREAM_FIRMWARE_PARAMS_RESP_MIN_LEN) {
1192 return -EBADMSG;
1193 }
1194
1195 pldm_msgbuf_extract(buf, resp_data->next_data_transfer_handle);
1196 pldm_msgbuf_extract(buf, resp_data->transfer_flag);
1197 pldm_msgbuf_extract(buf,
1198 resp_data->fdp_capabilities_during_update.value);
1199 pldm_msgbuf_extract(buf, resp_data->downstream_device_count);
1200
1201 return pldm_msgbuf_span_remaining(
1202 buf, (void **)&downstream_device_param_table->ptr,
1203 &downstream_device_param_table->length);
1204}
1205
1206LIBPLDM_ABI_TESTING
1207int decode_downstream_device_parameter_table_entry(
1208 struct variable_field *data,
1209 struct pldm_downstream_device_parameter_entry *entry,
1210 struct variable_field *versions)
1211{
1212 struct pldm_msgbuf _buf;
1213 struct pldm_msgbuf *buf = &_buf;
1214 void *cursor = NULL;
1215 size_t remaining;
1216 int rc;
1217
1218 if (data == NULL || entry == NULL || versions == NULL) {
1219 return -EINVAL;
1220 }
1221
1222 rc = pldm_msgbuf_init_errno(
1223 buf, PLDM_DOWNSTREAM_DEVICE_PARAMETER_ENTRY_MIN_LEN, data->ptr,
1224 data->length);
1225 if (rc < 0) {
1226 return rc;
1227 }
1228
1229 pldm_msgbuf_extract(buf, entry->downstream_device_index);
1230 pldm_msgbuf_extract(buf, entry->active_comp_comparison_stamp);
1231 pldm_msgbuf_extract(buf, entry->active_comp_ver_str_type);
1232 rc = pldm_msgbuf_extract(buf, entry->active_comp_ver_str_len);
1233 if (rc < 0) {
1234 return rc;
1235 }
Andrew Jeffery0a1be3c2024-08-11 08:34:10 +00001236 rc = pldm_msgbuf_extract_array(buf,
1237 PLDM_FWUP_COMPONENT_RELEASE_DATA_LEN,
1238 entry->active_comp_release_date,
1239 sizeof(entry->active_comp_release_date));
1240 if (rc < 0) {
1241 return rc;
1242 }
1243
Chris Wangb6ef35b2024-07-03 09:35:42 +08001244 // Fill the last byte with NULL character
1245 entry->active_comp_release_date[PLDM_FWUP_COMPONENT_RELEASE_DATA_LEN] =
1246 '\0';
1247
1248 pldm_msgbuf_extract(buf, entry->pending_comp_comparison_stamp);
1249 pldm_msgbuf_extract(buf, entry->pending_comp_ver_str_type);
1250 rc = pldm_msgbuf_extract(buf, entry->pending_comp_ver_str_len);
1251 if (rc < 0) {
1252 return rc;
1253 }
Andrew Jeffery0a1be3c2024-08-11 08:34:10 +00001254
1255 rc = pldm_msgbuf_extract_array(
1256 buf, PLDM_FWUP_COMPONENT_RELEASE_DATA_LEN,
1257 entry->pending_comp_release_date,
1258 sizeof(entry->pending_comp_release_date));
1259 if (rc < 0) {
1260 return rc;
1261 }
1262
Chris Wangb6ef35b2024-07-03 09:35:42 +08001263 // Fill the last byte with NULL character
1264 entry->pending_comp_release_date[PLDM_FWUP_COMPONENT_RELEASE_DATA_LEN] =
1265 '\0';
1266
1267 pldm_msgbuf_extract(buf, entry->comp_activation_methods.value);
1268 pldm_msgbuf_extract(buf, entry->capabilities_during_update.value);
1269 const size_t versions_len = entry->active_comp_ver_str_len +
1270 entry->pending_comp_ver_str_len;
1271 rc = pldm_msgbuf_span_required(buf, versions_len,
1272 (void **)&versions->ptr);
1273 if (rc < 0) {
1274 return rc;
1275 }
1276 versions->length = versions_len;
1277
1278 rc = pldm_msgbuf_span_remaining(buf, &cursor, &remaining);
1279 if (rc < 0) {
1280 return rc;
1281 }
1282
1283 data->ptr = cursor;
1284 data->length = remaining;
1285
1286 return 0;
1287}
1288
1289LIBPLDM_ABI_TESTING
1290int decode_downstream_device_parameter_table_entry_versions(
1291 const struct variable_field *versions,
1292 struct pldm_downstream_device_parameter_entry *entry, char *active,
Andrew Jefferya9892492024-10-03 14:07:17 +09301293 size_t active_len, char *pending, size_t pending_len)
Chris Wangb6ef35b2024-07-03 09:35:42 +08001294{
1295 struct pldm_msgbuf _buf;
1296 struct pldm_msgbuf *buf = &_buf;
1297 int rc;
1298
1299 if (versions == NULL || versions->ptr == NULL || !versions->length ||
1300 entry == NULL || active == NULL || pending == NULL) {
1301 return -EINVAL;
1302 }
1303
Andrew Jefferya9892492024-10-03 14:07:17 +09301304 if (!active_len || active_len - 1 < entry->active_comp_ver_str_len) {
1305 return -EOVERFLOW;
1306 }
1307
1308 if (!pending_len || pending_len - 1 < entry->pending_comp_ver_str_len) {
1309 return -EOVERFLOW;
1310 }
1311
Chris Wangb6ef35b2024-07-03 09:35:42 +08001312 /* This API should be called after decode_downstream_device_parameter_table_entry
1313 * has successfully decoded the entry, assume the entry data is valid here.
1314 */
1315 const size_t versions_len = entry->active_comp_ver_str_len +
1316 entry->pending_comp_ver_str_len;
1317 rc = pldm_msgbuf_init_errno(buf, versions_len, versions->ptr,
1318 versions->length);
1319 if (rc < 0) {
1320 return rc;
1321 }
1322
Andrew Jeffery0a1be3c2024-08-11 08:34:10 +00001323 rc = pldm_msgbuf_extract_array(buf, entry->active_comp_ver_str_len,
Andrew Jefferya9892492024-10-03 14:07:17 +09301324 active, active_len);
Andrew Jeffery0a1be3c2024-08-11 08:34:10 +00001325 if (rc < 0) {
1326 return rc;
1327 }
1328
Chris Wangb6ef35b2024-07-03 09:35:42 +08001329 active[entry->active_comp_ver_str_len] = '\0';
Andrew Jeffery0a1be3c2024-08-11 08:34:10 +00001330 rc = pldm_msgbuf_extract_array(buf, entry->pending_comp_ver_str_len,
Andrew Jefferya9892492024-10-03 14:07:17 +09301331 pending, pending_len);
Andrew Jeffery0a1be3c2024-08-11 08:34:10 +00001332 if (rc < 0) {
1333 return rc;
1334 }
1335
Chris Wangb6ef35b2024-07-03 09:35:42 +08001336 pending[entry->pending_comp_ver_str_len] = '\0';
1337
1338 entry->active_comp_ver_str = active;
1339 entry->pending_comp_ver_str = pending;
1340
1341 return pldm_msgbuf_destroy_consumed(buf);
1342}
1343
Andrew Jeffery9d2a1c62023-06-05 13:02:16 +09301344LIBPLDM_ABI_STABLE
Andrew Jeffery9c766792022-08-10 23:12:49 +09301345int encode_request_update_req(uint8_t instance_id, uint32_t max_transfer_size,
1346 uint16_t num_of_comp,
1347 uint8_t max_outstanding_transfer_req,
1348 uint16_t pkg_data_len,
1349 uint8_t comp_image_set_ver_str_type,
1350 uint8_t comp_image_set_ver_str_len,
1351 const struct variable_field *comp_img_set_ver_str,
1352 struct pldm_msg *msg, size_t payload_length)
1353{
1354 if (comp_img_set_ver_str == NULL || comp_img_set_ver_str->ptr == NULL ||
1355 msg == NULL) {
1356 return PLDM_ERROR_INVALID_DATA;
1357 }
1358
1359 if (payload_length != sizeof(struct pldm_request_update_req) +
Andrew Jeffery37dd6a32023-05-12 16:04:06 +09301360 comp_img_set_ver_str->length) {
Andrew Jeffery9c766792022-08-10 23:12:49 +09301361 return PLDM_ERROR_INVALID_LENGTH;
1362 }
1363
1364 if ((comp_image_set_ver_str_len == 0) ||
1365 (comp_image_set_ver_str_len != comp_img_set_ver_str->length)) {
1366 return PLDM_ERROR_INVALID_DATA;
1367 }
1368
1369 if ((max_transfer_size < PLDM_FWUP_BASELINE_TRANSFER_SIZE) ||
1370 (max_outstanding_transfer_req < PLDM_FWUP_MIN_OUTSTANDING_REQ)) {
1371 return PLDM_ERROR_INVALID_DATA;
1372 }
1373
1374 if (!is_string_type_valid(comp_image_set_ver_str_type)) {
1375 return PLDM_ERROR_INVALID_DATA;
1376 }
1377
Andrew Jeffery37dd6a32023-05-12 16:04:06 +09301378 struct pldm_header_info header = { 0 };
Andrew Jeffery9c766792022-08-10 23:12:49 +09301379 header.instance = instance_id;
1380 header.msg_type = PLDM_REQUEST;
1381 header.pldm_type = PLDM_FWUP;
1382 header.command = PLDM_REQUEST_UPDATE;
1383 uint8_t rc = pack_pldm_header(&header, &(msg->hdr));
1384 if (rc) {
1385 return rc;
1386 }
1387
1388 struct pldm_request_update_req *request =
Andrew Jeffery37dd6a32023-05-12 16:04:06 +09301389 (struct pldm_request_update_req *)msg->payload;
Andrew Jeffery9c766792022-08-10 23:12:49 +09301390
1391 request->max_transfer_size = htole32(max_transfer_size);
1392 request->num_of_comp = htole16(num_of_comp);
1393 request->max_outstanding_transfer_req = max_outstanding_transfer_req;
1394 request->pkg_data_len = htole16(pkg_data_len);
1395 request->comp_image_set_ver_str_type = comp_image_set_ver_str_type;
1396 request->comp_image_set_ver_str_len = comp_image_set_ver_str_len;
1397
1398 memcpy(msg->payload + sizeof(struct pldm_request_update_req),
1399 comp_img_set_ver_str->ptr, comp_img_set_ver_str->length);
1400
1401 return PLDM_SUCCESS;
1402}
1403
Andrew Jeffery9d2a1c62023-06-05 13:02:16 +09301404LIBPLDM_ABI_STABLE
Andrew Jeffery9c766792022-08-10 23:12:49 +09301405int decode_request_update_resp(const struct pldm_msg *msg,
1406 size_t payload_length, uint8_t *completion_code,
1407 uint16_t *fd_meta_data_len,
1408 uint8_t *fd_will_send_pkg_data)
1409{
1410 if (msg == NULL || completion_code == NULL ||
1411 fd_meta_data_len == NULL || fd_will_send_pkg_data == NULL ||
1412 !payload_length) {
1413 return PLDM_ERROR_INVALID_DATA;
1414 }
1415
1416 *completion_code = msg->payload[0];
1417 if (*completion_code != PLDM_SUCCESS) {
1418 return PLDM_SUCCESS;
1419 }
1420
1421 if (payload_length != sizeof(struct pldm_request_update_resp)) {
1422 return PLDM_ERROR_INVALID_LENGTH;
1423 }
1424
1425 struct pldm_request_update_resp *response =
Andrew Jeffery37dd6a32023-05-12 16:04:06 +09301426 (struct pldm_request_update_resp *)msg->payload;
Andrew Jeffery9c766792022-08-10 23:12:49 +09301427
1428 *fd_meta_data_len = le16toh(response->fd_meta_data_len);
1429 *fd_will_send_pkg_data = response->fd_will_send_pkg_data;
1430
1431 return PLDM_SUCCESS;
1432}
1433
Andrew Jeffery9d2a1c62023-06-05 13:02:16 +09301434LIBPLDM_ABI_STABLE
Andrew Jeffery37dd6a32023-05-12 16:04:06 +09301435int encode_pass_component_table_req(uint8_t instance_id, uint8_t transfer_flag,
1436 uint16_t comp_classification,
1437 uint16_t comp_identifier,
1438 uint8_t comp_classification_index,
1439 uint32_t comp_comparison_stamp,
1440 uint8_t comp_ver_str_type,
1441 uint8_t comp_ver_str_len,
1442 const struct variable_field *comp_ver_str,
1443 struct pldm_msg *msg, size_t payload_length)
Andrew Jeffery9c766792022-08-10 23:12:49 +09301444{
1445 if (comp_ver_str == NULL || comp_ver_str->ptr == NULL || msg == NULL) {
1446 return PLDM_ERROR_INVALID_DATA;
1447 }
1448
1449 if (payload_length != sizeof(struct pldm_pass_component_table_req) +
Andrew Jeffery37dd6a32023-05-12 16:04:06 +09301450 comp_ver_str->length) {
Andrew Jeffery9c766792022-08-10 23:12:49 +09301451 return PLDM_ERROR_INVALID_LENGTH;
1452 }
1453
1454 if ((comp_ver_str_len == 0) ||
1455 (comp_ver_str_len != comp_ver_str->length)) {
1456 return PLDM_ERROR_INVALID_DATA;
1457 }
1458
1459 if (!is_transfer_flag_valid(transfer_flag)) {
1460 return PLDM_INVALID_TRANSFER_OPERATION_FLAG;
1461 }
1462
1463 if (!is_string_type_valid(comp_ver_str_type)) {
1464 return PLDM_ERROR_INVALID_DATA;
1465 }
1466
Andrew Jeffery37dd6a32023-05-12 16:04:06 +09301467 struct pldm_header_info header = { 0 };
Andrew Jeffery9c766792022-08-10 23:12:49 +09301468 header.instance = instance_id;
1469 header.msg_type = PLDM_REQUEST;
1470 header.pldm_type = PLDM_FWUP;
1471 header.command = PLDM_PASS_COMPONENT_TABLE;
1472 uint8_t rc = pack_pldm_header(&header, &(msg->hdr));
1473 if (rc) {
1474 return rc;
1475 }
1476
1477 struct pldm_pass_component_table_req *request =
Andrew Jeffery37dd6a32023-05-12 16:04:06 +09301478 (struct pldm_pass_component_table_req *)msg->payload;
Andrew Jeffery9c766792022-08-10 23:12:49 +09301479
1480 request->transfer_flag = transfer_flag;
1481 request->comp_classification = htole16(comp_classification);
1482 request->comp_identifier = htole16(comp_identifier);
1483 request->comp_classification_index = comp_classification_index;
1484 request->comp_comparison_stamp = htole32(comp_comparison_stamp);
1485 request->comp_ver_str_type = comp_ver_str_type;
1486 request->comp_ver_str_len = comp_ver_str_len;
1487
1488 memcpy(msg->payload + sizeof(struct pldm_pass_component_table_req),
1489 comp_ver_str->ptr, comp_ver_str->length);
1490
1491 return PLDM_SUCCESS;
1492}
1493
Andrew Jeffery9d2a1c62023-06-05 13:02:16 +09301494LIBPLDM_ABI_STABLE
Andrew Jeffery9c766792022-08-10 23:12:49 +09301495int decode_pass_component_table_resp(const struct pldm_msg *msg,
1496 const size_t payload_length,
1497 uint8_t *completion_code,
1498 uint8_t *comp_resp,
1499 uint8_t *comp_resp_code)
1500{
1501 if (msg == NULL || completion_code == NULL || comp_resp == NULL ||
1502 comp_resp_code == NULL || !payload_length) {
1503 return PLDM_ERROR_INVALID_DATA;
1504 }
1505
1506 *completion_code = msg->payload[0];
1507 if (*completion_code != PLDM_SUCCESS) {
1508 return PLDM_SUCCESS;
1509 }
1510
1511 if (payload_length != sizeof(struct pldm_pass_component_table_resp)) {
1512 return PLDM_ERROR_INVALID_LENGTH;
1513 }
1514
1515 struct pldm_pass_component_table_resp *response =
Andrew Jeffery37dd6a32023-05-12 16:04:06 +09301516 (struct pldm_pass_component_table_resp *)msg->payload;
Andrew Jeffery9c766792022-08-10 23:12:49 +09301517
1518 if (!is_comp_resp_valid(response->comp_resp)) {
1519 return PLDM_ERROR_INVALID_DATA;
1520 }
1521
1522 if (!is_comp_resp_code_valid(response->comp_resp_code)) {
1523 return PLDM_ERROR_INVALID_DATA;
1524 }
1525
1526 *comp_resp = response->comp_resp;
1527 *comp_resp_code = response->comp_resp_code;
1528
1529 return PLDM_SUCCESS;
1530}
1531
Andrew Jeffery9d2a1c62023-06-05 13:02:16 +09301532LIBPLDM_ABI_STABLE
Andrew Jeffery9c766792022-08-10 23:12:49 +09301533int encode_update_component_req(
Andrew Jeffery37dd6a32023-05-12 16:04:06 +09301534 uint8_t instance_id, uint16_t comp_classification,
1535 uint16_t comp_identifier, uint8_t comp_classification_index,
1536 uint32_t comp_comparison_stamp, uint32_t comp_image_size,
1537 bitfield32_t update_option_flags, uint8_t comp_ver_str_type,
1538 uint8_t comp_ver_str_len, const struct variable_field *comp_ver_str,
1539 struct pldm_msg *msg, size_t payload_length)
Andrew Jeffery9c766792022-08-10 23:12:49 +09301540{
1541 if (comp_ver_str == NULL || comp_ver_str->ptr == NULL || msg == NULL) {
1542 return PLDM_ERROR_INVALID_DATA;
1543 }
1544
1545 if (payload_length !=
1546 sizeof(struct pldm_update_component_req) + comp_ver_str->length) {
1547 return PLDM_ERROR_INVALID_LENGTH;
1548 }
1549
1550 if (!comp_image_size) {
1551 return PLDM_ERROR_INVALID_DATA;
1552 }
1553
1554 if ((comp_ver_str_len == 0) ||
1555 (comp_ver_str_len != comp_ver_str->length)) {
1556 return PLDM_ERROR_INVALID_DATA;
1557 }
1558
1559 if (!is_string_type_valid(comp_ver_str_type)) {
1560 return PLDM_ERROR_INVALID_DATA;
1561 }
1562
Andrew Jeffery37dd6a32023-05-12 16:04:06 +09301563 struct pldm_header_info header = { 0 };
Andrew Jeffery9c766792022-08-10 23:12:49 +09301564 header.instance = instance_id;
1565 header.msg_type = PLDM_REQUEST;
1566 header.pldm_type = PLDM_FWUP;
1567 header.command = PLDM_UPDATE_COMPONENT;
1568 uint8_t rc = pack_pldm_header(&header, &(msg->hdr));
1569 if (rc) {
1570 return rc;
1571 }
1572
1573 struct pldm_update_component_req *request =
Andrew Jeffery37dd6a32023-05-12 16:04:06 +09301574 (struct pldm_update_component_req *)msg->payload;
Andrew Jeffery9c766792022-08-10 23:12:49 +09301575
1576 request->comp_classification = htole16(comp_classification);
1577 request->comp_identifier = htole16(comp_identifier);
1578 request->comp_classification_index = comp_classification_index;
1579 request->comp_comparison_stamp = htole32(comp_comparison_stamp);
1580 request->comp_image_size = htole32(comp_image_size);
1581 request->update_option_flags.value = htole32(update_option_flags.value);
1582 request->comp_ver_str_type = comp_ver_str_type;
1583 request->comp_ver_str_len = comp_ver_str_len;
1584
1585 memcpy(msg->payload + sizeof(struct pldm_update_component_req),
1586 comp_ver_str->ptr, comp_ver_str->length);
1587
1588 return PLDM_SUCCESS;
1589}
1590
Andrew Jeffery9d2a1c62023-06-05 13:02:16 +09301591LIBPLDM_ABI_STABLE
Andrew Jeffery9c766792022-08-10 23:12:49 +09301592int decode_update_component_resp(const struct pldm_msg *msg,
1593 size_t payload_length,
1594 uint8_t *completion_code,
1595 uint8_t *comp_compatibility_resp,
1596 uint8_t *comp_compatibility_resp_code,
1597 bitfield32_t *update_option_flags_enabled,
1598 uint16_t *time_before_req_fw_data)
1599{
1600 if (msg == NULL || completion_code == NULL ||
1601 comp_compatibility_resp == NULL ||
1602 comp_compatibility_resp_code == NULL ||
1603 update_option_flags_enabled == NULL ||
1604 time_before_req_fw_data == NULL || !payload_length) {
1605 return PLDM_ERROR_INVALID_DATA;
1606 }
1607
1608 *completion_code = msg->payload[0];
1609 if (*completion_code != PLDM_SUCCESS) {
1610 return PLDM_SUCCESS;
1611 }
1612
1613 if (payload_length != sizeof(struct pldm_update_component_resp)) {
1614 return PLDM_ERROR_INVALID_LENGTH;
1615 }
1616
1617 struct pldm_update_component_resp *response =
Andrew Jeffery37dd6a32023-05-12 16:04:06 +09301618 (struct pldm_update_component_resp *)msg->payload;
Andrew Jeffery9c766792022-08-10 23:12:49 +09301619
1620 if (!is_comp_compatibility_resp_valid(
Andrew Jeffery37dd6a32023-05-12 16:04:06 +09301621 response->comp_compatibility_resp)) {
Andrew Jeffery9c766792022-08-10 23:12:49 +09301622 return PLDM_ERROR_INVALID_DATA;
1623 }
1624
1625 if (!is_comp_compatibility_resp_code_valid(
Andrew Jeffery37dd6a32023-05-12 16:04:06 +09301626 response->comp_compatibility_resp_code)) {
Andrew Jeffery9c766792022-08-10 23:12:49 +09301627 return PLDM_ERROR_INVALID_DATA;
1628 }
1629
1630 *comp_compatibility_resp = response->comp_compatibility_resp;
1631 *comp_compatibility_resp_code = response->comp_compatibility_resp_code;
1632 update_option_flags_enabled->value =
Andrew Jeffery37dd6a32023-05-12 16:04:06 +09301633 le32toh(response->update_option_flags_enabled.value);
Andrew Jeffery9c766792022-08-10 23:12:49 +09301634 *time_before_req_fw_data = le16toh(response->time_before_req_fw_data);
1635
1636 return PLDM_SUCCESS;
1637}
1638
Andrew Jeffery9d2a1c62023-06-05 13:02:16 +09301639LIBPLDM_ABI_STABLE
Andrew Jeffery9c766792022-08-10 23:12:49 +09301640int decode_request_firmware_data_req(const struct pldm_msg *msg,
1641 size_t payload_length, uint32_t *offset,
1642 uint32_t *length)
1643{
1644 if (msg == NULL || offset == NULL || length == NULL) {
1645 return PLDM_ERROR_INVALID_DATA;
1646 }
1647 if (payload_length != sizeof(struct pldm_request_firmware_data_req)) {
1648 return PLDM_ERROR_INVALID_LENGTH;
1649 }
1650 struct pldm_request_firmware_data_req *request =
Andrew Jeffery37dd6a32023-05-12 16:04:06 +09301651 (struct pldm_request_firmware_data_req *)msg->payload;
Andrew Jeffery9c766792022-08-10 23:12:49 +09301652 *offset = le32toh(request->offset);
1653 *length = le32toh(request->length);
1654
1655 if (*length < PLDM_FWUP_BASELINE_TRANSFER_SIZE) {
1656 return PLDM_FWUP_INVALID_TRANSFER_LENGTH;
1657 }
1658
1659 return PLDM_SUCCESS;
1660}
1661
Andrew Jeffery9d2a1c62023-06-05 13:02:16 +09301662LIBPLDM_ABI_STABLE
Andrew Jeffery9c766792022-08-10 23:12:49 +09301663int encode_request_firmware_data_resp(uint8_t instance_id,
1664 uint8_t completion_code,
1665 struct pldm_msg *msg,
1666 size_t payload_length)
1667{
1668 if (msg == NULL || !payload_length) {
1669 return PLDM_ERROR_INVALID_DATA;
1670 }
1671
Andrew Jeffery37dd6a32023-05-12 16:04:06 +09301672 struct pldm_header_info header = { 0 };
Andrew Jeffery9c766792022-08-10 23:12:49 +09301673 header.instance = instance_id;
1674 header.msg_type = PLDM_RESPONSE;
1675 header.pldm_type = PLDM_FWUP;
1676 header.command = PLDM_REQUEST_FIRMWARE_DATA;
1677 uint8_t rc = pack_pldm_header(&header, &(msg->hdr));
1678 if (rc) {
1679 return rc;
1680 }
1681
1682 msg->payload[0] = completion_code;
1683
1684 return PLDM_SUCCESS;
1685}
1686
Andrew Jeffery9d2a1c62023-06-05 13:02:16 +09301687LIBPLDM_ABI_STABLE
Andrew Jeffery9c766792022-08-10 23:12:49 +09301688int decode_transfer_complete_req(const struct pldm_msg *msg,
1689 size_t payload_length,
1690 uint8_t *transfer_result)
1691{
1692 if (msg == NULL || transfer_result == NULL) {
1693 return PLDM_ERROR_INVALID_DATA;
1694 }
1695
1696 if (payload_length != sizeof(*transfer_result)) {
1697 return PLDM_ERROR_INVALID_LENGTH;
1698 }
1699
1700 *transfer_result = msg->payload[0];
1701 return PLDM_SUCCESS;
1702}
1703
Andrew Jeffery9d2a1c62023-06-05 13:02:16 +09301704LIBPLDM_ABI_STABLE
Andrew Jeffery9c766792022-08-10 23:12:49 +09301705int encode_transfer_complete_resp(uint8_t instance_id, uint8_t completion_code,
1706 struct pldm_msg *msg, size_t payload_length)
1707{
1708 if (msg == NULL) {
1709 return PLDM_ERROR_INVALID_DATA;
1710 }
1711
1712 if (payload_length != sizeof(completion_code)) {
1713 return PLDM_ERROR_INVALID_LENGTH;
1714 }
1715
Andrew Jeffery37dd6a32023-05-12 16:04:06 +09301716 struct pldm_header_info header = { 0 };
Andrew Jeffery9c766792022-08-10 23:12:49 +09301717 header.instance = instance_id;
1718 header.msg_type = PLDM_RESPONSE;
1719 header.pldm_type = PLDM_FWUP;
1720 header.command = PLDM_TRANSFER_COMPLETE;
1721 uint8_t rc = pack_pldm_header(&header, &(msg->hdr));
1722 if (rc) {
1723 return rc;
1724 }
1725
1726 msg->payload[0] = completion_code;
1727
1728 return PLDM_SUCCESS;
1729}
1730
Andrew Jeffery9d2a1c62023-06-05 13:02:16 +09301731LIBPLDM_ABI_STABLE
Andrew Jeffery9c766792022-08-10 23:12:49 +09301732int decode_verify_complete_req(const struct pldm_msg *msg,
1733 size_t payload_length, uint8_t *verify_result)
1734{
1735 if (msg == NULL || verify_result == NULL) {
1736 return PLDM_ERROR_INVALID_DATA;
1737 }
1738
1739 if (payload_length != sizeof(*verify_result)) {
1740 return PLDM_ERROR_INVALID_LENGTH;
1741 }
1742
1743 *verify_result = msg->payload[0];
1744 return PLDM_SUCCESS;
1745}
1746
Andrew Jeffery9d2a1c62023-06-05 13:02:16 +09301747LIBPLDM_ABI_STABLE
Andrew Jeffery9c766792022-08-10 23:12:49 +09301748int encode_verify_complete_resp(uint8_t instance_id, uint8_t completion_code,
1749 struct pldm_msg *msg, size_t payload_length)
1750{
1751 if (msg == NULL) {
1752 return PLDM_ERROR_INVALID_DATA;
1753 }
1754
1755 if (payload_length != sizeof(completion_code)) {
1756 return PLDM_ERROR_INVALID_LENGTH;
1757 }
1758
Andrew Jeffery37dd6a32023-05-12 16:04:06 +09301759 struct pldm_header_info header = { 0 };
Andrew Jeffery9c766792022-08-10 23:12:49 +09301760 header.instance = instance_id;
1761 header.msg_type = PLDM_RESPONSE;
1762 header.pldm_type = PLDM_FWUP;
1763 header.command = PLDM_VERIFY_COMPLETE;
1764 uint8_t rc = pack_pldm_header(&header, &(msg->hdr));
1765 if (rc) {
1766 return rc;
1767 }
1768
1769 msg->payload[0] = completion_code;
1770
1771 return PLDM_SUCCESS;
1772}
1773
Andrew Jeffery9d2a1c62023-06-05 13:02:16 +09301774LIBPLDM_ABI_STABLE
Andrew Jeffery37dd6a32023-05-12 16:04:06 +09301775int decode_apply_complete_req(const struct pldm_msg *msg, size_t payload_length,
1776 uint8_t *apply_result,
1777 bitfield16_t *comp_activation_methods_modification)
Andrew Jeffery9c766792022-08-10 23:12:49 +09301778{
1779 if (msg == NULL || apply_result == NULL ||
1780 comp_activation_methods_modification == NULL) {
1781 return PLDM_ERROR_INVALID_DATA;
1782 }
1783
1784 if (payload_length != sizeof(struct pldm_apply_complete_req)) {
1785 return PLDM_ERROR_INVALID_LENGTH;
1786 }
1787
1788 struct pldm_apply_complete_req *request =
Andrew Jeffery37dd6a32023-05-12 16:04:06 +09301789 (struct pldm_apply_complete_req *)msg->payload;
Andrew Jeffery9c766792022-08-10 23:12:49 +09301790
1791 *apply_result = request->apply_result;
1792 comp_activation_methods_modification->value =
Andrew Jeffery37dd6a32023-05-12 16:04:06 +09301793 le16toh(request->comp_activation_methods_modification.value);
Andrew Jeffery9c766792022-08-10 23:12:49 +09301794
1795 if ((*apply_result != PLDM_FWUP_APPLY_SUCCESS_WITH_ACTIVATION_METHOD) &&
1796 comp_activation_methods_modification->value) {
1797 return PLDM_ERROR_INVALID_DATA;
1798 }
1799
1800 return PLDM_SUCCESS;
1801}
1802
Andrew Jeffery9d2a1c62023-06-05 13:02:16 +09301803LIBPLDM_ABI_STABLE
Andrew Jeffery9c766792022-08-10 23:12:49 +09301804int encode_apply_complete_resp(uint8_t instance_id, uint8_t completion_code,
1805 struct pldm_msg *msg, size_t payload_length)
1806{
1807 if (msg == NULL) {
1808 return PLDM_ERROR_INVALID_DATA;
1809 }
1810
1811 if (payload_length != sizeof(completion_code)) {
1812 return PLDM_ERROR_INVALID_LENGTH;
1813 }
1814
Andrew Jeffery37dd6a32023-05-12 16:04:06 +09301815 struct pldm_header_info header = { 0 };
Andrew Jeffery9c766792022-08-10 23:12:49 +09301816 header.instance = instance_id;
1817 header.msg_type = PLDM_RESPONSE;
1818 header.pldm_type = PLDM_FWUP;
1819 header.command = PLDM_APPLY_COMPLETE;
1820 uint8_t rc = pack_pldm_header(&header, &(msg->hdr));
1821 if (rc) {
1822 return rc;
1823 }
1824
1825 msg->payload[0] = completion_code;
1826
1827 return PLDM_SUCCESS;
1828}
1829
Andrew Jeffery9d2a1c62023-06-05 13:02:16 +09301830LIBPLDM_ABI_STABLE
Andrew Jeffery9c766792022-08-10 23:12:49 +09301831int encode_activate_firmware_req(uint8_t instance_id,
1832 bool8_t self_contained_activation_req,
1833 struct pldm_msg *msg, size_t payload_length)
1834{
1835 if (msg == NULL) {
1836 return PLDM_ERROR_INVALID_DATA;
1837 }
1838
1839 if (payload_length != sizeof(struct pldm_activate_firmware_req)) {
1840 return PLDM_ERROR_INVALID_LENGTH;
1841 }
1842
1843 if (!is_self_contained_activation_req_valid(
Andrew Jeffery37dd6a32023-05-12 16:04:06 +09301844 self_contained_activation_req)) {
Andrew Jeffery9c766792022-08-10 23:12:49 +09301845 return PLDM_ERROR_INVALID_DATA;
1846 }
1847
Andrew Jeffery37dd6a32023-05-12 16:04:06 +09301848 struct pldm_header_info header = { 0 };
Andrew Jeffery9c766792022-08-10 23:12:49 +09301849 header.instance = instance_id;
1850 header.msg_type = PLDM_REQUEST;
1851 header.pldm_type = PLDM_FWUP;
1852 header.command = PLDM_ACTIVATE_FIRMWARE;
1853 uint8_t rc = pack_pldm_header(&header, &(msg->hdr));
1854 if (rc) {
1855 return rc;
1856 }
1857
1858 struct pldm_activate_firmware_req *request =
Andrew Jeffery37dd6a32023-05-12 16:04:06 +09301859 (struct pldm_activate_firmware_req *)msg->payload;
Andrew Jeffery9c766792022-08-10 23:12:49 +09301860
1861 request->self_contained_activation_req = self_contained_activation_req;
1862
1863 return PLDM_SUCCESS;
1864}
1865
Andrew Jeffery9d2a1c62023-06-05 13:02:16 +09301866LIBPLDM_ABI_STABLE
Andrew Jeffery9c766792022-08-10 23:12:49 +09301867int decode_activate_firmware_resp(const struct pldm_msg *msg,
1868 size_t payload_length,
1869 uint8_t *completion_code,
1870 uint16_t *estimated_time_activation)
1871{
1872 if (msg == NULL || completion_code == NULL ||
1873 estimated_time_activation == NULL || !payload_length) {
1874 return PLDM_ERROR_INVALID_DATA;
1875 }
1876
1877 *completion_code = msg->payload[0];
1878 if (*completion_code != PLDM_SUCCESS) {
1879 return PLDM_SUCCESS;
1880 }
1881
1882 if (payload_length != sizeof(struct pldm_activate_firmware_resp)) {
1883 return PLDM_ERROR_INVALID_LENGTH;
1884 }
1885
1886 struct pldm_activate_firmware_resp *response =
Andrew Jeffery37dd6a32023-05-12 16:04:06 +09301887 (struct pldm_activate_firmware_resp *)msg->payload;
Andrew Jeffery9c766792022-08-10 23:12:49 +09301888
1889 *estimated_time_activation =
Andrew Jeffery37dd6a32023-05-12 16:04:06 +09301890 le16toh(response->estimated_time_activation);
Andrew Jeffery9c766792022-08-10 23:12:49 +09301891
1892 return PLDM_SUCCESS;
1893}
1894
Andrew Jeffery9d2a1c62023-06-05 13:02:16 +09301895LIBPLDM_ABI_STABLE
Andrew Jeffery9c766792022-08-10 23:12:49 +09301896int encode_get_status_req(uint8_t instance_id, struct pldm_msg *msg,
1897 size_t payload_length)
1898{
1899 if (msg == NULL) {
1900 return PLDM_ERROR_INVALID_DATA;
1901 }
1902
1903 if (payload_length != PLDM_GET_STATUS_REQ_BYTES) {
1904 return PLDM_ERROR_INVALID_LENGTH;
1905 }
1906
Andrew Jeffery37dd6a32023-05-12 16:04:06 +09301907 struct pldm_header_info header = { 0 };
Andrew Jeffery9c766792022-08-10 23:12:49 +09301908 header.instance = instance_id;
1909 header.msg_type = PLDM_REQUEST;
1910 header.pldm_type = PLDM_FWUP;
1911 header.command = PLDM_GET_STATUS;
1912 uint8_t rc = pack_pldm_header(&header, &(msg->hdr));
1913 if (rc) {
1914 return rc;
1915 }
1916
1917 return PLDM_SUCCESS;
1918}
1919
Andrew Jeffery9d2a1c62023-06-05 13:02:16 +09301920LIBPLDM_ABI_STABLE
Andrew Jeffery9c766792022-08-10 23:12:49 +09301921int decode_get_status_resp(const struct pldm_msg *msg, size_t payload_length,
1922 uint8_t *completion_code, uint8_t *current_state,
1923 uint8_t *previous_state, uint8_t *aux_state,
1924 uint8_t *aux_state_status, uint8_t *progress_percent,
1925 uint8_t *reason_code,
1926 bitfield32_t *update_option_flags_enabled)
1927{
1928 if (msg == NULL || completion_code == NULL || current_state == NULL ||
1929 previous_state == NULL || aux_state == NULL ||
1930 aux_state_status == NULL || progress_percent == NULL ||
1931 reason_code == NULL || update_option_flags_enabled == NULL ||
1932 !payload_length) {
1933 return PLDM_ERROR_INVALID_DATA;
1934 }
1935
1936 *completion_code = msg->payload[0];
1937 if (*completion_code != PLDM_SUCCESS) {
1938 return PLDM_SUCCESS;
1939 }
1940
1941 if (payload_length != sizeof(struct pldm_get_status_resp)) {
1942 return PLDM_ERROR_INVALID_LENGTH;
1943 }
1944 struct pldm_get_status_resp *response =
Andrew Jeffery37dd6a32023-05-12 16:04:06 +09301945 (struct pldm_get_status_resp *)msg->payload;
Andrew Jeffery9c766792022-08-10 23:12:49 +09301946
1947 if (!is_state_valid(response->current_state)) {
1948 return PLDM_ERROR_INVALID_DATA;
1949 }
1950 if (!is_state_valid(response->previous_state)) {
1951 return PLDM_ERROR_INVALID_DATA;
1952 }
1953 if (!is_aux_state_valid(response->aux_state)) {
1954 return PLDM_ERROR_INVALID_DATA;
1955 }
1956 if (!is_aux_state_status_valid(response->aux_state_status)) {
1957 return PLDM_ERROR_INVALID_DATA;
1958 }
1959 if (response->progress_percent > PLDM_FWUP_MAX_PROGRESS_PERCENT) {
1960 return PLDM_ERROR_INVALID_DATA;
1961 }
1962 if (!is_reason_code_valid(response->reason_code)) {
1963 return PLDM_ERROR_INVALID_DATA;
1964 }
1965
1966 if ((response->current_state == PLDM_FD_STATE_IDLE) ||
1967 (response->current_state == PLDM_FD_STATE_LEARN_COMPONENTS) ||
1968 (response->current_state == PLDM_FD_STATE_READY_XFER)) {
1969 if (response->aux_state !=
1970 PLDM_FD_IDLE_LEARN_COMPONENTS_READ_XFER) {
1971 return PLDM_ERROR_INVALID_DATA;
1972 }
1973 }
1974
1975 *current_state = response->current_state;
1976 *previous_state = response->previous_state;
1977 *aux_state = response->aux_state;
1978 *aux_state_status = response->aux_state_status;
1979 *progress_percent = response->progress_percent;
1980 *reason_code = response->reason_code;
1981 update_option_flags_enabled->value =
Andrew Jeffery37dd6a32023-05-12 16:04:06 +09301982 le32toh(response->update_option_flags_enabled.value);
Andrew Jeffery9c766792022-08-10 23:12:49 +09301983
1984 return PLDM_SUCCESS;
1985}
1986
Andrew Jeffery9d2a1c62023-06-05 13:02:16 +09301987LIBPLDM_ABI_STABLE
Andrew Jeffery9c766792022-08-10 23:12:49 +09301988int encode_cancel_update_component_req(uint8_t instance_id,
1989 struct pldm_msg *msg,
1990 size_t payload_length)
1991{
1992 if (msg == NULL) {
1993 return PLDM_ERROR_INVALID_DATA;
1994 }
1995
1996 if (payload_length != PLDM_CANCEL_UPDATE_COMPONENT_REQ_BYTES) {
1997 return PLDM_ERROR_INVALID_LENGTH;
1998 }
1999
Andrew Jeffery37dd6a32023-05-12 16:04:06 +09302000 struct pldm_header_info header = { 0 };
Andrew Jeffery9c766792022-08-10 23:12:49 +09302001 header.instance = instance_id;
2002 header.msg_type = PLDM_REQUEST;
2003 header.pldm_type = PLDM_FWUP;
2004 header.command = PLDM_CANCEL_UPDATE_COMPONENT;
2005 uint8_t rc = pack_pldm_header(&header, &(msg->hdr));
2006 if (rc) {
2007 return rc;
2008 }
2009
2010 return PLDM_SUCCESS;
2011}
2012
Andrew Jeffery9d2a1c62023-06-05 13:02:16 +09302013LIBPLDM_ABI_STABLE
Andrew Jeffery9c766792022-08-10 23:12:49 +09302014int decode_cancel_update_component_resp(const struct pldm_msg *msg,
2015 size_t payload_length,
2016 uint8_t *completion_code)
2017{
2018 if (msg == NULL || completion_code == NULL) {
2019 return PLDM_ERROR_INVALID_DATA;
2020 }
2021
2022 if (payload_length != sizeof(*completion_code)) {
2023 return PLDM_ERROR_INVALID_LENGTH;
2024 }
2025
2026 *completion_code = msg->payload[0];
2027 return PLDM_SUCCESS;
2028}
2029
Andrew Jeffery9d2a1c62023-06-05 13:02:16 +09302030LIBPLDM_ABI_STABLE
Andrew Jeffery9c766792022-08-10 23:12:49 +09302031int encode_cancel_update_req(uint8_t instance_id, struct pldm_msg *msg,
2032 size_t payload_length)
2033{
2034 if (msg == NULL) {
2035 return PLDM_ERROR_INVALID_DATA;
2036 }
2037
2038 if (payload_length != PLDM_CANCEL_UPDATE_REQ_BYTES) {
2039 return PLDM_ERROR_INVALID_LENGTH;
2040 }
2041
Andrew Jeffery37dd6a32023-05-12 16:04:06 +09302042 struct pldm_header_info header = { 0 };
Andrew Jeffery9c766792022-08-10 23:12:49 +09302043 header.instance = instance_id;
2044 header.msg_type = PLDM_REQUEST;
2045 header.pldm_type = PLDM_FWUP;
2046 header.command = PLDM_CANCEL_UPDATE;
2047 uint8_t rc = pack_pldm_header(&header, &(msg->hdr));
2048 if (rc) {
2049 return rc;
2050 }
2051
2052 return PLDM_SUCCESS;
2053}
2054
Andrew Jeffery9d2a1c62023-06-05 13:02:16 +09302055LIBPLDM_ABI_STABLE
Andrew Jeffery9c766792022-08-10 23:12:49 +09302056int decode_cancel_update_resp(const struct pldm_msg *msg, size_t payload_length,
2057 uint8_t *completion_code,
2058 bool8_t *non_functioning_component_indication,
2059 bitfield64_t *non_functioning_component_bitmap)
2060{
2061 if (msg == NULL || completion_code == NULL ||
2062 non_functioning_component_indication == NULL ||
2063 non_functioning_component_bitmap == NULL || !payload_length) {
2064 return PLDM_ERROR_INVALID_DATA;
2065 }
2066
2067 *completion_code = msg->payload[0];
2068 if (*completion_code != PLDM_SUCCESS) {
2069 return PLDM_SUCCESS;
2070 }
2071
2072 if (payload_length != sizeof(struct pldm_cancel_update_resp)) {
2073 return PLDM_ERROR_INVALID_LENGTH;
2074 }
2075 struct pldm_cancel_update_resp *response =
Andrew Jeffery37dd6a32023-05-12 16:04:06 +09302076 (struct pldm_cancel_update_resp *)msg->payload;
Andrew Jeffery9c766792022-08-10 23:12:49 +09302077
2078 if (!is_non_functioning_component_indication_valid(
Andrew Jeffery37dd6a32023-05-12 16:04:06 +09302079 response->non_functioning_component_indication)) {
Andrew Jeffery9c766792022-08-10 23:12:49 +09302080 return PLDM_ERROR_INVALID_DATA;
2081 }
2082
2083 *non_functioning_component_indication =
Andrew Jeffery37dd6a32023-05-12 16:04:06 +09302084 response->non_functioning_component_indication;
Andrew Jeffery9c766792022-08-10 23:12:49 +09302085
2086 if (*non_functioning_component_indication) {
2087 non_functioning_component_bitmap->value =
Andrew Jeffery37dd6a32023-05-12 16:04:06 +09302088 le64toh(response->non_functioning_component_bitmap);
Andrew Jeffery9c766792022-08-10 23:12:49 +09302089 }
2090
2091 return PLDM_SUCCESS;
2092}