SHUSHAN CVI-Wireless User Manual

Introduction 

Thank you for choosing the SHUSHAN Configuration and Visualization Software from DurUntash Lab. The SHUSHAN CVI-Wireless is a Windows-based application specifically designed  to work with DurUntash Lab hardware. The SHUSHAN CVI-Wireless can be used in combination with our data loggers, sensor adapters and sensors. The software is provided free of charge with all DurUntash Lab products. To understand how the SHUSHAN CVI-Wireless works, and to maximize its benefit, please make sure to read the contents of this user manual. We also recommend exploring the resources available on our website, and reading our blog articles

SHUSHAN CVI sensor data monitoring and display for agriculture
 

SYSTEM

SHUSHAN CVI-Wireless Application

The SHUSHAN CVI-Wireless is Windows®-based (7, 8 or 10) graphical user interface, which can be used for easy device/sensor configuration, firmware update, data retrieval, and real-time computer-based data visualization and logging. As an option, the SHUSHAN app can be used to apply custom calibration and temperature-compensation coefficients to measurements in real-time. The SHUSHAN CVI is designed to work with all DurUntash products (e.g. reader, data logger, sensor interface) and can collect data from a large  wireless sensor network. Some features of the software might not be available when connected to some DurUntash devices. The SHUSHAN app is free software and you can download (Software > SHUSHAN CVI-Wireless) its latest version from our website.

Specifications

General

  • Current Version: 3.1 (2021)

  • Operating System: Windows 10, 8, or 7

  • Requirements: .Net Framework 4.8

Device Compatibility

INSTALLATION

 

SHUSHAN app setup files are available in our downloads page (Software > SHUSHAN CVI-Wireless). You can install the SHUSHAN app in a few easy steps as explained below: 

Step 1

 

Look for "setup.exe" file and double click it. A window with a "welcome to installation" should appear momentarily. Click Next.

 

Note: If you do not have the required version of Microsoft .Net Framework installed on you system, you will be prompted to install it first. You need an Internet connection for this to work, because .Net Framework will be downloaded from the Internet. Follow the instructions and complete the setup of .Net Framework if prompted.

Step 2

 

Read the end user license agreement, agree and click Next.

Step 3

 

Choose a folder where you want the SHUSHAN CVI software to be installed (installation folder) and click Next.

Note: At this stage the installer will attempt to install device drivers on your system. Please make sure that no DurUntash hardware is connected to the computer. For more information, please refer to the section on Drivers Installation.

Step 4

 

Click Next to start the installation process.

Step 5

 

If the installation is successful, you will see a window with an "installation complete" message.

InstallationSteps1.JPG
InstallationSteps2.JPG
InstallationSteps3.JPG
InstallationSteps4.JPG
InstallationSteps5.JPG

Drivers Installation

 

A USB driver must be installed before connecting DurUntash devices to the computer. In most cases, the drivers are automatically installed, however, as part of the SHUSHAN CVI installation you may be prompted to install the drivers. Below, you can see several driver installation windows. Follow provided instructions to complete the installation of drivers.  Contact us if you had any troubles with the process. 
 

D1.JPG
D3.JPG
D2.JPG
D4.JPG
 

OPERATION

 

Software Tabs

The SHUSHAN CVI main window is comprised of four tabs: 1) Main tab, 2) Charts tab, 3) Shee tab, and 4) Console tab. These tabs and their functions are explained below. 

Main Tab

 

The Main tab allows you to connect to USB or wireless devices (e.g. gateway), start computer-based data logging, retrieve data from DurUntash data loggers, and see real-time data from DurUntash sensors connected to a DurUntash hardware interface.

Connect to WiFi Device

To connect to a DurUntash device over WiFi (e.g. ISHKUR G-WF), you first need to find its IP and MAC address. This process is easy and you first need to connect to your device using the provided micro USB cable (explained below). Once connected as a USB device, go to the "Help" menu and click "Device Information". The software will automatically obtain your WiFi device information including its IP and MAC address and populate the corresponding boxes.

SHUSHAN CVI sensor data monitoring and display for agriculture

If the "Device IP" box remains empty or shows "(IP Unset)", this means your gateway is not connected to WiFi yet. Wait for it to connect  and try again. Then, click the "Connect" button. The app will automatically scan the area for the device that is connected to the local WiFi network or has its own WiFi hotspot (depending on the mode of operation). 

Connect to Server

This section is reserved for DurUntash Lab IoT-enabled devices (e.g. ISHKUR G-IT WiFi IoT-enabled gateway) and cloud-based services. To be able to connect to our servers (or cloud services), you need an API key which is provided to you as part of your data plan. You also need to set your local time zone. Please read this section to learn how to enter your API key and take care of other required settings. 

 

To add a new device to the list, please click on the "Add Device" button. Enter a device name (or ID) and click Ok. To Set alias for your device, choose the device from the dropdown menu and click on the "Set Alias". Enter an alias name and click Ok. To clear the list of devices, click on the "Clear List" button. 

The ISHKUR G-IT gateway records sensor data in a could-based data storage. You can either download historical sensor data for a specific time period or monitor near real-time sensor measurements (similar to ISHKUR G-WF WiFi mode). To monitor near real-time data, please click on the "Connect" button. The SHUSHAN CVI will automatically connect to the server, makes API requests at the specified intervals (say every 60 min), downloads available sensor data and plots them. 

 

Historical data can be retrieved by clicking the download button for any time period (provided data is available for that period). The SHUSHAN CVI downloads and writes the data in a "CSV" file (comma-separated text format), which can be easily opened in a Microsoft Excel or Notepad. Please take the following steps to download sensor data from the cloud storage using the SHUSHAN CVI software:  

 

  1. Make sure your computer is connected to the Internet.

  2. Open the SHUSHAN CVI software.

  3. Go to the Main tab > Connect to Server.

  4. Pick an appropriate device name or alias from the dropdown menu. 

  5. Pick an appropriate time period.

  6. Click on the "Download" button. You will get notifications when the process starts and when it ends.

Connect to USB Device

The SHUSHAN app does not automatically recognize devices that are connected to the computer. To connect to a device (e.g. AVAN Zero), choose a correct device name from the drop-down menu and select the correct port number. Please note that most DurUntash Lab device names are not explicitly listed. Thus, if you don't see the name of your device, simply choose "Other" from the drop-down menu. If in doubt about the correct port number, plug and unplug the device and choose the port that disappears when the device is disconnected. It may take up to 10 seconds for the port number to appear after connecting a new device, so please be patient. Click on the "Connect to Device" and wait for a moment until the name of the device appears on the main window status bar (example: -> ISHKUR G-WF). If connection is successful, device information and sensor data will populate the main tab boxes. You see the connection progress in the Debug window of the Console tab. 

Retrieve Data (Data Loggers)

This section only works with DurUntash dataloggers (see SHINAK Series and SUMERIT node). If you have a DurUntash datalogger connected to the computer, you will be able to check its memory status (free memory and number of records), delete data file (erase memory), and retrieve data that is available in the memory of the data logger. The progress bar reaches 100% when all data has been downloaded to the computer.

The datalogger records sensor data in a comma separated text format. The SHUSHAN CVI downloads and writes the data in a "csv"  file, which can be easily opened in a Microsoft Excel or Notepad. Please take the following steps to download sensor data using the SHUSHAN CVI software:  

 

  1. Connect the datalogger to the computer.

  2. Open the SHUSHAN CVI software.

  3. Go to the Main tab.

  4. Pick appropriate time period.

  5. Click on the "Retrieve Data" button. The downloading process will start momentarily. The progress bar (on the right) will show the percentage of downloaded data.

To delete the data file (on the datalogger), click the "Delete Data File" button. To know how many records are available to download, click the "Check Memory" button.​

Wireless Sensor Nodes

This section displays wireless sensor nodes information including name, alias, RSSI (signal strength), last update and battery voltage. Each wireless sensor node has an original name comprised of a commercial name and a device number (in brackets). The commercial name is read-only, but the device number can be set to any number between 0 and 255 (explained later). You can also a note to each wireless sensor node to identify them more easily. Double click the note area (yellow box) to write a note or change/delete the content.  

Sensor Channels

This section displays real-time data from up to four sensors connected to DurUntash devices. As soon as a sensor is detected at a port/channel, the green light turns on and sensor readings are displayed in corresponding boxes. If no sensor is present on a channel, TBD (To Be Determined) is shown next to the sensor reading box and the light turns grey. A red light indicates a soil moisture reading that is below the specified dry threshold. There is a "note area" in each channel section in light blue color, which can be used to give a name to specific channel and/or write down any other relevant information. Double click the note area (blue box) to write a note or change/delete the content.

Irrigation Status

If you have SUMERIT 2P-BLE irrigation node connected to your computer, you will be able to see irrigation notifications for its irrigation control port at the right bottom corner of the "Main" tab. Depending on the irrigation mode (section: Device Configuration Utility > Controller Tab), which can be "automatic" or "manual", the irrigation control button is enabled or disabled. In addition, the color and displayed text will change. Here's a list of possible scenarios:

  1. Automatic irrigation is off. The button is disabled, text "Auto (Irri Off)" will be displayed.

  2. Automatic irrigation is on. The button is disabled, text "Auto (Irri On)" will be displayed.

  3. Manual irrigation is off. The button is enabled (can be clicked), text "Turn On" will be displayed.

  4. Manual irrigation is on. The button is enabled (can be clicked), text "Turn Off" will be displayed.

 

The irrigation runtime is displayed next to the button. The irrigation runtime and status are sent to the app by the device in real-time. This means that even if you close the software and start it again, you will still see the correct status and runtime.

Charts Tab

 

As the name implies, the Charts tab is where sensor data is plotted and displayed. Depending on the type of sensors connected, up to three different charts may show up at the same time. The chart area will be active only if you have a connected device.

To select or hide specific data series, click on its name in the legend area. To unhide a series or to hide/unhide a chart, right click in the chart area. A menu will appear. Click on the chart name to hide/unhide. 

To plot historical data, choose a period time from the list and click "Plot". To reset the chart click on the "Reset Chart" button. Please note that only historical data for the sensors/channels that are active will be displayed. 

SHUSHAN CVI sensor data monitoring and display for agriculture

Console Tab

 

The primary purpose of the Console tab is troubleshooting by having access to the flow of incoming data from/to DurUntash hardware.

The are three windows in the console tab:

1) Notifications,

2) Status Updates, and

3) Debug.

 

Any alarms/notifications generated by the application is displayed in the Notifications window. Specific status updates or confirmations sent by a device are shown in the Status Updates window. The debug window displays any incoming or outgoing data/commands. It is also used during the firmware update process to track the progress. 

To clear the content of the windows, click on the "Clear Output" button.

SHUSHAN CVI sensor data monitoring and display for agriculture

Menu Bar

The Menu Bar is located at the top of the main window and includes the File, Tools and Help menus. These menus are explained below:

File

​Click one of the options under the Open sub-menu to open the Data Folders that are stored on the computer. A data file is created for 1) real-time data from USB devices, 2) real-time data from wireless sensor nodes, 3) data from remote devices or servers, 4) downloading records from a DurUntash datalogger, 5) generated errors, 6) generated alarms or notifications, and 7) status updates. Recorded data are available in comma-separated csv format and can be easily opened in Notepad or spreadsheets like Microsoft Excel.

Click Restart the Application to restart the SHUSHAN application.

Click Exit to exit the application.

Tools

​There are three options available under the Tools menu: 1) Update Firmware, 2) Settings., and 3) Device Configuration Utility. Please refer to the "Update Firmware" section to learn how to use the SHUSHAN app for updating your device's firmware. Clicking on Settings will open the "Settings Window", and clicking on Device Configuration Utility will open the "Device Configuration Utility". 

Help

There are several options under the Help menu. These options and their functions are explained below:

 

Device Information

Please take the following steps to retrieve your device information using the SHUSHAN CVI software:  

 

  1. Connect your device to the computer.

  2. Click on "Device Information". A dialog should appear with a list of device information (name, manufacturer, product URL, firmware version, compilation date, and serial number). 

  3. Click Ok and you will be redirected to the product page on our website (Internet connection required).

AVANZero_DeviceInfo.JPG

DurUntash Lab Homepage

Click on "DurUntash Lab Homepage" to open the DurUntash Lab homepage on the web.

Check for Software Update

Click on "Check for Software Update" to see if there is a new version of the SHUSHAN CVI available. Click Ok and you will be redirected to DurUntash downloads page.

Check for Firmware Update

Click on "Check for Firmware Update" to see if there is a new firmware version is available for your device. Click Ok and you will be redirected to DurUntash downloads page.

View Software User Manual

Click on "View Software User Manual" to open the DurUntash Lab online user manual on the web.

About SHUSHAN CVI

Click on "About SHUSHAN CVI" will open a window with information about the SHUSHAN CVI software including its current version.

 

Status Bar

The status bar is located at the bottom of the main software window below the tabs. If a device is connected to the computer and recognized by the SHUSHAN CVI, its name along with its allocated number (in brackets) will be displayed on the left corner side of the bar. Battery voltage (V, %) and time are displayed on the right corner side of the bar. In the middle of the status bar, there is an area ("information area") where the SHUHSN CVI will display informative messages. For example, "Logging data..." indicates that the software is engaged in automatic data logging. The information area also displays messages when the device configuration utility (explained below) is in use.

Statusbar.JPG

Settings Window

 

The Settings window has three tabs: 1) Sensors, 2) Data, and 3) Alarms. These are explained below:

Sensors Tab

EC Sensor (Unit)

If you have the HITA E0 electrical conductivity sensor connected, you can choose between plotting EC (dS/m) or TDS (ppm) values on the chart.

APAS T1 Software Calibration

By default, DurUntash data loggers and sensor adapters automatically apply calibration coefficients to the APAS T1 soil moisture sensor readings. As an option, the SHUSHAN CVI can be used to apply an extra layer of calibration to measurements in real-time (when carrying out computer-based data logging). The calibration equation can be linear (y = bx + c) or quadratic (y = mx^2 + bx + c), where "m", "b", and "c" are constants/coefficients, "x" is the soil moisture reading before calibration, and "y" is the calibrated reading. The software calibration can be enabled or disabled.

APAS T1 Software Temperature Compensation

By default, DurUntash data loggers and sensor adapters automatically compensate APAS T1 soil moisture sensor readings for temperature fluctutations. As an option, the SHUSHAN CVI can be used to add an extra layer of temp-compensation to measurements in real-time (when carrying out computer-based data logging). The temp-compensation involves a two-stage algorithm (based on multiple regression analysis) that takes both temperature and moisture readings and compensates water content readings for fluctuations that are caused by temperature change. Please do not modify the value of the Tref box (reference temperature). The reference temperature is 25 °C, by default. Please read this section on APAS T1 temperature compensation for more information.

HITA E0 Software Calibration

Our HITA E0 electrical conductivity sensor provides EC readings in the range of 0 - 20 dS/m, however these readings are only calibrated for the 0 - 10 dS/m range. As an option, the SHUSHAN CVI can be used to apply an extra layer of calibration to EC measurements in real-time (when carrying out computer-based data logging). The calibration equation can be linear (y = bx + c) or quadratic (y = mx^2 + bx + c), where "m", "b", and "c" are constants/coefficients, "x" is the reading before calibration, and "y" is the calibrated reading. The software calibration can be enabled or disabled.

Settings_Sensors_1.PNG

Notifications Tab

Wet/Dry Thresholds (Moisture Sensor)

Here you can enable an algorithm that automatically compares real-time moisture sensor (APAS T1) readings with the specified dry threshold and generates irrigation signals. The application will also divide the charts area (Home > Charts tab) into well-watered, over-watered and under-watered areas by painting different colors. You can set the lower and upper thresholds to values between 0 and 100. The Wet threshold must be greater than the Dry threshold.

Note: Moisture alarms are generated based on the dry threshold. The wet threshold is only used to display a “well-watered” range (between dry and wet thresholds) in the water content Chart area (Charts tab).

Notification Time

In this section, you can set a time (Time of Day) for notifications to appear in the "Notifications" section of the "Console" tab or be emailed to you. You can also reset notifications that have been generated in the background by clicking the "Reset Notifications" button. Notifications are aggregated and sent once a day.

Settings_Notifications_1.PNG

Email Report

In this section, you can enable an emailing system that will generate and send email reports from/to specified email addresses. This will let you know if soil moisture conditions are critical in any given irrigation zone. You need to check the "Enabled" checkbox in the previous section, otherwise you will not email notifications if moisture readings drop below the specified threshold.

You will need at least one email address to make this work. We strongly recommend that you sign up for a new Gmail account (to send email from) specifically for this purpose. You might need to turn on "Less secure app access" for this account. Please refer to this page from Google to learn how you can do that. 

If you leave the "Email (To)" box empty, the SHUSHAN CVI application will send email notifications to the same mailbox. The "Email (To)" address can be any email at which you would like to receive notifications. You may enter more than one email address in the box by separating them using comma (","). 

IoT Tab

Cloud Server Credentials

In this section, you can enter your API key (comes with your ISHKUR G-IT gateway data plan). Click the "Show Chars" button to see entered characters.   

Cloud Server Preferences

The cloud server preferences include three parameters:

  1. Local Time Zone,

  2. Days to Load, and

  3. Connection Intervals

From the dropdown menu, please choose the "Local Time Zone" that matches your location. The "Days to Load" ranges between 1 and 7 days and specifies the number of days for which historical data is downloaded (saved to a temporary file) from the server when you connect to our cloud service or server (Main Window> Main Tab > Connect to Server > Connect). The "Connection Intervals" determine the frequency at which the SHUSHAN application checks our cloud-based database (API requests) for available data (through an API gateway) once connected to server. The connection intervals can be set to any number between 15 and 1440 min. 

Important Note: the number of API requests might be limited depending on your data plan and API key. We recommend "Connection Intervals" that are as high as possible (> 60 min) to make sure that you will not run out of API requests. Please contact us directly if in doubt. 

Settings_IoT_1.PNG
 

General Tab

Storing Real-Time Data on Computer (USB Devices)

The SHUSHAN CVI can be used for computer-based data logging. DurUntash Lab data loggers and sensor adapters take sensor measurements every 5 or 10 s. The measurements are sent to the computer at the same frequency. The application stores incoming real-time data from USB devices on computer if storing data is enabled.

Storing Real-Time Data on Computer (Wireless Nodes)

The SHUSHAN CVI can be used for computer-based data logging. DurUntash Lab data loggers and sensor adapters take sensor measurements every 5 or 10 s. The measurements are sent to the computer at the same frequency. The application stores incoming real-time data from wireless sensor nodes on computer if storing data is enabled.

Nodes and Aliases

In this section, you can enable or disable notes and aliases. Notes and aliases only work with the wireless monitoring system (local access over WiFi/USB, or connection to a remote server). Once enabled, you can set new aliases for your sensor nodes or sensors. If disabled, the application hides any existing notes or aliases and only displays the commercial device name or ID. 

Settings_General_1.PNG

Device Configuration Utility

 

DurUntash equipment are normally ready to use out-of-the-box and no configurations ​are required. However, there are situations where uploading new settings into a device may be necessary. The SHUSHAN CVI can be used to  upload new settings and calibration coefficients into DurUntash Lab readout devices and sensors. Alternatively, new settings can be also sent to the device using the Arduino IDE. In the latter case, it is necessary to learn the easy-to-use communication protocol and its command lines. Some of these commands are device-specific. Please refer to your device's user manual for more information.

In this section, we will discuss how to use the Device Configuration Utility to upload new settings to your device.

General Device Settings Tab

 

Sampling (Datalogger / Sensor Node)

This section only works with DurUntash Lab data loggers (SHINAK series) and long range wireless sensor nodes (ISHTAR Series). DurUntash Lab data loggers take sensor measurements every 10 s. The measurements are summed, averaged and saved at the end of the logging interval.

 

Datalogging is always enabled on the datalogger and cannot be disabled. By default, the logging interval is 15 min and can be set to any number between 5 min and 24 hours. We strongly recommend a logging interval that is at least 15 min and maximum 1 hour. This way the datalogger is not wasting power by oversampling and at the same time is recording enough data that capture rapid changes in the soil.

 

GeneralSettings_Tab.PNG

Change Logging Interval

Please take the following steps to modify the units 

 

  1. Connect the device to the computer.

  2. Open the SHUSHAN CVI software.

  3. Go to the Tools menu and click on "Settings". The Settings window should appear with a number tabs. 

  4. Click on the "General Device Settings" Tab.

  5. Change the logging interval to a desired value and send it to the datalogger it by clicking the "Upload" button.

  6. In the case of a successful attempt a message will appear on the home window status bar. Please be patient as this might take 5 to 10 s. You can verify the new settings by clicking the Download button.

Set Datalogger's Date and Time

DurUntash Lab dataloggers rely on the DS3231 precise real-time clock (RTC) with a drift of only a few min per year. Some DurUntash Lab 4-channel sensor nodes (e.g. SHINAK 4P-LR or SUMERIT 2P-BLE) rely on the PCF8523 RTC, which has slightly higher drift that might reach a few min per month. If desired the user can update the date and time on these devices. Please make sure that your computer's date and time are accurate (because they are used to set your device's date and time), and take the following steps to set date and time on your datalogger:  

 

  1. Connect the SHINAK 4P-B to the computer.

  2. Open the SHUSHAN CVI software.

  3. Go to the Tools menu and click on "Settings". The Settings window should appear with a number tabs. 

  4. Click on the "General Device Settings" Tab.

  5. Set data and time by clicking the "Set Date & Time" button.

Change Measurement Units

By default, temperature is reported in Metric unit (°C). The unit can be changed to English (°F). Please take the following steps to modify the unit system using the SHUSHAN CVI software:  

 

  1. Make sure the device is connected to the computer and recognized by the software.

  2. Change the unit (to Metric or English) and set it by clicking the "Upload" button.

  3. In the case of a successful attempt, a message will appear on the home window status bar. You can verify the new settings by clicking the Download button.

Change Device Number

The device number can be set to any number between 0 to 255 (0 or 255, by default). Please take the following steps to modify the device number using the SHUSHAN CVI software:  

  1. Open the SHUSHAN CVI software.

  2. Make sure the device is connected to the computer and recognized by the software.

  3. Go to the Tools menu and click on "Device Configuration Utility". A window should appear with a number tabs. 

  4. Click on the "General Device Settings" Tab.

  5. Enter a new device number and set it by clicking the "Set New DN" button.

  6. The new device number should appear in brackets next to the device name in main window status bar. 

Change Device Alias (Bluetooth Devices)

An alias (broadcast name) can be set for DurUntash Bluetooth devices. Please take the following steps to set an alias for your device:  

  1. Open the software.

  2. Make sure the device is connected to the computer and recognized by the software.

  3. Go to the Tools menu and click on "Device Configuration Utility". A window should appear with a number tabs. 

  4. Click on the "General Device Settings" Tab.

  5. Enter a new alias and set it by clicking the "Set" button.

  6. The new device number should appear in brackets next to the device name in main window status bar. 

APAS T1 Tab

 

Installation Type (Default Calibration)

Depending on the media and sensor installation type, DurUntash readout devices apply two different default calibration coefficients to soil moisture readings by the APAS T1. By default, DurUntash readout devices are programmed for vertical top-down pot or rockwool installation, which is simply shortened to "rockwool (Partial Burial)" media type. You can change this to "Soil (Full Burial)" if that is your media type (and method of installation) of interest. If you have berried the sensor in any other media such as coco coir, you also need to select the latter setting. 

Calibration and Temp-Compensation

DurUntash data loggers and sensor adapters can automatically apply calibration coefficients to the APAS T1 soil moisture sensor readings. You can use the SHUSHAN CVI to send new calibration coefficients to your device. The calibration equation can be linear (y = bx + c) or quadratic (y = mx^2 + bx + c), where "m", "b", and "c" are constants/coefficients, "x" is the soil moisture reading before calibration, and "y" is the calibrated reading. The hardware calibration can be enabled or disabled.

Use the "Upload" button to send new calibration coefficients to your device. This might take 5 - 10 s. Click on the "Download" button to retrieve calibration coefficients that are currently in use by the device. ​

DurUntash data loggers and sensor adapters automatically compensate APAS T1 soil moisture sensor readings for temperature fluctutations. Please read this section on APAS T1 temperature compensation for more information.

APAST1_Tab.PNG

Set Wet/Dry Thresholds

The AVAN CT handheld reader has a built-in function that allows for comparing moisture measurements with upper (wet) and lower (dry) thresholds. If soil water content exceeds these thresholds, an unhappy emoji is displayed next to moisture measurements. This function is inactive by default. To activate the function and set the thresholds take the following steps:

  1. Make sure the device is connected to the computer and recognized by the software.

  2. Enter your new wet and dry threshold values and check the Enabled box.

  3. Click the Upload button to send the new thresholds to the AVAN CT. This may take up to 10 s.

  4. In the case of a successful attempt, a message will appear on the home window status bar. You can verify the new settings by clicking the Download button.

HITA E0 Tab

 

Our HITA E0 electrical conductivity sensor provides EC readings in the range of 0 - 20 dS/m, however these readings are only calibrated for the 0 - 10 dS/m range. You can carry out your own sensor calibration and use the SHUSHAN CVI to send the new calibration coefficients to your device. The calibration equation is linear (y = bx + c), where "b" and "c" are constants/coefficients, "x" is the reading before calibration, and "y" is the calibrated reading. The hardware calibration can be enabled or disabled.

Use the "Upload" button to send new calibration coefficients to your device. This might take 5 - 10 s. Click on the "Download" button to retrieve the calibration coefficients that are currently in use by the device. ​

DurUntash data loggers and sensor adapters automatically compensate HITA E0 sensor readings for temperature fluctuations. Please read this section on HITA E0 temperature compensation for more information.

HITAE0_Tab.PNG

Sensor Info Tab

 

Depending on your device, you can retrieve information (sensor-specific calibration data, serial number/ID) from the memory of up to four DurUntash sensors at the same time. Please make sure that you have at least one sensor connected to your device. Use the "Download Settings" button to download sensor information. This process can take up to 10 s for each sensor, so be patient. The corresponding sensor boxes will be updated with sensor name, sensor-specific data and ID one by one.

 

​Note 1: The "Upload Settings" button is password protected, because the sensor-specific calibration is carried out by us at DurUntash Lab. Our maker grade APAS T1 sensors do not go through this stage. Thus the information downloaded might not appear correct.

Note 2: The required code (in C/C++) to read and apply these coefficients will be provided to customers who are interested  in integrating DurUntash sensors.

SensorInfo_April 1, 2021.PNG

Wireless Tab

Network Settings

In this section, you can enter your WiFi SSID (name) and WiFi password. DurUntash gateways use these credentials to connect to your WiFi network. Unless you set an static IP address for the gateway, an IP address is automatically assigned to the gateway after connecting to WiFi. We strongly recommend that you proceed with a dynamic IP address.

 

Assign static IP address

You need to use an available IP address in your local network and the corresponding gateway. If you have tried to assign a fixed IP address to the gateway and it doesn’t work, we recommend assigning an IP address directly in your router settings through the gateway MAC Address.

 

Obtain gateway MAC address

You can find the gateway MAC Address in the Debug window (Console tab) right after the gateway connects to the WiFi network. You can also click on the "Device Information" from the Help menu to obtain your gateway's MAC address.  

 

Router settings

If you login into your router admin page, there should be a page or menu where you can assign an IP address to a network device. Each router has different  configurations. Thus, we cannot provide instructions on how do to it for all the available routers. We recommend Googling “assign IP address to MAC address” followed by your router name. You should find some instructions that show how to assign the IP to a MAC address for your specific router. In summary, if you go to your router configurations menu, you should be able to assign your desired IP address to your gateway MAC address (for example 84:F3:EB:B2:A7:66).

DeviceConfigUtility_Wireless_April 08, 2
 

Radio Settings

In this section, you can change the power output and other radio settings of  DurUntash Lab long range wireless sensor nodes. The nodes are equipped with an RFM9x LoRa radio module (based on SX127x LoRa®), which uses the license-free ISM bands (ITU "Europe" @ 433MHz or ITU "Americas" @ 900MHz) for long range wireless communication. The radio has a power output capability of +5 to +20 dBm (up to 100 mW). The radios come with default settings that enable them to have a range of ~2 km (1.2 mi) line-of-sight with a quarter-wave built-in antenna. These settings are as the following:

  • Power Output: 20 dBm

  • Bandwidth (BW): 125,000

  • Coding Rate (CR): 4/5

  • Spreading Factor (SF): 7

With tweaking the settings, you might be able to achieve higher ranges, even though we do not recommend changing them. Here are some settings examples for achieving different ranges:

  • Example 1: BW = 125 kHz, CR = 4/5, SF = 7 -> Default medium range

  • Example 2: BW = 500 kHz, CR = 4/5, SF = 7 -> Short range

  • Example 3: BW = 31.25 kHz, CR = 4/8, SF = 9 -> Long range