telethings teleRelays-2L Device Thermostat User Manual

telethings teleRelays-2L Device Thermostat

Product Information

Specifications

• Power supply: 220 VAC
• Dimensions: 14.5 x 9 x 4 cm
• Weight: Not specified
• Storage temperature: Not specified
• Operating temperature: Not specified
• Number of relays: Varies (2, 5, or 8)
• LoRaWAN Frequency: EU: 868 MHz, US: 915 MHz
• Class: Class C
• 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: Data sent every 15 minutes and 6 seconds after the last command
• Other components: Two-pin connector power supply, relay connectors, red LED power indicator

Product Usage Instructions

Device Wiring Instructions

• Device Power Supply
  The two-pin connector labeled with N and L is used to power the device.

• Relay Wiring
  The relay working contacts are connected in series with the circuit we want to control. Connect the circuit to connectors 1 and 2 as shown in Figure 4.

Work Principle of Device
The device sends data about relay states via the LoRaWAN interface to the server every 15 minutes. Additionally, it sends the states of the relay 6 seconds after receiving and executing a command from the server.

Add Device to Telethings IoT Cloud, Manage and Monitor Data
The device can be added to the Telethings IoT Cloud platform for management and monitoring of data.

Data Protocol

• teleRelays-2L Data Packages
  Detailed information about the data packages sent by teleRelays-2L.

• Communication Flow
  Description of the communication flow between the device and the server.

Frequently Asked Questions (FAQ)

How often does the device send data to the server?
The device sends data to the server every 15 minutes and 6 seconds after the last successfully received and executed command from the server.

BASIC INFORMATION

• The teleRelays-2L device is a type of smart relay that provides the possibility of management via the LoRaWAN interface. Unlike conventional relays, which have only the basic switching functions for which they are intended, this type of device has a built-in microcontroller that allows it to be integrated into smart control systems. So, this device offers the possibility of use in different systems (e.g. heating/cooling system control, lighting management and other systems that do not require a just-in-time response).
• The basic version of the device contains the following connectors:
  • two-pin power supply connector (220 VAC)
  • relay connectors
• In addition to the connectors, the device also includes the following components:
  • switch to turn on/off the device
  • red LED power indicator
• The device sends data about relay states via the LoRaWAN interface to the server every 15 minutes. Also, the device sends the states of the relay 6 seconds after the last successfully received and executed command from the server. The commands can be sent to the device using the Telethings IoT Cloud platform. Depending on the design, teleRelays-2L devices can have 2, 5 or 8 relays.

Overview

US: 915 MHz

Class:| Class C
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:| It is mandatory to send data to the server every

15 minutes and 6 seconds after the last successfully received and executed command from the server.

Other components:| Two-pin connector power supply connector,

relay connectors and red LED power indicator.

Values are selected on the purchase

DEVICE WIRING INSTRUCTIONS

Device Power Supply
The two-pin connector labelled with N and L is used to power the device.

Relay Wiring
The relay working contacts are connected in series with the circuit we want to control. It is necessary to connect the circuit to connectors 1 and 2, as shown in Figure 4.

WORK PRINCIPLE OF DEVICE

• The teleRelays-2L device establishes two-way communication with the server. The device sends the current states of the relay to the server, and receives commands from the server sent by the user from a special platform. Based on the received commands, the device controls the system to which it is connected by activating/deactivating a certain relay.
• The teleRelays-2L device can be controlled in two ways:
  • using one of the IoT devices (e.g. teleButton) or
  • using the Telethings IoT Cloud platform
• If the teleRelays-2L device is controled using an IoT device, then the pairing of that IoT device with the teleRelays-2L device can be done using the Telethings IoT Cloud platform.
• It is important to emphasize that controlling the teleRelays-2L device via the Telethings IoT Cloud platform is possible even if the same device is controlled via a specific IoT device.
• Since teleRelays-2L belongs to the C class of devices, the commands sent from the server to the device are executed with minimal delay caused by the LoRaWAN interface. The maximum delay in command execution is up to 2 seconds.

ADD DEVICE TO TELETHINGS IOT CLOUD, MANAGE AND MONITOR DATA

• First of all, it is necessary to log in to 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.

• If user does not have any device on his profile, after signing in, the Home Dashboard will open as shown in Figure 5. 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.

• 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 (e.g. teleRelays) appears as shown in Figure 6. Of course, it is still possible to claim new devices by clicking on the Claim Device option and repeating the previously explained procedure.

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

• To adjust the settings of a specific device, click on the Settings button and dashboard for adjusting the device settings will open as shown in Figure 8. This dashboard contains device name and teleRelays Settings widget with following options:
  • OUTPUT column represents a label for each relay output on the device.
  • MODE option is intended for adjusting the functionality of each relay output on the teleRelays-2L device and to display the currently adjusted settings for the selected relay outputs. The MODE option can have the following values:
  • ON is used to activate the selected relay output.
  • OFF is used to deactivate the selected relay output.
  • TOGGLE is used to invert the current state of the selected relay output.
  • DELAY ON is used to activate the selected relay output for the time interval set in the TIMER column. After the set time interval has expired, the selected relay output is deactivated.
  • DELAY OFF is used to deactivate the selected relay output for the time interval set in the TIMER column. After the set time interval has expired, the selected relay output is activated.
  • TIMER represents an additional option in case the DELAY ON or DELAY OFF value is selected for the MODE option. The TIMER option is used to enter the value of the time interval in minutes to maintain the selected state. This time interval can be between 1- 60 minutes.
• In order to save the selected settings, it is necessary to press the Save button. All settings for the device can be reset by pressing the Reset button, whereby the reset settings are automatically saved.

• By clicking on the device whose data you want to read, the dashboard shown in Figure 9 will open. The dashboard contains device name and table with following columns:
  • OUTPUT column represents a label for each relay output on the device.
  • RELAY STATE represents the state of the relay output. Green color implies an active state, while gray represents an inactive state of the relay.
  • The third column represents virtual buttons that enable control of the respective relay based on the settings set in the teleRelay Settings widget. So, the specified buttons send the adjusted settings (commands) to the teleRelays-2L device.

DATA PROTOCOL

If you are using your own server, you need to know data protocol, i.e. data packages and communication flow. First of all, it is necessary to create an application on the server and add the device using the appropriate keys. If the server application is created and the device is added to it, then the device can be turned on and the JOIN procedure can be started. Once the device is successfully JOINED to the server, it can start sending and receiving messages to/from the server.

teleRelays-2L Data Packages
The data package that teleRelays-2L sends to the server has the following format:
relay_states is 1 byte data and represents the current state of all relays on the device.

Each bit in the relay_states data represents the state of an individual relay, as shown in Table 2. If the relay is active, its state is marked with 1. Otherwise, the state of the relay is 0.

VALUE

| first relay

state

| second relay

state

| third relay

state

| fourth relay

state

| fifth relay

state

| sixth relay

state

| seventh relay

state

| eighth relay

state

The data package that the server sends to the teleRelays-2L device can have one of the following formats depending on the selected mode:

1. If ON, OFF or TOGGLE mode is selected, the data packet has the following format: < relay_number>
2. If DELAY ON or DELAY OFF mode is selected, the data packet has the following format: < relay_number>
   • command – represents mode (ON, OFF, TOGGLE, DELAY ON ili DELAY OFF)
   • relay_number – represents the number of the relay output in the range 0-7, depending on the number of relays on the device
   • timer_value – represents the value of the time interval to maintain the selected relay states
     DATA| PORT NUMBER| DATA SIZE IN BYTES| PACKAGE OFFSET
     ---|---|---|---
     command|

15

| 1| 0
relay_number| 1| 1
timer_value| 1| 2

Communication Flow

• The teleRelays-2L device communicates with the server every 15 minutes, if no commands have been sent from the server during that period. Also, the teleRelays-2L device communicates with the server 6 seconds after the last successfully received and executed command from the server.
• Also, the teleRelays-2L device constantly checks whether there are new data sent from the server.
  NOTE:
  If your own server is used, then it is not possible to use the Telething IoT Cloud shown in the previous chapter. In this case, scan the QR code on the device and send us an email with the device’s serial number so that we can send you the device EUI and application key.

References

• Telethings - Početna
• iot.telethings.com/home
• iot.telethings.com/signup

Read User Manual Online (PDF format)

Download This Manual (PDF format)

Download this manual  >>