See bottom of page for older versions of the MaxMon app.

The configuration for version 1.3 of the MaxMon app is split into 8 sections, each of which closely correspond to the setting screens of the app:

Each line in the configuration is composed of a name and a value (both within quotes). Each name includes an index that identifies a specific sensor, actuator, action, etc. See the documentation on the get configuration command for how to obtain your current configuration. Some setting names have a read-only suffix (see below) and cannot be updated by the set configuration command.

Default values are shown in bold, examples in grey. All strings are case sensitive!

General

For more detailed information - see Help: General settings.

Name Value
"setting.site" Label for your monitored location
"setting.site":"MyBoat"
"setting.service_state" Run state of the MaxMon app
(see Q: how do I arm/disarm the MaxMon app?)
Values: "armed" or "monitor"
"setting.service_state":"monitor"
"setting.log_interval" Interval (seconds) between routine sensor logs
"setting.log_interval":"600"
"setting.latlng" Latitude & longitude of 'home' location
"setting.latlng":"51.1788,-1.8262"
"setting.email_reports_enabled" Enable/disable email reports/alerts
Values: "true" or "false"
"setting.email_reports_enabled":"true"
"setting.email_recipients" Email report/alert recipients
"setting.email_recipients":"my.email@gmail.com"
"setting.sms_reports_enabled" Enable/disable text (SMS) reports/alerts
Values: "true" or "false"
"setting.sms_reports_enabled":"true"
"setting.sms_recipients" Text (SMS) report/alert recipients
"setting.sms_recipients":"07901234567"
"setting.arm_delay" Delay (seconds) before manually 'arming' app
Values: "0"-"300", default is "30"
"setting.arm_delay":"15"
"setting.arm_report" Enable/disable 'arming' reports
Values: "true" or "false"
"setting.arm_report":"false"
"setting.camera_enabled" Enable/disable phone camera
Values: "true" or "false"
"setting.camera_enabled":"true"
"setting.picture_rotation" Angle to rotate still pictures
Values: "0", "90", "180" or "270" (degrees clockwise)
"setting.picture_rotation":"90"
"setting.picture_quality" Quality(%) of pictures (higher quality images consume more bandwidth)
Values: "0"-"100", default is "75"
"setting.picture_quality":"50"
"setting.wifi_manage" Actively manage phone WiFi
Values: "true" or "false"
"setting.wifi_manage":"true"
"setting.bluetooth_manage" Actively manage phone bluetooth
Values: "true" or "false"
"setting.bluetooth_manage":"true"
"setting.diagnostic_level" Amount of diagnostics generated by app
Values: "Off", "Fatal", "Error", "Warn", "Info", "Debug" or "Trace" (least to most)
"setting.diagnostic_level":"Info"
"setting.stealth_enabled" Enable/disable stealth mode
Values: "true" or "false"
"setting.stealth_enabled":"false"
"setting.notification.read_only" (Read only) app monitoring status
"setting.notification.read_only":"MaxMon is monitoring - Connected to WiFi (MyWiFiNet)"

Devices

For more detailed information - see Help: Devices.

Name Value
"device.n.name.read_only" Name of n'th device
"device.1.name":"Android (samsung GT-S5360)"
"device.2.name":"Quatropus (USB)"
"device.n.version_app.read_only" (Read-only) version of the MaxMon app
"device.1.version_app.read_only":"1.3.0"
"device.n.version_android.read_only" (Read-only) version of Android
"device.1.version_android.read_only":"2.3.6"
"device.n.summary.read_only" (Read only) info about Quatropus accessory
"device.2.summary.read_only":"Quatropus v01c, Interface: USB, ID: 473036363731150f150d, Status: Responding"
"device.n.bootloader.read_only" (Read only) version of Quatropus bootloader
"device.2.bootloader.read_only":"1.2.0"
"device.n.firmware.read_only" (Read only) version of Quatropus firmware
"device.2.firmware.read_only":"1.1.5"
"device.n.updates.read_only" (Read only) status of Quatropus firmware updates
"device.2.updates.read_only":"Check online for updates"

Sensors

For more detailed information - see Help: Sensors.

Name Value
"sensor.n.label" Label for n'th sensor
"sensor.5.label":"Bilge contact (NC)"
"sensor.n.lab" Short label for n'th sensor
"sensor.5.lab":"Blg(NC)"
"sensor.n.enabled.states.read_only" Available enable/disable states for n'th sensor
Values: "Disabled", "Enabled" or "Enabled (charging)"
"sensor.3.enabled.states.read_only":"Disabled,Enabled"
"sensor.4.enabled.states.read_only":"Disabled,Enabled,Enabled (charging)"
"sensor.n.enabled" Enable/disable the n'th sensor
Values: from "sensor.n.enabled.states.read_only"
"sensor.5.enabled":"Enabled (charging)"
"sensor.n.discovered.read_only" (Read-only) whether the n'th sensor is connected
Values: "true" or "false"
"sensor.5.discovered.read_only":"true"
"sensor.n.states.read_only" (Read-only) valid states of n'th sensor
Multi-state sensors only
"sensor.1.states.read_only":"OFF,ON"
"sensor.10.states.read_only":"NONE,MOBILE,WIFI"
"sensor.n.alert_states"

Alert states for n'th sensor
Multi-state sensors only
Value must be from "sensor.n.states.read_only"
Special value: "" = disable alerting for this sensor
"sensor.1.alert_states":"OFF"
"sensor.10.alert_states":"NONE,MOBILE"

"sensor.n.alert_min" Alert-if-below threshold of n'th sensor
Numeric sensors only
Special value: "" = disable alert-if-below threshold
"sensor.2.alert_min":"4.0" (alert if below 4°C)
"sensor.n.alert_max" Alert-if-above threshold of n'th sensor
Numeric sensors only
Special value: "" = disable alert-if-above threshold
"sensor.2.alert_max":"" (disable alert-if-above threshold)
"sensor.n.display_min" Minimum display value of n'th sensor
Numeric sensors only
Special value: "" = auto-scale (use minimum recorded value)
"sensor.2.display_min":"-10.0" (to display from -10°C)
"sensor.n.display_max"

Maximum display value of n'th sensor
Numeric sensors only
Special value: "" = auto-scale (use maximum recorded value)
"sensor.2.display_max":"50.0" (to display up to 50°C)

"sensor.n.range_min.read_only" (Read-only) minimum measureable value of n'th sensor
Numeric sensors only
"sensor.2.range_min.read_only":"-40.0"
(for a sensor that reads -40°C to 80°C)
"sensor.n.range_max.read_only" (Read-only) maximum measureable value of n'th sensor
Numeric sensors only
"sensor.2.range_max.read_only":"80.0"
(for a sensor that reads -40°C to 80°C)
"sensor.n.default" If set to "true", resets n'th sensor to default settings
"sensor.5.default":"true"

Actuators

For more detailed information - see Help: Actuators.

Name Value
"actuator.n.label" Label for n'th actuator
"actuator.2.label":"Hall light"
"actuator.n.lab" Short label for n'th actuator
"actuator.2.lab":"Hall-lt"
"actuator.n.enabled.states.read_only" (Read-only) valid enable/disable states for n'th actuator
Values: "Disabled" or "Enabled"
"actuator.2.states.read_only":"Disabled,Enabled"
"actuator.n.enabled" Enable/disable the n'th actuator
Values: from "actuator.n.enabled.states.read_only"
"actuator.2.enabled":"Enabled"
"actuator.n.discovered.read_only" (Read-only) whether the n'th actuator is connected
Values: "true" or "false"
"actuator.2.discovered.read_only":"true"
"actuator.n.states.read_only" (Read-only) valid states of n'th actuator
"actuator.2.states.read_only":"OFF,ON"
"actuator.n.state"
(was "actuator.n.value" in older app versions)
State of n'th actuator
Use this to switch actuators ON and OFF
Value must be from "actuator.n.states.read_only"
"actuator.2.state":"ON"
"actuator.n.default" If set to "true", resets n'th actuator to default settings
"actuator.2.default":"true"

Actions

For more detailed information - see Help: Actions.

Note: actions and sequences never share the same index, i.e. if there is a "action.1.*" there will never be a "sequence.1.*".

Name Value
"action.n.label.read_only" (Read-only) label for n'th action
"action.1.label.read_only":"Report (day)"
"action.n.desc.read_only" (Read-only) description for n'th action
"action.1.desc.read_only":"Create sensor report for past 24hr and send to configured recipients"
"action.do" Perform a specified action or sequence
Use this to send reports, switch actuators, etc.
"action.do":"2" (performs action.2.* or sequence.2.*)

Sequences

For more detailed information - see Help: Sequences.

Note: actions and sequences never share the same index, i.e. if there is a "action.1.*" there will never be a "sequence.1.*".

Name Value
"sequence.n.label" Label for n'th sequence
"sequence.1001.label":"Light 30s"
"sequence.n.desc" Description for n'th sequence
"sequence.1001.desc":"Switch on hall light for 30 seconds"
"sequence.n.seq" Ordered list of actions in n'th sequence
Values: comma-delimited list of action indexes n (from action.n.*)
"sequence.1005.seq":"9,6,8"
"sequence.add"

Add one or more sequences (invent new unique sequence indexes and configure the sequences by referring to those new sequence inidexes)
"sequence.add":"1042,1043",
"sequence.1042.label":"Light 30s",
"sequence.1042.seq":"9,6,8",
   :

"sequence.n.remove" If set to "true", remove n'th sequence
"sequence.1005.remove":"true" (remove sequence.1005.*)

Alerts

For more detailed information - see Help: Alerts.

Name Value
"alert.conditions.read_only" (Read-only) list of possible sensor 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,Power is [OFF],Temperature(C) < 5.0,Temperature(C) > 30.0"
"alert.n.label.read_only" (Read-only) label for n'th alert
"alert.5.label.read_only":"Location(m) > 50.0"
"alert.n.enabled" Enable/disable the n'th alert
Values: "true" or "false"
"alert.5.enabled":"false"
"alert.n.action" Action or sequence to perform for n'th alert
Values: action or sequence index n (from action.n.* or sequence.n.*). Actions and sequences are guaranteed to have unique indexes.
"alert.5.action":"1"
"alert.n.interval" Interval (seconds) between same n'th alert
"alert.5.interval":"3600"
"alert.n.priority" Priority of n'th alert
Value: Integer (lowest execute first)
"alert.5.priority":"1"
"alert.add"

Add one or more alerts (invent new unique alert indexes and configure the alerts by referring to those new alert indexes - alert.n.condition and alert.n.action are required)
"alert.add":"42,43",
"alert.42.condition":"Motion(secs) > 1.0",
"alert.42.action":"2",
"alert.43.condition":"Battery(%) < 50.0",
"alert.43.action":"1",

   :

"alert.n.condition" New alert condition (only to be used in conjunction with "alert.add")
Value: one condition from "alert.conditions.read_only"
"alert.42.condition":"Motion(secs) > 1.0"
"alert.n.remove" If set to "true", remove n'th alert
"alert.3.remove":"true" (remove alert.3.*)

Tasks

For more detailed information - see Help: Tasks.

Name Value
"task.n.hour" Hour of n'th scheduled task
Min: "0" Max: "23"
"task.2.hour":"19"
"task.n.minutes" Minutes of n'th scheduled task
Min: "0" Max: "59"
"task.2.minutes":"30"
"task.n.daysofweek" Days of week to repeat n'th scheduled task
"task.2.daysofweek":"MTW----" (Mon, Tue and Wed)
"task.2.daysofweek":"MTWTFSS" (every day)
"task.n.action" Action or sequence to execute for n'th task
Values: action or sequence index n (from action.n.* or sequence.n.*). Actions and sequences are guaranteed to have unique indexes.
"task.2.action":"1"
"task.n.enabled" Enable/disable n'th scheduled task
Values: "true" or "false"
"task.2.enabled":"true"
"task.add"

Add one or more scheduled tasks
(Invent new unique task indexes and optionally configure the tasks by referring to those new task indexes)
"task.add":"42,43",
"task.42.daysofweek":"MTW----",
   :

"task.n.remove" If set to "true", remove n'th scheduled task
"task.2.remove":"true" (remove task.2.*)

Older app versions