The Linear MQTT Dashboard mobile application is useful for everyday use of the GreenSense projects, allowing devices to be both monitored and controlled from a mobile device such as a phone.
Before you can use the Linear MQTT Dashboard you will need to follow the networking guide to set up networked GreenSense devices.
Search Play Store for "linear mqtt" and select the "Linear MQTT Dashboard" app:
Tap the INSTALL button:
Tap the ACCEPT button:
Tap the OPEN button to open Linear MQTT Dashboard:
The Linear MQTT Dashboard default configuration should look something something like this:
The GreenSense device user interface can be configured by either:
The following guide explains how to import the Linear MQTT Dashboard configuration as it's the simplest approach.
Transfer the following file to the mobile device:
Local Computer
If the hardware is connected to a computer with a display, keyboard, and mouse, then the config.linear file can be copied to the device via a USB cable using the file manager, just like any other file.
Alternatively a service such as Google Drive can be used to transfer the file.
Headless/Remote Computer
If the hardware is connection to a computer that is headless (ie. has no display, keyboard, and mouse) or a computer that is remotely connected via the network then the Termux mobile application can be used.
Search for "termux" in the app store and select the "Termux" application:
Tap the ACCEPT button:
Tap the OPEN button:
Termux will open and should look something like this:
Use the following command in termux to transfer the config file to the mobile device:
Syntax:
scp [user]@[host]:~/workspace/GreenSense/Index/mobile/linearmqtt/output/config.linear config.linear
Example:
scp j@garden:~/workspace/GreenSense/Index/mobile/linearmqtt/output/config.linear config.linear
Enter the password of the garden computer and tap ENTER:
The config.linear file will be transferred and the output should look something like this:
Open the config.linear file via termux to automatically configure the user interface in Linear MQTT Dashboard:
termux-open config.linear
When the Linear MQTT Dashboard loads with the following prompt, tap YES:
Note: This prompt may take some time to appear. If it doesn't appear try the following...
After tapping YES the user interface configuration settings should be imported and the Linear MQTT Dashboard should look something like this (depending on the combination devices that have been added):
The MQTT indicator is red because it can't connect to the MQTT broker.
To fix this:
Update the following settings (if necessary) then tap SAVE:
The MQTT indicator should now be green indicating that it's connected to the server.
If a triangular play button is visible on the Linear MQTT Dashboard like the screenshot below then tap it to switch from edit mode to user mode:
The Linear MQTT Dashboard should now look similar to the screenshots below:
Note: The user interface will vary based on
Summary Tab
Monitor Tab
Irrigator Tab
You can now view and control your GreenSense devices from your phone.
Note: There is a generally a delay in data transmission. Allow for this when viewing data or changing the configuration.
Follow the usage guides for more information on how to configure and control your GreenSense devices from the Linear MQTT Dashboard.