When you browse to the MaxMon remote control web application you will be prompted to login to our web site. Enter the username and password you created when you bought a MaxMon product, or create an account.

Login

Tick the 'Remember me' check box on the login page if you don't want to be prompted for these credentials in future.

Note that this web site login is different from the email address and passphrase used by the remote control app to identify your remote MaxMon app (see below).

The remote control web application

Once you've successfully logged in to the MaxMon web site this is what the remote control web application looks like. It supports three types of command on a remote MaxMon app:

If you're having problems getting remote control to work see:

Performing remote actions

We'll begin by looking at how to perform the most common remote actions. For example, if we want the remote MaxMon app to send us a report covering the previous week:

  • Enter the the email address of the MaxMon app (see Getting started with MaxMon).
  • Ener the command passphrase you configured in the General settings of the MaxMon app.
  • Select 'Report (week)' from the 'Command' pulldown.
  • Press the 'Submit' button (obscured by the pulldown in the image below).

You should see a message like 'Sent command email'.

Note that selecting 'Report (week)' added a command string like "action.do":"n" to the 'Data' input field on the form. This is the command sent to the remote MaxMon app to tell it to send a weekly report. Within a minute or so (depending on the quality of the intervening network) you should receive an email and/or text (SMS) report from the remote MaxMon app. See timeouts and retries if you don't receive a response.

IMPORTANT: please note that ALL responses to remote control commands are emailed to the email recipient(s) you configured in the remote MaxMon app and do NOT appear in the web application. So check your email after sending remote control commands!

Simple remote configuration

The web application can configure and control almost every aspect of the remote MaxMon app, provided you know the right command strings (like "action.do":"n" in the previous example). To find the right command strings you first need to get the current configuration of the remote MaxMon app. As before, enter the email address of the MaxMon app, its command passphrase, select 'Get configuration' and press 'Submit'.

Within a minute or so you should receive an email response (sent to the email recipient(s) you configured in the MaxMon app - NOT to the web application) which looks something like the image below. See timeouts and retries if you don't receive a response.

remote-get-config-2

'Get configuration' response emails have two parts: a set of formatted configuration tables (MaxMon app versions 1.3.12+ only) and an attached and less easily readable configuration file (config.txt) in JSON format.

Depending on your app version the formatted configuration tables list:

  • General app settings, including whether your app is 'armed' or 'disarmed'.
  • Your actuators and their current settings (e.g. whether ON or OFF, or enabled or disabled).
  • Your alert settings (with a link to enable or disable specific alerts).
  • Actions and sequences you might want to perform remotely.

Links within these tables enable you to easily update remote settings without having to understand the format of config.txt. For example, to switch off the remote power socket actuator called 'Mercury socket' in the response above click its OFF link. Or to 'disarm' the app before entering your property click the 'Disarm' link.

remote-set-config-3This should open the MaxMon remote control web application in a browser, with the form pre-populated with the correct command string (e.g. "actuator.15.state":"OFF"). Fill out the email and passphrase fields and press 'Submit'. You should then soon receive another email showing the updated configuration.

Advanced remote configuration

If you want to view or change remote settings that are not available in the formatted configuration tables you need to open the attached config.txt file in a text editor.

remote-get-config-3At first glance it's intimidating, but it's actually reasonably easy to match each line to settings in your remote MaxMon app. Things to note:

  • Settings with a "read_only" suffix cannot be updated via remote control.
  • Each setting includes its unique name, e.g. all settings beginning "sensor.1" pertain to the same sensor (in this case the "Power" sensor, as seen from the "sensor.1.label" setting).
  • All settings are strings enclosed in quotes. Empty strings ("") can be meaningful, e.g. "setting.sms_recipients":"" means no text (SMS) report recipients are defined.
  • See MaxMon configuration (1.3) for explanations of every remote control setting.

Copy and paste settings you want to change from the config.txt file into the "Data" field of the remote control web application. In this example we are going to update the text (SMS) report settings. To enable the "Data" field (so you can paste into it) select the "Set remote configuration" command from the pulldown menu. Use the same MaxMon app email address and passphrase as before.

All strings are case sensitive! Remove any enclosing brackets and ensure each line but the last has a trailing comma.

 
   
Edit the settings in the "Data" field and click "Submit". Within a minute or so you should receive an email response (sent to the email recipient(s) you configured in the remote MaxMon app) with the updated configuration attached. See timeouts and retries if you don't receive a response.