Ucs_Return_t Ucs_Gpio_WritePort	(	Ucs_Inst_t *	self,
		uint16_t	destination_address,
		uint16_t	gpio_port_handle,
		uint16_t	mask,
		uint16_t	data,
		Ucs_Gpio_PinStateResCb_t	result_fptr
	)

Writes data to the given GPIO port.

This function corresponds with the INIC function INIC.GPIOPortPinState.

Parameters

self	The UNICENS instance pointer
destination_address	Address of the target device. Use the UCS_ADDR_LOCAL_DEV macro to target the local device. The following address ranges are supported: [0x10 ... 0x2FF] [0x500 ... 0xFEF] UCS_ADDR_LOCAL_DEV
gpio_port_handle	The GPIO Port resource handle.   GPIOPortHandle
mask	The GPIO pin to be written.   Mask
data	The state of the GPIO pin to be written.   Data
result_fptr	Required result callback function pointer.

Returns

Possible return values are shown in the table below.

Value	Description
UCS_RET_SUCCESS	No error
UCS_RET_ERR_PARAM	At least one parameter is wrong
UCS_RET_ERR_BUFFER_OVERFLOW	No message buffer available
UCS_RET_ERR_API_LOCKED	API is currently locked
UCS_RET_ERR_NOT_INITIALIZED	UNICENS is not initialized

Example

 // Main function
 void main()
 {
     Ucs_Return_t result = Ucs_Gpio_WritePort(0x555U, 0x1D00, 0x0039U, 0x0038U, &App_GpioWritePortResCb);
     if (result != UCS_RET_SUCCESS)
     {
         // Error handling here 
     }
 }

// The event handler function
// Handle GpioWritePort event
static void App_GpioWritePortResCb(uint16_t device_id, uint16_t port_handle, uint16_t current_state, uint16_t sticky_state, Ucs_Gpio_Result_t result, void * user_ptr)
{
    if (result.code == UCS_GPIO_RES_SUCCESS)
    {
        // Do what needs to be..
    }
    else
    {
         // Error handling here
         switch(result.details.result_type)
         {
            case UCS_GPIO_RESULT_TYPE_TGT:
            // Handle the target results
            break;

            case UCS_GPIO_RESULT_TYPE_TX:
            // Handle transmission error
            break;
         }
    }
}