MTB CAT1 Peripheral driver library

General Description

Functions

void Cy_GPIO_SetVregEn (GPIO_PRT_Type *base, uint32_t pinNum, uint32_t value)
 Configures the SIO pin pair output buffer regulation mode. More...
 
uint32_t Cy_GPIO_GetVregEn (GPIO_PRT_Type *base, uint32_t pinNum)
 Returns the SIO pin pair output buffer regulation mode. More...
 
void Cy_GPIO_SetIbufMode (GPIO_PRT_Type *base, uint32_t pinNum, uint32_t value)
 Configures the SIO pin pair input buffer mode. More...
 
uint32_t Cy_GPIO_GetIbufMode (GPIO_PRT_Type *base, uint32_t pinNum)
 Returns the SIO pin pair input buffer mode. More...
 
void Cy_GPIO_SetVtripSel (GPIO_PRT_Type *base, uint32_t pinNum, uint32_t value)
 Configures the SIO pin pair input buffer trip point. More...
 
uint32_t Cy_GPIO_GetVtripSel (GPIO_PRT_Type *base, uint32_t pinNum)
 Returns the SIO pin pair input buffer trip point. More...
 
void Cy_GPIO_SetVrefSel (GPIO_PRT_Type *base, uint32_t pinNum, uint32_t value)
 Configures the SIO reference voltage for the input buffer trip point. More...
 
uint32_t Cy_GPIO_GetVrefSel (GPIO_PRT_Type *base, uint32_t pinNum)
 Returns the SIO reference voltage for the input buffer trip point. More...
 
void Cy_GPIO_SetVohSel (GPIO_PRT_Type *base, uint32_t pinNum, uint32_t value)
 Configures the regulated output reference multiplier for the SIO pin pair. More...
 
uint32_t Cy_GPIO_GetVohSel (GPIO_PRT_Type *base, uint32_t pinNum)
 Returns the regulated output reference multiplier for the SIO pin pair. More...
 

Function Documentation

◆ Cy_GPIO_SetVregEn()

void Cy_GPIO_SetVregEn ( GPIO_PRT_Type base,
uint32_t  pinNum,
uint32_t  value 
)

Configures the SIO pin pair output buffer regulation mode.

Note that this function has no effect on non-SIO pins.

Parameters
basePointer to the pin's port register base address
pinNumPosition of the pin bit-field within the port register
valueSIO pair output buffer regulator mode. Options are detailed in SIO output buffer mode macros
Note
This function modifies a port register in a read-modify-write operation. It is not thread safe as the resource is shared among multiple pins on a port.
Function Usage
/* Scenario: Assume P0.3 is an SIO pin and that it is paired with P0.2.
Both pins are configured as output pins. The output (driven)
signals on P0.2 and P0.3 need to be at a regulated voltage
based on Voh and VRef selection. */
/* Get the output buffer regulation mode of P0.2/P0.3 pair */
if(CY_SIO_VREG_UNREGULATED == Cy_GPIO_GetVregEn(P0_3_PORT, P0_3_NUM))
{
/* Set the output buffer to be regulated on the P0.2/P0.3 SIO pair */
}

◆ Cy_GPIO_GetVregEn()

uint32_t Cy_GPIO_GetVregEn ( GPIO_PRT_Type base,
uint32_t  pinNum 
)

Returns the SIO pin pair output buffer regulation mode.

Note that this function has no effect on non-SIO pins.

Parameters
basePointer to the pin's port register base address
pinNumPosition of the pin bit-field within the port register
Returns
SIO pair output buffer regulator mode. Options are detailed in SIO output buffer mode macros
Function Usage
/* Scenario: Assume P0.3 is an SIO pin and that it is paired with P0.2.
Both pins are configured as output pins. The output (driven)
signals on P0.2 and P0.3 need to be at a regulated voltage
based on Voh and VRef selection. */
/* Get the output buffer regulation mode of P0.2/P0.3 pair */
if(CY_SIO_VREG_UNREGULATED == Cy_GPIO_GetVregEn(P0_3_PORT, P0_3_NUM))
{
/* Set the output buffer to be regulated on the P0.2/P0.3 SIO pair */
}

◆ Cy_GPIO_SetIbufMode()

void Cy_GPIO_SetIbufMode ( GPIO_PRT_Type base,
uint32_t  pinNum,
uint32_t  value 
)

Configures the SIO pin pair input buffer mode.

Note that this function has no effect on non-SIO pins.

Parameters
basePointer to the pin's port register base address
pinNumPosition of the pin bit-field within the port register
valueSIO pair input buffer mode. Options are detailed in SIO input buffer mode macros
Note
This function modifies a port register in a read-modify-write operation. It is not thread safe as the resource is shared among multiple pins on a port.
Function Usage
/* Scenario: Assume P0.3 is an SIO pin and that it is paired with P0.2.
Both pins are configured as input pins. The input signals
on P0.2 and P0.3 need to be interpreted as logic 0 or 1
depending on the chosen SIO vtrip point. */
/* Get the input buffer mode of P0.2/P0.3 pair */
if(CY_SIO_IBUF_SINGLEENDED == Cy_GPIO_GetIbufMode(P0_3_PORT, P0_3_NUM))
{
/* Set the input buffer to be differential on the P0.2/P0.3 SIO pair */
}

◆ Cy_GPIO_GetIbufMode()

uint32_t Cy_GPIO_GetIbufMode ( GPIO_PRT_Type base,
uint32_t  pinNum 
)

Returns the SIO pin pair input buffer mode.

Note that this function has no effect on non-SIO pins.

Parameters
basePointer to the pin's port register base address
pinNumPosition of the pin bit-field within the port register
Returns
SIO pair input buffer mode. Options are detailed in SIO input buffer mode macros
Function Usage
/* Scenario: Assume P0.3 is an SIO pin and that it is paired with P0.2.
Both pins are configured as input pins. The input signals
on P0.2 and P0.3 need to be interpreted as logic 0 or 1
depending on the chosen SIO vtrip point. */
/* Get the input buffer mode of P0.2/P0.3 pair */
if(CY_SIO_IBUF_SINGLEENDED == Cy_GPIO_GetIbufMode(P0_3_PORT, P0_3_NUM))
{
/* Set the input buffer to be differential on the P0.2/P0.3 SIO pair */
}

◆ Cy_GPIO_SetVtripSel()

void Cy_GPIO_SetVtripSel ( GPIO_PRT_Type base,
uint32_t  pinNum,
uint32_t  value 
)

Configures the SIO pin pair input buffer trip point.

Note that this function has no effect on non-SIO pins.

Parameters
basePointer to the pin's port register base address
pinNumPosition of the pin bit-field within the port register
valueSIO pair input buffer trip point. Options are detailed in SIO input buffer trip-point macros
Note
This function modifies a port register in a read-modify-write operation. It is not thread safe as the resource is shared among multiple pins on a port.
Function Usage
/* Scenario: Assume P0.3 is an SIO pin and that it is paired with P0.2.
Both pins are configured as input pins. The input signals
on P0.2 and P0.3 need to be interpreted as logic 0 or 1 at
0.5 x VDDIO threshold. */
/* Set the input buffer to be differential on the P0.2/P0.3 SIO pair */
/* Choose VREF to be sourced from VDDIO (pin ref) */
Cy_GPIO_SetVrefSel(P0_3_PORT, P0_3_NUM, CY_SIO_VREF_PINREF);
/* Get the input buffer trip-point of P0.2/P0.3 pair */
if(CY_SIO_VTRIP_CMOS == Cy_GPIO_GetVtripSel(P0_3_PORT, P0_3_NUM))
{
/* Set the input buffer trip-point to 0.5 x VDDIO on the P0.2/P0.3 SIO pair */
}

◆ Cy_GPIO_GetVtripSel()

uint32_t Cy_GPIO_GetVtripSel ( GPIO_PRT_Type base,
uint32_t  pinNum 
)

Returns the SIO pin pair input buffer trip point.

Note that this function has no effect on non-SIO pins.

Parameters
basePointer to the pin's port register base address
pinNumPosition of the pin bit-field within the port register
Returns
SIO pair input buffer trip point. Options are detailed in SIO input buffer trip-point macros
Function Usage
/* Scenario: Assume P0.3 is an SIO pin and that it is paired with P0.2.
Both pins are configured as input pins. The input signals
on P0.2 and P0.3 need to be interpreted as logic 0 or 1 at
0.5 x VDDIO threshold. */
/* Set the input buffer to be differential on the P0.2/P0.3 SIO pair */
/* Choose VREF to be sourced from VDDIO (pin ref) */
Cy_GPIO_SetVrefSel(P0_3_PORT, P0_3_NUM, CY_SIO_VREF_PINREF);
/* Get the input buffer trip-point of P0.2/P0.3 pair */
if(CY_SIO_VTRIP_CMOS == Cy_GPIO_GetVtripSel(P0_3_PORT, P0_3_NUM))
{
/* Set the input buffer trip-point to 0.5 x VDDIO on the P0.2/P0.3 SIO pair */
}

◆ Cy_GPIO_SetVrefSel()

void Cy_GPIO_SetVrefSel ( GPIO_PRT_Type base,
uint32_t  pinNum,
uint32_t  value 
)

Configures the SIO reference voltage for the input buffer trip point.

Note that this function has no effect on non-SIO pins.

Parameters
basePointer to the pin's port register base address
pinNumPosition of the pin bit-field within the port register
valueSIO pair reference voltage. Options are detailed in SIO reference voltage for input buffer trip-point macros
Note
This function modifies a port register in a read-modify-write operation. It is not thread safe as the resource is shared among multiple pins on a port.
Function Usage
/* Scenario: Assume P0.3 is an SIO pin and that it is paired with P0.2.
Both pins are configured as input pins. The input signals
on P0.2 and P0.3 need to be interpreted as logic 0 or 1 at
1.25 x 1.2V threshold. */
/* Set the input buffer to be differential on the P0.2/P0.3 SIO pair */
/* Set the input buffer trip-point to 0.5 x VOH on the P0.2/P0.3 SIO pair */
/* Set the regulated input buffer trip point multiplier to 1.25 x VRef */
Cy_GPIO_SetVohSel(P0_3_PORT, P0_3_NUM, CY_SIO_VOH_1_25);
/* Get the reference voltage of P0.2/P0.3 pair */
if(CY_SIO_VREF_PINREF == Cy_GPIO_GetVrefSel(P0_3_PORT, P0_3_NUM))
{
/* Set the reference voltage to 1.2V SRSS internal reference on the P0.2/P0.3 SIO pair */
Cy_GPIO_SetVrefSel(P0_3_PORT, P0_3_NUM, CY_SIO_VREF_1_2V);
}

◆ Cy_GPIO_GetVrefSel()

uint32_t Cy_GPIO_GetVrefSel ( GPIO_PRT_Type base,
uint32_t  pinNum 
)

Returns the SIO reference voltage for the input buffer trip point.

Note that this function has no effect on non-SIO pins.

Parameters
basePointer to the pin's port register base address
pinNumPosition of the pin bit-field within the port register
Returns
SIO pair reference voltage. Options are detailed in SIO reference voltage for input buffer trip-point macros
Function Usage
/* Scenario: Assume P0.3 is an SIO pin and that it is paired with P0.2.
Both pins are configured as input pins. The input signals
on P0.2 and P0.3 need to be interpreted as logic 0 or 1 at
1.25 x 1.2V threshold. */
/* Set the input buffer to be differential on the P0.2/P0.3 SIO pair */
/* Set the input buffer trip-point to 0.5 x VOH on the P0.2/P0.3 SIO pair */
/* Set the regulated input buffer trip point multiplier to 1.25 x VRef */
Cy_GPIO_SetVohSel(P0_3_PORT, P0_3_NUM, CY_SIO_VOH_1_25);
/* Get the reference voltage of P0.2/P0.3 pair */
if(CY_SIO_VREF_PINREF == Cy_GPIO_GetVrefSel(P0_3_PORT, P0_3_NUM))
{
/* Set the reference voltage to 1.2V SRSS internal reference on the P0.2/P0.3 SIO pair */
Cy_GPIO_SetVrefSel(P0_3_PORT, P0_3_NUM, CY_SIO_VREF_1_2V);
}

◆ Cy_GPIO_SetVohSel()

void Cy_GPIO_SetVohSel ( GPIO_PRT_Type base,
uint32_t  pinNum,
uint32_t  value 
)

Configures the regulated output reference multiplier for the SIO pin pair.

The regulated output reference controls both the output level of digital output pin and the input trip point of digital input pin in the SIO pair.

Note that this function has no effect on non-SIO pins.

Parameters
basePointer to the pin's port register base address
pinNumPosition of the pin bit-field within the port register
valueSIO pair reference voltage. Options are detailed in Regulated output voltage level (Voh) and input buffer trip-point of an SIO pair macros
Note
This function modifies a port register in a read-modify-write operation. It is not thread safe as the resource is shared among multiple pins on a port.
Function Usage
/* Scenario: Assume P0.3 is an SIO pin and that it is paired with P0.2.
Both pins are configured as output pins. The output (driven)
signals on P0.2 and P0.3 need to be at
2.5 x AMuxBusA voltage x 2 for logic high. */
/* Set the output buffer to be regulated on the P0.2/P0.3 SIO pair */
/* Set the reference voltage to be sourced from AMUXBUS A */
Cy_GPIO_SetVrefSel(P0_3_PORT, P0_3_NUM, CY_SIO_VREF_AMUX_A);
/* Get the regulated voltage multiplier value of P0.2/P0.3 pair */
if(CY_SIO_VOH_1_00 == Cy_GPIO_GetVohSel(P0_3_PORT, P0_3_NUM))
{
/* Set the regulated voltage multiplier to 2.5 x VRef */
Cy_GPIO_SetVohSel(P0_3_PORT, P0_3_NUM, CY_SIO_VOH_2_50);
}

◆ Cy_GPIO_GetVohSel()

uint32_t Cy_GPIO_GetVohSel ( GPIO_PRT_Type base,
uint32_t  pinNum 
)

Returns the regulated output reference multiplier for the SIO pin pair.

Note that this function has no effect on non-SIO pins.

Parameters
basePointer to the pin's port register base address
pinNumPosition of the pin bit-field within the port register
Returns
SIO pair reference voltage. Options are detailed in Regulated output voltage level (Voh) and input buffer trip-point of an SIO pair macros
Function Usage
/* Scenario: Assume P0.3 is an SIO pin and that it is paired with P0.2.
Both pins are configured as output pins. The output (driven)
signals on P0.2 and P0.3 need to be at
2.5 x AMuxBusA voltage x 2 for logic high. */
/* Set the output buffer to be regulated on the P0.2/P0.3 SIO pair */
/* Set the reference voltage to be sourced from AMUXBUS A */
Cy_GPIO_SetVrefSel(P0_3_PORT, P0_3_NUM, CY_SIO_VREF_AMUX_A);
/* Get the regulated voltage multiplier value of P0.2/P0.3 pair */
if(CY_SIO_VOH_1_00 == Cy_GPIO_GetVohSel(P0_3_PORT, P0_3_NUM))
{
/* Set the regulated voltage multiplier to 2.5 x VRef */
Cy_GPIO_SetVohSel(P0_3_PORT, P0_3_NUM, CY_SIO_VOH_2_50);
}