Управление системой SpaceFinder/SKY осуществляется с помощью отправки сообщений SMS с текстом команд. Команды управления регистронезависимы, т.е. Вы можете вводить их как заглавными, так и строчными буквами. Языком общения выбран английский в силу того, что латинский алфавит является базовым для сетей GSM, поэтому такие сообщения всегда корректно передаются и отображаются. Некоторые телефоны при включенном русском языке при наборе sms используют для кодирования текста формат Unicode, из-за чего латинские символы могут передаваться некорректно. Поэтому рекомендуем набирать sms сразу в английском шрифте. Лучше всего, если Вы создадите шаблоны sms для тех команд, которыми будете пользоваться наиболее часто. Такая функция присутствует во всех современных телефонах и это позволит избежать Вам возможных опечаток.
    Команды имеют полное и сокращеное имя. Параметры команды разделяются пробелом или запятой. Успешное выполнение команды подтверждается ответным смс-сообщением «ОК», либо статусным сообщением. При ошибке в написании команды в ответ придет сообщение «Wrong command» (неправильная команда) или «Wrong parameter» (неправильный или отсутствующий параметр).

Команды запросов

Команды запросов — команды, начинающиеся со слова «GET», либо, в сокращенном варианте, «GT». Эти команды позволяют получить различную информацию о состоянии системы, в том числе и координаты.

Команда Get Balance

Get Balance - запрос баланса SIM карты установленной в прибор.

Формат команды:
Get Balance *xxx#
где *xxx# - команда запроса Вашего сотового оператора.

Сокращенный вариант команды:
gt b *xxx#

Пример команды:
Get Balance *105#  - запрос баланса у оператора Tele2

Эта команда может быть использована и для выполнения других запросов, например
Get Balance  *122*1# - запрос «обещанного платежа» у оператора Tele2

Команда Get Settings


Get Settings — получить текущие настройки прибора

В ответ на эту команду приходит сообщение следующего вида:
GPS
Mode:
Guard:SIP
Msg: S
Area: 0,0
Inp.1: A 0
Out1: JS 0
Inp.2: A 0
Out2: JS 0
Temp: 7, -15, 50

В первой строке – текущее имя, присвоенное прибору.

Поле Mode показывает режим в котором работает прибор:
G - включен режим охраны
S - включен спящий режим
P - включен режим периодической отправки сообщений
T - включен  трекинг
числовое значение возле этих букв показывает соответствующий период отправки смс в единицах (часы, минуты, секунды), соответствующих текущему режиму.

Поле Grd – текущие настройки режима охраны (см. команду Set Guard)

Поле Msg – текущие настройки сообщений для периодических режимов (см. команду Set Msg)

Поле Area – текущие настройки охранного квадрата (см. команду Set Area)

Поле Inp  - текущие настройки соотвествующего входа (см. команду Set In)

Поле Out  - текущие настройки соотвествующего выхода (см. команду Set Out)

Поле Temp  - текущие настройки температурного датчика (см. команду Set Temp). Однако, в отличие от команды Set Temp, первое число в данном случае показывает рассчитанную величину смещения показаний  датчика.   


Команда Get Version



Get Version – возвращает SMS с номером версии прибора.  

Сокращенный вариант команды:
gt v


Команды запросов координат

Команды запросов координат позволяют получить текущее местоположение прибора.   

Важно понимать алгоритм определения координат при входящем запросе, т. к. в зависимости от различных навигационных условий на формирование ответа может уйти до 15 минут.
1) Максимальное время включения GPS может составлять 15 минут.
2) Если GPS не видит спутников - ищет их 2 минуты, если не нашел ни одного - отправляет что есть и выключает GPS
3) Если GPS видит 1-2 спутника - пытается найти третий в течение максимум 15 минут (если до этого спутников не было, и их искал 2 минуты, то значит, третий спутник будет искаться 13 минут, т.е. время включения не суммируется). Такое долгое время включения необходимо для обновления альманаха, в том случае если он устарел.
4) Если GPS нашел 3 спутника, но не определил правильно координаты - ждет максимум 3 минуты. Если координаты не определены или определены неточно - отправляет то, что есть. Если координаты определены правильно - отправляет результат сразу же.

В режиме трекинга GPS включен постоянно, поэтому этот алгоритм там не используется.

Команда Get status

Get status — при получении этой команды система определяет координаты и отправляет сообщение следующего вида:

59.9441 30.4843
In:1 2
Out:OFF
Pwr:M, 80%
Temp: 25
Mode:  

Первые два числа — широта и долгота в градусах.

В случае, если GPS-модуль не способен определить координаты, т. е. широта и долгота, присланные GPS-модулем, равны нулю или вычислены с ошибкой, то первая строчка в сообщении будет иметь вид:
Last Position 16/04 12:12 59.9441 30.4843
т. е. будет прислана последняя правильно определенная точка, запомненная системой SpaceFinder.

Поле In содержит информацию об активных входах.
В том случае, если есть сработавшие входы, они отображаются соответствующим порядковым номером. Например, строка In: 1 2! говорит о том, что активны входы с номерами 1 и 2; причем вход с номером 2 – последний сработавший вход (об этом говорит восклицательный знак рядом с номером). Если активных входов нет, то поле In буде содержать символ «-».

Поле Out отображает состояние выходов.
В том случае, если есть включенные выходы, они отображаются соответствующим порядковым номером.

Поле Pwr отображает информацию об используемом источнике питания.
Наличие символа “M” означает работа от основного (Main) питания.  
“80%” – процент заряда внутреннего резервного аккумулятора.
Поле Temp показывает текущую температуру модуля.
Поле Mode показывает режим в котором работает прибор:
G - включен режим охраны
S - включен спящий режим
P - включен режим периодической отправки сообщений
T - включен  трекинг
числовое значение возле этих букв показывает соответствующий период отправки смс в единицах (часы, минуты, секунды), соответствующих текущему режиму.

Сокращенные варианты команды:
gt s
gt


Команда Get RMC


Get RMC — в ответ на эту команду система отправляет координатную информацию согласно спецификации NMEA, например:
$GPRMC,054037.529,A,5957.0268,N,03017.6210,E,6.11,223.85,020707,,,A*64

054037.529 -время по Гринвичу
Буква “A” после поля времени говорит о том, что координаты вычислены правильно, буква “V” – координаты вычислены с ошибкой.
5957.0268,N -широта
03017.6210,E – долгота
020707 – дата

Сокращенный вариант команды:
gt r

Команда Get Pos

Get Pos — команда получения координатной информации. В зависимости от параметра позволяет получить координаты в различных форматах:

a) get pos  -  без парамера возвращает смс сообщение вида:
"MyCar1 16/04 15:20" широта долгота

В данном случае в имя добавляется текущее время GPS, которое отсчитывается по Гринвичу.

В случае, если GPS-модуль не способен определить координаты, т. е. широта и долгота, присланные GPS-модулем, равны нулю или вычислены с ошибкой, то в ответ будет отправлена последняя правильная точка, запомненная системой SpaceFinder, и в имя будет добавлено "Last Position".

b) get pos m - возвращает EMS-сообщение для программы MGMaps. В результате получения такого сообщения автоматически открывается программа MGMaps и показывает точку на карте. Точка именуется аналогично пункту a)

c) get pos y - возвращает смс, содержащее http-ссылку на интернет-сраницу с картой Яндекс

d) get pos g - возвращает смс, содержащее http-ссылку на интернет-сраницу с картой Google

Сокращенные варианты команды:
gt p
gt p m
gt p y
gt p g


Get Mgpos – альтернаивный вариант команды Get Pos M.


Команда Get GSM


Get GSM — команда позволяет получить информацию о базовой станции GSM-сети, на которой в данный момент зарегистрирован прибор, и информацию о соседних базовых станциях.

Формат ответа:
http://spacefinder.ru/gsm.html?d=<mcc>,<mnc>,<lac>,<cellid>,<rxl>;[<mcc>],[<mnc>],[<lac>],<cellid>,<rxl>...

где
<mсc> - код страны
<mnc> - код сотовой сети
<lac> - номер контроллера, объединяющего несколько базовых станций
<cell id> - идентификационный номер соты
<rxl>  - уровень сигнала от данной базовой станции

Первая серия значений <mcc>,<mnc>,<lac>,<cellid>,<rxl> присутствует всегда и отображает информацию о базовой станции, на которой в данный момент зарегистрирован прибор.  После символа «;» следует информация о соседней видимой станции. Если ее значения <mcc>,<mnc>,<lac> совпадают с предыдущей станцией, то в сообщении они будут пропущены.   

Пример ответа:
http://spacefinder.ru/gsm.html?d=250,99,04cc,2b17,59;2cc6,50;2e39,45;2b18,38;2cc7,33;2b0f,37;2b12,31