YOSensi Airflow Pro2 User manual

YO Airflow Pro2
User guide v1.0

YO Airflow Pro2User guide v1.0
page 2/23
Release notes
Released
Version
Key changes
24.03.2023
1.0
Initial release.
REV 1.0
www.yosensi.io

YO Airflow Pro2User guide v1.0
page 3/23
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
Internal Temperature and relative internal humidity 7
Battery condition 8
Differential pressure 8
Installation 11
Package contents 11
Safety precautions 11
Installation guide 12
Important! 13
Important to avoid breaking the device! 13
Operation 15
IoT system components 15
Device configuration 16
Configurable parameters 16
Parameters description 18
Configuration node 20
Connecting node with network 20
Yosensi Management Platform configuration 21
Payload description 23
Compliance statements 24
Revision history 25
REV 1.0
www.yosensi.io

YO Airflow Pro2User guide v1.0
page 4/23
Product description
Overview
The YO Airflow Pro2is equipped with two differential pressure sensors. It can be used to verify the
dirtiness of air filters and control the pressure in air conditioning systems and air blowers. Other uses
include controlling and monitoring airflow and air pressure in fan coil units.
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: unique device identifier required to connect via OTAA connection type to
LoRaWAN.
- DEV ADDR: address required to connect via ABP connection type to LoRaWAN.
- BLE MAC: bluetooth physical address.
REV 1.0
www.yosensi.io

YO Airflow Pro2User guide v1.0
page 5/23
Figure 2 Device sticker.
Physical interfaces
LEDs
YO Airflow Pro2communicates 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 Airflow Pro2is equipped with one reset button inside the device on the PCB board next to the
RGBW LED diode.
REV 1.0
www.yosensi.io

YO Airflow Pro2User guide v1.0
page 6/23
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
104 g
REV 1.0
www.yosensi.io

YO Airflow Pro2User guide v1.0
page 7/23
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
Measuring range
Accuracy
Differential pressure
-500 Pa to 500 Pa
0,1 Pa + 3% reading
(temperature dependent)
Temperature (internal)
-40°C to 125°C
±0,2°C (from 5°C to 60°C )
Relative humidity (internal)
0% to 100%
±2% (at 20%RH to 80% RH)
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.
Battery condition
Battery voltage is used to monitor the operating condition of the device. This data allows the user to
detect anomalies (like a sudden drop) and track the current state of the battery based on the voltage
drop over time compared to the initial voltage.
Differential pressure
Differential pressure is measured by two separate sensors. One of them provides information about
air pressure before the filter; the second measures air pressure after the filter. Measurements inform
users about airflow and air quality.
REV 1.0
www.yosensi.io

YO Airflow Pro2User guide v1.0
page 8/23
Installation
Package contents
1. Device (without batteries).
2. Warranty card.
3. Silicon tubes
4. Brackets or pitot tubes
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
REV 1.0
www.yosensi.io

YO Airflow Pro2User guide v1.0
page 9/23
Installation guide
1. Unscrew the device and remove all four screws from the enclosure.
Figure 4 Opening the enclosure of the device.
2. Place three LR6 batteries in the device according to the polarity indicated on the battery
holder.
Figure 5 Battery placement instructions.
REV 1.0
www.yosensi.io

YO Airflow Pro2User guide v1.0
page 10/23
3. Test to ensure the device turns on, then screw the enclosure back together.
4. Insert the silicone tubing into the sensor inputs.
Figure 6 Silicone tubing connection instructions.
Important!
The sensors must be placed according to the following diagram, i.e., the sensor measuring the higher
pressure must be placed on the right side and the one measuring the lower pressure on the left side:
Figure 7 Silicone tubing connection instructions (side view).
Important to avoid breaking the device!
When removing silicone tubes, it is necessary to use a sharp tool. First, the tubes must be cut off at
the edge of the sensor, then you can cut off the rest of the tube located along the black sensor. Be
careful to gently remove the rest of the silicon tube without breaking the sensor.
REV 1.0
www.yosensi.io

YO Airflow Pro2User guide v1.0
page 11/23
5. Place the brackets according to their use:
●The sensor measuring the higher pressure must be placed where the higher pressure
occurs
●The sensor measuring the lower pressure must be placed where the pressure is lower
Figure 8 Connecting silicone tubing with pitot tubes.
REV 1.0
www.yosensi.io

YO Airflow Pro2User guide v1.0
page 12/23
Operation
IoT system components
Typical IoT systems consist of 3 main elements (Figure 13), 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 9 IoT system components.
Figure 10 Fresnel zone where communication between two antennas can occur.
REV 1.0
www.yosensi.io

YO Airflow Pro2User guide v1.0
page 13/23
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 Airflow Pro2device.
{
"info": {
"devmodel": "LNAD",
"fwver": "3.4.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": 3600
}
}
REV 1.0
www.yosensi.io

YO Airflow Pro2User guide v1.0
page 14/23
GENERICS PARAMETERS
SECTION
NAME
DESCRIPTION
POSSIBLE
VALUES
DEFAULT
VALUE
READ/
WRITE
info
devmodel
Device name
-
LNDA
R
fwver
Firmware version
-
3.4.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 1.0
www.yosensi.io

YO Airflow Pro2User guide v1.0
page 15/23
DEVICE PARAMETERS
NAME
DESCRIPTION
POSSIBLE
VALUES
DEFAULT
VALUE
READ/
WRITE
measinterval
Measuring and sending interval
LoRa [s]
1–999999
3600
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.
REV 1.0
www.yosensi.io

YO Airflow Pro2User guide v1.0
page 16/23
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 1.0
www.yosensi.io

YO Airflow Pro2User guide v1.0
page 17/23
Configuration node
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 11 Firmware section and update configuration section form.
6. Press the upload button and wait.
For more detailed information you can find us on [email protected] or go to the YOsensi Bluetooth
web tool 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 1.0
www.yosensi.io

YO Airflow Pro2User guide v1.0
page 18/23
Yosensi Management Platform configuration
Before you can make the node visible, you’ll need an organisation and an application. The
organisation 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 it created for them by default (in case of any problems you can find us on
[email protected]). The application is a representation of each system and, together with nodes
definitions, are created by customers. Basic integration of a Node and Yosensi Management Platform
is described below.
NOTE
A subscription is needed to use Yosensi Management Platform. Contact us on
[email protected] for more information and pricing.
Yosensi Management Platform integration instructions:
1. Go to app.yosensi.io and log in.
2. You’ll see the default organisation view. To switch to another organisation, click on the user
avatar in the right top corner and select ‘Switch Organization’.
3. To create an application, press the bottom right ‘+’ button. Fill in the ‘Name’ and ‘Description’
fields and ‘Select Application Profile’ which is the region definition.
Figure 12 Application creation form.
4. Proceed to the application by clicking its name on the list, and press the ‘+’ button to add a
node. Select ‘Lora’ or ‘Helium’ if you want to connect to Helium network in ‘Node Type’ field.
Set the ‘Name’, ‘Description’ fields and fill in ‘Node ID’ (deveui) and ‘OTAA Key’ (otaa section -
appkey)which can be found using the firmware section. Select a model that is compatible
with your device—it affects the number of charts, its placement and data source (YO Airflow
Pro2model). You can also set the node’s ‘Location’, if locations have been pre-defined. If you
haven’t defined a suitable location, leave this field set at <None>.
REV 1.0
www.yosensi.io

YO Airflow Pro2User guide v1.0
page 19/23
Figure 13 Node creation form.
5. Every new node must be added in OTAA mode. You must then switch its type to ABP after
activation in Yosensi Management Platform by changing the Node configuration. Click on the
link in the ‘Node Name’ column. Go to the ‘KEYS’ tab and switch ‘Lora Type’ from OTAA to
ABP, and fill in the ‘Device Address’ (devaddr), ‘Application Session Key’ (appskey) and
‘Network Session Key’ (nwkskey) with values from the firmware section,and press UPDATE.
REV 1.0
www.yosensi.io

YO Airflow Pro2User guide v1.0
page 20/23
Figure 14 Node LoRa type configuration form.
6. When data is received by the server, you’ll notice that the ‘Last Seen’ column (‘NODES LIST’
tab) status changes from ‘never’ to ‘a few seconds ago’.
7. Open charts by clicking on the ‘OPEN’ button in Dashboard columns or by entering the
node’s ‘DETAILS’ tab (‘Node Name’ column link) and clicking ‘CHARTS’.
Payload description
If you want to connect to your own server you have to decode the payload specific to each device. To
do this you need a payload decoder which can be downloaded from Payload decoder. Extended
documentation of the protocol can be found at Payload description.. An exemplary payload produced
by YO Airflow Pro2is presented below with division into each measurement marked together with
decoded values whose interpretation is described in the Payload description document.
Example of YO Airflow Pro2payload with description:
02:00:00:00:08:00:01:11:ce:0d:00:01:00:f0:10:00:00:42:41:00:05:fe:f5:00:60:00:bd:15:00:01:08:
ab:0d:00:11:25:00:f7
Payload header
First measurement (battery voltage)
0x02
0x00
0x00
0x00
0x08
0x00
0x01
0x11
0xCE
ver = 2
cnt = 0
pct [s] = 0
type = 2
prec = 0
md [s] = 0
addr_len = 0
meas_len = 2
val = 4558
(4558 [mV])
REV 1.0
www.yosensi.io