We PROTEUS-III User manual

USER MANUAL
PROTEUS-III
2611011024000
VERSION 1.8
JULY 1, 2022

***************
MUST READ
Check for firmware updates
Before using the product make sure you use the most recent firmware version, data sheet
and user manual. This is especially important for Wireless Connectivity products that were
not purchased directly from Würth Elektronik eiSos. A firmware update on these respective
products may be required.
We strongly recommend to include in the customer system design, the possibility for a firmware
update of the product.

WIRELESS CONNECTIVITY & SENSORS
User manual Proteus-III
Revision history
Manual
version
FW
version
HW
version Notes Date
1.0 1.1.0 1.2 • Initial release February
2020
1.1 1.1.0 1.2
• Limitation of the RF_DeviceName to a
maximum of 31 bytes
• Added Annex Additional CRC8
Information and Example codes for
host integration
June 2020
1.2 1.1.0 1.2 • corrected capacitor number. C28
changed to C26 in section Trace
design
July 2020
1.3 1.1.0 1.2
• Updated section Trace design .
• Included figure On-board PCB antenna
and External antenna connection .
August 2020
1.4 1.1.0 1.2
• Updated Declaration of EU conformity
to latest Version of EN 300 328 after
successfully passing corresponding
delta test in chapter Regulatory
compliance information .
• Added package name in
chapter Footprint WE-FP-4+ .
October
2020
1.5 1.1.0 1.2 • Updated Declaration of EU conformity
in chapter Regulatory compliance
information .
December
2020
Order code 2611011024000 1
Version 1.8 , July 2022 www.we-online.com/wcs

WIRELESS CONNECTIVITY & SENSORS
User manual Proteus-III
1.6 1.1.0 1.2 • Schematic is updated in
chapter EV-Board .
February
2021
1.7 1.3.0 1.2 • New features of firmware version 1.3.0.
Please refer to chapter Firmware
history .
July 2021
1.8 1.4.0 1.2
• New features of firmware version 1.4.0.
Please refer to chapter Firmware
history .
• Added overview of helpful application
notes
• Updated document style
July 2022
?For firmware history see chapter Firmware history
Order code 2611011024000 2
Version 1.8 , July 2022 www.we-online.com/wcs

WIRELESS CONNECTIVITY & SENSORS
User manual Proteus-III
Abbreviations
Abbreviation Name Description
BTMAC Bluetooth®conform MAC address of the module used
on the RF-interface.
CS Checksum Byte wise XOR combination of the preceding fields.
DSSS Direct sequence
spread spectrum Technique to spread a message on the radio
DTM Direct test mode Mode to test Bluetooth®specific RF settings.
EV (Board) Evaluation (Board) Proteus-III populated on motherboard with USB
interface for test and evaluation purpose.
FEC Forward error
correction
Technique to correct received erroneous radio
messages
GAP Generic Access
Profile
The GAP provides a basic level of functionality that all
Bluetooth®devices must implement.
I/O Input/output Pinout description.
LESC Low energy
secure connection
Elliptic curve encryption method for Bluetooth®LE
encryption and authentication
LPM Low power mode Mode for efficient power consumption.
LRM Long range mode Radio mode with higher range and lower throughput.
MAC MAC address of the module.
MTU Maximum
transmission unit Maximum packet size of the Bluetooth®connection.
Payload The intended message in a frame / package.
RF Radio frequency Describes wireless transmission.
RSSI Receive Signal
Strength Indicator
The RSSI indicates the strength of the RF signal. Its
value is always printed in two’s complement notation.
Soft device Operating system used by the nRF52 chip.
SPI Serial Peripheral
Interface Allows the serial communication with the module.
UART
Universal
Asynchronous
Receiver
Transmitter
Allows the serial communication with the module.
User settings
Settings to configure the module. Any relation to a
specific entry in the user settings is marked in a
special font and can be found in chapter 8 .
[HEX] 0xhh Hexadecimal
All numbers beginning with 0x are hexadecimal
numbers. All other numbers are decimal, unless
stated otherwise.
Order code 2611011024000 3
Version 1.8 , July 2022 www.we-online.com/wcs

WIRELESS CONNECTIVITY & SENSORS
User manual Proteus-III
Contents
Overview of helpful application notes 12
1. Introduction 14
1.1. Operational description . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 14
1.1.1. Keyfeatures................................. 15
1.1.2. Connectivity................................. 16
1.2. Blockdiagram..................................... 17
1.3. Orderinginformation................................. 17
2. Electrical specifications 18
2.1. Recommended operating conditions . . . . . . . . . . . . . . . . . . . . . . . . 18
2.2. Absolute maximum ratings . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 18
2.3. Powerconsumption.................................. 19
2.3.1. Static..................................... 19
2.3.2. Dynamic................................... 20
2.4. Radiocharacteristics................................. 22
2.5. Pincharacteristics .................................. 23
3. Pinout 24
4. Quick start 27
4.1. Minimal pin connections . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 27
4.2. Antennaconnection ................................. 29
4.2.1. On-board PCB antenna . . . . . . . . . . . . . . . . . . . . . . . . . . . 29
4.2.2. Externalantenna .............................. 29
4.3. Powerup ....................................... 30
4.4. Quickstartexample.................................. 31
5. Functional description 34
5.1. Operationmodes................................... 34
5.2. Radiomodulestates................................. 34
5.3. State indication using the LED pins . . . . . . . . . . . . . . . . . . . . . . . . . 36
5.4. Sleepmode...................................... 36
5.5. Identification of a Proteus-III device on the radio . . . . . . . . . . . . . . . . . . 37
5.6. Connection based data transmission, with or without security . . . . . . . . . . 37
5.6.1. Further information for a secure connection setup . . . . . . . . . . . . 38
5.6.1.1. Justworksmode ............................ 38
5.6.1.2. StaticPasskey mode . . . . . . . . . . . . . . . . . . . . . . . . . . 41
5.6.1.3. LescPasskey mode . . . . . . . . . . . . . . . . . . . . . . . . . . . 44
5.6.1.4. LescNumComp mode . . . . . . . . . . . . . . . . . . . . . . . . . 47
5.6.1.5. Bonding................................. 50
5.7. Unidirectional connectionless data transmission using Beacons . . . . . . . . . 54
5.8. Energy-efficient distance estimation solutions . . . . . . . . . . . . . . . . . . . 55
5.9. Configure the module for low power consumption . . . . . . . . . . . . . . . . . 55
5.10. Start the direct test mode (DTM) . . . . . . . . . . . . . . . . . . . . . . . . . . 56
5.11. Using the 2 MBit and LE Coded phy . . . . . . . . . . . . . . . . . . . . . . . . 58
5.12. Connection setup using LE Coded phy . . . . . . . . . . . . . . . . . . . . . . . 58
Order code 2611011024000 4
Version 1.8 , July 2022 www.we-online.com/wcs

WIRELESS CONNECTIVITY & SENSORS
User manual Proteus-III
6. Host connection 62
6.1. Serialinterface:UART................................ 62
6.1.1. Resetbehaviour............................... 62
7. The command interface 63
7.1. Scan for other modules in range . . . . . . . . . . . . . . . . . . . . . . . . . . 65
7.1.1. CMD_SCANSTART_REQ . . . . . . . . . . . . . . . . . . . . . . . . . 65
7.1.2. CMD_SCANSTOP_REQ . . . . . . . . . . . . . . . . . . . . . . . . . . 65
7.1.3. CMD_GETDEVICES_REQ . . . . . . . . . . . . . . . . . . . . . . . . . 66
7.1.3.1. Example1................................ 67
7.1.4. CMD_RSSI_IND .............................. 67
7.1.5. CMD_BEACON_RSP............................ 68
7.2. Setupconnections .................................. 69
7.2.1. CMD_CONNECT_REQ . . . . . . . . . . . . . . . . . . . . . . . . . . 69
7.2.2. CMD_CONNECT_IND . . . . . . . . . . . . . . . . . . . . . . . . . . . 69
7.2.3. CMD_SECURITY_IND . . . . . . . . . . . . . . . . . . . . . . . . . . . 70
7.2.4. CMD_CHANNELOPEN_RSP . . . . . . . . . . . . . . . . . . . . . . . 70
7.2.5. CMD_DISCONNECT_REQ . . . . . . . . . . . . . . . . . . . . . . . . 70
7.2.6. CMD_DISCONNECT_IND . . . . . . . . . . . . . . . . . . . . . . . . . 71
7.2.7. CMD_PHYUPDATE_REQ . . . . . . . . . . . . . . . . . . . . . . . . . 71
7.2.8. CMD_PHYUPDATE_IND . . . . . . . . . . . . . . . . . . . . . . . . . . 72
7.2.9. CMD_PASSKEY_REQ . . . . . . . . . . . . . . . . . . . . . . . . . . . 72
7.2.10. CMD_PASSKEY_IND . . . . . . . . . . . . . . . . . . . . . . . . . . . . 73
7.2.11. CMD_DISPLAY_PASSKEY_IND . . . . . . . . . . . . . . . . . . . . . . 73
7.2.12. CMD_NUMERIC_COMP_REQ . . . . . . . . . . . . . . . . . . . . . . 74
7.2.13. CMD_GETBONDS_REQ . . . . . . . . . . . . . . . . . . . . . . . . . . 74
7.2.13.1. Example1................................ 75
7.2.14. CMD_DELETEBONDS_REQ . . . . . . . . . . . . . . . . . . . . . . . 75
7.2.14.1. Example1................................ 76
7.2.14.2. Example2................................ 76
7.2.15. CMD_ALLOWUNBONDEDCONNECTIONS_REQ . . . . . . . . . . . . 77
7.3. Transmit and receive data . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 78
7.3.1. CMD_DATA_REQ.............................. 78
7.3.2. CMD_TXCOMPLETE_RSP . . . . . . . . . . . . . . . . . . . . . . . . 78
7.3.3. CMD_DATA_IND .............................. 79
7.3.4. CMD_SETBEACON_REQ . . . . . . . . . . . . . . . . . . . . . . . . . 79
7.3.5. CMD_BEACON_IND ............................ 79
7.4. Configuring the module and modifying the device settings . . . . . . . . . . . . 81
7.4.1. CMD_SET_REQ .............................. 81
7.4.1.1. Example1................................ 82
7.4.1.2. Example2................................ 82
7.4.2. CMD_GET_REQ .............................. 83
7.4.2.1. Example1................................ 83
7.5. Managethedevicestate............................... 84
7.5.1. CMD_GETSTATE_REQ . . . . . . . . . . . . . . . . . . . . . . . . . . 84
7.5.1.1. Example1................................ 85
7.5.2. CMD_RESET_REQ............................. 85
7.5.3. CMD_SLEEP_REQ............................. 85
Order code 2611011024000 5
Version 1.8 , July 2022 www.we-online.com/wcs

WIRELESS CONNECTIVITY & SENSORS
User manual Proteus-III
7.5.4. CMD_SLEEP_IND ............................. 86
7.5.5. CMD_FACTORYRESET_REQ . . . . . . . . . . . . . . . . . . . . . . . 86
7.5.6. CMD_UARTDISABLE_REQ . . . . . . . . . . . . . . . . . . . . . . . . 87
7.5.7. CMD_UARTENABLE_IND . . . . . . . . . . . . . . . . . . . . . . . . . 88
7.5.8. CMD_BOOTLOADER_REQ . . . . . . . . . . . . . . . . . . . . . . . . 88
7.6. Run the Bluetooth test modes . . . . . . . . . . . . . . . . . . . . . . . . . . . . 90
7.6.1. CMD_DTMSTART_REQ . . . . . . . . . . . . . . . . . . . . . . . . . . 90
7.6.2. CMD_DTM_REQ .............................. 90
7.6.2.1. Example: Transmission, 16 times 0x0F, channel 0 . . . . . . . . . 92
7.6.2.2. Example: Receiver, channel 0 . . . . . . . . . . . . . . . . . . . . . 93
7.6.2.3. Example: Transmission, carrier test, channel 0 . . . . . . . . . . . 93
7.6.2.4. Example: Set TX power to -4 dBm . . . . . . . . . . . . . . . . . . 94
7.6.2.5. Example: Set PHY to 2 MBit mode . . . . . . . . . . . . . . . . . . 94
7.7. Switching GPIOs by remote control . . . . . . . . . . . . . . . . . . . . . . . . . 95
7.7.1. CMD_GPIO_LOCAL_WRITECONFIG_REQ . . . . . . . . . . . . . . . 95
7.7.1.1. Example: Configure two GPIOs to output high . . . . . . . . . . . . 96
7.7.2. CMD_GPIO_LOCAL_READCONFIG_REQ . . . . . . . . . . . . . . . 98
7.7.2.1. Example: Read the current GPIO configuration . . . . . . . . . . . 99
7.7.3. CMD_GPIO_REMOTE_WRITECONFIG_REQ . . . . . . . . . . . . . . 100
7.7.3.1. Example: Configure two GPIOs of the connected remote device
tooutputhigh..............................101
7.7.4. CMD_GPIO_REMOTE_READCONFIG_REQ . . . . . . . . . . . . . . 103
7.7.4.1. Example: Read the current GPIO configuration of the connected
remotedevice..............................104
7.7.5. CMD_GPIO_REMOTE_WRITE_REQ . . . . . . . . . . . . . . . . . . . 105
7.7.5.1. Example: Set a remote output GPIO to low . . . . . . . . . . . . . 106
7.7.6. CMD_GPIO_REMOTE_READ_REQ . . . . . . . . . . . . . . . . . . . 107
7.7.6.1. Example: Read the values of remote GPIOs . . . . . . . . . . . . . 108
7.7.7. CMD_GPIO_LOCAL_WRITE_REQ . . . . . . . . . . . . . . . . . . . . 109
7.7.7.1. Example: Set a local output GPIO to low . . . . . . . . . . . . . . . 110
7.7.8. CMD_GPIO_LOCAL_READ_REQ . . . . . . . . . . . . . . . . . . . . 111
7.7.8.1. Example: Read the values of local GPIOs . . . . . . . . . . . . . . 112
7.7.9. CMD_GPIO_REMOTE_WRITECONFIG_IND . . . . . . . . . . . . . . 113
7.7.9.1. Example: Two GPIOs have been configured by the connected re-
mote device to output high . . . . . . . . . . . . . . . . . . . . . . . 113
7.7.10. CMD_GPIO_REMOTE_WRITE_IND . . . . . . . . . . . . . . . . . . . 114
7.7.10.1. Example: GPIOs have been written via remote access . . . . . . . 114
7.7.11. CMD_GPIO_LOCAL_WRITE_IND . . . . . . . . . . . . . . . . . . . . 115
7.7.11.1. Example: GPIOs of the remote device have been written by its
localhost ................................115
7.8. Othermessages ...................................116
7.8.1. CMD_ERROR_IND.............................116
7.9. Messageoverview ..................................117
8. UserSettings - Module configuration values 121
8.1. FS_DeviceInfo: Read the chip type and OS version . . . . . . . . . . . . . . . . 121
8.1.1. Example1..................................122
Order code 2611011024000 6
Version 1.8 , July 2022 www.we-online.com/wcs

WIRELESS CONNECTIVITY & SENSORS
User manual Proteus-III
8.2. FS_FWVersion: Read the firmware version . . . . . . . . . . . . . . . . . . . . 123
8.2.1. Example1..................................123
8.3. FS_MAC: Read the MAC address . . . . . . . . . . . . . . . . . . . . . . . . . . 124
8.3.1. Example1..................................124
8.4. FS_BTMAC: Read the Bluetooth conform MAC address . . . . . . . . . . . . . 125
8.4.1. Example1..................................125
8.5. FS_SerialNumber: Read the serial number of the module . . . . . . . . . . . . 126
8.5.1. Example1..................................126
8.6. RF_DeviceName: Modify the device name . . . . . . . . . . . . . . . . . . . . . 127
8.6.1. Example1..................................127
8.6.2. Example2..................................127
8.7. RF_StaticPasskey: Modify the static passkey . . . . . . . . . . . . . . . . . . . 129
8.7.1. Example1..................................129
8.7.2. Example2..................................129
8.8. RF_SecFlags: Modify the security settings . . . . . . . . . . . . . . . . . . . . . 130
8.8.1. Example1..................................132
8.8.2. Example2..................................132
8.9. RF_SecFlagsPerOnly: Modify the security settings (Peripheral only mode) . . . 133
8.9.1. Example1..................................133
8.9.2. Example2..................................133
8.10. RF_ScanFlags: Modify the scan behavior . . . . . . . . . . . . . . . . . . . . . 134
8.10.1.Example1..................................134
8.10.2.Example2..................................134
8.11. RF_BeaconFlags: Interpret the advertising data . . . . . . . . . . . . . . . . . . 136
8.11.1.Example1..................................136
8.11.2.Example2..................................137
8.12. RF_AdvertisingTimeout: Modify the advertising timeout . . . . . . . . . . . . . 138
8.12.1.Example1..................................138
8.12.2.Example2..................................138
8.13. RF_AdvertisingFlags: Configure the advertising packet . . . . . . . . . . . . . . 139
8.13.1.Example1..................................139
8.13.2.Example2..................................140
8.14. RF_ScanFactor: Modify the scan factor . . . . . . . . . . . . . . . . . . . . . . 141
8.14.1.Example1..................................141
8.14.2.Example2..................................141
8.15. RF_ScanTiming: Modify the scan timing . . . . . . . . . . . . . . . . . . . . . . 142
8.15.1.Example1..................................143
8.15.2.Example2..................................143
8.16. RF_ConnectionTiming: Modify the connection timing . . . . . . . . . . . . . . . 144
8.16.1.Example1..................................145
8.16.2.Example2..................................145
8.17. RF_TXPower: Modify the output power . . . . . . . . . . . . . . . . . . . . . . . 147
8.17.1.Example1..................................147
8.17.2.Example2..................................147
8.18. RF_SPPBaseUUID: Configure the SPP base UUID . . . . . . . . . . . . . . . . 149
8.18.1.Example1..................................149
8.18.2.Example2..................................149
Order code 2611011024000 7
Version 1.8 , July 2022 www.we-online.com/wcs

WIRELESS CONNECTIVITY & SENSORS
User manual Proteus-III
8.19. RF_SPPServiceUUID: Configure the SPP service UUID . . . . . . . . . . . . . 150
8.19.1.Example1..................................150
8.19.2.Example2..................................150
8.20. RF_SPPRXUUID: Configure the SPP RX UUID . . . . . . . . . . . . . . . . . . 151
8.20.1.Example1..................................151
8.20.2.Example2..................................151
8.21. RF_SPPTXUUID: Configure the SPP TX UUID . . . . . . . . . . . . . . . . . . 152
8.21.1.Example1..................................152
8.21.2.Example2..................................152
8.22. RF_Appearance: Configure the appearance of the device . . . . . . . . . . . . 153
8.22.1.Example1..................................153
8.22.2.Example2..................................153
8.23. UART_ConfigIndex: Modify the UART speed . . . . . . . . . . . . . . . . . . . 154
8.23.1.Example1..................................156
8.23.2.Example2..................................156
8.24. CFG_Flags: Configure the module . . . . . . . . . . . . . . . . . . . . . . . . . 157
8.24.1.Example1..................................157
8.24.2.Example2..................................157
8.25. DIS_ManufacturerName: Configure the manufacturer name . . . . . . . . . . . 159
8.25.1.Example1..................................159
8.25.2.Example2..................................159
8.26. DIS_ModelNumber: Configure the model number . . . . . . . . . . . . . . . . . 161
8.26.1.Example1..................................161
8.26.2.Example2..................................161
8.27. DIS_SerialNumber: Configure the serial number . . . . . . . . . . . . . . . . . 163
8.27.1.Example1..................................163
8.27.2.Example2..................................163
8.28. DIS_HWVersion: Configure the HW version . . . . . . . . . . . . . . . . . . . . 165
8.28.1.Example1..................................165
8.28.2.Example2..................................165
8.29. DIS_SWVersion: Configure the SW version . . . . . . . . . . . . . . . . . . . . 167
8.29.1.Example1..................................167
8.29.2.Example2..................................167
8.30. DIS_Flags: Configure the device information service . . . . . . . . . . . . . . . 169
8.30.1.Example1..................................169
8.30.2.Example2..................................169
9. Timing parameters 173
9.1. Resetandsleep ...................................173
9.2. Bluetooth LE timing parameters . . . . . . . . . . . . . . . . . . . . . . . . . . . 173
9.3. Connection establishment . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 173
9.4. Connection based data transmission . . . . . . . . . . . . . . . . . . . . . . . . 174
9.4.1. Maximum data throughput . . . . . . . . . . . . . . . . . . . . . . . . . 175
10.Peripheral only mode 177
10.1. Reasons to use the peripheral only mode . . . . . . . . . . . . . . . . . . . . . 177
10.2. Restrictions......................................177
10.3. How to use the peripheral only mode . . . . . . . . . . . . . . . . . . . . . . . . 178
Order code 2611011024000 8
Version 1.8 , July 2022 www.we-online.com/wcs