Here are some step-by-step examples of using MaxMon remote control:

Each example follows the same basic flow - first you GET a copy of the remote configuration, then you SET an updated portion of that configuration. Each example can be applied to other settings, for example 'adding an alert' can easily be adapted to adding a new task.

 

Enabling text (SMS) reports

In this example text reports are not enabled, and we want to remotely enable them.

  • Go to the MaxMon remote control application web page and GET the current configuration.
  • Wait until you receive an email with the configuration attached (sent to the Inbox of the email recipient you configured in the remote MaxMon app). Open the attachment in a text editor. If you don't receive an email within a few minutes see No response to remote control?
  • In the remote control web application set Command to "Set remote configuration".
  • From the current configuration copy the lines:
    "setting.sms_reports_enabled":"false",
    "setting.sms_recipients":""
    into the Data area of the remote control web application. Leave the formatting as it is (just don't copy the opening and closing square brackets from the configuration).
  • Edit the Data area to:
    "setting.sms_reports_enabled":"true",
    "setting.sms_recipients":"0123 456 7890"
    where "0123 456 7890" is the phone number to which you wish to send text (SMS) reports.
  • Enter the Email address of the MaxMon phone and the remote control Passphrase (see Updating the remote configuration) and press "Submit".
  • Under the web form you should see a green "Sent command email" message.
  • You should shortly receive an email with the updated configuration, or an error report if the configuration was incorrectly formatted. See MaxMon configuration (1.3) for formatting instructions.
  • You can check the MaxMon app's updated configuration under "Settings > General".

 

Changing sensor settings

In this example a MaxMon phone deep inside a building is not always getting accurate Location(m) readings (distance from a 'home' location), so we want to increase the location alert threshold and the display range of the "Location(m)" graphs shown in email reports.

  • Go to the MaxMon remote control application web page and GET the current configuration (you don't need to do this if you already have a current configuration).
  • Wait until you receive an email with the configuration attached (sent to the Inbox of the email recipient you configured in the remote MaxMon app). Open the attachment in a text editor. If you don't receive an email within a few minutes see No response to remote control?
  • In the remote control web application set Command to "Set remote configuration".
  • Scan through the configuration until you find the sensor with label "Location(m)". For example:
    "sensor.6.label":"Location(m)",
    This tells you that sensor 6 is the "Location(m)" sensor (your sensor index may differ).
  • In the current configuration find the lines corresponding to the "Location(m)" settings you want to change. See MaxMon configuration (1.3) for detailed information on all settings.
    "sensor.6.alert_max":"50.0",
    "sensor.6.display_max":"100.0",
    Copy these settings into the Data area of the remote control web application. Leave the formatting as it is (just don't copy the opening and closing square brackets from the configuration).
  • Edit the Data area to:
    "sensor.6.alert_max":"100.0",
    "sensor.6.display_max":"500.0",
    These changes decrease the sensitivity of the "Location(m)" sensor, by setting it to alert if the MaxMon phone moves more than 100m from its home location and scaling "Location(m)" charts to display values up to 500m. Note that to receive alert reports you will need to create an alert.
  • Enter the Email address of the MaxMon phone and the remote control Passphrase (see Updating the remote configuration) and press "Submit".
  • Under the web form you should see a green "Sent command email" message.
  • You should shortly receive an email with the updated configuration, or an error report if the configuration was incorrectly formatted.
  • You can check the MaxMon app's updated configuration under "Settings > General".

 

Disabling an alert

In this example we want to disable a motion alert (for example while a property is occupied).

  • See changing sensor settings for the general GET/SET approach. The only difference is how to find the right alert setting to modify. Say we know we have defined two motion alerts, but only want to disable the motion alert associated with a "Report (day) action. Look through the configuration (see Getting the remote configuration) for an action with label "Report (day)":
    "action.1.label.read_only":"Report (day)",
    So now we know "Report (day)" is action 1 (may differ in your configuration).
  • Now look for motion alert settings (look at the alert labels) that refer to action 1:
    "alert.9.label.read_only":"Motion(secs) > 1.0",
    "alert.9.enabled":"true",
    "alert.9.action":"1",
    So alert 9 is the alert we are looking for (may differ in your configuration).
  • In the remote control web application set Command to "Set remote configuration".
  • Edit the Data area to disable the alert (set enabled false):
    "alert.9.enabled":"false"
  • Submit the web application form as in the earlier examples.

 

Adding an alert

In this example we want to add a new motion alert and associate it with a "Report (day)" action.

  • See earlier examples for the general GET/SET approach.
  • Look through the current configuration for a read-only list of available alert conditions:
    "alert.conditions.read_only":"Acceleration > 5.0,Battery(%) < 50.0,Float(NC) is [OPEN],Humidity(%) > 75.0,Location(m) > 50.0,Memory(MB) < 20.0,Motion(secs) > 1.0,Net is [NONE],Net(Errs) > 0.0,Power is [OFF],Temperature(C) < 5.0,Temperature(C) > 30.0",
    In this case the motion alert condition is "Motion(secs) > 1.0".
  • In the remote control web application set Command to "Set remote configuration".
  • Enter the following settings into the Data area:
    "alert.add":"99",
    "alert.99.condition":"Motion(secs) > 1.0", "alert.99.enabled":"true", "alert.99.action":"1", "alert.99.interval":"3600", "alert.99.priority":"1",
    The "alert.add" setting tells MaxMon to add a new alert (alert index 99 - choose any index that does not clash with an existing alert) for the desired motion alert condition (from the list of available alert conditions). See MaxMon configuration (1.3) for the meaning of the other alert settings. You can copy and paste an existing alert from the configuration to serve as a template.
  • Submit the web application form as in the earlier examples.

 

Deleting an alert

In this example we want to delete an existing motion alert.

  • See earlier examples for the general GET/SET approach.
  • See Disabling an alert for how to find the index of a specific alert. For this example say the motion alert index is 3 (i.e. the alert with settings "alert.3.*").
  • In the remote control web application set Command to "Set remote configuration".
  • Edit the Data area to delete alert 3:
    "alert.3.remove":"true"
  • Submit the web application form as in the earlier examples.

 

Performing an action (or sequence)

In this example we want to perform a remote action (or sequence), for example sending a report or switching a light on and off.

  • See earlier examples for the general GET/SET approach.
  • Look through the remote configuration for the index of the action or sequence you wish to perform, e.g. "action.1.label.read_only":"Report (day)" or "sequence.1003.label":"light10s". Note that actions and sequences never share the same index. In this case we are going to perform the 1003 sequence.
  • In the remote control web application set Command to "Set remote configuration".
  • Entering the following setting into the Data area:
    "action.do":"1003"
    This will request the remote MaxMon app to perform sequence 1003, which switches a light on and off.
  • Submit the web application form as in the earlier examples.