YOSensi YO AgriBox User Manual
  1. Manuals
  2. Brands
  3. YOSensi Manuals
  4. Measuring Instruments
  5. YO AgriBox
  6. User manual

YOSensi YO AgriBox User Manual

Hide thumbs
Table of Contents

Advertisement

Quick Links

Download this manual
YO AgriBox
User guide v1.3

Advertisement

Table of Contents
loading

Related Manuals for YOSensi YO AgriBox

Summary of Contents for YOSensi YO AgriBox

  • Page 1 YO AgriBox User guide v1.3...

  • Page 2: Release Notes

    Platform. With firmware 3.5.0 added new device parameter with description: soil type. Changed instructions of connecting node with network due to release of Yosensi configuration 07.07.2023 web tool. Checking OTAA and ABP keys are outdated with CLI since release firmware 3.4.0. Changed description of connecting nodes with Yosensi Management Platform.

  • 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

    Product description Overview YO AgriBox is a LoRaWAN device for measuring soil moisture at 3 points. Additionally, the device contains sensors that measure temperature and relative humidity inside the device. YO AgriBox makes it easy to plan and maintain optimum growing conditions for plants.

  • Page 5: Physical Interfaces

    BLE communication: connection to the device via BLE (configuration). Rapid flashing Blue LoRaWAN communication: connecting to LoRaWAN network. Buttons YO Agribox is equipped with one reset button inside the device on the PCB board next to the RGBW LED diode. www.yosensi.io...

  • Page 6: Specifications

    YO AgriBox User guide v1.3 page 6/30 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)

  • Page 7: Operating Conditions

    YO AgriBox User guide v1.3 page 7/30 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: Volumetric Water Content

    YO AgriBox User guide v1.3 page 8/30 Volumetric water content This value measures soil moisture content. Measurements are given in percentage value. Accuracy depends on the correct sensor installation. Figure 4 Volumetric water content chart probe 1. Figure 5 Volumetric water content chart probe 2.

  • Page 9: Internal Temperature And Relative Internal Humidity

    YO AgriBox User guide v1.3 page 9/30 Figure 6 Volumetric water content chart probe 3. 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.

  • Page 10: Battery Condition

    YO AgriBox User guide v1.3 page 10/30 Figure 8 Internal humidity exemplary chart. 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 11: Installation

    YO AgriBox User guide v1.3 page 11/30 Installation Package contents Device (without batteries). Warranty card. 3pcs. of 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.

  • Page 12: Installation Guide

    YO AgriBox User guide v1.3 page 12/30 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 Installation guide 1.
  • Page 13 YO AgriBox User guide v1.3 page 13/30 4. The soil moisture sensors should be connected according to the markings on the PCB, the sensor placed in CH1 should be inserted into the connectors marked "1" on the PCB, etc. Press the spring contact and insert the appropriate wire into the corresponding slot in the connector: brown wire (GND) - selected channel marked with „-”...
  • Page 14 YO AgriBox User guide v1.3 page 14/30 6. Assemble the device and screw it back together. 7. The accuracy of the reading depends on the correct installation of the sensor in soil. Depending on the needs there are several possibilities of sensor installation. Figure 14 shows the measuring probes can be completely buried and can be placed at different depths in the soil.

  • Page 15: 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 16: 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 Agribox device. "info": { "devmodel": "LNAG", "fwver": "3.6.2 ", "loraradio": "SX1261",...
  • Page 17 YO AgriBox User guide v1.3 page 17/30 GENERICS PARAMETERS SECTION NAME DESCRIPTION POSSIBLE DEFAULT READ/ VALUES VALUE WRITE devmodel Device name LNAG fwver Firmware version 3.6.2 loraradio Radio chipset model SX1261 info lorawanver LoRaWAN stack version 1.0.2 loraregion LoRaWAN region...

  • Page 18: Parameters Description

    [s] between sending LoRa packets. ch1cablelength, ch2cablelength, ch3cablelength: cable length of each soil moisture sensor connected to YO Agribox. soiltype: parameter describing the type of soil which the sensor is placed. This parameter significantly improves soil moisture collection for a specific soil Organic type soil includes black earth, peat and muck soils.
  • Page 19 YO AgriBox User guide v1.3 page 19/30 Downlink message It is possible to change the measurement interval (measinterval) by using downlink. Information about changing parameter will be sent from server via gateway when Example of downlink message must include: Prefix: 0x03 ●...
  • Page 20 YO AgriBox User guide v1.3 page 20/30 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 21: Configuration Node With Yosensi Management Platform

    YO AgriBox User guide v1.3 page 21/30 Configuration node with Yosensi Management Platform Connect to the device following these instructions: 1. Log in at app.yosensi.io 2. You’ll see the dashboard organization view. Go to the Application section in the sidebar.

  • Page 22: 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 23: 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 24 Select a model that is compatible with your device — this choice affects the number of charts and data source (YO AgriBox). 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 25 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 26 YO AgriBox User guide v1.3 page 26/30 Figure 23 Node LoRa type configuration form. 6. When the server receives data from the device, you’ll notice that the ‘Last Seen’ column (‘NODES LIST’ tab) status changes from ‘never’ to a few ‘seconds ago’ .

  • Page 27: Adding Node Via Bluetooth

    Extended documentation of the protocol can be found in the Payload description on our website. An example payload produced by YO Agribox is presented below with divisions for each measurement and marked with decoded values, whose interpretation is described in the Payload description.
  • Page 28 YO AgriBox User guide v1.3 page 28/30 0x10 0x00 0x00 0x40 type = 4, addr_len = 0 val = 64 md [s] = 0 prec = 0 meas_len = 1 (64[%]) Fourth measurement (output voltage- CH1,CH2,CH3) 0x44 0x00 0x07 0x09...

  • Page 29: Compliance Statements

    YO AgriBox User guide v1.3 page 29/30 Compliance statements www.yosensi.io...
  • Page 30 YO AgriBox User guide v1.3 page 30/30 www.yosensi.io...

Table of Contents