Function:		ezToggleLED

	Description:	Toggles the state of an LED.

*********************************************************************/

void ezToggleLED(u32 LEDNumber)	// toggles an LED
{
	if (ezIsLEDOn(LEDNumber)) {
		ezTurnOffLED(LEDNumber);
	} else {
		ezTurnOnLED(LEDNumber);
	}
}




/*********************************************************************

	Function:		ezTurnOnAllLEDs

	Description:	Turns on all LEDs.  

*********************************************************************/

void ezTurnOnAllLEDs(void)					// turns on all LEDs
{
	int i;
	
	// turn them on
	for (i = EZ_FIRST_LED; i <= EZ_LAST_LED; i++) {
		ezTurnOnLED(i);
	}

}
	

/*********************************************************************

	Function:		ezTurnOffAllLEDs

	Description:	Turns off all LEDs.  

*********************************************************************/

void ezTurnOffAllLEDs(void)					// turns off all LEDs
{
	int i;
	
	// turn them off
	for (i = EZ_FIRST_LED; i <= EZ_LAST_LED; i++) {
		ezTurnOffLED(i);
	}

}
	

/*********************************************************************

	Function:		ezCycleLEDs

	Description:	Cycles through each LED in turn.  

*********************************************************************/

void ezCycleLEDs(void)						// cycles through LEDS
{												// changes each time called
static int LED = EZ_FIRST_LED;

			ezTurnOffLED(LED);
			LED++;
			if (LED > EZ_LAST_LED) LED = EZ_FIRST_LED;
			ezTurnOnLED(LED);
}
	

/*********************************************************************

	Function:		ezIsLEDOn

	Description:	Returns TRUE if an LED is lit, FALSE otherwise.

*********************************************************************/

u32 ezIsLEDOn(u32 LEDNumber)	// test to see if an LED is lit
{

#if defined(__ADSP_EDINBURGH__)			// ADSP-BF533 EZ-Kit specific info
	switch(LEDNumber) {
		case 4:
			if (*pFlashA_PortB_In & 0x0001) return (TRUE);
			break;
		case 5:
			if (*pFlashA_PortB_In & 0x0002) return (TRUE);
			break;
		case 6:
			if (*pFlashA_PortB_In & 0x0004) return (TRUE);
			break;
		case 7:
			if (*pFlashA_PortB_In & 0x0008) return (TRUE);
			break;
		case 8:
			if (*pFlashA_PortB_In & 0x0010) return (TRUE);
			break;
		case 9:
			if (*pFlashA_PortB_In & 0x0020) return (TRUE);
			break;
	}

	// return
	return (FALSE);
#endif

#if defined(__ADSP_BRAEMAR__) || defined (__ADSP_TETON__) // ADSP-BF537 & BF561 EZ-Kit specific info

	u32	Value;	
	  
	adi_flag_Sense(EZ_LED_TO_FLAG(LEDNumber), &Value);

	// return
	return (Value );
 
#endif // Braemar or Teton

}

/*********************************************************************

	Function:		ezGetDisplay

	Description:	Returns the current status of the LED display

*********************************************************************/
u32 ezGetDisplay()
{
	int i;
	u32 Mask;
	u32 Display;
	
	// assume nothing's on and set our mask
	Display = 0;
	Mask = 1;
	
	// FOR (each LED)
	for (i = EZ_FIRST_LED; i <= EZ_LAST_LED; i++, Mask <<= 1) {
		
		// set the bit in Display if the LED is on
		if (ezIsLEDOn(i)) Display |= Mask;
		
	// ENDFOR
	}
	
	// return
	return (Display);
}

/*********************************************************************

	Function:		ezSetDisplay

	Description:	Sets the LED display

*********************************************************************/
void ezSetDisplay(u32 Display)
{

	int i;
	
	// FOR (each LED)
	for (i = EZ_FIRST_LED; i <= EZ_LAST_LED; i++, Display >>= 1) {
		
		// light the LED if that bit in the display is set
		if (Display & 0x1) {
			ezTurnOnLED(i);
		} else {
			ezTurnOffLED(i);
		}
		
	// ENDFOR
	}
	
}



/*********************************************************************

	Function:		ezErrorCheck

	Description:	This function is intended to be used as a means to 
					quickly determine if a function has returned a non-zero
					(hence an error) return code.  All driver and system
					services functions return a value of zero for success and 
					a non-zero value when a failure occurs.  This function
					lights all the LEDs and spins when a non-zero value is 
					passed to it.  

*********************************************************************/

void ezErrorCheck(u32 Result)				// lights all LEDS and spins on nonzero value
{
	while (Result != 0) {
		ezTurnOnAllLEDs();
	}
}
			
	



/*********************************************************************

	Function:		ezIsButtonPushed

	Description:	Returns TRUE if a button has been pushed, FALSE otherwise.

*********************************************************************/

u32 ezIsButtonPushed(u32 ButtonNumber) 		// returns TRUE if button is pushed, FALSE otherwise
{
	u32	Value;
	
	// sense it
	adi_flag_Sense(EZ_BUTTON_TO_FLAG(ButtonNumber), &Value);

	// return
	return (Value);
	
}		


/*********************************************************************

	Function:		ezEnableButtonCallback

	Description:	Enables generation of a callback in response to
					a button being pushed.

*********************************************************************/

u32	ezEnableButtonCallback		(					// enables generation of a push button callback
	u32 				ButtonNumber,
	void				*ClientHandle,
	ADI_DCB_HANDLE		DCBHandle,
	ADI_DCB_CALLBACK_FN	ClientCallback
) {

	// use the flag service to hook the interrupt
	return((u32)adi_flag_InstallCallback(EZ_BUTTON_TO_FLAG(ButtonNumber), FLAG_PERIPHERAL_ID, ADI_FLAG_TRIGGER_RISING_EDGE, TRUE, ClientHandle, DCBHandle, ClientCallback));
	
	// return
}



/*********************************************************************

	Function:		ezDisableButtonCallback

	Description:	Disables generation of a callback in response to 
					a button being pushed.

*********************************************************************/

u32	ezDisableButtonCallback	(u32 ButtonNumber)	// disables generation of a push button callback
{

	// use the flag service to hook the interrupt
	return((u32)adi_flag_RemoveCallback(EZ_BUTTON_TO_FLAG(ButtonNumber)));
	
}




/*********************************************************************

	Function:		ezClearButton

	Description:	Clears a push button latch.  This must be called to 
					reset the latch for the push button, if a button has
					been pressed.

*********************************************************************/

void	ezClearButton(u32 ButtonNumber)	// clears a button latch
{
	volatile int i;
	
	// delay to allow for any debounce to clear
	for (i = 0; i < 4000000; i++) ;
	
	// clear the flag corresponding to the button
	adi_flag_Clear(EZ_BUTTON_TO_FLAG(ButtonNumber));
	
}








/*********************************************************************

	Function:		ezInitPower

	Description:	Initializes and sets Power managwmentSDRAM parameters on the EZ-Kit.  
					(Replaces ezConfigurePLL & ezConfigureSDRAM )
					Processor clock set to max in each case
	
*********************************************************************/

#define DO_NOT_CHANGE_MMR_SETTINGS 0

static void ezInitPower(u8 NumCores)	
{
	ADI_EBIU_RESULT EBIUResult;
	ADI_PWR_RESULT 	PWRResult;
	
#if defined (__ADSP_TETON__)
	ADI_PWR_COMMAND_PAIR ezkit_power[3];
#endif	
	
	// It is important that the EBIU module is configured before Power module
	// so that changes to the clock frequencies are correctly reflected in the
	// SDRAM settings
	
	//Initializes the EBIU module 
	ADI_EBIU_COMMAND_PAIR ezkit_sdram[] = {	
#if defined (__ADSP_EDINBURGH__)	
		{ ADI_EBIU_CMD_SET_EZKIT, (void*)ADI_EBIU_EZKIT_BF533 },
#elif defined(__ADSP_BRAEMAR__)
		{ ADI_EBIU_CMD_SET_EZKIT, (void*)ADI_EBIU_EZKIT_BF537 },
#elif defined (__ADSP_TETON__)
		{ ADI_EBIU_CMD_SET_EZKIT, (void*)ADI_EBIU_EZKIT_BF561 },
#endif
		{ ADI_EBIU_CMD_END, 0}
	};
	EBIUResult = adi_ebiu_Init( ezkit_sdram, DO_NOT_CHANGE_MMR_SETTINGS );
	if ((EBIUResult != ADI_EBIU_RESULT_SUCCESS) && (EBIUResult != ADI_EBIU_RESULT_CALL_IGNORED)) {
		ezErrorCheck(EBIUResult);
	}
	
	//Initializes the power management module 
#if defined (__ADSP_TETON__)

	u8 ic=0;
	ezkit_power[ic].kind  =  ADI_PWR_CMD_SET_EZKIT;
	ezkit_power[ic].value =  (void*)ADI_PWR_EZKIT_BF561_500MHZ;
	
	// for Teton (BF561) there is a choice between auto sync if NumCores >1 or
	// no synchronization - essential for single-core apps.
	
	if (NumCores>1) {	
		ic++;
		// value field is superfluos for this command
		ezkit_power[ic].kind  =  ADI_PWR_CMD_SET_AUTO_SYNC_ENABLED;
	}
	ic++;
	// value field is superfluos for this command
	ezkit_power[ic].kind  =  ADI_PWR_CMD_END;
	
#else	// otherwise - Edinburgh or Braemar	

	ADI_PWR_COMMAND_PAIR ezkit_power[] = {	
#if defined (__ADSP_EDINBURGH__)	
		{ ADI_PWR_CMD_SET_EZKIT, (void*)ADI_PWR_EZKIT_BF533_600MHZ },
#elif defined(__ADSP_BRAEMAR__)
		{ ADI_PWR_CMD_SET_EZKIT, (void*)ADI_PWR_EZKIT_BF537_600MHZ },
#endif
		{ ADI_PWR_CMD_END, 0}
	};	
#endif
	
	PWRResult = adi_pwr_Init( ezkit_power );
	if ((PWRResult != ADI_PWR_RESULT_SUCCESS) && (PWRResult != ADI_PWR_RESULT_CALL_IGNORED)) {
		ezErrorCheck(PWRResult);
	}
	
	// Crank up speed to max possible
#if !defined (__ADSP_TETON__) || defined(__600_MHZ_TETON__)
	ezErrorCheck( adi_pwr_SetFreq( 0, 0, ADI_PWR_DF_NONE ) );
#else
	// Again, this is safe, on boards with ADSP-BF561SKBC500X rev 0.2
	// There are issues with some BF561 EZ-kits for V >=1.2V
	ezErrorCheck( adi_pwr_SetMaxFreqForVolt( ADI_PWR_VLEV_115 ) );
#endif
}


/*********************************************************************

	Function:		ezInitAsync

	Description:	Initializes and sets the appropriate wait states for
					the async memories on the EZKit.  

*********************************************************************/

static void ezInitAsync(void)						// configures async memory for use
{
	
#if defined(__ADSP_EDINBURGH__)			// ADSP-BF533 EZ-Kit specific info
	*pEBIU_AMBCTL0	= 0x7bb07bb0;	// Write access time = 7 cycles, read access time = 11 cycles, no ARDY
	*pEBIU_AMBCTL1	= 0x7bb07bb0;	// Hold time = 2 cycles, setup time = 3 cycles, transition time = 4 cycles
	*pEBIU_AMGCTL	= 0x00FF;
#endif // Edinburgh
 
}



/*********************************************************************

	Function:		ezInitFlashA

	Description:	Sets up the A flash on the board for use.  

*********************************************************************/

static void ezInitFlashA(void)						// sets up the flash
{
	
#if defined(__ADSP_EDINBURGH__)			// ADSP-BF533 EZ-Kit specific info
	*pFlashA_PortA_Out = 0;			// resets port A to initial value
	*pFlashA_PortA_Dir = 0xFF;		// configure everything on port A as outputs
	*pFlashA_PortB_Out = 0;			// resets port B to initial value
	*pFlashA_PortB_Dir = 0x3f;		// configure everything on port B as outputs
#endif // Edinburgh
 	
}



/*********************************************************************

	Function:		ezInitLEDs

	Description:	Initializes and sets up the LEDs for use. 

*********************************************************************/

static void ezInitLEDs(void)			// configures the flags to drive LEDs
{
	int i;

#if defined(__ADSP_EDINBURGH__)			// ADSP-BF533 EZ-Kit specific info
	// nothing to do here on the BF533 EZ-Kit
#endif // Edinburgh
	
#if defined(__ADSP_BRAEMAR__) || defined (__ADSP_TETON__) // ADSP-BF537 & BF561 EZ-Kit specific info
	// configure flags connected to LEDs as inputs
	for (i = 0; i < EZ_NUM_LEDS; i++) {
		adi_flag_Open(LED[i]);
		adi_flag_SetDirection(LED[i], ADI_FLAG_DIRECTION_OUTPUT);
	}
#endif // Braemar or Teton
 
	
}


/*********************************************************************

	Function:		ezTerminateLEDs

	Description:	Terminates the LEDs

*********************************************************************/

static void ezTerminateLEDs (void)
{
	// nothing to do ?????
		
}

/*********************************************************************

	Function:		ezInitButtons

	Description:	Initializes the push button as input flags

*********************************************************************/

static void ezInitButtons(void) {
	
	u32 i;

	// configure flags connected to buttons as inputs
	for (i = 0; i < EZ_NUM_BUTTONS; i++) {
		adi_flag_Open(Button[i]);
		adi_flag_SetDirection(Button[i], ADI_FLAG_DIRECTION_INPUT);
	}
		
}



/*********************************************************************

	Function:		ezTerminateButtons

	Description:	Terminates the buttons

*********************************************************************/

static void ezTerminateButtons(void)
{
	// nothing to do ?????
		
}