Skip to end of metadata
Go to start of metadata

Our smart farming solution, Farmers Hive, aids farmers in making better decisions by remote monitoring of farm assets. Farmers Hive classifies all farm assets into four: silo, storeroom, field, and vehicles. The Asset Management module allows the end user (farmer) to remotely monitor the performance of assets on their farms. We will discuss in detail the features of this solution.

Table of Contents

1.0 Asset Management Home page

The home page of the asset management module is as shown below. It provides an overview of the all the assets in the farmer's inventory. Here, you can add, monitor, and provide updates on the status of an asset. All assets are grouped by projects. For this tutorial, we named our project UCW-Hive-Smart-farming. Assets in each project are displayed in a tabular form.

2.0 Add Asset

To add an asset to a project:

  1. click the Add Asset button on the top right of the home page
  2. provide the necessary information for the asset in the dialog box as shown in the tractor example below

The major fields in the dialog box above are:
Asset name: unique identification of each asset as provided by the user/farmer
Description: brief explanation of the asset 
Asset Type: there are five major asset types: 

  1. vehicle: tractors, tractor operated implements, and other similar farm machinery
  2. silo
  3. store room: cold storage facilities

Device: the device mapped or connected to this asset

Time Zone: the time zone where the asset is located 

When you click the Add button on the dialog, an asset is added to your project. your screen should look like this:

Add asset

  • If an asset is successfully added to the project, an alert message indicating such is shown on the screen. The same applies if the "Add Asset" operation fails.
  • The project name is shown on the dashboard header using the format "Assets in <project_name>"
  • The asset information displayed on the home page are asset name, assetID, and asset type. The assetID is a system-generated unique identifier of an asset.

We will create other asset types for the purpose of this tutorial

3.0 Asset Actions

The action buttons for each asset class allows the user to edit asset information, maintain contacts for escalating alerts, view dashboards, set thresholds and units of measurements (where applicable) and delete the asset in question.

3.1 Insights

This opens a dashboard showing the data collected by the device mapped to the asset. These data are represented in tabular, graphical, and other pictorial formats.

3.1.1 Vehicle Dashboard

Vehicle dashboard has two gadgets: Jobs and Asset Map:


Each vehicle dashboard is named using the convention "<asset_name> dashboard" Jobs gadget

Assets, such as tractors, that are leased to other farmers can have its work-hours and fuel consumption rate monitored. To do this, the user starts a job by providing the job's name, and description, and selects from a drop down menu the type of operation the asset is to undergo at the lessee's farm. 

  • Start Job - The farmer starts a job by clicking the Start Job button, the amount of billable hours and fuel consumed will be tracked as shown below

  • Pause Job - The farmer can pause the monitoring of a job. This could be due to several reasons, such as downtime due to work breaks for staff, or repairs of asset. When a job is paused, the Job status changes from IN PROGRESS to PAUSED. To restart, the user has to click the Pause Job button a second time.

  • Stop Job - This button terminates a job when the user determines that the asset is no longer engaged in commercial activity. Once a job is stopped, it can not be restarted. The Job status changes to COMPLETE, and the End Time is recorded. The total fuel used (in gallons) and total work hours (shown here as duration in seconds) are available to aid the farmer determine 


  • Only one job can be running at a time. Until a job is stopped, the user can not start another job.
  • Job Names must be unique for an asset
  • Download Jobs - This button downloads all the jobs executed by this asset to a csv file.
  • Cost Distribution - The expense component of the asset are also monitored and displayed as a pie-chart for easy analysis by the farmer. The farmer provides the cost information using the COST button. This serves as a file for recording all expense incurred by the asset. Asset Map

This displays the location of the asset, in real time, on a satellite map. A GPS sensor collates and sends the geolocation data of the asset to our platform. Here, the farmer is fully aware of the asset's location at all times. This gadget will show the location of the asset even if no job is currently running.

3.1.2 Silo dashboard

The silo dashboard consists of two gadgets: Data Measurement and Data Visualisation Data Measurement

This displays the content level in a silo. That is, the amount of silage in a silo. The silo dept, called fill level in meters, is displayed along side the time-stamp when the measurement was taken. Data Visualisation

This gadget allows the user (farmer) to set the upper and lower threshold, if necessary, so as to alert the farmer when he/she is over-stocked or running out of stocked. This is achieved by providing these thresholds in the Min Fill Level and Max Fill Level fields.

3.1.3 Storeroom dashboard

This displays the temperature and humidity measurements of the store or coldroom storage asset. It has two gadgets: Data Measurements

This gadget displays the temperature, humidity and timestamp of when sensor data were captured. It does this in a tabular and as line chart. It also allows you to view data from an extended period by selecting the start and end date using the From and To date menu.

You can download these readings as a csv file. Data Visualisation

Shows the latest, the maximum, and minimum sensor data reading for the day, and tabulates alerts when the temperature or humidity rises or falls below a thresholds explained in Section 3.3. 


The alerts on all dashboards are different from those sent, via SMS, E-mail, to contacts maintained for an asset.

3.2 Edit

It allows the user to make changes to some of the asset parameters. These include Asset name, Description, and Time Zone.

You will have a similar dialog window on your screen to that when you try to add an asset in Section 1.0 above.

Edit Asset

Once you create an asset, you CAN NOT edit the device mapped to it or the asset-type. To change this information, you will need to delete and re-create the asset again!

3.3 Threshold

This button applies to the Silo and Stroreroom asset types. It is used to set the threshold or limits for sensor data emanating from the asset as well as the desired units for the sensor data. For instance, the user can set the temperature reading to either Celsius or Fahrenheit. An example of the Threshold dialog window for silo can be seen below:

3.4 Cost

This button applies only to the Vehicle asset type. 

The cost button opens a dialog box where the farmer can provide the amount of the various cost components of the asset. This information is subsequently displayed as a pie chart, Expense Analysis, in the vehicle dashboard.

3.5 Info

The Vehicle type and Power Take Off (PTO) (if applicable) of the vehicle asset. 


The Power Take Off (PTO) is used to estimate the fuel consumption rate of the tractor. 

3.6 Jobs

This module manages the jobs associated with a given vehicle asset. While a vehicle job is created on the vehicle dashboard, the management (such as to edit, delete and search for job(s)) of these jobs are done here. 


Only jobs that are active (jobs that have their status as either IN-PROGRESS or PAUSED) are shown on the Jobs gadget of the vehicle dashboard.

3.7 Contact

When thresholds are set for an asset, and these limits are exceeded, notifications (SMS, E-mail) are sent to the user(s) maintained using this module. When you click this button, you should see the contact home page as shown below:

3.7.1 Add Contact

To add a contact, click the Add Contact button on the top left of the screen and provide contact information in the dialog window.


  1. If the Alert mode is SMS or SMS and E-mail:
    1. phone number must be provided using format [+] [country code] [subscriber number including area code].
    2. the phone number must have a maximum of fifteen digits.
  2. If the Alert mode is E-mail or SMS and E-mail:
    1. valid e-mail address must be provided.
  3. Shortcut buttons are provided to the asset dashboard or asset management home page

3.7.2 Edit Contact

Edit contact information using Edit action button

3.7.3 Delete Contact

Use the Remove button to achieve this.

3.8 Remove

This button deletes the asset in question from your project

4.0 How to search for an asset

Using the already specified search techniques, the user can search for asset(s) from the list of available assets in a project. This is achieved by using asset name or asset Id as search queries. 

  1. using asset name

  2. using assetId

This search method returns searching a single asset only. The asset name or assetId must be correctly provided.

In special cases, when the user wants to return multiple assets from the search query, or only a part of the asset Id is know, the % symbol is used to achieve this. We will demonstrate this by using field asset as an example 

  1. if the first or leading characters of the device name or asset Id are known, the search query format becomes: <initial character(s)>%. For instance, a query of 3263d93f%  returns field asset

  2. If the ending characters are known to the user, the query format is: %<ending character(s)>

  3. If middle characters are provided, the format becomes: %<middle character(s)>%

  4. Another method if displaying all assets in the project is to provide % only as the query

  • No labels