ospi/v0/ospi.h

Go to the documentation of this file.

/*
 *  Copyright (C) 2021-24 Texas Instruments Incorporated
 *
 *  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.
 */
 
#ifndef OSPI_H_
#define OSPI_H_
 
/* ========================================================================== */
/*                             Include Files                                  */
/* ========================================================================== */
 
#include <stdint.h>
#include <drivers/ospi/v0/lld/ospi_lld.h>
#include <kernel/dpl/SystemP.h>
#include <kernel/dpl/HwiP.h>
#include <kernel/dpl/SemaphoreP.h>
 
 
#ifdef __cplusplus
extern "C" {
#endif
 
/* ========================================================================== */
/*                           Macros & Typedefs                                */
/* ========================================================================== */
 
struct OSPI_Config_s;
 
typedef struct OSPI_Config_s *OSPI_Handle;
 
/* ========================================================================== */
/*                         Structure Declarations                             */
/* ========================================================================== */
 
typedef struct
{
    /*
     * SOC configuration
     */
    uint32_t                baseAddr;
    uint32_t                dataBaseAddr;
    uint32_t                moduleId;
    uint32_t                clkId;
    uint32_t                inputClkFreq;
    /*
     * Driver configuration
     */
    uint32_t protocol;
    uint32_t                intrNum;
    uint32_t                intrEnable;
    uint8_t                 intrPriority;
    uint32_t                dmaEnable;
    uint32_t                phyEnable;
    uint32_t                dacEnable;
    uint32_t                frmFmt;
    uint32_t                devDelays[4];
    uint32_t                chipSelect;
    uint32_t                decChipSelect;
    uint32_t                baudRateDiv;
    uint32_t                validateOtp;
    const OSPI_AddrRegion *dmaRestrictedRegions;
    OSPI_PhyConfiguration  phyConfiguration;
} OSPI_Attrs;
 
typedef struct
{
    /*
     * User params
     */
    OSPI_Handle handle;
    /*
     * State variables
     */
    uint32_t isOpen;
    uint32_t isDacEnable;
    SemaphoreP_Object       lockObj;
    SemaphoreP_Object       transferSemObj;
    HwiP_Object             hwiObj;
    OSPI_Transaction *currTrans;
    void* ospiDmaHandle;
 
    OSPILLD_InitObject      ospilldInitObject;
    /* OSPI LLD Init Object and Handle */
 
    OSPILLD_Object          ospilldObject;
    OSPILLD_Handle          ospilldHandle;
    /* QSPI LLD Object and Handle */
} OSPI_Object;
 
typedef struct OSPI_Config_s
{
    const OSPI_Attrs *attrs;
    OSPI_Object *object;
} OSPI_Config;
 
extern OSPI_Config gOspiConfig[];
extern uint32_t    gOspiConfigNum;
 
extern OSPI_DmaConfig gOspiDmaConfig[];
 
/* ========================================================================== */
/*                  Internal/Private Structure Declarations                   */
/* ========================================================================== */
 
/* ========================================================================== */
/*                       Function Declarations                                */
/* ========================================================================== */
 
void OSPI_init(void);
 
void OSPI_deinit(void);
 
 
void OSPI_Params_init( OSPI_Params *ospiParams);
 
OSPI_Handle OSPI_open(uint32_t index, const OSPI_Params *openParams);
 
void OSPI_close(OSPI_Handle handle);
 
OSPI_Handle OSPI_getHandle(uint32_t index);
 
int32_t OSPI_readDirect(OSPI_Handle handle, OSPI_Transaction *trans);
 
int32_t OSPI_readIndirect(OSPI_Handle handle, OSPI_Transaction *trans);
 
int32_t OSPI_writeDirect(OSPI_Handle handle, OSPI_Transaction *trans);
 
int32_t OSPI_writeIndirect(OSPI_Handle handle, OSPI_Transaction *trans);
int32_t OSPI_readCmd(OSPI_Handle handle, OSPI_ReadCmdParams *rdParams);
 
int32_t OSPI_writeCmd(OSPI_Handle handle, OSPI_WriteCmdParams *wrParams);
 
void OSPI_Transaction_init(OSPI_Transaction *trans);
 
void OSPI_ReadCmdParams_init(OSPI_ReadCmdParams *rdParams);
 
void OSPI_WriteCmdParams_init(OSPI_WriteCmdParams *wrParams);
 
uint32_t OSPI_getInputClk(OSPI_Handle handle);
 
uint32_t OSPI_isDacEnable(OSPI_Handle handle);
 
uint32_t OSPI_isDmaEnable(OSPI_Handle handle);
 
uint32_t OSPI_isIntrEnable(OSPI_Handle handle);
 
uint32_t OSPI_isPhyEnable(OSPI_Handle handle);
 
uint32_t OSPI_isDtrEnable(OSPI_Handle handle);
 
int32_t OSPI_enableDDR(OSPI_Handle handle);
 
int32_t OSPI_enableSDR(OSPI_Handle handle);
 
int32_t OSPI_enableDdrRdCmds(OSPI_Handle handle);
 
int32_t OSPI_setRdDataCaptureDelay(OSPI_Handle handle, uint32_t rdDataCapDelay);
 
void OSPI_setNumAddrBytes(OSPI_Handle handle, uint32_t numAddrBytes);
 
void OSPI_setDeviceSize(OSPI_Handle handle, uint32_t pageSize, uint32_t blkSize);
 
void OSPI_setCmdDummyCycles(OSPI_Handle handle, uint32_t cmdDummyCycles);
 
void OSPI_setReadDummyCycles(OSPI_Handle handle, uint32_t dummyCycles);
 
void OSPI_setWriteDummyCycles(OSPI_Handle handle, uint32_t dummyCycles);
 
void OSPI_setPhyEnableSuccess(OSPI_Handle handle, uint32_t success);
 
void OSPI_setModeBits(OSPI_Handle handle, uint32_t modeBits);
 
void OSPI_enableModeBitsCmd(OSPI_Handle handle);
 
void OSPI_enableModeBitsRead(OSPI_Handle handle);
 
uint32_t OSPI_getPhyEnableSuccess(OSPI_Handle handle);
 
void OSPI_cmdModeBitSet(OSPI_Handle handle, uint32_t enable);
 
void OSPI_rdModeBitSet(OSPI_Handle handle, uint32_t enable);
 
uint32_t OSPI_getProtocol(OSPI_Handle handle);
 
void OSPI_setProtocol(OSPI_Handle handle, uint32_t protocol);
 
void OSPI_setDualOpCodeMode(OSPI_Handle handle);
 
void OSPI_clearDualOpCodeMode(OSPI_Handle handle);
 
void OSPI_setXferOpCodes(OSPI_Handle handle, uint8_t readCmd, uint8_t pageProgCmd);
 
void OSPI_setCmdExtType(OSPI_Handle handle, uint32_t cmdExtType);
 
int32_t OSPI_enableDacMode(OSPI_Handle handle);
 
int32_t OSPI_disableDacMode(OSPI_Handle handle);
 
uint32_t OSPI_getFlashDataBaseAddr(OSPI_Handle handle);
 
int32_t OSPI_phyTuneDDR(OSPI_Handle handle, uint32_t flashOffset);
 
int32_t OSPI_phyTuneSDR(OSPI_Handle handle, uint32_t flashOffset);
 
int32_t OSPI_phyTuneGrapher(OSPI_Handle handle, uint32_t flashOffset, uint8_t arrays[5][128][128]);
 
void OSPI_phyGetTuningData(uint32_t *tuningData, uint32_t *tuningDataSize);
 
int32_t OSPI_phyReadAttackVector(OSPI_Handle handle, uint32_t offset);
 
int32_t OSPI_enablePhy(OSPI_Handle handle);
 
int32_t OSPI_disablePhy(OSPI_Handle handle);
 
int32_t OSPI_enablePhyPipeline(OSPI_Handle handle);
 
int32_t OSPI_disablePhyPipeline(OSPI_Handle handle);
 
 
int32_t OSPI_norFlashInit1s1s1s(OSPI_Handle handle);
 
void OSPI_norFlashSetCmds(uint8_t rdCmd, uint8_t wrCmd, uint8_t eraseCmd);
 
int32_t OSPI_norFlashReadId(OSPI_Handle handle, uint32_t *manufacturerId, uint32_t *deviceId);
 
int32_t OSPI_norFlashWrite(OSPI_Handle handle, uint32_t offset, uint8_t *buf, uint32_t len);
 
int32_t OSPI_norFlashRead(OSPI_Handle handle, uint32_t offset, uint8_t *buf, uint32_t len);
 
int32_t OSPI_norFlashReadSfdp(OSPI_Handle handle, uint32_t offset, uint8_t *buf, uint32_t len);
 
int32_t OSPI_norFlashErase(OSPI_Handle handle, uint32_t address);
 
 
int32_t OSPI_configResetPin(OSPI_Handle handle, uint32_t config);
 
 
int32_t OSPI_configBaudrate(OSPI_Handle handle, uint32_t baud);
 
int32_t OSPI_readBaudRateDivFromReg(OSPI_Handle handle, uint32_t *baudDiv);
 
int32_t OSPI_getBaudRateDivFromObj(OSPI_Handle handle, uint32_t *baudDiv);
 
int32_t OSPI_setResetPinStatus(OSPI_Handle handle, uint32_t pinStatus);
 
int32_t OSPI_phyValidateTuningPoint(OSPI_Handle handle, uint32_t flashOffset);
 
uint32_t OSPI_isValidateOtpEnable(OSPI_Handle handle);
 
int32_t OSPI_setFrequency(OSPI_Handle handle, uint64_t inputClkFreq);
 
int32_t OSPI_setDelays(OSPI_Handle handle, uint32_t inputClkFreq);
 
int32_t OSPI_setBaudRateDiv(OSPI_Handle handle, uint32_t baudRateDiv);
 
#ifdef __cplusplus
}
#endif
 
#endif /* #ifndef OSPI_H_ */