1286b96f4SSieu Mun Tang /* 2286b96f4SSieu Mun Tang * Copyright (c) 2020-2022, Intel Corporation. All rights reserved. 3286b96f4SSieu Mun Tang * 4286b96f4SSieu Mun Tang * SPDX-License-Identifier: BSD-3-Clause 5286b96f4SSieu Mun Tang */ 6286b96f4SSieu Mun Tang 7286b96f4SSieu Mun Tang #ifndef SOCFPGA_FCS_H 8286b96f4SSieu Mun Tang #define SOCFPGA_FCS_H 9286b96f4SSieu Mun Tang 10286b96f4SSieu Mun Tang /* FCS Definitions */ 11286b96f4SSieu Mun Tang 12286b96f4SSieu Mun Tang #define FCS_RANDOM_WORD_SIZE 8U 13286b96f4SSieu Mun Tang #define FCS_PROV_DATA_WORD_SIZE 44U 1477902fcaSSieu Mun Tang #define FCS_SHA384_WORD_SIZE 12U 15286b96f4SSieu Mun Tang 16286b96f4SSieu Mun Tang #define FCS_RANDOM_BYTE_SIZE (FCS_RANDOM_WORD_SIZE * 4U) 1724f9dc8aSSieu Mun Tang #define FCS_RANDOM_EXT_MAX_WORD_SIZE 1020U 18286b96f4SSieu Mun Tang #define FCS_PROV_DATA_BYTE_SIZE (FCS_PROV_DATA_WORD_SIZE * 4U) 1977902fcaSSieu Mun Tang #define FCS_SHA384_BYTE_SIZE (FCS_SHA384_WORD_SIZE * 4U) 20286b96f4SSieu Mun Tang 2124f9dc8aSSieu Mun Tang #define FCS_RANDOM_EXT_OFFSET 3 2224f9dc8aSSieu Mun Tang 2302d3ef33SSieu Mun Tang #define FCS_MODE_DECRYPT 0x0 2402d3ef33SSieu Mun Tang #define FCS_MODE_ENCRYPT 0x1 2502d3ef33SSieu Mun Tang #define FCS_ENCRYPTION_DATA_0 0x10100 2602d3ef33SSieu Mun Tang #define FCS_DECRYPTION_DATA_0 0x10102 2702d3ef33SSieu Mun Tang #define FCS_OWNER_ID_OFFSET 0xC 28537ff052SSieu Mun Tang #define FCS_CRYPTION_CRYPTO_HEADER 0x07000000 29537ff052SSieu Mun Tang #define FCS_CRYPTION_RESP_WORD_SIZE 4U 30537ff052SSieu Mun Tang #define FCS_CRYPTION_RESP_SIZE_OFFSET 3U 31286b96f4SSieu Mun Tang 32d1740831SSieu Mun Tang #define PSGSIGMA_TEARDOWN_MAGIC 0xB852E2A4 33d1740831SSieu Mun Tang #define PSGSIGMA_SESSION_ID_ONE 0x1 34d1740831SSieu Mun Tang #define PSGSIGMA_UNKNOWN_SESSION 0xFFFFFFFF 35d1740831SSieu Mun Tang 36d1740831SSieu Mun Tang #define RESERVED_AS_ZERO 0x0 377facacecSSieu Mun Tang /* FCS Single cert */ 387facacecSSieu Mun Tang 397facacecSSieu Mun Tang #define FCS_BIG_CNTR_SEL 0x1 407facacecSSieu Mun Tang 417facacecSSieu Mun Tang #define FCS_SVN_CNTR_0_SEL 0x2 427facacecSSieu Mun Tang #define FCS_SVN_CNTR_1_SEL 0x3 437facacecSSieu Mun Tang #define FCS_SVN_CNTR_2_SEL 0x4 447facacecSSieu Mun Tang #define FCS_SVN_CNTR_3_SEL 0x5 457facacecSSieu Mun Tang 467facacecSSieu Mun Tang #define FCS_BIG_CNTR_VAL_MAX 495U 477facacecSSieu Mun Tang #define FCS_SVN_CNTR_VAL_MAX 64U 48d1740831SSieu Mun Tang 49581182c1SSieu Mun Tang /* FCS Attestation Cert Request Parameter */ 50581182c1SSieu Mun Tang 51581182c1SSieu Mun Tang #define FCS_ALIAS_CERT 0x01 52581182c1SSieu Mun Tang #define FCS_DEV_ID_SELF_SIGN_CERT 0x02 53581182c1SSieu Mun Tang #define FCS_DEV_ID_ENROLL_CERT 0x04 54581182c1SSieu Mun Tang #define FCS_ENROLL_SELF_SIGN_CERT 0x08 55581182c1SSieu Mun Tang #define FCS_PLAT_KEY_CERT 0x10 56581182c1SSieu Mun Tang 57342a0618SSieu Mun Tang /* FCS Crypto Service */ 58342a0618SSieu Mun Tang 59342a0618SSieu Mun Tang #define FCS_CS_KEY_OBJ_MAX_WORD_SIZE 88U 60342a0618SSieu Mun Tang #define FCS_CS_KEY_INFO_MAX_WORD_SIZE 36U 61342a0618SSieu Mun Tang #define FCS_CS_KEY_RESP_STATUS_MASK 0xFF 62342a0618SSieu Mun Tang #define FCS_CS_KEY_RESP_STATUS_OFFSET 16U 63342a0618SSieu Mun Tang 6424f9dc8aSSieu Mun Tang #define FCS_CS_FIELD_SIZE_MASK 0xFFFF 6524f9dc8aSSieu Mun Tang #define FCS_CS_FIELD_FLAG_OFFSET 24 6624f9dc8aSSieu Mun Tang #define FCS_CS_FIELD_FLAG_INIT BIT(0) 6724f9dc8aSSieu Mun Tang #define FCS_CS_FIELD_FLAG_UPDATE BIT(1) 6824f9dc8aSSieu Mun Tang #define FCS_CS_FIELD_FLAG_FINALIZE BIT(2) 6924f9dc8aSSieu Mun Tang 706726390eSSieu Mun Tang #define FCS_AES_MAX_DATA_SIZE 0x10000000 /* 256 MB */ 716726390eSSieu Mun Tang #define FCS_AES_MIN_DATA_SIZE 0x20 /* 32 Byte */ 726726390eSSieu Mun Tang #define FCS_AES_CMD_MAX_WORD_SIZE 15U 736726390eSSieu Mun Tang 747e8249a2SSieu Mun Tang #define FCS_GET_DIGEST_CMD_MAX_WORD_SIZE 7U 757e8249a2SSieu Mun Tang #define FCS_GET_DIGEST_RESP_MAX_WORD_SIZE 19U 76c05ea296SSieu Mun Tang #define FCS_MAC_VERIFY_CMD_MAX_WORD_SIZE 23U 77c05ea296SSieu Mun Tang #define FCS_MAC_VERIFY_RESP_MAX_WORD_SIZE 4U 787e8249a2SSieu Mun Tang #define FCS_SHA_HMAC_CRYPTO_PARAM_SIZE_OFFSET 8U 79d2fee94aSSieu Mun Tang 80d2fee94aSSieu Mun Tang #define FCS_ECDSA_GET_PUBKEY_MAX_WORD_SIZE 5U 81*07912da1SSieu Mun Tang #define FCS_ECDSA_SHA2_DATA_SIGN_CMD_MAX_WORD_SIZE 7U 82286b96f4SSieu Mun Tang /* FCS Payload Structure */ 8324f9dc8aSSieu Mun Tang typedef struct fcs_rng_payload_t { 8424f9dc8aSSieu Mun Tang uint32_t session_id; 8524f9dc8aSSieu Mun Tang uint32_t context_id; 8624f9dc8aSSieu Mun Tang uint32_t crypto_header; 8724f9dc8aSSieu Mun Tang uint32_t size; 8824f9dc8aSSieu Mun Tang } fcs_rng_payload; 89286b96f4SSieu Mun Tang 9002d3ef33SSieu Mun Tang typedef struct fcs_encrypt_payload_t { 91286b96f4SSieu Mun Tang uint32_t first_word; 92286b96f4SSieu Mun Tang uint32_t src_addr; 93286b96f4SSieu Mun Tang uint32_t src_size; 94286b96f4SSieu Mun Tang uint32_t dst_addr; 95286b96f4SSieu Mun Tang uint32_t dst_size; 9602d3ef33SSieu Mun Tang } fcs_encrypt_payload; 9702d3ef33SSieu Mun Tang 9802d3ef33SSieu Mun Tang typedef struct fcs_decrypt_payload_t { 9902d3ef33SSieu Mun Tang uint32_t first_word; 10002d3ef33SSieu Mun Tang uint32_t owner_id[2]; 10102d3ef33SSieu Mun Tang uint32_t src_addr; 10202d3ef33SSieu Mun Tang uint32_t src_size; 10302d3ef33SSieu Mun Tang uint32_t dst_addr; 10402d3ef33SSieu Mun Tang uint32_t dst_size; 10502d3ef33SSieu Mun Tang } fcs_decrypt_payload; 106286b96f4SSieu Mun Tang 107537ff052SSieu Mun Tang typedef struct fcs_encrypt_ext_payload_t { 108537ff052SSieu Mun Tang uint32_t session_id; 109537ff052SSieu Mun Tang uint32_t context_id; 110537ff052SSieu Mun Tang uint32_t crypto_header; 111537ff052SSieu Mun Tang uint32_t src_addr; 112537ff052SSieu Mun Tang uint32_t src_size; 113537ff052SSieu Mun Tang uint32_t dst_addr; 114537ff052SSieu Mun Tang uint32_t dst_size; 115537ff052SSieu Mun Tang } fcs_encrypt_ext_payload; 116537ff052SSieu Mun Tang 117537ff052SSieu Mun Tang typedef struct fcs_decrypt_ext_payload_t { 118537ff052SSieu Mun Tang uint32_t session_id; 119537ff052SSieu Mun Tang uint32_t context_id; 120537ff052SSieu Mun Tang uint32_t crypto_header; 121537ff052SSieu Mun Tang uint32_t owner_id[2]; 122537ff052SSieu Mun Tang uint32_t src_addr; 123537ff052SSieu Mun Tang uint32_t src_size; 124537ff052SSieu Mun Tang uint32_t dst_addr; 125537ff052SSieu Mun Tang uint32_t dst_size; 126537ff052SSieu Mun Tang } fcs_decrypt_ext_payload; 127537ff052SSieu Mun Tang 128d1740831SSieu Mun Tang typedef struct psgsigma_teardown_msg_t { 129d1740831SSieu Mun Tang uint32_t reserved_word; 130d1740831SSieu Mun Tang uint32_t magic_word; 131d1740831SSieu Mun Tang uint32_t session_id; 132d1740831SSieu Mun Tang } psgsigma_teardown_msg; 133d1740831SSieu Mun Tang 1347facacecSSieu Mun Tang typedef struct fcs_cntr_set_preauth_payload_t { 1357facacecSSieu Mun Tang uint32_t first_word; 1367facacecSSieu Mun Tang uint32_t counter_value; 1377facacecSSieu Mun Tang } fcs_cntr_set_preauth_payload; 138d1740831SSieu Mun Tang 139342a0618SSieu Mun Tang typedef struct fcs_cs_key_payload_t { 140342a0618SSieu Mun Tang uint32_t session_id; 141342a0618SSieu Mun Tang uint32_t reserved0; 142342a0618SSieu Mun Tang uint32_t reserved1; 143342a0618SSieu Mun Tang uint32_t key_id; 144342a0618SSieu Mun Tang } fcs_cs_key_payload; 145342a0618SSieu Mun Tang 1467e8249a2SSieu Mun Tang typedef struct fcs_crypto_service_data_t { 1477e8249a2SSieu Mun Tang uint32_t session_id; 1487e8249a2SSieu Mun Tang uint32_t context_id; 1497e8249a2SSieu Mun Tang uint32_t key_id; 1507e8249a2SSieu Mun Tang uint32_t crypto_param_size; 1517e8249a2SSieu Mun Tang uint64_t crypto_param; 1527e8249a2SSieu Mun Tang } fcs_crypto_service_data; 1537e8249a2SSieu Mun Tang 1546726390eSSieu Mun Tang typedef struct fcs_crypto_service_aes_data_t { 1556726390eSSieu Mun Tang uint32_t session_id; 1566726390eSSieu Mun Tang uint32_t context_id; 1576726390eSSieu Mun Tang uint32_t param_size; 1586726390eSSieu Mun Tang uint32_t key_id; 1596726390eSSieu Mun Tang uint32_t crypto_param[7]; 1606726390eSSieu Mun Tang } fcs_crypto_service_aes_data; 1616726390eSSieu Mun Tang 162286b96f4SSieu Mun Tang /* Functions Definitions */ 163286b96f4SSieu Mun Tang 164286b96f4SSieu Mun Tang uint32_t intel_fcs_random_number_gen(uint64_t addr, uint64_t *ret_size, 165286b96f4SSieu Mun Tang uint32_t *mbox_error); 16624f9dc8aSSieu Mun Tang int intel_fcs_random_number_gen_ext(uint32_t session_id, uint32_t context_id, 16724f9dc8aSSieu Mun Tang uint32_t size, uint32_t *send_id); 168286b96f4SSieu Mun Tang uint32_t intel_fcs_send_cert(uint64_t addr, uint64_t size, 169286b96f4SSieu Mun Tang uint32_t *send_id); 170286b96f4SSieu Mun Tang uint32_t intel_fcs_get_provision_data(uint32_t *send_id); 1717facacecSSieu Mun Tang uint32_t intel_fcs_cntr_set_preauth(uint8_t counter_type, 1727facacecSSieu Mun Tang int32_t counter_value, 1737facacecSSieu Mun Tang uint32_t test_bit, 1747facacecSSieu Mun Tang uint32_t *mbox_error); 17502d3ef33SSieu Mun Tang uint32_t intel_fcs_encryption(uint32_t src_addr, uint32_t src_size, 17602d3ef33SSieu Mun Tang uint32_t dst_addr, uint32_t dst_size, 17702d3ef33SSieu Mun Tang uint32_t *send_id); 17802d3ef33SSieu Mun Tang 17902d3ef33SSieu Mun Tang uint32_t intel_fcs_decryption(uint32_t src_addr, uint32_t src_size, 18002d3ef33SSieu Mun Tang uint32_t dst_addr, uint32_t dst_size, 18102d3ef33SSieu Mun Tang uint32_t *send_id); 182286b96f4SSieu Mun Tang 183537ff052SSieu Mun Tang int intel_fcs_encryption_ext(uint32_t session_id, uint32_t context_id, 184537ff052SSieu Mun Tang uint32_t src_addr, uint32_t src_size, 185537ff052SSieu Mun Tang uint32_t dst_addr, uint32_t *dst_size, 186537ff052SSieu Mun Tang uint32_t *mbox_error); 187537ff052SSieu Mun Tang int intel_fcs_decryption_ext(uint32_t sesion_id, uint32_t context_id, 188537ff052SSieu Mun Tang uint32_t src_addr, uint32_t src_size, 189537ff052SSieu Mun Tang uint32_t dst_addr, uint32_t *dst_size, 190537ff052SSieu Mun Tang uint32_t *mbox_error); 191537ff052SSieu Mun Tang 192d1740831SSieu Mun Tang int intel_fcs_sigma_teardown(uint32_t session_id, uint32_t *mbox_error); 193d1740831SSieu Mun Tang int intel_fcs_chip_id(uint32_t *id_low, uint32_t *id_high, uint32_t *mbox_error); 194d1740831SSieu Mun Tang int intel_fcs_attestation_subkey(uint64_t src_addr, uint32_t src_size, 195d1740831SSieu Mun Tang uint64_t dst_addr, uint32_t *dst_size, 196d1740831SSieu Mun Tang uint32_t *mbox_error); 197d1740831SSieu Mun Tang int intel_fcs_get_measurement(uint64_t src_addr, uint32_t src_size, 198d1740831SSieu Mun Tang uint64_t dst_addr, uint32_t *dst_size, 199d1740831SSieu Mun Tang uint32_t *mbox_error); 20077902fcaSSieu Mun Tang uint32_t intel_fcs_get_rom_patch_sha384(uint64_t addr, uint64_t *ret_size, 20177902fcaSSieu Mun Tang uint32_t *mbox_error); 20277902fcaSSieu Mun Tang 203581182c1SSieu Mun Tang int intel_fcs_create_cert_on_reload(uint32_t cert_request, 204581182c1SSieu Mun Tang uint32_t *mbox_error); 205581182c1SSieu Mun Tang int intel_fcs_get_attestation_cert(uint32_t cert_request, uint64_t dst_addr, 206581182c1SSieu Mun Tang uint32_t *dst_size, uint32_t *mbox_error); 207581182c1SSieu Mun Tang 2086dc00c24SSieu Mun Tang int intel_fcs_open_crypto_service_session(uint32_t *session_id, 2096dc00c24SSieu Mun Tang uint32_t *mbox_error); 2106dc00c24SSieu Mun Tang int intel_fcs_close_crypto_service_session(uint32_t session_id, 2116dc00c24SSieu Mun Tang uint32_t *mbox_error); 2126dc00c24SSieu Mun Tang 213342a0618SSieu Mun Tang int intel_fcs_import_crypto_service_key(uint64_t src_addr, uint32_t src_size, 214342a0618SSieu Mun Tang uint32_t *mbox_error); 215342a0618SSieu Mun Tang int intel_fcs_export_crypto_service_key(uint32_t session_id, uint32_t key_id, 216342a0618SSieu Mun Tang uint64_t dst_addr, uint32_t *dst_size, 217342a0618SSieu Mun Tang uint32_t *mbox_error); 218342a0618SSieu Mun Tang int intel_fcs_remove_crypto_service_key(uint32_t session_id, uint32_t key_id, 219342a0618SSieu Mun Tang uint32_t *mbox_error); 220342a0618SSieu Mun Tang int intel_fcs_get_crypto_service_key_info(uint32_t session_id, uint32_t key_id, 221342a0618SSieu Mun Tang uint64_t dst_addr, uint32_t *dst_size, 222342a0618SSieu Mun Tang uint32_t *mbox_error); 223342a0618SSieu Mun Tang 2247e8249a2SSieu Mun Tang int intel_fcs_get_digest_init(uint32_t session_id, uint32_t context_id, 2257e8249a2SSieu Mun Tang uint32_t key_id, uint32_t param_size, 2267e8249a2SSieu Mun Tang uint64_t param_data, uint32_t *mbox_error); 2277e8249a2SSieu Mun Tang int intel_fcs_get_digest_finalize(uint32_t session_id, uint32_t context_id, 2287e8249a2SSieu Mun Tang uint32_t src_addr, uint32_t src_size, 2297e8249a2SSieu Mun Tang uint64_t dst_addr, uint32_t *dst_size, 2307e8249a2SSieu Mun Tang uint32_t *mbox_error); 2317e8249a2SSieu Mun Tang 232c05ea296SSieu Mun Tang int intel_fcs_mac_verify_init(uint32_t session_id, uint32_t context_id, 233c05ea296SSieu Mun Tang uint32_t key_id, uint32_t param_size, 234c05ea296SSieu Mun Tang uint64_t param_data, uint32_t *mbox_error); 235c05ea296SSieu Mun Tang int intel_fcs_mac_verify_finalize(uint32_t session_id, uint32_t context_id, 236c05ea296SSieu Mun Tang uint32_t src_addr, uint32_t src_size, 237c05ea296SSieu Mun Tang uint64_t dst_addr, uint32_t *dst_size, 238c05ea296SSieu Mun Tang uint32_t data_size, uint32_t *mbox_error); 239c05ea296SSieu Mun Tang 240*07912da1SSieu Mun Tang int intel_fcs_ecdsa_sha2_data_sign_init(uint32_t session_id, 241*07912da1SSieu Mun Tang uint32_t context_id, uint32_t key_id, 242*07912da1SSieu Mun Tang uint32_t param_size, uint64_t param_data, 243*07912da1SSieu Mun Tang uint32_t *mbox_error); 244*07912da1SSieu Mun Tang int intel_fcs_ecdsa_sha2_data_sign_finalize(uint32_t session_id, 245*07912da1SSieu Mun Tang uint32_t context_id, uint32_t src_addr, 246*07912da1SSieu Mun Tang uint32_t src_size, uint64_t dst_addr, 247*07912da1SSieu Mun Tang uint32_t *dst_size, uint32_t *mbox_error); 248*07912da1SSieu Mun Tang 249d2fee94aSSieu Mun Tang int intel_fcs_ecdsa_get_pubkey_init(uint32_t session_id, uint32_t context_id, 250d2fee94aSSieu Mun Tang uint32_t key_id, uint32_t param_size, 251d2fee94aSSieu Mun Tang uint64_t param_data, uint32_t *mbox_error); 252d2fee94aSSieu Mun Tang int intel_fcs_ecdsa_get_pubkey_finalize(uint32_t session_id, uint32_t context_id, 253d2fee94aSSieu Mun Tang uint64_t dst_addr, uint32_t *dst_size, 254d2fee94aSSieu Mun Tang uint32_t *mbox_error); 255d2fee94aSSieu Mun Tang 2566726390eSSieu Mun Tang int intel_fcs_aes_crypt_init(uint32_t session_id, uint32_t context_id, 2576726390eSSieu Mun Tang uint32_t key_id, uint64_t param_addr, 2586726390eSSieu Mun Tang uint32_t param_size, uint32_t *mbox_error); 2596726390eSSieu Mun Tang int intel_fcs_aes_crypt_finalize(uint32_t session_id, uint32_t context_id, 2606726390eSSieu Mun Tang uint64_t src_addr, uint32_t src_size, 2616726390eSSieu Mun Tang uint64_t dst_addr, uint32_t dst_size, 2626726390eSSieu Mun Tang uint32_t *send_id); 2636726390eSSieu Mun Tang 264286b96f4SSieu Mun Tang #endif /* SOCFPGA_FCS_H */ 265