YOSensi YO Power User manual

YO Power
User guide v3.0

YO Power User guide v1.0
page 2/27
Release notes
Date
Version
Changes
11.06.2021
1.0
Initial release.
07.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
06.09.2022
3.0
Added specifications of the device, Installation instruction,
upgraded device configuration and operation of the device,
updated payloads description, added compliance statement
REV 3.0
www.yosensi.io

YO Power User guide v1.0
page 3/27
Content
Release notes 2
Content 2
Product description 4
Overview 4
Physical interfaces 5
LEDs 5
Buttons 5
Specifications 6
Physical 6
Operating conditions 7
Measured values 7
Pulse counter 7
Temperature and relative humidity 8
Battery condition 8
Installation 9
Package contents 9
Safety precautions 9
Installation guide 9
Operation 12
IoT system components 12
Device configuration 13
Configurable parameters 13
Parameters description 15
Configuration via CLI 17
Connecting node with network 17
Yosensi Management Platform configuration 18
Payload description 20
Compliance statements 22
Revision history 24
REV 3.0
www.yosensi.io

YO Power User guide v1.0
page 4/27
Product description
Overview
The YO Power measures AC flowing through devices connected to the electricity grid. With one YO
Power 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.
REV 3.0
www.yosensi.io

YO Power User guide v1.0
page 5/27
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: 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
Figure 2 Device sticker.
Physical interfaces
LEDs
YO Power 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 Power is equipped with one reset button inside the device on the PCB board under the
inscription “reset” shown on the figure 1. It is possible to press it with a thin stick.
REV 3.0
www.yosensi.io

YO Power User guide v1.0
page 6/27
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
125,2 g
REV 3.0
www.yosensi.io

YO Power User guide v1.0
page 7/27
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: 12 mA DC (12 V DC)
Maximum: 120 mA DC (12 V DC)
Measured values
MEASUREMENT RANGES
Parameter
Measuring range
Accuracy
Current
Model A: 0-100 A
±1%
Model B: 0-160A
±3%
Power consumption
0-230 V
Not given in datasheet
REV 3.0
www.yosensi.io

YO Power User guide v1.0
page 8/27
Current
YO Power offers automatically switchable measurement ranges: 2 A, 10 A, 50 A, 100 A., which
results in even greater precision when measuring current. Each channel can measure current over
different measuring ranges simultaneously. The YO Power has measurement inputs with specialized
integrated circuits (e.g. specialized analog-to-digital converters) that ensure high measurement
accuracy.
Figure 4 Current flow on second channel of the device exemplary chart.
Power consumption
Power consumption measured by YO Power and attached to it CT clamps is a value calculated for
each hour for 230 V and current flowing on each channel. It helps monitor customers how much
power is consumed by the devices every hour and check anomalies in the electric network.
Figure 5 Power consumption monitoring chart on 2nd channel of the device.
REV 3.0
www.yosensi.io

YO Power User guide v1.0
page 9/27
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.
REV 3.0
www.yosensi.io

YO Power User guide v1.0
page 10/27
Installation guide
1. Mount the device on a 35 mm DIN rail.
Figure 6 Device mounting instructions.
REV 3.0
www.yosensi.io

YO Power User guide v1.0
page 11/27
2. Connect the inputs to the individual channels of the device according to the polarity shown
on the enclosure label.
Figure 7 Connect the inputs to the individual channels of the device.
REV 3.0
www.yosensi.io

YO Power User guide v1.0
page 12/27
3. Fasten the current clamps around the wires in which the current is to be measured (a clamp
should be placed around one wire).
Figure 8 Instruction on how to fasten the current clamps around the wires.
REV 3.0
www.yosensi.io

YO Power User guide v1.0
page 13/27
4. Screw the power supply wires to the device regardless of polarity (6 - 30 V DC, 5 - 21 V AC).
Figure 9 Instruction on how to connect the power to the device.
REV 3.0
www.yosensi.io

YO Power User guide v1.0
page 14/27
Figure 10 Final look of the device.
REV 3.0
www.yosensi.io

YO Power User guide v1.0
page 15/27
Operation
IoT system components
Typical IoT systems consist of 3 main elements (Figure 11), 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 11 IoT system components.
Figure 12 Fresnel zone where communication between two antennas can occur.
REV 3.0
www.yosensi.io

YO Power User guide v1.0
page 16/27
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 Power device.
{
"info": {
"devmodel": "LNPW",
"fwver": "3.2.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": 10,
"ch1cttype": "50mA-100A",
"ch2cttype": "50mA-100A",
"ch3cttype": "50mA-100A",
"ch4cttype": "50mA-100A",
"ch5cttype": "50mA-100A",
"ch6cttype": "50mA-100A"
}
}
REV 3.0
www.yosensi.io

YO Power User guide v1.0
page 17/27
GENERICS PARAMETERS
SECTION
NAME
DESCRIPTION
POSSIBLE
VALUES
DEFAULT
VALUE
READ/
WRITE
info
devmodel
Device name
-
LNPW
R
fwver
Firmware version
-
3.2.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.
REV 3.0
www.yosensi.io

YO Power User guide v1.0
page 18/27
DEVICE PARAMETERS
NAME
DESCRIPTION
POSSIBLE
VALUES
DEFAULT
VALUE
READ/
WRITE
measinterval
Measuring and sending interval
LoRa [s]
1–999999
300
R/W
measthreshold
Measurement threshold for each
channel
2A, 10 A, 50A,
100 A
10
R/W
chxcttype
Number of channel, for x equal from
1 to 6, between the YO Power
device and type of current
transformer sensor clamp
50mA-100 A,
40mA-160 A,
50mA-200A,
50mA-400A,
50mA-600A,
50mA-800A
50mA-100
A
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.
-measthreshold: measurement threshold for each channel.
-ch1cttype…ch6cttype: numbers of channels for each current transformer sensor clamp able
to connect. Different types of clamps depend on the given parameter in the JSON script.
REV 3.0
www.yosensi.io

YO Power User guide v1.0
page 19/27
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
REV 3.0
www.yosensi.io

YO Power User guide v1.0
page 20/27
Configuration via CLI
Connect to the device following these instructions:
1. Read the macBLE address from the sticker on the device. Alternatively, you can identify the
device by RSSI parameter (which correlates with distance between transmitter and receiver).
2. Make sure you have your Bluetooth LE adapter turned on and working properly.
3. Download and run the CLI tool in the terminal/console application.
4. Make sure you have placed batteries in the YO Power device.
5. Run yosensi-cli-tool_vX.X.X_WIN.exe list to scan for Bluetooth devices. You can see
all commands by typing yosensi-cli-tool_vX.X.X_WIN.exe --help or add -h to your
current command to see all needed parameters.
6. If you find your MAC address in the list command results, you can connect and reconfigure
the device by using one of the available commands. You should use the upload_dev_config
subcommand to change device settings. Additional information, including the commands
supported by the CLI, are available at https://yosensi.io/support/CLI_datasheet.pdf.
Command help view:
.\yosensi-cli-tool_v3.1.0_win.exe upload_dev_config --help
usage: yosensi-cli-tool upload_dev_config [-h] mac
positional arguments: mac Bluetooth public MAC address
optional arguments: -h, --help show this help message and exit
Example of use:
.\yosensi-cli-tool_v3.1.0_win.exe upload_dev_config 80:e1:26:1c:f9:e9
It will take up to 120s to find and start uploading configuration data to the device from file, please
wait …
Searching for a device …
Trying to connect to the device LNPW-3.1.0 …
Downloading the configuration file …
Downloading the configuration file is complete.
Checksum of the downloaded configuration data is correct.
The configuration data has been written to the file.
After node reconfiguration, you need to have access to the gateway and server.
NOTE
The firmware update process is described in CLI tool manual, firmware_upload
subcommand section. Visit https://yosensi.io/support to see all available
documentation.
Connecting node with network
According to the LoRaWAN architecture, to transmit data on the network there should be a
configured Gateway and Network Server.. We’ll go through an example in our recommended Yosensi
Management Platform software.
REV 3.0
www.yosensi.io