network/uds/source/uds.c
#include <stdio.h>
#include <stdlib.h>
#include <string.h>
#include <malloc.h>
#include <errno.h>
#include <stdarg.h>
#include <unistd.h>
#include <3ds.h>
void print_constatus()
{
Result ret=0;
u32 pos;
udsConnectionStatus constatus;
//By checking the output of udsGetConnectionStatus you can check for nodes (including the current one) which just (dis)connected, etc.
ret = udsGetConnectionStatus(&constatus);
if(R_FAILED(ret))
{
printf("udsGetConnectionStatus() returned 0x%08x.\n", (unsigned int)ret);
}
else
{
printf("constatus:\nstatus=0x%x\n", (unsigned int)constatus.status);
printf("1=0x%x\n", (unsigned int)constatus.unk_x4);
printf("cur_NetworkNodeID=0x%x\n", (unsigned int)constatus.cur_NetworkNodeID);
printf("unk_xa=0x%x\n", (unsigned int)constatus.unk_xa);
for(pos=0; pos<(0x20>>2); pos++)printf("%u=0x%x ", (unsigned int)pos+3, (unsigned int)constatus.unk_xc[pos]);
printf("\ntotal_nodes=0x%x\n", (unsigned int)constatus.total_nodes);
printf("max_nodes=0x%x\n", (unsigned int)constatus.max_nodes);
printf("node_bitmask=0x%x\n", (unsigned int)constatus.total_nodes);
}
}
void uds_test()
{
Result ret=0;
u32 con_type=0;
u32 *tmpbuf;
size_t tmpbuf_size;
u8 data_channel = 1;
udsNetworkStruct networkstruct;
udsBindContext bindctx;
udsNetworkScanInfo *networks = NULL;
udsNetworkScanInfo *network = NULL;
size_t total_networks = 0;
u32 recv_buffer_size = UDS_DEFAULT_RECVBUFSIZE;
u32 wlancommID = 0x48425710;//Unique ID, change this to your own.
char *passphrase = "udsdemo passphrase c186093cd2652741";//Change this passphrase to your own. The input you use for the passphrase doesn't matter since it's a raw buffer.
udsConnectionType conntype = UDSCONTYPE_Client;
u32 transfer_data, prev_transfer_data = 0;
size_t actual_size;
u16 src_NetworkNodeID;
u32 tmp=0;
u32 pos;
udsNodeInfo tmpnode;
u8 appdata[0x14] = {0x69, 0x8a, 0x05, 0x5c};
u8 out_appdata[0x14];
char tmpstr[256];
strncpy((char*)&appdata[4], "Test appdata.", sizeof(appdata)-4);
printf("Successfully initialized.\n");
tmpbuf_size = 0x4000;
tmpbuf = malloc(tmpbuf_size);
if(tmpbuf==NULL)
{
printf("Failed to allocate tmpbuf for beacon data.\n");
return;
}
//With normal client-side handling you'd keep running network-scanning until the user chooses to stops scanning or selects a network to connect to. This example just scans a maximum of 10 times until at least one network is found.
for(pos=0; pos<10; pos++)
{
total_networks = 0;
memset(tmpbuf, 0, sizeof(tmpbuf_size));
ret = udsScanBeacons(tmpbuf, tmpbuf_size, &networks, &total_networks, wlancommID, 0, NULL, false);
printf("udsScanBeacons() returned 0x%08x.\ntotal_networks=%u.\n", (unsigned int)ret, (unsigned int)total_networks);
if(total_networks)break;
}
free(tmpbuf);
tmpbuf = NULL;
if(total_networks)
{
//At this point you'd let the user select which network to connect to and optionally display the first node's username(the host), along with the parsed appdata if you want. For this example this just uses the first detected network and then displays the username of each node.
//If appdata isn't enough, you can do what DLP does loading the icon data etc: connect to the network as a spectator temporarily for receiving broadcasted data frames.
network = &networks[0];
printf("network: total nodes = %u.\n", (unsigned int)network->network.total_nodes);
for(pos=0; pos<UDS_MAXNODES; pos++)
{
if(!udsCheckNodeInfoInitialized(&network->nodes[pos]))continue;
memset(tmpstr, 0, sizeof(tmpstr));
ret = udsGetNodeInfoUsername(&network->nodes[pos], tmpstr);
if(R_FAILED(ret))
{
printf("udsGetNodeInfoUsername() returned 0x%08x.\n", (unsigned int)ret);
free(networks);
return;
}
printf("node%u username: %s\n", (unsigned int)pos, tmpstr);
}
//You can load appdata from the scanned beacon data here if you want.
actual_size = 0;
ret = udsGetNetworkStructApplicationData(&network->network, out_appdata, sizeof(out_appdata), &actual_size);
if(R_FAILED(ret) || actual_size!=sizeof(out_appdata))
{
printf("udsGetNetworkStructApplicationData() returned 0x%08x. actual_size = 0x%x.\n", (unsigned int)ret, actual_size);
free(networks);
return;
}
memset(tmpstr, 0, sizeof(tmpstr));
if(memcmp(out_appdata, appdata, 4)!=0)
{
printf("The first 4-bytes of appdata is invalid.\n");
free(networks);
return;
}
strncpy(tmpstr, (char*)&out_appdata[4], sizeof(out_appdata)-5);
tmpstr[sizeof(out_appdata)-6]='\0';
printf("String from network appdata: %s\n", (char*)&out_appdata[4]);
hidScanInput();//Normally you would only connect as a regular client.
if(hidKeysHeld() & KEY_L)
{
conntype = UDSCONTYPE_Spectator;
printf("Connecting to the network as a spectator...\n");
}
else
{
printf("Connecting to the network as a client...\n");
}
for(pos=0; pos<10; pos++)
{
ret = udsConnectNetwork(&network->network, passphrase, strlen(passphrase)+1, &bindctx, UDS_BROADCAST_NETWORKNODEID, conntype, data_channel, recv_buffer_size);
if(R_FAILED(ret))
{
printf("udsConnectNetwork() returned 0x%08x.\n", (unsigned int)ret);
}
else
{
break;
}
}
free(networks);
if(pos==10)return;
printf("Connected.\n");
tmp = 0;
ret = udsGetChannel((u8*)&tmp);//Normally you don't need to use this.
printf("udsGetChannel() returned 0x%08x. channel = %u.\n", (unsigned int)ret, (unsigned int)tmp);
if(R_FAILED(ret))
{
return;
}
//You can load the appdata with this once connected to the network, if you want.
memset(out_appdata, 0, sizeof(out_appdata));
actual_size = 0;
ret = udsGetApplicationData(out_appdata, sizeof(out_appdata), &actual_size);
if(R_FAILED(ret) || actual_size!=sizeof(out_appdata))
{
printf("udsGetApplicationData() returned 0x%08x. actual_size = 0x%x.\n", (unsigned int)ret, actual_size);
udsDisconnectNetwork();
udsUnbind(&bindctx);
return;
}
memset(tmpstr, 0, sizeof(tmpstr));
if(memcmp(out_appdata, appdata, 4)!=0)
{
printf("The first 4-bytes of appdata is invalid.\n");
udsDisconnectNetwork();
udsUnbind(&bindctx);
return;
}
strncpy(tmpstr, (char*)&out_appdata[4], sizeof(out_appdata)-5);
tmpstr[sizeof(out_appdata)-6]='\0';
printf("String from appdata: %s\n", (char*)&out_appdata[4]);
con_type = 1;
}
else
{
udsGenerateDefaultNetworkStruct(&networkstruct, wlancommID, 0, UDS_MAXNODES);
printf("Creating the network...\n");
ret = udsCreateNetwork(&networkstruct, passphrase, strlen(passphrase)+1, &bindctx, data_channel, recv_buffer_size);
if(R_FAILED(ret))
{
printf("udsCreateNetwork() returned 0x%08x.\n", (unsigned int)ret);
return;
}
ret = udsSetApplicationData(appdata, sizeof(appdata));//If you want to use appdata, you can set the appdata whenever you want after creating the network. If you need more space for appdata, you can set different chunks of appdata over time.
if(R_FAILED(ret))
{
printf("udsSetApplicationData() returned 0x%08x.\n", (unsigned int)ret);
udsDestroyNetwork();
udsUnbind(&bindctx);
return;
}
tmp = 0;
ret = udsGetChannel((u8*)&tmp);//Normally you don't need to use this.
printf("udsGetChannel() returned 0x%08x. channel = %u.\n", (unsigned int)ret, (unsigned int)tmp);
if(R_FAILED(ret))
{
udsDestroyNetwork();
udsUnbind(&bindctx);
return;
}
con_type = 0;
}
if(udsWaitConnectionStatusEvent(false, false))
{
printf("Constatus event signaled.\n");
print_constatus();
}
printf("Press A to stop data transfer.\n");
tmpbuf_size = UDS_DATAFRAME_MAXSIZE;
tmpbuf = malloc(tmpbuf_size);
if(tmpbuf==NULL)
{
printf("Failed to allocate tmpbuf for receiving data.\n");
if(con_type)
{
udsDestroyNetwork();
}
else
{
udsDisconnectNetwork();
}
udsUnbind(&bindctx);
return;
}
while(1)
{
gspWaitForVBlank();
hidScanInput();
u32 kDown = hidKeysDown();
if(kDown & KEY_A)break;
prev_transfer_data = transfer_data;
transfer_data = hidKeysHeld();
//When the output from hidKeysHeld() changes, send it over the network.
if(transfer_data != prev_transfer_data && conntype!=UDSCONTYPE_Spectator)//Spectators aren't allowed to send data.
{
ret = udsSendTo(UDS_BROADCAST_NETWORKNODEID, data_channel, UDS_SENDFLAG_Default, &transfer_data, sizeof(transfer_data));
if(UDS_CHECK_SENDTO_FATALERROR(ret))
{
printf("udsSendTo() returned 0x%08x.\n", (unsigned int)ret);
break;
}
}
//if(udsWaitDataAvailable(&bindctx, false, false))//Check whether data is available via udsPullPacket().
{
memset(tmpbuf, 0, tmpbuf_size);
actual_size = 0;
src_NetworkNodeID = 0;
ret = udsPullPacket(&bindctx, tmpbuf, tmpbuf_size, &actual_size, &src_NetworkNodeID);
if(R_FAILED(ret))
{
printf("udsPullPacket() returned 0x%08x.\n", (unsigned int)ret);
break;
}
if(actual_size)//If no data frame is available, udsPullPacket() will return actual_size=0.
{
printf("Received 0x%08x size=0x%08x from node 0x%x.\n", (unsigned int)tmpbuf[0], actual_size, (unsigned int)src_NetworkNodeID);
}
}
if(kDown & KEY_Y)
{
ret = udsGetNodeInformation(0x2, &tmpnode);//This can be used to get the NodeInfo for a node which just connected, for example.
if(R_FAILED(ret))
{
printf("udsGetNodeInformation() returned 0x%08x.\n", (unsigned int)ret);
}
else
{
memset(tmpstr, 0, sizeof(tmpstr));
ret = udsGetNodeInfoUsername(&tmpnode, tmpstr);
if(R_FAILED(ret))
{
printf("udsGetNodeInfoUsername() returned 0x%08x for udsGetNodeInfoUsername.\n", (unsigned int)ret);
}
else
{
printf("node username: %s\n", tmpstr);
printf("node unk_x1c=0x%x\n", (unsigned int)tmpnode.unk_x1c);
printf("node flag=0x%x\n", (unsigned int)tmpnode.flag);
printf("node pad_x1f=0x%x\n", (unsigned int)tmpnode.pad_x1f);
printf("node NetworkNodeID=0x%x\n", (unsigned int)tmpnode.NetworkNodeID);
printf("node word_x24=0x%x\n", (unsigned int)tmpnode.word_x24);
}
}
}
if(kDown & KEY_X)//Block new regular clients from connecting.
{
ret = udsSetNewConnectionsBlocked(true, true, false);
printf("udsSetNewConnectionsBlocked() for enabling blocking returned 0x%08x.\n", (unsigned int)ret);
}
if(kDown & KEY_B)//Unblock new regular clients from connecting.
{
ret = udsSetNewConnectionsBlocked(false, true, false);
printf("udsSetNewConnectionsBlocked() for disabling blocking returned 0x%08x.\n", (unsigned int)ret);
}
if(kDown & KEY_R)
{
ret = udsEjectSpectator();
printf("udsEjectSpectator() returned 0x%08x.\n", (unsigned int)ret);
}
if(kDown & KEY_L)
{
ret = udsAllowSpectators();
printf("udsAllowSpectators() returned 0x%08x.\n", (unsigned int)ret);
}
if(udsWaitConnectionStatusEvent(false, false))
{
printf("Constatus event signaled.\n");
print_constatus();
}
}
free(tmpbuf);
tmpbuf = NULL;
if(con_type)
{
udsDestroyNetwork();
}
else
{
udsDisconnectNetwork();
}
udsUnbind(&bindctx);
}
int main()
{
Result ret=0;
gfxInitDefault();
consoleInit(GFX_TOP, NULL);
printf("libctru UDS local-WLAN demo.\n");
ret = udsInit(0x3000, NULL);//The sharedmem size only needs to be slightly larger than the total recv_buffer_size for all binds, with page-alignment.
if(R_FAILED(ret))
{
printf("udsInit failed: 0x%08x.\n", (unsigned int)ret);
}
else
{
uds_test();
udsExit();
}
printf("Press START to exit.\n");
// Main loop
while (aptMainLoop())
{
gspWaitForVBlank();
hidScanInput();
u32 kDown = hidKeysDown();
if (kDown & KEY_START)
break; // break in order to return to hbmenu
// Flush and swap framebuffers
gfxFlushBuffers();
gfxSwapBuffers();
}
gfxExit();
return 0;
}
3ds.h
Central 3DS header.
aptMainLoop
bool aptMainLoop(void)
Main function which handles sleep mode and HOME/power buttons - call this at the beginning of every f...
consoleInit
PrintConsole * consoleInit(gfxScreen_t screen, PrintConsole *console)
Initialise the console.
gfxSwapBuffers
void gfxSwapBuffers(void)
Updates the configuration of both screens.
gfxInitDefault
void gfxInitDefault(void)
Initializes the LCD framebuffers with default parameters This is equivalent to calling:
GFX_TOP
@ GFX_TOP
Top screen.
Definition: gfx.h:26
gfxExit
void gfxExit(void)
Deinitializes and frees the LCD framebuffers.
gfxFlushBuffers
void gfxFlushBuffers(void)
Flushes the data cache for the current framebuffers.
gspWaitForVBlank
#define gspWaitForVBlank()
Waits for VBlank.
Definition: gspgpu.h:151
KEY_B
@ KEY_B
B.
Definition: hid.h:13
KEY_X
@ KEY_X
X.
Definition: hid.h:22
KEY_Y
@ KEY_Y
Y.
Definition: hid.h:23
KEY_START
@ KEY_START
Start.
Definition: hid.h:15
KEY_R
@ KEY_R
R.
Definition: hid.h:20
KEY_A
@ KEY_A
A.
Definition: hid.h:12
KEY_L
@ KEY_L
L.
Definition: hid.h:21
hidKeysHeld
u32 hidKeysHeld(void)
Returns a bitmask of held buttons.
hidKeysDown
u32 hidKeysDown(void)
Returns a bitmask of newly pressed buttons, this frame.
hidScanInput
void hidScanInput(void)
Scans HID for input data.
R_FAILED
#define R_FAILED(res)
Checks whether a result code indicates failure.
Definition: result.h:11
udsBindContext
Definition: uds.h:91
udsConnectionStatus
Connection status struct.
Definition: uds.h:48
udsNetworkScanInfo
Output structure generated from host scanning output.
Definition: uds.h:134
udsNetworkStruct
Network struct stored as big-endian.
Definition: uds.h:61
udsNodeInfo
Node info struct.
Definition: uds.h:26
u8
uint8_t u8
would be nice if newlib had this already
Definition: types.h:21
Result
s32 Result
Function result.
Definition: types.h:42
u16
uint16_t u16
16-bit unsigned integer
Definition: types.h:22
u32
uint32_t u32
32-bit unsigned integer
Definition: types.h:23
udsUnbind
Result udsUnbind(udsBindContext *bindcontext)
Remove a bind.
UDS_BROADCAST_NETWORKNODEID
#define UDS_BROADCAST_NETWORKNODEID
Broadcast value for NetworkNodeID / alias for all NetworkNodeIDs.
Definition: uds.h:11
udsExit
void udsExit(void)
Exits UDS.
udsPullPacket
Result udsPullPacket(const udsBindContext *bindcontext, void *buf, size_t size, size_t *actual_size, u16 *src_NetworkNodeID)
Receives data over the network.
udsCreateNetwork
Result udsCreateNetwork(const udsNetworkStruct *network, const void *passphrase, size_t passphrase_size, udsBindContext *context, u8 data_channel, u32 recv_buffer_size)
Starts hosting a new network.
udsSendTo
Result udsSendTo(u16 dst_NetworkNodeID, u8 data_channel, u8 flags, const void *buf, size_t size)
Sends data over the network.
udsScanBeacons
Result udsScanBeacons(void *outbuf, size_t maxsize, udsNetworkScanInfo **networks, size_t *total_networks, u32 wlancommID, u8 id8, const u8 *host_macaddress, bool connected)
Scans for networks via beacon-scanning.
udsDisconnectNetwork
Result udsDisconnectNetwork(void)
Disconnect this client device from the network.
udsWaitConnectionStatusEvent
bool udsWaitConnectionStatusEvent(bool nextEvent, bool wait)
Waits for the ConnectionStatus event to occur, or checks if the event was signaled.
udsDestroyNetwork
Result udsDestroyNetwork(void)
Stop hosting the network.
udsSetNewConnectionsBlocked
Result udsSetNewConnectionsBlocked(bool block, bool clients, bool flag)
This uses udsUpdateNetworkAttribute() for (un)blocking new connections to this host.
udsEjectSpectator
Result udsEjectSpectator(void)
This can be used by the host to force-disconnect the spectators.
udsConnectNetwork
Result udsConnectNetwork(const udsNetworkStruct *network, const void *passphrase, size_t passphrase_size, udsBindContext *context, u16 recv_NetworkNodeID, udsConnectionType connection_type, u8 data_channel, u32 recv_buffer_size)
Connect to a network.
udsGetChannel
Result udsGetChannel(u8 *channel)
Gets the wifi channel currently being used.
udsSetApplicationData
Result udsSetApplicationData(const void *buf, size_t size)
This can be used by the host to set the appdata contained in the broadcasted beacons.
udsAllowSpectators
Result udsAllowSpectators(void)
This uses udsUpdateNetworkAttribute() for unblocking new spectator connections to this host.
udsInit
Result udsInit(size_t sharedmem_size, const char *username)
Initializes UDS.
udsGetConnectionStatus
Result udsGetConnectionStatus(udsConnectionStatus *output)
This loads the current ConnectionStatus struct.
udsCheckNodeInfoInitialized
bool udsCheckNodeInfoInitialized(const udsNodeInfo *nodeinfo)
Checks whether a NodeInfo struct was initialized by NWM-module(not any output from udsGenerateNodeInf...
UDS_DATAFRAME_MAXSIZE
#define UDS_DATAFRAME_MAXSIZE
Max size of user data-frames.
Definition: uds.h:20
UDS_CHECK_SENDTO_FATALERROR
#define UDS_CHECK_SENDTO_FATALERROR(x)
Check whether a fatal udsSendTo error occured(some error(s) from udsSendTo() can be ignored,...
Definition: uds.h:23
udsGetNodeInformation
Result udsGetNodeInformation(u16 NetworkNodeID, udsNodeInfo *output)
This loads a NodeInfo struct for the specified NetworkNodeID.
udsGetApplicationData
Result udsGetApplicationData(void *buf, size_t size, size_t *actual_size)
This can be used while on a network(host/client) to get the appdata from the current beacon.
udsGetNodeInfoUsername
Result udsGetNodeInfoUsername(const udsNodeInfo *nodeinfo, char *username)
Loads the UTF-16 username stored in the input NodeInfo struct, converted to UTF-8.
UDS_DEFAULT_RECVBUFSIZE
#define UDS_DEFAULT_RECVBUFSIZE
Default recv_buffer_size that can be used for udsBind() input / code which uses udsBind() internally.
Definition: uds.h:17
udsGetNetworkStructApplicationData
Result udsGetNetworkStructApplicationData(const udsNetworkStruct *network, void *buf, size_t size, size_t *actual_size)
This can be used with a NetworkStruct, from udsScanBeacons() mainly, for getting the appdata.
udsGenerateDefaultNetworkStruct
void udsGenerateDefaultNetworkStruct(udsNetworkStruct *network, u32 wlancommID, u8 id8, u8 max_nodes)
Generates a default NetworkStruct for creating networks.
UDS_MAXNODES
#define UDS_MAXNODES
Maximum number of nodes(devices) that can be connected to the network.
Definition: uds.h:8