YOSensi YO 360 User manual

YO 360
User guide v1.2

YO 360 User guide v1.2
page 2/25
Release notes
Released
Version
Key changes
25.08.2022
1.0
Initial release.
20.06.2023
1.1
Added configuration node with Yosensi Management
Platform.
31.07.2023
1.2
Changed description of connecting nodes with Yosensi
Management Platform.
www.yosensi.io

YO 360 User guide v1.2
page 3/25
Content
Release notes 2
Content 3
Product description 4
Overview 4
Physical interfaces 5
LEDs 5
Buttons 5
Specifications 5
Physical 5
Operating conditions 6
Measured values 7
Internal Temperature and relative internal humidity 7
Accelerometer 8
Battery condition 10
Installation 11
Package contents 11
Safety precautions 11
Installation guide 12
Operation 15
IoT system components 15
Device configuration 16
Configurable parameters 16
Parameters description 18
Configuration node with Yosensi Management Platform 20
Connecting node with network 21
Yosensi Management Platform configuration 21
Adding node manually 21
Adding node via bluetooth 24
Payload description 25
www.yosensi.io

YO 360 User guide v1.2
page 4/25
Product description
Overview
YO 360 measures temperature and humidity and sends information about its own position on the x, y
and z axes (built-in accelerometer). Its small size, battery power supply and long data transmission
range allow the device to be used in virtually any place. The enclosure is suitable for indoor use.
Figure 1 Device top view.
Device sticker placed on the bottom of the device enclosure contains information about model,
version, LoRaWAN region and 3 parameters important in case of device identification and
configuration:
- DEV EUI: unique device identifier required to connect via OTAA activation type to
LoRaWAN.
- DEV ADDR: address required to connect via ABP activation type to LoRaWAN.
- BLE MAC: bluetooth physical address.
www.yosensi.io

YO 360 User guide v1.2
page 5/25
Figure 2 Device sticker.
Physical interfaces
LEDs
YO 360 communicates its current behaviour to the user by RGBW LED placed on the top.
DIODE STATUES INTERPRETATION
BEHAVIOUR
COLOUR
DEVICE STATUS
Single flash
Green
General: device is working correctly (power and memory).
Single flash
Red
General: device is working incorrectly (power and memory).
LoRaWAN communication: failed to receive an
acknowledgement from LoRaWAN Server within specified
timeout.
Single flash
White
LoRaWAN communication: LoRaWAN frame sent \
confirmation from LoRaWAN Server after receiving the frame.
Slow flashing
Blue
BLE communication: connection to the device via BLE
(configuration).
Rapid flashing
Blue
LoRaWAN communication: connecting to LoRaWAN network.
Buttons
YO 360 is equipped with one reset button inside the device on the PCB board next to the RGBW
LED diode. It is shown on figure number 1 it is possible to press it with a thin stick.
Specifications
Physical
www.yosensi.io

YO 360 User guide v1.2
page 6/25
Figure 3 Dimensions of the device.
PHYSICAL SPECIFICATION
Dimensions
Diameter: 47mm
Height: 13mm
Colour
White
Black
Mounting method
Chose from:
●No handles
●One handle (mounting hole)
●Two oval handles
●Strap
Enclosure material
ABS
Level of protection
IP40
Weight
18,6 g
Operating conditions
OPERATING CONDITIONS
Temperature
0° to 70°C
Humidity
0 to 90%
Placement
Indoor use
www.yosensi.io

YO 360 User guide v1.2
page 7/25
Power supply
Battery CR2450 3 V
Power consumption
Maximum: 110 mA DC (3 V DC)
Measured values
MEASUREMENT RANGES
Parameter
Measuring range
Accuracy
Temperature (internal)
-40°C to 125°C
±0,2°C (from 5°C to 60°C )
Relative humidity
0% to 100%
±2% (at 20% to 80% )
Accelerometer
±180 ° on X, Y, Z axes
±0,1° (from -40°C to 85°C)
Internal Temperature and relative internal humidity
Temperature and relative humidity are measured by sensors placed inside the device enclosure.
These measurements can be used to monitor if the device is working in recommended conditions.
Figure 4 Exemplary internal temperature monitoring chart.
www.yosensi.io

YO 360 User guide v1.2
page 8/25
Figure 5 Exemplary relative humidity monitoring chart.
Accelerometer
The accelerometer sensor is providing position of a device in X, Y, Z axes and stores data about what
time it was moved to another location. Accelerometer informs in which position measurements of
temperature and humidity were done.
Figure 6 Exemplary accelerometer monitoring chart position X.
www.yosensi.io

YO 360 User guide v1.2
page 9/25
Figure 7Exemplary accelerometer monitoring exemplary chart position Y.
Figure 8 Accelerometer monitoring exemplary chart position Z.
www.yosensi.io

YO 360 User guide v1.2
page 10/25
Battery condition
Battery voltage is used to monitor its condition – to spot anomalies (like sudden drop) or its current
condition based on voltage drop over time in comparison to initial voltage rating.
Figure 9 Battery voltage exemplary chart.
www.yosensi.io

YO 360 User guide v1.2
page 11/25
Installation
Package contents
1. Device (without batteries).
2. Warranty card.
Safety precautions
SAFETY PRECAUTIONS
SYMBOL
DESCRIPTION
Device is marked with a symbol saying that electrical and electronic
products may not be mixed with unsorted household waste. Remember
that batteries used to power the device must be treated at a specialized
treatment facility.
Remember about possible electrostatic discharge when replacing battery,
connecting input or doing some other operations near inside electronics.
Be careful while handling the device – dropping it may cause damage that will
affect the sensors and other electronics inside.
When installing the device on the wall remember to wear adequate protective
equipment.
To maintain the level of protection device cover screws must be properly
tightened. Device shouldn’t be used without cover.
Any actions inside the device's enclosure (excluding replacing batteries) must
be performed by trained personnel only.
Clean the device only with damp cloth.
Device is intended for indoor use. Make sure that device is not exposed for
long term UV rays and in an environment in the immediate vicinity of water
which may flood the device
www.yosensi.io

YO 360 User guide v1.2
page 12/25
Installation guide
1. Unscrew the device: remove 4 screws from the enclosure.
Figure 10 Device opening instructions.
www.yosensi.io

YO 360 User guide v1.2
page 13/25
2. Place CR2450 3 V battery in the device according to the polarity.
Figure 11 Device battery assembling instructions.
3. Assemble the device. The order of the elements is important:
●Place the PCB (B) at the top of the enclosure (A)
●Then insert the seal (C)
●Fit the bottom part of the enclosure (D)
Figure 12 Assemble device instruction.
www.yosensi.io

YO 360 User guide v1.2
page 14/25
4. Match the PCB (marked components) to the enclosure according to the diagram. Place the
PCB in the enclosure with the battery basket facing up
Figure 13 Matching the PCB to the enclosure instructions.
5. The device is on. Screw it back together.
Figure 14 Assembled device top view.
www.yosensi.io

YO 360 User guide v1.2
page 15/25
Operation
IoT system components
Typical IoT systems consist of 3 main elements (Figure 15), brief described below. In order to set
communication, each element must be properly configured.
1. Node – device with sensors and a wireless communication module that gathers data, forms
the payload and sends it to the gateway.
2. Gateway – device similar to routers, equipped with a LoRa concentrator, that receives LoRa
packets and send them to the Internet-connected server.
3. Server – in most cases, a cloud-based service where data is processed, stored, analysed, and
presented in user-friendly ways (via a user interface); Yosensi default and recommended
tools are Yosensi Management Platform (for IoT structure management) and Grafana (for
data presentation).
Figure 15 IoT system components.
Figure 16 Fresnel zone where communication between two antennas can occur.
www.yosensi.io

YO 360 User guide v1.2
page 16/25
Device configuration
Configurable parameters
A few parameters must be set in order to send data to the gateway. The default firmware is
configured in OTAA connection type with predefined deveui,appkey (OTAA)and appskey,nwkskey
(ABP).
Configuration of the device is stored in a JSON format file divided into sections:
-info (generic, read only): information about the device,
-lorawan (generic): configuration data required to connect to the LoRaWAN,
-ble (generic): bluetooth settings,
-device (dynamic): individual configuration for a specific device (the structure of this section is
different for each device).
Sample configuration file for the YO 360 device.
{
"info": {
"devmodel": "LNPC",
"fwver": "3.5.0",
"loraradio": "SX1261",
"lorawanver": "1.0.2",
"loraregion": "EU868",
"blemacaddr": "0123456789ab"
},
"lorawan": {
"subband": 1,
"nwktype": "public",
"acttype": "otaa",
"otaa": {
"deveui": "0123456789abcdef",
"appeui": "fedcba9876543210",
"appkey": "000102030405060708090a0b0c0d0e0f",
"trials": 3
},
"abp": {
"devaddr": "01234567",
"nwkskey": "0123456789abcdef0123456789abcdef",
"appskey": "000102030405060708090a0b0c0d0e0f"
}
},
"ble": {
"power": 0,
"interval": 1600
},
"device": {
"measinterval": 7200
}
}
www.yosensi.io

YO 360 User guide v1.2
page 17/25
GENERICS PARAMETERS
SECTION
NAME
DESCRIPTION
POSSIBLE
VALUES
DEFAULT
VALUE
READ/
WRITE
info
devmodel
Device name
-
LNPC
R
fwver
Firmware version
-
3.5.0
R
loraradio
Radio chipset model
-
SX12611
R
lorawanver
LoRaWAN stack version
-
1.0.2
R
loraregion
LoRaWAN region
-
EU8681
R
blemacaddr
Bluetooth LE address
-
predefined
R
lorawan
subband
Uplink subband number
Table2
predefined
R/W
nwktype
Network type
public,
private
public
R/W
acttype
Activation type
otaa, abp
otaa
R/W
lorawan
-otaa
deveui
Device EUI (Extended
Unique Identifier)
8 B (HEX)
predefined
R/W
appeui
Application EUI
8 B (HEX)
predefined
R/W
appkey
Application Key
16 B (HEX)
predefined
R/W
trials
Join request trials
1-9
3
R/W
lorawan
-abp
devaddr
Device Address
4 B (HEX)
predefined
R/W
nwkskey
Network Session Key
16 B (HEX)
predefined
R/W
appskey
Application Session Key
16 B (HEX)
predefined
R/W
ble
power
Bluetooth LE transmit power
04
0 dBm
R/W
interval
Bluetooth LE advertising
interval [ms]
MS_INPUT3
1600
R/W
1LoRa radio chipset used defines the LoRaWAN region: SX1261 - EU868; SX1262 - AU915, US915, AS923
2Uplink subband list for specific LoRaWAN regions - UPLINK SUBBAND Table.
3Calculation formula: MS_INPUT = INTERVAL_MS × 1.6.
4Change currently not supported.
www.yosensi.io

YO 360 User guide v1.2
page 18/25
DEVICE PARAMETERS
NAME
DESCRIPTION
POSSIBLE
VALUES
DEFAULT
VALUE
READ/
WRITE
measinterval
Measuring and sending interval
LoRa [s]
1–999999
7200
R/W
Parameters description
-nwktype: used for setting the device in public or private network type.
-acttype: used for setting the device in ABP or OTAA mode.
-deveui, … , appskey: predefined addresses and keys, these parameters are generated using
multiple IDs specific to the particular MCU and are unique for each device.; they can be
changed if needed.
-interval: determines the interval of sending broadcast packets, used to connect to every BLE
receiver around the device.
-subband: used for setting the communication frequency sub-band in LoRaWAN.
-measinterval: interval of sending each LoRa payload.
www.yosensi.io

YO 360 User guide v1.2
page 19/25
UPLINK SUBBAND
REGION
DESCRIPTION
POSSIBLE
VALUES
DEFAULT
VALUE
READ/
WRITE
EU868
Sub-band 1; 867.1 - 868.5 MHz; channels 0-7
1
1
R
US915
Sub-band 1; 902.3 - 903.7 MHz; channels 0-7
1
2
R/W
Sub-band 2; 903.9 - 905.3 MHz; channels 8-15
2
Sub-band 3; 905.5 - 906.9 MHz; channels 16-23
3
Sub-band 4; 907.1 - 908.5 MHz; channels 24-31
4
Sub-band 5; 908.7 - 910.1 MHz; channels 32-39
5
Sub-band 6; 910.3 - 911.7 MHz; channels 40-47
6
Sub-band 7; 911.9 - 913.3 MHz; channels 48-55
7
Sub-band 8; 915.5 - 914.9 MHz; channels 56-63
8
AU915
Sub-band 1; 915.2 -916.6 MHz; channels 0-7
1
2
R/W
Sub-band 2; 916.8 - 918.2 MHz; channels 8-15
2
Sub-band 3; 918.4 - 919.8 MHz; channels 16-23
3
Sub-band 4; 920.0 - 921.4 MHz; channels 24-31
4
Sub-band 5; 921.6 - 923.0 MHz; channels 32-39
5
Sub-band 6; 923.2 - 924.6MHz; channels 40-47
6
Sub-band 7; 924.8 - 926.2 MHz; channels 48-55
7
Sub-band 8; 926.4 - 927.8 MHz; channels 56-63
8
AS923
Sub-band 1; 922.0 -923.2 MHz; channels 0-8
1
Not
supported
R/W
Sub-band 2; 923.2 - 924.5 MHz; channels 9-17
2
www.yosensi.io

YO 360 User guide v1.2
page 20/25
Configuration node with Yosensi Management Platform
Connect to the device following these instructions:
1. Go to app.yosensi.io and log in.
2. You’ll see the dashboard organisation view. Now go to the Application section in the sidebar.
3. After choosing your application, search and select the device by looking at the DEV EUI on
the device sticker which is the same as the NODE ID on the list.
4. Select the firmware section. Now you can see three different buttons:
●Configure - here you can change and upload parameters of the device.
●Update firmware - here you can update the firmware from version 3.4.0 and newer.
●Recover device - this section is made to recover firmware of the device. This button
helps when you might lose connection during uploading firmware.
5. After selecting the configure button and connecting node, the next step is to configure
parameters. Now you can change them in the section ‘ device ‘.
Figure 17 Update configuration section view.
6. Press the upload button and wait.
NOTE
Additional information including device configuration can be found in Yosensi
configuration web tool.
www.yosensi.io