background image

A. Wi-Fi certificate

The section contains the Wi-Fi certificate for Calypso .

Access

Optimization

Connectivity

CLASSIFICATION

2.4 GHz

Frequency Band(s)

ThreadX, version: 2.20.00.10

Operating System

Product: 1.0.0, Wi-Fi Component: 31.2.0.0.0

Firmware Version

Product: 2.1, Wi-Fi Component: 3.1

Hardware Version

Industrial (communications & input)

Subcategory

Other

Category

AMB5201 (Other)

Product Identifier(s)

261001102500x

Model Number

Calypso

Product

Wurth Elektronik eiSos GmbH & CO. KG

Company

January 22, 2019

Date of Last Certification

Page 1 of 2

Certification ID: WFA81685

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

Summary of Certifications

PROGRAM

Wi-Fi CERTIFIED™ b, g, n

WPA™ – Enterprise, Personal

WPA2™ – Enterprise, Personal

Wi-Fi Direct®

WMM®

Wi-Fi Protected Setup™

Calypso reference manual version 1.2

© April 2019

www.we-online.com/wireless-connectivity

137

Summary of Contents for CALYPSO

Page 1: ...CALYPSO REFERENCE MANUAL AMB5201 261001102500X VERSION 1 2 APRIL 12 2019 ...

Page 2: ...y 2019 1 1 1 0 0 2 0 Added chapter Reference design Added chapter Information for Ex protection February 2019 1 2 1 0 0 2 0 Added known issues in chapter Firmware history March 2019 1 3 1 0 0 2 0 Added FCC compliance April 2019 Calypso reference manual version 1 2 April 2019 www we online com wireless connectivity 1 ...

Page 3: ...l level LSB Least significant bit MSB Most significant bit PL Payload The real non redundant information in a frame packet RF Radio frequency Describes everything relating to the wireless transmission STA Station WLAN 802 11 node in station role can connect to an AP UART Universal Asynchronous Receiver Transmitter allows communicating with the module of a specific interface US UserSettings Any rel...

Page 4: ... secure Application layer protocol MQTT Message Queuing Telemetry Transport Application layer protocol OTA Over The Air Update mechanism DHCP Dynamic Host Configuration Protocol Application layer protocol WEP Wired Equivalent Privacy 802 11 security algorithm WPA Wi Fi Protected Access Wi Fi security algorithm WPS Wi Fi Protected Setup Wi Fi security algorithm DNS Domain Name System Application la...

Page 5: ...configuration 20 4 3 Power up 21 4 4 Region specific WLAN settings 21 4 5 Quick start example 22 4 5 1 Prerequisites 22 4 5 2 Hardware configuration 22 4 5 3 Setup description 22 4 5 4 Start up 23 4 5 5 Connect to an access point 24 4 5 6 Creating a TCP server 24 4 5 7 Creating a TCP client 25 4 5 8 Data transfer 25 5 Functional description 27 5 1 Key features 27 5 2 Modes of operation 28 5 2 1 Bo...

Page 6: ...s 44 8 4 Socket commands 47 8 4 1 Sockets work flow 47 8 4 1 1 TCP socket 47 8 4 1 2 UDP socket 48 8 4 1 3 Multicast 48 8 4 2 Secure sockets 48 8 4 3 Socket operations 49 8 4 4 Socket settings 51 8 4 5 Socket data exchange 54 8 5 File system commands 56 8 5 1 File system operations 57 8 5 2 File operations 58 8 6 Network application commands 61 8 6 1 mDNS 61 8 6 2 SNTP client 62 8 6 3 HTTP client ...

Page 7: ...ation mode 86 10 5 3 Accessing the web site in access point mode 87 11 Timing parameters 89 11 1 Hard reset 89 11 2 Soft reset 89 12 Firmware update 90 12 1 Prerequisites 90 12 2 Update procedure 90 12 2 1 Start up 90 12 2 2 Connection to the update device 91 12 2 3 Upload the update package 92 12 2 4 Finalize the update 94 13 Firmware history 95 14 Custom firmware 96 14 1 Custom configuration of ...

Page 8: ...imensions 118 18 1 Dimensions 118 18 2 Weight 118 18 3 Module drawing 119 18 4 Footprint 120 18 5 Antenna free area 121 19 Marking 122 19 1 Lot number 122 19 2 General labeling information 123 19 2 1 Label of Calypso 123 20 Information for Ex protection 124 21 Regulatory compliance information 125 21 1 Important notice EU 125 21 2 EU Declaration of conformity 126 21 3 FCC Compliance Statement 127 ...

Page 9: ... Ownership 135 24 4 Firmware update s 135 24 5 Disclaimer of warranty 135 24 6 Limitation of liability 136 24 7 Applicable law and jurisdiction 136 24 8 Severability clause 136 24 9 Miscellaneous 136 A Wi Fi certificate 137 B Error codes 139 B 1 Disconnection reason codes 139 B 2 Socket error codes 139 B 3 Secure socket error codes 140 B 4 WLAN error codes 143 B 5 Device error codes 144 B 6 Networ...

Page 10: ...solu tion for low power and low medium throughput applications WLAN will be used as a synonym for IEEE 802 11 standard compliant radio communication throughout this manual 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 U...

Page 11: ...order code Description 2610011025000 AMB5201 TR WLAN module in T R packaging 2610011025009 AMB5201 DEV 3 pcs WLAN module 2610019225001 AMB5201 EV EV kit for WLAN module Table 1 Ordering information Calypso reference manual version 1 2 April 2019 www we online com wireless connectivity 10 ...

Page 12: ...ent thermal slew rate 20 20 C min Table 2 Recommended operating conditions When operating at an ambient temperature of over 75 C the transmit duty cycle must remain below 50feature of the power amplifier If the auto protect feature triggers the device takes a maximum of 60 seconds to restart the trans mission 2 2 Absolute maximum ratings Description Min Typ Max Unit VCC 0 5 3 8 V Table 3 Absolute ...

Page 13: ...ration current VCC 3 3V 450 mA Table 4 Power consumption 2 4 Radio characteristics Description Min Typ Max Unit Max output power 16 18 dBm Input sensitivity 1 Mbit 94 92 dBm Max input level 802 11b 4 dBm Max input level 802 11g 10 dBm Frequencies 2412 2472 MHz Table 5 Radio characteristics Calypso reference manual version 1 2 April 2019 www we online com wireless connectivity 12 ...

Page 14: ...ate 3 4 36 Mbps 64 QAM OFDM coding rate 2 3 48 Mbps 64 QAM OFDM coding rate 3 4 54 Mbps 802 11n BPSK OFDM coding rate 1 2 7 2 Mbps QPSK OFDM coding rate 1 2 14 4 Mbps QPSK OFDM coding rate 3 4 21 7 Mbps 16 QAM OFDM coding rate 1 2 28 9 Mbps 16 QAM OFDM coding rate 3 4 43 3 Mbps 64 QAM OFDM coding rate 2 3 57 8 Mbps 64 QAM OFDM coding rate 3 4 65Mbps 64 QAM OFDM coding rate 5 6 72 2 Mbps Table 6 Mo...

Page 15: ...I O and control pin drive mode dependant 2 mA Pin output current sourced by any I O and control pin drive mode dependant 2 mA Table 7 Pin characteristics 2 6 TX power vs current consumption The following tables contains the typical TX power values and the corresponding typical average current for 3 6V supply voltage and 25 C ambient temperature Cable loses of the conducted measurement are about 2d...

Page 16: ... 93 182 3 7 8 96 182 3 8 8 89 182 27 9 8 88 182 22 10 8 81 182 29 11 8 86 182 2 12 8 88 182 17 13 8 89 182 18 14 8 92 182 2 15 8 93 182 11 Table 8 TX power vs current consumption conducted measurement of continuous data transmission rate 1Mbps DSSS Calypso reference manual version 1 2 April 2019 www we online com wireless connectivity 15 ...

Page 17: ... 80 101 73 7 5 83 101 29 8 4 93 100 84 9 3 93 100 59 10 2 88 100 30 11 1 98 100 18 12 1 09 100 02 13 0 75 100 14 0 73 100 15 0 64 100 Table 9 TX power vs current consumption conducted measurement of continuous data transmission rate 54Mbps OFDM Calypso reference manual version 1 2 April 2019 www we online com wireless connectivity 16 ...

Page 18: ...APP_MODE_1 RESERVED GND CTS RTS WAKE_UP UTXD URXD RESERVED GND GND RESERVED RESERVED RESERVED RESERVED RESERVED RESERVED RESERVED RESERVED RESERVED RESERVED GND RESERVED GND BOOT Figure 2 Pinout top view Calypso reference manual version 1 2 April 2019 www we online com wireless connectivity 17 ...

Page 19: ...section 5 2 do not connect if not needed 11 APP_MODE_1 Input internal weak pull down see section 5 2 do not connect if not needed 12 GPIO30 Unused output LOW do not connect if not needed 13 GND Negative supply voltage No Function Description 14 GND Negative supply voltage 15 UTXD Module UART TX 16 URXD Module UART RX internal weak pull up 17 GPIO3 Unused output LOW do not connect if not needed 18 ...

Page 20: ...ct if not needed 28 GPIO16 Unused output LOW do not connect if not needed 29 GPIO17 Unused output LOW do not connect if not needed 30 JTAG_TDI Debug line locked do not connect 31 JTAG_TDO Debug line locked do not connect 32 JTAG_TCK Debug line locked internal pull down do not connect 33 JTAG_TMS Debug line locked do not connect 34 GND Negative supply voltage Table 10 Pinout Calypso reference manua...

Page 21: ...F signal on pin RF of the module In this configuration pin ANT of the module has to be connected to ground and pin RF to the external antenna via 50Ω feed line Refer to chapter 16 for further information 4 2 Minimal pin configuration The following pins must be connected as described in table 11 for correct operation The remaining can be left unconnceted Pin Number Pin Function Pin connection 1 ANT...

Page 22: ...d stable behavior independent of battery status The typical time for t is in the order of 1 second An additional 1 1 seconds typical delay is introduced on first boot due to extended calibration e g after a firmware update Upon hard reset the firmware integrity check will add further latency into t_boot Figure 3 Power up 4 4 Region specific WLAN settings Despite the world wide availability of the ...

Page 23: ...on 1 JP4 to select the USB bus as power supply 2 JP3 current bridge is set 3 Jumpers are set across pins 1 2 URXD 3 4 UTXD 9 10 STATUS_IND_0 11 12 STATUS_IND_1 13 14 WAKE_UP and 15 16 BOOT of the connector JP1 4 For this example the AT command terminal mode is used and hence the two AP P_MODE_x pins shall be connected to VCC On the Calypso EV board this can be done by connecting pin 12 and 13 on C...

Page 24: ...correct driver installation the EV board appears as a virtual COM port 3 Open an instance of the serial port emulator with COM port settings 921600 baud 8e1 for each WLAN module connected to the PC via USB 4 On pressing the Reset button the start up message appears on the terminal with the product article number chipID MAC address and the current software version Calypso reference manual version 1...

Page 25: ...ss for module B and note the two different IP addresses assigned to the modules In the current example the modules have the following addresses Module MAC Address IP Address Role A 0xc8 0xfd 0x19 0x05 0x54 0xb4 192 168 1 168 TCP server B 0xc8 0xfd 0x19 0x05 0x74 0x98 192 168 1 140 TCP client Table 12 Quick start addresses and roles The MAC addresses are unique to every module and the IP address is...

Page 26: ...nnection a connect event is returned with the server address and port 4 5 8 Data transfer 1 On the server side the connection has to be accepted with a command AT accept 0 INET OK accept 1 inet 60108 192 168 1 140 OK The accept command returns the port and the IP address of the current client as well as the new socket ID generated for communication with this client 2 At this stage the modules are ...

Page 27: ...5 Receiving the message at A AT recv 1 0 5 OK recv 1 0 5 hello OK Calypso reference manual version 1 2 April 2019 www we online com wireless connectivity 26 ...

Page 28: ... to configure and exploit its rich features through an easy to use command interface over UART Feature Description Radio standards 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...

Page 29: ...ransition 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 Reset signal WAKE_UP signal or time event Figure 5 Modes of operation Calypso reference manual version 1 2 April 2019 www we online com wireless connectivity 28 ...

Page 30: ... 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 user can conveniently browse the settings web page and configure the module using any web browser More details towards provisioning...

Page 31: ... UART interface with the following parameters Parameter Range Standard Baud 115200 to 3000000 921600 Data bits 8 8 Stop bits 1 1 Parity none odd even even Flow control none RTS CTS none Table 15 Application modes The configuration of the UART in factory state is 921600 baud with data format of 8 data bits even parity and 1 stop bit 8e1 The baud rate and the parity of the UART can be configured usi...

Page 32: ...priority For this reason short interruptions may occur between the outputs of successive bytes The host must not implement a strict timeout between two bytes to be able to receive packets that have inter ruptions in between Up to four full byte durations 32 bit delay between two successive bytes shall be accepted by the host For the direction host to module the host must respect byte wise the line...

Page 33: ...er data can be binary as well as Base64 7 1 Command types There are three types of messages exchanged between the calypso and the host Requests The host requests the module to perform an action or start an operation All Requests start with the AT tag and end with r n hex 0x0D0A Confirmations On each request the module answers with a confirmation message to give a feedback on the requested operatio...

Page 34: ...each represented as X X X X X can range from 0 up to 255 the is used as delimiter per 8 bit IPv6 address Four hexadecimal numeric values of 32 bit each represented as X X X X X can range from 0x00000000 up to 0xFFFFFFFF the is used as delimiter per 32 bit Bitmask parameters are represented using delimiter e g x y Data should be either binary or Base64 format binary to text encoding Further details...

Page 35: ...te effectively switching off the radio resulting in loss of all on going transmissions and connections A time out can be specified to allow the network processor to gracefully disconnect before shutting down Request Response AT start OK or error code Arguments Arguments None None Table 16 AT start Request Response AT stop timeout OK or error code Arguments Arguments Timeout in milliseconds 0 Hiber...

Page 36: ...this command whenever possible instead of hard reset a falling edge on the Reset pin 8 1 4 Factory reset The factory reset command restores the module to factory state All files stored in the file system will be reverted to factory state New files that were added will be deleted The network processor settings including MAC address will be restored to factory state Request Response AT factoryreset ...

Page 37: ...r a time period specified in the sleep command Alternatively the module can be woken up manually with a rising edge on the WAKE_UP pin On wake up the module starts from the reset vector Request Response AT sleep timeout OK or error code Arguments Arguments Timeout in seconds min 1 max 86400 24 hrs None Table 21 AT sleep 8 1 6 Get The generic get command can be used to read the device parameters in...

Page 38: ...AILED netapp value1 bitmask IPACQUIRED IPACQUIRED_V6 IP_LEASED IP_RELEASED IPV4_LOST IP_COLLISION IPV6_LOST general version chip ID FW version X X X X PHY version X X X X NWP Version X X X X fprov ROM version time hh mm ss dd mm yyyy persistent 1 enable 0 disable IOT UDID 16 byte UDID UART baudrate baudrate parity 0 none 1 even 2 odd Table 22 AT get 8 1 7 Set The generic get command can be used to...

Page 39: ...cess 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 The AP mode is primarily intended for device provisioning and can support up to 4 stations Inherently the AP mode consumes higher currents and is therefore not suitable for battery powered applications Request Response AT wlanSetMode ...

Page 40: ...e index or error code Arguments Arguments Index starting index 0 29 Each device has the following parameters listed count number of device max 30 SSID BSSID Channel Security type hidden_ssid_enanled 0 or 1 cipher key_management_method 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 h...

Page 41: ...se WPA_ENT was not selected TLS TTLS_TLS TTLS_MSCHAPv2 TTLS_PSK PEAP0_TLS PEAP0_MSCHAPv2 PEAP0_PSK PEAP1_TLS PEAP1_PSK Table 26 AT wlanConnect A manual disconnect from an existing connection is done using the following command Request Response AT wlanDisconnect OK or error code Table 27 AT wlanDisconnect 8 2 4 Profiles Calypso allows the user to store up to seven preferred networks as profiles Bas...

Page 42: ..._ENT was not selected SecurityExtEapMethod Extensible Authentication Protocol Ignored in case WPA_ENT was not selected TLS TTLS_TLS TTLS_MSCHAPv2 TTLS_PSK PEAP0_TLS PEAP0_MSCHAPv2 PEAP0_PSK PEAP1_TLS PEAP1_PSK Profile priority 0 15 highest Table 28 AT wlanProfileAdd Request Response AT wlanProfileGet index wlanProfileGet Profile index or error code Arguments Arguments Index profile index 0 6 SSID ...

Page 43: ...old SUSPEND_PROFILES Suspend profile bit mask DISABLE_ENT_SERVER_AUTH 0 or 1 1 disable server auth when manually connecting to an enterprise network P2P CHANNEL_N_REGS value1 Listen channel 1 6 11 val ue2 Listen regulatory class 81 value3 operating channel 1 6 11 value4 operating regulatory class 81 AP SSID String up to 32 charecters CHANNEL Channels 1 11 HIDDEN_SSID 0 disabled 1 send empty SECURI...

Page 44: ...several profiles with same priority the decision is made based on security type WPA2 WEP OPEN In case of same security type the one with the highest signal strength is chosen to be connected Fast The device tries to connect to the last connected AP without transmitting a probe request AnyP2P The device connect to the first available Wi Fi direct device Scan In additional to the one shot scan calyp...

Page 45: ...s begins after a successful WLAN connection is established AP and Wi Fi direct modes start with a static address assigned to the module with a DHCP server available on board IPv4 Stateful with Stateless fallback In this mode the device waits for an IPv4 address from a DHCP server On time out the LLA address is used The LLA IP addressess are in the range 169 254 1 0 to169 254 254 255 Stateful DHCPv...

Page 46: ...ties it is recommended not to enable IPv6 addressing in power critical applications Wi Fi Station Wi Fi AP Wi Fi Direct IPv4 Always enabled static client like station GO like AP one address DHCP LLA Static IPv6 disabled not supported not supported two addresses Local Stateless Statefull Static Global Stateless S tatefull Static Table 35 IP addresses Calypso reference manual version 1 2 April 2019 ...

Page 47: ...OFF value2 subnet mask RELEASE_IP_SET value3 Default gateway DHCP value4 DNS IPV6_ADDR_LOCAL STATIC IP address STATELESS STATEFUL IPV6_ADDR_GLOBAL STATIC value1 IP address STATELESS value2 DNS IP STATEFUL IPV4_DNS_CLIENT Secondary DNS Table 36 AT NetCfgSet Request Response AT netCfgGet configID netCfgGet option value1 valueX Arguments Arguments GET_MAC_ADDR Mac address IPV4_STA_ADDR or IP_AP_ADDR ...

Page 48: ...etwork entities without establishing a connection This results in minimal connection latency but cannot ensure data integrity or packet order Connection oriented socket Stream sockets establish a connection between two en tities before data exchange there by ensuring data integrity and packet order 8 4 1 1 TCP socket A TCP socket a connection oriented socket creates a bi directional connection bet...

Page 49: ... 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 SSL TLS protocols provides features like end to end encryption and authentication to ensure secure communication between network peers A sequence of messages are exchanged between a TCP client and server leadi...

Page 50: ...set of well known trusted root CAs see appendix C 8 4 3 Socket operations In this section the AT commands used to perform various operations on a socket is de scribed A socket can be created using the command AT socket and the socket descriptor socketID returned by this command can be used to perform all the other socket operations Socket select command allows monitoring multiple sockets and trigg...

Page 51: ...Table 39 AT close close a socket Request Response AT bind socketID family localPort localAddress OK or error Arguments socketID socket descriptor family INET or INET6 localPort Local port localAddress Local IP address Table 40 AT bind Request Response AT listen socketID backlog OK or error Arguments socketID socket descriptor backlog max length of connect request queue Table 41 AT listen Calypso r...

Page 52: ...ET or INET6 Table 43 AT accept Request Response AT select nfds readsds timeout sec timeout usec select readfs or error Arguments nfds The highest numbered file descriptor in any of the three sets read write or accept readfs socket descriptors as bitlist 0 2 to monitor 0 and 2 timeout sec Time elapsed before select returns in sec timeout usec Time in microseconds Table 44 AT select 8 4 4 Socket set...

Page 53: ...disable SECMETHOD Sets security method to TCP socket value1 SSLV3 TLSV1 TLSV1_1 TLSV1_2 SS LV3_TLSV1_2 highest possible SECURE_MASK Set specific ci phers as bit mask default all ci phers value1 cipher type see table 47 SECURE_FILES_CA _FILE_NAME Map secured socket to CA file by name value1 absolute file path SECURE_FILES_PRIVATE_ KEY_FILE_NAME Map se cured socket to private key by name value1 abso...

Page 54: ..._WITH_RC4_128_SHA TLS_RSA_WITH_AES_128_CBC_SHA256 TLS_RSA_WITH_AES_256_CBC_SHA256 TLS_ECDHE_RSA_WITH_AES_128_CBC_SHA256 TLS_ECDHE_ECDSA_WITH_AES_128_CBC_SHA256 TLS_ECDHE_ECDSA_WITH_AES_128_CBC_SHA TLS_ECDHE_ECDSA_WITH_AES_256_CBC_SHA TLS_RSA_WITH_AES_128_GCM_SHA256 TLS_RSA_WITH_AES_256_GCM_SHA384 TLS_DHE_RSA_WITH_AES_128_GCM_SHA256 TLS_DHE_RSA_WITH_AES_256_GCM_SHA384 TLS_ECDHE_RSA_WITH_AES_128_GCM...

Page 55: ...ands described in this section Request Response AT recv socketID format length recv socketID length data or error Arguments socketID socket descriptor format data format 0 binary 1 base64 binary to text encoding length Max number of bytes to receive Table 49 AT recv The module allocates memory for data reception depending on the length field of the receive command If not enough memory can be alloc...

Page 56: ...Table 50 AT recvFrom The module allocates memory for data reception depending on the length field of the receive command If not enough memory can be allocated an error is returned We recommend to use a maximum length field of 1460 Request Response AT send socketID format length data OK or error Arguments socketID socket descriptor format data format 0 binary 1 base64 binary to text encoding length...

Page 57: ...content in the radio module s file system is limited to the available capacity in the file system itself The file system can only be accessed through AT commands File system on one module cannot be read by another this prevents cloning of sFlash Built in tamper detection detects corrupt files and warns the user of unauthenticated file access Each file has a minimum size of 4096 bytes Fail safe 819...

Page 58: ...WP when performing a file operation Care needs to be taken to have a clean and stable supply voltage especially during flash writes in a battery powered applications A drop in voltage during a erase cycle may lead to corruption of the file system 8 5 1 File system operations Calypso reference manual version 1 2 April 2019 www we online com wireless connectivity 57 ...

Page 59: ...en_write open_read must_commit bundle_file pending_commit pending_bundle_commit not_failsafe not_valid sys_file secure nosignature public_write public_read fileBlocksAlloc Allocated blocks Table 53 AT FileGetFileList 8 5 2 File operations In this section the file operation commands are described Calypso reference manual version 1 2 April 2019 www we online com wireless connectivity 58 ...

Page 60: ...CREATE_VENDOR_TOKEN for secure files only CREATE_PUBLIC_WRITE for secure files only CREATE_PUBLIC_READ for secure files only fileSize Max file size in bytes mandatory for CREATE option Table 54 AT fileOpen Please note that the maximum file name length is 180 bytes Request Response AT fileClose fileID certificateFileName signature OK or error Arguments fileID ID assigend from AT FileOpen certificat...

Page 61: ...teCounter or error Arguments FileName Full path to file secureToken Token assigend from AT FileOpen optional Table 57 AT fileGetInfo Request Response AT fileRead fileID offset format length FileRead format numberOfReadBytes data or error Arguments fileID ID assigned from AT FileOpen offset Offset to specific read block Format 0 binary 1 Base64 Length Number of bytes to read Table 58 AT fileRead Ca...

Page 62: ...is a distributed device service discovery protocol used for resolving IP addresses and ports on an IP network In contrast to standard DNS mDNS protocol is distributed where each device can join an IP multicast group and advertise its services Both IPv4 and IPv6 are supported with addresses 224 0 0 251 FF02 FB and UDP port 5353 are reserved for mDNS messages Each module can register to up to five s...

Page 63: ...ry The module tries to connect to the servers in order of the stored address index The time zone has to be set manually In order to avoid overload on the SNTP server a configurable minimum update interval can be specified SNTP client is disabled by default Request Response AT netAPPGet AppID option netAPPGet value or error Arguments AppID sntp_client Options enable value 0 disabled 1 enabled updat...

Page 64: ...e time with SNTP server 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 Request Response AT HttpCreate Ht...

Page 65: ...e key full path optional certificate full path optional ca full path optional Table 67 AT HttpConnect Request Response AT HttpDisconnect index OK or error Arguments index client handle Table 68 AT HttpDisconnect Request Response AT HttpSetProxy family port address OK or error Arguments family INET or INET6 port proxy server port address proxy server address Table 69 AT HttpSetProxy Calypso referen...

Page 66: ... AT HttpReadResBody index format length HttpReadResBody index flag format length body Arguments Arguments index client handle index client handle format request format 0 Bin 1 Base64 flag 0 data end 1 more data available length request data length length length of returned data body received data Table 71 AT HttpReadResBody Request Response AT HttpSetHeader index option flags format length data OK...

Page 67: ...req_if_modified_since req_if_none_match req_if_range req_if_unmodified_since req_origin req_proxy_auth req_range req_te req_tx_encoding req_upgrade req_user_agent req_via req_warning Table 74 HTTP header options The module allocates memory for user data read depending on the length field specified in the above commands If not enough memory can be allocated an error is returned We recommend to use ...

Page 68: ...hod SSLV3 TLSV1 TLSV1_1 TLSV1_2 TLSV1_1 SSLV3_TLSV1_2 mandatory if sec flag cipher cipher type see table 47 optional private key Full path to key file optional certificate Full path to certificate optional CA Full path to CA optional DH key Full path to Diffie Hellman key optional protocol v3_1 MQTT version 3 1 v3_1_1 MQTT version 3 1 1 blocking send 0 do not wait for server response 1 wait for se...

Page 69: ...Arguments index client handle topic topic string QOS QOS0 QOS1 QOS2 retain 0 do not retain 1 retain message length max 1460 message payload Table 79 AT MqttPublish Request Response AT mqttSubscribe index number of Topics topic1 QoSn reserved1 topicX QoSn reservedX OK or error Arguments index client handle number of topics max 4 topic topic string QOS QOS0 QOS1 QOS2 reserved leave empty Table 80 AT...

Page 70: ...ents index client index option value user username string password password string will topic QOS retain Message Length message keepalive value in seconds clean 0 persistent connection 1 clean connection Table 82 AT MqttSet 8 6 5 Ping Calypso supports ping network utility based on the standard ICMP protocol Both IPv4 and IPv6 are supported This utility can be used to test connectivity and round tr...

Page 71: ... of pings to send 0 forever flag 0 report once all pings are done 1 report after every ping 2 Stop after first successful ping Table 83 AT netAPPPing 8 7 Events The host can receive an indication of specific states through events or errors Asynchronous events can be sent to the host at any given time with an indication of specific states and specific data for each event 8 7 1 General events The ge...

Page 72: ...wlan netcfg netapp security error value1 Code value2 Software module other wlan netcfg netapp security Table 84 eventgeneral event 8 7 2 WLAN events The WLAN event may be received in relation to a WLAN connection Calypso reference manual version 1 2 April 2019 www we online com wireless connectivity 71 ...

Page 73: ...lue3 Reason see chapter B 1 value4 GO device name p2p_client_added value1 MAC value2 GO device name value3 Own SSID p2p_client_removed value1 MAC value2 GO device name value3 Own SSID p2p_devfound value1 GO device name value2 MAC value3 WPS p2p_request value1 GO device name value2 MAC value3 WPS p2p_connectfail value1 Status disconnected scaning connecting connected Table 85 eventwlan event Calyps...

Page 74: ...sioning status value2 Role value3 Status disconnected scaning connecting connected value4 SSID provisioning_profile_added value1 Provisioning status value2 SSID Table 86 eventwlan event Calypso reference manual version 1 2 April 2019 www we online com wireless connectivity 73 ...

Page 75: ...Status async_event value1 SD value2 Type ssl_accept rx_frag_too_big other_side_close_ssl connected_secured wrong_root_ca value4 SSID value3 Value Table 87 eventsocket event 8 7 4 NetApp events The NetApp event may be received in relation to network processor operation Calypso reference manual version 1 2 April 2019 www we online com wireless connectivity 74 ...

Page 76: ...ue1 Address value2 Lease time value3 BSSID dhcpv4_released value1 Address value2 BSSID value3 Reason ipv4_lost value1 Status dhcp_ipv4_acquire_timeout value1 Status ipv6_lost value1 IP lost Table 88 eventnetapp event 8 7 5 MQTT events The MQTT event may be received in relation to one of the MQTT operations performed by the module Calypso reference manual version 1 2 April 2019 www we online com wi...

Page 77: ... Failure Unsuback value2 Packet ID recv value1 Topic value2 QoS value3 Retain 0 not retain 1 retain value4 Duplicate 0 new 1 duplicate value5 Data format 0 bin 1 Base64 value6 Data length value7 Data disconnect Table 89 eventmqtt event 8 7 6 Fatal error events The fatal error event may be received in case of device malfunction Event eventfatalerror ID value1 valueX ID Values device_abort value1 Co...

Page 78: ... pins APP_MODE_0 and APP_MODE_1 can be used to define the application mode as described in chapter 5 2 1 To do so ap ply a LOW signal to the APP_MODE_0 pin a HIGH signal to the APP_MODE_1 pin and restart the module When the provisioning mode has been started successfully the LED at STATUS_IND_1 flashes with interval of 1s The module has created an access point with a SSID calypso_ followed by by t...

Page 79: ...ebsite in order to perform the provisioning operation on the WLAN module Figure 10 Provisioning main page Click on the Settings button to open the settings menu Several tabs are available to read the current status of the radio module and to configure it To save a WLAN profile in the radio module go to the Profiles tab and enter the credentials of the access point the radio module is supposed to c...

Page 80: ...t is defined in the mod ule s profiles Thus after adding the profile to the module a restart has to be performed To do so send a AT reboot or press the reset button Please make sure that the application mode pins APP_MODE_0 and AP P_MODE_1 are set correctly when restarting the device After restarting in AT command mode the module automatically connects to the pre defined AP eventwlan connect Calyp...

Page 81: ...4 5 5 In this example the modules have the IP addresses 192 168 1 169 and 192 168 1 140 10 1 2 UDP socket communication 1 Create a UDP socket using the following command Note the socket ID returned for use in future commands in this case 0 AT socket INET DGRAM UDP socket 0 OK 2 Although the bind on a UDP socket is optional it is essential here to know the desti nation port to send to at the peer i...

Page 82: ...le the modules have the IP addresses 192 168 1 169 SSL TLS client and 192 168 1 140 SSL TLS server 10 3 1 Create an SSL TLS server The module with IP address 192 168 1 140 is configured as SSL TLS server 1 Create a simple TCP socket with the following command Note the socket ID for future reference AT socket INET STREAM TCP socket 0 2 The next step is to upgrade the socket to secure by updating th...

Page 83: ...K 5 The connect event will show up once the server has accepted the connection request as described in the next section connect 9999 192 168 1 140 OK 10 3 3 Secure data transfer 1 The conncetion request from the client has to be accepted by the server Note the socket ID generated by the server for this client AT accept 0 INET OK 2 The accept event will show up on the server side once the server ha...

Page 84: ...g 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 1 Two Calypso evaluation boards 2 Computer with a serial terminal emulator like Tera Term 10 4 2 Auto connection setup F...

Page 85: ...ers 10 1 and 10 2 to do so After data has been transmitted received the connection can be closed again AT wlandisconnect 10 4 3 Manual connection setup This chapter describes how to set up a P2P connection between two Calypso radio mod ules The goal is to establish a connection to the client module B initiated by the group owner module A First of all the P2P settings of module A has to be configur...

Page 86: ... refer to the chapters 10 1 and 10 2 to do so After data has been transmitted received the connection can be closed again AT wlandisconnect 10 5 Running a web page on the radio module The Calypso radio module offers a secure file system to store files in the radio module In combination with the HTTP S server function a custom web site can be run on the module This chapter describes how to do so by...

Page 87: ...and the file data itself AT FileWrite 1966156880 0 0 104 html head t i t l e Simple web page t i t l e head body div This i s a simple webpage div body html f i l e w r i t e 104 OK After the transmission of the data to the radio module has been finished the file access must be closed by an AT FileClose command AT FileClose 1966156880 OK More complex websites can be analogously put to the secure f...

Page 88: ... to access the wireless network Therefore type AT wlanset AP SSID mySSID OK AT wlanset AP password mypassword OK Next we would like to use our own domain mywebpage net AT NetAppSet DEVICE DOMAIN mywebpage net OK Finally restart the network processor AT stop 0 OK AT s t a r t eventnetapp ipv4_acquired 10 123 45 1 10 123 45 1 0 0 0 0 OK Now connect with your PC or smart phone to the WLAN of the Caly...

Page 89: ...Figure 13 Test page Please note that the radio module provides up to 4 connections in AP mode Calypso reference manual version 1 2 April 2019 www we online com wireless connectivity 88 ...

Page 90: ...t up time 11 2 Soft reset A software reset is made available through the AT command AT reboot see section 8 1 In this case the module restarts from the reset vector The exact same process happens after a wake up signal from sleep mode Description Typ Unit Ready after reboot wake up 350 ms Table 92 Start up after reboot It is recommended to use the AT command to reboot the device instead of a falli...

Page 91: ...dule It can be any device with a browser supporting self signed HTTPS content and JavaScript It is recommended to use the Chrome browser with JavaScript enabled The self signed certificate triggers a security error on the browser Please trust the certificate and proceed to the OTA website 4 The device used for updating the radio module shall have the compressed and en crypted firmware image for th...

Page 92: ...owing the module tries to ping the gateway During this procedure the STATUS_IND_1 LED blinks at 1 Hz As soon as the pinging has been completed the STATUS_IND_1 LED stays solid eventota info Pinging gateway please wait eventota info Ping completed eventota info Waiting f o r new ota upload The message Waiting for new ota upload indicates that the module is successfully con nected to the network and...

Page 93: ... stored and select the same Click on upload file to start the update process During update the module outputs the OTA states on the UART In this state the STATUS_IND_1 LED blinks at 2 Hz Using browsers other than Chrome the progress bar is found to not update correctly In this case refresh the page manually Calypso reference manual version 1 2 April 2019 www we online com wireless connectivity 92 ...

Page 94: ...Figure 15 OTA webpage upload Figure 16 OTA in progress Calypso reference manual version 1 2 April 2019 www we online com wireless connectivity 93 ...

Page 95: ...e boot up after an OTA update may require additional time up to 60 seconds in compar ison to a normal boot up In the browser click on finalize to complete the OTA process After this step the ota html shall show the new firmware version A module reconfiguration via AT commands or Provisioning is required after the firmware update Figure 17 Finalize OTA Calypso reference manual version 1 2 April 201...

Page 96: ...The table 93 lists the version of different components used for the current firmware version Known issues Command AT MqttSet does not work as expected It will be fixed in subsequent firmware versions Description Version SimpleLink SDK 2 20 00 10 Service pack sp_3 9 0 6_2 0 0 0_2 2 0 6 NWP 3 9 0 6 MAC 2 0 0 0 PHY 2 2 0 6 ROM 0 Table 93 Version Calypso reference manual version 1 2 April 2019 www we ...

Page 97: ...This also results in a customer exclusive module with a unique ordering number An example for this level of customization are functions like host less operation where the module will perform data generation e g by reading a SPI or I2 C sensor and cyclic trans mission of this data to a data collector while sleeping or being passive most of the time Also replacing UART with SPI as host communication...

Page 98: ...omer firmware solution without a review and verification 14 4 Contact for firmware requests Please contact your local field sales engineer FSE or wireless sales we online com for quotes regarding this topics Calypso reference manual version 1 2 April 2019 www we online com wireless connectivity 97 ...

Page 99: ... application main power source interferences etc Frequently switching the module on and off especially with a slowly changing voltage level of the power supply can lead to erratic behavior in rare cases even as far as damaging the module or the firmware The use of an external reset IC can solve this matter and shall be considered especially in battery operated scenarios Elements for ESD protection...

Page 100: ... protrude as it is matched to sitting directly on top of a PCB Modules with integrated antennas should be placed with the antenna at the edge of the main board It should not be placed in the middle of the main board or far away from the edge This is to avoid tracks beside the antenna Filter and blocking capacitors should be placed directly in the tracks without stubs to achieve the best effect Ant...

Page 101: ...line The width W for a micro strip can Figure 20 Dimensioning the antenna feed line as micro strip be calculated using the following equation W 1 25 5 98 H e 50 r 1 41 87 Tmet 1 Example A FR4 material with εr 4 3 a height H 1000 µm and a copper thickness of Tmet 18 µm Calypso reference manual version 1 2 April 2019 www we online com wireless connectivity 100 ...

Page 102: ...binet As a rule of thumb a minimum distance of λ 10 which is 3 5 cm 868 MHz and 1 2 cm 2 44 GHz from the antenna to any other metal should be kept Metal placed further away will not directly influence the behavior of the antenna but will anyway produce shadowing Keep the antenna away from large metal objects as far as possible to avoid electromagnetic field blocking The choice of antenna might hav...

Page 103: ...formance be achieved 15 3 3 PCB antenna PCB antenna designs can be very different The special attention can be on the miniaturiza tion or on the performance The benefits of the PCB antenna are their small not existing if PCB space is available costs however the evaluation of a PCB antenna holds more risk of failure than the use of a finished antenna Most PCB antenna designs are a compromise of ran...

Page 104: ...pecification Value Frequency range MHz 169 Impedance Ω 50 VSWR 2 1 Gain dBi 1 Dimensions L x d mm 320 x 15 Weight g 42 Connector SMA plug Operating Temp C 40 85 This antenna requires a ground plane which will influence the electrical param eters Calypso reference manual version 1 2 April 2019 www we online com wireless connectivity 103 ...

Page 105: ... 50 VSWR 1 5 Polarization Vertical Radiation Omni Gain dBi 0 Antenna Cover TPEE Dimensions L x d mm 90 x 12 Weight g 9 6 Connector SMA plug Operating Temp C 40 80 This antenna requires a ground plane which will influence the electrical param eters Calypso reference manual version 1 2 April 2019 www we online com wireless connectivity 104 ...

Page 106: ... 2600130081 antenna can be also used for 902MHz 928MHz range Specification Value Center frequency MHz 868 Frequency range MHz 853 883 Wavelength 0 5 wave VSWR 2 0 Impedance Ω 50 Connector SMA Male Dimensions L x d mm 142 x 10 Peak gain dBi 2 3 Operating temp C 30 80 Calypso reference manual version 1 2 April 2019 www we online com wireless connectivity 105 ...

Page 107: ...foot antenna with 1 5 m antenna cable The 2600130082 is a kind of λ 4 radiator and therefore needs a ground plane at the feeding point Specification Value Frequency range MHz 824 894 VSWR 2 0 Polarisation Vertical Impedance Ω 50 5 Connector SMA Male Dimensions L x d mm 89 8 x 27 Weight g 50 5 Operating temp C 30 60 Calypso reference manual version 1 2 April 2019 www we online com wireless connecti...

Page 108: ...n Linear Radiation Omni Directional Peak Gain dBi 2 8 Average Gain dBi 0 6 Efficiency 85 Dimensions L x d mm 83 1 x 10 Weight g 7 4 Connector SMA plug Operating temp C 40 80 Special care must be taken for FCC Certification when using this external antenna to fullfil the requirement of permanently attached antenna or unique coupling for example by using the certified dipol antenna in a closed housi...

Page 109: ...sign This is no discrepancy due to the fact that the evaluation board itself does not fall within the scope of the EU directive 2014 53 EU Annex I as the module is tested on the evaluation board which is also the recommended use Further information concerning the use of the evaluation board can be found in the man ual of the Calypso evaluation board Calypso reference manual version 1 2 April 2019 ...

Page 110: ...16 1 EV Board Figure 26 Reference design Schematic most important parts Calypso reference manual version 1 2 April 2019 www we online com wireless connectivity 109 ...

Page 111: ...Figure 27 Reference design Layout Calypso reference manual version 1 2 April 2019 www we online com wireless connectivity 110 ...

Page 112: ...lose up Layout Figure 29 Reference design Stack up Top layer is used for routing and filled up with ground except underneath the module and the antenna free area Calypso reference manual version 1 2 April 2019 www we online com wireless connectivity 111 ...

Page 113: ...nsceiver to the ANT_PAD the connection to the inside the module integrated antenna Placing 22pF for C1 not placing C13 C14 and C15 Through C1 connecting with a 50 Ω line a dipol antenna For the certification the antenna from 15 3 4 5 was used with peak gain of 2 8 dBi Special care must be taken when using an external antenna to fullfil the requirement for FCC Certification of permanently attached ...

Page 114: ... certificates via radio the OTA mode or Provisioning mode may be used To manually switch to OTA mode or provisioning mode we strongly recom mend to make the pins APP_MODE_0 and APP_MODE_1 accessible on the custom PCB Otherwise the update of expired HTTP server certificates and security patches cannot be applied to the radio module Calypso reference manual version 1 2 April 2019 www we online com w...

Page 115: ...s of the solder resist between the host PCB top side and the modules bottom side Only lead free assembly is recommended according to JEDEC J STD020 Profile feature Value Preheat temperature Min TS Min 150 C Preheat temperature Max TS Max 200 C Preheat time from TS Min to TS Max tS 60 120 seconds Ramp up rate TL to TP 3 C second max Liquidous temperature TL 217 C Time tL maintained above TL tL 60 1...

Page 116: ...mal mass of the entire populated PCB heat transfer efficiency of the reflow oven and the specific type of solder paste used Based on the specific process and PCB layout the optimal soldering profile must be adjusted and verified Other soldering methods e g vapor phase have not been verified and have to be validated by the customer at their own risk Rework is not recommended Time Temperature Tp tp ...

Page 117: ...r every pad to the host PCB even if some are unused to improve the mechanical strength of the module The part is sensitive to ultrasonic waves as such do not use ultrasonic cleaning weld ing or other processing Any ultrasonic processing will void the warranty 17 3 ESD handling This product is highly sensitive to electrostatic discharge ESD As such always use prop er ESD precautions when handling M...

Page 118: ...assem bling the product is not allowed Evidence of tampering will void the warranty Compliance with the instructions in the product manual is recommended for correct product set up The product must be provided with a consolidated voltage source The wiring must meet all applicable fire and security prevention standards Handle with care Avoid touching the pins as there could be ESD damage Be careful...

Page 119: ...sical dimensions 18 1 Dimensions Dimensions 19 27 5 3 mm Table 96 Dimensions 18 2 Weight Weight 3 g Table 97 Weight Calypso reference manual version 1 2 April 2019 www we online com wireless connectivity 118 ...

Page 120: ...drawing 18 0 6 1 1 5 12 0 0 9 7 6 16 5 27 5 0 4 1 05 19 0 0 4 1 1 5 13 14 22 23 34 3 0 0 2 Figure 32 Module dimensions mm Calypso reference manual version 1 2 April 2019 www we online com wireless connectivity 119 ...

Page 121: ...Footprint 1 5 12 0 18 0 16 5 0 9 2 05 20 0 3 9 12 5 5 2 6 1 12 5 1 5 no metal Figure 33 Footprint and dimensions mm Calypso reference manual version 1 2 April 2019 www we online com wireless connectivity 120 ...

Page 122: ...ined As rule of thumb a minimum distance of metal parts to the antenna of λ 10 should be kept see figure 33 Even though metal parts would influence the characteristic of the antenna but the direct influence and matching keep an acceptable level Calypso reference manual version 1 2 April 2019 www we online com wireless connectivity 121 ...

Page 123: ...024 V12 2 122 4 Date code 4 digits 1703 week 03 in year 2017 1816 week 16 in year 2018 5 Firmware version 3 digits V3 2 302 V5 13 513 Table 98 Lot number details As the user can perform a firmware update the printed lot number only shows the factory delivery state The currently installed firmware can be requested from the module using the corresponding product specific command The firmware version...

Page 124: ...irst 1 to 3 digits represent the PID then the marks the start of the 6 digit counter to create a unique product marking In case of small labels the 3 byte manufacturer identifier 0x0018DA of the MAC address is not printed on the labels The 3 byte counter printed on the label can be used with this 0018DA to produce the full MAC address by appending the counter after the manufacturer identifier For ...

Page 125: ...nformation can be used The module itself is unfused The maximum output power of the module is 18dBm The total amount of capacitivity of all capacitors is 91 1µF The total amount of inductivity of all inductors is 15 4µH Calypso reference manual version 1 2 April 2019 www we online com wireless connectivity 124 ...

Page 126: ...ve 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 Calypso reference manual version 1 2 April 2019 www we online com wireless connectivity 125 ...

Page 127: ...pso 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 Following harmonized norms or technical specifications have been applied EN 300 328 V2 1 1 2016 11 EN 301 489 1 V2 2 0 Draft EN 301 489 17 V3 2 0 Draft EN 62479 2010 EN 62368 1 2014 AC 2015 A11 2017 Trier 31th of October 2018 Place ...

Page 128: ...ce L exploitation est autorisée aux deux conditions suivantes 1 l appareil ne doit pas produire de brouillage et 2 l utilisateur de l appareil doit accepter tout brouillage radioélectrique subi même si le brouillage est susceptible d en compromettre le fonctionnement 21 5 FCC and IC requirements to OEM integrators This module has been granted modular approval OEM integrators for host products may ...

Page 129: ...Equipment Manufacturer OEM must ensure that FCC labeling require ments are met This includes a clearly visible label on the outside of the final product Attaching a label to a removable portion of the final product such as a battery cover is not permitted The label must include the following text Contains FCC ID R7T1001102 The enclosed device complies with Part 15 of the FCC Rules Operation is sub...

Page 130: ... in chapter 15 3 4 5 It is only possible to connect an antenna by soldering It is mendatory to follow chapter 16 2 when connecting an antenna Special care must be taken when using an external antenna to fullfil the requirement of permanently attached antenna or unique coupling for example by using the certified dipol antenna in a closed housing so that only through professional installation it is ...

Page 131: ...ly eliminated in the current state of the art even if the products are operated within the range of the specifica tions The same statement is valid for all software and firmware parts contained in or used with or for products in the wireless connectivity product range of Würth Elektronik eiSos GmbH Co KG In certain customer applications requiring a high level of safety and espe cially in customer ...

Page 132: ...arge about the current product availability expectancy before or when the product for application design in disposal is con sidered The approach named above does not apply in the case of individual agreements deviating from the foregoing for customer specific products 22 7 Property rights All the rights for contractual products produced by Würth Elektronik eiSos GmbH Co KG on the basis of ideas de...

Page 133: ... applicable legal regulation s 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 Custom...

Page 134: ...ktronik eiSos GmbH Co KG must be informed about the intent of such usage before the design in stage In addition sufficient reliability evaluation checks for safety must be performed on every electronic component which is used in electrical circuits that require high safety and reliability function or perfor mance By using Würth Elektronik eiSos GmbH Co KG products the customer agrees to these term...

Page 135: ...es without prior written consent of Würth Elektronik eiSos You are not allowed to reproduce translate reverse engineer read out decompile disas semble or create derivative works of the incorporated Firmware in whole or in part No more extensive rights to use and exploit the Firmware granted to you 24 2 Usage and obligations The responsibility for the applicability and use of the Würth Elektronik e...

Page 136: ...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 another software 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 T...

Page 137: ... void this shall not affect the remaining provisions of the agreement The parties shall replace any such provisions with new valid provisions that most closely approximate the purpose of the agreement 24 9 Miscellaneous This license agreement constitutes the entire understanding and merges all prior discussions between the parties relating to this license agreement No ancillary verbal agreements h...

Page 138: ...01102500x Model Number Calypso Product Wurth Elektronik eiSos GmbH CO KG Company January 22 2019 Date of Last Certification Page 1 of 2 Certification ID WFA81685 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 Summary of Certifications PROGRAM Wi...

Page 139: ...RTIFIED g Wi Fi CERTIFIED n 2 4 GHz 1 Spatial Stream 2 4 GHz Short Guard Interval Greenfield Preamble Wi Fi Direct 2 4 GHz WMM Wi Fi Protected Setup 2 4 GHz PIN Push Button PBC Page 2 of 2 Certification ID WFA81685 Wi Fi CERTIFIED Interoperability Certificate Calypso reference manual version 1 2 April 2019 www we online com wireless connectivity 138 ...

Page 140: ...SCONNECT_UNSUPPORTED_RSN_VERSION 21 SL_WLAN_DISCONNECT_INVALID_RSN_CAPABILITIES 22 SL_WLAN_DISCONNECT_IEEE_802_1X_AUTHENTICATION_FAILED 23 SL_WLAN_DISCONNECT_CIPHER_SUITE_REJECTED 24 SL_WLAN_DISCONNECT_DISASSOC_QOS 32 SL_WLAN_DISCONNECT_DISASSOC_QOS_BANDWIDTH 33 SL_WLAN_DISCONNECT_DISASSOC_EXCESSIVE_ACK_PENDING 34 SL_WLAN_DISCONNECT_DISASSOC_TXOP_LIMIT 35 SL_WLAN_DISCONNECT_STA_LEAVING 36 SL_WLAN_...

Page 141: ... 105L No buffer space available SL_ERROR_BSD_EOBUFF SL_ENOBUFS SL_ERROR_BSD_EISCONN 106L Transport endpoint i s already connected SL_ERROR_BSD_ENOTCONN 107L Transport endpoint i s not connected SL_ERROR_BSD_ETIMEDOUT 110L Connection timed out SL_ERROR_BSD_ECONNREFUSED 111L Connection refused SL_ERROR_BSD_EALREADY 114L Non blocking connect in progress t r y again B 3 Secure socket error codes ssl t...

Page 142: ... i o n error SL_ERROR_BSD_ESECHANDSHAKETIMEDOUT 462L connection timed out due to handshake time SL_ERROR_BSD_ESECTXBUFFERNOTEMPTY 463L cannot s t a r t ssl connection while send buffer i s f u l l SL_ERROR_BSD_ESECRXBUFFERNOTEMPTY 464L cannot s t a r t ssl connection while recv buffer i s f u l l SL_ERROR_BSD_ESECSSLDURINGHANDSHAKE 465L cannot use while in hanshaking SL_ERROR_BSD_ESECNOTALLOWEDWHE...

Page 143: ...PILED_IN 674L Feature not compiled in SL_ERROR_BSD_ESEC_UNICODE_SIZE_E 675L Unicode password too big SL_ERROR_BSD_ESEC_NO_PASSWORD 676L no password provided by user SL_ERROR_BSD_ESEC_ALT_NAME_E 677L a l t name size problem too big SL_ERROR_BSD_ESEC_ASN_NO_SIGNER_E 688L ASN no signer to confirm f a i l u r e SL_ERROR_BSD_ESEC_ASN_CRL_CONFIRM_E 689L ASN CRL signature confirm f a i l u r e SL_ERROR_B...

Page 144: ... t e revoked SL_ERROR_BSD_ESEC_CRL_MISSING 762L CRL Not loaded SL_ERROR_BSD_ESEC_MONITOR_RUNNING_E 763L CRL Monitor already running SL_ERROR_BSD_ESEC_THREAD_CREATE_E 764L Thread Create Error SL_ERROR_BSD_ESEC_OCSP_NEED_URL 765L OCSP need an URL f o r lookup SL_ERROR_BSD_ESEC_OCSP_CERT_UNKNOWN 766L OCSP responder doesn t know SL_ERROR_BSD_ESEC_OCSP_LOOKUP_FAIL 767L OCSP lookup not successful SL_ERR...

Page 145: ...RROR_WLAN_AP_ACCESS_LIST_MODE_NOT_SUPPORTED 2181L Trying to switch to unsupported mode SL_ERROR_WLAN_AP_STA_NOT_FOUND 2182L t r y i n g to disconnect s t a t i o n which i s not connected B 5 Device error codes DEVICE ERRORS CODES SL_ERROR_SUPPLICANT_ERROR 4097L SL_ERROR_HOSTAPD_INIT_FAIL 4098L SL_ERROR_HOSTAPD_INIT_IF_FAIL 4099L SL_ERROR_WLAN_DRV_INIT_FAIL 4100L SL_ERROR_FS_FILE_TABLE_LOAD_FAILED...

Page 146: ..._FAILED_TO_WRITE_FILE 10251L SL_ERROR_FS_IMAGE_EXTRACT_FAILED_TO_OPEN_FILE 10252L SL_ERROR_FS_IMAGE_EXTRACT_FAILED_TO_GET_IMAGE_HEADER 10253L SL_ERROR_FS_IMAGE_EXTRACT_FAILED_TO_GET_IMAGE_INFO 10254L SL_ERROR_FS_IMAGE_EXTRACT_SET_ID_NOT_EXIST 10255L SL_ERROR_FS_IMAGE_EXTRACT_FAILED_TO_DELETE_FILE 10256L SL_ERROR_FS_IMAGE_EXTRACT_FAILED_TO_FORMAT_FS 10257L SL_ERROR_FS_IMAGE_EXTRACT_FAILED_TO_LOAD_F...

Page 147: ...NT_RETRIVE_ASYMETRIC_KEY_ERROR 10305L SL_ERROR_FS_OVERLAP_DETECTION_THRESHHOLD 10306L SL_ERROR_FS_FILE_HAS_RESERVED_NV_INDEX 10307L SL_ERROR_FS_FILE_MAX_SIZE_EXCEEDED 10310L SL_ERROR_FS_INVALID_READ_BUFFER 10311L SL_ERROR_FS_INVALID_WRITE_BUFFER 10312L SL_ERROR_FS_FILE_IMAGE_IS_CORRUPTED 10313L SL_ERROR_FS_SIZE_OF_FILE_EXT_EXCEEDED 10314L SL_ERROR_FS_WARNING_FILE_NAME_NOT_KEPT 10315L SL_ERROR_FS_M...

Page 148: ...ATION_TABLE 10362L SL_ERROR_FS_ILLEGAL_SIGNATURE 10363L SL_ERROR_FS_FILE_ALREADY_OPENED_IN_PENDING_STATE 10364L SL_ERROR_FS_INVALID_TOKEN_SECURITY_ALERT 10365L SL_ERROR_FS_NOT_SECURE 10366L SL_ERROR_FS_RESET_DURING_PROGRAMMING 10367L SL_ERROR_FS_CONFIG_FILE_RET_WRITE_FAILED 10368L SL_ERROR_FS_FILE_IS_ALREADY_OPENED 10369L SL_ERROR_FS_FILE_IS_OPEN_FOR_WRITE 10370L SL_ERROR_FS_ALERT_CANT_BE_SET_ON_N...

Page 149: ...0738L SL_ERROR_HTTP_SERVER_ENABLE_FAILED 30739L SL_ERROR_DHCP_SERVER_ENABLE_FAILED 30740L SL_ERROR_WPS_NO_PIN_OR_WRONG_PIN_LEN 30741L Calypso reference manual version 1 2 April 2019 www we online com wireless connectivity 148 ...

Page 150: ... Internet Network Information Center EV Certificates Root Cisco Root CA 2048 Class 2 Primary CA COMODO Certification Authority COMODO ECC Certification Authority COMODO RSA Certification Authority ComSign Global Root CA ComSign Secured CA Cybertrust Global Root D TRUST Root Class 3 CA 2 EV 2009 DigiCert Assured ID Root CA DigiCert Assured ID Root G2 DigiCert Assured ID Root G3 DigiCert Global Root...

Page 151: ...rlanden EV Root CA Staat der Nederlanden Root CA G2 Staat der Nederlanden Root CA G3 Starfield Class 2 Certification Authority Starfield Root Certificate Authority G2 Starfield Services Root Certificate Authority G2 StartCom Certification Authority G2 StartCom Certification Authority Swisscom Root CA 1 Swisscom Root CA 2 Swisscom Root EV CA 2 SwissSign Gold Root CA G3 SwissSign Platinum Root CA G3...

Page 152: ... Authority G4 VeriSign Class 3 Public Primary Certification Authority G5 VeriSign Class 4 Public Primary Certification Authority G3 VeriSign Universal Root Certification Authority Visa Information Delivery Root CA Calypso reference manual version 1 2 April 2019 www we online com wireless connectivity 151 ...

Page 153: ... 868 MHz magnet foot antenna with 1 5 m antenna cable 106 25 2 4 GHz dipole antenna 107 26 Reference design Schematic most important parts 109 27 Reference design Layout 110 28 Close up Layout 111 29 Reference design Stack up 111 30 Close up Schematic 112 31 Reflow soldering profile 115 32 Module dimensions mm 119 33 Footprint and dimensions mm 120 34 Lot number structure 122 List of Tables 1 Orde...

Page 154: ...nProfileAdd 41 29 AT wlanProfileGet 41 30 AT wlanProfileDel 41 31 AT wlanSet 42 32 AT wlanGet 43 33 AT wlanPolicySet 44 34 AT wlanPolicyGet 44 35 IP addresses 45 36 AT NetCfgSet 46 37 AT netCfgGet 46 38 AT socket create a socket 50 39 AT close close a socket 50 40 AT bind 50 41 AT listen 50 42 AT connect 51 43 AT accept 51 44 AT select 51 45 AT setSockOpt 52 46 AT setSockOpt continued 53 47 Suppor...

Page 155: ... 68 79 AT MqttPublish 68 80 AT MqttSubscribe 68 81 AT MqttUnsubscribe 69 82 AT MqttSet 69 83 AT netAPPPing 70 84 eventgeneral event 71 85 eventwlan event 72 86 eventwlan event 73 87 eventsocket event 74 88 eventnetapp event 75 89 eventmqtt event 76 90 eventfatalerror event 76 91 Start up time 89 92 Start up after reboot 89 93 Version 95 94 Classification reflow soldering profile Note refer to IPC ...

Page 156: ... Internet of Things more than you expect 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 ...

Reviews: