Description

General Purpose Input/Output (GPIO) API.

This module contains functions to control the GPIO peripheral of Silicon Labs 32-bit MCUs and SoCs. The GPIO peripheral is used for pin configuration and direct pin manipulation and sensing as well as routing for peripheral pin connections.

Functions
void	GPIO_DbgLocationSet (unsigned int location)
	Sets the pin location of the debug pins (Serial Wire interface).

void	GPIO_DriveModeSet ( GPIO_Port_TypeDef port, GPIO_DriveMode_TypeDef mode)
	Sets drive mode for a GPIO port.

void	GPIO_ExtIntConfig ( GPIO_Port_TypeDef port, unsigned int pin, unsigned int intNo, bool risingEdge, bool fallingEdge, bool enable)
	Configure the GPIO external pin interrupt.

void	GPIO_PinModeSet ( GPIO_Port_TypeDef port, unsigned int pin, GPIO_Mode_TypeDef mode, unsigned int out)
	Set the mode for a GPIO pin.

GPIO_Mode_TypeDef	GPIO_PinModeGet ( GPIO_Port_TypeDef port, unsigned int pin)
	Get the mode for a GPIO pin.

void	GPIO_EM4EnablePinWakeup (uint32_t pinmask, uint32_t polaritymask)
	Enable GPIO pin wake-up from EM4.

void	GPIO_DbgSWDClkEnable (bool enable)
	Enable/disable serial wire clock pin.

void	GPIO_DbgSWDIOEnable (bool enable)
	Enable/disable serial wire data I/O pin.

void	GPIO_DbgSWOEnable (bool enable)
	Enable/Disable serial wire output pin.

void	GPIO_EM4DisablePinWakeup (uint32_t pinmask)
	Disable GPIO pin wake-up from EM4.

uint32_t	GPIO_EM4GetPinWakeupCause (void)
	Check which GPIO pin(s) that caused a wake-up from EM4.

void	GPIO_EM4SetPinRetention (bool enable)
	Enable GPIO pin retention of output enable, output value, pull enable, and pull direction in EM4.

void	GPIO_InputSenseSet (uint32_t val, uint32_t mask)
	Enable/disable input sensing.

void	GPIO_IntClear (uint32_t flags)
	Clear one or more pending GPIO interrupts.

void	GPIO_IntDisable (uint32_t flags)
	Disable one or more GPIO interrupts.

void	GPIO_IntEnable (uint32_t flags)
	Enable one or more GPIO interrupts.

uint32_t	GPIO_IntGet (void)
	Get pending GPIO interrupts.

uint32_t	GPIO_IntGetEnabled (void)
	Get enabled and pending GPIO interrupt flags.

void	GPIO_IntSet (uint32_t flags)
	Set one or more pending GPIO interrupts from SW.

void	GPIO_Lock (void)
	Locks the GPIO configuration.

unsigned int	GPIO_PinInGet ( GPIO_Port_TypeDef port, unsigned int pin)
	Read the pad value for a single pin in a GPIO port.

void	GPIO_PinLock ( GPIO_Port_TypeDef port, unsigned int pin)
	Lock all GPIO configuration settings for a given pin.

void	GPIO_PinOutClear ( GPIO_Port_TypeDef port, unsigned int pin)
	Set a single pin in GPIO data out port register to 0.

unsigned int	GPIO_PinOutGet ( GPIO_Port_TypeDef port, unsigned int pin)
	Get current setting for a pin in a GPIO port data out register.

void	GPIO_PinOutSet ( GPIO_Port_TypeDef port, unsigned int pin)
	Set a single pin in GPIO data out register to 1.

void	GPIO_PinOutToggle ( GPIO_Port_TypeDef port, unsigned int pin)
	Toggle a single pin in GPIO port data out register.

uint32_t	GPIO_PortInGet ( GPIO_Port_TypeDef port)
	Read the pad values for GPIO port.

void	GPIO_PortOutClear ( GPIO_Port_TypeDef port, uint32_t pins)
	Set bits in DOUT register for a port to 0.

uint32_t	GPIO_PortOutGet ( GPIO_Port_TypeDef port)
	Get current setting for a GPIO port data out register.

void	GPIO_PortOutSet ( GPIO_Port_TypeDef port, uint32_t pins)
	Set bits GPIO data out register to 1.

void	GPIO_PortOutSetVal ( GPIO_Port_TypeDef port, uint32_t val, uint32_t mask)
	Set GPIO port data out register.

void	GPIO_PortOutToggle ( GPIO_Port_TypeDef port, uint32_t pins)
	Toggle pins in GPIO port data out register.

void	GPIO_Unlock (void)
	Unlocks the GPIO configuration.

void	GPIO_IntConfig ( GPIO_Port_TypeDef port, unsigned int pin, bool risingEdge, bool fallingEdge, bool enable)
	Configure GPIO interrupt.

Enumerations
enum	GPIO_Port_TypeDef { gpioPortA = 0, gpioPortB = 1, gpioPortC = 2, gpioPortD = 3, gpioPortE = 4, gpioPortF = 5 }
	GPIO ports IDs.

enum	GPIO_DriveMode_TypeDef { gpioDriveModeStandard = GPIO_P_CTRL_DRIVEMODE_STANDARD, gpioDriveModeLowest = GPIO_P_CTRL_DRIVEMODE_LOWEST, gpioDriveModeHigh = GPIO_P_CTRL_DRIVEMODE_HIGH, gpioDriveModeLow = GPIO_P_CTRL_DRIVEMODE_LOW }
	GPIO drive mode.

enum	GPIO_Mode_TypeDef { gpioModeDisabled = _GPIO_P_MODEL_MODE0_DISABLED, gpioModeInput = _GPIO_P_MODEL_MODE0_INPUT, gpioModeInputPull = _GPIO_P_MODEL_MODE0_INPUTPULL, gpioModeInputPullFilter = _GPIO_P_MODEL_MODE0_INPUTPULLFILTER, gpioModePushPull = _GPIO_P_MODEL_MODE0_PUSHPULL, gpioModePushPullDrive = _GPIO_P_MODEL_MODE0_PUSHPULLDRIVE, gpioModeWiredOr = _GPIO_P_MODEL_MODE0_WIREDOR, gpioModeWiredOrPullDown = _GPIO_P_MODEL_MODE0_WIREDORPULLDOWN, gpioModeWiredAnd = _GPIO_P_MODEL_MODE0_WIREDAND, gpioModeWiredAndFilter = _GPIO_P_MODEL_MODE0_WIREDANDFILTER, gpioModeWiredAndPullUp = _GPIO_P_MODEL_MODE0_WIREDANDPULLUP, gpioModeWiredAndPullUpFilter = _GPIO_P_MODEL_MODE0_WIREDANDPULLUPFILTER, gpioModeWiredAndDrive = _GPIO_P_MODEL_MODE0_WIREDANDDRIVE, gpioModeWiredAndDriveFilter = _GPIO_P_MODEL_MODE0_WIREDANDDRIVEFILTER, gpioModeWiredAndDrivePullUp = _GPIO_P_MODEL_MODE0_WIREDANDDRIVEPULLUP, gpioModeWiredAndDrivePullUpFilter = _GPIO_P_MODEL_MODE0_WIREDANDDRIVEPULLUPFILTER }
	Pin mode.

Function Documentation

◆ GPIO_DbgLocationSet()

void GPIO_DbgLocationSet ( unsigned int location )

Sets the pin location of the debug pins (Serial Wire interface).

Note: Changing the pins used for debugging uncontrolled, may result in a lockout.

Parameters

[in] location The debug pin location to use (0-3).

◆ GPIO_DriveModeSet()

void GPIO_DriveModeSet	(	GPIO_Port_TypeDef	`port,`
		GPIO_DriveMode_TypeDef	`mode`
	)

Sets drive mode for a GPIO port.

Parameters

[in]	`port`	The GPIO port to access.
[in]	`mode`	Drive mode to use for the port.

◆ GPIO_ExtIntConfig()

void GPIO_ExtIntConfig	(	GPIO_Port_TypeDef	`port,`
		unsigned int	`pin,`
		unsigned int	`intNo,`
		bool	`risingEdge,`
		bool	`fallingEdge,`
		bool	`enable`
	)

Configure the GPIO external pin interrupt.

It is recommended to disable interrupts before configuring the GPIO pin interrupt. See GPIO_IntDisable() for more information.

The GPIO interrupt handler must be in place before enabling the interrupt.

Notice that any pending interrupt for the selected interrupt is cleared by this function.

Note: On series 0 devices, the pin number parameter is not used. The pin number used on these devices is hardwired to the interrupt with the same number.
On series 1 devices, the pin number can be selected freely within a group. Interrupt numbers are divided into 4 groups (intNo / 4) and valid pin number within the interrupt groups are: 0: pins 0-3 (interrupt number 0-3) 1: pins 4-7 (interrupt number 4-7) 2: pins 8-11 (interrupt number 8-11) 3: pins 12-15 (interrupt number 12-15)

Parameters

[in]	`port`	The port to associate with the `pin` .
[in]	`pin`	The pin number on the port.
[in]	`intNo`	The interrupt number to trigger.
[in]	`risingEdge`	Set to true if the interrupt will be enabled on the rising edge. Otherwise, false.
[in]	`fallingEdge`	Set to true if the interrupt will be enabled on the falling edge. Otherwise, false.
[in]	`enable`	Set to true if the interrupt will be enabled after the configuration is complete. False to leave disabled. See GPIO_IntDisable() and GPIO_IntEnable() .

◆ GPIO_PinModeSet()

void GPIO_PinModeSet	(	GPIO_Port_TypeDef	`port,`
		unsigned int	`pin,`
		GPIO_Mode_TypeDef	`mode,`
		unsigned int	`out`
	)

Set the mode for a GPIO pin.

Parameters

[in]	`port`	The GPIO port to access.
[in]	`pin`	The pin number in the port.
[in]	`mode`	The desired pin mode.
[in]	`out`	A value to set for the pin in the DOUT register. The DOUT setting is important for some input mode configurations to determine the pull-up/down direction.

◆ GPIO_PinModeGet()

GPIO_Mode_TypeDef GPIO_PinModeGet	(	GPIO_Port_TypeDef	`port,`
		unsigned int	`pin`
	)

Get the mode for a GPIO pin.

Parameters

[in]	`port`	The GPIO port to access.
[in]	`pin`	The pin number in the port.

Returns: The pin mode.

◆ GPIO_EM4EnablePinWakeup()

void GPIO_EM4EnablePinWakeup	(	uint32_t	`pinmask,`
		uint32_t	`polaritymask`
	)

Enable GPIO pin wake-up from EM4.

When the function exits, EM4 mode can be safely entered.

Note: It is assumed that the GPIO pin modes are set correctly. Valid modes are gpioModeInput and gpioModeInputPull .

Parameters

[in]	`pinmask`	A bitmask containing the bitwise logic OR of which GPIO pin(s) to enable. See Reference Manuals for a pinmask to the GPIO port/pin mapping.
[in]	`polaritymask`	A bitmask containing the bitwise logic OR of GPIO pin(s) wake-up polarity. See Reference Manuals for pinmask-to-GPIO port/pin mapping.

◆ GPIO_DbgSWDClkEnable()

void GPIO_DbgSWDClkEnable ( bool enable )

inline

Enable/disable serial wire clock pin.

Note: Disabling SWDClk will disable the debug interface, which may result in a lockout if done early in startup (before debugger is able to halt core).

Parameters

[in]


              enable

false - disable serial wire clock.
true - enable serial wire clock (default after reset).

GPIO - General Purpose Input/Output

Description

Functions

Enumerations

Function Documentation

◆ GPIO_DbgLocationSet()

◆ GPIO_DriveModeSet()

◆ GPIO_ExtIntConfig()

◆ GPIO_PinModeSet()

◆ GPIO_PinModeGet()

◆ GPIO_EM4EnablePinWakeup()

◆ GPIO_DbgSWDClkEnable()

◆ GPIO_DbgSWDIOEnable()