U SER MANUALC ALYPSO F EATHERW ING
2610039025001

V ERSION 1.2
J UNE 12, 2023

***************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 Calypso FeatherWing

Revision history
Manualversion

HW
version

Notes

Date

1.0

1.1

Initial version

November 2020

1.1

1.2

• Change of antenna connection chapter 3.4

February 2023

• Change of chapter 3.2.
1.2

1.2

New corporate design

Order code 2610039025001
Version 1.2, June 2023

June 2023

1

www.we-online.com/wcs

WIRELESS CONNECTIVITY & SENSORS
User manual Calypso FeatherWing

Abbreviations
Abbreviation

Name

Description

CISPR

Comité International Spécial desPerturbations Radioélectriques

International Special
Committee on RadioEV

Evaluation

ESD

Electro Static Discharge

FOTA

Firmware over the update

EMC

Electro Magnetic Compatibility

GND

GroundHIGHHigh signal level

IDE

Integrated development environment

IEC

International Electrotechnical Commission

IEEE

Institute for electrical and electronicengineers

JTAG

Joint Test Action Group

LED

Light Emitting Diode

Li-Po

Lithium-Polymer

LOW

Low signal level

PC

Personal Computer

PCB

Printed Circuit Board

VCC
VDD

Supply voltage
Voltage Drain Drain

Order code 2610039025001
Version 1.2, June 2023

Supply voltage

2

www.we-online.com/wcs

WIRELESS CONNECTIVITY & SENSORS
User manual Calypso FeatherWing

Contents
1 General description
1.1
Introduction . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . .
1.2
Block diagram . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . .
1.3
Contents . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . .

5
5
6
6

2 Functional description
2.1
Adafruit Feather . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . .
2.2
Calypso Wi-Fi module (2610011025000) . . . . . . . . . . . . . . . . . . . . . .

77
7

3 Hardware description
3.1
Connectors . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . .
3.1.1 Feather connector . . . . . . . . . . . . . . . . . . . . . . . . . . . . . .
3.2
Jumpers . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . .
3.2.1 JP2 . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . .
3.2.2 JP3 . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . .
3.3
Push buttons . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . .
3.3.1 S1 . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . .
3.3.2 S2 . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . .
3.4
Schematics . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . .
3.5
Layout . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . .

9
9
9
10
10
11
11
11
12
13
14

4 Software description
4.1
Software architecture . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . .
4.2
Installing the tools . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . .
4.2.1 IDE . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . .
4.2.2 Installation steps . . . . . . . . . . . . . . . . . . . . . . . . . . . . . .
4.3
Hardware Setup . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . .
4.4
Running the quick start example . . . . . . . . . . . . . . . . . . . . . . . . . .

16
16
17
17
18
18
18

5 Regulatory compliance information20
5.1
Exemption clause . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 20
6 Important notes
6.1
General customer responsibility . . . . . . . . . . . . . . . . . . . . . . . . . . .
6.2
Customer responsibility related to specific, in particular safety-relevant applications . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . .
6.3Best care and attention . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . .
6.4
Customer support for product specifications . . . . . . . . . . . . . . . . . . . .
6.5
Product improvements . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . .
6.6
Product life cycle . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . .
6.7
Property rights . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . .
6.8
General terms and conditions . . . . . . . . . . . . . . . . . . . . . . . . . . . .

21
21
21
21
21
22
22
22
22

7 Legal notice
7.1
Exclusion of liability . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . .
7.2
Suitability in customer applications . . . . . . . . . . . . . . . . . . . . . . . . .
7.3
Trademarks . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . .

23
23
23
23

Order code 2610039025001
Version 1.2, June 2023

3

www.we-online.com/wcs

WIRELESS CONNECTIVITY & SENSORS
User manual Calypso FeatherWing

7.4

Usage restriction . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 23

8 License terms
8.1
Limited license . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . .
8.2
Usage and obligations . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . .
8.3
Ownership . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . .
8.4
Firmware update(s) . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . .
8.5Disclaimer of warranty . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . .
8.6
Limitation of liability . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . .
8.7
Applicable law and jurisdiction . . . . . . . . . . . . . . . . . . . . . . . . . . . .
8.8Severability clause . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . .
8.9
Miscellaneous . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . .

25
25
25
26
26
26
27
27
27
27

Order code 2610039025001
Version 1.2, June 2023

4

www.we-online.com/wcs

WIRELESS CONNECTIVITY & SENSORS
User manual Calypso FeatherWing

1 General description
1.1 Introduction
The Würth Elektronik eiSos Calypso FeatherWing is a development board that offers a secure
2.4 GHz Wi-Fi connectivity solution. It is fully compatible to the popular Adafruit Feather line ofdevelopment boards and extends the Feathers with Wi-Fi connectivity.
The Calypso FeatherWing consists of the Calypso radio module that offers Wi-Fi connectivity
based on IEEE 802.11 b/g/n with a fully featured TCP/IP (IPv4 and IPv6) stack. With out-of-thebox support to commonly used network applications like SNTP, HTTP(S), MQTT(S) Calypsooffers an easy and secure solution to any IoT application.
It has an AT-style command interface on the standard UART and hence can be connected toany of the Feather microcontroller boards. The Arduino (C/C++) drivers and examples (seechapter 4) made available makes it easy to build a prototype to kick-start the application development.

Figure 1: The WE Calypso FeatherWing (2610039025001)

Order code 2610039025001
Version 1.2, June 2023

5

www.we-online.com/wcs

WIRELESS CONNECTIVITY & SENSORS
User manual Calypso FeatherWing

1.2 Block diagram

Figure 2: Block diagram - Calypso FeatherWing

1.3 Contents
Description

Quantity

WE Calypso FeatherWing

1

Packaging: ESD safe bag

1

Table 1: Contents 2610039025001

Order code 2610039025001
Version 1.2, June 2023

6

www.we-online.com/wcs

WIRELESS CONNECTIVITY & SENSORS
User manual Calypso FeatherWing

2 Functional description
The Calypso FeatherWing was designed with rapid prototyping in mind. Being fully compatible
with the Adafruit ecosystem, this FeatherWing allows the user the flexibility to choose the preferred host microcontroller. The inherent modularity of the ecosystem allows the FeatherWing
to be easily integrated into any project.
The next sections provide a brief introduction to Adafruit’s Feather ecosystem and details on
the Calypso Wi-Fi module.
Feel free to check our youtube channel:
www.youtube.com/user/WuerthElektronik/videos for video tutorials, hands-ons and webinars
relating to our products.

2.1 Adafruit Feather
The Adafruit Feather ecosystem consists of two types of boards apart from a host of accessories:• Feather: Adafruit Feathers are a complete line of development boards from Adafruit thatare standalone and stackable. They can be powered either over the on-board micro-USB
plugs or using a Li-Po battery. Feathers are portable, flexible and light as their namesake.
• FeatherWing: FeatherWings are stackable boards that when used along with a Feather
add a certain functionality to the system.
The Feather system with more than 50+ Wings, several different types of accessories andarduino/circuit python based code support provides a perfect ecosystem for rapid prototyping.
Please refer to adafruit.com/feather for more details on the Adafruit Feather ecosystem.

2.2 Calypso Wi-Fi module (2610011025000)
The Calypso Wi-Fi module is a compact Wi-Fi radio module based on IEEE 802.11 b/g/n witha fully featured TCP/IP stack. The edge castellated connections, smart antenna configuration
and an easy-to-use AT-style command interface enable easy integration of the Calypso into any
embedded application.
The module supports IPv4 as well as IPv6 and implements several commonly used network
applications like SNTP, DHPv4, DHCPv6, mDNS, HTTP(S), MQTT(Secure) out-of the box.
Advanced security features like up to 6 simultaneous secure sockets, secure boot, securestorage and secure OTA update provide a good basis for a secure end product.
Whether a serial cable replacement or low power IoT application with cloud connectivity, theCalypso Wi-Fi module offers a robust and standard compliant wireless connectivity solution for
low-power and low-medium throughput applications.

Key features
In this section, the features of the Calypso module are summarized in the form of a table. Calypso offers the user to configure and exploit its rich features through an easy-to-use commandinterface over UART.

Order code 2610039025001
Version 1.2, June 2023

7

www.we-online.com/wcs

WIRELESS CONNECTIVITY & SENSORS
User manual Calypso FeatherWing

FeatureDescriptionRadiostandards

IEEE 802.11 b/g/n station
IEEE 802.11 b/g Access point (for provisioning only)
Wi-Fi Direct client and group owner

Channels

1-13

Security

WEP, WPA/WPA2PSK, WPA2 Enterprise (802.1x)

Provisioning

In AP mode using the on-board HTTPS server

Network layer

IPv4, IPv6

IP addresssing

Static, LLA, DHCPv4, DHCPv6 with DAD

Transport layer

TCP, UDP
SSLv3.0/TLSv1.0/TLSv1.1/TLSv1.2
Up to 15 simultaneous sockets of which 6 can be secure.

Network
applications

MQTT(Secure) client
HTTP(S) client
SNTP client
HTTP(S) server
mDNS, DNS-SD
DHCP server
Ping

UpdateSecure FOTA update with fall back mechanism

Security

Secure key storage
Trusted root-certificate catalog
Encrypted file system
Secure OTA
Software tamper detection
Cloning protection

Powermanagement802.11 power save power modes
Lower power sleep mode with timed or pin wake-up
Table 2: Key features

Further details about Calypso Wi-Fi module can be found under
we-online.com/catalog/en/CALYPSO

Order code 2610039025001
Version 1.2, June 2023

8

www.we-online.com/wcs

WIRELESS CONNECTIVITY & SENSORS
User manual Calypso FeatherWing

3 Hardware description
This sections contains a detailed description of the hardware features of the Calypso FeatherWing. The design files for this hardware can be downloaded fromgithub.com/WE-eiSmart/FeatherWings-Hardware.

3.1 Connectors
3.1.1 Feather connector
This is the standard set of connectors that is used across the Feather ecosystem. The tablebelow describes the functions of each of the 28 pins as applicable to this FeatherWing.
Pin Number

Pin name

Function

1

RST

Not connected

2

3V3

3.3 V power supply

3

AREF

Not connected

4

GND

Ground

5

A0

Not connected

6

A1(Optional) Calypso APP_MODE_0 pin via JP3

7

A2(Optional) Calypso APP_MODE_1 pin via JP3

8A3

Not connected

9A4

Not connected

10A5

Not connected

11

SCK

Not connected

12

MOSI

Not connected

13

MISO

Not connected

14

U0RX

Calypso UTXD pin

15

U0TX

Calypso URXD Pin

16

NC

Not connected

Order code 2610039025001
Version 1.2, June 2023

9

www.we-online.com/wcs

WIRELESS CONNECTIVITY & SENSORS
User manual Calypso FeatherWing

Pin Number

Pin name

Function

17

SDA

Not connected

18

SCL

Not connected19

5Not connected

20

6(Optional) Calypso WAKE_UP pin via JP3

21

9

Not connected

22

U1TX

Not connected

23

U1RX

Not connected

24

12(Optional) Switch S2 via JP3

25

13

Not connected

26

5V

Not connected

27

EN

Not connected

28

VBAT

Not connected

3.2 Jumpers

Figure 3: Jumpers and their default state

3.2.1 JP2
This jumper enables the user to start Calypso Wi-Fi module in different modes through the
APP_MODE_0 and APP_MODE_1 pins. Table 4 briefly describes the different application
modes of Calypso. Please refer to Section 5.2 of the Calypso user manual for further details.
For normal operation in the standard AT-command mode, these jumpers do not need as thelines are pulled down internally.

Order code 2610039025001
Version 1.2, June 2023

10

www.we-online.com/wcs

WIRELESS CONNECTIVITY & SENSORS
User manual Calypso FeatherWing

JP2

Function

Jumper set (default)

1,3

APP_MODE_0 to HIGH

No

3,5

APP_MODE_0 to LOW

No

2,4

APP_MODE_1 to HIGH

No

4,6

APP_MODE_1 to LOW

No

Table 3: Jumper JP2
APP_MODE_0
APP_MODE_1_module

APP_MODE_1
APP_MODE_0_module

Mode

0

0

AT command normal mode0

1

FOTA mode

10

Provisioning mode

1

1

AT command terminal mode

Table 4: Calypso Application modes
APP_MODE_x means the labeling of the nets in the circuit of the evaluation board.
APP_MODE_x_module means the pin name of the module corresponding to the Calypso documentation. The numbering is not consistent.
3.2.2 JP3
This jumper allows the connection of Calypso’s pins APP_MODE_0, APP_MODE_1, WAKE_UP
pins to the host microcontroller. Additionally, it allows the general purpose switch S2 to be connected to GPIO 6.
JP3

FuntionJumper set (default)

1,2

S2 to GPIO12

Yes

3,4

APP_MODE_0 to GPIOA1

No

5,6

APP_MODE_1 to GPIOA2

No

7,8

WAKE_UP to GPIO6

No

Table 5: Jumper JP3

3.3 Push buttons
3.3.1 S1This push button is connected to the /RESET pin of the Calypso Wi-Fi module. Pressing thisbutton resets the module.

Order code 2610039025001
Version 1.2, June 2023

11

www.we-online.com/wcs

WIRELESS CONNECTIVITY & SENSORS
User manual Calypso FeatherWing

Figure 4: Push buttons
3.3.2 S2S2 is a general purpose push button which is connected to GPIO 6 when a jumper is set
between pins 1 and 2 of JP3. This switch can be used to trigger a specific action like switching
the Calypso into provisioning mode.

Order code 2610039025001
Version 1.2, June 2023

12

www.we-online.com/wcs

D

C

B

+

+3V3

GND

+3V3

2

C5
4u7

GND

GND

D1

C7
1uF

1

GND

2

GND

C6
100nF

4*2

GND

R1
4k7R

1

RESET_WIFS

GND

C3
n.m.

GND

VBAT
EN
USB
GPIO13
GPIO12
GPIO11
GPIO10
GPIO9
GPIO6
GPIO5
GPIOSCLGPIOSDA

2

28
27
26
25
24
23
22
21
20
19
18
17
GPIO6

GPIO12GND

APP_MODE_1
APP_MODE_0

C2 LED_YELLOW
n.m. RESET_WIFS

LED_GREEN+3V3

STATUS_IND_0
STATUS_IND_1
RESET
BOOT
APP_MODE_0
APP_MODE_1
GND
GND
GND
GND

5
6
7
9
10
11
34
23
3
13

1 ANT
2 RF

4 VCC
RESERVEDRESERVEDRESERVEDRESERVEDRESERVEDRESERVEDRESERVEDRESERVEDRESERVEDRESERVEDRESERVEDRESERVEDRESERVEDRESERVED

GND

3

12
33
32
31
30
29
28
27
26
25
24
8
19
17

MOD1
WIRL-WIFS_2610011025000

FEATHERWING FORM FACTOR

C1
22pF

C9
n.m.

GND

RESET
3V
AREF
GND
GPIOA0GPIOA1GPIOA2GPIOA3
GPIOA4GPIOA5GPIOSCKGPIOMOSIGPIOMISOGPIORXGPIOTXNC

CALYPSO WI-FI MODULE

S1434331013822

3*2

GND

TP2 TP1

UART5_RX
UART5_TXGPIOA1GPIOA2

ANT

A

1
2
3
4
5
6
7
8
9
10
11
12
13
14
15
16

C4

+3V3

n.m.

3

O1

GND

C8
n.m.

2

4*2

+3V3

2x4

1
3
5
7

JP3

GND

1

4

Optische Marke für Bestücker

O2

10kR

2
4
6
8
GPIO12GPIOA1GPIOA2
GPIO6

LED_YELLOW

S2434331013822

3*2

Optische Marke für BestückerS2

S2
APP_MODE_0
APP_MODE_1
WAKE_UP

4

R7

+3V3

R6

5

5

GND

2x3

1
3
5

JP2

+3V3

GND

2
4
6
APP_MODE_1

6

R5
10kR
GND

+3V3

R3
10kR

2610039025001
2610039020001

GND

D2

R2
1k5R

Sheet: 1/1
6

17.02.2023 14:03

261003902xxxx-HW-V1.2

LED_GREEN

D3

R4
3k3R

+3V3

GPIO CONFIGURATION JUMPERS

APP_MODE_0

+3V3

+

1

10kR

+

2

GND
GND
UTXD
URXD
WAKE_UP
/CTS
/RTS

22
14
15
16
18
20
21
UART5_RX
UART5_TX
WAKE_UP212

Order code 2610039025001
Version 1.2, June 2023
1

1

D

C

B

A

WIRELESS CONNECTIVITY & SENSORS
User manual Calypso FeatherWing

3.4 Schematics

Figure 5: Schematics

www.we-online.com/wcs

13

WIRELESS CONNECTIVITY & SENSORS
User manual Calypso FeatherWing

12.5mm

3.5 Layout

C

C

C

NO METAL AREA

12.5mm

12.5mm

12.5mmFigure 6: Assembly diagram

Order code 2610039025001
Version 1.2, June 2023

14

www.we-online.com/wcs

WIRELESS CONNECTIVITY & SENSORS
User manual Calypso FeatherWing

Figure 7: Top, bottom and internal layers

Order code 2610039025001
Version 1.2, June 2023

15

www.we-online.com/wcs

WIRELESS CONNECTIVITY & SENSORS
User manual Calypso FeatherWing

4 Software description
Würth Elektronik eiSos provides a software development kit (SDK) with examples to support
all the WE FeatherWings. Here are the salient features of the WE FeatherWing SDK.
• The SDK is open-source and well documented.
• It uses popular open-source tool chain including an IDE.
• The examples are written in Arduino-styled C/C++ for quick prototyping.
• The core components of the SDK are written in pure C to enable easy porting to any
microcontroller platform.
• Development platform independent (Windows, Linux or MAC).
• Modular structure of the software stack makes it easy to integrate into any project.
The SDK can be accessed on Github at github.com/WE-eiSmart/FeatherWings.

4.1 Software architecture
The WE FeatherWing SDK is built up in a modular way using a set of open-source tools toenable complete flexibility for the user.
The figure 8 shows the architecture of the WE FeatherWing SDK.
• PlatformIO: is a cross-platform, cross-architecture, multiple framework professional toolfor embedded software development. It provides the tool chain necessary for the softwaredevelopment including building, debugging, code-upload and many more. PlatformIO
works well on all the modern operating systems and supports a host of development
boards including the Feathers from Adafruit. Further details about PlatformIO can befound under platformio.org• Platform interface: This layer provides abstraction to the peripheral drivers for the platform being used. Currently, this SDK implements an abstraction to the Arduino peripheral
drivers for the Feather M0 express platform.
• WE SDK: This is a layer of platform-independent pure C drivers for sensors and wireless connectivity modules from Würth Elektronik eiSos. These drivers implement all thenecessary functions to utilize full feature set of the sensors and wireless connectivity
modules. More details on the SDK and dowloads under, we-online.com/wcs-software.
• Board files: This layer provides abstraction at a board level and provides functions toconfigure and control individual FeatherWings from WE.
• User application: The SDK currently implements a quick start example for each of the
FeatherWings.

Order code 2610039025001
Version 1.2, June 2023

16

www.we-online.com/wcs

WIRELESS CONNECTIVITY & SENSORS
User manual Calypso FeatherWing

Figure 8: Software architecture

4.2 Installing the tools
4.2.1 IDE
Although, platformIO provides a versatile command line interface for development, the SDK
provides quick start projects for the Visual Studio Code. This popular IDE makes for bettercode organization as well as code editing. Visual Studio Code is available on all modern
operating systems. Support for extensions, built-in Git and a versatile code editor make it awell rounded tool for embedded software development. Please refer to code.visualstudio.com
for more details on Visual Studio Code.

Order code 2610039025001
Version 1.2, June 2023

17

www.we-online.com/wcs

WIRELESS CONNECTIVITY & SENSORS
User manual Calypso FeatherWing

4.2.2 Installation steps• Install Visual Studio Code on the platform of your choice following the instructions undercode.visualstudio.com/docs• Follow the instructions under platformio.org/install/ide?install=vscode to install PlatformIO
IDE extension.

4.3 Hardware Setup
The quick start examples in the SDK are written to be run on Adafruit’s Feather M0 express.
The hardware setup is as simple as stacking up the FeatherWing on top of the M0 Feather andpowering up the board.

4.4 Running the quick start example• Clone or download the WE FeatherWing SDK from Github.
github.com/WE-eiSmart/FeatherWings• Open the workspace of interest with the filename <FeatherWing>.code-workspace in Visual Studio code.
• Build and upload the code from the PlatformIO tab as shown in the Figure 9• After successful upload, click on Monitor to view the debug logs in the serial terminal (seeFigure 9).

Order code 2610039025001
Version 1.2, June 2023

18

www.we-online.com/wcs

WIRELESS CONNECTIVITY & SENSORS
User manual Calypso FeatherWing

Figure 9: Running the quick start example

Order code 2610039025001
Version 1.2, June 2023

19

www.we-online.com/wcs

WIRELESS CONNECTIVITY & SENSORS
User manual Calypso FeatherWing

5 Regulatory compliance information
Pursuant to Article 1 (2.) of the EU directive 2014/53/EU, Article 1 (2.) the directive does not
apply to equipment listed in Annex I (4.): custom-built evaluation kits destined for professionals
to be used solely at research and development facilities for such purposes.
Nevertheless this evaluation board has been tested to satisfy general EMC requirements. Following standards have been applied:• IEC 61000-4-3• IEC 61000-4-4• IEC 61000-4-6• CISPR 16-2-1• CISPR 16-2-3

5.1 Exemption clause
Relevant regulation requirements are subject to change. Würth Elektronik eiSos does notguarantee the accuracy of the before mentioned information. Directives, technical standards,
procedural descriptions and the like may be interpreted differently by the national authorities.
Equally, the national laws and restrictions may vary with the country. In case of doubt or uncertainty, we recommend that you consult with the authorities or official certification organizationsof the relevant countries. Würth Elektronik eiSos is exempt from any responsibilities or liabilities related to regulatory compliance.
Notwithstanding the above, Würth Elektronik eiSos makes no representations and warranties
of any kind related to their accuracy, correctness, completeness and/or usability for customer
applications. No responsibility is assumed for inaccuracies or incompleteness.

Order code 2610039025001
Version 1.2, June 2023

20

www.we-online.com/wcs

WIRELESS CONNECTIVITY & SENSORS
User manual Calypso FeatherWing

6 Important notes
The following conditions apply to all goods within the wireless connectivity product range of
Würth Elektronik eiSos GmbH & Co. KG:

6.1 General customer responsibility
Some goods within the product range of Würth Elektronik eiSos GmbH & Co. KG containstatements regarding general suitability for certain application areas. These statements aboutsuitability are based on our knowledge and experience of typical requirements concerning theareas, serve as general guidance and cannot be estimated as binding statements about thesuitability for a customer application. The responsibility for the applicability and use in a particular customer design is always solely within the authority of the customer. Due to this fact, it is
up to the customer to evaluate, where appropriate to investigate and to decide whether the device with the specific product characteristics described in the product specification is valid andsuitable for the respective customer application or not. Accordingly, the customer is cautioned
to verify that the documentation is current before placing orders.

6.2 Customer responsibility related to specific, in particularsafety-relevant applications
It has to be clearly pointed out that the possibility of a malfunction of electronic components or
failure before the end of the usual lifetime cannot be completely eliminated in the current stateof the art, even if the products are operated within the range of the specifications. The samestatement is valid for all software sourcecode and firmware parts contained in or used with orfor products in the wireless connectivity and sensor product range of Würth Elektronik eiSos
GmbH & Co. KG. In certain customer applications requiring a high level of safety and especiallyin customer applications in which the malfunction or failure of an electronic component could
endanger human life or health, it must be ensured by most advanced technological aid ofsuitable design of the customer application that no injury or damage is caused to third parties
in the event of malfunction or failure of an electronic component.

6.3 Best care and attention
Any product-specific data sheets, manuals, application notes, PCN’s, warnings and cautions
must be strictly observed in the most recent versions and matching to the products firmware revisions. This documents can be downloaded from the product specific sections on the wirelessconnectivity homepage.

6.4 Customer support for product specifications
Some products within the product range may contain substances, which are subject to restrictions in certain jurisdictions in order to serve specific technical requirements. Necessary
information is available on request. In this case, the field sales engineer or the internal sales
person in charge should be contacted who will be happy to support in this matter.

Order code 2610039025001
Version 1.2, June 2023

21

www.we-online.com/wcs

WIRELESS CONNECTIVITY & SENSORS
User manual Calypso FeatherWing

6.5 Product improvements
Due to constant product improvement, product specifications may change from time to time.
As a standard reporting procedure of the Product Change Notification (PCN) according to
the JEDEC-Standard, we inform about major changes. In case of further queries regarding the
PCN, the field sales engineer, the internal sales person or the technical support team in charge
should be contacted. The basic responsibility of the customer as per section 6.1 and 6.2 remains unaffected. All wireless connectivity module driver software ¨wireless connectivity SDK¨
and it’s source codes as well as all PC software tools are not subject to the Product Change
Notification information process.

6.6 Product life cycle
Due to technical progress and economical evaluation we also reserve the right to discontinue
production and delivery of products. As a standard reporting procedure of the Product Termination Notification (PTN) according to the JEDEC-Standard we will inform at an early stage
about inevitable product discontinuance. According to this, we cannot ensure that all products
within our product range will always be available. Therefore, it needs to be verified with thefield sales engineer or the internal sales person in charge about the current product availability
expectancy before or when the product for application design-in disposal is considered. The
approach named above does not apply in the case of individual agreements deviating from theforegoing for customer-specific products.

6.7 Property rights
All the rights for contractual products produced by Würth Elektronik eiSos GmbH & Co. KG
on the basis of ideas, development contracts as well as models or templates that are subject
to copyright, patent or commercial protection supplied to the customer will remain with Würth
Elektronik eiSos GmbH & Co. KG. Würth Elektronik eiSos GmbH & Co. KG does not warrant
or represent that any license, either expressed or implied, is granted under any patent right,
copyright, mask work right, or other intellectual property right relating to any combination, application, or process in which Würth Elektronik eiSos GmbH & Co. KG components or services
are used.

6.8 General terms and conditions
Unless otherwise agreed in individual contracts, all orders are subject to the current version ofthe "General Terms and Conditions of Würth Elektronik eiSos Group", last version available atwww.we-online.com.

Order code 2610039025001
Version 1.2, June 2023

22

www.we-online.com/wcs

WIRELESS CONNECTIVITY & SENSORS
User manual Calypso FeatherWing

7 Legal notice
7.1 Exclusion of liability
Würth Elektronik eiSos GmbH & Co. KG considers the information in this document to be correct at the time of publication. However, Würth Elektronik eiSos GmbH & Co. KG reserves theright to modify the information such as technical specifications or functions of its products or
discontinue the production of these products or the support of one of these products without
any written announcement or notification to customers. The customer must make sure thatthe information used corresponds to the latest published information. Würth Elektronik eiSos
GmbH & Co. KG does not assume any liability for the use of its products. Würth Elektronik
eiSos GmbH & Co. KG does not grant licenses for its patent rights or for any other of its intellectual property rights or third-party rights.
Notwithstanding anything above, Würth Elektronik eiSos GmbH & Co. KG makes no representations and/or warranties of any kind for the provided information related to their accuracy,
correctness, completeness, usage of the products and/or usability for customer applications.
Information published by Würth Elektronik eiSos GmbH & Co. KG regarding third-party products or services does not constitute a license to use such products or services or a warranty or
endorsement thereof.

7.2 Suitability in customer applications
The customer bears the responsibility for compliance of systems or units, in which Würth Elektronik eiSos GmbH & Co. KG products are integrated, with applicable legal regulations. Customer acknowledges and agrees that it is solely responsible for compliance with all legal, regulatory and safety-related requirements concerning its products, and any use of Würth Elektronik
eiSos GmbH & Co. KG components in its applications, notwithstanding any applications-related
in-formation or support that may be provided by Würth Elektronik eiSos GmbH & Co. KG. Customer represents and agrees that it has all the necessary expertise to create and implement
safeguards which anticipate dangerous consequences of failures, monitor failures and theirconsequences lessen the likelihood of failures that might cause harm and take appropriate remedial actions. The customer will fully indemnify Würth Elektronik eiSos GmbH & Co. KG and
its representatives against any damages arising out of the use of any Würth Elektronik eiSos
GmbH & Co. KG components in safety-critical applications.

7.3 Trademarks
AMBER wireless is a registered trademark of Würth Elektronik eiSos GmbH & Co. KG. Allother trademarks, registered trademarks, and product names are the exclusive property of therespective owners.

7.4 Usage restriction
Würth Elektronik eiSos GmbH & Co. KG products have been designed and developed for usage in general electronic equipment only. This product is not authorized for use in equipment

Order code 2610039025001
Version 1.2, June 2023

23

www.we-online.com/wcs

WIRELESS CONNECTIVITY & SENSORS
User manual Calypso FeatherWing

where a higher safety standard and reliability standard is especially required or where a failureof the product is reasonably expected to cause severe personal injury or death, unless the parties have executed an agreement specifically governing such use. Moreover, Würth Elektronik
eiSos GmbH & Co. KG products are neither designed nor intended for use in areas such as
military, aerospace, aviation, nuclear control, submarine, transportation (automotive control,
train control, ship control), transportation signal, disaster prevention, medical, public information network etc. Würth Elektronik eiSos GmbH & Co. KG must be informed about the intent
of such usage before the design-in stage. In addition, sufficient reliability evaluation checks forsafety must be performed on every electronic component, which is used in electrical circuitsthat require high safety and reliability function or performance. By using Würth Elektronik eiSos
GmbH & Co. KG products, the customer agrees to these terms and conditions.

Order code 2610039025001
Version 1.2, June 2023

24

www.we-online.com/wcs

WIRELESS CONNECTIVITY & SENSORS
User manual Calypso FeatherWing

8 License terms
These License terms will take effect upon the purchase and usage of the Würth Elektronik
eiSos GmbH & Co. KG wireless connectivity products. You hereby agree that these license
terms are applicable to the product and the incorporated software, firmware and source codes(collectively, "Software") made available by Würth Elektronik eiSos in any form, including but
not limited to binary, executable or source code form.
The software included in any Würth Elektronik eiSos wireless connectivity product is purchased
to you on the condition that you accept the terms and conditions of these license terms. You
agree to comply with all provisions under these license terms.

8.1 Limited license
Würth Elektronik eiSos hereby grants you a limited, non-exclusive, non-transferable and royaltyfree license to use the software and under the conditions that will be set forth in these license
terms. You are free to use the provided software only in connection with one of the products
from Würth Elektronik eiSos to the extent described in these license terms. You are entitled
to change or alter the source code for the sole purpose of creating an application embedding
the Würth Elektronik eiSos wireless connectivity product. The transfer of the source code to
third parties is allowed to the sole extent that the source code is used by such third parties
in connection with our product or another hardware provided by Würth Elektronik eiSos understrict adherence of these license terms. Würth Elektronik eiSos will not assume any liability forthe usage of the incorporated software and the source code. You are not entitled to transfer
the source code in any form to third parties without prior written consent of Würth Elektronik
eiSos.
You are not allowed to reproduce, translate, reverse engineer, decompile, disassemble or create derivative works of the incorporated software and the source code in whole or in part. No
more extensive rights to use and exploit the products are granted to you.

8.2 Usage and obligations
The responsibility for the applicability and use of the Würth Elektronik eiSos wireless connectivity product with the incorporated firmware in a particular customer design is always solely
within the authority of the customer. Due to this fact, it is up to you to evaluate and investigate,
where appropriate, and to decide whether the device with the specific product characteristics
described in the product specification is valid and suitable for your respective application ornot.
You are responsible for using the Würth Elektronik eiSos wireless connectivity product with
the incorporated firmware in compliance with all applicable product liability and product safety
laws. You acknowledge to minimize the risk of loss and harm to individuals and bear the risk
for failure leading to personal injury or death due to your usage of the product.
Würth Elektronik eiSos’ products with the incorporated firmware are not authorized for use insafety-critical applications, or where a failure of the product is reasonably expected to cause
severe personal injury or death. Moreover, Würth Elektronik eiSos’ products with the incorporated firmware are neither designed nor intended for use in areas such as military, aerospace,aviation, nuclear control, submarine, transportation (automotive control, train control, ship control), transportation signal, disaster prevention, medical, public information network etc. You

Order code 2610039025001
Version 1.2, June 2023

25

www.we-online.com/wcs

WIRELESS CONNECTIVITY & SENSORS
User manual Calypso FeatherWing

shall inform Würth Elektronik eiSos about the intent of such usage before design-in stage. In
certain customer applications requiring a very high level of safety and in which the malfunction
or failure of an electronic component could endanger human life or health, you must ensure
to have all necessary expertise in the safety and regulatory ramifications of your applications.
You acknowledge and agree that you are solely responsible for all legal, regulatory and safetyrelated requirements concerning your products and any use of Würth Elektronik eiSos’ products with the incorporated firmware in such safety-critical applications, notwithstanding any
applications-related information or support that may be provided by Würth Elektronik eiSos.
YOU SHALL INDEMNIFY WÜRTH ELEKTRONIK EISOS AGAINST ANY DAMAGES ARISING OUT OF THE USE OF WÜRTH ELEKTRONIK EISOS’ PRODUCTS WITH THE INCORPORATED FIRMWARE IN SUCH SAFETY-CRITICAL APPLICATIONS.

8.3 Ownership
The incorporated firmware created by Würth Elektronik eiSos is and will remain the exclusive
property of Würth Elektronik eiSos.

8.4 Firmware update(s)You have the opportunity to request the current and actual firmware for a bought wireless connectivity product within the time of warranty. However, Würth Elektronik eiSos has no obligation
to update a modules firmware in their production facilities, but can offer this as a service on request. The upload of firmware updates falls within your responsibility, e.g. via ACC or anothersoftware for firmware updates. Firmware updates will not be communicated automatically. It
is within your responsibility to check the current version of a firmware in the latest version of
the product manual on our website. The revision table in the product manual provides all necessary information about firmware updates. There is no right to be provided with binary files,
so called "firmware images", those could be flashed through JTAG, SWD, Spi-Bi-Wire, SPI orsimilar interfaces.

8.5 Disclaimer of warranty
THE FIRMWARE IS PROVIDED "AS IS". YOU ACKNOWLEDGE THAT WÜRTH ELEKTRONIKEISOS MAKES NO REPRESENTATIONS AND WARRANTIES OF ANY KIND RELATED TO,
BUT NOT LIMITED TO THE NON-INFRINGEMENT OF THIRD PARTIES’ INTELLECTUAL
PROPERTY RIGHTS OR THE MERCHANTABILITY OR FITNESS FOR YOUR INTENDEDPURPOSE OR USAGE. WÜRTH ELEKTRONIK EISOS DOES NOT WARRANT OR REPRESENT THAT ANY LICENSE, EITHER EXPRESS OR IMPLIED, IS GRANTED UNDER ANY
PATENT RIGHT, COPYRIGHT, MASK WORK RIGHT, OR OTHER INTELLECTUAL PROPERTY RIGHT RELATING TO ANY COMBINATION, MACHINE, OR PROCESS IN WHICH
THE WÜRTH ELEKTRONIK EISOS’ PRODUCT WITH THE INCORPORATED FIRMWARE IS
USED. INFORMATION PUBLISHED BY WÜRTH ELEKTRONIK EISOS REGARDING THIRDPARTY PRODUCTS OR SERVICES DOES NOT CONSTITUTE A LICENSE FROM WÜRTH
ELEKTRONIK EISOS TO USE SUCH PRODUCTS OR SERVICES OR A WARRANTY OR
ENDORSEMENT THEREOF.

Order code 2610039025001
Version 1.2, June 2023

26

www.we-online.com/wcs

WIRELESS CONNECTIVITY & SENSORS
User manual Calypso FeatherWing

8.6 Limitation of liability
Any liability not expressly provided by Würth Elektronik eiSos shall be disclaimed.
You agree to hold us harmless from any third-party claims related to your usage of the Würth
Elektronik eiSos’ products with the incorporated firmware, software and source code. Würth
Elektronik eiSos disclaims any liability for any alteration, development created by you or yourcustomers as well as for any combination with other products.

8.7 Applicable law and jurisdiction
Applicable law to these license terms shall be the laws of the Federal Republic of Germany. Any
dispute, claim or controversy arising out of or relating to these license terms shall be resolved
and finally settled by the court competent for the location of Würth Elektronik eiSos registeredoffice.

8.8 Severability clause
If a provision of these license terms is or becomes invalid, unenforceable or null and void,
this shall not affect the remaining provisions of the terms. The parties shall replace any suchprovisions with new valid provisions that most closely approximate the purpose of the terms.

8.9 Miscellaneous
Würth Elektronik eiSos reserves the right at any time to change this terms at its own discretion.
It is your responsibility to check at Würth Elektronik eiSos homepage for any updates. Your
continued usage of the products will be deemed as the acceptance of the change.
We recommend you to be updated about the status of new firmware and software, which isavailable on our website or in our data sheet and manual, and to implement new software inyour device where appropriate.
By ordering a product, you accept these license terms in all terms.

Order code 2610039025001
Version 1.2, June 2023

27

www.we-online.com/wcs

WIRELESS CONNECTIVITY & SENSORS
User manual Calypso FeatherWing

List of Figures
1
2
3
4
5
6
7
8
9

The WE Calypso FeatherWing (2610039025001) . . . . . . . . . . . . . . . . . .
Block diagram - Calypso FeatherWing . . . . . . . . . . . . . . . . . . . . . . . .
Jumpers and their default state . . . . . . . . . . . . . . . . . . . . . . . . . . . .
Push buttons . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . .
Schematics . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . .
Assembly diagram . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . .
Top, bottom and internal layers . . . . . . . . . . . . . . . . . . . . . . . . . . . .
Software architecture . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . .
Running the quick start example . . . . . . . . . . . . . . . . . . . . . . . . . . .

5
6
10
12
13
14
15
17
19

List of Tables
1
2
3
4
5

Contents 2610039025001 . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 6
Key features . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 8
Jumper JP2 . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 11
Calypso Application modes . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 11
Jumper JP3 . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 11

Order code 2610039025001
Version 1.2, June 2023

28

www.we-online.com/wcs

Contact
Würth Elektronik eiSos GmbH & Co. KG
Division Wireless Connectivity & Sensors
Max-Eyth-Straße 174638 Waldenburg
Germany
Tel.: +49 651 99355-0
Fax.: +49 651 99355-69
www.we-online.com/wireless-connectivity