Calypso is Wi-Fi Certified. The Certification ID is WFA81685. 1.1. Operational description The Calypso WLAN module is intended to be used as a radio sub-system in order to provide WLAN communication capabilities to the system. The UART acts as the primary interface between the module and a host micro-controller.
2. Electrical specifications Unless otherwise stated, all the values given here were measured on the Calypso evaluation board under the following conditions:T=25°C, VDDS=3.6V, internal DC-DC converter active and 50 conducted. 2.1. Recommended operating conditions Description Min. Typ. Max. Unit Temperature range °C...
4.1.1. On-board PCB antenna The Calypso has an on-board PCB antenna optimzed for operation in the 2.4 GHz band. A simple short between the pins RF and ANT feeds the RF output of the module to the on- board antenna. In this configuration, the module does not require any additional RF circuitry.
Calypso modules and exchange data between the two modules. Minimal pin and antenna connections have to be done on both the modules as described in sec- tions 4.2 and section 4.1 . It is recommended to use the Calypso evaluation kit for quick tests.
Figure 4: Quick start setup 4.5.4. Start-up 1. Connect the Calypso EV boards to the laptop/PC via USB. 2. The power LED indicates that supply voltage is active. The FTDI driver for the converter IC on the evaluation board has to be installed and/or updated.
5. Functional description The Calypso WLAN module is intended to be used as a radio sub-system in order to provide WLAN (IEEE 802.11) communication capabilities to system. The UART acts as the primary interface between the module and a host micro-controller.
5.2. Modes of operation When active, the Calypso can be in one of the following operation modes. The transition to/from the modes occurs due to one of the following reasons. • Command from the host. • Position of the App_Mode_x pins during boot up •...
A 0 indicates logic LOW level, 1 indicates logical HIGH level. 5.2.2. Idle In idle mode, Calypso allows the user to configure and use the module using the UART com- mand interface. The AT-command interface is described in detail in chapter 7 . A transition to provisioning or hibernate can be done using the appropriate commands.
6. Host connection The Calypso is intended to be used as a radio module in a system, interfaced with a host micro-controller. The use of industry standard UART as the primary interface ensures a very minimal requirement set on the host MCU. As a result of this, the module can be designed in with most host controllers from a 8051 to the more advanced ARM core architecture.
7. The command interface The command interface on the Calypso enables full control over the module using ASCII based AT styled commands. In order to support easy integration with a wide range of micro- controllers, two different modes of the command interface are implemented. The user can choose one of the following modes by setting the two APP_MODE_x pins to the correspond- ing levels as described in section 5.2 .
8. AT commands In this chapter, various commands used to configure and control the Calypso module are described. 8.1. Device commands The commands under device category provide access to generic module properties like communication interface, time and date settings and version information. Additionally, basic device operations like start, stop, reboot and sleep are described in this section.
8.2.1. Set mode The Calypso can be operated as a WLAN station, access point or in P2P (Wi-Fi direct) mode. The mode can be selected using the following command and the configuration will take effect only after a stop/start of the NWP.
Table 25: AT+wlanscan 8.2.3. Manual connection In order to manually connect the Calypso to a known access point the following command has to be used. A manual connect has the highest priority over all the other connection types. A connect event confirms a successful connection.
Table 27: AT+wlanDisconnect 8.2.4. Profiles Calypso allows the user to store up to seven preferred networks as profiles. Based on the connection policy (see section 8.2.6 ) the module automatically establishes connection with one of the saved profiles. Profile priority determines the order of connection. The profiles are saved in the non-volatile memory and can be added, read or deleted using the following commands.
WLAN NWP can be set to one of the following options: Normal, low latency, low power and long sleep. • P2P: In P2P mode, the Calypso can be configured to either choose a specific role (GO or client) or negotiate with the peer. The connections initiation can be active or passive based on the policy set.
Table 34: AT+wlanPolicyGet 8.3. Network configuration commands Configuration at the network level involves address management. The Calypso supports multiple address-acquisition methods for both IPv4 and IPv6 addressing. In Station and Wi-Fi direct client mode, the address acquisition process begins after a successful WLAN connection is established.
A TCP socket, a connection-oriented socket, creates a bi-directional connection between the two network peers, a client and a server. Calypso supports both client and server roles. Here is a general work flow of a TCP socket ( see figure 7 ).
In this case the client work flow is similar to TCP ( see figure 7 ). Figure 8: UCP socket work flow 8.4.1.3. Multicast The Calypso also supports multicast (one-to-many) over the IP network. Ipv4 IGMPv2 and IPv6 MLDv1 protocols for joining or leaving a multicast group are supported 8.4.2. Secure sockets Calypso supports secure socket communication using the SSL and TLS protocols.
The SSL/TLS protocol requires certificates for authentication and a trusted root certificate catalog to verify the certificates. The calypso provides secure key storage option through the encrypted file system (see section 8.5 ). A trusted root certificate catalog is present on board with a set of well known trusted root CAs (see appendix C ).
Table 52: AT+sendTo 8.5. File system commands Calypso creates and maintains an ecrypted file system on the serial flash present on-board. The file system provides secure storage for files like certificates, private keys and web pages. Here are some of the features of the file system.
Table 61: AT+netAppStop 8.6.2. SNTP client Calypso implements an on-board SNTP client with configurable server addresses. A list of up to three SNTP servers can be stored in the non-volatile memory. The module tries to connect to the servers in order of the stored address index. The time zone has to be set manually.
Table 64: AT+netappUpdateTime 8.6.3. HTTP client Calypso offers creation of a HTTP client and execution of commonly used methods including get,post,connect and delete. This enables the user to connect to any HTTP(S) server and transmit and receive data with ease. In the following all the commands to create and control a HTTP client are described.
The broker on the other hand is responsible for receiving a published topic and pushing it to all the subscribed nodes. Calypso offers AT commands to create an MQTT client, subscribe as well as publish topics. The following section describes these commands.
To enable easy provisioning when integrated to an embedded system with limited HMI ca- pabilities, the Calypso offers a provisioning mode. In this mode, the module acts as an AP and allows external devices with appropriate credentials to connect and access the on-board HTTPS server.
The domain "calypso.net" is local and hence cannot be verified by known root CAs. Hence, the on-board HTTPS server uses a self-signed certificate. As a result of this, the browser on the configuring device may a report security risk. In this case the user has to trust the certificate and proceed to the website in order to perform the provisioning operation on the WLAN module.
Page 80
After restarting in AT command mode, the module automatically connects to the pre-defined +eventwlan : connect , Calypso P r u e f r o u t e r , 0 x0 : 0 x25 : 0 x9c : 0 x c f : 0 x85 : 0 x f 0 +eventnetapp : i p v 4 _ a c q u i r e d , 1 9 2 .
10. Typical application use cases In this section some of the typical use cases for the Calypso module are considered and a simple example is described in each case. 10.1. UDP communication UDP is a connectionless transport layer protocol used to exchange data between peers in an IP network.
SSL/TLS layer provides added security features like server authentication and end-to-end encryption. This exampled describes creation of an SSL/TLS server as well as client on Calypso EV board and exchange of data between the two. The following hardware is required to go through the quick start example.
Client. The discovery of devices is done by sending/listening broadcasting packets on channels 1, 6 and 11. This section demonstrates the Wi-Fi direct capabilities of Calypso module by connecting two Calypso EV boards over Wi-Fi direct. 10.4.1. Prerequisites The following hardware is required to go through this Wi-Fi direct example.
+eventnetapp : i p v 4 _ a c q u i r e d , 1 0 . 1 2 3 . 4 5 . 1 , 1 0 . 1 2 3 . 4 5 . 1 , 0 . 0 . 0 . 0 Now connect with your PC or smart phone to the WLAN of the Calypso radio module and call the website "mywebpage.net/mytest.html"...
11.1. Hard reset A hard reset on the Calypso module is done by asserting a low on the /RESET. On hard- reset, the module reloads the application from the sFlash after verifying the image to ensure the integrity of the application. This contributes towards higher start up times of the applica- tion.
Profile 0 and the connection policy is set to "AUTO" (see chapter 8.2.6 ). 3. The device (PC, Smartphone, ...) should be connected to the same AP and configured within the same network as the Calypso radio module. It can be any device with a browser supporting (self-)signed HTTPS content and JavaScript.
Version 0.x.x "Engineering" Version 1.0.0 "Release" The Calypso firmware is based on SimpleLink Wi-Fi CC3220 Software development kit (SDK) from Texas Instruments with the corresponding features as well as known issues. The table 93 lists the version of different components used for the current firmware version.
16. Reference design Calypso was tested and certified on the corresponding Calypso evaluation board. For the compliance with the EU directive 2014/53/EU Annex I, the evaluation board serves as refer- ence design. For the FCC it serves as trace design.
Page 113
• Bottom layer is used for routing. Figure 30: Close-up Schematic Two variants of the Calypso are certified: • Using the inside the module integrated PCB antenna. Not placing C1, C14 and C15, but placing 0 Ohm for C13. C13 connects the RF_PAD, the radio signal from/toward the transceiver, to the ANT_PAD, the connection to the inside the module integrated antenna.
R&TTE directive 1999/5/EC and the RED directive 2014/53/EU of the European Union (EU). The Calypso can be operated without notification and free of charge in the area of the Euro- pean Union. However, according to the R&TTE / RED directive, restrictions (e.g. in terms of duty cycle or maximum allowed RF power) may apply.
74638 Waldenburg This declaration of conformity is issued under the sole responsibility of the manufacturer. Object of the declaration: Calypso / 2610011025000 The object of the declaration described above is in conformity with the relevant Union har- monization legislation: Directive 2014/53/EU and 2011/65/EU.
– The OEM must sign the OEM Modular Approval Agreement. – The module must be used with only the following approved antenna(s). 21.6. Pre-certified antennas The Calypso is pre-certified with the following antennas. Product Certified antenna Calypso PCB antenna included in the Calypso Dipol antenna as specified in chapter 15.3.4.5...
A. Wi-Fi certificate The section contains the Wi-Fi certificate for Calypso . Wi-Fi CERTIFIED™ Interoperability Certificate This certificate lists the features that have successfully completed Wi-Fi Alliance interoperability testing. Learn more: www.wi-fi.org/certification/programs Certification ID: WFA81685 Page 1 of 2 Date of Last Certification...
B. Error codes The section briefly describes the meaning of error codes returned by Calypso in response to commands. B.1. Disconnection reason codes / * WLAN Disconnect Reason Codes * / SL_WLAN_DISCONNECT_UNSPECIFIED ( 1 ) SL_WLAN_DISCONNECT_AUTH_NO_LONGER_VALID ( 2 ) SL_WLAN_DISCONNECT_DEAUTH_SENDING_STA_LEAVING ( 3 )
Page 156
more than you expect Monitoring Automated Meter Internet & Control Reading of Things Contact: Würth Elektronik eiSos GmbH & Co. KG Division Wireless Connectivity & Sensors Rudi-Schillings-Str. 31 54296 Trier Germany Tel.: +49 651 99355-0 Fax.: +49 651 99355-69 www.we-online.com/wireless-connectivity...
Need help?
Do you have a question about the CALYPSO and is the answer not in the manual?
Questions and answers