Advisor Advanced SMS

Control Reference Manual

Content
Introduction 1
SMS control requirements 2
Command syntax 2
User authentication 2
SMS command list 3
Messages from unauthorized source 8
Unrecognized commands 8
Automatic disabling of SMS control 8
Multilingual support 9
Responses 9

Contact information
For contact information, see www.utcfireandsecurity.com or www.interlogix.com.
For customer support, see www.utcfssecurityproducts.eu.
Copyright © 2014 UTC Fire & Security Americas Corporation, Inc. All rights
reserved.

Introduction
This manual specifies the SMS commands available in the systems equipped
with ATS7310 GSM communication modules. You can send commands to the
alarm system via SMS messages. These commands are listed in “SMS
command list” on page 3.

P/N 1070010 (EN) • REV B • ISS 18APR14 1

SMS control requirements
In order to use SMS control functions, you must follow these rules:
• Have a valid phone number defined in user options.
This setting is available both locally and remotely. See the Register and
Unregister command, as well as the Phone command description.
• Belong to the user group with the SMS control allowance.
• Have SMS control enabled. See the enable and Disable command
description for more details.

Command syntax
The following syntax is used for all commands:
[<PIN>] <command> [<parameters>] [, <command>
[<parameters>] ]
The following principles apply:
• Commands are case-insensitive.
• Any number of consecutive blank characters (spaces, tabs, CRs, etc.) are
interpreted as a single space.
• You can have up to 10 commands in one SMS message. Commands must be
separated with a comma.
• In most cases <list> is a space-separated list, or “all”. If <list> is “all”, or is
omitted, this is equivalent to a list of all objects for which the user has rights
for the selected action.
• If the parameter is a phone number, it should be given in the fully expanded
form, with country code preceded by “+”. For example: +48555223322.

User authentication
The user is authenticated by the phone number sending the SMS message.
Only registered phone numbers are allowed to send SMS commands.
The PIN field is required, if:
• The “User PIN req.” option is set to Yes
— or —
• The same phone number is programmed for more than one user. The PIN is
then required to identify the user.
If the PIN field is required and the command does not contain the PIN code, the
following message is returned:
Command rejected, PIN required.

2 Advisor Advanced SMS Control Reference Manual

If the PIN field is required and the PIN is invalid, the following message is
returned:
Command rejected, invalid PIN.
If the PIN field is not required, the PIN must not be present in SMS message.

SMS command list

Table 1: SMS commands
Command Description Example
status Get system status. st
st The command returns the Get system status.
following: alarm in areas, areas
set, areas being set, partset,
unset, areas not ready, and fault
list.
area <area list> Get area names. area 2
ar <area list> Get area 2 name.
ar 2 3 5
Get names of areas 2, 3, and 5.
set [<area list>] Set areas. set
s [<area list>] If <area list> is “all”, or is Set all allowed areas.
omitted, this is equivalent to a set 1
list of all areas for which the user Set area 1.
has rights for the selected s 2 3 5
action. Set areas 2, 3, and 5.
s all
Set all allowed areas.
unset [<area list>] Unset areas. Parameters are unset
u [<area list>] equal to the Set command. Unset all allowed areas.
unset 1
Unset area 1.
u 2 3 5
Unset areas 2, 3, and 5.
u all
Unset all allowed areas.
partset [<area list>] Part set 1 or part set 2 areas. partset
p [<area list>] Parameters are equal to the Set Part set 1 all allowed areas.
command. partset2 1
partset2 [<area list>]
Part set 2 area 1.
p2 [<area list>]
p 2 3 5
Part set 1 areas 2, 3, and 5.
p2 all
Part set 2 all allowed areas.

Advisor Advanced SMS Control Reference Manual 3

Command Description Example
forceset [<area list>] Forced set areas. Parameters forceset
fs [<area list>] are equal to the Set command. Forced set all allowed areas.
forceset 1
Forced set area 1.
fs 2 3 5
Forced set areas 2, 3, and 5.
fs all
Forced set all allowed areas.
forcepartset [<area list>] Forced part set areas. forcepartset
fp [<area list>] Parameters are equal to the Set Forced part set all allowed areas.
command. forcepartset 1
Forced part set area 1.
fp 2 3 5
Forced part set areas 2, 3, and 5.
fp all
Forced part set all allowed areas.
zone <zone list> Get zone details. zone 2
zn <zone list> The command returns zone Get details for zone 2.
name, areas that the zone zn 2 3 5
belongs to, and zone type, for Get details for zones 2, 3, and 5.
each zone in the list.
Up to 10 zone entries can be
returned.
zone status [<area list>] Get open and inhibit status of all zone status
zs [<area list>] zones in the areas listed. Get status for all zones in all
If <area list> is “all”, or is allowed areas.
omitted, this is equivalent to a zone status 1
list of all areas for which the user Get status for zones of area 1.
has rights for the selected zs 2 3 5
action. Get status for zones of areas 2, 3,
and 5.
zs all
Get status from all zones in all
allowed areas.
zone faults [<area list>] Get fault, tamper, and isolate zone faults
zf [<area list>] status of all zones in the areas Get faults for all zones in all
listed. Parameters are equal to allowed areas.
the Zone Status command. zone faults 1
Get faults for zones of area 1.
zf 2 3 5
Get faults for zones of areas 2, 3,
and 5.
zf all
Get faults from all zones in all
allowed areas.
inhibit <zone list> Inhibit listed zones. inhibit 2
inh <zone list> Inhibit zone 2.
inh 1 2 3 7
Inhibit zones 1, 2, 3, and 7.

4 Advisor Advanced SMS Control Reference Manual

Command Description Example
uninhibit <zone list> Uninhibit listed zones. uninhibit 2
uninh <zone list> Uninhibit zone 2.
uninh 1 2 3 7
Uninhibit zones 1, 2, 3, and 7.
isolate <zone list> Isolate listed zones. isolate 2
iso <zone list> Isolate zone 2.
iso 1 2 3 7
Isolate zones 1, 2, 3, and 7.
unisolate <zone list> Unisolate listed zones. unisolate 2
uniso <zone list> Unisolate zone 2.
uniso 1 2 3 7
Unisolate zones 1, 2, 3, and 7.
event [<type>] [<num>] Get a selected event. event 23
ev [<type>] [<num>] Events are numbered starting Get mandatory event 23.
from 1 (the most recent event) event access 3
to 255. Get access event 23.
Type can be one of the ev all
following: Get the last event.
• “Mandatory” or “m”: event all 13
mandatory events Get event 13.
• “Nonmandatory” or “n”: non- ev
mandatory events Get the last mandatory event.
• “Installer” or “i”: installer
events
• “Access” or “a”: access
events
• “All”: all events
If the <type> parameter is
omitted, only the mandatory
events are listed.
If the number is omitted, the
most recent event is returned.
events [<type>] Get events from the range, events 23
[<num1>] [<num2>] including <num1> and <num2>. Get mandatory events from 1 to 23.
evs [<type>] [<num1>] Type usage is equal to the events access 3 13
[<num2>] “event” command, with the Get access events from 3 to 13.
following exceptions: evs all
• If one number is omitted, all Get 10 last events.
events up to <num1> are events all 13
returned (or <num1> of most Get events 1 to 13.
recent events).
evs 2 50
• If both numbers are omitted, Get mandatory events 2 to 26 (only
10 most recent events are 25 events can be returned).
returned (1 to 10).
Parameters num1 and num2 can
have values from 1 (the most
recent event) to 255.
Up to 25 events can be returned.

Advisor Advanced SMS Control Reference Manual 5

Command Description Example
on <trigger list> Activate listed triggers. on 1
Activate trigger 1.
on 2 5 6
Activate triggers 2, 5, and 6.
off <trigger list> Deactivate listed triggers. off 1
Deactivate trigger 1.
off 2 5 6
Deactivate triggers 2, 5, and 6.
toggle <trigger list> Toggle listed triggers states. toggle 1
Toggle trigger 1.
toggle 2 5 6
Toggle triggers 2, 5, and 6.
trigger <trigger list> Get trigger names and states. trigger 1
trig <trigger list> Get trigger 1 name and state.
tr 2 3 5
Get names and states for
triggers 2, 3, and 5.
output <num> Get output state. output 3
out <num> Get output 3 status.
out 7
Get output 7 status.
outputs [<output list>] Get listed outputs states. outputs 3
outs [<output list>] Get output 3 status.
outs 7 8 11
Get status of outputs 7, 8, and 11.
start reporting [<num>] Start SMS reporting to the user start reporting 6
start [<num>] <num>, or for the sender, if Start reporting for user 6.
<num> is omitted [2][3]. start
Start reporting for yourself.
stop reporting [<num>] Stop SMS reporting to the user stop reporting 6
stop [<num>] <num>, or for the sender, if Stop reporting for user 6, until the
<num> is omitted, until the next next system set.
system set [2][3]. stop
Stop SMS reporting for yourself,
until the next system set.
stop reporting permanent Stop SMS reporting to the user stop reporting
[<num>] <num>, or for the sender, if permanent 6
stop perm [<num>] <num> is omitted, until started Stop reporting for user 6, until it is
again via the “start reporting” allowed by the “start reporting”
command [2][3]. command.
stop perm
Stop reporting for yourself, until
started again.
register <phone> <num> Change phone number of the register +48555223322
r <phone> <num> user <num> to the new <phone> 6
[1]. Change phone number of user 6 to
Note: You cannot change your the new one.
own phone number using this r +48223322555 9
command. Use “Phone” Change phone number of user 9 to
command instead. the new one.

6 Advisor Advanced SMS Control Reference Manual

Command Description Example
unregister <num> Delete phone number of the unregister 6
unr <num> user <num> [1]. Delete phone number of user 6.
Note: You cannot delete your unr 9
own phone number using this Delete phone number of user 9.
command.
phone <phone> Change own phone number to phone +48555223322
<phone>. Change the registered phone
The command must be sent number of the sender for the new
from the old (currently one. The next command must be
registered) phone number. sent from the +48555223322.
The registered phone is
changed permanently once the
next valid command is sent from
the new phone number. If the
next valid command is sent from
the old phone number, the
operation is cancelled.
pin <PIN> [<num>] Change PIN for the user <num>, pin 1234 6
or for the sender, if <num> is Set user 6 PIN to 1234.
omitted [2]. pin 4321
Set own PIN to 4321.
disable <num> Disable SMS control for the user disable 6
dis <num> <num> [1][4]. Disable control for user 6
dis 9
Disable control for user 9
enable <num> Enable SMS control for the user enable 6
en <num> <num> [1][4]. Enable control for user 6
en 9
Enable control for user 9
user <num> Get user <num> details [1]. user 6
The command returns user List user 6 details
name, phone number, language, u 9
SMS control and reporting List user 6 details
privileges.
users [<num 1> <num2>] List users from <num 1> to users 6 9
<num2> range together with List users from 6 to 9 and their
their phone numbers, SMS phone numbers.
control and reporting privileges users
[1]. List all users that have “SMS
If the user range is omitted, the reports” and “SMS control” allowed.
list contains only the users that
belong to the user groups with
“SMS reports allowed” or “SMS
control allowed” privileges set.
language <language> Change language of the user language english 6
[<num>] <num>, or for the sender, if Set language for user 6 to English.
lang <language> <num> is omitted. lang polski
[<num>] <Language> is the localized Set own language to Polish.
language name, for example,
English, Deutsch, Suomi.

Advisor Advanced SMS Control Reference Manual 7

Command Description Example
credits Get GSM network credit cr
cr information [1]. Get credit information.
The answer format may vary for
different GSM operators.
connect <num> Start remote PC connection connect 2
conn <num> <num> [1] Start PC connection 2.
conn 4
Start PC connection 4.
help Get list of the allowed SMS help
commands. Get command list

[1] Only the Supervisor can execute this command.

[2] Non-supervisor users can perform this operation only for themselves. Only the Supervisor
can execute this command for a different user than himself.
[3] The command affects the “SMS reporting” option in the user settings. The command can be
performed only for those users that are allowed to receive SMS reports, for example, the user
belongs to the User Group with the SMS reporting allowed.
[4] The command affects “SMS control” option in User settings. The command can be performed
only for those users that belong to the User Group with SMS control allowed.

Messages from unauthorized sources

SMS messages from an unknown source are forwarded to the user with
Supervisor privileges, if panel settings allow this.
The panel configuration sets the limit for the number of forwarded SMS
messages during 24 hours. If the number of messages exceeds the limit, no
more messages are forwarded, and an appropriate event message is added to
the panel log.
Contact your system installer for more details.

Unrecognized commands
If an invalid (unrecognized) command is sent from a registered phone number,
the system responds with the following message:
Bad command.

Automatic disabling of SMS control

After 10 unsuccessful command attempts from the phone registered to a user,
SMS control is automatically disabled for the user. The following message is sent
to the Supervisor user:
SMS control disabled following too many unsuccessful
attempts.
Automatic disabling is accomplished by means of disabling the SMS control
option. The option can be restored by the supervisor using the “enable”
command (see the Enable command).

8 Advisor Advanced SMS Control Reference Manual

If SMS control is automatically disabled for a particular user, it is re-enabled
automatically after the user successfully logs in to the system locally.

Multilingual support
The commands are interpreted in the language set for the authenticated user.
If there is any special national character in the command, the command can be
sent either using national characters (USC2 coding), or in plain ASCII (“flattened”
form).

Responses
Table 2 below lists possible responses to an SMS command.

Table 2: SMS responses

Response Cause
<command list> A response to the Help command.
<event list> A list of events requested.
<fault list> Part of a status response [1], a list of faults.
This can be also a part of the set / unset / part set / forced
set response. In this case the list contains faults that
prevent the command from the successful execution.
<language> language is set for user The language command was performed successfully.
<num> (<user name>)
<phone> - phone already registered The new phone number has been already registered for
for user <num> (<name>) the user when the Register command is sent.
<phone> - phone changed for user The phone number was successfully changed via the
<num> (<name>) Phone command.
<phone> - phone registered for user Registered phone number was successfully assigned to
<num> (<name>) the <phone> after command Register.
<trigger number> <state> (<trigger Trigger details received via the Trigger command.
name>)
Access not allowed The requested information concerns areas that the user
has no access to.
Access not allowed to zone(s) <zone The user does not have the access required to perform
list> the action on the selected zones within this area.
Action failed: possibly caused by a The command was attempted but failed.
system fault or insufficient authority Note: Some failure conditions are difficult to determine.
These include, for example, system faults, and
arm/disarm authority that changes with time.

Advisor Advanced SMS Control Reference Manual 9

Response Cause
Alarm <area list> A response to the Status command. List areas in alarms,
Not ready <area list> areas set, areas that are currently under setting, part set,
unset, not ready to set, or if there are no faults [1].
Set <area list>
Partset <area list>
Setting <area list>
Unset <area list>
Unsetting <area list>
No faults
AREA <n> Zone faults response. List the area, and tampers, anti-
Tampered <zone list> masks, low battery and short faults in its zones, as well as
isolated zones.
AntiMask <zone list>
Low Batt <zone list>
Short Loss <zone list>
Isolated <zone list>
AREA <n> (<area name>) Area name received via the Area command.
AREA <n> Zone status response. List the area, and open and
Open <zone list> inhibited zones in this area.
Inhibited <zone list>
Normal

Bad command. The command was not recognized.

Command rejected, invalid PIN. A PIN is required but the command contains an invalid
PIN.
Command rejected, PIN required. A PIN is required but the command does not contain a
PIN.
Commands: <command list> A response for the Help command.
Credit check not configured The credit checking function is not configured in the
system.
Credit check started The system has requested the credit information. Upon
receiving from the GSM provider, this information is sent
via a separate SMS message.
Event: unrecognised event number The event number or range given is invalid.
[range] <num1> [num2]
Inhibited zone(s) <zone list> A response for the Inhibit command.
Isolated zone(s) <zone list> A response for the Isolate command.
No action performed: invalid Wrong parameter of the command. For example, non-
parameter existing area number.
No action performed: invalid trigger Wrong trigger number.
list, please use numbers 1–255
No action performed: invalid user Invalid user numbers.
range
No action performed: no existing PC Unable to connect to the PC, because the selected PC
connection connection does not exist.
No action performed: no existing user Invalid user number.

10 Advisor Advanced SMS Control Reference Manual

Response Cause
No action performed: possibly caused Unable to execute a command (for example, set area)
by a system fault or area state because of a system fault or area state (for example, the
area is already set).
This message can be followed by the list of faults that
prevent an execution of the command.
No action performed: SMS control Unable to activate SMS control for a user that does not
functions cannot be used by user belong to the group with SMS control allowed.
<num>
No action performed: SMS reports Unable to activate reporting for a user that does not
cannot be received by user <num> belong to the group with SMS reporting allowed.
No action performed: you do not have The user has no access to the areas given.
access to area(s) <area list>
No action performed: you do not have A non-supervisory user has attempted to change the
authority to change settings for user other user settings.
<num>
No action performed: you do not have The user has no rights to perform the action.
authority to set / unset / part set /
forced set
not configured output <output num> Wrong output number.
output <num> <state> (<name>) Output status response. Lists the requested output status
together with output names, if available.
PC connection initiated for <num> The system was successfully connected via PC
connection <num> as a result of the Connect command.
PC connection not configured The selected PC connection is not configured in the
system.
Phone change cancelled for user <n> While changing sender’s own phone number, the next
(<name>) valid command was sent from the old phone number
instead of the new one, and this cancels the number
change.
Phone deleted for user <num> The phone number was successfully removed with the
(<name>) Unregister command.
Phone is being changed for user The phone number change request via the Phone
<num> (<name>) command was accepted, but it will be changed only after
the next command is received from the new phone
number.
Phone not unregistered: cannot The supervisor has attempted to unregister his or her own
delete own phone phone number.
Phone not unregistered: no existing Invalid user number.
user
PIN not set: not found user Invalid user number.
PIN not set: PIN not accepted Invalid PIN provided.
PIN set for user <num> (<user PIN was successfully changed via the Pin command.
name>)

Advisor Advanced SMS Control Reference Manual 11

Response Cause
Reporting activated for user <n> Successful execution of one of the following commands:
(<user name>) Start reporting, Stop reporting, and Stop reporting
Reporting de-activated until re-setting permanent.
for user <n> (<user name>)
Reporting de-activated for user <n>
(<user name>)
SMS control disabled for user <num> SMS control was successfully enabled or disabled via one
(<user name>) of the following commands: Enable or Disable.
SMS control enabled for user <num>
(<user name>)
Triggers set: <trigger list> Trigger change request response (on, off, or toggle). Lists
Triggers reset: <trigger list> the affected triggers.
Triggers unchanged: <trigger list>
Unauthorised, access denied This message is sent as a response to a request from the
user without sufficient privileges and access rights to
perform the requested command.
Uninhibited zone(s) <zone list> A response for the Uninhibit command.
Unisolated zone(s) <zone list> A response for the Unisolate command.
user <num> (<name>) User details received via the User command.
phone <phone>
language <language>
SMS control [not allowed] / [enabled]
/ [disabled] / [disabled until local
access]
SMS reporting [not allowed] /
[enabled] / [disabled] / [disabled until
re-setting]
user <num> (<name>) [R*] / [R-] [C*] User entries received via the Users command.
/ [C-] [<phone number>] R* is shown if the user is allowed to receive SMS reports
and SMS reporting is currently enabled. R- is shown if
SMS reporting is disabled for the user. If the user is not
allowed to receive SMS reports, this information is not
shown.
C* is shown if the user is allowed to use SMS control, and
SMS control is enabled for the user. C- is shown if SMS
control is currently disabled for the user. If the user is not
allowed to use SMS control, this information is not shown.
ZONE <n> (<zone name>) Zone details received via the Zone command.
Area(s): <area list>
Type: <type name>

[1] This message is also received after a set, unset, part set, forced set, or forced part set
command.

12 Advisor Advanced SMS Control Reference Manual