Fls.h

Go to the documentation of this file.

/*
*
* Copyright (C) 2024 Texas Instruments Incorporated
*
* All rights reserved not granted herein.
*
* Limited License.
*
* Texas Instruments Incorporated grants a world-wide, royalty-free, non-exclusive
* license under copyrights and patents it now or hereafter owns or controls to make,
* have made, use, import, offer to sell and sell ("Utilize") this software subject to the
* terms herein.  With respect to the foregoing patent license, such license is granted
* solely to the extent that any such patent is necessary to Utilize the software alone.
* The patent license shall not apply to any combinations which include this software,
* other than combinations with devices manufactured by or for TI ("TI Devices").
* No hardware patent is licensed hereunder.
*
* Redistributions must preserve existing copyright notices and reproduce this license
* (including the above copyright notice and the disclaimer and (if applicable) source
* code license limitations below) in the documentation and/or other materials provided
* with the distribution
*
* Redistribution and use in binary form, without modification, are permitted provided
* that the following conditions are met:
*
* *       No reverse engineering, decompilation, or disassembly of this software is
* permitted with respect to any software provided in binary form.
*
* *       any redistribution and use are licensed by TI for use only with TI Devices.
*
* *       Nothing shall obligate TI to provide you with source code for the software
* licensed and provided to you in object code.
*
* If software source code is provided to you, modification and redistribution of the
* source code are permitted provided that the following conditions are met:
*
* *       any redistribution and use of the source code, including any resulting derivative
* works, are licensed by TI for use only with TI Devices.
*
* *       any redistribution and use of any object code compiled from the source code
* and any resulting derivative works, are licensed by TI for use only with TI Devices.
*
* Neither the name of Texas Instruments Incorporated nor the names of its suppliers
*
* may be used to endorse or promote products derived from this software without
* specific prior written permission.
*
* DISCLAIMER.
*
* THIS SOFTWARE IS PROVIDED BY TI AND TI'S LICENSORS "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 TI AND TI'S LICENSORS 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.
*
*/
 
/*
 * Below are the global requirements which are met by this FLS
 * driver which can't be mapped to a particular source ID
 */
/*
 * Design : MCAL-7370,MCAL-7251,MCAL-7373,MCAL-7357,MCAL-7387,MCAL-7461,MCAL-7446,MCAL-7391,MCAL-7277,MCAL-7323,MCAL-7272,MCAL-7475,MCAL-7363.MCAL-7347,MCAL-7352,MCAL-7444,MCAL-7373,MCAL-7405,MCAL-7338,MCAL-7347,MCAL-7461,MCAL-7432,MCAL-7431,MCAL-7460,MCAL-7434,MCAL-7411
 */
 
 #ifndef FLS_H_
 #define FLS_H_
 
/* ========================================================================== */
/*                             Include Files                                  */
/* ========================================================================== */
 
 
#include "Std_Types.h"
#include "Os.h"
#include "Fls_Cfg.h"
#include "Fls_Irq.h"
#include "Fls_Cbk.h"
#include "MemIf_Types.h"
#include <SchM_Fls.h>
#include <Fls/fls_hw/ospi/V0/lldr_ospi.h>
 
#ifdef __cplusplus
extern "C"
{
#endif
 
/* ========================================================================== */
/*                           Macros & Typedefs                                */
/* ========================================================================== */
 
/* None */
 
#define FLS_SW_MAJOR_VERSION   (12U)
#define FLS_SW_MINOR_VERSION   (1U)
#define FLS_SW_PATCH_VERSION   (1U)
/* @} */
 
#define FLS_AR_RELEASE_MAJOR_VERSION    (4U)
#define FLS_AR_RELEASE_MINOR_VERSION    (3U)
#define FLS_AR_RELEASE_REVISION_VERSION (1U)
/* @} */
 
#define FLS_VENDOR_ID                   ((uint16) 44U)
#define FLS_MODULE_ID                   ((uint16) 92U)
#define FLS_INSTANCE_ID                 ((uint8) 0U)
/* @} */
 
 
/*
 * Design : MCAL-7457
 */
typedef uint32 Fls_AddressType;
typedef uint32 Fls_LengthType;
 
 
/*
 * Design : MCAL-7275,MCAL-7369,MCAL-7308,MCAL-7267,MCAL-7427,MCAL-7269,MCAL-7394,MCAL-7332,MCAL-7394,MCAL-7257,MCAL-7269,MCAL-7308,MCAL-7455,MCAL-7358
 */
#ifndef FLS_E_PARAM_CONFIG
#define FLS_E_PARAM_CONFIG                      ((uint8) 0x01U)
#endif
#ifndef FLS_E_PARAM_ADDRESS
#define FLS_E_PARAM_ADDRESS                     ((uint8) 0x02U)
#endif
#ifndef FLS_E_PARAM_LENGTH
#define FLS_E_PARAM_LENGTH                      ((uint8) 0x03U)
#endif
#ifndef FLS_E_PARAM_DATA
#define FLS_E_PARAM_DATA                        ((uint8) 0x04U)
#endif
#ifndef FLS_E_UNINIT
#define FLS_E_UNINIT                            ((uint8) 0x05U)
#endif
#ifndef FLS_E_BUSY
#define FLS_E_BUSY                              ((uint8) 0x06U)
#endif
#ifndef FLS_E_PARAM_POINTER
#define FLS_E_PARAM_POINTER                     ((uint8) 0x0AU)
#endif
#ifndef FLS_E_VERIFY_ERASE_FAILED
#define FLS_E_VERIFY_ERASE_FAILED               ((uint8) 0x07U)
#endif
#ifndef FLS_E_VERIFY_WRITE_FAILED
#define FLS_E_VERIFY_WRITE_FAILED               ((uint8) 0x08U)
#endif
#ifndef FLS_E_TIMEOUT
#define FLS_E_TIMEOUT                           ((uint8) 0x09U)
#endif
 
 
/*TRANSIENT FAULTS WITH HW*/
#ifndef FLS_E_ERASE_FAILED
#define FLS_E_ERASE_FAILED                      ((uint8) 0x01U)
#endif
#ifndef FLS_E_WRITE_FAILED
#define FLS_E_WRITE_FAILED                      ((uint8) 0x02U)
#endif
#ifndef FLS_E_READ_FAILED
#define FLS_E_READ_FAILED                       ((uint8) 0x03U)
#endif
#ifndef FLS_E_COMPARE_FAILED
#define FLS_E_COMPARE_FAILED                    ((uint8) 0x04U)
#endif
#ifndef FLS_E_UNEXPECTED_FLASH_ID
#define FLS_E_UNEXPECTED_FLASH_ID               ((uint8) 0x05U)
#endif
 
 
#define FLS_SID_INIT                            ((uint8) 0x00U)
#define FLS_SID_ERASE                           ((uint8) 0x01U)
#define FLS_SID_WRITE                           ((uint8) 0x02U)
#define FLS_SID_CANCEL                          ((uint8) 0x03U)
#define FLS_SID_GET_STATUS                      ((uint8) 0x04U)
#define FLS_SID_GET_JOB_RESULT                  ((uint8) 0x05U)
#define FLS_SID_READ                            ((uint8) 0x07U)
#define FLS_SID_COMPARE                         ((uint8) 0x08U)
#define FLS_SID_SET_MODE                        ((uint8) 0x09U)
#define FLS_SID_GET_VERSION_INFO                ((uint8) 0x10U)
#define FLS_SID_BLANK_CHECK                     ((uint8) 0x0AU)
#define FLS_SID_MAIN_FUNCTION                   ((uint8) 0x06U)
 
/* @} */
 
/* ========================================================================== */
/*                         Structures and Enums                               */
/* ========================================================================== */
 
/*
 * Design : MCAL-7339,MCAL-7328,MCAL-7248,MCAL-7298,MCAL-7415,MCAL-7411,MCAL-7431,MCAL-7460,MCAL-7434
 */
typedef struct
{
        Fls_LengthType        numberOfSectors;
        Fls_LengthType        sectorPageSize;
        Fls_LengthType        sectorSize;
        Fls_AddressType       sectorStartaddress;
} Fls_SectorType;
 
typedef enum
{
    OSPI_XFER_LINES_SINGLE = 0U,
    OSPI_XFER_LINES_DUAL,
    OSPI_XFER_LINES_QUAD,
    OSPI_XFER_LINES_OCTAL
} OSPI_xferLines;
 
typedef enum
{
    FLS_OSPI = 0U,
    FLS_XSPI = 1U,
    FLS_QSPI = 2U
} FLASH_Protocol;
/*
 * Design : MCAL-7343,MCAL-7355,MCAL-7302,MCAL-7404,MCAL-7290,MCAL-7414,MCAL-7273,MCAL-7396,MCAL-7323,MCAL-7348,MCAL-7364,MCAL-7360,MCAL-7287,MCAL-7317,MCAL-7365,MCAL-7291,MCAL-7262
 */
typedef struct Fls_ConfigType_s
{
        Fls_JobEndNotifyType            Fls_JobEndNotification;
        Fls_JobErrorNotifyType          Fls_JobErrorNotification;
        uint32                          maxReadNormalMode;
        uint32                          maxWriteNormalMode;
        Fls_SectorType                  sectorList[FLS_NUMBER_OF_SECTOR_CFG];
        uint32                           currentSectorIndex;
        boolean                            dacEnable;
        boolean                            xipEnable;
        uint64                          ospiClkSpeed;
        boolean                            dtrEnable;
        boolean                         phyEnable;
        OSPI_xferLines                  ospixferlines;
        uint32                          flsBaudRateDiv;
        uint32                          blockSize;
        boolean                         dmaEnable;
} Fls_ConfigType;
 
typedef struct
{
FLASH_Protocol FLS_PROTOCOL;
uint32 FOUR_BYTE_ADDR_ENABLE; 
uint32 NOR_BLOCK_SIZE; /* NOR Block Size in bytes */
uint32 NOR_UNIFORM_SECTOR_SIZE; /* NOR Sector Size in bytes */
uint32 NOR_SECTOR_SIZE; /* NOR Hybrid Sector Size in bytes. Uniform Address space consists of all 256 KB Sectors */
uint32 NOR_SIZE; /* Total NOR Size in bytes */
/*na*/ uint32 NOR_NUM_4K_SECTORS; /* Number of 4K sectors in the NOR flash */
uint32 NOR_NUM_SECTORS; /* Total number of sectors in the NOR flash */
/*na*/ uint32 NOR_NUM_BLOCKS; /* Total number of blocks in the NOR flash */
uint32 NOR_PAGE_SIZE; /* Page size of the NOR flash in bytes */
/*na*/ uint32 NOR_NUM_PAGES_PER_SECTOR; /* Number of pages per sector */
uint32 NOR_NUM_PAGES_PER_BLOCK; /* Number of pages per block */
/*check*/uint8 NOR_ERASED_DATA; /* Value of erased data */
/*na*/ uint32 NOR_4K_SECT_BOT_END_OFFSET; /* Offset for the bottom of the 4K sector */
/*na*/ uint32 NOR_BE_SECTOR_NUM; /* Number of sectors in the BE (Block Erase) region */
/*na*/ uint32 NOR_CMD_BULK_ERASE; /* Bulk Erase command for the NOR flash */
uint8 NOR_CMD_WRREG; /* Write Register command */
uint8 NOR_CMD_WREN; /* Write Enable command */
/*na*/ uint32 NOR_CMD_WRDIS; /* Write Disable command */
uint8 NOR_CMD_RDSR; /* Read Status Register command */
/*na*/ uint32 NOR_CMD_RDSR2; /* Read Status Register 2 command */
uint8 NOR_CMD_RDREG; /* Register Read command */
/*na*/ uint32 NOR_CMD_RDCR; /* Read Configuration Register command */
uint8 NOR_CMD_RDID;
uint8 NOR_CMD_SRSTE; /* Software Reset Enable command */
uint8 NOR_CMD_SFRST; /* Software Reset command */
uint8 NOR_CMD_BLOCK_ERASE; /* Block Erase command */
uint8 NOR_CMD_SECTOR_ERASE; /* Sector Erase command */
uint32 NOR_CMD_READ; /* Standard Read command */
/*na*/ uint32 NOR_CMD_FAST_READ; /* Fast Read command */
uint32 NOR_CMD_OCTAL_READ; /* Octal Read command (calculated based on sector size) */
uint32 NOR_CMD_OCTAL_DDR_READ; /* Octal DDR Read command (calculated based on NOR size and sector size) */
uint32 NOR_CMD_PAGE_PROG; /* Page Program command */
uint32 NOR_CMD_OCTAL_PROG; /* Octal Program command */
uint32 NOR_CMD_WRITE_VCR; /* Write VCR (Volatile Configuration Register) command */
/*na*/ uint32 NOR_CMD_READ_VCR; /* Read VCR (Volatile Configuration Register) command */
uint8 NOR_VREG_OFFSET; /* Offset for the volatile register */
/*na*/ uint32 NOR_NVREG_OFFSET; /* Offset for the non-volatile register */
/* Non-Volatile Status Register 1 address */
/*na*/ uint32 NOR_STS1_NVREG_ADDR;
/*na*/ uint32 NOR_STS2_NVREG_ADDR;
/* Non-Volatile Configuration Register 1 address */
/*na*/ uint32 NOR_CFG1_NVREG_ADDR;
/*na*/ uint32 NOR_CFG2_NVREG_ADDR;
/*na*/ uint32 NOR_CFG3_NVREG_ADDR;
/*na*/ uint32 NOR_CFG4_NVREG_ADDR;
/*na*/ uint32 NOR_CFG5_NVREG_ADDR;
/* Volatile Status Register address */
/*na*/ uint32 NOR_STS1_VREG_ADDR;
/*na*/ uint32 NOR_STS2_VREG_ADDR;
/* Volatile Configuration Register address */
/*na*/ uint32 NOR_CFG1_VREG_ADDR;
uint32 NOR_CFG2_VREG_ADDR;
uint32 NOR_CFG3_VREG_ADDR;
/*na*/ uint32 NOR_CFG4_VREG_ADDR;
/*na*/ uint32 NOR_CFG5_VREG_ADDR;
uint32 NOR_RDID_NUM_BYTES; 
uint32 NOR_MANF_ID; /* Manufacturer ID */
uint32 NOR_DEVICE_ID; /* Device ID */
uint32 NOR_SR_WIP; 
/*na*/uint32 NOR_SR_WRPGEN; 
/*na*/uint32 NOR_CR_TBPARM;
/*na*/uint32 NOR_CMD_RDCR_VOL;
/*na*/uint32 NOR_CMD_RDCR_NVOL;
/*na*/uint32 NOR_CMD_OCTAL_O_FAST_RD;
uint32 NOR_CMD_OCTAL_IO_FAST_RD;
uint32 NOR_CMD_OCTAL_FAST_PROG;
uint32 NOR_CMD_EXT_OCTAL_FAST_PROG;
/*na*/uint32 NOR_CMD_QUAD_O_FAST_RD;
uint32 NOR_CMD_QUAD_IO_FAST_RD;
uint32 NOR_CMD_QUAD_DDR_O_FAST_RD;
uint32 NOR_CMD_QUAD_FAST_PROG;
/*na*/uint32 NOR_CMD_EXT_QUAD_FAST_PROG;
uint32 NOR_CMD_OCTAL_DDR_O_FAST_RD;
/*na*/uint32 NOR_CMD_OCTAL_DDR_IO_FAST_RD;
/*na*/uint32 NOR_CMD_READ_ENVCR;
/*na*/uint32 NOR_CMD_WRITE_NVCR;
/*na*/uint32 NOR_CMD_READ_NVCR;
uint8 NOR_CMD_WRITE_ENVCR;
uint32 NOR_SINGLE_READ_DUMMY_CYCLE;
uint32 NOR_SINGLE_CMD_READ_DUMMY_CYCLE;
uint32 NOR_OCTAL_SDR_CMD_READ_DUMMY_CYCLE;
uint32 NOR_OCTAL_DDR_CMD_READ_DUMMY_CYCLE;
uint32 NOR_OCTAL_READ_DUMMY_CYCLE;
uint32 NOR_OCTAL_READ_DUMMY_CYCLE_LC;
uint32 NOR_OCTAL_READ_DUMMY_CYCLE_INDAC;
uint32 NOR_OCTAL_READ_DUMMY_CYCLE_LC_INDAC;
uint32 NOR_QUAD_READ_DUMMY_CYCLE;
uint32 NOR_CMD_QUAD_DDR_IO_READ;
uint32 NOR_CMD_QUAD_PAGE_PROG;
uint32 NOR_CMD_QUAD_READ;
uint32 NOR_RDID_CMD_LENGTH_SINGLE;
uint32 NOR_RDID_CMD_LENGTH_OCTAL;
uint32 NOR_PAGE_PROG_TIMEOUT;
/*na*/ uint32 NOR_SECTOR_ERASE_TIMEOUT;
uint32 NOR_WRR_WRITE_TIMEOUT;
uint32 NOR_BULK_ERASE_TIMEOUT;
}FlashConfig;
 
typedef struct FlsNorDeviceConfig_t
{
FlashConfig flscfg[NOR_NUMBER_FLASH];
} FlsNorDeviceConfig;
 
extern const FlsNorDeviceConfig FlsNorDevice;
/* @} */
 
/* ========================================================================== */
/*                          Function Declarations                             */
/* ========================================================================== */
 
FUNC(void, FLS_CODE) Fls_SwitchMode(boolean dacEnable, boolean xipEnable);
 
FUNC(void, FLS_CODE) Fls_Init(
    P2CONST(Fls_ConfigType, AUTOMATIC, FLS_CONFIG_DATA) ConfigPtr);
 
FUNC(Std_ReturnType, FLS_CODE) Fls_Erase(Fls_AddressType TargetAddress, Fls_LengthType Length);
 
FUNC(Std_ReturnType, FLS_CODE) Fls_Write(Fls_AddressType TargetAddress,
    const uint8 *SourceAddressPtr, Fls_LengthType Length);
 
FUNC(Std_ReturnType, FLS_CODE) Fls_Read(Fls_AddressType SourceAddress,
                    uint8 *TargetAddressPtr,
                    Fls_LengthType Length);
 
#if (STD_ON == FLS_COMPARE_API)
FUNC(Std_ReturnType, FLS_CODE) Fls_Compare(Fls_AddressType SourceAddress, const uint8 *TargetAddressPtr, Fls_LengthType Length);
#endif
 
#if (STD_ON == FLS_BLANK_CHECK_API)
FUNC(Std_ReturnType, FLS_CODE) Fls_BlankCheck(Fls_AddressType TargetAddress, Fls_LengthType Length);
#endif
 
#if (STD_ON == FLS_GET_STATUS_API)
FUNC(MemIf_StatusType, FLS_CODE) Fls_GetStatus( void );
#endif
 
#if (STD_ON == FLS_VERSION_INFO_API)
FUNC(Std_ReturnType, FLS_CODE) Fls_GetVersionInfo(Std_VersionInfoType *versioninfo);
#endif
 
#if (STD_ON == FLS_GET_JOB_RESULT_API)
FUNC(MemIf_JobResultType, FLS_CODE) Fls_GetJobResult( void );
#endif
 
FUNC(void, FLS_CODE) Fls_MainFunction(void);
 
#if ( FLS_CANCEL_API == STD_ON )
FUNC(void, FLS_CODE) Fls_Cancel(void);
#endif
 
#if (STD_ON == OSPI_REGISTER_READBACK_API)
Std_ReturnType Ospi_RegisterReadback(
     P2VAR(CSL_ospi_flash_cfgRegs, AUTOMATIC, FLS_APPL_DATA) RegRbPtr);
#endif  /* #if (STD_ON == SPI_REGISTER_READBACK_API) */
 
#ifdef __cplusplus
}
#endif
 
#endif  /* #ifndef FLS_H_ */
 
/* @} */