ConnectedCrops

CCMobile App User Manual

Date: 07 February 2024

Revision: 1.1.0

Copyright Esprida Corporation 2024 | All rights reserved

For optimum product performance, please make sure you read this manual and thoroughly understand the contents before installing, using, or maintaining your ConnectedCrops™ Station and CCMobile App™.
You can also refer to FAQ, and helpful articles. And for technical assistance, please contact us at: support@connectedcrops.ca

Table of Contents

APPLICABILITY

This CCMobile App user Manual applies to version 5.2.0 of the CCMobile App available on the Google Play Store or the Apple App Store.

The version of CCMobile App installed on your phone can be found:

1: SUMMARY

1.1 Summary

The ConnectedCrops system is a powerful tool that provides real-time temperature and/or soil moisture data in agricultural fields on a user’s mobile phone. This real-time data, in addition to email and text message alerts, allows agricultural professionals to make key decisions for irrigation, frost protection, and spraying without having to be in the field, or even in the country. Users can receive monthly reports to see data changes for a station over the month and can receive historical data to allow comparisons and look for trends from field to field, month to month, or year over year.

CCMobile App (“the App”) is a mobile application for ConnectedCrops Agriculture Stations (“Stations”). The App enables ConnectedCrops owners/users to:

CCMobile was built and designed using growers’ requirements and feedback to ensure it satisfied their needs for a reliable tool – a tool that told them the temperature and soil moisture condition of their farm, anytime and anywhere in the world, in real-time. No need for data extraction and no need to be physically close to the Stations.

This CCMobile App User Manual describes the features available in the App, how to troubleshoot conditions that can occur, and how to contact ConnectedCrops support staff for additional support.

1: Getting Started

2.1: Download and install the CCMobile App

If you are reading this manual on your phone, you can click on one of the icons below to navigate directly to where you can download the app:

for Android phones OR

for iPhones.

Or, from your smartphone, go to Google Play or the App Store and:

2.2: Sign Up

To log in to CCMobile to activate station(s) and check their readings, you need to first set up your account. To create a ConnectedCrops account:

  1. launch the Application
  2. click on Sign Up Now
  3. fill in your farm name and the remaining fields. Note: All fields are mandatory
  4. view the Licence Agreement
  5. click on the Sign Up button
Note: CCMobile passwords must conform to the following specifications:

·         a minimum length of 8 characters
·         must contain at least one (1) number
·         must contain at least one (1) lowercase letter
·         must contain at least one (1) upper-case letter
·         must contain at least one (1) special character from the list of
@, $, @,  !, %, *, ?,  and &

Once you press sign up, you should see an ALERT confirmation message on your screen and an email will be sent to you with the confirmation/activation link.

  1. click on the OK button in the successful signup ALERT screen
  1. you will be directed back to the Sign in screen
  2. on the same phone, open the email you received from ConnectedCrops and click on the link to verify your account

NOTE: if you don’t see the email, please check your Spam or Junk folder.

  1. clicking on the link will re-launch the CCMobile application and log you in if you are using the same phone on which you signed up. If not, provide the email address and password credentials you just created and click on the Sign in button
  2. the first time you log in, CCMobile will provide some help pages to give you a quick overview of its features. We recommend you read them
  3. if you encounter an alert message indicating the account is not active, email support@connnectedcrops.ca and provide the email address you are trying to setup and our support team will manually activate your account

3: the CCMobile App Screens

The CCMobile App has 3 main screens from which you can access all of the information and data you need and configure your station(s):

Most of the screens you will encounter will have these 3 buttons available on the bottom. If you don’t see, these 3 buttons on the bottom of the screen, there will be a back arrow that will allow you to return to the previous screen.

This section will describe each of these screens.

3.1: the Home Screen

The Home screen displays the sensor readings for each of your ConnectedCrops stations. It is a one-glance view of the current temperatures and/or soil moisture sensors.

The screen orders the stations alphabetically by Station name. if you have multiple farms, sorting will be performed alphabetically, first by Farm and then by Station name.

Users can view their stations in either a List view or a Map view. The view can be toggled using the List / Map slider.

There are two models of the ConnectedCrops stations:

  • Gen 4 (Generation 4): can accommodate 2 sensors and has a built-in solar panel on the front of the station
  • Model 5: can accommodate 4 sensors, has a separate solar panel unit that is plugged into a port on the bottom of the station, and has a temperature sensor and humidity sensor built into the station enclosure

As a result, the way each of these stations is depicted in the App interface is slightly different.

Generation 4 stations will be depicted according to the image below:

The Model 5 stations are depicted according to the image below:

3.1.1 Last Communication time

The Last Communication field indicates the last time the station transmitted any data to the ConnectedCrops Cloud.

If the reported time is in blue, the last communication was within the last 24 hours.

If the reported time is in red, the last communication was more than 24 hours ago.

3.1.2 Battery Level

Battery level readings can be in green, yellow, red, and gray depending on its status.

3.1.3 Soil Moisture sensor readings

Soil Moisture sensor readings can be in green, yellow, or red depending on their status. The status is measured based on the thresholds you define. If not defined, CCMobile will use default values based on the soil type defined for this sensor.

The image below depicts an example of a soil moisture sensor with defined thresholds for:

Error MessageReasonRequired Action
Please connect the sensorThe App is not getting readings from the soil moisture sensor. Either it’s not properly connected or physically damagedTry to connect the sensor as described in the manual and check for possible physical damage
Sensor setup mismatchThe sensor type chosen during sensor setup doesn’t match the actual sensor type connected to the StationEither physically change the connection as needed or correct the setup under Station Configuration in the CCMobile App
Please install sensor in soilIndicates that the sensor is connected but the readings coming from the sensor indicate it is not inserted in soil.If it is installed in soil, check for air gaps around the installed sensor.
ErrorReading is out of rangeCheck the sensor connection and physical condition. If it doesn’t change, the sensor may be damaged/defective. Contact support

3.1.4 Temperature sensor readings

Temperature sensor readings can be in green, yellow, or red depending on their status. The status is measured based on the thresholds you define. If not defined, CCMobile will use default values based on the soil type defined for this sensor.

The image below depicts an example of a soil moisture sensor with defined thresholds for:

In some scenarios, you may also see error messages in place of a temperature reading:

Please connect the sensorThe App is not getting readings from the temperature. Either it’s not properly connected or physically damagedTry to connect the sensor as described in the manual and check for possible physical damage
Sensor setup mismatchThe sensor type chosen during sensor setup doesn’t match the actual sensor type connected to the StationEither physically change the connection as needed or correct the setup under Station Configuration in the CCMobile App
ErrorReading is out of rangeCheck the sensor connection and physical condition. If it doesn’t change, the sensor may be damaged/defective. Contact support

3.1.5 Email Excel reading report

To download sensor readings from a Station:

  1. click on the Station Menu icon
  2. choose the “Email Excel Report”
  3. fill in the email address(es) to which you want to send the report

3.1.6 Humidity Sensor reading (Model 5 only)

The Humidity Sensor on the Model 5 stations is used to detect high humidity levels within the station enclosure, indicating a potential water penetration issue. Humidity sensor readings can be in green, yellow, or red depending on the status.

As a user, you will not receive notifications if the humidity sensor goes into the yellow or, red; however, ConnectedCrops support staff will be warned of such situations and will reach out to you directly to assess the situation.

The humidity sensor threshold values are not configurable by the end user through the CCMobile App.

3.1.7 Onboard Temperature Sensor reading (Model 5 only)

The Onboard Temperature Sensor on the Model 5 stations is used to determine the temperature directly at the station. While this sensor is internal to the ConnectedCrops enclosure, the low heat output by the ConnectedCrops station components and the sleep state when the station is not transmitting data means this temperature should reflect the actual temperature of the outside conditions without any effects from wind, rain or snow.

The Onboard Temperature Sensor readings can be in green, yellow, or red depending on its status. The status is measured based on the thresholds you define. If not defined, CCMobile will use default values based on the soil type defined for this sensor.

3.2: The Events Screen

The Events screen displays a list of events that have been generated for the station you have access to. An “event” is like a news feed of updates related to your Station’s performance or readings meeting thresholds. If Alert Notifications have been enabled, you will have received an email or SMS message for each of these events.

Pressing the down arrow beside an event will provide more in-depth information including the threshold that triggered the event.

3.3: The Settings screen

The Settings screen allows the user to make changes to the stations or CCMobile App. Pressing the Settings button will bring a screen with the following list of activities:

3.3.1 Configure Station

Selecting Configure Station will present the user with a list of the station they have access. Choose one of the stations from the list by pressing on the name of the station. Once selected the user will be presented with the screen shown.

3.3.1.1 Rename Station

Selecting Rename Station allows a user to change the name of a station. This might be done if the station is being moved to a different location. Selecting OK will save the station’s new name. Selecting the button will return the user to the Station screen.

3.3.1.2 Transmission Frequency

Selecting Transmission Frequency allows a user to change how often a ConnectedCrops station communicates sensor data to the ConnectedCrops Cloud and the CCMobile App.

When setting the Transmission Frequency, consider how quickly the conditions you are monitoring can change. If your station is only monitoring soil moisture, soil moisture changes occur slowly so a less frequent transmission frequency will be acceptable (e.g., every 6 hours). If you are monitoring for temperature changes, these can occur more rapidly and you may want to be alerted to temperature thresholds being reached quickly. This situation might require a more frequent transmission frequency like every 30 minutes.

Be aware that the more frequently data is transmitted, the more battery will be consumed. With bright, sunny days this will not be an issue but, for prolonged periods of cloud or rainy days, the solar panel may not be able to keep the battery charged.

3.3.1.3 Location

Selecting Location allows the ConnectedCrops station to be located on the map view. Selecting Location for the first time will prompt the user to allow the CCMobile app to use the phone’s geolocation service to find the precise location of the station. Allowing this service will simplify the map setup.

If a user declines this service (e.g., Don’t allow) or needs to change the location after initially being set, they can still locate their ConnectedCrops station on the map. To do this, a user can use their finger to move the map until the green station pin is hovering over the correct farm/field location and then select the SAVE button.

NOTE: A user can use the two-closing-fingers movement to zoom out and make the map resolution smaller. This will result in each single-finger map movement making the green station pin move further geographically. Using the two-expanding-fingers movement to zoom in can then be used to precisely locate the green station pin.
NOTE: You can not manually enter the Latitude and Longitude values in their respective fields.

3.3.1.4 Sensors Setup

Selecting Sensors Setup allows the user to define the type of sensor connected to each port on their ConnectedCrops station. If a port will not have a sensor connected to it, set the radio button for this port to None to avoid having the port show up with an error in the CCMobile App.

You can also provide a meaningful name for the sensor so that when alert notifications arrive, you understand exactly which sensor is reporting the reading. This is especially important if there will be more than one temperature or soil moisture sensor on the same station.

Ensure you press the Save changes button made to a port before proceeding to another port or returning to the previous screen.

3.3.1.5 Receive notifications via …

Selecting Receive notifications via… displays the screen where a user can define how they would like to receive alert notifications.

Email and SMS text Message Alert Configuration

By sliding the Email: and/or SMS: sliders to ON, the user can insert the email address and/or mobile phone number where they would like to receive notifications when a sensor exceeds any of their defined thresholds or when other important station events occur.

You can include additional email addresses or mobile phone numbers by selecting the + Add More button to have a new line displayed.

Blackout Period Configuration

A Blackout Period is a defined period when users will not receive email or SMS text messages, for this station, when sensor thresholds have been exceeded. This feature allows a user to prevent the sounds associated with email and SMS text message arrivals from waking a user up during their sleep or to avoid being disturbed during any other defined period.

Only one (1) Blackout Period can be defined for a station, but each station can have a different Blackout Period.

By sliding the Blackout Period: slider to ON, the Blackout Period popup screen will allow a user to define a start and end time for the blackout period by moving the corresponding endpoints.

Selecting the OK button will save the blackout period.

A Blackout Period can be modified by selecting the button underneath the Blackout Period: heading, adjusting the times, and then selecting the OK button.

To disable a Blackout Period, slide the Blackout Period: slider to the OFF position.

Monthly Reports Configuration

On this screen, a user can also define if, and how often, they would like to receive a monthly report for this station. The monthly report provides a chart showing the sensor readings for the past month in PDF format. It also includes the raw sensor data in Excel® format so users familiar with Excel can perform their own spreadsheet data calculations.

To enable receiving monthly reports, select the Monthly Report: slider to ON and indicate, using the checkboxes, which months you would like to receive the reports for.

For all changes made on the Receive notifications via… screen, ensure you press the Save button at the bottom of the Receive notifications via… screen before returning to the previous screen.

3.3.1.6 Thresholds

Selecting Thresholds allows a user to define Alert Notification thresholds for each sensor connected to a station.

Soil Moisture

Soil Moisture thresholds can be set for:

  • Field Capacity
  • approaching Field Capacity (Soil Moisture (VWC%) is above:)
  • approaching Wilting Point (Soil Moisture (VWC%) is below:)
  • Wilting Point

These 4 points represent the moisture thresholds at which an alert will be sent via email and/or SMS text message to those people defined in the Receive notifications via….

Soil Moisture characteristics are dependent on the type of soil that is being monitored and the type of crop being grown. When the user selects a soil type the dropdown list, default values for the Field Capacity, Wilting Point, and 2 Approaching thresholds will be populated.

Field Capacity is the amount of soil moisture (or water content) held in the soil after excess water has drained away via gravity and the rate of downward movement has decreased. It is all of the water in the soil it can hold against the pull of gravity. In the field, this usually takes place 2–3 days after a rain or irrigation event. It can also be measured in a laboratory. It is highly dependent on the type of soil, where clay soils can retain a high amount of moisture for a longer period of time while sandy soils retain much less moisture because of the large pores between sand particles. Any rain or irrigation that occurs beyond Field Capacity is lost as the soil is incapable of retaining it.

The soil type chosen on the Thresholds screen will automatically populate a Field Capacity VWC% value. This value comes from laboratory and field research for the different types of soils and ConnectedCrops recommends keeping this default value unless you have performed your own measurements that indicate a different value should be used for your soil.

Wilting Point (or Permanent Wilting Point – PWP) is the point at which there is so little moisture in the soil, and the soil is holding on to this moisture with such force, that the plant’s roots can no longer extract the moisture from the soil. At this point, the plant becomes starved of moisture and nutrients.

While the Wilting Point VWC% value is defined from laboratory experimentation for each soil type based on a common procedure, is clear that there are many other factors that impact, not least of which is the type of crop and the capabilities of its root system to extract moisture. As such, the user may want to adjust the Wilting Point VWC% value if there is more accurate information available from research done for your particular crop and soil type.

Approaching Field Capacity (Soil Moisture (VWC%) is above:) is not a scientific value but rather a recommended warning threshold. If you were irrigating when this alert is received, it means you should consider stopping your irrigation in this field.

Approaching Wilting Point (Soil Moisture (VWC%) is below:) is also not a scientific value but rather a recommended warning threshold. If you receive this alert, it means you should consider starting irrigation in this field unless you are aware of a significant rain event in the very near future.

Temperature

Temperature thresholds can be set for:

3.3.1.7 Alert Notifications and Weather Forecasts

When sensor thresholds are set in the previous section (3.3.1.6) AND Email alerts and/or SMS text messages have been enabled and configured (section 3.3.1.5 Receive notifications via…), the user will receive email and/or SMS text message alerts when a sensor threshold has been exceeded.

Each message will contain:

In addition, weather forecast data is provided for this station’s specific geographic location. Email alerts contain 3 days of weather forecast information: Today, Tomorrow, and the day after. SMS Text alerts only contain weather forecast data for today because of text length limitations.

This weather information can be helpful when making decisions to address the root cause of the alert received. For example,

  1. Will temperatures continue to fall and do I need to take steps to mitigate against frost damage?
  2. If my soil moisture is low, am I expecting rain in the next 24 to 72 hours?
  3. Will high winds and high temperatures cause soil moisture to decrease more quickly and should I irrigate sooner than scheduled?
IMPORTANT: To receive weather forecast information, valid latitude and longitude values must be entered for the station

3.3.1.8 Add inversion alert

The Add inversion alert screen allows a user to define the temperature sensors and temperature differential that would represent a temperature inversion; when the temperature closer to the ground is colder than the temperature higher from the ground. Understanding when temperature inversions are occurring is an important factor when deciding when to spray crops.

NOTE: The Add inversion alert selection will only be available if your station has at least 2 temperature sensors connected to it.

On this screen, the user will define which temperature sensor is at the higher height, which temperature sensor is at the lower height, and what temperature differential will trigger the alert notification. A temperature differential of +2 °C (as shown in the image below) means the temperature on the highest sensor is 2 degrees warmer than the temperature on the lower sensor.

3.3.2 Add New Station

Selecting Add New Station will walk the user through the steps required to an additional ConnectedCrops station to their farm through the CCMobile App. These steps are identical to the steps followed when the first station was registered.

The label at the back of the ConnectedCrops station provides the following information.

  • HW:                        Hardware version
  • FW:                         Initial Firmware version
  • BL:                          Bootloader version
  • Date:                      Manufacturing date
  • Serial:                    Serial number
  • ICCID:                    SIM Card Identification #

The wizard in the CCMobile App will walk you through the four steps for activating a Station:

  1. Registration: Registering the station to ConnectedCrops Cloud
  2. Sensor Setup: Setting up the sensors for each station; defining their types, names, and the ports to which they’re physically connected on the Station.
  3. Activation: Powering up the station, or resetting it, and checking if CCMobile is receiving readings from the stations
  4. Configuration: Setting up the alerts, station’s properties, and operation mode

3.3.2.1 Registration

This step registers the station to ConnectedCrops Cloud using a station name of your choosing and its unique serial number:

  • if you do not use the QR code or have issues with your camera, you may enter the details of the station manually. To do this, click on the arrow next to Type in the details manually and fill in the fields with the information displayed in the QR Code label
  • Click the Register button at the bottom of the screen

NOTE: If you DENY access to your phone’s camera, you must manually type in the registration information from the QR Code label on the back of the station.

3.3.2.2 Sensor Setup

This step of the registration process will define what types of sensors are connected to the station and to which ports.

3.3.2.3 Activation

This step of the registration process will activate the station to start the data collection process.

Please check the troubleshooting section if you are facing issues while activating your station.

3.3.3 Accounts

Selecting Accounts allows a user to perform 3 tasks:

  1. change their password
  2. change the name of their farm
  3. delete their ConnectedCrops account

3.3.3.1  Change Password

Selecting Change Password will redirect the user to a ConnectedCrops Cloud webpage that allows the user to change their password. This page requires the user to remember their old password. If you’ve forgotten your old password, email support@connectedcrops.ca and the team will be able to change your password for you.

3.3.3.2  Change Farm Name

Selecting Change Farm Name allows the user to change the name of their farm.

3.3.3.2  Account Deletion

Selecting Account Deletion allows the user to permanently delete their ConnectedCrops account. This will delete all stations, sensor data, and user account information from the ConnectedCrops server.

3.3.4 Help

Selecting Help displays a series of screenshots that briefly explain how to use the CCMobile App.

By scrolling past the last screen on the Help page, a user can:

3.3.5 About

Selecting About displays the version information for the installed CCMobile App.

3.3.6 Logout

Selecting Logout will display a prompt to confirm that you wish to log out of the CCMobile App. By selecting Yes, the user will be logged out. The next time the CCMobile App is launched, the user will be required to log into the app.

4: Troubleshooting

Depending on what you are trying to do, there are several ways to troubleshoot a Station. In all cases, check the status indicators on the Station. ConnectedCrops Stations are provided with 4 bi-colour LED lights on the front cover for status indication and troubleshooting. They will be either red, blue, or not illuminated.

To troubleshoot, you need to first understand what the indicators are.

4.1 LED Lights Guide

While the Station is in its ‘Wake’ state, the lights illuminate and flash to indicate the status of their respective features. While the Station is in its ‘Sleep’ state the lights are not illuminated to conserve battery power.

Each light indicates the status of a specific feature of the Station: Battery, Cellular connection/communication, Board components, and Sensors. The Station has 2 states:

On station initialization (e.g., when the fuse is inserted or after the Reset button is pressed), the Station will do a test to validate all of its components. The LEDs will then flash on and off 5 times to represent the success or failure of the initialization process. If all flashes illuminate blue, the initialization was successful. If all flashes illuminate red the initialization process failed. The results of the validation test are shown right before the unit sleeps and this takes anywhere from 30 seconds to 3 ½ minutes to appear.

The following illustrations show the meaning of solid or flashing light sequences for each LED during the ‘Wake’ phase of the Station.

4.1.1: Battery LED

4.1.2: Connection LED

4.1.3: LED1: Internal Hardware

4.1.4: LED2: Internal Hardware

4.2 Troubleshooting Scenarios

4.2.1: Station lights are not illuminating during startup

If the answers to all of the above are “Yes”, then the station may not be charged. Please leave it in the sun for 3-8 hours (or more if cloudy) and check again.

4.2.2: Not getting readings on the CCMobile App

4.2.3: Sensors are connected but show as though they are not

In the CCMobile App, you may encounter the message “Please connect the sensor” for one (or more) of your sensors. This error is shown if the ConnectedCrops station is not receiving data from a sensor port on the back of the station (Ports 1 – 4) that is configured to have a sensor connected to it. If you think you should not be getting this error, please check the following:

4.2.4: Soil Sensor “Please install sensor in soil” reading

If you are seeing the message “Please install sensor in soil” for a soil moisture sensor in the CCMobile App, it means the readings received from the soil moisture sensor are consistent with the sensor not being in soil.

4.2.5: Sensor “Error” reading

If you are seeing the message “Error” for a sensor in the CCMobile App (in place of an expected reading), it means the value being returned by the sensor is outside of its normal operating range. It could mean the sensor is damaged. To verify:

If the readings don’t change, please contact support

4.2.6: “Sensor setup mismatch” reading

If you are seeing the message “Sensor setup mismatch” for a sensor in the CCMobile App (in place of an expected reading), it means the sensor is misallocated on the app under Sensors Setup (e.g., a temperature sensor is plugged into a port configured for a soil moisture sensor). To verify this:

If the readings don’t change, please contact support

4.2.7: Station registration error: Station already exists

If you receive a message during the process of registering a new station that the station already exists:

If you can’t identify the station, please contact support and supply the Serial Number that is printed on the label on the back of the station (it will start with FFFF….)

4.2.8: Signed up but never got a confirmation email

If you are signing up in the CCMobile App for the first time and you did not receive a confirmation email:

If you still don’t receive a confirmation email or you get an error message on CCMobile indicating that the email is already used, please contact support

4.2.9: Can’t log in to the CCMobile App

If you are having trouble logging into the CCMobile App, check the following:

4.2.10: Station shows offline on CCMobile App although Cellular Connection lights are illuminating

If the station indicates it has not communicated for a long period of time in the CCMobile App but the station Cellular Connection LED lights show it is attempting to communicate at the scheduled interval, please refer to the 3.1.2 Connection LED table in section 3.1 LED Lights Guide to help diagnose the issue:

4.2.11: Station doesn’t seem to be charging

If a ConnectedCrops station battery is not charging properly, there are a few indicators you will receive in advance to warn you of the situation:

To ensure the battery can be properly charged:

4.2.12: Not Receiving email or SMS text messages when sensor thresholds are exceeded

When a sensor reading exceeds one of the threshold values, you will receive a push notification on your phone for the CCMobile App but you can also receive email and SMS text messages for this event. If you expect to be receiving email and/or SMS text messages but are not:

  1. check that the Email: slider is enabled and that your email address is correctly entered (section 3.3.1.5  Receive notifications via…)
  2. check that the SMS: slider is enabled and that your mobile phone number is correctly entered (section 3.3.1.5  Receive notifications via…)
  3. check that the expected email and/or SMS text message was not triggered during a defined Blackout Period (section 3.3.1.5  Receive notifications via…)

5: Contact Us

At any time, feel free to contact us at info@connectedcrops.ca or for support, please email us at support@connectedcrops.ca 

Exit mobile version