YOSensi YO Analog LNAN User manual

YO Analog
User guide v3.2

YO Analog User guide v3.2
page 2/30
Release notes
Date
Version
Changes
11.06.2021
1.0
Initial release.
13.12.2021
2.0
Change of power supply from 100~240 V AC, 50/60 Hz to 6
- 30 V DC, 5 - 21 V AC.
26.08.2022
3.0
Added specifications of the device, Installation instruction,
upgraded device configuration and operation of the device,
updated payloads description, added compliance statement
20.07.2023
3.1
Added configuration node with Yosensi Management
Platform. Changed description of connecting nodes with
Yosensi Management Platform.
26.10.2023
3.2
Added configuration with Yosensi Mobile App.
www.yosensi.io

YO Analog User guide v3.2
page 3/30
Content
Release notes 2
Content 3
Product description 4
Overview 4
Physical interfaces 5
LEDs 5
Buttons 5
Specifications 6
Physical 6
Operating conditions 7
Measured values 7
Current 8
Voltage 9
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
Configuration node with Yosensi mobile app 21
Connecting node with network 22
Yosensi Management Platform configuration 22
Adding a node manually 22
Adding node via Bluetooth 26
Payload description 26
Compliance statements 28
www.yosensi.io

YO Analog User guide v3.2
page 4/30
Product description
Overview
The YO Analog measures AC flowing through devices connected to the electricity grid. With one
YO Analog it is possible to measure the current simultaneously (e.g., in two three-phase, six
single-phase, one three-phase and three single-phase devices, etc.). It is possible to install current
clamps without knowing the direction through which the current flows. Wireless communication
eliminates the need for additional wiring or conversion of existing installations. By means of the
application algorithm developed by the Yosensi Team, and despite the limitations of data transfer
in the LoRaWAN network, it is possible to establish accurate mapping of current and power
consumption.
Figure 1 Device top view.
www.yosensi.io

YO Analog User guide v3.2
page 5/30
Device sticker placed on the right side of the device enclosure contains information about model,
version, LoRaWAN region and 3 parameters important in case of device identification and
configuration:
-DEV EUI: 64-bit unique device identifier in a LoRaWAN network,
-DEV ADDR: address required to connect via ABP activation type to LoRaWAN,
-BLE MAC: bluetooth physical address.
Figure 2 Device sticker.
Physical interfaces
LEDs
YO Analog communicates its current behavior to the user by RGBW LED placed on the top of the
device shown on figure one.
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 Analogis equipped with one reset button inside the device on the PCB board under the
inscription “reset” shown on the device. It is possible to press it with a thin stick.
www.yosensi.io

YO Analog User guide v3.2
page 6/30
Specifications
Physical
Figure 3 Dimensions of the device.
PHYSICAL SPECIFICATION
Dimensions
Height: 90 mm
Width: 71,2 (4 pole) mm
Depth: 58 mm
Colour
Light grey
Mounting method
35 mm DIN rail
Vertical (can be screwed to the wall)
Enclosure material
Polycarbonate
Fire resistance class
UL94-VO
Level of protection
IP20
Weight
127 g
www.yosensi.io

YO Analog User guide v3.2
page 7/30
Operating conditions
OPERATING CONDITIONS
Temperature
0° to 70°C
Humidity
0 to 90%
Placement
Indoor use
Power supply
6 - 30 V DC
5 - 21 V AC
Power consumption
Typical: 80 mA DC (12 V DC)
Maximum: 180 mA DC (12 V DC)
Measured values
MEASUREMENT RANGES
Parameter
Measuring range
Accuracy
Current
4-20 mA
-
Voltage
0-10 V
-
www.yosensi.io

YO Analog User guide v3.2
page 8/30
Current
YO Pulse provides measuring of current flow in the network between 4 - 20 mA which is used as a
standard in many industries. This helps customers to monitor signals in the industry network
connected to the IoT devices. YO Analog can monitor up to 6 signals depending on the configuration.
Figure 4 Current flow on first channel of the device exemplary chart.
Figure 5 Current flow on the second channel of the device exemplary chart.
www.yosensi.io

YO Analog User guide v3.2
page 9/30
Figure 6 Current flow on the third channel of the device exemplary chart.
Voltage
YO Pulse provides measuring of voltage in the network between 0- 10 V which is used as a standard
in many industries. This helps customers to monitor control signals in the industry network
connected to the IoT devices. YO Analog can monitor up to 6 signals depending on the configuration.
Figure 7 Voltage on the fourth channel of the device exemplary chart.
www.yosensi.io

YO Analog User guide v3.2
page 10/30
Figure 8 Voltage on the fifth channel of the device exemplary chart.
Figure 9 Voltage on the sixth channel of the device exemplary chart.
www.yosensi.io

YO Analog User guide v3.2
page 11/30
Installation
Package contents
1. Device.
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 outdoor and indoor use.
www.yosensi.io

YO Analog User guide v3.2
page 12/30
Installation guide
1. Mount the device on a 35 mm DIN rail.
Figure 10 Device mounting instructions.
Important! By default each input is configured as current. If you want to configure one or more inputs
as voltage you have to do it before connecting sensors. The configuration is possible via BLE.
2. Connect a 4-20 mA signal source and/or a 0-10 V voltage measuring cable to the individual
inputs of the device according to the polarity shown on the enclosure label.
www.yosensi.io

YO Analog User guide v3.2
page 13/30
Figure 11 Connect the inputs to the individual channels of the device.
3. Screw the power supply wires to the device regardless of polarity (6 - 30 V DC, 5 - 21 V AC).
www.yosensi.io

YO Analog User guide v3.2
page 14/30
Figure 12 Instruction on how to fasten the current clamps around the wires.
Figure 13 Final look of the device.
www.yosensi.io

YO Analog User guide v3.2
page 15/30
Operation
IoT system components
Typical IoT systems consist of 3 main elements (Figure 14), 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 14 IoT system components.
Figure 15 Fresnel zone where communication between two antennas can occur.
www.yosensi.io

YO Analog User guide v3.2
page 16/30
Device configuration
Configurable parameters
A few parameters must be set before sending data to the gateway. The default firmware is configured
in OTAA mode with predefined deveui,appkey (OTAA)and appskey,nwkskey (ABP).
Configuration of the device is stored in a JSON file divided into the following sections:
-info (generic, read only): information about the device,
-lorawan (generic): configuration data for LoRaWAN connection,
-ble (generic): bluetooth settings,
-device (dynamic): individual configuration for a specific device (this section’s structure differs
for each device),
Sample configuration file for the YO Analog device.
{
"info": {
"devmodel": "LNAN",
"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": 300,
"measthreshold": 20,
"ch1func": "0-20mA",
"ch2func": "0-20mA",
"ch3func": "0-20mA",
"ch4func": "0-10V",
"ch5func": "0-10V",
"ch6func": "0-10V"
}
}
www.yosensi.io

YO Analog User guide v3.2
page 17/30
GENERICS PARAMETERS
SECTION
NAME
DESCRIPTION
POSSIBLE
VALUES
DEFAULT
VALUE
READ/
WRITE
info
devmodel
Device name
-
LNAN
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
[dBm]
04
0
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 Analog User guide v3.2
page 18/30
DEVICE PARAMETERS
NAME
DESCRIPTION
POSSIBLE
VALUES
DEFAULT
VALUE
READ/
WRITE
measinterval
Measuring and sending interval
LoRa [s]
1–999999
300
R/W
measthreshold
Measuring and sending threshold
accuracy
1-9999
20
R/W
chxfunc
Number of channels with function of
measurement current or voltage
0-20 mA
0-10 V
0-20 mA
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: measurement interval [s] between sending LoRa packets.
-measthreshold: measurement threshold for each channel. If current or voltage value
between previous measurement and the next differs by a value of ‘meastreshold’, it queues
this data for sending. Measurement difference is reported in subsequent LoRa packets along
with measurement time.
-ch1func…ch6func: numbers of channels with measurement of current or voltage flow in the
network connected to the device.
www.yosensi.io

YO Analog User guide v3.2
page 19/30
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 Analog User guide v3.2
page 20/30
Configuration node with Yosensi Management Platform
Connect to the device as follows:
1. Log in at app.yosensi.io
2. You’ll see the dashboard organization view. Go to the Application section in the sidebar.
3. Select the application and locate and select the device by looking for the DEV EUI on the
device label that matches the NODE ID in the list.
4. Select the Firmware section. For the configuration of the device, you can see three different
buttons:
●Configure – here, you can change and upload the device parameters.
●Update firmware – here, you can update the firmware to version 3.4.0 and newer.
●Recover device – this section restores the firmware of the device. This button helps if
you lose the connection while uploading firmware.
5. Once the “Configure” button has been selected and the node has been paired with the
computer, the next step is configuring parameters. You will see 2 different display options for
the configuration. The first recommended is “Form-based-editor” and the second is “Text
editor”. Possible values with the description of each parameter can be found in the device
configuration.
Figure 16 Update configuration section view.
6. Press the Upload button and wait.
www.yosensi.io