nci.h

Go to the documentation of this file.

/*****************************************************************************
 *
 * MODULE:      NFC
 *
 * COMPONENT:   nci.h
 *
 * AUTHOR:      Martin Looker
 *
 * DESCRIPTION: NCI driver for reading and writing data (interface)
 *
 * $HeadURL: https://www.collabnet.nxp.com/svn/lprf_sware/Projects/Components/NFC/Tags/+v1000/Include/nci.h $
 *
 * $Revision: 86042 $
 *
 * $LastChangedBy: nxp29761 $
 *
 * $LastChangedDate: 2017-01-06 11:08:16 +0000 (Fri, 06 Jan 2017) $
 *
 * $Id: nci.h 86042 2017-01-06 11:08:16Z nxp29761 $
 *
 ****************************************************************************
 *
 * This software is owned by NXP B.V. and/or its supplier and is protected
 * under applicable copyright laws. All rights are reserved. We grant You,
 * and any third parties, a license to use this software solely and
 * exclusively on NXP products [NXP Microcontrollers such as JN5168, JN5179].
 * You, and any third parties must reproduce the copyright and warranty notice
 * and any other legend of ownership on each copy or partial copy of the
 * software.
 *
 * 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 HOLDER 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 NXP B.V. 2016. All rights reserved
 *
 ***************************************************************************/
#ifndef NCI_H_
#define NCI_H_

/****************************************************************************/
/***        Include Files                                                 ***/
/****************************************************************************/
#include <jendefs.h>

/****************************************************************************/
/***        Macro Definitions                                             ***/
/****************************************************************************/

/****************************************************************************/
/***        Type Definitions                                              ***/
/****************************************************************************/
typedef enum
{
    E_NCI_EVENT_ABSENT,     
    E_NCI_EVENT_PRESENT,    
    E_NCI_EVENT_READ_FAIL,  
    E_NCI_EVENT_READ_OK,    
    E_NCI_EVENT_WRITE_FAIL, 
    E_NCI_EVENT_WRITE_OK,   
} teNciEvent;

typedef void (*tprNciCbEvent)(          /* Called when an event takes place */
        teNciEvent  eNciEvent,          /* Event raised */
        uint32      u32Address,
        uint32      u32Length,
        uint8       *pu8Data);          /* Event data (NULL if no data) */

/****************************************************************************/
/***        Exported Functions (called by application)                    ***/
/****************************************************************************/
/****************************************************************************
 *
 *  NAME:  NCI_vInitialise
 */
PUBLIC  void NCI_vInitialise(
        uint8       u8Address,          
        bool_t      bLocation,          
        uint32      u32FrequencyHz,     
        uint8       u8InputVen,         
        uint8       u8InputIrq          
        );

/****************************************************************************
 *
 *  NAME:  NCI_vRegCbEvent
 */
PUBLIC  void NCI_vRegCbEvent(
        tprNciCbEvent prRegCbEvent      
        );

/****************************************************************************
 *
 *  NAME:  NCI_vTick
 */
PUBLIC  void NCI_vTick(
        uint32      u32TickMs           
        );

/****************************************************************************
 *
 *  NAME:  NCI_bRead
 */
PUBLIC  bool_t      NCI_bRead(
        uint32      u32ReadAddress,     
        uint32      u32ReadLength,      
        uint8       *pu8ReadData        
        );

/****************************************************************************
 *
 *  NAME:  NCI_bReadVersion
 */
PUBLIC  bool_t NCI_bReadVersion(
        uint32    u32ReadLength, 
        uint8    *pu8ReadData    
        );

/****************************************************************************
 *
 *  NAME:  NCI_bWrite
 */
PUBLIC  bool_t NCI_bWrite(
        uint32    u32WriteAddress,  
        uint32    u32WriteLength,   
        uint8    *pu8WriteData      
        );

/****************************************************************************
 *
 *  NAME:  NCI_bEnd
 */
PUBLIC  bool_t      NCI_bEnd(void);

/****************************************************************************
 *
 *  NAME:  NCI_u32Nci
 */
PUBLIC  uint32      NCI_u32Nci(void);

/****************************************************************************
 *
 *  NAME:  NCI_u32Config
 */
PUBLIC  uint32      NCI_u32Config(void);

/****************************************************************************
 *
 *  NAME:  NCI_u32Session
 */
PUBLIC  uint32      NCI_u32Session(void);

/****************************************************************************
 *
 *  NAME:  NCI_u32Sram
 */
PUBLIC  uint32      NCI_u32Sram(void);

/****************************************************************************
 *
 *  NAME:  NCI_pu8Header
 */
PUBLIC  uint8      *NCI_pu8Header(void);

/****************************************************************************
 *
 *  NAME:  NCI_pu8Version
 */
PUBLIC  uint8      *NCI_pu8Version(void);

/****************************************************************************/
/***        Exported Variables                                            ***/
/****************************************************************************/

#endif /* NCI_H_ */
/****************************************************************************/
/***        END OF FILE                                                   ***/
/****************************************************************************/