Содержание

Сообщения

В данном разделе рассмотрены форматы всех типов сообщений системы 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";;;