User Manual

150 • Appendix
Mailbox Command References
WAGO-I/O-SYSTEM 750
I/O Modules
6.3.5.25 Read Device Name of a Remote Bluetooth
®
Device
(GetRemoteDeviceName, 0x82)
With call up, the name of a disconnected I/O module in the wireless network
is queried (compare Appendix 6.3.5.24, GetRemoteDeviceMacID). Since this
information must be requested via remote device and no quick response can be
guaranteed, the first request starts with the name resolution. However, it re-
sponds with MBX_CMD_DENIED_BUSY without returning the name. Re-
peating the request delivers both MBX_CMD_OK and the character string of
the requested device name as soon as the name has been determined. The call
up returns an error if "ScanRemoteDevices" has not been called previously
and the search (first call up) has not been completed successfully. As long as
the name call up runs, the wireless module is not available for any other func-
tions. Functions that do not use the wireless module are performed normally.
If the name query has been completed, a new call up from "GetRemoteDe-
viceName" delivers the Bluetooth
®
name of the remote device (compare Ap-
pendix 6.3.5.1, "GetLocalDeviceName"). A maximum of (mailbox size - 3)
characters are displayed.
The Bluetooth
®
name of remote devices may also exceed the length (15 char-
acters) that can be displayed in the largest mailbox setting (18 bytes). In this
case, the complete name can be read by block transfer, however.
Note
Before calling up "GetRemoteDeviceName", the command "ScanRemoteDe-
vices" (see Appendix 6.3.5.23) must be executed.
Conditions
Mailbox size Operating mode/profile Device role
6 12 18 Config.
Real-
time
Ad hoc Master Slave
Save
config.
Restart
(●) (●) (●) ● - - ● ● - -
Request
Byte 2
7
2
6
2
5
2
4
2
3
2
2
2
1
2
0
0 MBX_GETREMOTEDEVICENAME
1 T -
2 MBX_DEVICE_INDEX