Содержание
Сообщения
В данном разделе рассмотрены форматы всех типов сообщений системы Wialon. Сообщения определенного типа можно запросить используя флаги, их список представлен ниже:
Все флаги используются только в DEC формате.
Типы сообщений:
| Флаг HEX | Флаг DEC | Описание |
|---|---|---|
| Сообщения объекта | ||
| 0x0000 | 0 | сообщение с данными |
| 0x0100 | 256 | SMS |
| 0x0200 | 512 | команда |
| 0x0600 | 1536 | событие |
| 0x2000 | 8192 | потребление видео-трафика |
| Сообщения ресурса | ||
| 0x0300 | 768 | пользовательское уведомление |
| 0x0500 | 1280 | сообщение биллинга |
| 0x0900 | 2304 | SMS для водителя |
| Журнал | ||
| 0x1000 | 4096 | записи журнала |
Для удаления определенных сообщений нужно иметь следующие ACL-флаги:
| Что удалить | Флаг сообщения HEX(DEC) | ACL-флаг HEX(DEC) |
|---|---|---|
| Сообщения с данными | 0x0000(0) | 0x800000(8388608) |
| SMS-Сообщения | 0x0100(256) | 0x800000(8388608) |
| Отправленные команды | 0x0200(512) | 0x800000(8388608) |
| Зарегистрированные события | 0x0600(1536) | 0x2000000(33554432) |
| Журнал | 0x1000(4096) | 0x800(2048) |
Смотрите более подробную информацию по ACL-флагам.
Сообщениe с данными
Флаг - 0x0000(0)
{ "t":<uint>, /* время сообщения (UTC) */ "f":<uint>, /* флаги (см. таблицу ниже)*/ "tp":"ud", /* тип сообщения (ud - сообщение с данными) */ "pos":{ /* местоположение */ "y":<double>, /* широта */ "x":<double>, /* долгота */ "z":<int>, /* высота над уровнем моря */ "s":<uint> /* скорость */ "c":<uint>, /* курс */ "sc":<ubyte> /* количество спутников */ }, "i":<uint>, /* входящие данные */ "o":<uint>, /* исходящие данные */ "p":{ /* параметры */ <text>:<double>, ... }, "lc":<int>, /* lbs сообщения checksum */ "rt":<uint> /* время регистрации сообщения (UTC) */ }
Флаги сообщений с данными:
| Значение HEX | Значение DEC | Описание |
|---|---|---|
| 0x01 | 1 | доступна информация о местоположении |
| 0x02 | 2 | доступна информация о входящих данных |
| 0x04 | 4 | доступна информация о исходящих данных |
| 0x08 | 8 | доступна информация о состоянии |
| 0x10 | 16 | устанавливается, если сообщение содержит тревожный бит |
| 0x20 | 32 | устанавливается, если сообщение содержит информацию о коде водителя в параметре avl_driver |
| 0x20000 | 131072 | устанавливается, если сообщение откорректировано по lbs |
| 0x80000 | 524288 | устанавливается, если сообщение содержит wi-fi позицию |
SMS сообщение
Флаг - 0x0100(256)
{ "t":<uint>, /* время сообщения (UTC) */ "f":<uint>, /* флаги: у SMS сообщений нет флагов, поэтому будет стоять 0 */ "tp":"us", /* тип сообщения (us - SMS сообщение) */ "st":<text>, /* текст сообщения */ "mp":<text>, /* телефонный номер модема */ "p":{} /* параметры */ }
Команда
Флаг - 0x0200(512)
{ "t":<uint>, /* время сообщения (UTC) */ "f":<uint>, /* флаги: у сообщений с командами нет флагов, поэтому будет стоять 0 */ "tp":"ucr", /* тип сообщения (ucr - команда) */ "ca":<text>, /* название команды */ "cn":<text>, /* тип команды */ "cp":<text>, /* параметры команды */ "ui":<uint>, /* ID пользователя */ "ln":<text>, /* название связи */ "lt":<text>, /* тип связи */ "et":<uint>, /* время выполнения */ "p":{} /* параметры */ }
Типы связи рассмотрены в разделе Команды: cоздание, редактирование и удаление.
Событие
Флаг - 0x0600(1536)
{ "t":<uint>, /* время сообщения (UTC) */ "f":<uint>, /* флаги (см. таблицу ниже))*/ "tp":"evt", /* тип сообщения (evt - событие) */ "et":<text>, /* текст события */ "x":<double>, /* долгота */ "y":<double>, /* широта */ "p":{} /* параметры */ }
Флаги событий:
| Значение HEX | Значение DEC | Описание |
|---|---|---|
| 0x0 | 0 | простое событие |
| 0x1 | 1 | нарушение |
| 0x2 | 2 | событие техобслуживания |
| 0x4 | 4 | событие контроля маршрута |
| 0x10 | 16 | устанавливается дополнительно к флагу 0x2: зарегистрировано техобслуживание |
| 0x20 | 32 | устанавливается дополнительно к флагу 0x2: произошла заправка |
Потребление видео-трафика
Флаг - 0x2000(8192)
{ "t":<uint>, /* время сообщения (UTC) */ "f":<uint>, /* флаги */ "tp":"xx", /* тип сообщения */ "p":{ /* параметры */ "cha_n":<uint>, "bytes_in":<long>, "action":<uint>, "conn_id":<uint>, "hw_id":<long> } }
Пользовательское уведомление
Флаг - 0x0300(768)
{ "t":<uint>, /* время сообщения (UTC) */ "f":<uint>, /* флаги: у сообщений с уведомлениями нет флагов, поэтому будет стоять 0 */ "tp":"xx", /* тип сообщения */ "p":{} /* параметры */ }
Cообщение биллинга
Флаг - 0x0500(1280)
{ "t":<uint>, /* время сообщения (UTC) */ "f":<uint>, /* флаги: 0x1 - устанавливается когда сообщение содержит запись о платеже */ "tp":"xx", /* тип сообщения */ "p":{} /* параметры */ }
SMS для водителя
Флаг - 0x0900(2304)
{ "t":<uint>, /* время сообщения (UTC) */ "f":<uint>, /* флаги: 0x1 - устанавливается когда сообщение отправлено */ "tp":"xx", /* тип сообщения */ "p":{ /* параметры */ "phone":<text>, /* телефонный номер */ "sms_text":<text>, /* текст смс */ "driver_name":<text>, /* имя водителя */ "driver_id":<uint> /* ID водителя */ } }
Журнал
Флаг - 0x1000(4096)
{ "t":<uint>, /* время сообщения (UTC) */ "f":4096, /* флаги: 4096 - сообщения журнала */ "tp":"xx", /* тип сообщения */ "p":{ /* параметры */ "user":<text>, /* имя пользователя */ "action":<text>, /* действие */ "host":<text>, /* хост */ "p1":<text>, /* параметры */ ... } }
wln сообщения
Формат wln сообщений
REG;время;долгота;широта;скорость;курс;параметры double;параметры uint;текстовые параметры;параметры long;двоичные параметры;
Внутри секции параметры разделяются запятыми.
Пример
REG;1466585078;30.4367027283;59.7207145691;1;273;ALT:24.0,adc1:0.0,adc2:25.57,adc3:0.0,adc4:0.0,adc5:0.0,adc6:0.0,fuel1:0.0,fuel2:170.0,fuel3:0.0,odometer:7293607.0,acc:0.0,pwr_int:0.731,pwr_ext:25.751,hdop:1.7;in13:1,,SATS:5,count1:1,count2:0,temp1:0,temp2:23,temp3:0,sats_glonass:0,sats_gps:5;soft_version:"44";;;