SMS ControlMate User manual
SMS ControlMate
Versatile SMS monitoring and control
USER GUIDE
Contents
INTRODUCTION................................................................................................................................. 5
INPUTS .......................................................................................................................................... 5
OUTPUT RELAYS ............................................................................................................................ 7
OTHER FEATURES .......................................................................................................................... 7
BASIC CONCEPTS ........................................................................................................................... 8
COMMAND SUMMARY.................................................................................................................... 11
POWER SAVING........................................................................................................................... 15
SETTING TIMERS.......................................................................................................................... 17
SMS NOTIFICATIONS.................................................................................................................... 18
SPECIAL CASE MESSAGES:............................................................................................................ 19
OBSERVATIONS ........................................................................................................................... 19
CONSIDERATIONS........................................................................................................................ 21
INSTALLATION................................................................................................................................. 22
MOUNTING DIMENSIONS............................................................................................................ 22
INPUTS & OUTPUTS..................................................................................................................... 23
RECOMMENDED ENCLOSURE ...................................................................................................... 25
POWER & CONTROL CONNECTIONS............................................................................................. 26
USING CONTROLMATE .................................................................................................................... 27
POWER-ON.................................................................................................................................. 27
GETTING STARTED........................................................................................................................... 28
SIMPLE CONTROL ........................................................................................................................ 29
WHO HAS ACCESS TO MY CONTROLLER? ..................................................................................... 31
ONDELay and OFFDELay .............................................................................................................. 32
onCMD and offCMD .................................................................................................................... 33
ONSTATE and SAVE...................................................................................................................... 34
COMMAND ALIASES (SUBSTITUTION) .......................................................................................... 35
SLAVE MODE ............................................................................................................................... 36
GLOSSARY OF TERMS....................................................................................................................... 37
LOGICAL ‘OR’ FUNCTION.......................................................................................................... 38
LOGICAL ‘AND’ FUNCTION ....................................................................................................... 38
WORKED EXAMPLES........................................................................................................................ 39
EXAMPLE 1 –SIMPLE DAYLIGHT SENSOR ..................................................................................... 40
EXAMPLE 2 –FARM GATE -or- COOL-ROOM DOOR WARNING ..................................................... 41
EXAMPLE 3 –START & STOP AN ENGINE...................................................................................... 41
OTHER EXAMPLES........................................................................................................................ 43
Delayed ‘on’ event, with warning output ................................................................................. 43
Notify me when the engine has been started 200 times........................................................... 43
DISPLAY / OUTPUT OPTIONS............................................................................................................ 44
LED In/Out Status Display ............................................................................................................ 45
Initialisation / LED Indicators ................................................................................................... 46
Message Send Failure .............................................................................................................. 46
Optional LCD / Button Module..................................................................................................... 47
During power-on / initialisation ............................................................................................... 47
During modem registration...................................................................................................... 47
During normal operation ......................................................................................................... 48
CONSOLE CONNECTIONS................................................................................................................. 49
PUTTY TERMINAL CONFIGURATION............................................................................................. 49
TERATERM CONFIGURATION....................................................................................................... 50
MODEMS......................................................................................................................................... 51
CONFIGURATION RECORD............................................................................................................... 53
CONNECTIVITY WORKSHEET............................................................................................................ 55
SMS ControlMate –Versatile SMS monitoring and control
Sunday, 24 February 2019
INTRODUCTION
The unit provides a flexible control and monitoring solution using SMS text messaging to work with
remotely located devices or equipment. There are many SMS control products in the market…
ControlMate offers a number of PLC-like capabilities not found in any of those other products.
Ensure you are using the correct commands for your ControlMate software.
(Currently v190224 –this document)
Due to continuous improvement, this online manual always reflects the latest features
and typo corrections included in ControlMate. A controller chip with the latest updated
software is available for exchange.
IMPORTANT: On 10 August 2017, some less important commands were removed –which are
available under other existing commands –e.g. SHOwing in and out states.
SECURE PASSCODE –from v190122, we have REMOVED the CLI #0 PIN feature, replaced with a
customer defined (single word) PASSCODE. If defined, typing the correct passcode unlocks the
controller for operations for a period after the most recent command –then re-locks automatically.
If you forget the passcode –there is a ‘back door’ – only accessible from the serial console –which
allows you to unlock the controller –to re-set or remove the passcode.
Applications for ControlMate may be as simple as sensing a gate open or closed, or starting and
stopping a generator. Sensing a tank is full, remotely starting a pump, turning on the security lights -
and everything between.
ControlMate is normally supplied as a naked card, for integration to your own control or monitoring
system. The unit implements four contact-closure inputs, and four change-over (SPDT) relays to
operate external devices with the unit.
INPUTS
•2-wire / ‘zero-volt’ inputs (contact-closure).
Configurable for N/O or N/C sources
1
<20mS detection timing.
•User defined ‘text’ messages attached to
the ON and OFF states when sending SMS
notifications.
e.g. ON = Gate Open OFF = Gate Closed
•Separate ON and OFF hold delay before the new
input state is raised. e.g. wait for a door to be held
for 10 secs before triggering… or Ignore a
chattering gate / sensor…
•Separately assignable ‘internal’ control of other
functions based on input changes.
•The LCD panel* includes four assignable buttons for local operations.
*The standard LED panel is provided, an optional LCD panel at extra cost.
1
N/C (Normally Closed) inputs offer the added benefit of detecting a broken wire in the switching circuit.
OUTPUT RELAYS
•Uncommitted-isolated SPDT changeover contacts.
•Output state may be latching on/off, flashing
2
, or a pulsed duration to operate the controlled
device, or simply ‘tell’ another product to do its own thing.
•Text strings attached to the ON and OFF states when sending SMS notifications.
e.g. when ON = ‘Pump Start’, or when OFF = ‘Pump Stop’
•Independent timer events may be assigned to any command on any days of the week.
•Authorised free ‘voice’ dial-in callers are able to initiate a command (once per call).
Any function may be configured as a response to the free call.
•Relays after power-failure may be restored to the previous state at power-on, to all-off, or a
pre-configured state.
OTHER FEATURES
•Standalone, or remote operation. After configuration, many operational functions can be
performed without user intervention.
•As a 3G solution, ControlMate may be placed and administered from almost anywhere in the
world with phone coverage. A suitably provisioned SIM card with no PIN lock must be installed.
•Once configured, the text notifications are clear and easy to understand, with information about
what happened, why, and who or what initiated it.
•Setup may be performed with a personal computer and a simple terminal program
3
, or using
SMS commands for remote management and status inquiries.
•Complete operating configuration may be saved to a text file, and restored or copied to other
controllers in the future
4
•Abbreviated text commands to set up and operate. Commands are not case-sensitive.
•An access list allows only pre-authorised numbers to send commands or dial-in to the unit.
•Access list members default to being ‘administrators’ – with full access, or may be demoted to
‘users’ with restrictions. Specific users may be denied control of individual relay outputs.
•If a unit has been ‘accidentally’ cleared of all settings, a ‘backdoor’code allows you to remotely
add yourself to the Access List to rebuild the configuration.
•An internal ‘watchdog’ ensures the controller won’t become locked in unattended locations, and
resets the unit in event of an unexpected lock up.
•User accessible indicators show the current logical status of each input and output, as well as
general ControlMate activity.
The attention LED indicates the modem / SIM account is initialising or has failed to connect.
•Any controller may be designated as a slave to any other controller
–which will reflect the output states across both devices from the ‘initiator’ to the slave.
WHEN PROGRAMMING OR OTHERWISE CHANGING CONTROLMATE SETUP,
TAKE PRECAUTIONS THAT DEVICES CONNECTED TO THE OUTPUT RELAYS DO
NOT ACTIVATE UNEXPECTEDLY.
2
If ‘flash’ mode is enabled, the user must ensure the controlled device will support repeated on/off cycles.
3
Terminal programs include: PuTTY, TeraTerm and others with an added USB-TTL-serial adapter. Console
access is faster and more cost-effective than sending multiple SMS messages during setup –unless the device
is far away from the user.
4
To restore or copy configuration data, the target must be running the same memory ‘version’ as the original
ControlMate.
BASIC CONCEPTS
To assist in using ControlMate, several concepts will help understand its functions.
COMMANDS Allow users to control or configure the ControlMate functionality.
IN The ‘contact-closure’ interface that receives trigger events from external devices.
Inputs may be ‘inverted’ to accommodate ‘normally-closed’ circuits.
Inputs may have a user-defined delay when changing state on and/or off.
Input changes may perform any internal command to execute other tasks.
OUT The changeover relay outputs that control the user’s attached devices. Outputs may be
driven as a steady ON-or-OFF state, flashing, or pulsed for a specific duration when an ‘on’
event is triggered.
Outputs may be set to ‘initialise’ at a known pre-set state, or at the last known state.
CLI The list of caller-id numbers that identifies who can control, and who is notified by SMS text
message. Callers or commands from unlisted numbers are ignored.
CLI entries include a phone number (CLINUM) and ‘friendly’ name (CLINAME) of callers,
along with a DIAL-IN command for ‘free’ voice calls.
*ADMIN / USER / SLAVE membership offer additional protection and features
Admin users receive error notifications, however if an Admin CLI number is entered wrongly,
the message will retry and fail - and if the other operational error persists across restarts –it
may become impossible to recover, and a UTIL-RESET may be necessary to clear all the
configuration data. This is a by-product of the SMS retry and auto-recovery capabilities.
ACL Access Control List –permits or denies individual users from controlling specific outputs.
SMS Notifications may be individually routed for selected members of the CLI list –when specific
inputs or outputs change state.
e.g. George hears about the security sensors, Tom gets notified about pump events.
TIMER There are multiple independent timers, which may be set to automatically perform any
controller function on specified days at the same times.
COMMAND SUMMARY
These control and inquiry messages may be typed at the ‘setup’ terminal, or sent via SMS text
message. Requests will respond to the sender with confirmation of the action, or a brief help
message to help identify the valid commands. If a command is not recognised, any following ‘lines’
will be ignored t avoid setting invalid states.
Virtually all configuration values interact with other settings to achieve complex results.
Always check your plan before, and re-check the settings after you make them,
then test they operate the way you intended!
All action commands are notified back to the sender, even if the sender is not in the SMS list.
Only the bold letters are required for ControlMate to recognise the command.
Commands are not case-sensitive.
CONTROL OUTPUTS
ALL USERS with ACL permission
OUT
0123 | all
On/Off/tog
If any CLI are set as slaves,
the output state will be
mirrored to them using
SET SLAVE / SET
OUTSMS.
Simply turn output/relay on,
off or toggle its state.
ACL will be checked before
relay state is changed.
SHOW OPERATING VALUES
ALL USERS
SHOw
CLI5
[from [to]]
Takes approx. 20
secs to return
*all* records
Display the list of authorised
users in the nominated range
SHOw
INputs
[from [to]]
Takes approx. 10
secs to return
*all* records
Show a status of inputs in the
nominated range
SHOw
OUTputs
[from [to]]
Takes approx. 10
secs to return
*all* records
Show a status of outputs in
the nominated range
SHOw
TIMers
[from [to]]
Takes approx. 20
secs to return
*all* records
Show the timer settings in the
nominated range
SHOw
ALIASes
[from [to]]
Takes approx. 20
secs to return
*all* records
Display the command
replacement strings
SHOw
SMS
(Start from
cli)
Show the list of IN & OUT
SMS notification assignments.
SHO
ZSMS
(Start from
cli)
Display the zero counter SMS
assignments for each CL
SHOw
BUTtons
Display any assigned LCD
button commands. (option)
SHOw
BOARd
Display hardware build date
and original customer name6
SHOw
SYS
Displays controller information
SHOw
SIM / MODem
Displays modem & SIM info
SHOw
COUNTers
Displays historical counter
data since last sw update
SET COMMANDS
FOR ADMIN USERS ONLY
SET CLI VARIABLES
SET
CLINUMber
cli
CallerID
Set authorised CallerID
number in position ‘cli’
04123345678
SET
CLINAMe
cli
name
Set a friendly-name for
position ‘cli’ e.g. John Smith
SET
ADMIN
cli
Allow all commands
5
SHO CLI may take several seconds to return a listing, as it generates a response based on all possible users.
6
Counters, build date and customer are stored in persistent memory –not initialised by SET CLEAR
SET
USER7
cli
No SET commands
SET
SLAVe8
Cli
Mirrors local output
states to a remote
‘slave’ unit.
Sends raw OUT messages
to another ControlMate
SET
ACL
cli / all
{output list}
Permit CLI member to control
specific outputs {0123}.
SET
INSMS
cli / all
{input list}
Select which CLI users will
receive notifications of INPUT
state changes.
SET
OUTSMS
cli / all
{output list}
Select which CLI users will
receive notifications of
OUTPUT state changes.
SET
INZsms9
cli / all
{input list}
Select which CLI users will
receive ‘on’ notifications when
INPUT counter #input
reaches ZERO.
SET
OUTZsms10
cli / all
{output list}
Select which CLI users will
receive ‘on’ notifications when
OUTPUT counter #output
reaches ZERO.
SET
DIALIN
cli
command
Command to execute if user
dials in to the controller
SET INPUT VARIABLES
SET
ONDELay
input
duration11
Set the hold-off delay after an
input changes state –to
becoming ‘ON’
SET
OFFDELay
input
duration
Set the hold-off delay after an
input changes state –to
becoming ‘OFF’
SET
INONtext
input
String
0-chars set dflt
1-char will not
be sent
Set the text notification to be
associated with each input
ON state
SET
INOFFtext
Input
String
0-chars set dflt
1-char will not
be sent
Set the text notification to be
associated with each input
OFF state
SET
ONCMD
input
command
Assign a command when IN n
turns ON –also see INDO
SET
OFFCMD
input
command
Assign a command when IN n
turns OFF –also see INDO
SET
INO
input
Requires input
to change state
to resync status
Set input to N/O operation
(normal…)12
SET
INC
input
Requires input
to change state
to resync status
Set input to N/C operation
(inverted…)
7
If a CLI user number is a landline or other ‘non SMS’ capable device (typically for dial-in applications) –it is
desirable to set it as a USER type –so admin messages are not sent out unnecessarily. USERs can’t SET
configuration values –so it doesn’t make any operational difference.
8
Setting SLAVE in the sending ‘master’ unit will forward OUT on/off messages >to> the slave.
Setting SLAVE in the receiving unit will stop the slave from replying to the master commands. (Recommended)
9
INZsms will post a notification every time that input goes ‘on’ with an INCOunt value of zero.
To avoid repeating messages, turn off the INZsms setting, or set INCOunt to a new non-zero value.
10
OUTZsms will post a notification every time that output goes ‘on’ with an OUTCOunt value of zero.
To avoid repeating messages, turn off the OUTZsms setting, or set OUTCOunt to a new non-zero value.
11
Delays and pulse durations may be entered as ‘seconds’ by default, or may be specified - using
ms/sec/min/hour to assist in calculating longer durations. (not case sensitive). The actual delay period is
approximate, and may be significantly affected by other activities –e.g. SMS message processing
12
Changing the input operating mode may trigger notifications or control events if the input is mapped.
It is recommended that INO/INC changes are made while the equipment is ‘safe’.
SET
INCOunter
input
Value
(-32000 to
+32000)
Set value nfor input counter.
(Increments for each ‘on’
event)
Negative values will stop at
zero
SET
OUTCOunter
output
Value
(-32000 to
+32000)
Set value nfor output counter.
(Increments for each ‘on’
event)
Negative values will stop at
zero
SET OUTPUT VARIABLES
SET
OUTONtext
output
text
Set the text notification to be
associated with each output
ON state
SET
OUTOFtext
output
text
Set the text notification to be
associated with each output
OFF state
SET
PULse
output
duration13
Set the pulse ‘on’ duration for
each relay.
SET
FLAsh
output
duration
Set the flashing rate for each
relay.
SET SYSTEM VARIABLES
SET
SITE
NAME
name
A unique identifier for this
ControlMate Displayed in
SHO SYS and SMS
messages
SET
CALLback
on|off
Default is ON
Enable or disable the dial-in
callback feature.
SET
ALIAS
replaceString
(one word)
withString
(up to 24 chars)
Define replacement strings.
e.g. pump translates to out 1
SET
TIMErtimer hh:mm {daysNoSpaces} {command}
Set a recurring timer event
SET
SAVemode
LASTknown
on|off
Determines whether the
ControlMate will restart with
the last-known output states,
or use pre-set states for each
relay.
SET
ONSTate
output
on|off
When SAVemode is turned
OFF, we can individually set
the next power-on state for
each output relay
SET
LCD
0|1|2|aut|+
LCD status/in/out/auto/incrmt
SET
BUTton
button
{command}
blank = remove
When the optional LCD panel
is installed, a single command
may be assigned to each
button.
CLEAR SETTINGS
This parameter
ALWAYS
lower-case!
SET
CLEAR
all
Clears all configuration
settings
SET
CLEAR
cli
Clears the caller/user access
list
SET
CLEAR
but
Clear the optional LCD-button
command assignments
SET
CLEAR
sms
Clears the SMS notification
list
SET
CLEAR
in
Clear all INPUT settings
SET
CLEAR
out
Clear all OUTPUT settings
SET
CLEAR
alias
index
Clear one ALIAS string for a
specific index. Use SHOw
ALIAS
SET
CLEAR
aliases
Clear ALL alias substitution
strings
SET
CLEAR
tim
Clear all TIMER settings
SET
MODEM
on|off
To save power under
constrained supply conditions,
you may turn the modem
OFF14
MISC COMMANDS
SKIPDEL
Skip over any onDelay or
offDelay straight to the state.
REPOrt
XREPOrt
{cliNumber}
default = reply
to sender
XREPO gives an
extended report
Send health report to
CLI #n…
Some commands have similar spelling. Ensure that you’ve chosen and used the correct command!
PASSPHRASE COMMANDS
SET
KEY or
PASS
Up to 15
chars in a
single word.
leave BLANK
to remove
the key
ONLY from the
serial console
SET the security pass code
SHOw
KEY or
PASS
DISPLAY the security pass code
UNLock
KEY
Passcode
(As set above)
Unlocks access for a period of time
–then re-locks automatically
SK3Leton
one-time*
backdoor key
ONLY from the
serial console
Unlock controller security for two
minutes
An invalid SKEL entry
displays the day & time of
the failed attempt
*The unique one-time unlock key is derived from SK3L failure message
PASSCODE EXAMPLES
If you see
PASSCODE?
On the serial console after the reflash –it’s locked!
14
If the modem is OFF, local operations are unaffected. The modem will be turned on automatically if needed
to send a message, and will turn the modem off again after 30 minutes without further communications.
From the console, or when the modem is on, it can be turned on/off manually with SET MODEM ON / OFF.
If the modem is left off for longer than 24 hours, the controller will enter deep-sleep, requiring a power-cycle.
If you type any command, and see
PASSCODE?
Yes, it’s really locked.
Normally, if you know the passcode, type
KEY {passcode} or UNLock {passcode}
Which will unlock the controller to accept commands, make config changes etc.
The controller will automatically re-lock after a period of inactivity.
Mixed-case keywords e.g. key PAssPhRaSe are CASE-SENSITIVE !
If you DON’T know the passcode ---
Only from the serial console –not via SMS
From the console –you have a backdoor for one-time access (not via SMS)
By using the prompt for a failed access
[Thu 09:49] PASSCODE?
-Is giving a hint to the one-time backdoor access code
Type SK3L hh:mm as shown in the prompt (skeleton-key)
SK3L 09:49 will unlock the console for a few minutes allowing ‘emergency’ access
SMS users must know the PASSCODE for normal access.
TO SET A NEW PASSCODE
Only from the serial console –not via SMS
When you are in the command line / allowed access –
SET KEY {passcode}
Sets a new passcode –or if blank –will clear the existing passcode.
SET KEY {leave blank}
All users must know the new passcode to perform future actions.
POWER SAVING
Under battery operation, keep the unit connected to a trickle charger whenever not being used.
The controller is aware of ‘low’ operating voltage and ‘crash-stop’ voltage states (less than required
to keep the modem and/or battery viable
15
).
If either voltage threshold is reached for more than ~30 seconds, a text notification will be sent to all
ADMIN CLI users.
15
The battery powered units have an internal Sealed Lead-Acid (SLA) battery, which must be kept above 11
volts to retain the performance of the battery over its life.
If it was low-voltage ‘warning’ - the modem will be turned OFF to save the remaining battery charge.
It can still ‘send’ notifications. If the battery / charge recovers – the unit will revert to the fully
operational state.
However if the battery voltage drops below the ‘crash-stop’ level, it will send a message – then shut
down the controller completely until the unit is recharged / turned off and back on.
To reduce power consumption in battery applications or remote locations, you can send the
command SET MODEM OFF
16
, which will reduce power usage by around 50% - extending battery life
even further.
The Power/Activity indicator LED slows to blink every 4 seconds when the modem is turned off.
IMPORTANT NOTES: Further incoming SMS commands will not be received until the modem is
turned on again, but when a new outbound message is generated, the modem will turn on
automatically –and will remain on for 30 minutes (in case you need to respond remotely).
NOTE:
Using timers to turn the modem ‘off’ in the evening, and ‘on’ in the morning, will still raise
notifications when needed, but save battery power by not ‘listening’ for your incoming messages
overnight while you’re asleep.
Another option if it suits your application - is to simply turn the modem off ‘all the time’ with SET
MODEM OFF… then as mentioned elsewhere, you’ll still get messages & notifications generated by
the unit, and you can respond or send commands back in the period after any messages –and the
modem will automatically go back to sleep 30 minutes after the last message transaction either way.
Do not turn the modem OFF in SLAVE controllers –because they can’t receive slave commands!
16
The clock and timers when the modem is ‘on’ are derived from the cellular network. When the modem is
off, the time is maintained locally, but is not as accurate over longer periods. When the modem is turned on
again - the clock will be resynchronised to the cell network.
DIAL-IN EVENTS
ControlMate supports a voice-call from any authorised CLI number to initiate any controller
command. The command for CLI member ‘n’ may be changed with SET DIALIN n {command}
Each CLI user may have a different assigned dial-in command.
The ControlMate allows the call to ‘ring’ twice
17
, but rejects the incoming call –thus it is a free call,
however the caller won’t know if the device has turned on or off
18
in response to the dial-in. If you
have SMS assigned to that event, the unit can be configured to send a confirmation of the recent
dial-in event.
When a successful call-in has been made, hang-up within 5 secs, and the controller will make a
return call as notification of a successful access attempt. DO NOT ANSWER THE CALLBACK, or the
SIM account will be charged. Reject or ignore the notification call-back, which will be dropped after
approximately 5 seconds. Call-back notifications may be disabled with SET CALL OFF
For example, if ‘Out 0 Toggle’ is configured, and output 0 is connected to a pump, which can run
for up to an hour…
Set the pulse duration for output 0 to hold ‘on’for 1 hour… then if a caller dials in, or forgets to call
back, the pump will turn off automatically after an hour anyway. This doesn’t help if someone else
dials in ‘to be helpful’–soon after you turned the pump on –as they will simply turn the pump off !
Just make sure those in the caller ID access list know what they’re doing. The notifications can help
reduce any confusion. If you don’t get a call-back –the command may not have been executed –so
checking with a SHO xxx inquiry may be worthwhile.
Users may be added to the OUTSMS assignments for any output –and they’ll be notified by text
message whenever that relay changes state.
SETTING TIMERS
The timer capabilities are extremely flexible. There are multiple timers –each may be set to operate
on one or more days of the week at a specified time.
Example: To set timer #4 to toggle output relay #1 on Weekends at 17:00 (5:00pm) –
SET TIMER 4 17:00 Wke out 1 tog
To break this down into four fields…
SET TIMER 4 is self-explanatory…
17:00 is the time on selected days to perform the command.
This timer is only triggered on Weekend days (WKE),
… and the command to be executed is OUT 1 TOG
17
Caller-ID data is provided between the first and second incoming ring. Ensure the phone making the
incoming call is configured to send Caller-ID information, or ControlMate can’t identify the caller by their
number.
18
The caller’s phone number must be correctly stored in the CLI list for a dial-in to be successful. There is no
difference to a dial-in user if their call is accepted or rejected as being a CLI member. It is suggested in this
case that any dial-in output is configured with a pulsed duration, or to send an SMS back to the sender - to
avoid being accidentally toggled the ‘wrong’ way – thus any dial-in call after the pulse has expired will always
set the output ‘on’ for another pulse cycle.
Any valid ControlMate command may
be used. Even if it modifies the timer
that triggered it!
The timer ‘days’may be any combination of –
ALL, WKD, WKE, SA, SU, MO, TU, WE, TH, FR –without commas or spaces between.
e.g. typing WKETUFR –will arm the timer for
WKEnds (Saturday+Sunday)
plus TUesday and FRiday
- ControlMate commands are not case-sensitive.
To review timer settings use SHO TIMer or
SHO TIMer nfor detail about timer ‘n’.
If the full list is ‘too long’ use the detail view (SHO
TIMer n)
One possible use may be to enable or disable a particular user’s rights on certain days or times…
SET TIMER 6 17:00 all set ACL 2 3 // User 2 out 3 on all days
SET TIMER 7 03:00 wkemo set ACL 2 {blank} // disable all outs for user 2
SET TIMER 8 23:00 tuwethfr set ACL 2 {blank} // disable all outs for user 2
This allows user #2 to operate relay output 3 between 17:00 (5pm), and 03:00 WeeKEnds and
MOndays (WkeMo -or- SaSuMo), and until 23:00 (11pm) on other days (TuWeThFr).
SMS NOTIFICATIONS
Most interaction with ControlMate occurs via SMS text messages. Due to the restricted length of
standard ‘single message’ texts – the content is often brief and to the point.
HOWEVER: There are occasions on a heavily configured system, particularly with
lengthy text/message prompts… that some commands will return a warning because the
response message is ‘too long’. In these cases use a detail view to see the settings you
are looking for. Longer messages ae always visible on the ‘local’ serial console.
e.g. SHO TIMERS could create an over-length reply, but SHO TIMER 2 (or any other number) will
return a shorter, but more detailed reply.
If no users are configured to receive INSMS or OUTSMS from the caller access list, only the person
that sends a command or request will get an acknowledgement/ reply from ControlMate.
If the ControlMate operation involves a change of input state –any users
19
with INSMS associations
will be notified. The same applies to users with OUTSMS associations –for output state changes.
You must keep in mind that with any DIalIn, and onCMD/offCMD settings, the inputs and
outputs may operate without any user commands.
19
It is possible for INSMS and OUTSMS to generate a lot of text messages! Ensure only those people that need
are updated with each input or output state. ControlMate can queue multiple outbound messages –but each
takes around 3-10 seconds to be actually sent –so with 6 notified users, and 2 queued messages each - the
queue positions could take some time to flush out to the recipients.
>sho tim
--TIMERS-- ON
0: 22:00 Mon-Fri
1: 00:00 Every Day
3: 12:00 MoTuFr
5: 14:00 TuTh
6: 11:00 Mon-Fri
7: 13:00 WeThFr
9: 13:00 Sat-Sun
>set tim 3 12:00 motufr out 2 tog
Timer 3: at 12:00 MoTuFr, do [out 2 on]
NOTE:INSMS/OUTSMS messages are only sent if the input or output changes state.
Sending an ON command if the output is already ‘on’ will not generate a ‘change of state’
message. This is done to manage excess SMS traffic. SLAVE updates will be sent whether
or not the local output changes state –to keep the slave controller in sync with the sender.
If more than one CLI access list member is associated with an input (INSMS) or output (OUTSMS),
any state changes on those inputs and outputs will be notified to all those assigned users –as well as
the person that initiated the event.
INZsms and OUTZsms messages are sent when an INCOunter or OUTCOunter counts up to zero.
These values may be set to a negative value, and increment when the in/out switches ‘on’.
If the value is positive, the in/out counter continues upward –to a limit over 32000
20
- with each ‘on’
trigger event. The counters will not increment from a value of zero.
To start an upward positive counter, set a value of 1 or any non-zero value.
DIALIN commands that trigger ‘output’ events will be notified in the same way.
SPECIAL CASE MESSAGES:
•If a message is received by the unit with the words BALANCE, EXPIR or CREDIT, ControlMate will
send a notification to all ADMIN users –in event the SIM account is running low on credit.
•If a message is received with the word CODE in the text, ControlMate will send a notification to
all the ADMIN users in the CLI list –in event the SIM provider is notifying you of an important
access or other ‘code’.
OBSERVATIONS
•In some rare situations it is possible that reply messages may be too long to send!
In these cases you might be able to make the request more specific
e.g. rather than- SHO TIMERs, use SHO TIMER n
rather than SHO INON, use SHO IN n
etc… These will show more detail about each single object n.
•If ControlMate generates too many messages, too quickly to fit in the outgoing queue, the ‘last’
messages are dropped
21
- and the red ‘status’ LED is flashed – but ControlMate will continue
sending those previously queued messages that were stacked up earlier.
•If ControlMate has difficulty sending an individual message, it will retry that message several
times before ‘dropping’ that individual notification.
•The more you think about the INON/OFF, and OUTON/OFF text descriptions –the more
informative the notifications will be. ControlMate tries to tie together as much information as
possible to make meaningful messages.
•If the INON or INOFF messages are only 1-char –that specific message will not be sent as an
INSMS event . This is to support ‘on-only’ or ‘of-only’ notifications etc.
•When a message is sent out, it tries to make the most use of the CLINAMe information and the
ControlMate I/O status to provide the most informative messages. ‘John’s Mobile’, ‘Office Desk’
etc will help identify operator requests.
•SET CLINAM or SET SITE NAME support MiXed CaSe names.
*SET (with asterisk) will force the names to all lower case. (Just a coding kink!)
20
Max up-count value is 32767, then rolls over to -32768 and continues counting toward zero.
21
As soon as positions are released in the first-in-first-out basis.
•POWER SUPPLY requirement with 12V supply
CONTROLMATE:
-Start-up, approx. 200mA (with short peaks during network registration).
-MODEM ON: No LCD or LED, no relays active 90mA when idle.
-MODEM OFF: No LCD or LED, no relays active 50mA when idle.
-LCD, add 15mA, or each relay on 20mA, LED panel adds approx. 80mA
While actually sending SMS messages, add approx. 150mA to any situation.
•If the (30 sec) average supply drops below a reliable operating voltage, a warning is sent to
ADMIN users. If the supply drops below a critical level, the controller enters low-power state,
and can only be restarted with a power-cycle.
•Supply voltage is displayed for confidence purposes only.
•Input trigger current ~2mA (<2K7 ohms across closed-contact).
•High-side input opto-couplers are biased to +5V via 330-ohm pull-up.
•If the modem has been turned off, and no attempt at outgoing messages has been
made for 24 hours, the controller will enter hardware deep-sleep to conserve
remaining battery condition. Only a power-cycle can restart normal operation.
This manual suits for next models
1
Table of contents
Other SMS Measuring Instrument manuals
