telethings teleButton 2L Wireless Button Device User Manual
- June 1, 2024
- Telethings
Table of Contents
USER MANUAL
TeleButton – 2L
BASIC INFORMATION
Telethings teleButton is a wireless button device which enables remote control
via LoraWAN. By pressing any of the buttons, the ID of the button is sent
(each button has its own ID that is sent to the server), processed on the
server and passed on for management (e.g. relay control).
It is possible to set the device to only send ON commands, only OFF commands,
alternate sending ON-OFF (toggle control), as well as DELAY ON and DELAY OFF
commands, which is defined on the ThingsBoard app and it works in combination
with our TeleRelay devices.
The device is powered only via 3V a battery power supply. The device comes
with 1, 2, 4, and 6 buttons. 
ADD DEVICE TO TELETHINGS IOT CLOUD, SET SETTINGS AND MONITOR DATA
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 ink 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 opens as shown in Figure 2.
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 Tele Button appears as
shown in Figure 3. 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 Tele Button option, the Tele Button Device List is
opened as shown in Figure 4. 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 5. This dashboard contains
following widgets:
-
A widget for adjusting the settings of each button on the device with the following labels:
o BUTTON: ID of the button on button device
o 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
o RELAY ID: ID of the device that is being controlled by the teleButton device
o RELAY OUTPUT: Number of the output on the relay device (min. 1, max 8)
o 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 teleButton 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, teleButton 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 6 will open. The dashboard contains the following widgets: -
teleButton 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 TRANSFER 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.
3.1. teleButton – 2L data packet
teleButton – 2L device sends 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, from device with 3 buttons
it is possible to receive values 1, 2
and 3 etc.
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 |
Table 1. Reference for creating payload formatter
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.
TELETHINGS D.O.O.
A: Gračaničkih gazija b.b., 75320
Gračanica, Bosna i Hercegovina
T: +387 (0)35 700 209
F: +387 (0)35 700 201
E: i[email protected]
W: www.telethings.com