Messages

In this chapter, all formats of messages are described. Messages of a specified type can be requested using flags (see their list below):

Messages types:

Flag Description
0x0000 messages with data
0x0100 SMS
0x0200 command
0x0600 event

Message with data

Flag - 0x0000

{
	"t":<uint>,		/* message time (UTC) */
	"f":<uint>,		/* flags (see table below)*/
	"tp":"udp",		/* message type (udp - message with data) */
	"l":<text>,		/* loaction */
	"y":<double>,		/* latitude */
	"x":<double>,		/* longitude */
	"z":<int>,		/* altitude */
	"s":<uint>		/* speed */
	"c":<uint>,		/* course */
	"sc":<ubyte>		/* satellites count */
	"i":<uint>,		/* input data */
	"o":<uint>,		/* output data */
	"p":{			/* parameters */
		<text>:<double>		/* name: value */
	}		
}

Flags of messages with data:

Value Description
0x01 position information is available
0x02 input data information is available
0x04 output data information is available
0x08 state information is available
0x10 message contains alarm bit
0x20 message contains information about driver code

SMS

Flag - 0x0100

{
	"t":<uint>,	/* message time (UTC) */
	"f":256,	/* flag (256 - sms) */
	"tp":"us",	/* message type (us - SMS message) */
	"st":<text>,	/* text of message */
	"mp":<text>,	/* modem phone number */
	"p":{}		/* parameters */		
}

Command

Flag - 0x0200

{
	"t":<uint>,	/* message time (UTC) */
	"f":512,	/* flag (512 - command) */
	"tp":"ucr",	/* message type (ucr - command) */
	"cn":<text>,	/* command name */
	"cp":<text>,	/* command parameters */
	"ug":<text>,	/* user GUID */
	"ln":<text>,	/* link name */
	"lt":<text>,	/* link type */
	"et":<uint>,	/* execution time */
	"p":{}		/* parameters */		
}

Link types are described i chapter Command parameters.

Event

Flag - 0x0600

{
	"t":<uint>,	/* message time (UTC)*/
	"f":<uint>,	/* flags (see below) */
	"tp":"evt",	/* message type (evt - event) */
	"et":<text>,	/* text of event */
	"x":<double>,	/* longitude */
	"y":<double>,	/* latitude */
	"p":{}		/* parameters */		
}

Event flags:

Value Description
0x0 simple event
0x1 violation
0x2 maintenance event
0x4 route control event
0x8 update driver on a unit event
Follow us on Facebook Gurtam Wialon Twitter Gurtam Wialon info@gurtam.com   |   Copyright © 2002-2019 Gurtam