m2m_wifi_set_device_name

Functions
NMI_API sint8	m2m_wifi_set_device_name (uint8 *pu8DeviceName, uint8 u8DeviceNameLength)

Detailed Description

Sets the WINC device name. The name string is used as a device name in both (P2P) WiFi-Direct mode as well as DHCP hostname (option 12). For P2P devices to communicate a device name must be present. If it is not set through this function a default name is assigned. The default name is WINC-XX-YY, where XX and YY are the last 2 octets of the OTP MAC address. If OTP (eFuse) is programmed, then the default name is WINC-00-00.

Function Documentation

m2m_wifi_set_device_name()

NMI_API sint8 m2m_wifi_set_device_name	(	uint8 *	pu8DeviceName,
		uint8	u8DeviceNameLength
	)

Parameters

[in]	pu8DeviceName	A Buffer holding the device name. Device name is a null terminated C string.
[in]	u8DeviceNameLength	The length of the device name. Should not exceed the maximum device name's length M2M_DEVICE_NAME_MAX (including null character).

Warning

The function called once after initialization. Used for the Wi-Fi Direct (P2P) as well as DHCP client hostname option (12).

Device name shall contain only characters allowed in valid internet host name as defined in RFC 952 and 1123.

Returns

The function returns M2M_SUCCESS for successful operations and a negative value otherwise.