plugntrust.h

Go to the documentation of this file.

/****************************************************************************
** Copyright (C) 2020 MikroElektronika d.o.o.
** Contact: https://www.mikroe.com/contact
**
** Permission is hereby granted, free of charge, to any person obtaining a copy
** of this software and associated documentation files (the "Software"), to deal
** in the Software without restriction, including without limitation the rights
** to use, copy, modify, merge, publish, distribute, sublicense, and/or sell
** copies of the Software, and to permit persons to whom the Software is
** furnished to do so, subject to the following conditions:
** The above copyright notice and this permission notice shall be
** included in all copies or substantial portions of the Software.
**
** THE SOFTWARE IS PROVIDED "AS IS", WITHOUT WARRANTY OF ANY KIND,
** EXPRESS OR IMPLIED, INCLUDING BUT NOT LIMITED TO THE WARRANTIES
** OF MERCHANTABILITY, FITNESS FOR A PARTICULAR PURPOSE AND NONINFRINGEMENT.
** IN NO EVENT SHALL THE AUTHORS OR COPYRIGHT HOLDERS BE LIABLE FOR ANY CLAIM,
** DAMAGES OR OTHER LIABILITY, WHETHER IN AN ACTION OF CONTRACT, TORT
** OR OTHERWISE, ARISING FROM, OUT OF OR IN CONNECTION WITH THE SOFTWARE OR THE
**  USE OR OTHER DEALINGS IN THE SOFTWARE.
****************************************************************************/
 
#ifndef PLUGNTRUST_H
#define PLUGNTRUST_H
 
#ifdef __cplusplus
extern "C"{
#endif
 
#ifdef PREINIT_SUPPORTED
#include "preinit.h"
#endif
 
#ifdef MikroCCoreVersion
    #if MikroCCoreVersion >= 1
        #include "delays.h"
    #endif
#endif
 
#include "drv_digital_out.h"
#include "drv_digital_in.h"
#include "drv_i2c_master.h"
 
#define PLUGNTRUST_NAD_WRITE                            0x5A
#define PLUGNTRUST_NAD_READ                             0xA5
 
#define PLUGNTRUST_PCB_BLOCK_I                          0x00
#define PLUGNTRUST_PCB_BLOCK_I_NS_ENCODE                0x40
#define PLUGNTRUST_PCB_BLOCK_I_M_CHAIN                  0x20
 
#define PLUGNTRUST_PCB_BLOCK_R                          0x80
#define PLUGNTRUST_PCB_BLOCK_R_NR_ENCODE                0x10
#define PLUGNTRUST_PCB_BLOCK_R_ERROR_CRC                0x01
#define PLUGNTRUST_PCB_BLOCK_R_ERROR_OTHER              0x02
 
#define PLUGNTRUST_PCB_BLOCK_S                          0xC0
#define PLUGNTRUST_PCB_BLOCK_S_RESYNC_REQ               0x00
#define PLUGNTRUST_PCB_BLOCK_S_RESYNC_RSP               0x20
#define PLUGNTRUST_PCB_BLOCK_S_IFS_REQ                  0x01
#define PLUGNTRUST_PCB_BLOCK_S_IFS_RSP                  0x21
#define PLUGNTRUST_PCB_BLOCK_S_ABORT_REQ                0x02
#define PLUGNTRUST_PCB_BLOCK_S_ABORT_RSP                0x22
#define PLUGNTRUST_PCB_BLOCK_S_WTX_REQ                  0x03
#define PLUGNTRUST_PCB_BLOCK_S_WTX_RSP                  0x23
#define PLUGNTRUST_PCB_BLOCK_S_SOFT_RESET_REQ           0x0F
#define PLUGNTRUST_PCB_BLOCK_S_SOFT_RESET_RSP           0x2F
#define PLUGNTRUST_PCB_BLOCK_S_END_APDU_SESSION_REQ     0x05
#define PLUGNTRUST_PCB_BLOCK_S_END_APDU_SESSION_RSP     0x25
#define PLUGNTRUST_PCB_BLOCK_S_SE_RESET_REQ             0x06
#define PLUGNTRUST_PCB_BLOCK_S_SE_RESET_RSP             0x26
#define PLUGNTRUST_PCB_BLOCK_S_GET_ATR_REQ              0x07
#define PLUGNTRUST_PCB_BLOCK_S_GET_ATR_RSP              0x27
 
 // pcb
 
 
#define PLUGNTRUST_CLA_SECURE                           0x84
#define PLUGNTRUST_CLA_NOT_SECURE                       0x80
 
#define PLUGNTRUST_INS_MASK_INS_CHAR                    0xE0
#define PLUGNTRUST_INS_MASK_INSTRUCTION                 0x1F
#define PLUGNTRUST_INS_TRANSIENT                        0x80
#define PLUGNTRUST_INS_AUTH_OBJECT                      0x40 
#define PLUGNTRUST_INS_ATTEST                           0x20
#define PLUGNTRUST_INS_WRITE                            0x01
#define PLUGNTRUST_INS_READ                             0x02
#define PLUGNTRUST_INS_CRYPTO                           0x03
#define PLUGNTRUST_INS_MGMT                             0x04
#define PLUGNTRUST_INS_PROCESS                          0x05
#define PLUGNTRUST_INS_IMPORT_EXTERNAL                  0x06
 
#define PLUGNTRUST_P1_UNUSED                            0x80
#define PLUGNTRUST_P1_MASK_KEY_TYPE                     0x60
#define PLUGNTRUST_P1_MASK_CRED_TYPE                    0x1F
#define PLUGNTRUST_P1_KEY_PAIR                          0x60
#define PLUGNTRUST_P1_PRIVATE                           0x40
#define PLUGNTRUST_P1_PUBLIC                            0x20
#define PLUGNTRUST_P1_DEFAULT                           0x00
#define PLUGNTRUST_P1_EC                                0x01
#define PLUGNTRUST_P1_RSA                               0x02
#define PLUGNTRUST_P1_AES                               0x03
#define PLUGNTRUST_P1_DES                               0x04
#define PLUGNTRUST_P1_HMAC                              0x05
#define PLUGNTRUST_P1_BINARY                            0x06
#define PLUGNTRUST_P1_USERID                            0x07
#define PLUGNTRUST_P1_COUNTER                           0x08
#define PLUGNTRUST_P1_PCR                               0x09
#define PLUGNTRUST_P1_CURVE                             0x0B
#define PLUGNTRUST_P1_SIGNATURE                         0x0C
#define PLUGNTRUST_P1_MAC                               0x0D
#define PLUGNTRUST_P1_CIPHER                            0x0E
#define PLUGNTRUST_P1_TLS                               0x0F
#define PLUGNTRUST_P1_CRYPTO_OBJ                        0x10
 
#define PLUGNTRUST_P2_DEFAULT                           0x00
#define PLUGNTRUST_P2_GENERATE                          0x03
#define PLUGNTRUST_P2_CREATE                            0x04
#define PLUGNTRUST_P2_SIZE                              0x07
#define PLUGNTRUST_P2_SIGN                              0x09
#define PLUGNTRUST_P2_VERIFY                            0x0A
#define PLUGNTRUST_P2_INIT                              0x0B
#define PLUGNTRUST_P2_UPDATE                            0x0C
#define PLUGNTRUST_P2_FINAL                             0x0D
#define PLUGNTRUST_P2_ONESHOT                           0x0E
#define PLUGNTRUST_P2_DH                                0x0F
#define PLUGNTRUST_P2_DIVERSIFY                         0x10
#define PLUGNTRUST_P2_AUTH_FIRST_PART2                  0x12
#define PLUGNTRUST_P2_AUTH_NONFIRST_PART2               0x13
#define PLUGNTRUST_P2_DUMP_KEY                          0x14
#define PLUGNTRUST_P2_CHANGE_KEY_PART1                  0x15
#define PLUGNTRUST_P2_CHANGE_KEY_PART2                  0x16
#define PLUGNTRUST_P2_KILL_AUTH                         0x17
#define PLUGNTRUST_P2_IMPORT                            0x18
#define PLUGNTRUST_P2_EXPORT                            0x19
#define PLUGNTRUST_P2_SESSION_CREATE                    0x1B
#define PLUGNTRUST_P2_SESSION_CLOSE                     0x1C
#define PLUGNTRUST_P2_SESSION_REFRESH                   0x1E
#define PLUGNTRUST_P2_SESSION_POLICY                    0x1F
#define PLUGNTRUST_P2_VERSION                           0x20
#define PLUGNTRUST_P2_MEMORY                            0x22
#define PLUGNTRUST_P2_LIST                              0x25
#define PLUGNTRUST_P2_TYPE                              0x26
#define PLUGNTRUST_P2_EXIST                             0x27
#define PLUGNTRUST_P2_DELETE_OBJECT                     0x28
#define PLUGNTRUST_P2_DELETE_ALL                        0x2A
#define PLUGNTRUST_P2_SESSION_USERID                    0x2C
#define PLUGNTRUST_P2_HKDF                              0x2D
#define PLUGNTRUST_P2_PBKDF                             0x2E
#define PLUGNTRUST_P2_I2CM                              0x30
#define PLUGNTRUST_P2_I2CM_ATTESTED                     0x31
#define PLUGNTRUST_P2_MAC                               0x32
#define PLUGNTRUST_P2_UNLOCK_CHALLENGE                  0x33
#define PLUGNTRUST_P2_CURVE_LIST                        0x34
#define PLUGNTRUST_P2_SIGN_ECDAA                        0x35
#define PLUGNTRUST_P2_ID                                0x36
#define PLUGNTRUST_P2_ENCRYPT_ONESHOT                   0x37
#define PLUGNTRUST_P2_DECRYPT_ONESHOT                   0x38
#define PLUGNTRUST_P2_ATTEST                            0x3A
#define PLUGNTRUST_P2_ATTRIBUTES                        0x3B
#define PLUGNTRUST_P2_CPLC                              0x3C    
#define PLUGNTRUST_P2_TIME                              0x3D    
#define PLUGNTRUST_P2_TRANSPORT                         0x3E
#define PLUGNTRUST_P2_VARIANT                           0x3F
#define PLUGNTRUST_P2_PARAM                             0x40
#define PLUGNTRUST_P2_DELETE_CURVE                      0x41
#define PLUGNTRUST_P2_ENCRYPT                           0x42
#define PLUGNTRUST_P2_DECRYPT                           0x43
#define PLUGNTRUST_P2_VALIDATE                          0x44
#define PLUGNTRUST_P2_GENERATE_ONESHOT                  0x45
#define PLUGNTRUST_P2_VALIDATE_ONESHOT                  0x46
#define PLUGNTRUST_P2_CRYPTO_LIST                       0x47
#define PLUGNTRUST_P2_RANDOM                            0x49
#define PLUGNTRUST_P2_TLS_PMS                           0x4A
#define PLUGNTRUST_P2_TLS_PRF_CLI_HELLO                 0x4B
#define PLUGNTRUST_P2_TLS_PRF_SRV_HELLO                 0x4C
#define PLUGNTRUST_P2_TLS_PRF_CLI_RND                   0x4D
#define PLUGNTRUST_P2_TLS_PRF_SRV_RND                   0x4E
#define PLUGNTRUST_P2_RAW                               0x4F
#define PLUGNTRUST_P2_IMPORT_EXT                        0x51
#define PLUGNTRUST_P2_SCP                               0x52
#define PLUGNTRUST_P2_AUTH_FIRST_PART1                  0x53
#define PLUGNTRUST_P2_AUTH_NONFIRST_PART1               0x54
 
#define PLUGNTRUST_SECURE_OBJECT_TYPE_EC_KEY_PAIR       0x01
#define PLUGNTRUST_SECURE_OBJECT_TYPE_EC_PRIV_KEY       0x02
#define PLUGNTRUST_SECURE_OBJECT_TYPE_EC_PUB_KEY        0x03
#define PLUGNTRUST_SECURE_OBJECT_TYPE_RSA_KEY_PAIR      0x04
#define PLUGNTRUST_SECURE_OBJECT_TYPE_RSA_KEY_PAIR_CRT  0x05
#define PLUGNTRUST_SECURE_OBJECT_TYPE_RSA_PRIV_KEY      0x06
#define PLUGNTRUST_SECURE_OBJECT_TYPE_RSA_PRIV_KEY_CRT  0x07
#define PLUGNTRUST_SECURE_OBJECT_TYPE_RSA_PUB_KEY       0x08
#define PLUGNTRUST_SECURE_OBJECT_TYPE_AES_KEY           0x09
#define PLUGNTRUST_SECURE_OBJECT_TYPE_DES_KEY           0x0A
#define PLUGNTRUST_SECURE_OBJECT_TYPE_BINARY_FILE       0x0B
#define PLUGNTRUST_SECURE_OBJECT_TYPE_USERID            0x0C
#define PLUGNTRUST_SECURE_OBJECT_TYPE_COUNTER           0x0D
#define PLUGNTRUST_SECURE_OBJECT_TYPE_PCR               0x0F
#define PLUGNTRUST_SECURE_OBJECT_TYPE_CURVE             0x10
#define PLUGNTRUST_SECURE_OBJECT_TYPE_HMAC_KEY          0x11
 
#define PLUGNTRUST_MEM_PERSISTENT                       0x01
#define PLUGNTRUST_MEM_TRANSIENT_RESET                  0x02
#define PLUGNTRUST_MEM_TRANSIENT_DESELECT               0x03
 
#define PLUGNTRUST_ORIGIN_EXTERNAL                      0x01
#define PLUGNTRUST_ORIGIN_INTERNAL                      0x02
#define PLUGNTRUST_ORIGIN_PROVISIONED                   0x03
 
#define PLUGNTRUST_TLV_TAG_SESSION_ID                   0x10
#define PLUGNTRUST_TLV_TAG_POLICY                       0x11
#define PLUGNTRUST_TLV_TAG_MAX_ATTEMPTS                 0x12
#define PLUGNTRUST_TLV_TAG_IMPORT_AUTH_DATA             0x13
#define PLUGNTRUST_TLV_TAG_IMPORT_AUTH_KEY_ID           0x14
#define PLUGNTRUST_TLV_TAG_1                            0x41
#define PLUGNTRUST_TLV_TAG_2                            0x42
#define PLUGNTRUST_TLV_TAG_3                            0x43
#define PLUGNTRUST_TLV_TAG_4                            0x44
#define PLUGNTRUST_TLV_TAG_5                            0x45
#define PLUGNTRUST_TLV_TAG_6                            0x46
#define PLUGNTRUST_TLV_TAG_7                            0x47
#define PLUGNTRUST_TLV_TAG_8                            0x48
#define PLUGNTRUST_TLV_TAG_9                            0x49
#define PLUGNTRUST_TLV_TAG_10                           0x4A
 
#define PLUGNTRUST_ECS_SIG_ECDSA_PLAIN                  0x09
#define PLUGNTRUST_ECS_SIG_ECDSA_SHA                    0x11
#define PLUGNTRUST_ECS_SIG_ECDSA_SHA_224                0x25
#define PLUGNTRUST_ECS_SIG_ECDSA_SHA_256                0x21
#define PLUGNTRUST_ECS_SIG_ECDSA_SHA_384                0x22
#define PLUGNTRUST_ECS_SIG_ECDSA_SHA_512                0x26
#define PLUGNTRUST_ECS_SIG_ED25519PH_SHA_512            0xA3
#define PLUGNTRUST_ECS_SIG_ECDAA                        0xF4 
 
#define PLUGNTRUST_RSA_SHA1_PKCS1_PSS                   0x15
#define PLUGNTRUST_RSA_SHA224_PKCS1_PSS                 0x2B
#define PLUGNTRUST_RSA_SHA256_PKCS1_PSS                 0x2C
#define PLUGNTRUST_RSA_SHA384_PKCS1_PSS                 0x2D
#define PLUGNTRUST_RSA_SHA512_PKCS1_PSS                 0x2E
#define PLUGNTRUST_RSA_SHA1_PKCS1                       0x0A
#define PLUGNTRUST_RSA_SHA_224_PKCS1                    0x27
#define PLUGNTRUST_RSA_SHA_256_PKCS1                    0x28
#define PLUGNTRUST_RSA_SHA_384_PKCS1                    0x29
#define PLUGNTRUST_RSA_SHA_512_PKCS1                    0x2A
#define PLUGNTRUST_RSA_NO_PAD                           0x0C
#define PLUGNTRUST_RSA_PKCS1                            0x0A
#define PLUGNTRUST_RSA_PKCS1_OAEP                       0x0F
#define PLUGNTRUST_RSA_512                              512
#define PLUGNTRUST_RSA_1024                             1024
#define PLUGNTRUST_RSA_1152                             1152
#define PLUGNTRUST_RSA_2048                             2048
#define PLUGNTRUST_RSA_3072                             3072
#define PLUGNTRUST_RSA_4096                             4096
#define PLUGNTRUST_RSA_COMP_MOD                         0x00
#define PLUGNTRUST_RSA_COMP_PUB_EXP                     0x01
#define PLUGNTRUST_RSA_COMP_PRIV_EXP                    0x02
#define PLUGNTRUST_RSA_COMP_P                           0x03
#define PLUGNTRUST_RSA_COMP_Q                           0x04
#define PLUGNTRUST_RSA_COMP_DP                          0x05
#define PLUGNTRUST_RSA_COMP_DQ                          0x06
#define PLUGNTRUST_RSA_COMP_INVQ                        0x07
 
#define PLUGNTRUST_DIGEST_NO_HASH                       0x00
#define PLUGNTRUST_DIGEST_SHA                           0x01
#define PLUGNTRUST_DIGEST_SHA224                        0x07
#define PLUGNTRUST_DIGEST_SHA256                        0x04
#define PLUGNTRUST_DIGEST_SHA384                        0x05
#define PLUGNTRUST_DIGEST_SHA512                        0x06
 
#define PLUGNTRUST_HMAC_SHA1                            0x18
#define PLUGNTRUST_HMAC_SHA256                          0x19
#define PLUGNTRUST_HMAC_SHA384                          0x1A
#define PLUGNTRUST_HMAC_SHA512                          0x1B
#define PLUGNTRUST_CMAC_128                             0x31
 
#define PLUGNTRUST_ECC_UNUSED                           0x00
#define PLUGNTRUST_ECC_NIST_P192                        0x01
#define PLUGNTRUST_ECC_NIST_P224                        0x02
#define PLUGNTRUST_ECC_NIST_P256                        0x03
#define PLUGNTRUST_ECC_NIST_P384                        0x04
#define PLUGNTRUST_ECC_NIST_P521                        0x05
#define PLUGNTRUST_ECC_Brainpool160                     0x06
#define PLUGNTRUST_ECC_Brainpool192                     0x07
#define PLUGNTRUST_ECC_Brainpool224                     0x08
#define PLUGNTRUST_ECC_Brainpool256                     0x09
#define PLUGNTRUST_ECC_Brainpool320                     0x0A
#define PLUGNTRUST_ECC_Brainpool384                     0x0B
#define PLUGNTRUST_ECC_Brainpool512                     0x0C
#define PLUGNTRUST_ECC_Secp160k1                        0x0D
#define PLUGNTRUST_ECC_Secp192k1                        0x0E
#define PLUGNTRUST_ECC_Secp224k1                        0x0F
#define PLUGNTRUST_ECC_Secp256k1                        0x10
#define PLUGNTRUST_ECC_TPM_ECC_BN_P256                  0x11
#define PLUGNTRUST_ECC_ID_ECC_ED_25519                  0x40
#define PLUGNTRUST_ECC_ID_ECC_MONT_DH_25519             0x41
#define PLUGNTRUST_ECC_CURVE_PARAM_A                    0x01
#define PLUGNTRUST_ECC_CURVE_PARAM_B                    0x02
#define PLUGNTRUST_ECC_CURVE_PARAM_G                    0x04
#define PLUGNTRUST_ECC_CURVE_PARAM_N                    0x08
#define PLUGNTRUST_ECC_CURVE_PARAM_PRIME                0x10
 
#define PLUGNTRUST_CIPHER_DES_CBC_NOPAD                 0x01
#define PLUGNTRUST_CIPHER_DES_CBC_ISO9797_M1            0x02
#define PLUGNTRUST_CIPHER_DES_CBC_ISO9797_M2            0x03
#define PLUGNTRUST_CIPHER_DES_CBC_PKCS5                 0x04
#define PLUGNTRUST_CIPHER_DES_ECB_NOPAD                 0x05
#define PLUGNTRUST_CIPHER_DES_ECB_ISO9797_M1            0x06
#define PLUGNTRUST_CIPHER_DES_ECB_ISO9797_M2            0x07
#define PLUGNTRUST_CIPHER_DES_ECB_PKCS5                 0x08
#define PLUGNTRUST_CIPHER_AES_ECB_NOPAD                 0x0E
#define PLUGNTRUST_CIPHER_AES_CBC_NOPAD                 0x0D
#define PLUGNTRUST_CIPHER_AES_CBC_ISO9797_M1            0x16
#define PLUGNTRUST_CIPHER_AES_CBC_ISO9797_M2            0x17
#define PLUGNTRUST_CIPHER_AES_CBC_PKCS5                 0x18
#define PLUGNTRUST_CIPHER_AES_CTR                       0xF0
 
#define PLUGNTRUST_CONFIG_ECDAA                         0x0001
#define PLUGNTRUST_CONFIG_ECDSA_ECDH_ECDHE              0x0002
#define PLUGNTRUST_CONFIG_EDDSA                         0x0004
#define PLUGNTRUST_CONFIG_DH_MONT                       0x0008
#define PLUGNTRUST_CONFIG_HMAC                          0x0010
#define PLUGNTRUST_CONFIG_RSA_PLAIN                     0x0020
#define PLUGNTRUST_CONFIG_RSA_CRT                       0x0040
#define PLUGNTRUST_CONFIG_AES                           0x0080
#define PLUGNTRUST_CONFIG_DES                           0x0100
#define PLUGNTRUST_CONFIG_PBKDF                         0x0200
#define PLUGNTRUST_CONFIG_TLS                           0x0400
#define PLUGNTRUST_CONFIG_MIFARE                        0x0800
#define PLUGNTRUST_CONFIG_FIPS_MODE_DISABLED            0x1000
#define PLUGNTRUST_CONFIG_I2CM                          0x2000
#define PLUGNTRUST_CONFIG_ECC_ALL                       0x000F
#define PLUGNTRUST_CONFIG_RSA_ALL                       0x0060
#define PLUGNTRUST_CONFIG_ALL                           0x3FFF
 
#define PLUGNTRUST_TRANSIENT_LOCK                       0x01
#define PLUGNTRUST_PERSISTENT_LOCK                      0x02
 
#define PLUGNTRUST_LOCKED                               0x01
 
#define PLUGNTRUST_CC_DIGEST                            0x01
#define PLUGNTRUST_CC_CIPHER                            0x02
#define PLUGNTRUST_CC_SIGNATURE                         0x03
 
#define PLUGNTRUST_RESULT_SUCCESS                       0x01
#define PLUGNTRUST_RESULT_FAILURE                       0x02
 
#define PLUGNTRUST_PERSISTENT                           0x01
#define PLUGNTRUST_TRANSIENT                            0x02
 
#define PLUGNTRUST_NOT_SET                              0x01
#define PLUGNTRUST_SET                                  0x02
 
#define PLUGNTRUST_NO_MORE                              0x01
#define PLUGNTRUST_MORE                                 0x02
 
#define PLUGNTRUST_SCP_REQUIRED                         0x01
#define PLUGNTRUST_SCP_NOT_REQUIRED                     0x02
 
#define PLUGNTRUST_APPLET_RES_ID_TRANSPORT              0x7FFF0200ul
#define PLUGNTRUST_APPLET_RES_ID_KP_FASTSCP_USER        0x7FFF0201ul
#define PLUGNTRUST_APPLET_RES_ID_KP_FASTSCP_IMPORT      0x7FFF0202ul
#define PLUGNTRUST_APPLET_RES_ID_PUB_FASTSCP_IMPORT     0x7FFF0203ul
#define PLUGNTRUST_APPLET_RES_ID_FEATURE                0x7FFF0204ul
#define PLUGNTRUST_APPLET_RES_ID_FACTORY_RESET          0x7FFF0205ul
#define PLUGNTRUST_APPLET_RES_ID_UNIQUE_ID              0x7FFF0206ul
#define PLUGNTRUST_APPLET_RES_ID_PLATFORM_SCP           0x7FFF0207ul
 
#define PLUGNTRUST_SW_NOERROR                           0x9000
#define PLUGNTRUST_SW_CONDITIONS_NOT_SATISFIED          0x6985
#define PLUGNTRUST_SW_SECURITY_STATUS                   0x6982
#define PLUGNTRUST_SW_WRONG_DATA                        0x6A80
#define PLUGNTRUST_SW_DATA_INVALID                      0x6984
#define PLUGNTRUST_SW_COMMAND_NOT_ALLOWED               0x6986
 
#define PLUGNTRUST_OBJECT_DOES_EXISTS                   1
#define PLUGNTRUST_OBJECT_DOESNT_EXIST                  2
 
#define PLUGNTRUST_OBJID_SE05X_APPLET_RES_START         0x7FFF0000ul
#define PLUGNTRUST_SSS_OBJID_DEMO_AUTH_START            0x7DA00000ul
#define PLUGNTRUST_SSS_OBJID_IOT_HUB_A_START            0xF0000000ul
 
#define PLUGNTRUST_OBJID_APPLET_MASK                    0xFFFF0000ul
#define PLUGNTRUST_OBJID_IOT_MASK                       0xF0000000ul
 
 
 // apdu
 
#define PLUGNTRUST_SET_DEV_ADDR                         0x48
 
#define PLUGNTRUST_INTERFACE_ISO14443                   0
#define PLUGNTRUST_INTERFACE_I2C                        1
 
#define PLUGNTRUST_CARD_MANAGER_WITH_RSP                1
#define PLUGNTRUST_CARD_MANAGER_WITHOUT_RSP             0
 
 // plugntrust_set
 
#define PLUGNTRUST_MAP_MIKROBUS( cfg, mikrobus ) \
    cfg.scl = MIKROBUS( mikrobus, MIKROBUS_SCL ); \
    cfg.sda = MIKROBUS( mikrobus, MIKROBUS_SDA ); \
    cfg.en = MIKROBUS( mikrobus, MIKROBUS_CS ); \
    cfg.rst = MIKROBUS( mikrobus, MIKROBUS_RST ); \
 
 // plugntrust_map
 // plugntrust
 
typedef struct
{
    // Output pins
    digital_out_t  en;      
    digital_out_t  rst;     
 
    // Modules
    i2c_master_t i2c;       
    // I2C slave address
    uint8_t slave_address;  
    uint8_t interface;      
} plugntrust_t;
 
typedef struct
{
    pin_name_t  scl;        
    pin_name_t  sda;        
    pin_name_t  en;         
    pin_name_t  rst;        
 
    uint32_t  i2c_speed;    
    uint8_t   i2c_address;  
} plugntrust_cfg_t;
 
typedef struct
{
    uint8_t cla;                
    uint8_t ins;                
    uint8_t p1;                 
    uint8_t p2;                 
    uint8_t payload_len;        
    uint8_t payload[ 0xFF ];    
    uint16_t rsp_len;           
    uint16_t status;            
} plugntrust_apdu_t;
 
typedef struct
{
    uint8_t nad;                
    uint8_t pcb;                
    uint8_t len;                
    plugntrust_apdu_t *apdu;    
    uint16_t crc16;             
} plugntrust_frame_data_t;
 
typedef struct
{
    uint8_t protocol_version;
    uint8_t vendor_id[ 5 ];
    
    uint8_t data_link_layer_parameters_len;
    uint8_t data_link_layer_parameters[ 0x04 ];
    
    uint8_t physical_layer_id;
    
    uint8_t physical_layer_parameters_len;
    uint8_t physical_layer_parameters[ 0x0B ];
    
    uint8_t historical_len;
    uint8_t historical[ 0x0A ];
    
} plugntrust_atr_t;
 
typedef struct
{
    uint8_t major_version;
    uint8_t minor_version;
    uint8_t patch_version;
    
    uint16_t applet_config;
    uint16_t secure_box;
    
} plugntrust_version_info_t;
 
typedef enum
{
    PLUGNTRUST_OK               = 0,
    PLUGNTRUST_ERROR            = -1,
    PLUGNTRUST_ERROR_TIMEOUT    = -2,
    PLUGNTRUST_ERROR_DATA_OVF   = -3
 
} plugntrust_return_value_t;
 
void plugntrust_cfg_setup ( plugntrust_cfg_t *cfg );
 
err_t plugntrust_init ( plugntrust_t *ctx, plugntrust_cfg_t *cfg );
 
err_t plugntrust_default_cfg ( plugntrust_t *ctx );
 
err_t plugntrust_apdu_write ( plugntrust_t *ctx, plugntrust_frame_data_t *frame_data );
 
err_t plugntrust_apdu_read ( plugntrust_t *ctx, plugntrust_frame_data_t *frame_data );
 
err_t plugntrust_apdu_transfer ( plugntrust_t *ctx, plugntrust_frame_data_t *frame_data );
 
void plugntrust_set_en ( plugntrust_t *ctx, uint8_t state );
 
void plugntrust_set_rst ( plugntrust_t *ctx, uint8_t state );
 
void plugntrust_reset ( plugntrust_t *ctx );
 
void plugntrust_set_tlv_u8 ( uint8_t *buf, uint8_t *buf_len, uint8_t tag, uint8_t value );
 
void plugntrust_set_tlv_u16 ( uint8_t *buf, uint8_t *buf_len, uint8_t tag, uint16_t value );
 
void plugntrust_set_tlv_u16_optional ( uint8_t *buf, uint8_t *buf_len, uint8_t tag, uint16_t value );
 
void plugntrust_set_tlv_u32 ( uint8_t *buf, uint8_t *buf_len, uint8_t tag, uint32_t value );
 
err_t plugntrust_set_tlv_u8buf ( uint8_t *buf, uint8_t *buf_len, uint8_t tag, uint8_t *cmd, uint32_t cmd_len );
 
err_t plugntrust_set_tlv_u8buf_optional ( uint8_t *buf, uint8_t *buf_len, uint8_t tag, uint8_t *cmd, uint32_t cmd_len );
 
err_t plugntrust_get_tlv_u8 ( uint8_t *buf, uint32_t *buf_index, uint8_t tag, uint8_t *rsp );
 
err_t plugntrust_get_tlv_u16 ( uint8_t *buf, uint32_t *buf_index, uint8_t tag, uint16_t *rsp );
 
err_t plugntrust_get_tlv_u8buf ( uint8_t *buf, uint32_t *buf_index, uint8_t buf_len, uint8_t tag, uint8_t *rsp, uint32_t *rsp_len );
 
uint8_t plugntrust_calculate_apdu_size ( plugntrust_apdu_t *apdu_data );
 
err_t plugntrust_end_apdu_session ( plugntrust_t *ctx );
 
err_t plugntrust_object_id_list ( plugntrust_t *ctx, uint32_t *id_list, uint8_t *list_len );
 
err_t plugntrust_sw_reset ( plugntrust_t *ctx, plugntrust_atr_t *atr_data );
 
err_t plugntrust_select_applet ( plugntrust_t *ctx, uint8_t ns_encode, plugntrust_version_info_t *ver_info );
 
err_t plugntrust_select_card_manager ( plugntrust_t *ctx, uint8_t rsp, uint8_t *cardmanager_rsp, uint8_t *cardmanager_rsp_len );
 
err_t plugntrust_get_free_memory ( plugntrust_t *ctx, uint8_t memory_type, uint16_t *free_memory );
 
err_t plugntrust_get_random_numbers ( plugntrust_t *ctx, uint8_t *random_buf, uint8_t buf_len );
 
err_t plugntrust_check_object_exist ( plugntrust_t *ctx, uint32_t object_id );
 
err_t plugntrust_delete_object ( plugntrust_t *ctx, uint32_t object_id );
 
err_t plugntrust_read_object ( plugntrust_t *ctx, uint32_t object_id, uint16_t offset, uint16_t read_len, uint8_t *data_buf, uint32_t *data_len );
 
err_t plugntrust_write_binary_object ( plugntrust_t *ctx, uint32_t object_id, uint16_t offset, uint16_t data_len, uint8_t *data_buf );
 
err_t plugntrust_get_applet_info ( plugntrust_t *ctx, plugntrust_version_info_t *ver_info );
 
#ifdef __cplusplus
}
#endif
#endif // PLUGNTRUST_H
 
 // plugntrust
 
// ------------------------------------------------------------------------ END