YOSensi YO Meter Pulse User manual

YO Meter Pulse
User guide v1.2

YO Meter Pulse User guide v1.2
page 2/27
Release notes
Released
Version
Key changes
05.09.2022
1.0
Initial release.
14.04.2023
1.1
Addition of device configuration and firmware update
options via Yosensi Configuration Web Tool. CLI is outdated
for new devices (applies to firmware up to 3.4.0).
21.07.2023
1.2
Updated configuration instructions using Yosensi
Management Platform for firmware 3.4.2 and newer.
Changed description of connecting nodes with Yosensi
Management Platform.
www.yosensi.io

YO Meter Pulse User guide v1.2
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 9
Installation 10
Package contents 10
Safety precautions 10
Installation guide 11
Operation 14
IoT system components 14
Device configuration 15
Configurable parameters 15
Parameters description 17
Configuration node with Yosensi Management Platform 19
Connecting node with network 20
Yosensi Management Platform configuration 20
Adding node manually 20
Adding node via bluetooth 23
Payload decoder 24
Compliance statements 25
www.yosensi.io

YO Meter Pulse User guide v1.2
page 4/27
Product description
Overview
YO Meter Pulse device can be used where pulse counting is needed, for example water meters, to
acquire and wirelessly send the information about measured value. Additionally, the device measures
temperature and humidity.
Figure 1 Device top view.
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.
www.yosensi.io

YO Meter Pulse User guide v1.2
page 5/27
Physical interfaces
LEDs
YO Meter 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 Meter is equipped with one reset button inside the device.
www.yosensi.io

YO Meter Pulse User guide v1.2
page 6/27
Specifications
Physical
Figure 3 Dimensions of the device.
PHYSICAL SPECIFICATION
Dimensions
Height: 42 mm
Width: 88 mm
Depth: 64 mm
Colour
Light grey
Mounting method
Horizontal
Vertical (can be screwed to the wall)
Enclosure material
ABS
Level of protection
IP67
Weight
126,5 g
www.yosensi.io

YO Meter Pulse User guide v1.2
page 7/27
Operating conditions
OPERATING CONDITIONS
Temperature
0° to 70°C
Humidity
0 to 90%
Placement
Indoor use
Power supply
3 x LR6 (AA) battery (3 x 1,5 V)
Power consumption
Maximum 120 mA DC (4,5 V DC)
Measured values
MEASUREMENT RANGES
Parameter
Measurement range
Accuracy
Temperature
-40° to 125°C
±0.2°C (5° to 60°C)
Relative humidity
0% to 100%
±2% (20% to 80%)
Periodic counter
0-2147483647 ( int32 )
-
Persistent counter
0-2147483647 ( int32 )
-
Pulse counter
The YO Meter Pulse input accepts connection to potential-free contacts. The device will not count
pulses if the input is connected to contacts with any potential. Device input can detect pulses with
different contact debounce times. This parameter is configurable and by default is 47 ms – up to max.
10 pulses per 1 s (boundary range 1-50 pulses per 1 s depends on the contact debouncing setting).
Device is equipped with two counters: periodic and persistent.
www.yosensi.io

YO Meter Pulse User guide v1.2
page 8/27
Periodic counter counts pulses cyclically with time interval defined by LoRa sending interval. The
periodic counter counts the pulses within the time interval specified by the measurement interval
parameter which also specifies the time at which a LoRaWAN data payload is sent.
Figure 4 Periodic pulse counter exemplary chart.
Persistent counter accumulates pulses and stores them in non-volatile memory - this counter can be
reset (cleared) using one of the parameters via BLE.
Figure 5 Persistent pulse counter exemplary chart
Temperature and relative 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 6 Internal temperature exemplary chart.
www.yosensi.io

YO Meter Pulse User guide v1.2
page 9/27
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 7 Battery voltage exemplary chart.
www.yosensi.io

YO Meter Pulse User guide v1.2
page 10/27
Installation
Package contents
1. Device (without batteries).
2. Warranty card.
3. PG7 cable gland cap.
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. 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 Meter Pulse User guide v1.2
page 11/27
Installation guide
1. Unscrew the device: remove 4 screws from the enclosure.
Figure 8 Device opening instructions.
2. Unscrew the cable gland nut and remove the cap.
Figure 9 Device with removed top cover and PG7 cap marked.
www.yosensi.io

YO Meter Pulse User guide v1.2
page 12/27
3. Pass the pulse counting cable through the cable gland.
Figure 10 Input cable passing through the cable gland instructions.
4. Press the spring contact in the DI connector and insert the pulse counting cable. Tighten the
cable gland nut to immobilize the sensor cable and maintain tightness.
Figure 11 Connecting input cable instructions.
www.yosensi.io

YO Meter Pulse User guide v1.2
page 13/27
5. Place three LR6 (AA) batteries in the device according to the polarity indicated on the battery
holder.
Figure 12 Battery placement instructions.
6. Assemble the device and screw it back together.
www.yosensi.io

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

YO Meter Pulse User guide v1.2
page 15/27
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 Meter Pulse device.
{
"info": {
"devmodel": "LNMP",
"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": 1800,
"debouncetime": 47,
"clearcnt": "no"
}
}
www.yosensi.io

YO Meter Pulse User guide v1.2
page 16/27
GENERICS PARAMETERS
SECTION
NAME
DESCRIPTION
POSSIBLE
VALUES
DEFAULT
VALUE
READ/
WRITE
info
devmodel
Device name
-
LNMP
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 Meter Pulse User guide v1.2
page 17/27
DEVICE PARAMETERS
NAME
DESCRIPTION
POSSIBLE
VALUES
DEFAULT
VALUE
READ/
WRITE
measinterval
Measuring and sending interval
LoRa [s]
1–999999
1800
R/W
debouncetime
Pulse input debounce time [ms]
1–1000
47
R/W
clearcnt
Clear the persistent pulse counter
no, yes
no
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.
-debouncetime: input frequency depends on the setting of the contact debouncing parameter;
by default it is 47 ms.
-clearcnt: device keeps a persistent counter in EEPROM where it stores the total number of
pulses counted; this counter can be cleared using this parameter.
www.yosensi.io

YO Meter Pulse User guide v1.2
page 18/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
www.yosensi.io

YO Meter Pulse User guide v1.2
page 19/27
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 application, 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. Now 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. 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 15 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

YO Meter Pulse User guide v1.2
page 20/27
Connecting node with network
The LoRaWAN architecture requires a configured Gateway and Network Server. We’ll go through an
example in our recommended Yosensi Management Platform software.
Yosensi Management Platform configuration
Before you can make the node visible, you’ll need an organization and an application. The
organization is your own space, at the highest level of IoT systems management (like the root
directory in operating systems). It can be created only by Yosensi staff, and all clients using Yosensi
Management Platform have one created for them by default. In case of any questions, you can find us
at [email protected]. The application is a representation of each system and, together with the
node definitions, is created by customers. The basic integration of a node into the Yosensi
Management Platform is described below. Nodes can be added manually or via Bluetooth.
NOTE
A subscription is needed to use Yosensi Management Platform. Contact us on
[email protected] for more information and pricing.
Adding a node manually
Yosensi Management Platform integration instructions:
1. Log in to app.yosensi.io.
2. You’ll see the default organization view. To switch to another organization, click on the user
avatar in the right top corner and select ‘Switch Organization’.
3. To create a new application, press the bottom right ‘+’ button. Fill in the ‘Name’ and
‘Description’ fields and select an ‘Application Profile’, which is the region definition.
Figure 16 Application creation form.
www.yosensi.io