| submitted | available | document details (if available) | source link |
|---|---|---|---|
| November 10 2019 |
| various | Users Manual | Users Manual | 1.32 MiB | November 10 2019 |
Test report no. 19011843 Page 1 of 116 EUT: 2609041191000 Themisto-I FCC ID: R7T0904119 FCC Title 47 CFR Part 15 Date of issue: 2019-10-09 Annex acc. to FCC Title 47 CFR Part 15 relating to Wrth Elektronik eiSoos GmbH Co. KG 2609041191000 Themisto-I Annex no. 5 User Manual Functional Description Title 47 - Telecommunication Part 15 - Radio Frequency Devices Subpart C Intentional Radiators ANSI C63.4-2014 ANSI C63.10-2013 Date: 2019-03-11 Created: P4 Reviewed: P9 Released: P1 Vers. No. 1.19 TV NORD Hochfrequenztechnik GmbH & Co. KG LESKANPARK, Gebude 10, Waltherstr. 49-51, 51069 Kln, Germany Tel.: +49 221 88889500 Test report no. 19011843 Page 2 of 116 EUT: 2609041191000 Themisto-I FCC ID: R7T0904119 FCC Title 47 CFR Part 15 Date of issue: 2019-10-09 User Manual / Functional Description of the test equipment (EUT) Date: 2019-03-11 Created: P4 Reviewed: P9 Released: P1 Vers. No. 1.19 TV NORD Hochfrequenztechnik GmbH & Co. KG LESKANPARK, Gebude 10, Waltherstr. 49-51, 51069 Kln, Germany Tel.: +49 221 88889500 THEMISTO-I REFERENCE MANUAL 2609041191000 VERSION 1.0 AUGUST 29, 2019 Revision history Manual version FW version HW version Notes 1.0 2.4.0 1.0 Initial version Date July 2019
? For rmware history see chapter Firmware history Themisto-I reference manual version 1.0 www.we-online.com/wireless-connectivity August 2019 1 Abbreviations and abstract Abbreviation Name ACK CS DC FSE Acknowledgement Checksum Duty cycle Field Sales Engineer 0xhh [HEX]
Hexadecimal HIGH LOW LPM LRM LSB MSB PL RF UART US VCC High signal level Low signal level Low power mode Long range mode Least signicant bit Most signicant bit Payload Radio frequency Universal Asynchronous Receiver Transmitter UserSettings Supply voltage Description Acknowledgement pattern conrming the reception of the transmitted data packet. XOR checksum to check the correct transmission of the prepended Bytes. Transmission time in relation of one hour. 1% means, channel is occupied for 36 seconds per hour. Support and sales contact person responsible for limited sales area. All numbers beginning with 0x are stated as hexadecimal numbers. All other numbers are decimal unless notied . Signal level equals VCC. Signal levels equals 0 Volts. Operation mode for reduced power consumption. Tx mode increasing the RX sensitivity by using spreading and forward error correction. The real, non-redundant information in a frame /
packet. Describes everything relating to the wireless transmission. The UART allows communicating with the module of a specic interface. Any relation to a specic entry in the UserSettings is marked in a special font and can be found in the chapter 8. Themisto-I reference manual version 1.0 www.we-online.com/wireless-connectivity August 2019 2 Contents 1 Introduction 1.1 1.2 1.3 2.1 2.2 2.3 2.4 2.5 Operational description . Block diagram . Ordering information . 2 Electrical specications Recommended operating conditions . Absolute maximum ratings . Power consumption . 2.3.1 Static . Radio characteristics . Pin characteristics . 3 Pinout 4 Quickstart 4.1 Minimal pin conguration . Power up . 4.2 4.3 Quickstart example . 5 Functional description 5.1 5.2 MAC and network layer Physical layer . 5.2.1 Addressing modes . 5.2.2 Unicast . 5.2.3 Multicast/Broadcast . 5.2.4 Acknowledgement and retries . 5.2.5 Packet sniffer mode . 5.2.6 Repeater mode and mesh network . System conguration parameters . 5.3 6 Host connection 6.1 Serial interface: UART . 7 The command interface 7.1 7.2 7.3 Overview . Data transfer and reception in the command mode . 7.2.1 CMD_DATA_REQ . 7.2.2 CMD_DATAEX_REQ . 7.2.3 CMD_DATAEX_IND . 7.2.4 CMD_REPEAT_IND . Requesting parameters, actions and events . 7.3.1 CMD_RESET_REQ . 7.3.2 CMD_RESET_IND . 7.3.3 CMD_SHUTDOWN_REQ . 7.3.4 CMD_STANDBY_REQ . 7.3.5 CMD_STANDBY_IND . 7.3.6 CMD_RSSI_REQ . 8 8 9 9 10 10 10 11 11 11 12 13 16 16 16 17 19 19 19 19 20 20 20 20 20 20 22 22 23 23 24 24 24 26 27 28 28 28 28 29 29 30 Themisto-I reference manual version 1.0 www.we-online.com/wireless-connectivity August 2019 3 7.4 Modication of volatile parameters . 7.4.1 CMD_SET_PAPOWER_REQ . 7.4.1.1 Example . 7.4.2 CMD_SET_CHANNEL_REQ . 7.4.2.1 Example . 7.4.3 CMD_SET_DESTNETID_REQ . 7.4.4 CMD_SET_DESTADDR_REQ . 7.5 Modication of non-volatile parameters . 7.5.1 CMD_SET_REQ . 7.5.2 CMD_GET_REQ . 7.5.3 CMD_FACTORY_RESET_REQ . 7.6 Message overview . 8 UserSettings - Module conguration values 8.1 Difference between volatile and non-volatile settings . 8.2 Modifying the UserSettings . 8.2.1 UART_Baudrate: Congure the UART speed . Example 1 . 8.2.1.1 8.2.1.2 Example 2 . 8.2.2 RADIO_DefaultRfProle: Congure the RF-settings . Example 1 . 8.2.2.1 Example 2 . 8.2.2.2 8.2.3 RADIO_DefaultRfTXPower: Congure the RF TX-power
. Example 1 . 8.2.3.1 8.2.3.2 Example 2 . 8.2.4 RADIO_DefaultRfChannel: Congure the RF channel . 8.2.4.1 Example 1 . 8.2.4.2 Example 2 . 8.2.5 MAC_DefaultAddressMode: Congure the address mode . 8.2.5.1 Example 1 . 8.2.5.2 Example 2 . 8.2.6 MAC_NumRetrys: Congure the number of retries . Example 1 . 8.2.6.1 8.2.6.2 Example 2 . 8.2.7 MAC_DefaultDestNetID: Congure the destination network id . Example 1 . 8.2.7.1 8.2.7.2 Example 2 . 8.2.8 MAC_DefaultDestAddr: Congure the destination address . Example 1 . 8.2.8.1 Example 2 . 8.2.8.2 8.2.8.3 Example 3 . 8.2.9 MAC_SourceNetID: Congure the source network id . Example 1 . 8.2.9.1 8.2.9.2 Example 2 . 8.2.10 MAC_SourceAddr: Congure the source address . Example 1 . 8.2.10.1 Example 2 . 8.2.10.2 8.2.10.3 Example 3 . 31 31 31 31 32 32 33 34 34 35 35 37 38 38 38 38 39 39 40 40 41 42 42 42 43 43 43 44 45 45 46 46 46 47 47 47 48 48 48 48 50 50 50 51 51 51 51 Themisto-I reference manual version 1.0 www.we-online.com/wireless-connectivity August 2019 4 8.2.11 OpMode: Read the operating mode of the module . 8.2.11.1 Example 1 . 8.2.12 CfgFlags: Congure the conguration ags of the module . Example 1 . 8.2.12.1 8.2.12.2 Example 2 . 8.2.13 RpFlags: Congure the repeater ags of the module . Example 1 . 8.2.13.1 8.2.13.2 Example 2 . 8.2.14 RP_NumSlots: Congure the repeater data base . 8.2.14.1 Example 1 . 8.2.14.2 Example 2 . 8.2.15 FactorySettings: Read out the factory settings . 8.2.15.1 Example 1 . 8.2.16 FirmwareVersion: Read out the rmware version . 8.2.16.1 Example 1 . 9 Timing parameters 9.1 9.2 9.3 Reset behavior
. 9.1.1 Reset via /RESET pin . 9.1.2 Reset as result of a serious error condition . Latencies when leaving standby or shutdown . 9.2.1 Wake-up latency from standby . 9.2.2 Wake-up latency from shutdown . Latencies during data transfer / packet generation . 10 Radio parameters 10.1 Channel assignment 11 Battery powered operation
. 12 Custom rmware 12.1 Custom conguration of standard rmware . 12.2 Customer specic rmware . 12.3 Customer rmware . 12.4 Contact for rmware requests . 13 Flooding mesh: Using the repeater functionality 13.1 Setup of the network and repeater device . 13.2 Example network . 13.2.1 Application in parallel networks . 14 Firmware update 14.1 Update using the UART interface . 14.1.1 ACC Software . 14.1.2 Generic UART solution . 14.2 Update using JTAG . 15 Firmware history 53 53 54 54 54 56 56 57 58 58 59 60 60 61 61 62 62 62 62 62 62 63 63 64 64 66 67 67 67 67 68 69 70 71 72 73 73 73 73 74 75 Themisto-I reference manual version 1.0 www.we-online.com/wireless-connectivity August 2019 5 16 Design in guide 16.1 Advice for schematic and layout . 16.2 Dimensioning of the micro strip antenna line . 16.3 Antenna solutions 16.3.1 Wire antenna . 16.3.2 Chip antenna . 16.3.3 PCB antenna . 16.3.4 Antennas provided by Wrth Elektronik eiSos . 2600130011 - Helike - 169 MHz dipole antenna . 16.3.4.1 16.3.4.2 2600130041 - Herse - 434 MHz dipole antenna . 2600130081 - Hyperion-I - 868 MHz dipole antenna . 16.3.4.3 2600130082 - Hyperion-II - 868 MHz magnetic base antenna . 16.3.4.4 16.3.4.5 2600130021 - Himalia - 2.4 GHz dipole antenna . 17 Reference design 17.1 Schematic . 17.2 Layout
. 18 Manufacturing information 18.1 Moisture sensitivity level
. 18.2 Soldering . 18.2.1 Reow soldering . 18.2.2 Cleaning . 18.2.3 Other notations . 18.3 ESD handling . 18.4 Safety recommendations . 19 Physical dimensions 19.1 Dimensions . 19.2 Weight . 19.3 Module drawing . 19.4 Footprint . 19.5 Antenna free area . 20 Marking 20.1 Lot number
. 20.2 General labeling information . 21 Information for Ex protection 76 76 78 79 80 80 80 81 81 82 83 84 85 86 87 89 91 91 91 91 93 93 93 94 95 95 95 96 97 97 98 98 99 100 22 Regulatory compliance information 101 22.1 Important notice FCC . 101 22.2 Conformity assessment of the nal product
. 101 22.3 Exemption clause . 101 22.4 FCC Compliance Statement . 102 22.5 IC Compliance Statement
. 102 22.6 FCC and IC requirements to OEM integrators . 102 22.7 Pre-certied antennas . 104 Themisto-I reference manual version 1.0 www.we-online.com/wireless-connectivity August 2019 6 23 Important notes 105 23.1 General customer responsibility . 105 23.2 Customer responsibility related to specic, in particular safety-relevant ap-
plications . 105 23.3 Best care and attention . 105 23.4 Customer support for product specications . 105 23.5 Product improvements . 106 23.6 Product life cycle . 106 23.7 Property rights . 106 23.8 General terms and conditions . 106 24 Legal notice 107 24.1 Exclusion of liability . 107 24.2 Suitability in customer applications . 107 24.3 Trademarks . 107 24.4 Usage restriction . 107 25 License terms 109 25.1 Limited license . 109 25.2 Usage and obligations . 109 25.3 Ownership . 110 25.4 Firmware update(s) . 110 25.5 Disclaimer of warranty . 110 25.6 Limitation of liability . 111 25.7 Applicable law and jurisdiction . 111 25.8 Severability clause . 111 25.9 Miscellaneous . 111 Themisto-I reference manual version 1.0 www.we-online.com/wireless-connectivity August 2019 7 1 Introduction 1.1 Operational description The Themisto-I is a radio sub module for wireless communication between devices such as control systems, remote controls, sensors etc. It offers several radio congurations, address modes and relieves the host system of radio-specic tasks as checksum calculation, address resolution repetition of unacknowledged telegrams (if enabled) It can be deployed wherever the wireless exchange of data packets between two or more parties is required. A serial interface (UART) whose data rate and format can be adjusted exibly is available for communicating with the host system. Themisto-I reference manual version 1.0 www.we-online.com/wireless-connectivity August 2019 8 1.2 Block diagram Figure 1: Block diagram 1.3 Ordering information WE order code Former order code Description 2609041191009 Themisto-I DEV 2609041191000 Themisto-I Development Kit: 3* Themisto-I radio module 915 MHz with antenna pad Radio module 915 MHz with antenna pad, Tape &
Reel Table 1: Ordering information Themisto-I reference manual version 1.0 www.we-online.com/wireless-connectivity August 2019 9 2 Electrical specications As not otherwise stated measured on the evaluation board Themisto-I-EV with T=25C, VDDS=3.3V, internal DC-DC converter active and a 50 W connection. Any radio transmission in the standard rmware uses boost mode independent of the chosen output power. 2.1 Recommended operating conditions Description Ambient temperature Supply voltage (VDDS) Rising supply voltage slew rate Falling supply voltage slew rate Falling supply voltage slew rate, with low power ash settings 25 3.0 Unit C V Min. Typ. Max. 85
-40 2.21 3.7 100 mV/s 0 20 mV/s 0 3 mV/s Table 2: Recommended operating conditions 2.2 Absolute maximum ratings Description Supply voltage (VDDS) Voltage on any digital pin Input RF level Output RF level Min. Typ.
-0.3
-0.3 12 25 Max. 3.8 VDDS + 0.3, max 3.8 10 25 Unit V V dBm dBm Table 3: Absolute maximum ratings 1Below 2.2V the chipset stops immediately working. A certain buffer for voltage drops should be considered by for example supplying with 2.4V. Themisto-I reference manual version 1.0 www.we-online.com/wireless-connectivity August 2019 10 2.3 Power consumption As a DC/DC voltage regulator is integrated, the current consumption is strongly depending on the supplied voltage level. The transmit and receive currents are depending on the impedance matching, and therefore may vary depending on antenna selection and matching. The indicated values are the complete current consumption for radio and ac-
tive MCU. Not to be confused with only radio or only CPU core currents, as sometimes stated by others. A stable power supply is indispensable to ensure valid operating conditions for the module. 2.3.1 Static The current consumption is the sum of the CPU current and Radio TX or RX current in active modes. Measurements on Themisto-I-EV with T=25C, VDDS=3.6V, internal DC-DC converter active and a 50 W connection unless specied otherwise. Description TX current 25 dBm output power @ VCC 3.3 RX current @ VCC 3.3 Low power (standby) radio off, UART off, RTC running, full RAM retention Low power (shutdown) radio off, UART off, RTC off, no RAM retention Table 4: Power consumption Typ. Unit 400 mA 12 mA 2 A A 0.9 2.4 Radio characteristics Themisto-I reference manual version 1.0 www.we-online.com/wireless-connectivity August 2019 11 Description Frequency band Radio data rate Min 902.5 30 RX sensitivity Prole 6 RX sensitivity Prole 8 RX sensitivity Prole 9 TX power 0 Typ. Max 905 400
-99
-105
-111 25 Unit 927.5 MHz kbit/s 400 dBm dBm dBm dBm 25 Table 5: Radio characteristics 2.5 Pin characteristics Property Default GPIO maximum current Maximum current of RX_IND,TX_IND Pull up current (T=25C, VDDS=1.8 V) Pull down current (T=25C, VDDS=1.8 V) Pull up current (T=25C, VDDS=3.8 V) Pull down current (T=25C, VDDS=3.8 V) Table 6: Pin characteristics 2 4 typ. Value Unit mA mA A A A A 71.7 21.1 277 113 Themisto-I reference manual version 1.0 www.we-online.com/wireless-connectivity August 2019 12 3 Pinout Figure 2: Pinout (top view) Themisto-I reference manual version 1.0 www.we-online.com/wireless-connectivity August 2019 13 GNDBOOTRX_INDTX_INDURXDVCCGNDUTXDTESTTESTTESTTEST112i1i41323WAKE-UPANT/RTSRESERVED/RESETRESERVEDRESERVEDRESERVEDRESERVEDRESERVEDRESERVEDRESERVEDRESERVEDRESERVEDRESERVED Designation I/O Description Antenna connector 50W ANT GND VCC UTXD URXD
/RTS RESERVED RESERVED RESERVED RESERVED RESERVED No 1 2 3 4 5 6 7 8 9 10 11 12 BOOT Input Supply Ground Supply Supply voltage Output UART module TX Input Output UART Flow Control. Module busy = HIGH. UART module RX, uses internal pull-up. I/O I/O I/O I/O I/O Reserved for future use. Uses an internal pull-up. Do not connect. Reserved for future use. Uses an internal pull-
down. Do not connect. Reserved for future use. Uses an internal pull-
down. Do not connect. Reserved for future use. Uses an internal pull-
down. Do not connect. Reserved for future use. Uses an internal pull-
down. Do not connect. Apply LOW during and shortly after reset to start the application rmware. Apply HIGH during and shortly after reset to enable the UART bootloader. Themisto-I reference manual version 1.0 www.we-online.com/wireless-connectivity August 2019 14 No 13 14 15 16 17 18 19 20 21 22 23 No i1 i2 i3 i4 Designation RESERVED I/O I/O WAKE-UP Input RESERVED RESERVED RESERVED RESERVED I/O I/O I/O I/O
/RESET RX_IND TX_IND Input Output Output RESERVED I/O Description Reserved for future use. Uses an internal pull-
down. Do not connect. Apply a falling edge to wake-up from shutdown or standby mode. Uses an internal pull-down. Reserved for future use. Uses an internal pull-
down. Do not connect. Reserved for future use. Uses an internal pull-
down. Do not connect. Reserved for future use. Uses an internal pull-
down. Do not connect. Reserved for future use. Uses an internal pull-
down. Do not connect. Uses an internal pull-up. LOW holds the module in reset state. Indicates RF data reception, active = high. Indicates RF data transmission, active = high. Reserved for future use. Uses an internal pull-
down. Do not connect. GND Supply Ground Designation TEST TEST TEST TEST I/O Input Input Input Input Description Debug interface. Do not connect. Debug interface. Do not connect. Debug interface. Do not connect. Debug interface. Do not connect. Table 7: Pinout Themisto-I reference manual version 1.0 www.we-online.com/wireless-connectivity August 2019 15 4 Quickstart 4.1 Minimal pin conguration In factory state, the module is immediately ready for operation in command mode. The fol-
lowing pins are required in the minimal conguration:
/RESET, BOOT, VCC, GND, /RTS, UTXD and URXD. The antenna pad ANT must be con-
nected accordingly in case it is used. If the module is to be connected to a PC, a converter cable/IC (3.3V TTL to USB) is neces-
sary to achieve interface compatibility. The Themisto-I-EV already implements such a USB converter to be connected to a PC. Not interpreting the /RTS line of the module as described in this manual may cause undened behavior and data loss. For enabling a quick wake-up (after Standby) the pin WAKE-UP has to be connected. The lines BOOT and WAKE-UP may be connected via external pull-up / down to a xed level according to their description when not switched by a host. In case of the WAKE-UP pin the external pull-up has to be selected accordingly in compari-
son with the internal resistor of typical 13kW. 4.2 Power up Recommended procedure for starting the module into normal operation:
Set and hold the BOOT and RESET pin to LOW. After supply voltage is applied to the module and has stabilized, the /RESET pin shall be tied to LOW level for another Dt of at least 1ms to ensure a safe start-up when releasing or applying HIGH to the /RESET pin. The module will send a CMD_RESET_IND UART message as well as pulling the /RTS line to LOW once it has booted and started the application. Then the BOOT pin may be either released or kept at LOW level. If the module is used on a battery-powered system, using a matching reset-IC (or a dis-
crete RC block for a delay) is highly recommended to ensure a correct power up and stable behavior towards a battery getting empty. Applying a reset (e.g. a host temporarily pulling the /RESET pin LOW for at least 1ms and releasing it again to HIGH) after the VCC is stable is also suf-
cient. Themisto-I reference manual version 1.0 www.we-online.com/wireless-connectivity August 2019 16 Figure 3: Power up 4.3 Quickstart example Sending and receiving: Hello World Connect the two devices (modules, EV-boards or USB dongles) to a PC. You may need to install FTDI VCP drivers manually (see ) or using windows update. A minimum distance of 2 meters between the two devices should be kept at all time to avoid over modulation of the receiver. A terminal program, for example hterm, is used to perform the communication via COM ports. The two corresponding COM ports have to be selected and opened with a default conguration of 115200 baud, 8 Data Bits, 1 Stop Bit and Parity set to none (8n1). Make sure the received data is shown also as hex by enabling the corresponding checkbox:
As soon as the module is ready for operation (at start-up or after a reset), the device sends a CMD_RESET_IND message on the UART. Eventually the reset button has to be pushed (or CMD_RESET_REQ performed) to trigger a reset and see this message. Next, the command interface can be used to congure the module or to transmit data. The MAC_DefaultAddressMode is 0, which means that all radio frames are broadcasts that can be received by any other radio compatible device in default settings. Themisto-I reference manual version 1.0 www.we-online.com/wireless-connectivity August 2019 17 To send the string "Hello World" the corresponding CMD_DATA_REQ has to be inserted into the input line of hterm. The "Type" needs to be change from "ASC" to "HEX" before entering the rst byte. The command CMD_DATA_REQ has the following structure:
Start signal Command Length 1 Byte 0x02 0x00 Payload CS Length Bytes 1 Byte In this example the payload 0x48 0x65 0x6C 0x6C 0x6F 0x20 0x57 0x6F 0x72 0x6C 0x64 0x21 (Hello World!) has a length of 12 (0x0C) Bytes. The checksum CS is a XOR conjunction of all previous bytes, which is 0x0F in this case. Using the "ASend" button followed by pushing the "Start" button sends the data once. The second module receiving this packet outputs a CMD_DATAEX_IND message containing the transmitted payload data and the corresponding RSSI value. In the default address mode (MAC_DefaultAddressMode = 0), the format of the CMD_DATAEX_IND is as follows:
Start signal Command Length 1 Byte 0x02 0x81 Payload RSSI CS
(Length-1) Bytes 1 Byte 1 Byte Thus, the CMD_DATAEX_IND message informs us that we received a packet with payload of 13 (0x0D) Bytes. 12 byte of these Bytes are the transmitted user payload 0x48 0x65 0x6C 0x6C 0x6F 0x20 0x57 0x6F 0x72 0x6C 0x64 0x21 (Hello World!) and one byte is the RSSI value, here 0xD9 (-39dBm in twos complement notation). Themisto-I reference manual version 1.0 www.we-online.com/wireless-connectivity August 2019 18 5 Functional description The Themisto-I can be congured to operate in several modes at the physical, MAC as well as the network layer. This chapter describes all the available modes of operation. 5.1 Physical layer At the physical layer, the Themisto-I can be congured to use one of the following radio pro-
les (see parameter RADIO_DefaultRfProfile). Radio prole Data rate (gross) [kcps]
Modulation Max packet size [Byte]
6 400 GFSK 8 (long range mode) 9 (long range mode) 480 (= 240 kbps net) 480 (= 30 kbps net) DSSS with FEC DSSS with FEC 224 224 224 Additionally, the frequency channel of operation is congurable to avoid interference between several subnets of radio devices (see RADIO_DefaultRfChannel). The radio parameters need to be chosen for optimal performance based on the required range, data rate, maximum payload size, keeping in mind the compliance with valid regulatory requirements. A detailed description for conguring these parameters could be found in chapter 7 and chapter 8. 5.2 MAC and network layer 5.2.1 Addressing modes In order to interconnect several modules and build a network or to send data to specic devices, the Themisto-I supports addressing at MAC and network levels. Based on the address mode of the module congured using the UserSetting MAC_DefaultAddressMode, each device can be congured with an address (1 or 2 byte) and a network id (1 byte) that is dened by the UserSettings MAC_SourceAddr and MAC_SourceNetID respectively. Address mode MAC address size [Byte] Network address size [Byte]
0 1 2 3 0 1 1 2 0 0 1 1 Depending on the selected address mode up to 254 network IDs and up to 65534 addresses are supported. 0xFF and 0xFFFF are used as broadcast addresses. Themisto-I reference manual version 1.0 www.we-online.com/wireless-connectivity August 2019 19 Please note that the RF settings (e.g. RF prole, RF channel, address mode, repeater settings) must be the same for all nodes in the network. Violation may cause interrupted transmission, or received packets that cannot to be interpreted correctly. In addition, the timing parameters in case of re-
peater or enabled ACKs must be the same for all nodes in a network. The address mode 3 (254 network ids and 65534 addresses) is only supported by the Tarvos-II and Tarvos-III. Radio messages of devices that are using the same radio channel may inter-
fere with each other leading to possible collisions and packet loss. 5.2.2 Unicast A module can use the command CMD_DATA_REQ to send data to a pre-dened destination specied by the parameters MAC_DefaultDestAddr and MAC_DefaultDestNetID. Besides this, the command CMD_DATAEX_REQ triggers the data transmission to the address specied in the command. 5.2.3 Multicast/Broadcast The destination address or destination network id of 0xFF (255) or 0xFFFF (65535) stands for a broadcast which will trigger any compatible receiver to interpret this frame to forward it to its host. 5.2.4 Acknowledgement and retries In order to improve reliability in communication, the module can be congured to use radio acknowledgement and retry mechanism. It can be activated using the parameter MAC_NumRetrys accordingly and only in case of non-broadcast messages. 5.2.5 Packet sniffer mode The address resolution can be disabled ("packet sniffer") by enabling the sniffer mode in the UserSetting CfgFlags. A module in sniffer mode will accept all data packets (ignoring the target address) and forward them to the serial interface. Furthermore, it does not send any acknowledgement and cannot work as repeater at the same time (see section 13). 5.2.6 Repeater mode and mesh network The module can be run as a repeater to articially extend the range of sending devices in an existing network. A module congured as repeater, simply re-transmits the received packet after a random back off time. This mode allows options to build a flooding meshnetwork described in detail in chapter 13. 5.3 System conguration parameters The parameters that determine the functionality of the module are classied into two cate-
gories. The non-volatile UserSettings (see chapter 8) values that can be modied using the CMD_SET_REQ command retain their values after a power reset. Themisto-I reference manual version 1.0 www.we-online.com/wireless-connectivity August 2019 20 Please note that each CMD_SET_REQ will consume one ash erase/write cycle, which are limited due to the hardware (guaranteed are 100k cycles, see TI C-
C1310 datasheet). On the other hand, the volatile settings (called "RuntimeSettings") can be accessed by ex-
plicit commands (see chapter 7.4) and used to quickly (but temporarily) modify specic pa-
rameters without using ash cycles. These settings are only valid until a reset is performed and shall be used when frequent updates of settings are necessary. Themisto-I reference manual version 1.0 www.we-online.com/wireless-connectivity August 2019 21 6 Host connection 6.1 Serial interface: UART The conguration in factory state of the UART is 115200 baud with data format of 8 data Bits, no parity and 1 stop Bit ("8n1"). The baud rate of the UART can be congured by means of the UserSetting UART_Baudrate. The data format is xed to 8n1. The output of characters on the serial interface runs with secondary priority. For this reason, short interruptions may occur between the outputs of individual successive Bytes. The host must not implement too strict timeouts between two Bytes to be able to receive packets that have interruptions 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 /RTS, which will indicate that the next byte of the packet can be received by the module. This direction also accepts a pause of up to four full byte durations (32Bit) delay between two successive Bytes before discarding received content (without user notication). Themisto-I reference manual version 1.0 www.we-online.com/wireless-connectivity August 2019 22 7 The command interface 7.1 Overview The module acts as a slave and can be fully controlled by an external host. The conguration as well as the operation of the module can be managed by predened commands that are sent as telegrams over the UART interface of the module. The commands of the command interface can be divided into 3 groups:
Requests: The host requests the module to trigger any action, e.g. request CMD_RESET_REQ the host asks the module to perform a reset. in case of the Conrmations: On each request, the module answers with a conrmation message In case of a CMD_RESET_REQ, to give a feedback on the requested operation status. the module answers with a CMD_RESET_CNF to tell the host whether the reset will be performed or not. Indications and Responses: The module indicates spontaneously when a special event has occurred. The CMD_DATAEX_IND indicates for example that data was received via radio. Start signal Command Length 1 Byte 1 Byte 0x02 Payload CS Length Bytes 1 Byte Start signal 0x02 (1 Byte) Command One of the predened commands (1 Byte), the module implements new and modied commands in comparison to other radio compatible modules. Length Species the number of payload data in the following eld. Payload Variable number (dened by the length eld) of data or parameters. Checksum Byte wise XOR combination of all preceding Bytes including the start signal, i.e. 0x02 Command Length Payload = CS All commands of type Request must obey the following rules:
Only one request at a time may be active. Wait for conrmation of the previous re-
quest and implement a suiting timeout (depends on the command or action that was requested, 500ms should cover the worst-case time). Indications are spontaneous messages, they may occur in between a command re-
quest and its conrmation. A high /RTS line signalizes that the module UART is not ready for reception. Thus, any byte(s) sent from the host will be discarded by the module without further user notication ("module busy"). If "module busy" occurs while sending a command to the module, it is necessary to resend this entire command again after /RTS pin status shows "module idle" again. Themisto-I reference manual version 1.0 www.we-online.com/wireless-connectivity August 2019 23 7.2 Data transfer and reception in the command mode This group of commands include the commands that either are used to request a radio telegram to be send or indicates a received frame. 7.2.1 CMD_DATA_REQ This command serves the simple data transfer in the command mode. Transmission takes place on the congured channel to the previously parametrised destination address (taken from the volatile RuntimeSettings). This command is especially suitable for transmission for a point-to-point connection. The maximum number of payload data Bytes depends on the chosen RADIO_DefaultRfProfile. Format:
Start signal Command Length 1 Byte 0x02 0x00 Payload CS Length Bytes 1 Byte Response (CMD_DATA_CNF):
Start signal Command | 0x40 Length Status CS 0x02 0x40 0x01 1 Byte 1 Byte Status:
0x00: ACK received or not requested (MAC_NumRetrys is 0, MAC_DefaultAddressMode is 0 or a broadcast address is set as destination address) 0x01: no ACK received within a time-out after using all MAC_NumRetrys 0xFF: invalid (payload too long) 7.2.2 CMD_DATAEX_REQ This command serves data transfer in a network with several parties. Both the RF channel to use and the destination address (depending on the parametrised address mode) are specied along with the command. The maximum number of payload data Bytes depends on the chosen RADIO_DefaultRfProfile. The entered channel, destination network and destination address are loaded into the volatile RuntimeSettings and thus are kept until the system is reset or these values are modied again. Please note that the format of this command depends on the congured MAC_DefaultAddressMode. Address mode 0:
Themisto-I reference manual version 1.0 www.we-online.com/wireless-connectivity August 2019 24 Start signal Command Length Channel Payload CS 0x02 0x01 Payload len. + 1 1 Byte Payload len. Bytes 1 Byte Address mode 1:
Start signal Command Length Channel Dest. address Payload CS 0x02 0x01 Payload len. + 2 1 Byte 1 Byte Payload len. Bytes 1 Byte Address mode 2:
Start signal Command Length Channel Dest. netID Dest. address Payload CS 0x02 0x01 Payload len. + 3 1 Byte 1 Byte 1 Byte Payload len. Bytes 1 Byte Address mode 3:
Start signal Command Length Channel Dest. netID Dest. address Payload CS 0x02 0x01 Payload len. + 4 1 Byte 1 Byte 2 Byte (LSB rst) Payload len. Bytes 1 Byte Response:
Status:
Start signal CMD_DATA_REQ | 0x40 Length Status CS 0x02 0x40 0x01 1 Byte 1 Byte 0x00: ACK received or not requested (MAC_NumRetrys is 0, MAC_DefaultAddressMode is 0 or a broadcast address is set as destination address) 0x01: no ACK received within a time-out after using all MAC_NumRetrys 0x02: invalid channel selected 0xFF: invalid (payload too long) Themisto-I reference manual version 1.0 www.we-online.com/wireless-connectivity August 2019 25 7.2.3 CMD_DATAEX_IND This telegram indicates the reception of data Bytes and represents the counterpart to the commands CMD_DATA_REQ and CMD_DATAEX_REQ. Apart from the RX eld strength (RSSI value given in twos complement notation), this telegram also displays the source address of the sending device (depending on the parametrised address mode). Please note that the format of this command depends on the congured MAC_DefaultAddressMode. Format in address mode 0:
Start signal Command Length Payload Field strength CS 0x02 0x81 Payload len. + 1 Payload len. Bytes 1 Byte 1 Byte Format in address mode 1:
Start signal Command Length 0x02 0x81 Payload len. + 2 Sender address 1 Byte Payload Field strength CS Payload len. Bytes 1 Byte 1 Byte Format in address mode 2:
Start signal Command Length 0x02 0x81 Payload len. + 3 Sender network id Sender address 1 Byte 1 Byte Payload Field strength CS Payload len. Bytes 1 Byte 1 Byte Format in address mode 3:
Start signal Command Length 0x02 0x81 Payload len. + 4 Sender network id 1 Byte Sender address 2 Byte
(LSB rst) Payload Field strength CS Payload len. Bytes 1 Byte 1 Byte Themisto-I reference manual version 1.0 www.we-online.com/wireless-connectivity August 2019 26 7.2.4 CMD_REPEAT_IND This command indicates that the module has repeated a data packet when acting in repeater mode. The source address and network id is the address of the origin sender of the RF packet, the destination address and network id is the address of the device that is supposed to receive the RF packet. Format in address mode 0:
Start signal 0x02 Command Length Status Address mode 0x00 1 Byte 0x80 0x02 CS 1 Byte Format in address mode 1:
Start signal Command Length Status Address mode 0x02 0x80 0x04 1 Byte 0x01 Dest. ad-
dress 1 Byte Source ad-
dress 1 Byte CS 1 Byte Format in address mode 2:
Start signal Com. Length Status Address. mode Dest. NetID Dest. address Source NetID Source address 0x02 0x80 0x06 1 Byte 0x02 1 Byte 1 Byte 1 Byte 1 Byte CS 1 Byte Format in address mode 3:
Start signal Com. Length Status Address. mode Dest. NetID 0x02 0x80 0x08 1 Byte 0x02 1 Byte Dest. address 2 Byte
(LSB rst) Source NetID 1 Byte Source address 2 Byte
(LSB rst) CS 1 Byte Status:
0x00: OK 0x01: Failed Themisto-I reference manual version 1.0 www.we-online.com/wireless-connectivity August 2019 27 7.3 Requesting parameters, actions and events This group includes all commands that will return read-only parameters or request actions in the module. 7.3.1 CMD_RESET_REQ This command triggers a software reset of the module. The reset is performed after the acknowledgment is transmitted. All volatile settings are initialized with their defaults. Format:
Start signal Command Length 0x00 0x02 0x05 CS 0x07 Response (CMD_RESET_CNF):
Start signal Command | 0x40 Length Status CS 0x02 0x45 0x01 1 Byte 1 Byte Status:
0x00: Request successfully received and processed 0x01: Request not successful As soon as the module has restarted a CMD_RESET_IND is printed on the UART and the /RTS line will show "module idle". 7.3.2 CMD_RESET_IND This message indicates that the module has restarted. After the /RTS line is low and the start-up time-out has passed, the module is ready to receive UART data and radio frames. Start signal Command Length Mode 0x10 0x02 0x01 0x85 CS 0x96 7.3.3 CMD_SHUTDOWN_REQ This command triggers the shut down mode of the chip, which is the mode with lowest power consumption. The shut down is performed after the command conrmation message is transmitted. The UART interface is disabled in shut down mode. Format:
Start signal Command Length 0x00 0x0E 0x02 CS 0x0C Response (CMD_SHUTDOWN_CNF):
Themisto-I reference manual version 1.0 www.we-online.com/wireless-connectivity August 2019 28 Start signal Command | 0x40 Length Status CS 0x02 0x4E 0x01 1 Byte 1 Byte Status:
0x00: Request successfully received and processed 0x01: Request not successful To wake-up from shut down mode, a falling edge has to be applied to the WAKE-UP pin. In this case, the module restarts such that all volatile settings are lost. As soon as it has restarted a CMD_RESET_IND message is printed on the UART. Please note that in shut down mode, the WAKE-UP pin has an internal pull-down to ensure the wake-up is not performed accidentally due to a oating pin. 7.3.4 CMD_STANDBY_REQ This command triggers the standby mode of the chip, a low power mode with RAM retention. The standby mode is entered after the command conrmation message is transmitted. The UART interface is disabled in standby mode. The latency is smaller than the latency caused by a complete restart of the module as done in the shut down mode. Format:
Start signal Command Length 0x00 0x0F 0x02 CS 0x0D Response (CMD_STANDBY_CNF):
Start signal Command | 0x40 Length Status CS 0x02 0x4F 0x01 1 Byte 1 Byte Status:
0x00: Request successfully received and processed 0x01: Request not successful To wake-up from standby mode, a falling edge has to be applied to the WAKE-UP pin. Please note that in standby mode, the WAKE-UP pin has an internal pull-down to ensure the wake-
up is not performed accidentally due to a oating pin. When a falling edge is detected, the module wakes up but does not revert to factory settings as the RAM content is retained and all volatile settings are kept. Upon being idle again, a CMD_STANDBY_IND message is printed on the UART and the /RTS pin will show a low level. 7.3.5 CMD_STANDBY_IND This message indicates that the module woke up from standby mode and is ready for oper-
ation. Themisto-I reference manual version 1.0 www.we-online.com/wireless-connectivity August 2019 29 Start signal Command | 0x80 Length Status 0x00 0x8F 0x02 0x01 CS 0x8C Status:
0x00: wake-up successful 7.3.6 CMD_RSSI_REQ This command returns the RX level of the last received packet determined by the transceiver IC in the form of a signed twos complement. The current RSSI value of the radio IC ("live RSSI value") cannot be requested by means of this command. Format:
Start signal Command Length 0x00 0x0D 0x02 CS 0x0F Response (CMD_RSSI_CNF):
Start signal Command | 0x40 Length RX level 1 Byte 0x4D 0x02 0x01 CS 1 Byte The value obtained in this way delivers the RX level RSSIdBm in dBm as follows. Example: Conversion of the hexadecimal value in twos complement notation to a decimal RSSIdec 0xDBhex = 10111101bin )
128 + 0 64 + 1 32 + 1 16 + 1 8 + 1 4 + 0 2 + 1 1 = 67dBm If the RSSI equals 0x80 (-128dBm), there is no RSSI value available yet. Themisto-I reference manual version 1.0 www.we-online.com/wireless-connectivity August 2019 30 7.4 Modication of volatile parameters This group contains all functions that will modify RuntimeSettings while the module is run-
ning. These settings are volatile and will be reset to their defaults (see chapter 8) on a reset of the module or when waking up after a shut down command. 7.4.1 CMD_SET_PAPOWER_REQ This command is used to set the radio TX-power. Unlike the UserSettings parameter RADIO_DefaultRfTXPower, this is a volatile runtime parameter, but its power value is used in the same way. Thus, see section 8.2.3 for more information. The parameter must be chosen with prudence to reach good functionality and compliance with valid regulatory requirements as for example the EN 300 220 in the European Union or the FCC in the United States of America. The power value is entered in the complement on two format. Format:
Start signal Command Length Power CS 0x02 0x11 0x01 1 Byte 1 Byte Response (CMD_SET_PAPOWER_CNF):
Start signal Command | 0x40 Length Congured power CS 0x02 0x51 0x01 1 Byte 1 Byte 7.4.1.1 Example Setting the power to +14 dBm:
Start signal Command Length Congured power 0x02 0x11 0x01 0x0E CS 0x1C Response:
Start signal Command | 0x40 Length Congured power 0x02 0x51 0x01 0x0E CS 0x5C 7.4.2 CMD_SET_CHANNEL_REQ This command is used to select the radio channel. Unlike the UserSettings parameter RADIO_DefaultRfChannel, this is a volatile runtime parameter. Themisto-I reference manual version 1.0 www.we-online.com/wireless-connectivity August 2019 31 The parameter must be chosen with prudence to reach good functionality
(radio environment dependent) and compliance with valid regulatory require-
ments as the EN 300 220 in the European Union or the FCC in the United States of America. Format:
Start signal Command Length Channel 1 Byte 0x02 0x06 0x01 CS 1 Byte Response (CMD_SET_CHANNEL_CNF):
Start signal Command | 0x40 Length Congured channel CS 0x02 0x46 0x01 1 Byte 1 Byte 7.4.2.1 Example Selection of channel 226:
Start signal Command Length channel 0xE2 0x02 0x06 0x01 CS 0xE7 Response:
Start signal Command | 0x40 Length Congured channel 0x02 0x46 0x01 0xE2 CS 0xA7 7.4.3 CMD_SET_DESTNETID_REQ This command serves to congure the Dest. netID in address mode 2 and 3. Unlike the UserSettings parameter MAC_DefaultDestNetID, this is a volatile runtime parameter. Format:
Start signal Command Length Dest. netID CS 0x02 0x07 0x01 1 Byte 1 Byte Return (CMD_SET_DESTNETID_CNF):
Start signal Command | 0x40 Length Status CS 0x02 0x47 0x01 1 Byte 1 Byte Status:
0x00: Request successfully received and processed 0x01: Request not successful Themisto-I reference manual version 1.0 www.we-online.com/wireless-connectivity August 2019 32 7.4.4 CMD_SET_DESTADDR_REQ This command serves to congure the destination address in address modes 1, 2 and 3. Unlike the UserSettings parameter MAC_DefaultDestAddr, this is a volatile runtime parame-
ter. Format: Mode 1 + 2:
Start signal Command Length Dest. address CS 0x02 0x08 0x01 or 0x02 1 Byte or 2 Byte 1 Byte Response (CMD_SET_DESTADDR_CNF):
Start signal Command | 0x40 Length Status CS 0x02 0x48 0x01 1 Byte 1 Byte Status:
0x00: Request successfully received and processed 0x01: Request not successful Themisto-I reference manual version 1.0 www.we-online.com/wireless-connectivity August 2019 33 7.5 Modication of non-volatile parameters The non-volatile parameters are also called UserSettings and are stored in a special ash location. This settings can also be congured using our windows pc software "ACC". 7.5.1 CMD_SET_REQ This command enables direct manipulation of the parameters in the modules non-volatile UserSettings. The respective parameters are accessed by means of the corresponding SettingsIndex. Parameters with size of two or more Bytes have to be transferred with the LSB rst unless otherwise specied. The modied parameters only take effect after a restart of the module. This can be done by a CMD_RESET_REQ or using the /RESET pin. The validity of the specied parameters is not veried by the application. In-
correct values can result in device malfunction up to a scenario where the rmware of the module needs to be re-ashed to get it operating again!
Any use of CMD_SET_REQ will consume one ash erase/write cycle. Flash erase/write cycles are limited through hardware (guaranteed minimum 100k cycles). For frequently changing parameters use the volatile parameters "Run-
timeSettings", see chapter 7.4 . To store the parameters in the ash memory of the module, the particular mem-
ory segment must be buffered into RAM, then to be erased entirely and then restored from RAM. If a reset or VCC instability occurs during this procedure (e.g. due to sup-
ply voltage uctuations), the entire memory area may be destroyed and the module can only be resurrected by means of a JTAG or Bootloader rmware update. Recommended procedure: First verify the conguration of the module with CMD_GET_REQ and only apply a CMD_SET_REQ if required. Make sure the VCC is stable and no reset occurs during this procedure. Format:
Start signal Command Length SettingsIndex Parameter CS 0x02 0x09 1 Byte 1 Byte
(Length - 1) Bytes 1 Byte Response (CMD_SET_CNF):
Themisto-I reference manual version 1.0 www.we-online.com/wireless-connectivity August 2019 34 Start signal Command | 0x40 Length Status CS 0x02 0x49 0x01 1 Byte 1 Byte Status:
0x00: Request successfully received and processed 0x01: Operation failed due to invalid parameter 7.5.2 CMD_GET_REQ This command can be used to query the UserSettings parameters. The respective parame-
ters are accessed by means of the corresponding SettingsIndex. Parameters with size of two or more Bytes will be transmitted LSB rst unless noted otherwise. Format:
Start signal Command Length SettingsIndex CS 0x02 0x0A 0x01 1 Byte 1 Byte Response (CMD_GET_CNF):
Start signal Command | 0x40 Length Status Parameter CS 0x02 0x4A 1 Byte 1 Byte (Length - 1) Bytes 1 Byte Status:
0x00: Request successfully received and processed 0x01: Request not successful 7.5.3 CMD_FACTORY_RESET_REQ This command restores the default UserSettings of the module. software reset of the module is performed in addition. Format:
If this was successful, a Start signal Command Length 0x00 0x02 0x12 CS 0x10 Response (CMD_FACTORY_RESET_CNF):
Themisto-I reference manual version 1.0 www.we-online.com/wireless-connectivity August 2019 35 Start signal Command | 0x40 Length Status CS 0x02 0x52 0x01 1 Byte 1 Byte Status:
0x00: Request successfully received and processed 0x01: Request not successful Themisto-I reference manual version 1.0 www.we-online.com/wireless-connectivity August 2019 36 7.6 Message overview CMD_DATA_REQ CMD_RESET_REQ CMD_DATAEX_REQ CMD Message name 0x00 0x01 0x05 0x06 0x07 0x08 0x09 CMD_SET_REQ 0x0A CMD_GET_REQ 0x0D CMD_RSSI_REQ 0x0E CMD_SHUTDOWN_REQ 0x0F CMD_STANDBY_REQ 0x11 0x12 0x40 0x45 0x46 0x47 0x48 0x49 CMD_SET_CNF 0x4A CMD_GET_CNF 0x4D CMD_RSSI_CNF 0x4E CMD_SHUTDOWN_CNF 0x4F CMD_STANDBY_CNF 0x51 0x52 0x80 0x81 0x85 0x8F CMD_STANDBY_IND CMD_REPEAT_IND CMD_DATAEX_IND CMD_RESET_CNF CMD_RESET_IND CMD_DATA_CNF CMD_SET_CHANNEL_REQ CMD_SET_DESTNETID_REQ Set the destination network id CMD_SET_DESTADDR_REQ Short description Send data to congured address Send data to specic address Reset module Change the RF channel Set the destination address Change the UserSettings Read the UserSettings Request RSSI of last packet Go to shut down mode Go to standby mode Change the radio TX power Data has been sent Reset request received Channel has been updated CMD_SET_PAPOWER_REQ CMD_FACTORY_RESET_REQ Perform a factory reset CMD_SET_CHANNEL_CNF 7.4.2 CMD_SET_DESTNETID_CNF Destination network id has been updated 7.4.3 CMD_SET_DESTADDR_CNF Destination address has been updated UserSettings have been updated Return the requested UserSetting values Return the requested RSSI value Shut down request received Standby request received RF TX power has been updated CMD_SET_PAPOWER_CNF CMD_FACTORY_RESET_CNF Factory reset request received Data has been repeater Data has been received Reset has been applied Woke up from standby mode Table 8: Message overview Chapter 7.2.1 7.2.2 7.3.1 7.4.2 7.4.3 7.4.4 7.5.1 7.5.2 7.3.6 7.3.3 7.3.4 7.4.1 7.5.3 7.2.1 7.3.1 7.4.4 7.5.1 7.5.2 7.3.6 7.3.3 7.3.4 7.4.1 7.5.3 7.2.4 7.2.3 7.3.2 7.3.5 Themisto-I reference manual version 1.0 www.we-online.com/wireless-connectivity August 2019 37 8 UserSettings - Module conguration values 8.1 Difference between volatile and non-volatile settings The so-called UserSettings are stored permanently into the internal ash of the module. At start-up, these UserSettings are loaded as start values into the volatile settings ("Run-
timeSettings"). Some of the RuntimeSettings can be modied by special commands (see chapter 7.4). These RuntimeSettings are lost and replaced by the UserSettings content when the module is restarted. See chapters 7.4 and 7.5 for methods to change volatile and/or non-volatile settings. The non-volatile UserSettings can be modied by means of specic commands in the con-
guration mode (CMD_SET_REQ) of the module. These parameters are stored permanently in the modules ash memory. All settings are described on the following pages. After changing those parameters, a reset will be necessary to make use of the new settings. The validity of the specied parameters given with a CMD_SET_REQ is not veri-
ed. Incorrect values can result in device malfunction and may even result in the need of re-ashing the entire module rmware!
8.2 Modifying the UserSettings The following chapters will give examples for the modication for many parameters using the commands CMD_SET_REQ and CMD_GET_REQ. The PC software ACC (AMBER Cong Center, version 3.4.3 or newer) can also be used to change non-volatile parameters. 8.2.1 UART_Baudrate: Congure the UART speed Settings index Designation 0 UART_Baudrate Permissible values 9600 -
921600 Default value Permissions Number of Bytes 115200 read/write 4 The UserSetting UART_Baudrate is a 32 Bit eld that contains the symbol rate for the com-
munication interface. The format for the parametervalue is LSB rst. After changing the baud rate using the CMD_SET_REQ the module restarts using the new baud rate. Thus, please do not forget to update the baud rate of the connected host controller to be able to use the modules UART further on. Themisto-I reference manual version 1.0 www.we-online.com/wireless-connectivity August 2019 38 Please double check that the Byte-order of the parameter. It is to be used LSB rst. Wrong values may lead to a condition where talking with the module is not possible anymore. 8.2.1.1 Example 1 Set the baud rate of the module to 9600 baud (0x00002580M SBf irst corresponds to 0x80250000LSBf irst) using the CMD_SET_REQ with Settings index 0:
Start signal Command Length Settings index 0x02 0x09 0x05 0x00 Parameter CS 0x80 0x25 0x00 0x00 0xAB Response CMD_SET_CNF: Successfully modied the setting. Start signal Command | 0x40 Length Status 0x00 0x02 0x49 0x01 CS 0x4A 8.2.1.2 Example 2 Request the baud rate of the module using CMD_GET_REQ:
Start signal Command Length Settings index 0x02 0x0A 0x01 0x00 CS 0x09 Response CMD_GET_CNF: Successfully read out the baud rate 0x00002580 (9600 baud). Start signal Command | 0x40 Length Status 0x00 0x4A 0x02 0x05 Parameter CS 0x80 0x25 0x00 0x00 0xE8 Themisto-I reference manual version 1.0 www.we-online.com/wireless-connectivity August 2019 39 8.2.2 RADIO_DefaultRfProle: Congure the RF-settings Settings index 1 Designation Permissible values Default value Permissions Number of Bytes RADIO_DefaultRfProfile 6,8,9 6 read/write 1 The UserSetting RADIO_DefaultRfProfile is an 8 Bit eld that addresses the applied RF conguration. The parameter must be chosen with prudence to reach good functionality and compliance with valid regulatory requirements as the FCC in the United States of America. After modication of the RADIO_DefaultRfProfile, please check whether the RADIO_DefaultRfChannel has to be updated too. Radio prole Data rate (gross)
[kcps]
Modulation Max packet size [Byte]
6 400 GFSK 8
(long range mode) 9
(long range mode) 480
(= 240 kbps net) 480
(= 30 kbps net) DSSS with FEC DSSS with FEC 224 224 224 Max packet time for repeater mode
[ms]
15 15 75 Table 9: Radio proles 8.2.2.1 Example 1 Set the radio prole to 6 using the CMD_SET_REQ:
Start signal Command Length Settings index Parameter 0x02 0x09 0x02 0x01 0x06 CS 0x0E Response CMD_SET_CNF: Successfully modied the setting. Start signal Command | 0x40 Length Status 0x00 0x02 0x49 0x01 CS 0x4A Themisto-I reference manual version 1.0 www.we-online.com/wireless-connectivity August 2019 40 8.2.2.2 Example 2 Request the radio prole using CMD_GET_REQ:
Start signal Command Length Settings index 0x02 0x0A 0x01 0x01 CS 0x08 Response CMD_GET_CNF: Successfully read out the radio as 6. Start signal Command | 0x40 Length Status Parameter 0x02 0x4A 0x02 0x00 0x06 CS 0x4C Themisto-I reference manual version 1.0 www.we-online.com/wireless-connectivity August 2019 41 8.2.3 RADIO_DefaultRfTXPower: Congure the RF TX-power Settings index 2 Designation RADIO_DefaultRfTXPower Permissible values 12, 18, 21, 23, 24, 25 Default value Permissions Number of Bytes 25 read/write 1 This UserSetting denes the radio output power of the module. The UserSettings parameter RADIO_DefaultRfTXPower is entered as a complement on two. This value represents the power at the radio ic without taking the antenna into account. The user is responsible for adhering to the statutory regulations for the maxi-
mum power output when using this module. In case of the Themisto-I with an external antenna the antenna gain needs to be taken into account, too. 8.2.3.1 Example 1 Set the radio output power to 0 using the CMD_SET_REQ:
Start signal Command Length Settings index Parameter 0x02 0x09 0x02 0x02 0x0C CS 0x07 Response CMD_SET_CNF: Successfully modied the setting. Start signal Command | 0x40 Length Status 0x00 0x02 0x49 0x01 CS 0x4A 8.2.3.2 Example 2 Request the radio output power using CMD_GET_REQ:
Start signal Command Length Settings index 0x02 0x0A 0x01 0x02 CS 0x0B Response CMD_GET_CNF: Successfully read out the radio as 25 dBm (0x19). Start signal Command | 0x40 Length Status Parameter 0x02 0x4A 0x02 0x00 0x19 CS 0x53 Themisto-I reference manual version 1.0 www.we-online.com/wireless-connectivity August 2019 42 8.2.4 RADIO_DefaultRfChannel: Congure the RF channel Settings index Designation Permissible values Default value Permissions Number of Bytes 3 RADIO_DefaultRfChannel 201 - 251 226 read/write 1 This UserSetting determines the wireless channel of the module to be used after a reset. The dependence between channel and frequency is as follows:
F requencyRF 802M Hz
(1) ChannelRF =
0:5M Hz Check chapter 10.1 for more information. The user is responsible for adhering to the statutory regulations for the fre-
quency and spectrum use when using this module. 8.2.4.1 Example 1 Set the radio channel to 201 (0xC9) using the CMD_SET_REQ:
Start signal Command Length Settings index Parameter 0x02 0x09 0x02 0x03 0xC9 CS 0xC3 Response CMD_SET_CNF: Successfully modied the setting. Start signal Command | 0x40 Length Status 0x00 0x02 0x49 0x01 CS 0x4A 8.2.4.2 Example 2 Request the radio channel using CMD_GET_REQ:
Start signal Command Length Settings index 0x02 0x0A 0x01 0x03 CS 0x0A Response CMD_GET_CNF: Successfully read out the radio as 226 (0xE2). Start signal Command | 0x40 Length Status Parameter 0x02 0x4A 0x02 0x00 0xE2 CS 0xA8 Themisto-I reference manual version 1.0 www.we-online.com/wireless-connectivity August 2019 43 8.2.5 MAC_DefaultAddressMode: Congure the address mode Settings index 4 Designation Permissible values Default value Permissions Number of Bytes MAC_DefaultAddressMode 0 - 3 0 read/write 1 This setting denes the address mode of the module. The following modes have been implemented:
No addressing (mode 0): Each module receives the transmitted RF telegram and delivers the received data to the host system via UART. No address information is transmitted in the radio telegram. 1-byte address (mode 1): The receiving module only delivers the data to the host system via UART, if the 1 Byte destination address congured at the sender corresponds to the 1 Byte source address of the receiver (MAC_SourceAddr) or if the destination broadcast address 255 was specied. Both, the destination address and the source address are transmitted in the wireless telegram (total = 2 Bytes). 2-Bytes address (mode 2): The receiving module only delivers the data to the host system via UART, if both the destination network id and the 1 Byte destination address congured at the sender correspond to the source addresses of the receiver (MAC_SourceNetID and 1 Byte MAC_SourceAddr) or if the destination broadcast address 255 and/or network broadcast id 255 was specied. A total of 4 Bytes of address information are transmitted in the wireless telegram. 2-Bytes address (mode 3): The receiving module only delivers the data to the host system via UART, if both the destination network id and the 2 Byte destination address congured at the sender correspond to the source addresses (MAC_SourceNetID and 2 Byte MAC_SourceAddr) of the receiver or if the destination broadcast address 65535 and network broadcast id 255 was specied. A total of 6 Bytes of address information are transmitted in the wireless telegram. In address mode 0, the use of wireless acknowledgement will cause problems if several wireless modules are addressed simultaneously. Therefore, no ACK is requested when using address mode 0 or when having any broadcast ad-
dress in the frame (destination net ID and/or destination address). The user shall also not set MAC_NumRetrys 6= 0 in address mode 0. Themisto-I reference manual version 1.0 www.we-online.com/wireless-connectivity August 2019 44 The receiver and transmitter modules must always operate in the same ad-
dress mode! Otherwise, the receiver cannot interpret the received data packet meaning that the packet is discarded!
8.2.5.1 Example 1 Set the address mode to 2 using the CMD_SET_REQ:
Start signal Command Length Settings index Parameter 0x02 0x09 0x02 0x04 0x02 CS 0x0F Response CMD_SET_CNF: Successfully modied the setting. Start signal Command | 0x40 Length Status 0x00 0x02 0x49 0x01 CS 0x4A 8.2.5.2 Example 2 Request the address mode using CMD_GET_REQ:
Start signal Command Length Settings index 0x02 0x0A 0x01 0x04 CS 0x0D Response CMD_GET_CNF: Successfully read out the address mode as 1. Start signal Command | 0x40 Length Status Parameter 0x02 0x4A 0x02 0x00 0x01 CS 0x4B Themisto-I reference manual version 1.0 www.we-online.com/wireless-connectivity August 2019 45 8.2.6 MAC_NumRetrys: Congure the number of retries Settings index Designation Permissible values Default value Permissions Number of Bytes 6 MAC_NumRetrys 0 - 255 0 read/write 1 This UserSetting determines the maximum number of wireless transmission retries. If this parameter is set to a value other than zero, the receiver module will automatically be prompt-
ed to send a wireless acknowledgement ("ACK"). Please note that sending acknowledge-
ments additionally increases the trafc and will have inuence on the duty-cycle, which can be crucial for CE compliance. This parameter shall only be enabled (i.e. set to another value than 0) if the parameter address mode selects a value of 1, 2 or 3 and the customer has congured unique addresses for the entire network. A use of broadcast mes-
sages (destination network ID and/or destination address) is not allowed when MAC_NumRetrys is set to any value not equal to 0. 8.2.6.1 Example 1 Set the transmission retry number to 1 using the CMD_SET_REQ:
Start signal Command Length Settings index Parameter 0x02 0x09 0x02 0x06 0x01 CS 0x0E Response CMD_SET_CNF: Successfully modied the setting. Start signal Command | 0x40 Length Status 0x00 0x02 0x49 0x01 CS 0x4A 8.2.6.2 Example 2 Request the number of retries using CMD_GET_REQ:
Start signal Command Length Settings index 0x02 0x0A 0x01 0x06 CS 0x0F Response CMD_GET_CNF: Successfully read out thenumber of retries as 3. Start signal Command | 0x40 Length Status Parameter 0x02 0x4A 0x02 0x00 0x013 CS 0x49 Themisto-I reference manual version 1.0 www.we-online.com/wireless-connectivity August 2019 46 8.2.7 MAC_DefaultDestNetID: Congure the destination network id Settings index Designation Permissible values Default value Permissions Number of Bytes 7 MAC_DefaultDestNetID 0 - 255 255 read/write 1 This UserSetting species the default destination network ID, which is used in address modes 2 and 3. If the special broadcast id and the broadcast address are set to 255, the packets will be received by all network participants. Its volatile RuntimeSettings can be modied with the command CMD_SET_DESTNETID_REQ at runtime. 8.2.7.1 Example 1 Set the default destination network id to 1 using the CMD_SET_REQ:
Start signal Command Length Settings index Parameter 0x02 0x09 0x02 0x07 0x01 CS 0x0F Response CMD_SET_CNF: Successfully modied the setting. Start signal Command | 0x40 Length Status 0x00 0x02 0x49 0x01 CS 0x4A 8.2.7.2 Example 2 Request the default destination network id using CMD_GET_REQ:
Start signal Command Length Settings index 0x02 0x0A 0x01 0x07 CS 0x0E Response CMD_GET_CNF: Successfully read out the default destination network id as 0. Start signal Command | 0x40 Length Status Parameter 0x02 0x4A 0x02 0x00 0x00 CS 0x4A Themisto-I reference manual version 1.0 www.we-online.com/wireless-connectivity August 2019 47 8.2.8 MAC_DefaultDestAddr: Congure the destination address Settings index Designation Permissible values Default value Permissions 8 MAC_DefaultDestAddr 0 - 65535 65535 read/write Number of Bytes 1-2 This UserSetting speciest destination address, which is used in address modes 1, 2 and 3. If a broadcast address (255 in addressmodes 1 and 2, or 65535 in address mode 3) is used, the packets will be received by all network participants or by participants in the same network id. Its volatile RuntimeSettings can be modied with the command CMD_SET_DESTADDR_REQ at runtime. 8.2.8.1 Example 1 Set the default destination address to 1 using the CMD_SET_REQ. If only one-byte parameter size is used, the LSB is set to the value of the parameter and the MSB is automatically written to 0xFF. Start signal Command Length Settings index Parameter 0x02 0x09 0x02 0x08 0x01 CS 0x00 Response CMD_SET_CNF: Successfully modied the setting. Start signal Command | 0x40 Length Status 0x00 0x02 0x49 0x01 CS 0x4A 8.2.8.2 Example 2 Set the default destination address to 256 (0x0100) using the CMD_SET_REQ. LSB = 0x00, MSB = 0x01. The MSB of the address is used in address mode 3, only. The 2-byte parameter eld has the order LSB rst. Start signal Command Length Settings index Parameter CS 0x00 0x01 0x01 0x02 0x09 0x03 0x08 Response CMD_SET_CNF: Successfully modied the setting. Start signal Command | 0x40 Length Status 0x00 0x02 0x49 0x01 CS 0x4A 8.2.8.3 Example 3 Request the default destination address using CMD_GET_REQ:
Themisto-I reference manual version 1.0 www.we-online.com/wireless-connectivity August 2019 48 Start signal Command Length Settings index 0x02 0x0A 0x01 0x08 CS 0x01 Response CMD_GET_CNF: Successfully read out the default destination address as 0 (0x0000). The 2 byte parameter has the order LSB rst. The return value of this Settings index is al-
ways read as 2 byte parameter. Start signal Command | 0x40 Length Status Parameter 0x02 0x4A 0x03 0x00 CS 0x00 0x00 0x4B Themisto-I reference manual version 1.0 www.we-online.com/wireless-connectivity August 2019 49 8.2.9 MAC_SourceNetID: Congure the source network id Settings index Designation Permissible values Default value Permissions Number of Bytes 10 MAC_SourceNetID 0 - 254 0 read/write 1 This UserSetting species the source network id to be used in address modes 2 and 3. Setting the Source Net ID to Broadcast (255) is not allowed. 8.2.9.1 Example 1 Set the source network id to 1 using the CMD_SET_REQ:
Start signal Command Length Settings index Parameter 0x02 0x09 0x02 0x0A 0x01 CS 0x02 Response CMD_SET_CNF: Successfully modied the setting. Start signal Command | 0x40 Length Status 0x00 0x02 0x49 0x01 CS 0x4A 8.2.9.2 Example 2 Request the source network id using CMD_GET_REQ:
Start signal Command Length Settings index 0x02 0x0A 0x01 0x0A CS 0x03 Response CMD_GET_CNF: Successfully read out the source network id as 2. Start signal Command | 0x40 Length Status Parameter 0x02 0x4A 0x02 0x00 0x02 CS 0x48 Themisto-I reference manual version 1.0 www.we-online.com/wireless-connectivity August 2019 50 8.2.10 MAC_SourceAddr: Congure the source address Settings index Designation Permissible values Default value Permissions 11 MAC_SourceAddr 0 - 65534 0 read/write Number of Bytes 1-2 This UserSetting species the source device address to be used in address modes 1, 2 and 3. The LSB corresponds to the rst byte in "parameter" the MSB (if used) to the second byte. The broadcast address 0xFF (255) or 0xFFFF (65535) must not be used for the source address (LSB, LSB+MSB) and source network id parameters. 8.2.10.1 Example 1 Set the source address to 1 (this will set the LSB to 0x01, the MSB is automatically set to 0xFF) using the CMD_SET_REQ:
Start signal Command Length Settings index Parameter 0x02 0x09 0x02 0x0B 0x01 CS 0x03 Response CMD_SET_CNF: Successfully modied the setting. Start signal Command | 0x40 Length Status 0x00 0x02 0x49 0x01 CS 0x4A 8.2.10.2 Example 2 Set the source address to 256 (LSB =0x00, MSB = 0x01) using the CMD_SET_REQ. The 2 byte parameter is to be used LSB rst. Start signal Command Length Settings index Parameter CS 0x00 0x01 0x02 0x02 0x09 0x03 0x0B Response CMD_SET_CNF: Successfully modied the setting. Start signal Command | 0x40 Length Status 0x00 0x02 0x49 0x01 CS 0x4A 8.2.10.3 Example 3 Request the source address using CMD_GET_REQ:
Themisto-I reference manual version 1.0 www.we-online.com/wireless-connectivity August 2019 51 Start signal Command Length Settings index 0x02 0x0A 0x01 0x0B CS 0x02 Response CMD_GET_CNF: Successfully read out the source address as 2 (0x0002). The 2 byte parameter is to be used LSB rst. Start signal Command | 0x40 Length Status Parameter 0x02 0x4A 0x03 0x00 CS 0x02 0x00 0x49 Themisto-I reference manual version 1.0 www.we-online.com/wireless-connectivity August 2019 52 8.2.11 OpMode: Read the operating mode of the module Settings index Designation Permissible values Default value Permissions Number of Bytes 14 OpMode 16 16 read 1 The OpMode 0x10 (16) is indicating that the module is in command mode. Currently no other OpMode is available. 8.2.11.1 Example 1 Request the operation mode using CMD_GET_REQ:
Start signal Command Length Settings index 0x02 0x0A 0x01 0x0E CS 0x07 Response CMD_GET_CNF: Successfully read out that the operation mode is command mode
(0x10). Start signal Command | 0x40 Length Status Parameter 0x02 0x4A 0x02 0x00 0x10 CS 0x5A Themisto-I reference manual version 1.0 www.we-online.com/wireless-connectivity August 2019 53 8.2.12 CfgFlags: Congure the conguration ags of the module Settings index Designation 15 CfgFlags Permissible values See description Default value Permissions Number of Bytes 0 read/write 2 This parameter is used for the general module conguration. Repeater and sniffer mode cannot be enabled at the same time. A module congured as sniffer will not send any ACKs even if requested by the sender. Bit no. Filter 0 0x0001 Description Set this Bit to 1 to enable the sniffer mode. The sniffer mode will ig-
nore all destination adresses in the radio frames and forward any com-
patible message into a CMD_DATAEX_IND. Not to be used when repeater mode is enabled or MAC_NumRetrys is not equal to 0. 1 - 15 0xFFFE Reserved for future use. All reserved Bits 0. 8.2.12.1 Example 1 Enable the sniffer mode by setting the CfgFlags parameter value to 0x0001 using the CMD_SET_REQ. The 2 byte parameter is to be used LSB rst. Start signal Command Length Settings index Parameter CS 0x01 0x00 0x06 0x02 0x09 0x03 0x0F Response CMD_SET_CNF: Successfully modied the setting. Start signal Command | 0x40 Length Status 0x00 0x02 0x49 0x01 CS 0x4A 8.2.12.2 Example 2 Request the conguration ags using CMD_GET_REQ:
Start signal Command Length Settings index 0x02 0x0A 0x01 0x0F CS 0x06 Response CMD_GET_CNF: Successfully read out the value of CfgFlags. The 2 byte parameter is to be used LSB rst. A parameter value 0x0000 indicates that the sniffer mode is disabled. Themisto-I reference manual version 1.0 www.we-online.com/wireless-connectivity August 2019 54 Start signal Command | 0x40 Length Status Parameter 0x02 0x4A 0x03 0x00 CS 0x00 0x00 0x4B Themisto-I reference manual version 1.0 www.we-online.com/wireless-connectivity August 2019 55 8.2.13 RpFlags: Congure the repeater ags of the module Settings index Designation 16 RpFlags Permissible values See description Default value Permissions Number of Bytes 0 read/write 2 This parameter is used for the repeater conguration. See chapter 13 for more information about the repeater mode. Repeater and sniffer mode cannot be enabled at the same time. The repeater function shall not be enabled in radio proles 3 and 4. The user is responsible for adhering to the statutory regulations for the fre-
quency and spectrum use when using the repeater mode with this module. Especially the duty-cycle of each repeating network node must be checked and controlled by the end system application in respect to CE compliance. Bit no. 0 1 - 15 Description Filter 0x0001 Set this Bit to 1 to enable the repeater mode. 0xFFFE Reserved for future use. All reserved Bits 0. 8.2.13.1 Example 1 Enable the repeater mode by setting the RpFlags parameter value to 0x0001 using the CMD_SET_REQ. The 2 byte parameter is to be used LSB rst. Start signal Command Length Settings index Parameter CS 0x01 0x00 0x19 0x02 0x09 0x03 0x10 Response CMD_SET_CNF: Successfully modied the setting. Themisto-I reference manual version 1.0 www.we-online.com/wireless-connectivity August 2019 56 Start signal Command | 0x40 Length Status 0x00 0x02 0x49 0x01 CS 0x4A 8.2.13.2 Example 2 Request the repeater ags using CMD_GET_REQ:
Start signal Command Length Settings index 0x02 0x0A 0x01 0x10 CS 0x19 Response CMD_GET_CNF: Successfully read out the value of RpFlags. The 2 byte parameter is to be used LSB rst. A parameter value 0x0000 indicates that the repeater mode is disabled. A value of 0x0001 indicates that the repeater mode is enabled. Start signal Command | 0x40 Length Status Parameter 0x02 0x4A 0x03 0x00 CS 0x00 0x00 0x4B Themisto-I reference manual version 1.0 www.we-online.com/wireless-connectivity August 2019 57 8.2.14 RP_NumSlots: Congure the repeater data base Settings index Designation Permissible values Default value Permissions Number of Bytes 17 RP_NumSlots 1 -255 32 read/write 1 An 8 Bit eld that contains the number of time slots to be used for the packet repetition. When using several repeater devices in a single network, repeated data packets may collide on the frequency channel, when all repeater devices send the received packet at the same time. To avoid this, the frequency channel is divided in RP_NumSlots time slots, where each repeater chooses a certain slot by random. The smallest number of time slots that is needed, depends on the network structure and the number of the repeaters used. Assume there are NumRP repeater devices in the range of a sending device, then the probability of two repeated packets collide can be calculated by:
1 RP _N umSlotsN umRP (RP _N umSlots N umRP )!
RP _N umSlots!
(2) Common values are:
NumRP RP_NumSlots Collision probability 2 3 4 5 6 7 32 32 32 64 64 128 3.1%
9.2%
17.7%
14.8%
21.5%
15.4%
In the example network shown in gure 6, there are only two repeaters that can conict each other. Repeater 2 and 3 are forwarding the packet received from Sender 1 "at the same time". Thus, NumRP equals 2 and RP_NumSlots equal 32 is sufcient to have a collision prob-
ability of less than 5%. The time delay used by the repeater device can be determined as the time needed to send one packet (see table 9) times a random number between one and RP_NumSlots. Example:
In RADIO_DefaultRfProfile 0 the maximum send time for one packet is about 40ms. If we use 32 RP_NumSlots, the packet is forwarded latest after 3240ms=1280ms. 8.2.14.1 Example 1 Set the RP_NumSlots to 64 (0x40) using the CMD_SET_REQ. Themisto-I reference manual version 1.0 www.we-online.com/wireless-connectivity August 2019 58 Start signal Command Length Settings index Parameter 0x02 0x09 0x02 0x11 0x40 CS 0x58 Response CMD_SET_CNF: Successfully modied the setting. Start signal Command | 0x40 Length Status 0x00 0x02 0x49 0x01 CS 0x4A 8.2.14.2 Example 2 Request the number of repeater slots using CMD_GET_REQ:
Start signal Command Length Settings index 0x02 0x0A 0x01 0x11 CS 0x18 Response CMD_GET_CNF: Successfully read out the number of repeater slots as 32 (0x20). Start signal Command | 0x40 Length Status Parameter 0x02 0x4A 0x02 0x00 0x20 CS 0x6A Themisto-I reference manual version 1.0 www.we-online.com/wireless-connectivity August 2019 59 8.2.15 FactorySettings: Read out the factory settings Settings index Designation Permissible values Default value Permissions Number of Bytes 32 FactorySettings
-
-
read 8 This parameter denes the factory settings of the module. Byte no. 3 : 0 6 : 4 7 Description Serial number: 3 byte ID (LSB rst), 1 byte PID Hardware version: Major , Minor, Patch Frequency correction factor 8.2.15.1 Example 1 Request the factory settings of the module using CMD_GET_REQ:
Start signal Command Length Settings index 0x02 0x0A 0x01 0x20 CS 0x29 Response CMD_GET_CNF: Successfully read out the FactorySettings. Start signal Command | 0x40 Length Status Parameter 0x02 0x4A 0x09 0x00 0x01 0x00 0x00 0x74 0x00 0x03 0x02 0x00 CS 0x35 Successfully returned the following factory settings, the order of the multi byte parameters was changed to MSB rst to be converted into decimal numbers later:
Serial number: 0x74.000001 (116.000001) with PID 0x74 (116) and SN 0x000001 (1) Hardware version 0x02 0x03 0x00 (2.3.0) Frequency correction factor of 0x00 (0) For being compatible to this manual a Hardware Version of 2.2.0 or newer is required. Full functionality as described in this manual requires a module in Hardware Version 2.3.0 or newer. Themisto-I reference manual version 1.0 www.we-online.com/wireless-connectivity August 2019 60 8.2.16 FirmwareVersion: Read out the rmware version Settings index Designation Permissible values Default value Permissions Number of Bytes 33 FirmwareVersion
-
-
read 3 This parameter denes the version of the rmware currently running on the module. 8.2.16.1 Example 1 Request the factory settings of the module using CMD_GET_REQ:
Start signal Command Length Settings index 0x02 0x0A 0x01 0x21 CS 0x28 Response CMD_GET_CNF: Successfully read out the rmware version as 2.1.0. The sequence inside the eld "Parameter" is Patch, Minor, Major. Start signal Command | 0x40 Length Status 0x00 0x4A 0x02 0x04 Parameter CS 0x00 0x01 0x02 0x4F Themisto-I reference manual version 1.0 www.we-online.com/wireless-connectivity August 2019 61 9 Timing parameters 9.1 Reset behavior Following a reset, a CMD_RESET_IND and a stable low level on the /RTS pin signalizes that the module is ready for operation. During restart the /RTS may be pulled to GND level for a short time (<100s, see gure 4) until it is congured accordingly by the application on the module. 9.1.1 Reset via /RESET pin To force a module restart by means of the /RESET pin, it must rst be drawn to low for at least 100s. After the pin is released, the module will reboot, indicate a CMD_RESET_IND. Please note that the selected UART baud rate will introduce a latency for transmitting the 5-byte packet at module start-up. Recommended procedure: After the /RESET pin is released, wait for up to 200ms + UART transmission time for the CMD_RESET_IND packet (value is to be adopted for the selected UART baud rate) and for the stable low level on the /RTS pin. This section applies only to a situation where the VCC is stable and the mod-
ule was already running. Additional timings are needed when VCC was just applied to the module, see chapter 4.2 9.1.2 Reset as result of a serious error condition If the module runs in a serious error condition, a software reset is executed. In this case, the module starts up (this includes sending a CMD_RESET_IND) automatically and can be used again. The volatile RuntimeSettings are reset to defaults. Therefore, the host needs to detect the start-up indication and implement recongure the modules volatile settings when this event was detected. 9.2 Latencies when leaving standby or shutdown The indication CMD_RESET_IND or CMD_STANDBY_IND (5 Bytes in total) are written before the
/RTS pin is pulled back to low level. Therefore, the start-up time is also dependent on the UART baud rate. The time presented here was measured with the UART default setting of 115200 baud, 8n1. 9.2.1 Wake-up latency from standby The wake-up time from standby is 1.6 ms. Themisto-I reference manual version 1.0 www.we-online.com/wireless-connectivity August 2019 62 Figure 4: Wake-up from standby 9.2.2 Wake-up latency from shutdown The wake-up time from shutdown is 5 ms. Figure 5: Wake-up from shutdown 9.3 Latencies during data transfer / packet generation The data transfer is always buffered, i.e. data received via UART is buffered in the module until a specic event occurs (i.e. packet completed with the CS eld of a command). Subse-
quently, the UART reception is interrupted (ow control with /RTS signal), and the payload data is passed to the internal memory of the wireless transceiver (FIFO). By using several UART buffers the time during which the UART is not receiving can be min-
imized. The wireless transmission starts as soon as the rst complete data packet is available in the transceiver memory. During the continuous wireless transmission, the remaining payload data is transmitted byte by byte on the radio. On the receiver side, the buffer is read as soon as an incoming packet is detected. The entire radio frame is buffered in the radio buffer and processed once the frame was checked against bit errors. If the module detects a packet that requires an ACK, the ACK is sent directly after the full packet reception. The channel access method is always deactivated for any ACKs. Themisto-I reference manual version 1.0 www.we-online.com/wireless-connectivity August 2019 63 10 Radio parameters The default radio parameters are determined by the values of RADIO_DefaultRfProfile, RADIO_DefaultRfChannel and RADIO_DefaultRfTXPower in the user settings. These non-
volatile parameters can be modied using CMD_SET_REQ. To modify their volatile counterparts the commands CMD_SET_PAPOWER_REQ and CMD_SET_CHANNEL_REQ can be used. The parameters must be chosen with prudence not only to ensure optimal functionality, but also in compliance to the appropriate regulatory requirements such as the FCC in the United States of America. The module is pre-certied by mounting it on its EV-board. However, conformance of the end-device to this certication depends on the radiated power. Among other factors, the radiated power depends on the selected antenna, the wiring to the antenna and the quality of the power supply. Thus, it is highly recommended that the end-device manufacturer verify the radiated power on the end application. The frequency channels of the module can be selected from a 500 kHz grid. 10.1 Channel assignment A means that the channel is allowed corresponding to the appropriate operational frequency band requirements.
- means, that the channel is not allowed and is blocked by the rmware.
* means, that the channel in general is allowed, we recommend to use every second channel as the 6dB bandwidth is 500 kHz to fulll FCC $ 15.247 (a)(2). Themisto-I reference manual version 1.0 www.we-online.com/wireless-connectivity August 2019 64 Channel Frequency
[MHz]
Prole 6,8,9 Proposed channel grid 1 Proposed channel grid 2 Channel Frequency
[MHz]
Prole 6,8,9 Proposed channel grid 1 Proposed channel grid 2 200 201 202 203 204 205 206 207 208 209 210 211 212 213 214 215 216 217 218 219 220 221 222 223 224 225 226 902 902.5 903 903.5 904 904.5 905 905.5 906 906.5 907 907.5 908 908.5 909 909.5 910 910.5 911 911.5 912 912.5 913 913.5 914 914.5 915
-
*
A
*
A
*
A
*
A
*
A
*
A
*
A
*
A
*
A
*
A
*
A
*
A
*
A
-
A
*
A
*
A
*
A
*
A
*
A
*
A
*
A
*
A
*
A
*
A
*
A
*
A
*
227 228 229 230 231 232 233 234 235 236 237 238 239 240 241 242 243 244 245 246 247 248 249 250 251 252 915,5 916 916.5 917 917.5 918 918.5 919 919.5 920 920.5 921 921.5 922 922.5 923 923.5 924 924.5 925 925.5 926 926.5 927 927.5 928
*
A
*
A
*
A
*
A
*
A
*
A
*
A
*
A
*
A
*
A
*
A
*
A
*
-
A
*
A
*
A
*
A
*
A
*
A
*
A
*
A
*
A
*
A
*
A
*
A
*
A
-
Table 10: Channel assignment Themisto-I reference manual version 1.0 www.we-online.com/wireless-connectivity August 2019 65 11 Battery powered operation For battery-powered operation, the module provides two sleep modes. Each mode can be entered by a specic command and left by applying a falling edge at the WAKE-UP pin. Enter mode Typical current consumption [A]
Wake-up trigger CPU wake-up time [ms]
Wake-up behavior Wake-up message Shutdown By command Standby By command CMD_SHUTDOWN_REQ CMD_STANDBY_REQ 0.9 2 Falling edge at the WAKE-UP pin See chapter 9 The module restarts such that all volatile settings are lost. RAM is retained and module just continues its operation. CMD_RESET_IND CMD_STANDBY_IND Themisto-I reference manual version 1.0 www.we-online.com/wireless-connectivity August 2019 66 12 Custom rmware 12.1 Custom conguration of standard rmware The conguration of standard rmware includes adoption of the non-volatile Usersettings
(see chapter 8) to customer requirements and creating a customized product on base of the standard product with a unique ordering number for a specic customer that needs this conguration. For example if the UART baud rate shall be changed from the default value to another value. This variant will result in a customer exclusive module with a unique ordering number. This will also x the rmware version to a specic and customer tested version and thus results in a customer exclusive module with a unique ordering number. Further scheduled rmware updates of the standard rmware will not be applied to this variant automatically. Applying updates or further functions require a customer request and customer release procedure. 12.2 Customer specic rmware A customer specic rmware may include "Custom conguration of standard rmware" plus additional options or functions and tasks that are customer specic and not part of the stan-
dard rmware. Further scheduled rmware updates of the standard rmware will not be applied to this vari-
ant automatically. Applying updates or further functions require a customer request and customer release procedure. 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 I2C 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 interface is classied such a custom specic option. Certication critical changes need to be re-evaluated by an external qualied measurement laboratory. These critical changes may occur when e.g. changing radio parameters, the channel access method, the duty-cycle or in case of various other functions and options possibly used or changed by a customer specic rmware. 12.3 Customer rmware A customer rmware is a rmware written and tested by the customer himself or a 3rd party as a customer representative specically for the hardware platform provided by a module. This customer rmware (e.g. in form of a Intel hex le) will be implemented into the modules production process at our production side. This also results in a customer exclusive module with a unique ordering number. The additional information needed for this type of customer rmware, such as hardware specic details and details towards the development of such rmware are not available for the public and can only be made available to qualied customers. Themisto-I reference manual version 1.0 www.we-online.com/wireless-connectivity August 2019 67 The qualication(s) and certication(s) of the standard rmware cannot be ap-
plied to this customer rmware solution without a review and verication. 12.4 Contact for rmware requests Please contact your local eld sales engineer (FSE) or wireless-sales@we-online.com for quotes regarding this topics. Themisto-I reference manual version 1.0 www.we-online.com/wireless-connectivity August 2019 68 13 Flooding mesh: Using the repeater functionality The module can be run as a repeater to articially extend the range of sending devices in an existing network. If the module is congured as repeater, it can be simply added to existing Figure 6: Range extension using several repeaters wireless networks consisting of compatible modules. With this, the newly generated mesh network uses the so-called "ooding technique" to deliver data packets from their source to their destination device. The repeater module itself simply listens to the congured channel and forwards all received packets except the ones addressed to itself. Thereby a random delay is used to avoid RF packet collision. To reduce trafc on the frequency channel, each repeater device checks before repetition, if the channel is free and whether it has already sent this packet before or not. Thus, every repeater sends each packet only once. In a network with NumRP repeater devices, each data packet is repeated NumRP times. Therefore each packet that is send from node A to node B forces a trafc of NumRP+1 data packets in total on the frequency channel. Besides of this, an module that is congured as repeater supports also the functions of a standard module. Thus, it can receive data and can initiate the data transmission to other modules. Themisto-I reference manual version 1.0 www.we-online.com/wireless-connectivity August 2019 69 13.1 Setup of the network and repeater device The repeater mode can be enabled with setting Bit 0 accordingly in the RpFlags. As ACKs are not supported by the repeater mode all network members must make sure that the UserSettings value of MAC_NumRetrys is set to 0. If the module is congured as repeater, the following notes have to be considered:
1. Requirements on the network:
a) The repeater devices have to be line-powered (no battery), since due to packet repetition it demands more energy. b) Depending on the data rate, each repeater should repeat a maximum of 2-5 pack-
ets per second to give a good chance that the repeater is not busy with repeating when already a new packet arrives for repetition. Otherwise, packets can get lost. Please setup your network such that this requirement is fullled. More packets per second will result in more packet loss as the collision probability is increased. c) If the network consists of several layers of repeaters, each layer delays the packet transmission additionally. d) To setup the network all participants have to use the same RADIO_DefaultRfProfile, RADIO_DefaultRfChannel and MAC_DefaultAddressMode. e) The network must be designed by the user in a way the duty-cycle requirements of the local regulatory requirements cannot be exceeded. 2. Information for the repeater device:
a) Acknowledgements (ACK) of successfully received packets are blocked. If an ACK is requested by the sending module, the request is ignored. Furthermore, the repeater does not request any ACK, when repeating a packet. b) The "packet sniffer" mode cannot run at the same time as the module is in repeater mode. c) Each time a packet has been repeated a CMD_REPEAT_IND is output over UART. Depending on the address mode, the address of the involved devices is placed in the CMD_REPEAT_IND telegram. With this the original sender of the RF packet and the device, that is supposed to receive the packet, can be identied. 3. Information for the sending and receiving devices:
a) The senders should send less frequently to avoid packet collision on the frequency channel and to not exceed the duty cycle requirements. b) The repeater devices do not support the feature of ACKs for the successful re-
ception of the packets. Thus, the sender will never receive ACKs if requested. To ensure that transmitted packets are successfully received by the destination device, the network administrator has to integrate his own acknowledging feature in the customers application. To be sure that the sender does not request ACKs the UserSetting MAC_NumRetrys must be set to 0. Themisto-I reference manual version 1.0 www.we-online.com/wireless-connectivity August 2019 70 c) Every repeater sends each packet only once. However, receivers can receive each packet several times (sent by different repeaters), if there are packets of different content in the network temporally close to each other. Thus, on the side of the receiving device, a mechanism shall be implemented that detects and lters double packets. 13.2 Example network Figure 7: Example network In the example network shown above, the goal is to send a packet from device 1 to 5. Without the repeater devices, this would be impossible. The steps are as follows:
1. Sender 1 sends a packet. a) Repeater 2 and 3 receive and accept it at the same time. 2. Device 2 and 3 delay the packet. a) Repeater 3 sends the packet. i. Sender 1 and 6 do not accept it, since their addresses are wrong (unequal 5). Themisto-I reference manual version 1.0 www.we-online.com/wireless-connectivity August 2019 71 ii. Repeater 2 does not accept it, since it has been already received before (1.2). b) Repeater 2 sends the packet. i. Repeaters 3 does not accept it, since it has been already received before
(1.3). ii. Sender 1 does not accept it, since its address is wrong (unequal 5). iii. Repeater 4 receives and accepts the packet. 3. Repeater 4 delays and sends the packet. a) Sender 6 and 7 do not accept it, since their addresses are wrong (unequal 5). b) Repeater 2 does not accept it, since it has been already received before (1.2). c) Receiver 5 accepts it and its successfully delivered (address equals 5). Note that the packet forwarded by repeater 2 and 3 would collide in the frequency channel, if they wouldnt be randomly delayed (see RP_NumSlots). 13.2.1 Application in parallel networks If As described above, a repeater device forwards all packets that are received before. a network needs to have a bigger throughput of data, a parallel network can be set up, that relaxes the stress of the primal network. To do so, all sending, receiving and repeater devices of the parallel network are congured to use a new non-overlapping channel, such that the primal network is not affected at all by the trafc of the parallel network. All nodes in the networks shall not be closer to each other than 2 meters, if that connot be avoided the tx power parameter of devices close to each other must be reduced. Themisto-I reference manual version 1.0 www.we-online.com/wireless-connectivity August 2019 72 14 Firmware update We highly recommend having the UART or JTAG accessible in any application to have the possibility to perform a rmware update. Firmware updates can only be performed through this interfaces once a module is implemented into a customer PCB. Flashing a customer or non standard rwmare makes all regulatory and con-
formity information and certicates of chapter 22 invalid. 14.1 Update using the UART interface Only the UTDX, URXD and GND signals are needed for this connection. A suiting adapter/-
converter is required for a PC connection (e.g. the FTDI TTL-323R-3V3 UART to USB converter). None of the module pins is 5V TTL compatible. Applying overvoltage to any pin may damage the hardware permanently. Make sure your levels are in the range of the electrical specication shown in chapter 2 14.1.1 ACC Software As long as our standard rmware is running on the module, it can be updated with the PC utility "AMBER Cong Center" (ACC) via the serial interface. Therefore the module must be reset while holding the BOOT pin on a high level until the bootloader is active. If the module is not directly connected to a PC, at least the UART should be made accessi-
ble, e.g. by means of suitable connectors. The pin BOOT must be connected to a high level (while and short after a reset) in order to start the bootloader. If the BOOT pin is connected to GND the application will start, so for normal operation the level on the BOOT pin must be pulled to GND (e.g. using a pull-down with up to 1kW) to make sure the application is started. The reset signal shall be connectable to GND for performing a reset of the module (e.g. using a push-button which pulls to GND when pressed). The /RESET pin has an internal pull-up of 100 kW. 14.1.2 Generic UART solution This information is not available for public and requires a NDA and Licensing procedure for qualied customers. Additional information is available upon request from wireless-
sales@we-online.com. Themisto-I reference manual version 1.0 www.we-online.com/wireless-connectivity August 2019 73 14.2 Update using JTAG Using this interface option allows performing a fail-safe rmware update even in case of a broken rmware or misconguration. The user needs hardware and software tools to be able to perform this procedure. In detail those are:
Flash adapter for Cortex M C supporting TI CC1310 (Not every adapter supports the used connection methods). Recommended adapters are: "Segger J-Flash" and "TI XDS110v3"
Flasher software according to the used asher adapter
/RESET, GND and VCC are needed for the JTAG connection JTAG connection is supported through the modules pads i1 to i4 Our binary rmware les are not publicly available and require a NDA and licensing proce-
dure for qualied customers. Additional information is available upon request from wireless-sales@we-online.com. Using this method may require a full chip-erase to be able to write a new mr-
ware into the module. Never erase the entire chip. Some memory segments (such as CCFG and FactorySettings) must be retained if original rmware shall be ashed onto the C again. Missing, illegal or erased parameters/ash segments may lead to module malfunctions when original rmware is used. Themisto-I reference manual version 1.0 www.we-online.com/wireless-connectivity August 2019 74 15 Firmware history Version 2.4.0 "Release"
Initial release. Known issues:
TI-RTOS: Additional latencies up to 5ms due to task priorities may occur. In case a CMD_DATAEX_REQ is used with a wrong channel number, the module answers with a CMD_DATAEX_CNF (0x02 0x41 0x01 0x02 0x40) instead of a CMD_DATA_CNF (0x02 0x40 0x01 0x02 0x41) message. Themisto-I reference manual version 1.0 www.we-online.com/wireless-connectivity August 2019 75 16 Design in guide 16.1 Advice for schematic and layout For users with less RF experience it is advisable to closely copy the relating evaluation board with respect to schematic and layout, as it is a proven design. The layout should be conducted with particular care, because even small deciencies could affect the radio performance and its range or even the conformity. The following general advice should be taken into consideration:
A clean, stable power supply is strongly recommended. Interference, especially oscil-
lation can severely restrain range and conformity. Variations in voltage level should be avoided. LDOs, properly designed in, usually deliver a proper regulated voltage. Blocking capacitors and a ferrite bead in the power supply line can be included to lter and smoothen the supply voltage when necessary. No xed values can be recommended, as these depend on the circumstances of the application (main power source, interferences etc.). The use of an external reset IC should be considered if one of the following points is relevant:
The slew rate of the power supply exceeds the electrical specications. The effect of different current consumptions on the voltage level of bat-
teries or voltage regulators should be considered. The module draws higher currents in certain scenarios like start-up or radio transmit which may lead to a voltage drop on the supply. A restart under such circum-
stances should be prevented by ensuring that the supply voltage does not drop below the minimum specications. Voltage levels below the minimum recommended voltage level may lead to misfunction. The /Reset pin of the module shall be held on LOW logic level whenever the VCC is not stable or below the minimum operating Voltage. Special care must be taken in case of battery powered systems. Themisto-I reference manual version 1.0 www.we-online.com/wireless-connectivity August 2019 76 Elements for ESD protection should be placed on all pins that are accessible from the outside and should be placed close to the accessible area. For example, the RF-pin is accessible when using an external antenna and should be protected. ESD protection for the antenna connection must be chosen such as to have a minimum effect on the RF signal. For example, a protection diode with low capacitance such as the LXES15AAA1-100 or a 68 nH air-core coil connecting the RF-line to ground give good results. Placeholders for optional antenna matching or additional ltering are recommended. The antenna path should be kept as short as possible. Again, no xed values can be recommended, as they depend on the inuenc-
ing circumstances of the application (antenna, interferences etc.). Figure 8: Layout To avoid the risk of short circuits and interference there should be no routing under-
neath the module on the top layer of the baseboard. On the second layer, a ground plane is recommended, to provide good grounding and shielding to any following layers and application environment. In case of integrated antennas it is required to have areas free from ground. This area should be copied from the evaluation board. The area with the integrated antenna must overlap with the carrier board and should not 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 It should not be placed in the middle of the main board or far away the main board. from the edge. This is to avoid tracks beside the antenna. Themisto-I reference manual version 1.0 www.we-online.com/wireless-connectivity August 2019 77 Filter and blocking capacitors should be placed directly in the tracks without stubs, to achieve the best effect. Antenna matching elements should be placed close to the antenna / connector, block-
ing capacitors close to the module. Ground connections for the module and the capacitors should be kept as short as possible and with at least one separate through hole connection to the ground layer. ESD protection elements should be placed as close as possible to the exposed areas. Figure 9: Placement of the module with integrated antenna 16.2 Dimensioning of the micro strip antenna line The antenna track has to be designed as a 50W feed line. The width W for a micro strip can be calculated using the following equation:
!
W = 1:25 5:98 H 50p e
r +1:41 87
Tmet
(3) Example:
A FR4 material with er = 4.3, a height H = 1000 m and a copper thickness of Tmet= 18 m Themisto-I reference manual version 1.0 www.we-online.com/wireless-connectivity August 2019 78 Figure 10: Dimensioning the antenna feed line as micro strip will lead to a trace width of W 1.9 mm. To ease the calculation of the micro strip line (or e.g. a coplanar) many calculators can be found in the internet. As rule of thumb a distance of about 3W should be observed between the micro strip and other traces / ground. The micro strip refers to ground, therefore there has to be the ground plane underneath the trace. Keep the feeding line as short as possible. 16.3 Antenna solutions There exist several kinds of antennas, which are optimized for different needs. Chip anten-
nas are optimized for minimal size requirements but at the expense of range, PCB antennas are optimized for minimal costs, and are generally a compromise between size and range. Both usually t inside a housing. Range optimization in general is at the expense of space. Antennas that are bigger in size, so that they would probably not t in a small housing, are usually equipped with a RF con-
nector. A benet of this connector may be to use it to lead the RF signal through a metal plate (e.g. metal housing, cabinet). As a rule of thumb a minimum distance of l/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 inuence 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 eld blocking. The choice of antenna might have inuence on the safety requirements. In the following chapters, some special types of antenna are described. Themisto-I reference manual version 1.0 www.we-online.com/wireless-connectivity August 2019 79 16.3.1 Wire antenna An effective antenna is a l/4 radiator with a suiting ground plane. The simplest realization is a piece of wire. Its length is depending on the used radio frequency, so for example 8.6 cm 868.0 MHz and 3.1 cm for 2.440 GHz as frequency. This radiator needs a ground plane at its feeding point. Ideally, it is placed vertically in the middle of the ground plane. As this is often not possible because of space requirements, a suitable compromise is to bend the wire away from the PCB respective to the ground plane. The l/4 radiator has approximately 40 W input impedance, therefore matching is not required. 16.3.2 Chip antenna There are many chip antennas from various manufacturers. The benet of a chip antenna is obviously the minimal space required and reasonable costs. However, this is often at the expense of range. For the chip antennas, reference designs should be followed as closely as possible, because only in this constellation can the stated performance be achieved. 16.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 benets 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 nished antenna. Most PCB antenna designs are a compromise of range and space between chip antennas and connector antennas. Themisto-I reference manual version 1.0 www.we-online.com/wireless-connectivity August 2019 80 16.3.4 Antennas provided by Wrth Elektronik eiSos 16.3.4.1 2600130011 - Helike - 169 MHz dipole antenna Figure 11: 169 MHz dipole-antenna Value 169 50
2.1 1 Specication Frequency range [MHz]
Impedance [W]
VSWR Gain [dBi]
Dimensions (L x d) [mm] 320 x 15 Weight [g]
Connector Operating Temp. [C]
42 SMA plug
-40 +85 This antenna requires a ground plane which will inuence the electrical param-
eters. Themisto-I reference manual version 1.0 www.we-online.com/wireless-connectivity August 2019 81 16.3.4.2 2600130041 - Herse - 434 MHz dipole antenna Figure 12: 434 MHz dipole-antenna Value 433 50
1.5 Vertical Omni 0 TPEE Specication Frequency range [MHz]
Impedance [W]
VSWR Polarization Radiation Gain [dBi]
Antenna Cover Dimensions (L x d) [mm] 90 x 12 Weight [g]
Connector Operating Temp. [C]
9.6 SMA plug
-40 +80 This antenna requires a ground plane which will inuence the electrical param-
eters. Themisto-I reference manual version 1.0 www.we-online.com/wireless-connectivity August 2019 82 16.3.4.3 2600130081 - Hyperion-I - 868 MHz dipole antenna Figure 13: 868 MHz dipole-antenna Ideally suited for applications where no ground plane is available. The 2600130081 antenna can be also used for 902MHz - 928MHz range. Value 868 853 883 0.5 wave
2.0 50 SMA (Male) Specication Center frequency [MHz]
Frequency range [MHz]
Wavelength VSWR Impedance [W]
Connector Dimensions (L x d) [mm] 142 x 10 Peak gain [dBi]
Operating temp. [C]
-2.3
-30 +80 Themisto-I reference manual version 1.0 www.we-online.com/wireless-connectivity August 2019 83 16.3.4.4 2600130082 - Hyperion-II - 868 MHz magnetic base antenna Well suited for applications where the RF is lead through a metal wall that could serve as ground plane to the antenna. Figure 14: 868 MHz magnet foot antenna with 1.5 m antenna cable The 2600130082 is a kind of l/4 radiator and therefore needs a ground plane at the feeding point. Value 824 894
2.0 Vertical 505 SMA (Male) Specication Frequency range [MHz]
VSWR Polarisation Impedance [W]
Connector Dimensions (L x d) [mm] 89.8 x 27 Weight [g]
Operating temp. [C]
505
-30 +60 Themisto-I reference manual version 1.0 www.we-online.com/wireless-connectivity August 2019 84 16.3.4.5 2600130021 - Himalia - 2.4 GHz dipole antenna Figure 15: 2.4 GHz dipole-antenna Due to the fact, that the antenna has dipole topology there is no need for an additional ground plane. Nevertheless the specication was measured edge mounted and 90 bent on a 100 x 100 mm ground plane. Value 2.4 2.5 50
2:1 Linear Omni-Directional 2.8
-0.6 85 %
Specication Frequency range [GHz]
Impedance [W]
VSWR Polarization Radiation Peak Gain [dBi]
Average Gain [dBi]
Efciency Dimensions (L x d) [mm] 83.1 x 10 Weight [g]
Connector Operating temp. [C]
7.4 SMA plug
-40 +80 Special care must be taken for FCC certication when using this external antenna to fulll the requirement of permanently attached antenna or unique coupling for example by using the certied dipole antenna in a closed housing, so that only through professional installation it is possible to remove it. Themisto-I reference manual version 1.0 www.we-online.com/wireless-connectivity August 2019 85 17 Reference design Themisto-I was tested and certied on the corresponding Themisto-I evaluation board. For the compliance with the FCC 15.247, the evaluation board serves as reference design. This is no discrepancy due to the fact that the evaluation board itself does not fall within the scope of FCC 15.247 according to 47 CFR 2.803 (c) exemptions (iv) evaluation kit, 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 Themisto-I evaluation board. Themisto-I reference manual version 1.0 www.we-online.com/wireless-connectivity August 2019 86 17.1 Schematic Themisto-I reference manual version 1.0 www.we-online.com/wireless-connectivity August 2019 87 Themisto-I reference manual version 1.0 www.we-online.com/wireless-connectivity August 2019 88 17.2 Layout Figure 16: Assembly diagram Themisto-I reference manual version 1.0 www.we-online.com/wireless-connectivity August 2019 89 Figure 17: Top and Bottom Layer Themisto-I reference manual version 1.0 www.we-online.com/wireless-connectivity August 2019 90 18 Manufacturing information 18.1 Moisture sensitivity level This wireless connectivity product is categorized as JEDEC Moisture Sensitivity Level 3 (MSL3), which requires special handling. More information regarding the MSL requirements can be found in the IPC/JEDEC J-STD-020 standard on www.jedec.org. More information about the handling, picking, shipping and the usage of moisture/reow and/or process sensitive products can be found in the IPC/JEDEC J-STD-033 standard on www.jedec.org. 18.2 Soldering 18.2.1 Reow soldering Attention must be paid on the thickness 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. Prole feature Preheat temperature Min Preheat temperature Max Preheat time from TS Min to TS Max Ramp-up rate (TL to TP) Liquidous temperature Time tL maintained above TL Peak package body temperature Time within 5C of actual preak temperature Ramp-down Rate (TP to TL) Time 20C to TP TS Min TS Max tS TL tL TP tP Value 150C 200C 60 - 120 seconds 3C / second max. 217C 60 - 150 seconds see table below 20 - 30 seconds 6C / second max. 8 minutes max. Table 11: Classication reow soldering prole, Note: refer to IPC/JEDEC J-STD-020E Themisto-I reference manual version 1.0 www.we-online.com/wireless-connectivity August 2019 91 Package thickness
< 1.6mm 1.6mm - 2.5mm
> 2.5mm Volume mm3
<350 260C 260C 250C Volume mm3 350-2000 260C 250C 245C Volume mm3
>2000 260C 245C 245C Table 12: Package classication reow temperature, PB-free assembly, Note: refer to IPC/-
JEDEC J-STD-020E It is recommended to solder this module on the last reow cycle of the PCB. For solder paste use a LFM-48W or Indium based SAC 305 alloy (Sn 96.5 / Ag 3.0 / Cu 0.5 / Indium 8.9HF /
Type 3 / 89%) type 3 or higher. The reow prole must be adjusted based on the thermal mass of the entire populated PCB, heat transfer efciency of the reow oven and the specic type of solder paste used. Based on the specic process and PCB layout the optimal soldering prole must be adjusted and veried. Other soldering methods (e.g. vapor phase) have not been veried and have to be validated by the customer at their own risk. Rework is not recommended. Figure 18: Reow soldering prole After reow soldering, visually inspect the board to conrm proper alignment Themisto-I reference manual version 1.0 www.we-online.com/wireless-connectivity August 2019 92 TimeTemperatureTptptLtSTs maxTs minTC 5CTL25Time 25C to PeakPreheat AreaMax. Ramp Up RateMax. Ramp Down Rate 18.2.2 Cleaning Do not clean the product. Any residue cannot be easily removed by washing. Use a "no clean" soldering paste and do not clean the board after soldering. Do not clean the product with water. Capillary effects can draw water into the gap between the host PCB and the module, absorbing water underneath it. If water is trapped inside, it may short-circuit adjoining pads. The water may also destroy the label and ink-jet printed text on it. Cleaning processes using alcohol or other organic solvents may draw solder ux residues into the housing, which wont be detected in a post-wash inspection. The solvent may also destroy the label and ink-jet printed text on it. Do not use ultrasonic cleaning as it will permanently damage the part, particularly the crystal oscillators. 18.2.3 Other notations Conformal coating of the product will result in the loss of warranty. The RF shields will not protect the part from low-viscosity coatings. Do not attempt to improve the grounding by forming metal strips directly to the EMI covers or soldering on ground cables, as it may damage the part and will void the warranty. Always solder 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. 18.3 ESD handling This product is highly sensitive to electrostatic discharge (ESD). As such, always use prop-
er ESD precautions when handling. Make sure to handle the part properly throughout all stages of production, including on the host PCB where the module is installed. For ESD ratings, refer to the module series maximum ESD section. For more information, refer to the relevant chapter 2. Failing to follow the aforementioned recommendations can result in severe damage to the part. the rst contact point when handling the PCB is always between the local GND and the host PCB GND, unless there is a galvanic coupling between the local GND (for example work table) and the host PCB GND. Before assembling an antenna patch, connect the grounds. While handling the RF pin, avoid contact with any charged capacitors and be careful when contacting any materials that can develop charges (for example coaxial cable with around 50-80 pF/m, patch antenna with around 10 pF, soldering iron etc.) Themisto-I reference manual version 1.0 www.we-online.com/wireless-connectivity August 2019 93 Do not touch any exposed area of the antenna to avoid electrostatic discharge. Do not let the antenna area be touched in a non ESD-safe manner. When soldering, use an ESD-safe soldering iron. 18.4 Safety recommendations It is your duty to ensure that the product is allowed to be used in the destination country and within the required environment. Usage of the product can be dangerous and must be tested and veried by the end user. Be especially careful of:
Use in areas with risk of explosion (for example oil reneries, gas stations). Use in areas such as airports, aircraft, hospitals, etc., where the product may interfere with other electronic components. It is the customers responsibility to ensure compliance with all applicable legal, regulatory and safety-related requirements as well as applicable environmental regulations. Disassem-
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 re and security prevention standards. Handle with care. Avoid touching the pins as there could be ESD damage. Be careful when working with any external components. When in doubt consult the technical documentation and relevant standards. Always use an antenna with the proper characteris-
tics. Since the module itself is not fused the voltage supply shall be fed from a limited power source according to EN 62368-1 class PS1. Modules with high output power of up to 500mW, as for example the Thebe family, generate a high amount of warmth while transmitting. The manufactur-
er of the end device must take care of potentially neccessary actions for his application. Themisto-I reference manual version 1.0 www.we-online.com/wireless-connectivity August 2019 94 19 Physical dimensions 19.1 Dimensions 19.2 Weight Dimensions 17 x 27 x 3.8 mm Table 13: Dimensions Weight 3g Table 14: Weight Themisto-I reference manual version 1.0 www.we-online.com/wireless-connectivity August 2019 95 19.3 Module drawing Figure 19: Module dimensions [mm]
Themisto-I reference manual version 1.0 www.we-online.com/wireless-connectivity August 2019 96 24,027,00,417,00,43,80,214,02,04,0112132322,01,01,5 19.4 Footprint Figure 20: Footprint and dimensions [mm]
The following points have to be considered:
To avoid the risk of short circuits, a minimum clearance of at least 14 mm between the opposing pad rows has to be maintained! No routing on the top layer of a carrier PCB
(i.e. "under" the module) shall be performed. For the module variant with integrated antenna the marked corner area of 7.3 x 13.8 m-
m has to be kept free from metal, on any layer. The four bottom side pads are optionally for the rmware update using JTAG can be left open when JTAG update is not needed in the customers application. This footprint is also compatible to the radio modules Tarvos-I, Tarvos-II, Thadeus and Titania. 19.5 Antenna free area To avoid inuence and mismatching of the antenna the recommended free area around the antenna should be maintained. As rule of thumb a minimum distance of metal parts to the antenna of l/10 should be kept (see gure 20). Even though metal parts would inuence the characteristic of the antenna, but the direct inuence and matching keep an acceptable level. Themisto-I reference manual version 1.0 www.we-online.com/wireless-connectivity August 2019 97 18,024,01,02,04,02,022,01,54,02,26,0 20 Marking 20.1 Lot number The 15 digit lot number is printed in numerical digits as well as in form of a machine readable bar code. It is divided into 5 blocks as shown in the following picture and can be translated according to the following table. Figure 21: Lot number structure Block Information 1 2 3 4 5 eiSos internal, 3 digits eiSos internal, 2 digits Hardware version, 3 digits Date code, 4 digits Firmware version, 3 digits Example(s) 439 01 V2.4 = 024, V12.2 = 122 1703 = week 03 in year 2017, 1816 = week 16 in year 2018 V3.2 = 302, V5.13 = 513 Table 15: Lot number details As the user can perform a rmware update the printed lot number only shows the factory delivery state. The currently installed rmware can be requested from the module using the corresponding product specic command. The rmware version as well as the hardware version are restricted to show only major and minor version not the patch identier. Themisto-I reference manual version 1.0 www.we-online.com/wireless-connectivity August 2019 98 20.2 General labeling information The module labels may include the following elds:
Manufacturer identication WE, Wrth Elektronik or Wrth Elektronik eiSos WE Order Code and/or article alias Serial number or MAC address Certication identiers (CE, FCC ID, IC, ARIB,...) Bar code or 2D code containing the serial number or MAC address The serial number includes the product ID (PID) and an unique 6 digit number. The rst 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 identier (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 identier. Figure 22: Label of the Themisto-I Themisto-I reference manual version 1.0 www.we-online.com/wireless-connectivity August 2019 99 21 Information for Ex protection In case the end product should be used in Ex protection areas the following information can be used:
The module itself is unfused. The maximum output power of the module is 25dBm. The total amount of capacitivity of all capacitors is 56.7F. The total amount of inductivity of all inductors is 6.9 H. Themisto-I reference manual version 1.0 www.we-online.com/wireless-connectivity August 2019 100 22 Regulatory compliance information 22.1 Important notice FCC The use of RF frequencies is limited by national regulations. The Themisto-I has been designed to comply with the FCC Part 15. The Themisto-I can be operated without notication 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. 22.2 Conformity assessment of the nal product The Themisto-I is a subassembly. It is designed to be embedded into other products (prod-
ucts incorporating the Themisto-I are henceforward referred to as "nal products"). It is the responsibility of the manufacturer of the nal product to ensure that the nal product is in compliance with the essential requirements of the underlying national radio regulations. The conformity assessment of the subassembly Themisto-I carried out by Wrth Elektronik eiSos does not replace the required conformity assessment of the nal product. 22.3 Exemption clause Relevant regulation requirements are subject to change. Wrth Elektronik eiSos does not guarantee the accuracy of the before mentioned information. Directives, technical standards, procedural descriptions and the like may be interpreted differently by the national authori-
ties. Equally, the national laws and restrictions may vary with the country. In case of doubt or uncertainty, we recommend that you consult with the authorities or ofcial certication organizations of the relevant countries. Wrth Elektronik eiSos is exempt from any respon-
sibilities or liabilities related to regulatory compliance. Notwithstanding the above, Wrth Elektronik eiSos makes no representations and war-
ranties of any kind related to their accuracy, correctness, completeness and/or usability for customer applications. No responsibility is assumed for inaccuracies or incompleteness. Themisto-I reference manual version 1.0 www.we-online.com/wireless-connectivity August 2019 101 22.4 FCC Compliance Statement FCC ID: R7T0904119 This device complies with Part 15 of the FCC Rules. 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.
(FCC 15.19) Modications (FCC 15.21) Caution: Changes or modications for this equipment not expressly approved by Wrth Elek-
tronik eiSos may void the FCC authorization to operate this equipment. 22.5 IC Compliance Statement Certication Number: 5136A-0904119 PMN: 0904119 This device complies with Industry Canada licence-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 prsent appareil est conforme aux CNR dIndustrie Canada applicables aux appareils radio exempts de licence. Lexploitation est autorise aux deux conditions suivantes : (1) lappareil ne doit pas produire de brouillage, et (2) lutilisateur de lappareil doit accepter tout brouillage radiolectrique subi, mme si le brouillage est susceptible den compromettre le fonctionnement. 22.6 FCC and IC requirements to OEM integrators This module has been granted modular approval. OEM integrators for host products may use the module in their nal products without additional FCC/IC (Industry Canada) certica-
tion if they meet the following conditions. Otherwise, additional FCC/IC approvals must be obtained. The host product with the module installed must be evaluated for simultaneous transmission requirements. The users manual for the host product must clearly indicate the operating requirements and conditions that must be observed to ensure compliance with current FCC/IC RF exposure guidelines. To comply with FCC/IC regulations limiting both maximum RF output power and human exposure to RF radiation, the maximum antenna gain including cable loss in a mobile-
only exposure condition must not exceed 0dBi. Themisto-I reference manual version 1.0 www.we-online.com/wireless-connectivity August 2019 102 A label must be afxed to the outside of the host product with the following statements:
This device contains FCCID: R7T0904119 This equipment contains equipment certied under ICID: 5136A-0904119 The nal host / module combination may also need to be evaluated against the FCC Part 15B criteria for unintentional radiators in order to be properly authorized for oper-
ation as a Part 15 digital device. If the nal host / module combination is intended for use as a portable device (see classications below) the host manufacturer is responsible for separate approvals for the SAR requirements from FCC Part 2.1093 and RSS-102. OEM requirements:
The OEM must ensure that the following conditions are met. End users of products, which contain the module, must not have the ability to alter the rmware that governs the operation of the module. The agency grant is valid only when the module is incorporated into a nal product by OEM integrators. The end-user must not be provided with instructions to remove, adjust or install the module. The Original Equipment Manufacturer (OEM) must ensure that FCC labeling require-
ments are met. This includes a clearly visible label on the outside of the nal product. Attaching a label to a removable portion of the nal product, such as a battery cover, is not permitted. The label must include the following text:
Contains FCC ID: R7T0904119 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. When the device is so small or for such use that it is not practicable to place the s-
tatement above on it, the information required by this paragraph shall be placed in a prominent location in the instruction manual or pamphlet supplied to the user or, alter-
natively, shall be placed on the container in which the device is marketed. However, the FCC identier or the unique identier, as appropriate, must be displayed on the device. The user manual for the end product must also contain the text given above. Changes or modications not expressly approved could void the users authority to operate the equipment. The OEM must ensure that timing requirements according to 47 CFR 15.231(a-c) are met. The OEM must sign the OEM Modular Approval Agreement. The module must be used with only the following approved antenna(s). Themisto-I reference manual version 1.0 www.we-online.com/wireless-connectivity August 2019 103 The OEM shall perform testing in accordance to 996369 D04 Module Integration Guide V01. 22.7 Pre-certied antennas The certication is valid for antennas with gain smaller than 1.7dB, for example:
1/2 dipole (1.6dBi). 1/4 wave ground plane antenna (0.3dBi). Using antennas with higher gain the requirements for power spectrum density might be violated for radio prole 9. Using other antennas, the integrator has to retest and either reduce the output power or limit the duty cycle. Themisto-I reference manual version 1.0 www.we-online.com/wireless-connectivity August 2019 104 23 Important notes The following conditions apply to all goods within the wireless connectivity product range of Wrth Elektronik eiSos GmbH & Co. KG:
23.1 General customer responsibility Some goods within the product range of Wrth 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 con-
cerning 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 specic product characteristics described in the product speci-
cation 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. 23.2 Customer responsibility related to specic, in particular safety-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 specications. The same statement is valid for all software sourcecode and rmware parts contained in or used with or for products in the wireless connectivity and sensor product range of Wrth 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. 23.3 Best care and attention Any product-specic data sheets, manuals, application notes, PCNs, warnings and cautions must be strictly observed in the most recent versions and matching to the products rmware revisions. This documents can be downloaded from the product specic sections on the wireless connectivity homepage. 23.4 Customer support for product specications Some products within the product range may contain substances, which are subject to re-
strictions in certain jurisdictions in order to serve specic technical requirements. Necessary information is available on request. In this case, the eld sales engineer or the internal sales person in charge should be contacted who will be happy to support in this matter. Themisto-I reference manual version 1.0 www.we-online.com/wireless-connectivity August 2019 105 23.5 Product improvements Due to constant product improvement, product specications may change from time to time. As a standard reporting procedure of the Product Change Notication (PCN) according to the JEDEC-Standard, we inform about major changes. In case of further queries regarding the PCN, the eld 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 23.1 and 23.2 remains unaffected. All wireless connectivity module driver software wireless con-
nectivity SDK and its source codes as well as all PC software tools are not subject to the Product Change Notication information process. 23.6 Product life cycle Due to technical progress and economical evaluation we also reserve the right to discontin-
ue production and delivery of products. As a standard reporting procedure of the Product Termination Notication (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 veried with the eld 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 con-
sidered. The approach named above does not apply in the case of individual agreements deviating from the foregoing for customer-specic products. 23.7 Property rights All the rights for contractual products produced by Wrth 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 Wrth Elektronik eiSos GmbH & Co. KG. Wrth 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 Wrth Elektronik eiSos GmbH & Co. KG components or services are used. 23.8 General terms and conditions Unless otherwise agreed in individual contracts, all orders are subject to the current ver-
sion of the "General Terms and Conditions of Wrth Elektronik eiSos Group", last version available at www.we-online.com. Themisto-I reference manual version 1.0 www.we-online.com/wireless-connectivity August 2019 106 24 Legal notice 24.1 Exclusion of liability Wrth Elektronik eiSos GmbH & Co. KG considers the information in this document to be correct at the time of publication. However, Wrth Elektronik eiSos GmbH & Co. KG re-
serves the right to modify the information such as technical specications 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 notication to customers. The customer must make sure that the information used corresponds to the latest published information. Wrth Elektronik eiSos GmbH & Co. KG does not assume any liability for the use of its products. Wrth 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, Wrth Elektronik eiSos GmbH & Co. KG makes no repre-
sentations 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 Wrth Elektronik eiSos GmbH & Co. KG regarding third-party prod-
ucts or services does not constitute a license to use such products or services or a warranty or endorsement thereof. 24.2 Suitability in customer applications The customer bears the responsibility for compliance of systems or units, in which Wrth 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 le-
gal, regulatory and safety-related requirements concerning its products, and any use of Wrth Elektronik eiSos GmbH & Co. KG components in its applications, notwithstanding any applications-related in-formation or support that may be provided by Wrth Elektronik eiSos GmbH & Co. KG. Customer represents and agrees that it has all the necessary ex-
pertise 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 Wrth Elektronik eiSos GmbH & Co. KGand its representatives against any damages arising out of the use of any Wrth Elektronik eiSos GmbH & Co. KG components in safety-critical applications. 24.3 Trademarks AMBER wireless is a registered trademark of Wrth Elektronik eiSos GmbH & Co. KG. All other trademarks, registered trademarks, and product names are the exclusive property of the respective owners. 24.4 Usage restriction Wrth 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 equip-
ment where a higher safety standard and reliability standard is especially required or where Themisto-I reference manual version 1.0 www.we-online.com/wireless-connectivity August 2019 107 a failure of the product is reasonably expected to cause severe personal injury or death, unless the parties have executed an agreement specically governing such use. Moreover, Wrth 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. Wrth Elektronik eiSos GmbH & Co. KG must be informed about the intent of such usage before the design-in stage. In addition, sufcient 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 Wrth Elektronik eiSos GmbH & Co. KG products, the customer agrees to these terms and conditions. Themisto-I reference manual version 1.0 www.we-online.com/wireless-connectivity August 2019 108 25 License terms This License Terms will take effect upon the purchase and usage of the Wrth Elektronik eiSos GmbH & Co. KG wireless connectivity products. You hereby agree that this license terms is applicable to the product and the incorporated software, rmware and source codes
(collectively, "Software") made available by Wrth Elektronik eiSos in any form, including but not limited to binary, executable or source code form. The software included in any Wrth Elektronik eiSos wireless connectivity product is pur-
chased 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. 25.1 Limited license Wrth 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 Wrth 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 Wrth 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 Wrth Elektronik eiSos under strict adherence of this license terms. Wrth 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 Wrth 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. 25.2 Usage and obligations The responsibility for the applicability and use of the Wrth Elektronik eiSos wireless con-
nectivity 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 specic product characteristics described in the product specication is valid and suitable for your respective application or not. You are responsible for using the Wrth 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. Wrth 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, Wrth 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 Wrth Elektronik eiSos about the intent of such usage before Themisto-I reference manual version 1.0 www.we-online.com/wireless-connectivity August 2019 109 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 rami-
cations 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 Wrth Elektronik eiSos products with the incorporated Firmware in such safety-critical ap-
plications, notwithstanding any applications-related information or support that may be pro-
vided by Wrth Elektronik eiSos. YOU SHALL INDEMNIFY WRTH ELEKTRONIK EISOS AGAINST ANY DAMAGES ARISING OUT OF THE USE OF WRTH ELEKTRONIK EISOS PRODUCTS WITH THE INCORPORATED FIRMWARE IN SUCH SAFETY-CRITICAL AP-
PLICATIONS. 25.3 Ownership The incorporated Firmware created by Wrth Elektronik eiSos is and will remain the exclu-
sive property of Wrth Elektronik eiSos. 25.4 Firmware update(s) You have the opportunity to request the current and actual Firmware for a bought wireless connectivity Product within the time of warranty. However, Wrth Elektronik eiSos has no obligation to update a modules rmware in their production facilities, but can offer this as a service on request. The upload of rmware updates falls within your responsibility, e.g. via ACC or another software for rmware updates. Firmware updates will not be communicated automatically. It is within your responsibility to check the current version of a rmware in the latest version of the product manual on our website. The revision table in the product manual provides all necessary information about rmware updates. There is no right to be provided with binary les, so called "Firmware images", those could be ashed through JTAG, SWD, Spi-Bi-Wire, SPI or similar interfaces. 25.5 Disclaimer of warranty THE FIRMWARE IS PROVIDED "AS IS". YOU ACKNOWLEDGE THAT WRTH ELEK-
TRONIK 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. WRTH 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 WRTH ELEKTRONIK EISOS PRODUCT WITH THE INCOR-
PORATED FIRMWARE IS USED. INFORMATION PUBLISHED BY WRTH ELEKTRONIK EISOS REGARDING THIRD-PARTY PRODUCTS OR SERVICES DOES NOT CONSTI-
TUTE A LICENSE FROM WRTH ELEKTRONIK EISOS TO USE SUCH PRODUCTS OR SERVICES OR A WARRANTY OR ENDORSEMENT THEREOF. Themisto-I reference manual version 1.0 www.we-online.com/wireless-connectivity August 2019 110 25.6 Limitation of liability Any liability not expressly provided by Wrth Elektronik eiSos shall be disclaimed. You agree to hold us harmless from any third-party claims related to your usage of the Wrth Elektronik eiSos products with the incorporated Firmware, software and source code. Wrth Elektronik eiSos disclaims any liability for any alteration, development created by you or your customers as well as for any combination with other products. 25.7 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 nally settled by the court competent for the location of Wrth Elektronik eiSos registered ofce. 25.8 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. 25.9 Miscellaneous Wrth Elektronik eiSos reserves the right at any time to change this terms at its own discre-
tion. It is your responsibility to check at Wrth 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 rmware 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. Themisto-I reference manual version 1.0 www.we-online.com/wireless-connectivity August 2019 111 List of Figures Block diagram . 1 Pinout (top view)
. 2 3 Power up . 4 Wake-up from standby . 5 Wake-up from shutdown . Range extension using several repeaters . 6 Example network . 7 8 Layout . 9 Placement of the module with integrated antenna . 10 Dimensioning the antenna feed line as micro strip . 11 169 MHz dipole-antenna . 434 MHz dipole-antenna . 12 868 MHz dipole-antenna . 13 14 868 MHz magnet foot antenna with 1.5 m antenna cable . 15 2.4 GHz dipole-antenna . 16 Assembly diagram . 17 Top and Bottom Layer
. 18 Reow soldering prole . 19 Module dimensions [mm]
20 Footprint and dimensions [mm]
. Lot number structure . 21 22 Label of the Themisto-I
. List of Tables 1 Ordering information . 2 Recommended operating conditions . 3 Absolute maximum ratings
. 4 Power consumption . 5 Radio characteristics . 6 Pin characteristics . 7 Pinout
. 8 Message overview . 9 Radio proles . 10 Channel assignment
. 11 Classication reow soldering prole, Note: refer to IPC/JEDEC J-STD-020E 12 Package classication reow temperature, PB-free assembly, Note: refer to IPC/JEDEC J-STD-020E . 13 Dimensions . 14 Weight . 15 Lot number details . 9 13 17 63 63 69 71 77 78 79 81 82 83 84 85 89 90 92 96 97 98 99 9 10 10 11 12 12 15 37 40 65 91 92 95 95 98 Themisto-I reference manual version 1.0 www.we-online.com/wireless-connectivity August 2019 112 Monitoring& ControlAutomated Meter ReadingInternet of Things more than you expectContact:Wrth Elektronik eiSos GmbH & Co. KGDivision Wireless Connectivity & SensorsRudi-Schillings-Str. 3154296 TrierGermanyTel.: +49 651 99355-0Fax.: +49 651 99355-69www.we-online.com/wireless-connectivity
This product uses the FCC Data API but is not endorsed or certified by the FCC