mcci_bootloader.h File Reference

#include "mcci_bootloader_types.h"
#include "mcci_tweetnacl_sign.h"

Go to the source code of this file.

Enumerations
enum	McciBootloaderError_e {   McciBootloaderError_OK = 0 , McciBootloaderError_BootloaderNotValid , McciBootloaderError_ResetClockNotValid , McciBootloaderError_NoAppImage ,   McciBootloaderError_EraseFailed , McciBootloaderError_ReadFailed , McciBootloaderError_FlashWriteFailed , McciBootloaderError_FlashVerifyFailed ,   McciBootloaderError_FlashNotFound , McciBootloaderError_FlashNotSupported }
enum	McciBootloaderState_e {   McciBootloaderState_Initial = 0 , McciBootloaderState_CheckingPrimaryStorageHash , McciBootloaderState_CheckingPrimaryStorageSignature , McciBootloaderState_CheckingFallbackStorageHash ,   McciBootloaderState_CheckingFallbackStorageSignature , McciBootloaderState_ErasingApp , McciBootloaderState_WritingApp , McciBootloaderState_CheckingApp }

Functions
bool	McciBootloader_checkCodeValid (const void *pBase, size_t numBytes)
bool	McciBootloader_checkStorageImage (McciBootloaderStorageAddress_t address, McciBootloader_AppInfo_t *pAppInfo, const mcci_tweetnacl_sign_publickey_t *pPublicKey)
static size_t	McciBootloader_codeSize (const void *base, const void *top)
void	McciBootloader_main (void)
McciBootloaderError_t	McciBootloader_programAndCheckFlash (McciBootloaderStorageAddress_t address, const McciBootloader_AppInfo_t *pAppInfo)

Variables
void *	g_McciBootloader_BssBase
void *	g_McciBootloader_BssTop
void *	g_McciBootloader_DataBase
void *	g_McciBootloader_DataTop
uint8_t	g_McciBootloader_imageBlock [4096]
void *	g_McciBootloader_SocRamBase
void *	g_McciBootloader_SocRamTop
void *	g_McciBootloader_StackTop
const void *	gk_McciBootloader_AppBase
const void *	gk_McciBootloader_AppTop
const void *	gk_McciBootloader_BootBase
const void *	gk_McciBootloader_BootTop
const void *	gk_McciBootloader_DataImageBase
const void *	gk_McciBootloader_ImageSize
const void *	gk_McciBootloader_MfgBase
const void *	gk_McciBootloader_MfgTop

Enumeration Type Documentation

McciBootloaderError_e

enum McciBootloaderError_e

Enumerator
McciBootloaderError_OK	successful
McciBootloaderError_BootloaderNotValid	bootloader image isn't valid
McciBootloaderError_ResetClockNotValid	post-reset clock not valid
McciBootloaderError_NoAppImage	app image not valid, no fallback available.
McciBootloaderError_EraseFailed	erase failed
McciBootloaderError_ReadFailed	storage read failed during program
McciBootloaderError_FlashWriteFailed	flash write failed during programming
McciBootloaderError_FlashVerifyFailed	flash verify failed after programming
McciBootloaderError_FlashNotFound	flash didn't reply properly to SFDP
McciBootloaderError_FlashNotSupported	flash SFDP contents are prior to JESD216B, or otherwise not suitable.

Definition at line 53 of file mcci_bootloader.h.

McciBootloaderState_e

enum McciBootloaderState_e

Enumerator
McciBootloaderState_Initial	initial state when annunciator launched
McciBootloaderState_CheckingPrimaryStorageHash
McciBootloaderState_CheckingPrimaryStorageSignature
McciBootloaderState_CheckingFallbackStorageHash
McciBootloaderState_CheckingFallbackStorageSignature
McciBootloaderState_ErasingApp
McciBootloaderState_WritingApp
McciBootloaderState_CheckingApp

Definition at line 68 of file mcci_bootloader.h.

Function Documentation

McciBootloader_checkCodeValid()

bool McciBootloader_checkCodeValid	(	const void *	pBase,
		size_t	numBytes
	)

Definition at line 108 of file mccibootloader_checkcodevalid.c.

References McciBootloaderPlatform_checkImageValid().

Referenced by McciBootloader_main(), and McciBootloader_programAndCheckFlash().

McciBootloader_checkStorageImage()

bool McciBootloader_checkStorageImage	(	McciBootloaderStorageAddress_t	address,
		McciBootloader_AppInfo_t *	pAppInfo,
		const mcci_tweetnacl_sign_publickey_t *	pPublicKey
	)

Definition at line 86 of file mccibootloader_checkstorageimage.c.

References g_McciBootloader_imageBlock, McciBootloaderPlatform_checkImageValid(), McciBootloaderPlatform_getAppInfo(), and McciBootloaderPlatform_storageRead().

Referenced by McciBootloader_main().

McciBootloader_codeSize()

static size_t McciBootloader_codeSize ( const void *  base, const void *  top  )

inlinestatic

Definition at line 141 of file mcci_bootloader.h.

Referenced by McciBootloader_main(), and McciBootloaderPlatform_entry().

McciBootloader_main()

void McciBootloader_main

(

void

)

Definition at line 143 of file mccibootloader_main.c.

References g_McciBootloader_incomingAppInfo, gk_McciBootloader_AppBase, gk_McciBootloader_AppTop, gk_McciBootloader_BootBase, gk_McciBootloader_BootTop, McciBootloader_checkCodeValid(), McciBootloader_checkStorageImage(), McciBootloader_codeSize(), McciBootloader_programAndCheckFlash(), McciBootloaderError_BootloaderNotValid, McciBootloaderError_NoAppImage, McciBootloaderError_OK, McciBootloaderPlatform_annunciatorIndicateState(), McciBootloaderPlatform_annunciatorInit(), McciBootloaderPlatform_entry(), McciBootloaderPlatform_fail(), McciBootloaderPlatform_getAppInfo(), McciBootloaderPlatform_getFallbackStorageAddress(), McciBootloaderPlatform_getPrimaryStorageAddress(), McciBootloaderPlatform_getSignatureBlock(), McciBootloaderPlatform_getUpdateFlag(), McciBootloaderPlatform_setUpdateFlag(), McciBootloaderPlatform_startApp(), McciBootloaderPlatform_storageInit(), and McciBootloaderState_CheckingPrimaryStorageHash.

McciBootloader_programAndCheckFlash()

McciBootloaderError_t McciBootloader_programAndCheckFlash	(	McciBootloaderStorageAddress_t	address,
		const McciBootloader_AppInfo_t *	pAppInfo
	)

Definition at line 82 of file mccibootloader_programandcheckflash.c.

References g_McciBootloader_imageBlock, McciBootloader_checkCodeValid(), McciBootloaderError_EraseFailed, McciBootloaderError_FlashVerifyFailed, McciBootloaderError_FlashWriteFailed, McciBootloaderError_OK, McciBootloaderError_ReadFailed, McciBootloaderPlatform_storageRead(), McciBootloaderPlatform_systemFlashErase(), and McciBootloaderPlatform_systemFlashWrite().

Referenced by McciBootloader_main().

Variable Documentation

g_McciBootloader_BssBase

void* g_McciBootloader_BssBase

extern

Referenced by McciBootloaderPlatform_entry().

g_McciBootloader_BssTop

void* g_McciBootloader_BssTop

extern

Referenced by McciBootloaderPlatform_entry().

g_McciBootloader_DataBase

void* g_McciBootloader_DataBase

extern

Referenced by McciBootloaderPlatform_entry().

g_McciBootloader_DataTop

void* g_McciBootloader_DataTop

extern

Referenced by McciBootloaderPlatform_entry().

g_McciBootloader_imageBlock

uint8_t g_McciBootloader_imageBlock[4096]

extern

Definition at line 53 of file mccibootloader_checkstorageimage.c.

Referenced by McciBootloader_checkStorageImage(), and McciBootloader_programAndCheckFlash().

g_McciBootloader_SocRamBase

void* g_McciBootloader_SocRamBase

extern

Referenced by McciBootloaderPlatform_checkImageValid().

g_McciBootloader_SocRamTop

void* g_McciBootloader_SocRamTop

extern

Referenced by McciBootloaderPlatform_checkImageValid().

g_McciBootloader_StackTop

void* g_McciBootloader_StackTop

extern

gk_McciBootloader_AppBase

const void* gk_McciBootloader_AppBase

extern

Referenced by McciBootloader_main().

gk_McciBootloader_AppTop

const void* gk_McciBootloader_AppTop

extern

Referenced by McciBootloader_main().

gk_McciBootloader_BootBase

const void* gk_McciBootloader_BootBase

extern

Referenced by McciBootloader_main().

gk_McciBootloader_BootTop

const void* gk_McciBootloader_BootTop

extern

Referenced by McciBootloader_main().

gk_McciBootloader_DataImageBase

const void* gk_McciBootloader_DataImageBase

extern

Referenced by McciBootloaderPlatform_entry().

gk_McciBootloader_ImageSize

const void* gk_McciBootloader_ImageSize

extern

gk_McciBootloader_MfgBase

const void* gk_McciBootloader_MfgBase

extern

gk_McciBootloader_MfgTop

const void* gk_McciBootloader_MfgTop

extern