startup.h

#ifndef __STARTUP_H
#define __STARTUP_H
#include <stdint.h>
 
// Flags define bits for the dwFlags in the MonExtraStruct
// They are used for various image configurations on boot
#define FLAG_DTCM_EN (0x1)   // Data TCM should be enabled
#define FLAG_ITCM_EN (0x2)   // Instruction TCM should be enabled
#define FLAG_DBG_WFE_EN (0x4)
#define FLAG_RELOC (0x8)   // image is relocatable in flash (assuming header updates)
 
#define NBURN_CSUM_MAGIC (0x4255524E)
 
typedef struct
{
    uint32_t u32Start;
    uint32_t u32End;
    uint8_t u8Region;
    uint8_t u8pad;
    uint16_t u16Attrs;
} __attribute__((packed)) MPUConfig_t;
 
typedef struct
{
    uint32_t dwFlags;
    uint32_t count;
    MPUConfig_t config[];
    // uint32_t checksum will follow immediately
} __attribute__((packed)) MonExtraStruct;
 
typedef struct
{
    uint32_t dwImgAddr;
    uint32_t dwExecutionAddr;
    MonExtraStruct *pExtra;
    uint32_t dwImgLen;
    uint32_t dwImgSum;
    uint32_t dwStructSum;
} AppHeader_t;
 
#define IMG_ID_XSUM_MAGIC 0x4E42   // 'N''B'
 
// This is just an App Header with the image ID field, as it would be found at
// the sector base
typedef struct
{
    uint16_t wImgID;
    uint16_t wImgIDXSum;
    uint32_t dwImgAddr;
    uint32_t dwExecutionAddr;
    MonExtraStruct *pExtra;
    uint32_t dwImgLen;
    uint32_t dwImgSum;
    uint32_t dwStructSum;
} StartUpStruct;
 
// allows for easy mapping of StartupStructs onto block boundaries
typedef struct
{
    union
    {
        StartUpStruct startHdr;
        struct
        {
            uint16_t wImgID;
            uint16_t wImgIDXSum;
            AppHeader_t appHdr;
        };
    };
    uint8_t padd[0x2000 - sizeof(StartUpStruct)];
} __attribute__((packed)) StartUpBlockStruct;
 
extern StartUpBlockStruct *RunningAppImage;
 
#endif /* ----- #ifndef __STARTUP_H  ----- */