flash.h

Go to the documentation of this file.

/* --COPYRIGHT--,BSD
 * Copyright (c) 2015, Texas Instruments Incorporated
 * All rights reserved.
 *
 * Redistribution and use in source and binary forms, with or without
 * modification, are permitted provided that the following conditions
 * are met:
 *
 * *  Redistributions of source code must retain the above copyright
 *    notice, this list of conditions and the following disclaimer.
 *
 * *  Redistributions in binary form must reproduce the above copyright
 *    notice, this list of conditions and the following disclaimer in the
 *    documentation and/or other materials provided with the distribution.
 *
 * *  Neither the name of Texas Instruments Incorporated nor the names of
 *    its contributors may be used to endorse or promote products derived
 *    from this software without specific prior written permission.
 *
 * THIS SOFTWARE IS PROVIDED BY THE COPYRIGHT HOLDERS AND CONTRIBUTORS "AS IS"
 * AND ANY EXPRESS OR IMPLIED WARRANTIES, INCLUDING, BUT NOT LIMITED TO,
 * THE IMPLIED WARRANTIES OF MERCHANTABILITY AND FITNESS FOR A PARTICULAR
 * PURPOSE ARE DISCLAIMED. IN NO EVENT SHALL THE COPYRIGHT OWNER OR
 * CONTRIBUTORS BE LIABLE FOR ANY DIRECT, INDIRECT, INCIDENTAL, SPECIAL,
 * EXEMPLARY, OR CONSEQUENTIAL DAMAGES (INCLUDING, BUT NOT LIMITED TO,
 * PROCUREMENT OF SUBSTITUTE GOODS OR SERVICES; LOSS OF USE, DATA, OR PROFITS;
 * OR BUSINESS INTERRUPTION) HOWEVER CAUSED AND ON ANY THEORY OF LIABILITY,
 * WHETHER IN CONTRACT, STRICT LIABILITY, OR TORT (INCLUDING NEGLIGENCE OR
 * OTHERWISE) ARISING IN ANY WAY OUT OF THE USE OF THIS SOFTWARE,
 * EVEN IF ADVISED OF THE POSSIBILITY OF SUCH DAMAGE.
 * --/COPYRIGHT--*/
#ifndef _FLASH_H_
#define _FLASH_H_



// **************************************************************************
// the includes

#include "sw/modules/types/src/types.h"

#include "sw/drivers/cpu/src/32b/f28x/f2806x/cpu.h"




#ifdef __cplusplus
extern "C" {
#endif


// **************************************************************************
// the defines


#define FLASH_BASE_ADDR                     (0x00000A80)


#define FLASH_ACTIVE_WAIT_COUNT_DEFAULT     (0x01FF)


#define FLASH_STANDBY_WAIT_COUNT_DEFAULT    (0x01FF)


#define FLASH_FOPT_ENPIPE_BITS              (1 << 0)


#define FLASH_FACTIVEWAIT_ACTIVEWAIT_BITS   (255 << 0)


#define FLASH_FBANKWAIT_RANDWAIT_BITS       (15 << 0)

#define FLASH_FBANKWAIT_PAGEWAIT_BITS       (15 << 8)


#define FLASH_FOTPWAIT_OTPWAIT_BITS         (31 << 0)


#define FLASH_FPWR_PWR_BITS                 (3 << 0)


#define FLASH_FSTATUS_PWRS_BITS             (3 << 0)

#define FLASH_FSTATUS_STDBYWAITS_BITS       (1 << 2)

#define FLASH_FSTATUS_ACTIVEWAITS_BITS      (1 << 3)

#define FLASH_FSTATUS_3VSTAT_BITS           (1 << 8)


#define FLASH_FSTDBYWAIT_STDBYWAIT_BITS     (255 << 0)


// **************************************************************************
// the typedefs


typedef enum
{
  FLASH_3VStatus_InRange=(0 << 8),     
  FLASH_3VStatus_OutOfRange=(1 << 8)   
} FLASH_3VStatus_e;


typedef enum
{
  FLASH_CounterStatus_NotCounting=0,   
  FLASH_CounterStatus_Counting         
} FLASH_CounterStatus_e;


typedef enum
{
  FLASH_NumOtpWaitStates_1=(1 << 0),    
  FLASH_NumOtpWaitStates_2=(2 << 0),    
  FLASH_NumOtpWaitStates_3=(3 << 0),    
  FLASH_NumOtpWaitStates_4=(4 << 0),    
  FLASH_NumOtpWaitStates_5=(5 << 0),    
  FLASH_NumOtpWaitStates_6=(6 << 0),    
  FLASH_NumOtpWaitStates_7=(7 << 0),    
  FLASH_NumOtpWaitStates_8=(8 << 0),    
  FLASH_NumOtpWaitStates_9=(9 << 0),    
  FLASH_NumOtpWaitStates_10=(10 << 0),  
  FLASH_NumOtpWaitStates_11=(11 << 0),  
  FLASH_NumOtpWaitStates_12=(12 << 0),  
  FLASH_NumOtpWaitStates_13=(13 << 0),  
  FLASH_NumOtpWaitStates_14=(14 << 0),  
  FLASH_NumOtpWaitStates_15=(15 << 0)   
} FLASH_NumOtpWaitStates_e;


typedef enum
{
  FLASH_NumPagedWaitStates_0=(0 << 8),     
  FLASH_NumPagedWaitStates_1=(1 << 8),     
  FLASH_NumPagedWaitStates_2=(2 << 8),     
  FLASH_NumPagedWaitStates_3=(3 << 8),     
  FLASH_NumPagedWaitStates_4=(4 << 8),     
  FLASH_NumPagedWaitStates_5=(5 << 8),     
  FLASH_NumPagedWaitStates_6=(6 << 8),     
  FLASH_NumPagedWaitStates_7=(7 << 8),     
  FLASH_NumPagedWaitStates_8=(8 << 8),     
  FLASH_NumPagedWaitStates_9=(9 << 8),     
  FLASH_NumPagedWaitStates_10=(10 << 8),   
  FLASH_NumPagedWaitStates_11=(11 << 8),   
  FLASH_NumPagedWaitStates_12=(12 << 8),   
  FLASH_NumPagedWaitStates_13=(13 << 8),   
  FLASH_NumPagedWaitStates_14=(14 << 8),   
  FLASH_NumPagedWaitStates_15=(15 << 8)    
} FLASH_NumPagedWaitStates_e;


typedef enum
{
  FLASH_NumRandomWaitStates_1=(1 << 0),     
  FLASH_NumRandomWaitStates_2=(2 << 0),     
  FLASH_NumRandomWaitStates_3=(3 << 0),     
  FLASH_NumRandomWaitStates_4=(4 << 0),     
  FLASH_NumRandomWaitStates_5=(5 << 0),     
  FLASH_NumRandomWaitStates_6=(6 << 0),     
  FLASH_NumRandomWaitStates_7=(7 << 0),     
  FLASH_NumRandomWaitStates_8=(8 << 0),     
  FLASH_NumRandomWaitStates_9=(9 << 0),     
  FLASH_NumRandomWaitStates_10=(10 << 0),   
  FLASH_NumRandomWaitStates_11=(11 << 0),   
  FLASH_NumRandomWaitStates_12=(12 << 0),   
  FLASH_NumRandomWaitStates_13=(13 << 0),   
  FLASH_NumRandomWaitStates_14=(14 << 0),   
  FLASH_NumRandomWaitStates_15=(15 << 0)    
} FLASH_NumRandomWaitStates_e;


typedef enum
{
  FLASH_PowerMode_PumpAndBankSleep=(0 << 0),    
  FLASH_PowerMode_PumpAndBankStandby=(1 << 0),  
  FLASH_PowerMode_PumpAndBankActive=(3 << 0)    
} FLASH_PowerMode_e;


typedef struct _FLASH_Obj_
{
    volatile uint16_t  FOPT;         
    volatile uint16_t  rsvd_1;       
    volatile uint16_t  FPWR;         
    volatile uint16_t  FSTATUS;      
    volatile uint16_t  FSTDBYWAIT;   
    volatile uint16_t  FACTIVEWAIT;  
    volatile uint16_t  FBANKWAIT;    
    volatile uint16_t  FOTPWAIT;     
} FLASH_Obj;


typedef struct _FLASH_Obj_ *FLASH_Handle;


// **************************************************************************
// the globals


// **************************************************************************
// the function prototypes

extern void FLASH_clear3VStatus(FLASH_Handle flashHandle);


extern void FLASH_disablePipelineMode(FLASH_Handle flashHandle);


extern void FLASH_enablePipelineMode(FLASH_Handle flashHandle);


extern FLASH_3VStatus_e FLASH_get3VStatus(FLASH_Handle flashHandle);


extern uint16_t FLASH_getActiveWaitCount(FLASH_Handle flashHandle);


extern FLASH_CounterStatus_e FLASH_getActiveWaitStatus(FLASH_Handle flashHandle);


extern FLASH_PowerMode_e FLASH_getPowerMode(FLASH_Handle flashHandle);


extern uint16_t FLASH_getStandbyWaitCount(FLASH_Handle flashHandle);


extern FLASH_CounterStatus_e FLASH_getStandbyWaitStatus(FLASH_Handle flashHandle);


extern FLASH_Handle FLASH_init(void *pMemory,const size_t numBytes);


extern void FLASH_setActiveWaitCount(FLASH_Handle flashHandle,const uint16_t count);


extern void FLASH_setNumPagedReadWaitStates(FLASH_Handle flashHandle,const FLASH_NumPagedWaitStates_e numStates);


extern void FLASH_setNumRandomReadWaitStates(FLASH_Handle flashHandle,const FLASH_NumRandomWaitStates_e numStates);


extern void FLASH_setOtpWaitStates(FLASH_Handle flashHandle,const FLASH_NumOtpWaitStates_e numStates);


extern void FLASH_setPowerMode(FLASH_Handle flashHandle,const FLASH_PowerMode_e mode);


extern void FLASH_setStandbyWaitCount(FLASH_Handle flashHandle,const uint16_t count);


#ifdef __cplusplus
}
#endif // extern "C"

#endif  // end of _FLASH_H_ definition