nn::uds::CTR::CreateNetwork Function

Syntax

nn::Result CreateNetwork(
     u8 subId,
     u8 maxEntry,
     bit32 localId,
     const char passphrase[],
     size_t passphraseLength,
     u8 channel
);

Arguments

Name Description
in subId Communication mode ID. The application can set any arbitrary value for this.
in maxEntry Maximum number of nodes that can connect to the network. This value can be up to 12, including the local device.
in localId The local communication ID. Specify the value generated by CreateLocalCommunicationId.
in passphrase[] String holding the seed of the passphrase to use for wireless layer encryption. With UDS, communication can only be established if uniqueId and passphrase match.
in passphraseLength Passphrase length. Specify a value between UDS_PASSPHRASE_LENGTH_MIN and UDS_PASSPHRASE_LENGTH_MAX, inclusive.
in channel The channel to use for communication. Specify channel 0 (automatic), 1, 6, or 11. When this function runs on retail systems, the channel is always selected automatically.

Return Values

Returns the function's execution result. Returns one of the Result values listed below.
Value Description
ResultSuccess Successfully established local communication and began operating as a master.
ResultNotInitialized The library is not initialized. Call the nn::uds::Initialize function.
ResultInvalidState Not in an executable state. Returned when executed in a state other than STATE_DISCONNECTED.
ResultOutOfRange The specified argument value was not in the valid range for the argument. Try again, specifying a valid value for the argument.
ResultWirelessOff Transitioned to wireless OFF mode. Re-initialization is required.
A value other than the above. Failed for reasons other than those given above.

Description

Creates a new network. This function is provided for debugging purposes and can be used to specify the channel to use for wireless communication during development. Note that the channel argument is ignored on production hardware.

Revision History

2011/01/25
Changed size of passphrase used from "fewer than 255 (provisional)" to "at least 8 and no more than 255," and confirmed.
Changed to automatically set the channel to use, with the old function to specify the channel now limited to debugging purposes.
2010/10/15
Expanded the information on the return values.
2010/06/14
Initial version.

CONFIDENTIAL