AmcExi2Comm.h

Go to the documentation of this file.

#ifndef _DOLPHIN_AMC_AMCEXI2COMM_H_
#define _DOLPHIN_AMC_AMCEXI2COMM_H_
 
#include <dolphin/amc/AmcTypes.h>
#include <dolphin/os.h>
 
typedef enum {
    AMC_EXI_NO_ERROR = 0,
    AMC_EXI_UNSELECTED,
} AmcExiError;
 
// ---------------------------------------------------------------------------
//
// void EXI2_Init( volatile unsigned char **inputPendingPtrRef,
//                 EXICallback monitorCallback );
//
// Description: Initialize the EXI2 driver (without interrupts).  The
//              parameter 'inputPendingPtrref' is a flag showing whether input
//              is waiting in the EXI2 buffer and 'monitorCallback' is a
//              pointer to a callback function that is invoked at the end of
//              the EXI2 ISR.
//
// ---------------------------------------------------------------------------
void EXI2_Init(volatile unsigned char** inputPendingPtrRef,
               EXICallback monitorCallback);
 
// ---------------------------------------------------------------------------
//
// void EXI2_EnableInterrupts( void );
//
// Description: Enable EXI2 interrupts.  This function must be called to use
//              interrupts on the EXI2 interface.  Call this function only
//              after EXI2_Init() has been invoked.
//
// ---------------------------------------------------------------------------
void EXI2_EnableInterrupts(void);
 
// ---------------------------------------------------------------------------
//
// int EXI2_Poll( void );
//
// Description: Returns the number of bytes waiting to be read in the EXI2
//              buffer.
//
// ---------------------------------------------------------------------------
int EXI2_Poll(void);
 
// ---------------------------------------------------------------------------
//
// AmcExiError EXI2_ReadN( void *bytes, unsigned long length );
//
// Description: Read length bytes and return in bytes[] array.
//
//     Returns: One of AMC_EXI_*.
//
// ---------------------------------------------------------------------------
AmcExiError EXI2_ReadN(void* bytes, unsigned long length);
 
// ---------------------------------------------------------------------------
//
// AmcExiError EXI2_WriteN( const void *bytes, unsigned long length );
//
// Description: Write length bytes stored in bytes[] array.
//
//     Returns: One of AMC_EXI_*.
//
// ---------------------------------------------------------------------------
AmcExiError EXI2_WriteN(const void* bytes, unsigned long length);
 
// ---------------------------------------------------------------------------
//
// void EXI2_Reserve( void );
//
// Description: Disable non-monitor communications over the EXI2 port.
//              This function must be called before the monitor takes
//              control of the processor.
//
// ---------------------------------------------------------------------------
void EXI2_Reserve(void);
 
// ---------------------------------------------------------------------------
//
// void EXI2_Unreserve( void );
//
// Description: Re-enable non-monitor communications over the EXI2 port.
//              This function must be called just before the monitor
//              gives control of the processor back to the application.
//
// ---------------------------------------------------------------------------
void EXI2_Unreserve(void);
 
// ---------------------------------------------------------------------------
//
// AmcExiError EXI2_GetStatusReg( u16* pu16StatusReg );
//
// Description: Read and store the value of the status register into
//              *pu16StatusReg.
//
//     Returns: One of AMC_EXI_*.
// ---------------------------------------------------------------------------
AmcExiError EXI2_GetStatusReg(u16* pu16StatusReg);
 
int AMC_IsStub();
 
#endif