WE 2611086021011 Thetis-I USB Radio Stick User Manual

: June 6, 2024
: WE

Table of Contents

Revision history
Abbreviations and abstract
Introduction
- Ordering information
- WirepasTM technology
Functional description
- Typical Setup
- Taking into operation
  - Usage of CBUS pins
References
Regulatory compliance information
Important notes
Legal notice
License terms
Read User Manual Online (PDF format)
Download This Manual (PDF format)

THETIS-I USB RADIO STICK
USER MANUAL
2611086021011
VERSION 1.0

MARCH 22, 2021

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.

Revision history

Manual version	HW version	Notes	Date
1	1	• Initial version of the manual	Mar-21

Abbreviations and abstract

Abbreviation	Name	Description
API	Application Programming Interface
FSE	Field Sales Engineer	Support and sales contact person responsible for

Introduction

The Thetis-I is a radio module that provides wireless connectivity capabilities in the 2.4 GHz frequency band. The Thetis-I USB Radio Stick incorporates the Thetis-I in a USB stick form factor enabling easy interfacing with any USB enabled device like personal computer or laptop. That makes it particularly suitable to act as sink of the Wirepas Mesh network. The Thetis-I USB Radio Stick allows quick set-up of a radio link between PC and any system with integrated Thetis-I radio module.

Ordering information

WE order code	Description
2.61109E+12	Thetis-I USB Radio Stick

Table 1: Ordering information

WirepasTM technology

As an official partner of WirepasTM, Würth Elektronik eiSos is authorized to make commercial use of Wirepas firmware for the purposes of normal business.

Functional description

The Thetis-I USB Radio Stick consists of Thetis-I radio module along with a serial-to-USB adapter that enables direct connection to any USB compatible device. An FTDI serial-toUSB converter chip FT231X connects the USB interface to the UART pins of the integrated radio module. Besides UART, additional digital GPIO pins (CBUS) are connected to the radio module to provide special functions like reset. Figure illustrates all the functional components of Thetis-I USB Radio Stick.

Figure 1: Block diagram of the Thetis-I USB Radio Stick

Typical Setup

The Thetis-I USB Radio Stick offers the Wirepas Mesh API on its UART interface. Please refer to the Wirepas dual MCU manual [1] for the full documentation.

Two or more modules or USB radio sticks can communicate with each other if they share the same Wirepas network ID, channel and encryption as well as authentication keys. Based on the network configuration, data can be:

broadcast;
multicast to a group;
unicast to a specific module.

The role of the Thetis-I USB Radio Stick can be:

sink;
routing node;
non-routing node.

In the frame of the Wirepas EV-Kit and together with the PC tool Wirepas Commander [2], the USB radio stick can be used in a prototype Wirepas network consisting of the USB radio stick itself, a mini evaluation board, and three sensor nodes. Please refer to the Wirepas Evaluation Kit user manual: https://www.we-online.com/Man/EVAL-THETIS-I

Taking into operation

The serial-to-USB FTDI converter chip FT231X requires special drivers to be installed for proper operation. The Virtual COM Port (VCP) drivers have to be installed by following the “Installation Guides” found under: https://www.ftdichip.com/Drivers/VCP.htm

It is recommended to restart the PC after installation of drivers.
Please note that the FTDI drivers are not available for all platforms. We have tested Windows 10 x64 as well as Raspberry Pi 3B and 4B with Raspbian Buster.
On proper installation of the drivers, the module appears as a virtual COM port on the PC (ttyUSBx on Linux, COMx on Windows) in case of the VCP driver use. This COM port can be opened in any serial emulator program or user written software to communicate with the radio module. The radio module responds to commands in a specific format. Please refer to the corresponding Thetis-I user manual for the complete description of the command set.
When connecting the USB radio stick to the PC, it is recommended to reset the USB radio stick once. This can be done using the USB stick reset button or using the CBUS0 pin (see chapter ). This reset procedure is also recommended after each reboot of the PC.

Figure 2: Reset button on the Thetis-I USB Radio Stick

Usage of CBUS pins

To switch the CBUS pins static HIGH or LOW and thus to use the provided pins functions of the Thetis-I radio module, the D2XX driver of FTDI has to be used. This driver is part of the previous mentioned VCP driver installation in case of Windows OS. In case of Linux, a manual installation is required. Please follow FTDI’s “Installation Guides” for proper D2XX install: https://www.ftdichip.com/Drivers/D2XX.htm Example codes and tutorials for ¨how to use the D2XX driver within your own software tool¨ can be found in the software example section of: https://www.ftdichip.com/Support/SoftwareExamples/CodeExamples.htm

Resetting the Thetis-I USB Radio Stick using the CBUS pin
The /RESET pin of the Thetis-I can be used to reset the integrated radio module. As the /RESET pin is connected to the CBUS0 pin of the integrated FTDI chip, the radio module can be reset by pulling the CBUS0 pin low for at least 100ms and releasing it to high level again. By default, the CBUS0 pin of the FT231X is configured as P (bit bang), such that the FTDI D2XX driver function tt can be used.
/ prep: create and connect an FTDI device intance /
/ set CBUS0 to output level LOW / SetBitMode(0x10, FTDI.FT_BIT_MODES.FT_BIT_MODE_CBUS_BITBANG);
/ hold CBUS0 for at least 100ms on LOW level / wait_ms(100);
/ clear FTDI receive and send buffers / Purge(FTDI.FT_PURGE.FT_PURGE_RX | FTDI.FT_PURGE.FT_PURGE_TX);
/ set CBUS0 to output level HIGH / SetBitMode(0x00, FTDI.FT_BIT_MODES.FT_BIT_MODE_RESET);
/ a delay according to the reset timing parameter will occur (see manual) /
/ disconnect and close the FTDI device instance /
Code 1: Pin reset via CBUS0 using the D2XX driver

References

[1] Wirepas. Wirepas Mesh Dual-MCU API Reference Manual, WP-RM-100, version 5.1A. ttsP.
[2] Würth Elektronik. Wirepas Commander PC tool. tts rsr.

Thetis-I USB Radio Stick user manual version 1.0 www.we-online.com/wireless- connectivity

Regulatory compliance information

Important notice EU

The use of RF frequencies is limited by national regulations. The Thetis-I USB Radio Stick has been designed to comply with the R&TTE directive 1999/5/EC and the RED directive 2014/53/EU of the European Union (EU). The Thetis-I USB Radio Stick can be operated without notification and free of charge in the area of the European Union. However, according to the R&TTE / RED directive, restrictions (e.g. in terms of duty cycle or maximum allowed RF power) may apply.

Important notice FCC

The use of RF frequencies is limited by national regulations. The Thetis-I USB Radio Stick has been designed to comply with the FCC Part 15. The Thetis-I USB Radio Stick can be operated without notification and free of charge in the area of the United States of America. However, according to the FCC Part 15, restrictions (e.g. in terms of maximum allowed RF power and antenna) may apply.

EU Declaration of conformity

EU DECLARATION OF CONFORMITY

Radio equipment: 2611086021011
The manufacturer: Würth Elektronik eiSos GmbH & Co. KG Max-Eyth-Straße 1 74638 Waldenburg

This declaration of conformity is issued under the sole responsibility of the manufacturer.

Object of the declaration: 2611086021011

The object of the declaration described above is in conformity with the relevant Union harmonisation legislation Directive 2014/53/EU and 2011/65/EU with its amending Annex II EU 2015/863 . Following harmonised norms or technical specifications have been applied:

EN 300 328 V2.2.2 (2019-07)
EN 301 489-1 V2.2.3
EN 301 489-17 V3.2.4 (2020-09)
EN 62479 : 2010
EN 62368-1:2014 + AC:2015

Trier, 8th of February 2021
Place and date of issue

FCC – Federal Communications Commission

The device has been FCC Part 15 B tested.
Contains FCC ID: R7T1101102
The enclosed device complies with Part 15 of the FCC rules. Operation is subject to the following two conditions:
(i.) this device may not cause harmful interference and
(ii.) this device must accept any interference received, including interference that may cause undesired operation.

IC – Industry Canada

This device contains ISED: 5136A-1101102
This device complies with Industry Canada license-exempt RSS standard(s). Operation is subject to the following two conditions: (1) this device may not cause harmful interference, and (2) this device must accept any interference received, including interference that may cause undesired operation. Le présent appareil est conforme aux CNR d’Industrie Canada applicables aux appareils radio exempts de licence. 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.

Important notes

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

General customer responsibility

Some goods within the product range of Würth Elektronik eiSos GmbH & Co. KG contain statements regarding general suitability for certain application areas. These statements about suitability are based on our knowledge and experience of typical requirements concerning the areas, serve as general guidance and cannot be estimated as binding statements about the suitability 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 and suitable for the respective customer application or not. Accordingly, the customer is cautioned to verify that the documentation is current before placing orders.

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 state of the art, even if the products are operated within the range of the specifications. The same statement is valid for all software sourcecode and firmware parts contained in or used with or for 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 especially in 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 of suitable 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.

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 wireless connectivity homepage.

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.

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 and 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.

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 the field 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 the foregoing for customer-specific products.

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.

General terms and conditions

Unless otherwise agreed in individual contracts, all orders are subject to the current version of the “General Terms and Conditions of Würth Elektronik eiSos Group”, last version available at www.we-online.com.

Legal notice

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 the right 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 that the 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.

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 their consequences 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. KGand its representatives against any damages arising out of the use of any Würth Elektronik eiSos GmbH & Co. KG components in safety-critical applications.

Trademarks

AMBER wireless is a registered trademark of Würth Elektronik eiSos GmbH & Co. KG. All other trademarks, registered trademarks, and product names are the exclusive property of the respective owners.

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 where a higher safety standard and reliability standard is especially required or where a failure of 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 for safety must be performed on every electronic component, which is used in electrical circuits that 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.

License terms

This 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 this license terms is 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 this license terms. You agree to comply with all provisions under this license terms.

Limited license

Würth Elektronik eiSos hereby grants you a limited, non-exclusive, non- transferable and royalty-free license to use the software and under the conditions that will be set forth in this 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 this 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 under strict adherence of this license terms. Würth Elektronik eiSos will not assume any liability for the 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.

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 or not.
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 in safety-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 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 safety-related 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.

Ownership

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

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 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. 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 or similar interfaces.

Disclaimer of warranty

THE FIRMWARE IS PROVIDED “AS IS”. YOU ACKNOWLEDGE THAT WÜRTH ELEKTRONIK EISOS 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 INTENDED PURPOSE 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 THIRD-PARTY 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.

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 your customers as well as for any combination with other products.

Applicable law and jurisdiction

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

Severability clause

If a provision of this 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 such provisions with new valid provisions that most closely approximate the purpose of the terms.

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 is available on our website or in our data sheet and manual, and to implement new software in your device where appropriate. By ordering a wireless connectivity product, you accept this license terms in all terms.

List of Figures
1 Block diagram of the Thetis-I USB Radio Stick . . . . . . . . . . . . . . . . . 5
2 Reset button on the Thetis-I USB Radio Stick . . . . . . . . . . . . . . . . . . 6

List of Tables
1 Ordering information . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 4

more than you expect