rt-thread-official/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 ------------------------------ */