Qualcomm 8250 surf board GPIO initial process

osbl_main_ctl()-> osbl_do_procedures( &bl_shared_data, osbl_main_procs )->osbl_hw_init()-> tlmm_misc_init()-> gpio_init()


gpio_init (){

.........


/* Configure all the GPIOs to the primary state. */
HAL_tlmm_ConfigGpioGroup((const uint32*)pgBSPData->asGroup[GPIO_GROUP_PRIMARY].panData,
(uint16)pgBSPData->asGroup[GPIO_GROUP_PRIMARY].nNumGpio);

/* Initialize the GPIO OWNER registers. */
gpio_tlmm_init_gpio_owners();

/* Configure camera */
#ifndef T_MDM8900
#ifdef T_FFA
gpio_out(CAMIF_EN_N, GPIO_HIGH_VALUE);
#endif
gpio_out(CAMIF_RST_N, GPIO_LOW_VALUE);
#endif
#if defined(T_SURF) && defined(TLMM_USES_HS_USB)
/* Configure HS USB */
gpio_out(USBH_CS1_N, GPIO_LOW_VALUE);
gpio_out(USBH_RST_N, GPIO_LOW_VALUE);
#endif

#if defined(TLMM_USES_UART3) && defined(T_FFA)
/* Select UART3 */
gpio_out(UART3_CONFIG, GPIO_HIGH_VALUE);
#endif

#ifdef FEATURE_DTV_TSIF
HAL_tlmm_SetPort(HAL_TLMM_PORT_TSIF, 0x1, 0x1);
#endif

#ifdef FEATURE_ILCDC_FFA
HAL_tlmm_SetPort(HAL_TLMM_LCDC_CFG, 0, 1);
#endif

#endif /* IMAGE_MODEM_PROC */
}


*===============================================================================

FUNCTION
void HAL_tlmm_ConfigGpioGroup ( uint32 nWhichGpioSet[],
uint32 nWhichCfgSet[],
uint8 size )

DESCRIPTION
Configures a group of GPIOs based on the supplied input parameters. Each
array contains a GPIO/Configuration set, but we extract only the GPIO from
the first array and the configuration from the second. This allows GPIO
groups to be set to several different configurations, such as primary,
sleep, or default group configuration.

PARAMETERS
nWhichGpioSet[] - An array of GPIO configurations to extract the GPIO
numbers to configure.
nWhichCfgSet[] - An array of GPIO configurations to extract the GPIO
configuration information to set the above GPIOs to.
nWhatSize - The size of the first array.

DEPENDENCIES
None.

RETURN VALUE
None.

SIDE EFFECTS
None.

===============================================================================*/
void HAL_tlmm_ConfigGpioGroup( const uint32 nWhichGpioSet[],
uint16 nWhatSize )
{
uint16 nIdx;
uint8 nGroup; /* Variable used to extract the GPIO register. */
uint16 nWhichGpio; /* Variable to extract the GPIOs from the arrays. */
uint32 nGpioOffset;/* Contains the register offset for each GPIO. */

/* This array is a buffer of outputs in order to construct a mask. */
uint32 nMask [HAL_TLMM_NUM_REG_GROUP];
uint32 nBuffer[HAL_TLMM_NUM_REG_GROUP];

/* Initialize the temporary OE buffers. */
for(nIdx = 0; nIdx < HAL_TLMM_NUM_REG_GROUP; ++nIdx)
{
nMask[nIdx] = 0x0;
nBuffer[nIdx] = 0x0;
}

/* Loop through and configure each GPIO based to that specified by the
configuration index.*/
for(nIdx = 0; nIdx < nWhatSize; ++nIdx)
{
nWhichGpio = (uint16)HAL_GPIO_NUMBER(nWhichGpioSet[nIdx]);

/* Do not configure GPIOs specified as GENERIC DEFAULT. */
if( nWhichGpio >= HAL_TLMM_NUM_GPIO )
{
continue;
}

nGroup = HAL_GET_GROUP(nWhichGpio);
nGpioOffset = (nWhichGpio - HAL_tlmm_GroupStart[nGroup]);

/* Call the function to write GPIOn_PAGE and GPIOn_CFG if modem. */
HAL_tlmm_WriteConfig(nWhichGpio, nGroup, nWhichGpioSet[nIdx]);

nMask[nGroup] |= (1UL << nGpioOffset);

/* Mark GPIO for output enable if necessary or input. */
if( HAL_DIR_VAL(nWhichGpioSet[nIdx]) == HAL_TLMM_OUTPUT )
{
HAL_tlmm_SaveBuff[nGroup].oe_buff |= (1UL << nGpioOffset);
nBuffer[nGroup] |= (1UL << nGpioOffset);
}
else
{
HAL_tlmm_SaveBuff[nGroup].oe_buff &= ~(1UL << nGpioOffset);
nBuffer[nGroup] &= ~(1UL << nGpioOffset);
}
}

/* Do a masked write to all GPIO output enable registers. */
for( nIdx = 0; nIdx < HAL_TLMM_NUM_REG_GROUP; ++nIdx )
{
/* Program the output enable. */
HAL_tlmm_WriteRegister(HAL_REG_OE, nIdx, nMask[nIdx], nBuffer[nIdx]);
}
}


/*===========================================================================

FUNCTION GPIO_OUT

DESCRIPTION
Outputs the given value to the corresponding GPIO register given a GPIO
signal type. This function calculates the GPIO register and the mask
value.

DEPENDENCIES
None.

RETURN VALUE
None
===========================================================================*/

void gpio_out
(
GPIO_SignalType gpio_signal,
GPIO_ValueType gpio_value
)
{
BSP_ConfigType gpio_config;

/* Ensure the BSP has been initialized. */
if( !bsp_was_initialized )
{
gpio_tlmm_init_bsp();
}

if( gpio_signal == GPIO_GENERIC_DEFAULT )
{
MSG_ERROR("gpio_out(): GPIO Client or Signal is invalid.", 0, 0, 0);
return;
}

/* Get the configuration associated with this signal. */
gpio_config = pgBSPData->panConfigs[gpio_signal];

INTLOCK();
HAL_tlmm_WriteGpio(gpio_config, (boolean)gpio_value);
INTFREE();
}


/*===============================================================================

FUNCTION
void HAL_tlmm_WriteGpio( uint32 nWhichConfig, bool bValue )

DESCRIPTION
Outputs the supplied value to the GPIO register at the GPIO location..

DEPENDENCIES
The GPIO should be configured to be output before calling this function;
otherwise, the value written to the GPIO may not take effect.

RETURN VALUE
None.

SIDE EFFECTS
None.

===============================================================================*/
void HAL_tlmm_WriteGpio( uint32 nWhichConfig, boolean bValue )
{
uint32 nValue = 0x0;
uint16 nWhichGpio = (uint16)HAL_GPIO_NUMBER(nWhichConfig);

/* Get the GPIO Group number [0-n]. */
uint8 nGroup = HAL_GET_GROUP(nWhichGpio);
uint32 dwWriteMask = (1UL << (nWhichGpio - HAL_tlmm_GroupStart[nGroup]));

/* Ensure GPIO number is valid. */
if( nWhichGpio >= HAL_TLMM_NUM_GPIO )
{
return;
}

/* If operations on this GPIO are disabled. */
if( !HAL_GET_ENABLE(nWhichGpio) )
{
return;
}

/* Get the value to write. */
if( FALSE == bValue )
{
nValue = 0x0;
}
else
{
nValue = dwWriteMask;
}

/* Write the masked value to the corresponding GPIO_OUT register. */
HAL_tlmm_WriteRegister(HAL_REG_OUT, nGroup, dwWriteMask, nValue);
}