m2m_flash.h

Go to the documentation of this file.

#ifndef __M2M_FLASH_H__
#define __M2M_FLASH_H__

/*=*=*=*=*=*=*=*=*=*=*=*=*=*=*=*=*=*=*=*=*=*=*=*=*=*=*=*=*=*=*=*=*=*=*=*=*=*=*=*=*=*=*=*=*=*=*=*=*=*
INCLUDES
*=*=*=*=*=*=*=*=*=*=*=*=*=*=*=*=*=*=*=*=*=*=*=*=*=*=*=*=*=*=*=*=*=*=*=*=*=*=*=*=*=*=*=*=*=*=*=*=*=*/
#include "common/include/nm_common.h"
#include "driver/include/m2m_types.h"

#define FLASH_UPDATEIMAGE_OPTION_UPDATE         NBIT0

#define FLASH_UPDATEIMAGE_OPTION_VALIDATE       NBIT1

#define FLASH_UPDATEIMAGE_OPTION_SWITCH         NBIT2

#define FLASH_SUCCESS                           0

#define FLASH_ERR_PARAM                         (-1)

#define FLASH_ERR_LOCAL_ACCESS          (-2)

#define FLASH_ERR_WINC_ACCESS           (-3)

#define FLASH_ERR_SIZE                          (-4)

#define FLASH_ERR_WINC_CONFLICT         (-5)

#define FLASH_ERR_UNINIT                        (-6)

#define FLASH_ERR_INTERNAL                      (-7)

typedef enum {
        FLASH_DATA_FN_INITIALIZE,
        FLASH_DATA_FN_DATA,
        FLASH_DATA_FN_TERMINATE,
        FLASH_DATA_FN_COMPLETE
}tenuFlashDataFnCtl;

typedef enum {
        FLASH_DATA_FN_READ,
        FLASH_DATA_FN_WRITE
}tenuDataFnRW;

typedef enum {
        FLASH_IMAGE_INACTIVE,
        FLASH_IMAGE_ACTIVE
}tenuImageId;


typedef sint8 (*tpfDataAccessFn) (tenuFlashDataFnCtl enuCtl, void *pvStr);

typedef struct {
        uint32                  u32TotalSize;
        tenuDataFnRW    enuRW;
}tstrDataAccessInitParamsApp;

typedef struct {
        uint8   *pu8Data;
        uint32  u32DataSize;
}tstrDataAccessParamsApp;

typedef struct {
        uint16                          u16LastAccessId;
        uint8                           u8Success;
        uint8                           u8Changed;
        uint8                           u8Init;
        uint8                           u8Reset;
}tstrFlashState;

/*=*=*=*=*=*=*=*=*=*=*=*=*=*=*=*=*=*=*=*=*=*=*=*=*=*=*=*=*=*=*=*=*=*=*=*=*=*=*=*=*=*=*=*=*=*=*=*=*=*
FUNCTION PROTOTYPES
*=*=*=*=*=*=*=*=*=*=*=*=*=*=*=*=*=*=*=*=*=*=*=*=*=*=*=*=*=*=*=*=*=*=*=*=*=*=*=*=*=*=*=*=*=*=*=*=*=*/
sint8 m2m_flash_updateimage(uint8 u8Options, uint16 u16Id, tpfDataAccessFn pfSourceFn, uint32 u32SourceSize);
sint8 m2m_flash_readimage(tenuImageId enuImageId, uint16 u16Id, tpfDataAccessFn pfDestFn, uint32 u32DestSize);
sint8 m2m_flash_rootcert_add(uint16 u16Id, tpfDataAccessFn pfFn, uint32 u32Size);

sint8 m2m_flash_rootcert_remove(uint16 u16Id, uint8 *pu8Identifier, uint32 u32IdentifierSz);
sint8 m2m_flash_rootcert_read(uint16 u16Id, tpfDataAccessFn pfDestFn, uint32 u32DestSize, uint8 *pu8Identifier, uint32 u32IdentifierSz);
sint8 m2m_flash_rootcert_readidx(uint16 u16Id, tpfDataAccessFn pfDestFn, uint32 u32DestSize, uint8 u8Index);

void m2m_flash_get_state(tstrFlashState *pstrState);


sint8 m2m_flash_init(void);

#endif /* __M2M_FLASH_H__ */