NWMUDS:Bind: Difference between revisions

From 3dbrew
Jump to navigation Jump to search
 
(10 intermediate revisions by the same user not shown)
Line 9: Line 9:
|-
|-
| 1
| 1
| NodeID
| BindNodeID
|-
|-
| 2
| 2
| u32, unknown.
| u32 recv_buffer_size. Official user-processes require this to be >=0x646. This is the ''exact'' size of the buffer allocated under sharedmem used for storing the received data which can then be loaded via [[NWMUDS:PullPacket]](this includes header data). NWM-module itself ''only'' requires this size to be >=0x5F4(this is only checked after allocating the buffer).
|-
|-
| 3
| 3
| u8, unknown.
| u8 data_channel
|-
|-
| 4
| 4
| u16, unknown.
| u16 NetworkNodeID probably. Likely for controlling which device this BindNodeID can communicate with, or all of them when the broadcast alias is used.
|}
|}


Line 37: Line 37:
|-
|-
| 3
| 3
| Output handle.
| Output event handle. This is signaled every time data becomes available via [[NWMUDS:PullPacket]].
|}
|}
=Data Channel=
This is an arbitrary value to use for data-frame filtering. This bind will only receive data frames which contain a matching data_channel value. The input data_channel value for this command must be non-zero, otherwise error 0xE10113EA is returned.


=Description=
=Description=
This initializes the NodeID for use on this device, etc. It's unknown how this NodeID is determined.
This initializes a [[NWM_Services|BindNodeID]] for use on this device, etc. This can be done multiple times for initializing different BindNodeIDs.

Latest revision as of 17:56, 14 April 2016

Request

Index Word Description
0 Header code [0x00120100]
1 BindNodeID
2 u32 recv_buffer_size. Official user-processes require this to be >=0x646. This is the exact size of the buffer allocated under sharedmem used for storing the received data which can then be loaded via NWMUDS:PullPacket(this includes header data). NWM-module itself only requires this size to be >=0x5F4(this is only checked after allocating the buffer).
3 u8 data_channel
4 u16 NetworkNodeID probably. Likely for controlling which device this BindNodeID can communicate with, or all of them when the broadcast alias is used.

Response

Index Word Description
0 Header code
1 Result code
2 Value 0x0, handle transfer translate-header.
3 Output event handle. This is signaled every time data becomes available via NWMUDS:PullPacket.

Data Channel

This is an arbitrary value to use for data-frame filtering. This bind will only receive data frames which contain a matching data_channel value. The input data_channel value for this command must be non-zero, otherwise error 0xE10113EA is returned.

Description

This initializes a BindNodeID for use on this device, etc. This can be done multiple times for initializing different BindNodeIDs.