rt-thread/bsp/lpc178x/drivers/lpc177x_8x_pinsel.c

/**********************************************************************
* $Id$		lpc177x_8x_pinsel.c			2011-06-02
*//**
* @file		lpc177x_8x_pinsel.c
* @brief	Contains all functions support for Pin-connection block
*			firmware library on LPC177x_8x
* @version	1.0
* @date		02. June. 2011
* @author	NXP MCU SW Application Team
* 
* Copyright(C) 2011, NXP Semiconductor
* All rights reserved.
*
***********************************************************************
* Software that is described herein is for illustrative purposes only
* which provides customers with programming information regarding the
* products. This software is supplied "AS IS" without any warranties.
* NXP Semiconductors assumes no responsibility or liability for the
* use of the software, conveys no license or title under any patent,
* copyright, or mask work right to the product. NXP Semiconductors
* reserves the right to make changes in the software without
* notification. NXP Semiconductors also make no representation or
* warranty that such application will be suitable for the specified
* use without further testing or modification.
**********************************************************************/

/* Peripheral group ----------------------------------------------------------- */
/** @addtogroup PINSEL
 * @{
 */

/* Includes ------------------------------------------------------------------- */
#include "lpc177x_8x_pinsel.h"

#define PINSEL_I2C_MODE_POS				(8)
#define PINSEL_I2C_MODE_NUMBITS			(2)
#define PINSEL_I2C_MODE_BITMASK			(0x03)

#define PINSEL_BASIC_MODE_POS			(3)
#define PINSEL_BASIC_MODE_NUMBITS		(2)
#define PINSEL_BASIC_MODE_BITMASK		(0x03)

#define PINSEL_DACEN_POS				(16)
#define PINSEL_DACEN_BITMASK			(0x01)
#define PINSEL_DACEN_NUMBITS			(1)

#define PINSEL_GLITCH_FILTER_POS				(8)
#define PINSEL_GLITCH_FILTER_BITMASK			(0x01)
#define PINSEL_GLITCH_FILTER_NUMBITS			(1)

#define PINSEL_ADMODE_POS				(7)
#define PINSEL_ADMODE_BITMASK			(0x01)
#define PINSEL_ADMODE_NUMBITS			(1)

/* Private Functions ---------------------------------------------------------- */

/*********************************************************************//**
 * @brief		Get pointer to GPIO peripheral due to GPIO port
 * @param[in]	portnum		Port Number value, should be in range from 0..3.
 * @param[in]	pinnum		Pin number value, should be in range from 0..31
 * @return		Pointer to GPIO peripheral
 **********************************************************************/
static uint32_t * PIN_GetPointer(uint8_t portnum, uint8_t pinnum)
{
	uint32_t *pPIN = NULL;
	pPIN = (uint32_t *)(LPC_IOCON_BASE + ((portnum * 32 + pinnum)*sizeof(uint32_t)));
	return pPIN;
}

/* Public Functions ----------------------------------------------------------- */
/** @addtogroup PINSEL_Public_Functions
 * @{
 */

/*********************************************************************//**
 * @brief 		Setup the pin selection function
 * @param[in]	portnum PORT number, should be in range: 0..3
 * @param[in]	pinnum	Pin number, should be in range: 0..31
 * @param[in] 	funcnum Function number, should be range: 0..7
 * 				- 0: Select GPIO (Default)
 * 				- 1: Selects the 1st alternate function
 * 				- 2: Selects the 2nd alternate function
 * 				...
 *				- 7: Selects the 7th alternate function
 * @return 		None
 **********************************************************************/
void PINSEL_ConfigPin ( uint8_t portnum, uint8_t pinnum, uint8_t funcnum)
{
	uint32_t *pPIN = NULL;
	pPIN = PIN_GetPointer(portnum, pinnum);
	*pPIN &= 0x00000007;//Clear function bits
	*pPIN |= funcnum;
}


/*********************************************************************//**
 * @brief 		Setup resistor mode for each pin
 * @param[in]	portnum PORT number, should be in range: 0..3
 * @param[in]	pinnum	Pin number, should be in range: 0..31
 * @param[in] 	modenum: Mode number, should be in range: 0..3
				- IOCON_MODE_PLAIN: Plain output
				- IOCON_MODE_PULLDOWN: Pull-down enable
				- IOCON_MODE_PULLUP: Pull-up enable
				- IOCON_MODE_REPEATER: Repeater mode
 * @return 		None
 **********************************************************************/
void PINSEL_SetPinMode ( uint8_t portnum, uint8_t pinnum, PinSel_BasicMode modenum)
{
	uint32_t *pPIN = NULL;
	pPIN = PIN_GetPointer(portnum, pinnum);
	*(uint32_t *)pPIN &= ~(3<<3);//Clear function bits
	*(uint32_t *)pPIN |= modenum;
}

/*********************************************************************//**
 * @brief 		Setup hysteresis for each pin
 * @param[in]	portnum Port number, should be in range: 0..3
 * @param[in]	pinnum	Pin number, should be in range: 0..31
 * @param[in] 	NewState new state of Hysteresis mode, should be:
 * 				- ENABLE: Hysteresis enable
 * 				- DISABLE: Hysteresis disable
 * @return 		None
 **********************************************************************/
void PINSEL_SetHysMode(uint8_t portnum, uint8_t pinnum, FunctionalState NewState)
{
	uint32_t *pPIN = NULL;
	pPIN = PIN_GetPointer(portnum, pinnum);
	if(NewState == DISABLE)
	{
		*(uint32_t *)pPIN &= ~IOCON_HYS;//Clear hys bits
	}
	else
		*(uint32_t *)pPIN |= IOCON_HYS;
}

/*********************************************************************//**
 * @brief 		Setup Slew rate for each pin
 * @param[in]	portnum Port number, should be in range: 0..3
 * @param[in]	pinnum	Pin number, should be in range: 0..31
 * @param[in] 	NewState new state of Slew rate control, should be:
 * 				- ENABLE: Output slew rate control is enable
 * 				- DISABLE: Output slew rate control is disable
 * @return 		None
 **********************************************************************/
void PINSEL_SetSlewMode(uint8_t portnum, uint8_t pinnum, FunctionalState NewState)
{
	uint32_t *pPIN = NULL;
	pPIN = PIN_GetPointer(portnum, pinnum);
	if(NewState == DISABLE)
	{
		*(uint32_t *)pPIN &= ~IOCON_SLEW;//Clear hys bits
	}
	else
		*(uint32_t *)pPIN |= IOCON_SLEW;
}

/*********************************************************************//**
 * @brief 		Setup Input Buffer for each pin
 * @param[in]	portnum Port number, should be in range: 0..3
 * @param[in]	pinnum	Pin number, should be in range: 0..31
 * @param[in] 	NewState new state of Input buffer mode, should be:
 * 				- ENABLE: The input buffer is enable
 * 				- DISABLE: The input buffer is disable
 * @return 		None
 **********************************************************************/
void PINSEL_SetInBufMode(uint8_t portnum, uint8_t pinnum, FunctionalState NewState)
{
	uint32_t *pPIN = NULL;
	pPIN = PIN_GetPointer(portnum, pinnum);
	if(NewState == DISABLE)
	{
		*(uint32_t *)pPIN &= ~IOCON_INBUF;//Clear hys bits
	}
	else
		*(uint32_t *)pPIN |= IOCON_INBUF;
}

/*********************************************************************//**
 * @brief 		Setup I2CMode for only pins that provide special I2C functionality
 * @param[in]	portnum Port number, should be in range: 0..3
 * @param[in]	pinnum	Pin number, should be in range: 0..31
 * @param[in] 	I2CMode I2C mode, should be:
 * 				- IOCON_I2CMODE_FAST: Fast mode and standard I2C mode
 * 				- IOCON_I2CMODE_OPENDRAIN: Open drain I/O
 * 				- IOCON_I2CMODE_FASTPLUS: Fast Mode Plus I/O
 * 				- IOCON_I2CMODE_HIGHOPENDRAIN: High drive open drain I/O
 * @return 		None
 **********************************************************************/
void PINSEL_SetI2CMode(uint8_t portnum, uint8_t pinnum, PinSel_I2cMode I2CMode)
{
	uint32_t *pPIN = NULL;
	pPIN = PIN_GetPointer(portnum, pinnum);

	*(uint32_t *)pPIN &= ~(PINSEL_I2C_MODE_BITMASK<< PINSEL_I2C_MODE_POS);
	*(uint32_t *)pPIN |= (I2CMode << PINSEL_I2C_MODE_POS);
}

/*********************************************************************//**
 * @brief 		Setup Open-drain mode in each pin
 * @param[in]	portnum Port number, should be in range: 0..3
 * @param[in]	pinnum	Pin number, should be in range: 0..31
 * @param[in] 	NewState new state of Open-drain mode:
 * 				- DISABLE: Normal pin I/O mode
 * 				- ENABLE: Open-drain enable
 * @return 		None
 **********************************************************************/
void PINSEL_SetOpenDrainMode(uint8_t portnum, uint8_t pinnum, FunctionalState NewState)
{
	uint32_t *pPIN = NULL;
	pPIN = PIN_GetPointer(portnum, pinnum);
	if(NewState == DISABLE)
	{
		*(uint32_t *)pPIN &= ~IOCON_ODMODE;//Clear hys bits
	}
	else
	{
		*(uint32_t *)pPIN |= IOCON_ODMODE;
	}
}

/*********************************************************************//**
 * @brief 		Enable the Analog mode for each pin (default is as Digital pins)
 * @param[in]	portnum PORT number, should be in range: 0..3
 * @param[in]	pinnum	Pin number, should be in range: 0..31
 * @param[in] 	enable: the state of the pin that is expected to run
				- ENABLE: Enable the DAC mode of the pin
				- DISABLE: Disable the DAC mode
 * @return 		None
 **********************************************************************/
void PINSEL_SetAnalogPinMode (uint8_t portnum, uint8_t pinnum, uint8_t enable)
{
	uint32_t *pPIN = NULL;

	uint8_t condition = 0;

	condition = ((portnum == 0) && (pinnum == 12)) || ((portnum == 0) && (pinnum == 13))
					| ((portnum == 0) && (pinnum <= 26) && (pinnum >= 23))
					| ((portnum == 1) && (pinnum == 30)) || ((portnum == 1) && (pinnum == 31));

	if(!condition)
	{
		return;
	}

	pPIN = PIN_GetPointer(portnum, pinnum);

	//Clear this bit to set the pin to Analog mode
	*(uint32_t *)pPIN &= ~(PINSEL_ADMODE_BITMASK << PINSEL_ADMODE_POS);

	if(enable)
	{

	}
	else
	{
		*(uint32_t *)pPIN |= (1 << PINSEL_ADMODE_POS);//Set 16th bit to one
	}

	return;
}



/*********************************************************************//**
 * @brief 		Choose the DAC mode for each pin
 * @param[in]	portnum PORT number, should be in range: 0..3
 * @param[in]	pinnum	Pin number, should be in range: 0..31
 * @param[in] 	enable: the state of the pin that is expected to run
				- ENABLE: Enable the DAC mode of the pin
				- DISABLE: Disable the DAC mode
 * @return 		None
 **********************************************************************/
void PINSEL_DacEnable (uint8_t portnum, uint8_t pinnum, uint8_t enable)
{
	uint32_t *pPIN = NULL;

	// This setting is only for DAC pin (output pin)
	if(!((portnum == 0) && (pinnum == 26)))
	{
		return;
	}

	pPIN = PIN_GetPointer(portnum, pinnum);

	//Clear DAC Enable function bits
	*(uint32_t *)pPIN &= ~(PINSEL_DACEN_BITMASK << PINSEL_DACEN_POS);

	if(enable)
	{
		*(uint32_t *)pPIN |= (1 << PINSEL_DACEN_POS);//Set 16th bit to one
	}
	else
	{

	}

	return;
}

/*********************************************************************//**
 * @brief 		Control the glitch filter for each pin
 * @param[in]	portnum PORT number, should be in range: 0..3
 * @param[in]	pinnum	Pin number, should be in range: 0..31
 * @param[in] 	enable: the state of the pin that is expected to run
				- ENABLE: The noise pulses below approximately 10ns are filtered out
				- DISABLE: No input filtering is done.
 * @return 		None
 **********************************************************************/
void PINSEL_SetFilter (uint8_t portnum, uint8_t pinnum, uint8_t enable)
{
	uint32_t *pPIN = NULL;

	// This setting is only for DAC pin (output pin)
	if(!((portnum == 0) && ((pinnum == 7) || (pinnum == 8) || (pinnum == 9))))
	{
		return;
	}

	pPIN = PIN_GetPointer(portnum, pinnum);

	*(uint32_t *)pPIN |= (1 << 7);//Set 7th bit for normal operation following the UM1.0

	//Clear Filter bits
	*(uint32_t *)pPIN &= ~(PINSEL_GLITCH_FILTER_BITMASK << PINSEL_GLITCH_FILTER_POS);

	if(!enable)
	{
		*(uint32_t *)pPIN |= (1 << PINSEL_GLITCH_FILTER_POS);//Set 8th bit to one
	}
	else
	{

	}

	*pPIN = *pPIN;

	return;
}

/**
 * @}
 */

/**
 * @}
 */

/* --------------------------------- End Of File ------------------------------ */