flash_interface.h

Go to the documentation of this file.

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

 @file flash_interface

 @brief Interface API for flash access on the CC26xx. Header can be compiled
        with a varation of implementations:

        flash_interface_interal.c - Driverlib access of CC26xx internal flash
        flash_interface_ext_rtos.c - TI-RTOS SPI access of external SPI flash
        flash_interface_ext_rtos.c - Driverlib SPI access of external SPI flash

 Group: WCS, BTS
 $Target Device: DEVICES $

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

#ifndef FLASH_INTERFACE
#define FLASH_INTERFACE

#ifdef __cplusplus
extern "C"
{
#endif

/*********************************************************************
 * INCLUDES
 */
#include <string.h>
#include "hal_board.h"
#include <stdlib.h>
#include <stdbool.h>


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

#define FLASH_SUCCESS   0x00

#define FLASH_FAILURE   0xFF

#define SPI_MAX_READ_SZ 1024

/*********************************************************************
 * MACROS
 */
#if defined(CC26XX_R2)
    #define FLASH_ADDRESS(page, offset)     (((page) << 12) + (offset))
    #define FLASH_PAGE(addr)                (addr >> 12)
    #define INTFLASH_PAGE_MASK              0xFFFFF000
    #define INTFLASH_PAGE_SIZE              0x1000
    #define MAX_ONCHIP_FLASH_PAGES          32
    #define MAX_OFFCHIP_METADATA_PAGES      MAX_ONCHIP_FLASH_PAGES
#elif defined(CC26X2) || defined(CC13X2) || defined(CC13X2P)
    #define FLASH_ADDRESS(page, offset)     (((page) << 13) + (offset))
    #define FLASH_PAGE(addr)                (addr >> 13)
    #define INTFLASH_PAGE_MASK              0xFFFFE000
    #define INTFLASH_PAGE_SIZE              0x2000
    #define MAX_ONCHIP_FLASH_PAGES          44
    #define MAX_OFFCHIP_METADATA_PAGES      MAX_ONCHIP_FLASH_PAGES
#else
    #error
#endif

#define EXT_FLASH_ADDRESS(page, offset)     (((page) << 12) + (offset))

#define EXT_FLASH_PAGE(addr)                (addr >> 12)

#define EXTFLASH_PAGE_MASK                  0xFFFFF000

#define EFL_PAGE_SIZE                       0x1000

#define EFL_FLASH_SIZE                      0x100000

extern void flash_init(void);

extern bool flash_open(void);

extern void flash_close(void);

extern bool hasExternalFlash(void);

extern uint8_t readFlash(uint_least32_t addr, uint8_t *pBuf, size_t len);

extern uint8_t readFlashPg(uint8_t page, uint32_t offset, uint8_t *pBuf,
                            uint16_t len);

extern uint8_t writeFlash(uint_least32_t addr, uint8_t *pBuf, size_t len);

extern uint8_t writeFlashPg(uint8_t page, uint32_t offset, uint8_t *pBuf,
                            uint16_t len);

extern uint8_t eraseFlashPg(uint8_t page);

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

#ifdef __cplusplus
}
#endif

#endif /* FLASH_INTERFACE */