oad_image_header.h

Go to the documentation of this file.

/******************************************************************************

 @file  oad_image_header.h

 @brief This file contains the image header definition and structures.

 Group: WCS, BTS
 $Target Device: DEVICES $

 ******************************************************************************
 $License: BSD3 2017 $
 ******************************************************************************
 $Release Name: PACKAGE NAME $
 $Release Date: PACKAGE RELEASE DATE $
 ******************************************************************************/

#ifndef OAD_IMAGE_HEADER_H
#define OAD_IMAGE_HEADER_H

#ifdef __cplusplus
extern "C"
{
#endif

/*******************************************************************************
 * INCLUDES
 ******************************************************************************/
#include <stddef.h>
#include <stdint.h>
#include "hal_types.h"


/*******************************************************************************
 * CONSTANTS
 ******************************************************************************/


#ifdef OAD_ONCHIP

  #define BIM_VAR_ADDR  0x20000400

  extern uint32_t _bim_var;
#endif // OAD_ONCHIP

#define SIGN_FN_PTR 0x57fa0
extern uint32_t _sign_fnPtr;

#define OAD_IMG_TYPE_PERSISTENT_APP       0

#define OAD_IMG_TYPE_APP                  1

#define OAD_IMG_TYPE_STACK                2

#define OAD_IMG_TYPE_APP_STACK            3

#define OAD_IMG_TYPE_NP                   4

#define OAD_IMG_TYPE_FACTORY              5

#define OAD_IMG_TYPE_BIM                  6

#define OAD_IMG_TYPE_APPSTACKLIB          7

#define OAD_IMG_TYPE_USR_BEGIN            16

#define OAD_IMG_TYPE_USR_END              31

#define OAD_IMG_TYPE_HOST_BEGIN           32

#define OAD_IMG_TYPE_HOST_END             63

#define OAD_IMG_TYPE_RSVD_BEGIN           64

#define OAD_IMG_TYPE_RSVD_END             255

#define OAD_WIRELESS_TECH_BLE             0xFFFE

#define OAD_WIRELESS_TECH_TIMAC_SUBG      0xFFFD

#define OAD_WIRELESS_TECH_TIMAC_2_4G      0xFFFB

#define OAD_WIRELESS_TECH_ZIGBEE          0xFFF7

#define OAD_WIRELESS_TECH_RF4CE           0xFFEF

#define OAD_WIRELESS_TECH_THREAD          0xFFDF

#define OAD_WIRELESS_TECH_EASYLINK        0xFFBF

#ifdef DeviceFamily_CC26X2
  #define OAD_IMG_ID_VAL                    {'C', 'C', '2', '6', 'x', '2', 'R', '1'}
#elif defined (DeviceFamily_CC13X2) ||                                        \
      defined (DeviceFamily_CC13X2_V1) ||                                     \
      defined (DeviceFamily_CC13X2_V2)
  #define OAD_IMG_ID_VAL                    {'C', 'C', '1', '3', 'x', '2', 'R', '1'}
#elif defined (DeviceFamily_CC26X0R2)
  #define OAD_IMG_ID_VAL                    {'O', 'A', 'D', ' ', 'I', 'M', 'G', ' '}
#elif defined (DOXYGEN)

  #define OAD_IMG_ID_VAL
#else
  #error "Unknown Device Family"
#endif //DeviceFamily_CC26X2

#define OAD_EXTFL_ID_VAL                  {'O', 'A', 'D', ' ', 'N', 'V', 'M', '1'}


#define CRC_OFFSET                   offsetof(imgHdr_t, fixedHdr.crc32)

#define BIM_VER_OFFSET               offsetof(imgHdr_t, fixedHdr.bimVer)

#define IMG_DATA_OFFSET              BIM_VER_OFFSET

#define IMG_INFO_OFFSET              offsetof(imgHdr_t, fixedHdr.imgCpStat)

#define IMG_COPY_STAT_OFFSET         IMG_INFO_OFFSET

#define CRC_STAT_OFFSET              offsetof(imgHdr_t, fixedHdr.crcStat)

#define IMG_TYPE_OFFSET              offsetof(imgHdr_t, fixedHdr.imgType)

#define BOUNDARY_SEG_OFFSET          offsetof(imgHdr_t, fixedHdr.segTypeBd)


#define SEG_LEN_OFFSET               4

#define SEG_SIGERINFO_OFFSET         offsetof(imgHdr_t, secInfoSeg.secSignerInfo)

#define SEG_SIGNR_OFFSET             offsetof(imgHdr_t, secInfoSeg.eccSign.sign_r)

#define SEG_SIGNS_OFFSET             offsetof(imgHdr_t, secInfoSeg.eccSign.sign_s)

#define SEC_VERIF_STAT_OFFSET        offsetof(imgHdr_t, secInfoSeg.verifStat)

#define HDR_LEN_WITH_SECURITY_INFO   offsetof(imgHdr_t, secInfoSeg.segTypeSecure) + sizeof(securityInfoSeg_t)

#define IMG_START_ADDR_OFFSET        offsetof(imgHdr_t, imgPayload.startAddr)

#define SEG_HDR_LEN                  12

#define OAD_IMG_ID_LEN               8

#define OAD_SW_VER_LEN               4

#define OAD_IMG_HDR_LEN              sizeof(imgFixedHdr_t)

#define IMG_BOUNDARY_SEG_ID          0x00

#define IMG_PAYLOAD_SEG_ID           0x01


#define IMG_NONCOUNT_SEG_ID          0x02

#define IMG_SECURITY_SEG_ID          0x03

#define OAD_IMG_FULL_HDR_LEN         sizeof(imgHdr_t)                     /* The length of the OAD Header + Segments */
#define OAD_IMG_ID_LEN               8                                    /* OAD image identification bytes length */
#define OAD_SW_VER_LEN               4                                    /* OAD software version length in bytes */

#ifndef STACK_LIBRARY
  #define BOUNDARY_SEG_LEN           0x18 
#endif
#define SECURITY_SEG_LEN             0x55 

#define IMG_COPY_STAT_OFFSET         IMG_INFO_OFFSET                      /* Image copy status */

#define SEG_LEN_OFFSET               4                                    /* Offset from seg header to seg len */
#define SIG_OFFSET                   offsetof(imgHdr_t, secInfoSeg.eccSign.sign_r)      /* Offset from the start of security seg to sig */

#define ECDSA_KEY_LEN                32

#define ECDSA_SHA_TEMPWORKZONE_LEN   ECDSA_KEY_LEN*6  /* space for six buffers finalHash, reverseHash, pubkeyX, pubKeyY, sign1, sign2 */

#define BIM_VER                      0x3

#define META_VER                     0x1

#define SECURITY_VER                 0x1

#define DEFAULT_STATE                0xFF

#define CRC_VALID                    0xFE

#define CRC_INVALID                  0xFC

#define NEED_COPY                    0xFE

#define COPY_DONE                    0xFC

#define VERIFY_PASS                  0xFE

#define VERIFY_FAIL                  0xFC

#define EFL_MATADATA_HDR_LEN         OAD_IMG_HDR_LEN + 8

#define INVALID_ADDR                 0xFFFFFFFF

#define INVALID_LEN                  INVALID_ADDR

#define DEFAULT_CRC                  0xFFFFFFFF


#define SIGNER_INFO_SIZE                  8

#define SIGNATURE_SIZE                    64



/*******************************************************************************
 * Typedefs
 */

#if defined (__IAR_SYSTEMS_ICC__)
  #define TYPEDEF_STRUCT_PACKED        __packed typedef struct
#elif defined __TI_COMPILER_VERSION || defined __TI_COMPILER_VERSION__
  #define TYPEDEF_STRUCT_PACKED        typedef struct __attribute__((packed))
#elif defined (__GNUC__)
  #define TYPEDEF_STRUCT_PACKED        typedef struct __attribute__((__packed__))
#endif


PACKED_TYPEDEF_STRUCT
{
    uint8_t     signerInfo[SIGNER_INFO_SIZE];
    uint8_t     signature[SIGNATURE_SIZE];
}signPld_ECDSA_P256_t;



TYPEDEF_STRUCT_PACKED
{
  uint8_t   imgID[8];       
  uint32_t  crc32;          
  uint8_t   bimVer;         
  uint8_t   metaVer;        
  uint16_t  techType;       
  uint8_t   imgCpStat;      
  uint8_t   crcStat;        
  uint8_t   imgType;        
  uint8_t   imgNo;          
  uint32_t  imgVld;         
  uint32_t  len;            
  uint32_t  prgEntry;       
  uint8_t   softVer[4];     
  uint32_t  imgEndAddr;     
  uint16_t  hdrLen;         
  uint16_t  rfu;            
}imgFixedHdr_t;

TYPEDEF_STRUCT_PACKED
{
  uint8_t   segTypeImg;     
  uint16_t  wirelessTech;   
  uint8_t   rfu;            
  uint32_t  imgSegLen;      
  uint32_t  startAddr;      
}imgPayloadSeg_t;

TYPEDEF_STRUCT_PACKED
{
  uint8_t   segTypeBd;      
  uint16_t  wirelessTech;   
  uint8_t   rfu;            
  uint32_t  boundarySegLen; 
  uint32_t  stackStartAddr; 
  uint32_t  stackEntryAddr; 
  uint32_t  ram0StartAddr;  
  uint32_t  ram0EndAddr;    
}boundarySeg_t;


typedef struct {
  uint8_t  sign_r[32];
  uint8_t  sign_s[32];
} eccSignature_t;

TYPEDEF_STRUCT_PACKED
{
  uint8_t   segTypeSecure;     
  uint16_t  wirelessTech;      
  uint8_t   verifStat;         
  uint32_t  secSegLen;         
  uint8_t   secVer;            
  uint32_t  secTimestamp;      
  uint8_t   secSignerInfo[8];  
  eccSignature_t  eccSign;     
}securityInfoSeg_t;

TYPEDEF_STRUCT_PACKED
{
   imgFixedHdr_t         fixedHdr;    
#if (defined(SECURITY))
   securityInfoSeg_t     secInfoSeg;  
#endif
#if (!defined(STACK_LIBRARY) && (defined(SPLIT_APP_STACK_IMAGE)))
   boundarySeg_t         boundarySeg; 
#endif
   imgPayloadSeg_t       imgPayload;  
} imgHdr_t;

TYPEDEF_STRUCT_PACKED
{
   uint32_t *eccWorkzone;    
   uint8_t *SHAWorkzone;  
   uint8_t *tempWorkzone;         
   uint8_t *SHADataBuf;           
   uint8_t  SHADataBufLen;                
} ecdsaSigVerifyBuf_t;

/*******************************************************************************
 * Typedefs
 */

/* Function typdef for bim_payloadVerify() fxn defined in bim_main.c */
typedef uint8_t (*bimSignFnPtr_t)(uint8_t, uint32_t, uint32_t, uint8_t *,
                                  uint8_t *, ecdsaSigVerifyBuf_t *);

#ifdef __cplusplus
}
#endif

#endif /* OAD_IMAGE_HEADER_H */