Deepak Kodihalli | 1b24f97 | 2019-02-01 04:09:13 -0600 | [diff] [blame] | 1 | #ifndef BASE_H |
| 2 | #define BASE_H |
| 3 | |
| 4 | #ifdef __cplusplus |
| 5 | extern "C" { |
| 6 | #endif |
| 7 | |
| 8 | #include <asm/byteorder.h> |
| 9 | #include <stddef.h> |
| 10 | #include <stdint.h> |
| 11 | |
Deepak Kodihalli | 97e0bd5 | 2019-02-21 03:54:22 -0600 | [diff] [blame] | 12 | #include "pldm_types.h" |
| 13 | |
Deepak Kodihalli | 1b24f97 | 2019-02-01 04:09:13 -0600 | [diff] [blame] | 14 | /** @brief PLDM Types |
| 15 | */ |
| 16 | enum pldm_supported_types { |
| 17 | PLDM_BASE = 0x00, |
Sampa Misra | 0db1dfa | 2019-03-19 00:15:31 -0500 | [diff] [blame] | 18 | PLDM_PLATFORM = 0x02, |
Sampa Misra | 032bd50 | 2019-03-06 05:03:22 -0600 | [diff] [blame] | 19 | PLDM_BIOS = 0x03, |
Deepak Kodihalli | 1b24f97 | 2019-02-01 04:09:13 -0600 | [diff] [blame] | 20 | }; |
| 21 | |
| 22 | /** @brief PLDM Commands |
| 23 | */ |
| 24 | enum pldm_supported_commands { |
Sampa Misra | 432e187 | 2019-02-13 03:49:43 -0600 | [diff] [blame] | 25 | PLDM_GET_PLDM_VERSION = 0x3, |
Deepak Kodihalli | 1b24f97 | 2019-02-01 04:09:13 -0600 | [diff] [blame] | 26 | PLDM_GET_PLDM_TYPES = 0x4, |
| 27 | PLDM_GET_PLDM_COMMANDS = 0x5 |
| 28 | }; |
| 29 | |
| 30 | /** @brief PLDM base codes |
| 31 | */ |
| 32 | enum pldm_completion_codes { |
| 33 | PLDM_SUCCESS = 0x00, |
| 34 | PLDM_ERROR = 0x01, |
| 35 | PLDM_ERROR_INVALID_DATA = 0x02, |
| 36 | PLDM_ERROR_INVALID_LENGTH = 0x03, |
| 37 | PLDM_ERROR_NOT_READY = 0x04, |
| 38 | PLDM_ERROR_UNSUPPORTED_PLDM_CMD = 0x05, |
| 39 | PLDM_ERROR_INVALID_PLDM_TYPE = 0x20 |
| 40 | }; |
| 41 | |
Sampa Misra | 432e187 | 2019-02-13 03:49:43 -0600 | [diff] [blame] | 42 | enum transfer_op_flag { |
| 43 | PLDM_GET_NEXTPART = 0, |
| 44 | PLDM_GET_FIRSTPART = 1, |
| 45 | }; |
| 46 | |
| 47 | enum transfer_resp_flag { |
| 48 | PLDM_START = 0x01, |
| 49 | PLDM_MIDDLE = 0x02, |
| 50 | PLDM_END = 0x04, |
| 51 | PLDM_START_AND_END = 0x05, |
| 52 | }; |
| 53 | |
Tom Joseph | 4125104 | 2019-02-07 16:17:07 +0530 | [diff] [blame] | 54 | /** @enum MessageType |
| 55 | * |
| 56 | * The different message types supported by the PLDM specification. |
| 57 | */ |
| 58 | typedef enum { |
| 59 | PLDM_RESPONSE, //!< PLDM response |
| 60 | PLDM_REQUEST, //!< PLDM request |
| 61 | PLDM_RESERVED, //!< Reserved |
| 62 | PLDM_ASYNC_REQUEST_NOTIFY, //!< Unacknowledged PLDM request messages |
| 63 | } MessageType; |
| 64 | |
| 65 | #define PLDM_INSTANCE_MAX 31 |
Deepak Kodihalli | 1b24f97 | 2019-02-01 04:09:13 -0600 | [diff] [blame] | 66 | #define PLDM_MAX_TYPES 64 |
| 67 | #define PLDM_MAX_CMDS_PER_TYPE 256 |
| 68 | |
| 69 | /* Message payload lengths */ |
| 70 | #define PLDM_GET_COMMANDS_REQ_BYTES 5 |
Sampa Misra | 432e187 | 2019-02-13 03:49:43 -0600 | [diff] [blame] | 71 | #define PLDM_GET_VERSION_REQ_BYTES 6 |
Deepak Kodihalli | 1b24f97 | 2019-02-01 04:09:13 -0600 | [diff] [blame] | 72 | |
| 73 | /* Response lengths are inclusive of completion code */ |
| 74 | #define PLDM_GET_TYPES_RESP_BYTES 9 |
| 75 | #define PLDM_GET_COMMANDS_RESP_BYTES 33 |
Sampa Misra | 432e187 | 2019-02-13 03:49:43 -0600 | [diff] [blame] | 76 | /* Response data has only one version and does not contain the checksum */ |
| 77 | #define PLDM_GET_VERSION_RESP_BYTES 10 |
Deepak Kodihalli | 1b24f97 | 2019-02-01 04:09:13 -0600 | [diff] [blame] | 78 | |
| 79 | /** @struct pldm_msg_hdr |
| 80 | * |
| 81 | * Structure representing PLDM message header fields |
| 82 | */ |
| 83 | struct pldm_msg_hdr { |
| 84 | #if defined(__LITTLE_ENDIAN_BITFIELD) |
| 85 | uint8_t instance_id : 5; //!< Instance ID |
| 86 | uint8_t reserved : 1; //!< Reserved |
| 87 | uint8_t datagram : 1; //!< Datagram bit |
| 88 | uint8_t request : 1; //!< Request bit |
| 89 | #elif defined(__BIG_ENDIAN_BITFIELD) |
| 90 | uint8_t request : 1; //!< Request bit |
| 91 | uint8_t datagram : 1; //!< Datagram bit |
| 92 | uint8_t reserved : 1; //!< Reserved |
| 93 | uint8_t instance_id : 5; //!< Instance ID |
| 94 | #endif |
| 95 | |
| 96 | #if defined(__LITTLE_ENDIAN_BITFIELD) |
| 97 | uint8_t type : 6; //!< PLDM type |
| 98 | uint8_t header_ver : 2; //!< Header version |
| 99 | #elif defined(__BIG_ENDIAN_BITFIELD) |
| 100 | uint8_t header_ver : 2; //!< Header version |
| 101 | uint8_t type : 6; //!< PLDM type |
| 102 | #endif |
| 103 | uint8_t command; //!< PLDM command code |
| 104 | } __attribute__((packed)); |
| 105 | |
Deepak Kodihalli | 1b24f97 | 2019-02-01 04:09:13 -0600 | [diff] [blame] | 106 | /** @struct pldm_msg |
| 107 | * |
| 108 | * Structure representing PLDM message |
| 109 | */ |
| 110 | struct pldm_msg { |
vkaverap | a6575b8 | 2019-04-03 05:33:52 -0500 | [diff] [blame] | 111 | struct pldm_msg_hdr hdr; //!< PLDM message header |
| 112 | uint8_t payload[1]; //!< &payload[0] is the beginning of the payload |
Deepak Kodihalli | 1b24f97 | 2019-02-01 04:09:13 -0600 | [diff] [blame] | 113 | } __attribute__((packed)); |
| 114 | |
Tom Joseph | 4125104 | 2019-02-07 16:17:07 +0530 | [diff] [blame] | 115 | /** @struct pldm_header_info |
| 116 | * |
| 117 | * The information needed to prepare PLDM header and this is passed to the |
| 118 | * pack_pldm_header and unpack_pldm_header API. |
| 119 | */ |
| 120 | struct pldm_header_info { |
| 121 | MessageType msg_type; //!< PLDM message type |
| 122 | uint8_t instance; //!< PLDM instance id |
| 123 | uint8_t pldm_type; //!< PLDM type |
| 124 | uint8_t command; //!< PLDM command code |
| 125 | uint8_t completion_code; //!< PLDM completion code, applies for response |
| 126 | }; |
| 127 | |
| 128 | /** |
| 129 | * @brief Populate the PLDM message with the PLDM header.The caller of this API |
| 130 | * allocates buffer for the PLDM header when forming the PLDM message. |
| 131 | * The buffer is passed to this API to pack the PLDM header. |
| 132 | * |
| 133 | * @param[in] hdr - Pointer to the PLDM header information |
| 134 | * @param[out] msg - Pointer to PLDM message header |
| 135 | * |
| 136 | * @return 0 on success, otherwise PLDM error codes. |
| 137 | */ |
| 138 | int pack_pldm_header(const struct pldm_header_info *hdr, |
| 139 | struct pldm_msg_hdr *msg); |
| 140 | |
| 141 | /** |
| 142 | * @brief Unpack the PLDM header from the PLDM message. |
| 143 | * |
| 144 | * @param[in] msg - Pointer to the PLDM message header |
| 145 | * @param[out] hdr - Pointer to the PLDM header information |
| 146 | * |
| 147 | * @return 0 on success, otherwise PLDM error codes. |
| 148 | */ |
| 149 | int unpack_pldm_header(const struct pldm_msg_hdr *msg, |
| 150 | struct pldm_header_info *hdr); |
| 151 | |
Deepak Kodihalli | 1b24f97 | 2019-02-01 04:09:13 -0600 | [diff] [blame] | 152 | /* Requester */ |
| 153 | |
| 154 | /* GetPLDMTypes */ |
| 155 | |
| 156 | /** @brief Create a PLDM request message for GetPLDMTypes |
| 157 | * |
| 158 | * @param[in] instance_id - Message's instance id |
| 159 | * @param[in,out] msg - Message will be written to this |
| 160 | * @return pldm_completion_codes |
| 161 | * @note Caller is responsible for memory alloc and dealloc of param |
vkaverap | a6575b8 | 2019-04-03 05:33:52 -0500 | [diff] [blame] | 162 | * 'msg.payload' |
Deepak Kodihalli | 1b24f97 | 2019-02-01 04:09:13 -0600 | [diff] [blame] | 163 | */ |
| 164 | int encode_get_types_req(uint8_t instance_id, struct pldm_msg *msg); |
| 165 | |
| 166 | /** @brief Decode a GetPLDMTypes response message |
| 167 | * |
| 168 | * @param[in] msg - Response message payload |
vkaverap | a6575b8 | 2019-04-03 05:33:52 -0500 | [diff] [blame] | 169 | * @param[in] payload_length - Length of response message payload |
Deepak Kodihalli | 8c64346 | 2019-02-21 10:43:36 -0600 | [diff] [blame] | 170 | * @param[out] completion_code - Pointer to response msg's PLDM completion code |
Deepak Kodihalli | 97e0bd5 | 2019-02-21 03:54:22 -0600 | [diff] [blame] | 171 | * @param[out] types - pointer to array bitfield8_t[8] containing supported |
Deepak Kodihalli | 1b24f97 | 2019-02-01 04:09:13 -0600 | [diff] [blame] | 172 | * types (MAX_TYPES/8) = 8), as per DSP0240 |
| 173 | * @return pldm_completion_codes |
| 174 | */ |
vkaverap | a6575b8 | 2019-04-03 05:33:52 -0500 | [diff] [blame] | 175 | int decode_get_types_resp(const uint8_t *msg, size_t payload_length, |
Deepak Kodihalli | 8c64346 | 2019-02-21 10:43:36 -0600 | [diff] [blame] | 176 | uint8_t *completion_code, bitfield8_t *types); |
Deepak Kodihalli | 1b24f97 | 2019-02-01 04:09:13 -0600 | [diff] [blame] | 177 | |
| 178 | /* GetPLDMCommands */ |
| 179 | |
| 180 | /** @brief Create a PLDM request message for GetPLDMCommands |
| 181 | * |
| 182 | * @param[in] instance_id - Message's instance id |
| 183 | * @param[in] type - PLDM Type |
| 184 | * @param[in] version - Version for PLDM Type |
| 185 | * @param[in,out] msg - Message will be written to this |
| 186 | * @return pldm_completion_codes |
| 187 | * @note Caller is responsible for memory alloc and dealloc of param |
vkaverap | a6575b8 | 2019-04-03 05:33:52 -0500 | [diff] [blame] | 188 | * 'msg.payload' |
Deepak Kodihalli | 1b24f97 | 2019-02-01 04:09:13 -0600 | [diff] [blame] | 189 | */ |
Deepak Kodihalli | 97e0bd5 | 2019-02-21 03:54:22 -0600 | [diff] [blame] | 190 | int encode_get_commands_req(uint8_t instance_id, uint8_t type, ver32_t version, |
| 191 | struct pldm_msg *msg); |
Deepak Kodihalli | 1b24f97 | 2019-02-01 04:09:13 -0600 | [diff] [blame] | 192 | |
| 193 | /** @brief Decode a GetPLDMCommands response message |
| 194 | * |
| 195 | * @param[in] msg - Response message payload |
vkaverap | a6575b8 | 2019-04-03 05:33:52 -0500 | [diff] [blame] | 196 | * @param[in] payload_length - Length of reponse message payload |
Deepak Kodihalli | 8c64346 | 2019-02-21 10:43:36 -0600 | [diff] [blame] | 197 | * @param[out] completion_code - Pointer to response msg's PLDM completion code |
Deepak Kodihalli | 97e0bd5 | 2019-02-21 03:54:22 -0600 | [diff] [blame] | 198 | * @param[in] commands - pointer to array bitfield8_t[32] containing supported |
Deepak Kodihalli | 1b24f97 | 2019-02-01 04:09:13 -0600 | [diff] [blame] | 199 | * commands (PLDM_MAX_CMDS_PER_TYPE/8) = 32), as per DSP0240 |
| 200 | * @return pldm_completion_codes |
| 201 | */ |
vkaverap | a6575b8 | 2019-04-03 05:33:52 -0500 | [diff] [blame] | 202 | int decode_get_commands_resp(const uint8_t *msg, size_t payload_length, |
Deepak Kodihalli | 8c64346 | 2019-02-21 10:43:36 -0600 | [diff] [blame] | 203 | uint8_t *completion_code, bitfield8_t *commands); |
Deepak Kodihalli | 1b24f97 | 2019-02-01 04:09:13 -0600 | [diff] [blame] | 204 | |
Sampa Misra | 432e187 | 2019-02-13 03:49:43 -0600 | [diff] [blame] | 205 | /* GetPLDMVersion */ |
| 206 | |
| 207 | /** @brief Create a PLDM request for GetPLDMVersion |
| 208 | * |
| 209 | * @param[in] instance_id - Message's instance id |
| 210 | * @param[in] transfer_handle - Handle to identify PLDM version data transfer. |
| 211 | * This handle is ignored by the responder when the |
| 212 | * transferop_flag is set to getFirstPart. |
| 213 | * @param[in] transfer_opflag - flag to indicate whether it is start of |
| 214 | * transfer |
| 215 | * @param[in] type - PLDM Type for which version is requested |
| 216 | * @param[in,out] msg - Message will be written to this |
| 217 | * @return pldm_completion_codes |
| 218 | * @note Caller is responsible for memory alloc and dealloc of param |
vkaverap | a6575b8 | 2019-04-03 05:33:52 -0500 | [diff] [blame] | 219 | * 'msg.payload' |
Sampa Misra | 432e187 | 2019-02-13 03:49:43 -0600 | [diff] [blame] | 220 | */ |
| 221 | int encode_get_version_req(uint8_t instance_id, uint32_t transfer_handle, |
| 222 | uint8_t transfer_opflag, uint8_t type, |
| 223 | struct pldm_msg *msg); |
| 224 | |
| 225 | /** @brief Decode a GetPLDMVersion response message |
| 226 | * |
| 227 | * @param[in] msg - Response message payload |
vkaverap | a6575b8 | 2019-04-03 05:33:52 -0500 | [diff] [blame] | 228 | * @param[in] payload_length - Length of reponse message payload |
Deepak Kodihalli | 8c64346 | 2019-02-21 10:43:36 -0600 | [diff] [blame] | 229 | * @param[out] completion_code - Pointer to response msg's PLDM completion code |
Sampa Misra | 432e187 | 2019-02-13 03:49:43 -0600 | [diff] [blame] | 230 | * @param[out] next_transfer_handle - the next handle for the next part of data |
| 231 | * @param[out] transfer_flag - flag to indicate the part of data |
| 232 | * @return pldm_completion_codes |
| 233 | */ |
vkaverap | a6575b8 | 2019-04-03 05:33:52 -0500 | [diff] [blame] | 234 | int decode_get_version_resp(const uint8_t *msg, size_t payload_length, |
Deepak Kodihalli | 8c64346 | 2019-02-21 10:43:36 -0600 | [diff] [blame] | 235 | uint8_t *completion_code, |
Sampa Misra | 432e187 | 2019-02-13 03:49:43 -0600 | [diff] [blame] | 236 | uint32_t *next_transfer_handle, |
Deepak Kodihalli | 97e0bd5 | 2019-02-21 03:54:22 -0600 | [diff] [blame] | 237 | uint8_t *transfer_flag, ver32_t *version); |
Sampa Misra | 432e187 | 2019-02-13 03:49:43 -0600 | [diff] [blame] | 238 | |
Deepak Kodihalli | 1b24f97 | 2019-02-01 04:09:13 -0600 | [diff] [blame] | 239 | /* Responder */ |
| 240 | |
| 241 | /* GetPLDMTypes */ |
| 242 | |
| 243 | /** @brief Create a PLDM response message for GetPLDMTypes |
| 244 | * |
| 245 | * @param[in] instance_id - Message's instance id |
| 246 | * @param[in] completion_code - PLDM completion code |
Deepak Kodihalli | 97e0bd5 | 2019-02-21 03:54:22 -0600 | [diff] [blame] | 247 | * @param[in] types - pointer to array bitfield8_t[8] containing supported |
Deepak Kodihalli | 1b24f97 | 2019-02-01 04:09:13 -0600 | [diff] [blame] | 248 | * types (MAX_TYPES/8) = 8), as per DSP0240 |
| 249 | * @param[in,out] msg - Message will be written to this |
| 250 | * @return pldm_completion_codes |
| 251 | * @note Caller is responsible for memory alloc and dealloc of param |
vkaverap | a6575b8 | 2019-04-03 05:33:52 -0500 | [diff] [blame] | 252 | * 'msg.payload' |
Deepak Kodihalli | 1b24f97 | 2019-02-01 04:09:13 -0600 | [diff] [blame] | 253 | */ |
| 254 | int encode_get_types_resp(uint8_t instance_id, uint8_t completion_code, |
Deepak Kodihalli | 97e0bd5 | 2019-02-21 03:54:22 -0600 | [diff] [blame] | 255 | const bitfield8_t *types, struct pldm_msg *msg); |
Deepak Kodihalli | 1b24f97 | 2019-02-01 04:09:13 -0600 | [diff] [blame] | 256 | |
| 257 | /* GetPLDMCommands */ |
| 258 | |
| 259 | /** @brief Decode GetPLDMCommands' request data |
| 260 | * |
vkaverap | a6575b8 | 2019-04-03 05:33:52 -0500 | [diff] [blame] | 261 | * @param[in] msg - Request message |
| 262 | * @param[in] payload_length - Length of request message payload |
Deepak Kodihalli | 1b24f97 | 2019-02-01 04:09:13 -0600 | [diff] [blame] | 263 | * @param[out] type - PLDM Type |
| 264 | * @param[out] version - Version for PLDM Type |
| 265 | * @return pldm_completion_codes |
| 266 | */ |
vkaverap | a6575b8 | 2019-04-03 05:33:52 -0500 | [diff] [blame] | 267 | int decode_get_commands_req(const uint8_t *msg, size_t payload_length, |
| 268 | uint8_t *type, ver32_t *version); |
Deepak Kodihalli | 1b24f97 | 2019-02-01 04:09:13 -0600 | [diff] [blame] | 269 | |
| 270 | /** @brief Create a PLDM response message for GetPLDMCommands |
| 271 | * |
| 272 | * @param[in] instance_id - Message's instance id |
| 273 | * @param[in] completion_code - PLDM completion code |
Deepak Kodihalli | 97e0bd5 | 2019-02-21 03:54:22 -0600 | [diff] [blame] | 274 | * @param[in] commands - pointer to array bitfield8_t[32] containing supported |
Deepak Kodihalli | 1b24f97 | 2019-02-01 04:09:13 -0600 | [diff] [blame] | 275 | * commands (PLDM_MAX_CMDS_PER_TYPE/8) = 32), as per DSP0240 |
| 276 | * @param[in,out] msg - Message will be written to this |
| 277 | * @return pldm_completion_codes |
| 278 | * @note Caller is responsible for memory alloc and dealloc of param |
vkaverap | a6575b8 | 2019-04-03 05:33:52 -0500 | [diff] [blame] | 279 | * 'msg.payload' |
Deepak Kodihalli | 1b24f97 | 2019-02-01 04:09:13 -0600 | [diff] [blame] | 280 | */ |
| 281 | int encode_get_commands_resp(uint8_t instance_id, uint8_t completion_code, |
Deepak Kodihalli | 97e0bd5 | 2019-02-21 03:54:22 -0600 | [diff] [blame] | 282 | const bitfield8_t *commands, struct pldm_msg *msg); |
Deepak Kodihalli | 1b24f97 | 2019-02-01 04:09:13 -0600 | [diff] [blame] | 283 | |
Sampa Misra | 432e187 | 2019-02-13 03:49:43 -0600 | [diff] [blame] | 284 | /* GetPLDMVersion */ |
| 285 | |
| 286 | /** @brief Create a PLDM response for GetPLDMVersion |
| 287 | * |
| 288 | * @param[in] instance_id - Message's instance id |
| 289 | * @param[in] completion_code - PLDM completion code |
| 290 | * @param[in] next_transfer_handle - Handle to identify next portion of |
| 291 | * data transfer |
| 292 | * @param[in] transfer_flag - Represents the part of transfer |
| 293 | * @param[in] version_data - the version data |
| 294 | * @param[in] version_size - size of version data |
| 295 | * @param[in,out] msg - Message will be written to this |
| 296 | * @return pldm_completion_codes |
| 297 | * @note Caller is responsible for memory alloc and dealloc of param |
vkaverap | a6575b8 | 2019-04-03 05:33:52 -0500 | [diff] [blame] | 298 | * 'msg.payload' |
Sampa Misra | 432e187 | 2019-02-13 03:49:43 -0600 | [diff] [blame] | 299 | */ |
| 300 | int encode_get_version_resp(uint8_t instance_id, uint8_t completion_code, |
| 301 | uint32_t next_transfer_handle, |
Deepak Kodihalli | 97e0bd5 | 2019-02-21 03:54:22 -0600 | [diff] [blame] | 302 | uint8_t transfer_flag, const ver32_t *version_data, |
Sampa Misra | 432e187 | 2019-02-13 03:49:43 -0600 | [diff] [blame] | 303 | size_t version_size, struct pldm_msg *msg); |
| 304 | |
| 305 | /** @brief Decode a GetPLDMVersion request message |
| 306 | * |
vkaverap | a6575b8 | 2019-04-03 05:33:52 -0500 | [diff] [blame] | 307 | * @param[in] msg - Request message |
| 308 | * @param[in] payload_length - length of request message payload |
Sampa Misra | 432e187 | 2019-02-13 03:49:43 -0600 | [diff] [blame] | 309 | * @param[out] transfer_handle - the handle of data |
| 310 | * @param[out] transfer_opflag - Transfer Flag |
| 311 | * @param[out] type - PLDM type for which version is requested |
| 312 | * @return pldm_completion_codes |
| 313 | */ |
vkaverap | a6575b8 | 2019-04-03 05:33:52 -0500 | [diff] [blame] | 314 | int decode_get_version_req(const uint8_t *msg, size_t payload_length, |
Sampa Misra | 432e187 | 2019-02-13 03:49:43 -0600 | [diff] [blame] | 315 | uint32_t *transfer_handle, uint8_t *transfer_opflag, |
| 316 | uint8_t *type); |
| 317 | |
Deepak Kodihalli | 1b24f97 | 2019-02-01 04:09:13 -0600 | [diff] [blame] | 318 | #ifdef __cplusplus |
| 319 | } |
| 320 | #endif |
| 321 | |
| 322 | #endif /* BASE_H */ |