telethings TELESWITCH – 2L Smart LoRaWAN Thermostat User Manual

: June 1, 2024
: Telethings

Table of Contents

telethings TELESWITCH – 2L Smart LoRaWAN Thermostat
Product Information
OVERVIEW
WORK PRINCIPLE OF THE DEVICE
ADD DEVICE TO TELETHINGS IOT CLOUD
DATA PROTOCOL
TROUBLESHOOTING AND SUPPORT
References
Read User Manual Online (PDF format)
Download This Manual (PDF format)

telethings TELESWITCH – 2L Smart LoRaWAN Thermostat

.telethings-TELESWITCH --2L-Smart-LoRaWAN-Thermostat-
product

Product Information

Specifications

Power supply: CR2450 battery
Dimensions: (specific dimensions not provided)
Storage temperature: (specific range not provided)
Operating temperature: (specific range not provided)
Energy consumption: Extremely low
LoRaWAN Frequency:
- EU: 868 MHz
- US: 915 MHz
Class: A
Activation method: Over-The-Air Activation (OTAA)
Data transmission power: +16 dBm
Encryption: AES128
LoRaWAN version: MAC V1.0.2 REV B
Communication with the server: Mandatory on button press

FAQ

How do I change the settings of the teleSwitch-2L device?
- You can change the settings of the device by accessing the Telethings IoT Cloud platform and adjusting the configurations there.
What do I do if I encounter connectivity issues with the device?
- If you face connectivity issues, ensure that the device is within range of a LoRaWAN network gateway and that the battery is not depleted. You can also check the Telethings IoT Cloud for any reported connection problems.

OVERVIEW

Power supply:	1xCR2450 battery
Dimensions	8.6×8.6×0.7mm
Storage temperature:	-10°C ~ 60°C
Operating temperature:	0°C ~ 60°C
Energy consumption:	1.2-2 µA in idle state

5.2 mA in active state

LoRaWAN|
Frequency:*| EU: 868 MHz

US: 915 MHz

Values are selected on the purchase

Basic Information

teleSwitch-2L is a wireless device which enables remote control via the LoRaWAN network. Depending on the version of the device, it may contain 2 or 3 buttons. By pressing any button, the ID of the pressed button is transmitted to the server, from where the paired device is managed. This device can also be used and paired with some of other Telethings devices such as teleRelay-2L devices, using Telethings IoT Cloud platform.

The device is powered by a CR2450 battery and it belongs to the group of devices with extremely low consumption.

WORK PRINCIPLE OF THE DEVICE

LoRaWAN is a low-power, wide area networking protocol suitable for transmitting small size payloads over long distances. It wirelessly connects devices to the internet and manages communication between end-node devices and network gateways.
teleSwitch-2L device enables remote control via LoraWAN technology. By pressing any button, the ID of the pressed button is transmitted to the server, from where the paired device is managed according to the adjusted settings, as shown in Figure 2.

.telethings-TELESWITCH --2L-Smart-LoRaWAN-Thermostat-
fig-2

It is possible to set the teleSwitch-2L device to only send ON commands, only OFF commands, alternate sending ON-OFF (TOGGLE control), as well as DELAY ON and DELAY OFF commands. Those commands are defined on Telethings IoT Cloud and it works in combination with our teleRelays-2L devices.

ADD DEVICE TO TELETHINGS IOT CLOUD

ADD DEVICE TO TELETHINGS IOT CLOUD, SET SETTINGS AND MONITOR DATA

.telethings-TELESWITCH --2L-Smart-LoRaWAN-Thermostat-
fig-3

First of all, it is necessary to log in a https://iot.telethings.com/home. If a user account has not been created, then you must first register on Telethings IoT Cloud at the following link https://iot.telethings.com/signup and activate your profile by clicking on the link received in your e-mail.

.telethings-TELESWITCH --2L-Smart-LoRaWAN-Thermostat-
fig-4

If user does not have any device on his profile, after signing in, the Home Dashboard opens as shown in Figure 3. Click on the Claim Device option and click on the QR Code Scanner icon. After that, the camera is activated and the QR code should be scanned.

.telethings-TELESWITCH --2L-Smart-LoRaWAN-Thermostat-
fig-5

A corresponding message about the success of the device claim will be displayed after scanning the QR code. Considering that the device claim was successful, new option with the name of device type teleSwitch appears as shown in Figure 4. Of course, it is still possible to claim new devices by clicking on the Claim Device option and repeating the previously explained procedure.

.telethings-TELESWITCH --2L-Smart-LoRaWAN-Thermostat-
fig-6

By clicking on teleSwitch option, the teleSwitch Device List is opened as shown in Figure 5. There are options for renaming the device and for adjusting its settings.

To adjust the settings of a specific device, click on the Settings icon button and dashboard for adjusting the device settings will open as shown in Figure 6. This dashboard contains following widgets:

A widget for adjusting the settings of each button on the device with the following labels:
- BUTTON: ID of the button on button device
- MODE: Type of command that server forwards from button device to device that is controlled. The value of this setting can be:
- ON – By pressing the key with the corresponding ID, the ON command is sent, which turns on the connected device
- OFF – By pressing the key with the corresponding ID, the OFF command is sent, which turns off the connected device
- TOGGLE – By pressing the key with the corresponding ID, the TOGGLE command is sent, which turns on the connected device if it is turned off and vice versa.
- DELAY ON – By pressing button with belonging ID, the command for time hold of the ON state is sent, so after the expiration of TIMEOUT value state goes to the logical 0
- DELAY OFF – By pressing button with belonging ID, the command for time hold of the OFF state is sent, so after the expiration of TIMEOUT value state goes to the logical 1
- RELAY ID: ID of the device that is being controlled by the teleSwitch device
- RELAY OUTPUT: Number of the output on the relay device (min. 1, max 8)
- TIMER VALUE: Timeout value in case that server sends DELAY ON or DELAY OFF command
  On this widget, it is possible to configure the functionality of the teleSwitch device in such a way that it performs multifunctional control of TeleRelay devices. Options like delayed ON and etc. are managed on the teleRelay device, teleSwitch device only gives the signal.
Widget Send Mail Confirmation allows sending an email to the user when any of the buttons is pressed on a certain device.

By clicking on the device whose data you want to read, the dashboard shown in Figure 7 will open. The dashboard contains the following widgets:

teleSwitch Device widget represents virtual device buttons that enable control of connected devices. An indication of a button being pressed via the widget or directly on the device is a change in the color of the button for one second.
History widget allows viewing the pressed keys in the selected time interval.

DATA PROTOCOL

If your own server is used, it is necessary to know the definition of data transfer protocol, packets and data format used in that protocol. First of all, it is required to create application on The Things Stack platform (private or public) for your devices and inside that application you need to add as many devices as you need. After that it is possible to start JOIN procedure in order to connect device with server. Once the JOIN procedure is successfully finished it is possible to exchange data between server and joined device.

teleSwitch – 2L data packet

teleSwitch device sends a quite simple data packet that is 1 byte in size and contains the ID of the button that was pressed. So, it is possible to receive values 1 and 2 from device with 2 buttons, but from device with 3 buttons it is possible to receive values 1, 2 and 3.

Based on this information you can easily create payload formatter in your application on the server.
Below is a table which you can use as a reference for creating user payload formatter inside server application.

DATA	PORT NUMBER	DATA SIZE IN BYTES	OFFSET IN PACKET
BUTTON ID	100	1	0
JOIN METADATA	10	1	0

After every successfully join, device sends test byte in order to confirm that data transfer is working without problems (JOIN METADATA).

NOTE:

If you want to integrate our device to your stack, scan the QR code on the device and send us an e-mail with the serial number, so we can send you the device EUI and the device app key.