SHUSHAN Mobile App User Manual

Introduction 

Thank you for choosing the SHUSHAN Mobile app from DurUntash Lab. The SHUSHAN Mobile is an application for Android specifically designed  to work with DurUntash Bluetooth-enabled devices. The SHUSHAN Mobile can be used in combination with our Bluetooth dataloggers, sensor nodes, handheld readers,  and sensors. The app is provided free of charge with all compatible DurUntash Lab products. To understand how the SHUSHAN Mobile 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

 

SYSTEM

SHUSHAN Mobile App

The SHUSHAN Mobile app is an Android-based (v5.0 and up) mobile application, which can be used for easy device/sensor configuration, mobile-based data logging, and taking sensor readings. The SHUSHAN app can be used to send custom calibration coefficients to DurUntash Bluetooth readout devices. The SHUSHAN app is free and you can download its latest version from Play Store.

Specifications

General

  • Current Version: 1.3 (2021)

  • Operating System: Android (5.0 and up)

  • Requirements: Bluetooth Low Energy (BLE) (available on Android 4.3 and up)

INSTALLATION

 

To install the SHUSHAN Mobile app, please go to Play Store and look up the app name. You can also find the app here. The app is installed in a few easy steps. 

Permissions

 

The app needs a number of permissions to be granted by the user before it can become fully functional. The main required permissions are listed below:

Location

  • approximate location (network-based)

  • precise location (GPS and network-based)

  • access extra location provider commands

 

Photos/Media/Files

  • read the contents of your USB storage

  • modify or delete the contents of your USB storage

 

Storage

  • read the contents of your USB storage

  • modify or delete the contents of your USB storage

Other

  • mock location sources for testing

  • view network connections

  • pair with Bluetooth devices

  • access Bluetooth settings

  • full network access

Screenshot_20210124-144858_Package insta
Screenshot_20210124-144834_Package insta

The process of granting permission vary by phone. Please contact us directly if you experienced any issues during or after installation. 

OPERATION

 

The SHUSHAN Mobile app is divided into three tabs: 1) Home tab (middle), 2) Settings tab (right), and 3) Information tab (left). These tabs and their functions are explained below. 

Home Tab

The Home tab allows the user to connect to Bluetooth devices and see real-time data from DurUntash sensors that are connected.

Connect to a Bluetooth Device

To connect to a Bluetooth device (e.g. SUMERIT 2P-BLE), click the Scan button (next to the "Connect" button on the left). The app will automatically scan the area for available Bluetooth devices and list them. Pick a device name and click the "Connect" button. If connection is successful, device information (node name, signal strength and battery level) and sensor data will populate the Home tab boxes. 

Screenshot_20201123-163211.jpg
Screenshot_20210310-170125.jpg
Screenshot_20210310-170103.jpg
Screenshot_20210310-170139.jpg

​Sensor Type and Readings

If a sensor is connected, sensor name and its picture along with real-time measurements will be displayed in corresponding boxes. A LED right next to sensor name indicates the status of the sensor or sensor readings. As soon as a sensor is connected to a port/channel, the LED turns green or red (depending on sensor reading and threshold settings) and sensor readings are displayed in the boxes. If no sensor is present on a channel, "Not connected!" is shown and the light turns grey. A red light indicates a soil moisture reading that is below the specified dry threshold (explained later). 

If your Bluetooth device has more than one sensor channel, a tab will appear that will allow you to switch between sensors. 

Screenshot_20201103-212741.jpg
Screenshot_20201104-203726.jpg
Screenshot_20201105-150837.jpg
Screenshot_20201103-212801.jpg
Screenshot_20210310-170208.jpg

Save Sensor Readings

There are three buttons at the bottom of the Home tab. You may click the "Save" button to save real-time sensor readings on your phone in a "csv" file. The save button will not work if the device is not connected. If there is more than one sensor connected, readings from both sensors will be saved. GPS coordinates and date & time are also recorded. To view previously recorded data click the "View History" button, and to delete the csv file, click the "Delete" button. The app uses the node name (alias) to create a csv file.

 

Please note that this file will not be accessible by the buttons should you change node name or if no sensor is connected. You can find available csv files on your smartphone internal storage under "\DurUntashLab\SHUHSAN". 

Irrigation Control and Notifications

In addition to having two sensor ports, the SUMERIT 2P-BLE has one irrigation control port. You can see irrigation notifications for this port at the top of the sensor tabs. Depending on the irrigation mode (explained in the "Settings" section), 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, and the color of the button will be blue. 

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

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

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

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 app and restart it, you will still see the correct status and run time. 

Screenshot_20210310-175224.jpg
Screenshot_20210310-175307.jpg
Screenshot_20210310-175155.jpg
Screenshot_20210310-170208.jpg

Information Tab

  

Different sections of this tab will provide information about the SHUSHAN Mobile app ("About the App"), connected Bluetooth device ("Device Information"), and connected sensor ("Sensor Information"). 

About the App

The current version of the app can be seen here. Clinking on the DurUntash logo will take you to the DurUntash Lab website.

Device Information

This section displays the Bluetooth node name that is connected, firmware version, firmware compilation date and serial number. If device information is not displayed or part of it is missing (usually due to communication error), click on "Device Information" title/button. Wait at least 10 sec to receive missing information. 

Sensor Information

Sensor name and serial number are displayed here. If there is more than one sensor connected, they will all be listed. If sensor information is not displayed or part of it is missing (usually due to communication error), click on "Sensor Information" title/button. Wait at least 10 sec to receive missing  information. 

Screenshot_20201123-162138.jpg
Screenshot_20201123-162145.jpg
Screenshot_20210310-170518.jpg
 

Settings Tab

App Settings

Connect by Name

To connect to a Bluetooth sensor node for the first time, you need to first scan for available nodes and then connect to a node on the list. By checking the "Connect by Node Name" checkbox, the app will save the name of the node and next time you can connect to the same node by directly clicking the "Connect" button. This feature is useful if you have only one Bluetooth node. If you use the app to connect to multiple Bluetooth nodes, leave this box unchecked.  

Mobile-based Datalogging

You can use the app to turn your smartphone into a datalogger and log data at specified time intervals. Sensor readings will be stored on your phone in a 'csv' file along with GPS coordinates and timestamp. Logging interval can be any number between 1 and 1440 min. We recommend a logging interval that is at least 15 min.

 

Note 1: You will not be able to save sensor readings manually if automatic datalogging is enabled.

 

Note 2: Mobile-based datalogging is not guaranteed on all Android devices. Some Android devices have strict permission rules that won't allow creating or modifying files on the phone drive. 

Wet/Dry Thresholds

This feature only works with our APAS T1 soil moisture sensor. You can set the lower and uppers thresholds between 0 and 100. By checking the "Enable Alert for Dry/Wet Soil" checkbox, the app will automatically monitor soil moisture levels and turns the LED light "red" if soil moisture readings exceed the specified thresholds. 

Note: App settings are only saved on your Android device. 

Screenshot_20201123-162001.jpg

Node Settings: General

Temperature Unit

By default, temperature is reported in Metric unit (°C). The unit can be changed to English (°F) by clicking the checkbox "Temperature Unit (°F)". Please make sure to hit the "Upload" button to upload new setting (i.e. temp unit) into your Bluetooth sensor node.  

Node Alias

Multiple Bluetooth sensor nodes can be permanently installed in different spots in a field, orchard, greenhouse or grow operation. Using the SHUSHAN mobile app, you can give each node a unique alphanumeric broadcast name (Node Alias) like "PlantPot101" or "MyGarden". The alias must be at least three characters. Please make sure to hit the "Upload" button to upload new alias into your Bluetooth sensor node.  

 

You can then use the mobile app to collect data from each of these different nodes (connect to one node at a time) and save on your smartphone under their unique name. 

Screenshot_20210310-170318.jpg

Node Settings: Datalogging

Internal RTC Time

The SUMERIT irrigation node relies on a real-time clock (RTC) to maintain correct date and time even if the device is turned off. Whenever you connect to your device, the RTC date and time are displayed. You can update this time by clicking directly on the displayed date & time. Please make sure that your phone's date and time are correct, because they are used to set the date and time of your device's RTC.  

Logging Interval

In this section, you can set logging intervals for your SUMERIT node. Timestamped sensor readings and irrigation status will be stored on your device in 'csv' format. The logging interval can be any number between 5 and 1440 min. For power management reasons, we recommend logging intervals that are at least 15 min.

Please make sure to hit the "Upload" button to upload new logging interval into your Bluetooth-enabled node.  

Note: changing the logging interval of your SUMERIT node will not affect the logging interval for mobile-based datalogging that is stored on your phone. 

Screenshot_20210310-170332.jpg

Node Settings: Data Retrieval

Date Range (From/To), Retrieve Button

Use the date pickers to choose a date range. This range will be used to download corresponding logged data on your SUMERIT node when you hit the "Retrieve" button. Data retrieval using your smartphone might take a long time specially if there is a large number of records. We recommend that you only use feature for downloading small data sizes. To download data faster, please use the SHSHAN CVI-Wireless application for Windows. Downloading data from your phone will not affect the data stored on your device. 

Memory Button 

To learn the status of your SUMERIT node including the used space and number of records, hit the "Memory" button. 

Delete Button

To delete the content of your SUMERIT node's SD card (memory), hit the "Delete" button. Please note that all data will be lost forever and cannot be recovered. 

Screenshot_20210310-170343.jpg

Node Settings: Irrigation Scheduling

Automatic

In this section, you can set your irrigation node (e.g. SUMERIT 2P-BLE)  for automatic irrigation scheduling. When the switch is off, you can turn your irrigation valve/pump on/off using the  button in the home tab (Manual Mode). The default mode is manual irrigation.      

Dry Threshold

The automatic irrigation scheduling mode requires a "Dry Threshold" to be set. Changing the dry threshold here will not affect the dry threshold in the App Settings. 

 

Start (Time of Day)

Here, you can set start time (time of day) for the automatic irrigation scheduling mode. Irrigation events will be triggered only at time of day specified here.  

Run Time

In the automatic and manual irrigation scheduling modes, the irrigation will run (runtime) for the number of minutes specified here. The runtime can be any number between 1 and 1440 min. 

Moisture Sensor Feedback

The SUMERIT irrigation node has two sensor ports. If both ports are reading soil moisture sensors, you can choose to check both boxes. In this case, the SUMERIT nod will take the average of moisture readings from both channels and use it for irrigation scheduling. If you check only one box (select only one channel), only readings from moisture sensor connected to that channel will be the basis for irrigation scheduling. If no channel is selected, the SUMERIT node will turn into a time-based irrigation scheduler that will turn (if auto-irrigation enabled) your valve (or pump) on/off at the specified time of day. 

Screenshot_20210310-170436.jpg

Node Settings: APAS T1 Substrate Moisture Sensor 

 

Sensor Burial Type

Depending on the media type, DurUntash readout devices apply two different default calibration coefficients to APAS T1 soil moisture readings. By default, our readout devices are programmed for "rockwool (partial insertion)" media type. You can change this to "soil (full burial)" if that is your media type of interest.

Soil-Specific Calibration

Our Bluetooth sensor nodes and readers can automatically apply soil-specific calibration coefficients to the APAS T1 soil moisture sensor readings. You can use the SHUSHAN Mobile app to send new calibration coefficients to your device. The calibration equation can be linear (y = bx + c; m = 0) 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 calibration can be enabled or disabled.

Use the "Upload" button to send new settings (calibration coefficients and soil type) 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 readout devices automatically compensate APAS T1 soil moisture sensor readings for temperature fluctuations. To apply your own temperature-compensation model to real-time sensor readings, you may use the SHUSHAN CVI Windows applicationPlease read this section on APAS T1 temperature compensation for more information.

Screenshot_20210310-170451.jpg

Node Settings: HITA E0 Electrical Conductivity Sensor

 

Calibration  

Our HITA E0 electrical conductivity sensor can provide EC readings in the range of 0 - 20 dS/m, however these readings are only calibrated for the 0 - 5 (typical) or 0 - 10 dS/m range. You can carry out your own sensor calibration and use the app to send new calibration coefficients to your Bluetooth 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 Bluetooth devices automatically compensate HITA E0 sensor readings for temperature fluctuations. To apply your own temperature-compensation model to real-time sensor readings, you may use the SHUSHAN CVI Windows applicationPlease read this section on HITA E0 temperature compensation for more information.

Screenshot_20210310-170505.jpg

SERVICE

 

Bug Report

Even though we have done our best to make sure the SHUSHAN Mobile app is free of errors, you may still find bugs in the application. In that case, please feel free to contact us and report the bug(s). Please provide as much information as you can. You can always attach a snapshot to help us with identifying the source of problem.

CUSTOMER SUPPORT

 

We are available for questions, problems, or feedback Monday through Friday, 8:00 to 17:00 (Los Angeles Time).

 

Note: If you purchased your instrument through a distributor, please contact them directly for assistance.

Contact Information

You can reach us via our contact page here.

 

Please make sure to include the following information in your message:

  • Name

  • Address

  • Email address

  • Instrument serial number (SN)

  • Description of the problem

Note: Instrument SN is normally attached to the enclosure or cable. If the SN is missing for any reason, use the SHUSHAN CVI software and follow the instructions in the user manual to retrieve the SN.

Terms and Conditions

By using Duruntash Lab instruments and documentation, you agree to abide by the Duruntash Lab LLC Terms and Conditions. For details, please refer to our web address at:

duruntashlab.com/terms-and-conditions