Advertisement

Quick Links

YO Distance
User guide v1.2

Advertisement

Table of Contents
loading

Summary of Contents for YOSensi YO Distance

  • Page 1 YO Distance User guide v1.2...
  • Page 2: Release Notes

    YO Distance User guide v1.2 page 2/27 Release notes Released Version Key changes 05.09.2022 Initial release. Added node configuration with Yosensi Management 20.06.2023 Platform. Changed description of connecting nodes with Yosensi Management Platform. 26.10.2023 Added configuration with Yosensi Mobile App. www.yosensi.io...
  • Page 3: Table Of Contents

    Installation guide Operation IoT system components Device configuration Configurable parameters Parameters description Configuration node with Yosensi Management Platform Configuration node with Yosensi mobile app Connecting node with network Yosensi Management Platform configuration Adding a node manually Adding node via Bluetooth...
  • Page 4: Product Description

    4/27 Product description Overview YO Distance is a LoRaWAN device for ultrasonic distance measurement. One use case example is monitoring the water level in a remote tank. Additionally, the device contains sensors that measure temperature, relative humidity. Figure 1 Device top view.
  • Page 5: Physical Interfaces

    BLE MAC: bluetooth physical address. Figure 2 Device sticker. Physical interfaces LEDs YO Distance is equipped with a RGBW LED to indicate the operating status on the top of the device. DIODE STATUES INTERPRETATION BEHAVIOUR COLOUR DEVICE STATUS Single flash Green General: device is working correctly (power and memory).
  • Page 6: Specifications

    YO Distance User guide v1.2 page 6/27 Specifications Physical Figure 3 Dimensions of the device. PHYSICAL SPECIFICATION Dimensions Height: 40 mm Width: 100 mm Depth: 100 mm Colour Light grey Mounting method Horizontal Vertical (can be screwed to the wall)
  • Page 7: Operating Conditions

    YO Distance 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)
  • Page 8: Temperature And Relative Humidity

    YO Distance User guide v1.2 page 8/27 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.
  • Page 9: Battery Condition

    YO Distance 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.
  • Page 10: Installation

    YO Distance User guide v1.2 page 10/27 Installation Package contents Device (without batteries). 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.
  • Page 11: Installation Guide

    YO Distance User guide v1.2 page 11/27 Installation guide 1. Unscrew the device: remove 4 screws from the enclosure.Gently disassemble the device (the cover and bottom of the device are connected via cable). Figure 8 Device opening instructions. 2. Place 3 AA batteries in the device according to the polarity marked on the PCB..
  • Page 12 3. The device is on. Screw it back together. Figure 10 Top view of YO Distance after assembling it. 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.
  • Page 13 YO Distance User guide v1.2 page 13/27 5. The device is suitable for horizontal mounting. It is recommended that it be placed in the center of the cover (ceiling) of the water tank, so that the distance from the tank walls is the same on each side.
  • Page 14: Operation

    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).
  • Page 15: Device Configuration

    (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 Distance device. "info": { "devmodel": "LNDN", "fwver": "3.6.1", "loraradio": "SX1261",...
  • Page 16 YO Distance User guide v1.2 page 16/27 GENERICS PARAMETERS SECTION NAME DESCRIPTION POSSIBLE DEFAULT READ/ VALUES VALUE WRITE devmodel Device name LNDN fwver Firmware version 3.6.1 loraradio Radio chipset model SX1261 info lorawanver LoRaWAN stack version 1.0.2 loraregion LoRaWAN region...
  • Page 17: Parameters Description

    YO Distance User guide v1.2 page 17/27 DEVICE PARAMETERS NAME DESCRIPTION POSSIBLE DEFAULT READ/ VALUES VALUE WRITE measinterval Measuring and sending interval 120–999999 3600 LoRa [s] Parameters description nwktype: used for setting the device in public or private network type.
  • Page 18 YO Distance User guide v1.2 page 18/27 UPLINK SUBBAND REGION DESCRIPTION POSSIBLE DEFAULT READ/ VALUES VALUE WRITE EU868 Sub-band 1; 867.1 - 868.5 MHz; channels 0-7 Sub-band 1; 902.3 - 903.7 MHz; channels 0-7 Sub-band 2; 903.9 - 905.3 MHz; channels 8-15 Sub-band 3;...
  • Page 19: Configuration Node With Yosensi Management Platform

    YO Distance 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 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.
  • Page 20: Configuration Node With Yosensi Mobile App

    Configuration node with Yosensi mobile app Connect to the device using Yosensi app as follows: 1. Login to Yosensi App using your credentials. 2. Go to the Devices section and choose the device you want to configure. If you can not see the device ensure that you are in the correct organization.
  • Page 21: Connecting Node With Network

    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 support@yosensi.io.
  • Page 22 Select a model that is compatible with your device — this choice affects the number of charts and data source (YO Distance). 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>.
  • Page 23 5. New nodes must be added in OTAA mode. Nodes can be switched to ABP mode after activation in the 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 blank spaces, then press update.
  • Page 24: Adding Node Via Bluetooth

    ‘DETAILS’ tab (‘Node Name’ column link) and clicking ‘CHARTS’ . Adding node via Bluetooth 1. Log in at 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’ .
  • Page 25: Payload Description

    Extended documentation of the protocol can be found in the Payload description on our website. An example payload produced by YO Distance is presented below with divisions for each measurement and marked with decoded values, whose interpretation is described in the Payload description.
  • Page 26: Compliance Statements

    YO Distance User guide v1.2 page 26/27 Compliance statements www.yosensi.io...
  • Page 27 YO Distance User guide v1.2 page 27/27 www.yosensi.io...

This manual is also suitable for:

Yo airflow pro dualYo airflow pro

Table of Contents