INFO: Device-specific attributes – Corp Ten Support Portal Home

Summary

With the addition of the BL3K link and Universal Consolidated SMS Gateways (UCGS) in Unitrac v2.15, a method was added to allow the Unitrac admin to specify device-specific attributes when provisioning devices into Unitrac. In the case of the BL3K, each device is associated with an SMS gateway and assigned a phone number.

This document describes the attributes and which attributes are valid for each device type.

More Detail

Each attribute is globally identified by its ID. That is, IDs are constant across all Unitracs.

The defined attribute types are described in the following table.

TYPE	LITERAL VALUE	Description
Date (D)	4	Year, month and day in UTC.
Enumeration (E)	1	Set of discrete values read from the database.
Key (K256)	2	Encryption/decryption key of 32 bytes specified in ASCII-HEX format.
Key (K256/56)	6	Encryption/decryption key of maximum 32 bytes and minimum 8 bytes specified in ASCII-HEX format.
Key (K192)	5	Encryption/decryption key of 24 bytes specified in ASCII-HEX format.
Key (K128)	3	Encryption/decryption key of 1 bytes specified in ASCII-HEX format.
String (S)	0	Character string.

The following table lists all attributes.

ID	Name	Type	Description
1	SMS Gateway	E	Specifies which UCGS to use for SMS. These are read from the database. The values are: NO SMS - don't use SMS Kore Canadian - Use Kore Wireless Canadian gateway Kore ICMS - Use Kore Wireless inter-carrier gateway Kore US - Use Kore Wireless U.S. gateway
2	SMS Phone Number	S	Phone number to use for sending SMS to the device.
3	MT Encryption Key	K256	256-bit key used by Unitrac to encrypt messages to a device.
4	MO Decryption Key	K256	256-bit key used by Unitrac to decrypt messages from a device.
5	MO Decryption key for Blowfish 128	K128	Key used by Unitrac to decrypt messages from a device using Blowfish with 128 bit key.
6	IMEI Number	S	IMEI number used to send data to a device. This is used to hold the IMEI number for device types where this information is needed but not part of the unit ID.
7	Expiration Date	D	Date at which the device expires and is deleted from the database as if it had been deleted by an administrator.
8	MO Decryption Key	k192	Key used by Unitrac to decrypt messages from a device using a 192 bit key.
9	Download	E	CT3K Download Options No Download Download Only Download and Erase
10	Host Name	S	DNS Hostname associated with device
11	On Motion	E	CT3K Motion Options Do nothing Connect Live Track
12	Password	S	Device Password
13	Audio	E	CT3K Audio Options Off Mic1 Mic2
14	Dial Phone Number	S	Phone number to use for dialing the device.
15	MO Decryption Key	K256/56	Key used by Unitrac to decrypt messages from a device using a 256 bit or 56 bit key.
16	APN	E	Specifies APN information (name, username and password) used by the device.
17	Device Key	S	The 10-digit unit-specific key needed to send commands to a Sendum PT-300 (PS3K link).
18	RFU Model	E
19	PLD Model	E
20	Device Model	E	The device model for links that support more than one model.
21	Host or IP	S	Internet host name or IP address in either IPv4 or IPv6 format.
22	Port	S	Internet port number.
23	AES-128 Key	K128	Bidirectional AES-128 key (32 ASCII-Hex chars).
24	AES-256 Key	K256	Bidirectional AES-256 key (64 ASCII-Hex chars).
25	Preferred Transport	E	QP3K preferred transport SMS Unitrac-to-Device Device-to-Unitrac
26	Battery Capacity	E	QP3K battery capacity 2800 mAH 3200 mAH

Notes:

1) MO = Mobile Originated.

2) MT = Mobile Terminated.

The table below lists the device types that have attributes and what attributes are associated with that device. Note: all device types have the “Device Model” (20) attribute.

Device	Attribute ID	Attribute Name
BL3K	1 2	SMS Gateway SMS Phone Number
CL3K	7	Expiration Date
CT3K	1 2 9 10 11 12 13 14	SMS Phone Number SMS Gateway Download Options Host Name On Motion Password Audio Dial Phone Number
DT2K	5	MO Decryption Key (Blowfish 128)
DT3K	1 2 4	SMS Gateway SMS Phone Number MO Decryption Key (AES256)
GL3K	1 2	SMS Gateway SMS Phone Number
GS2K	8	MO Decryption Key (3DES)
I2K	3 4	MT Encryption Key (AES256) MO Decryption Key (AES256)
KF4K	3 6	MT Encryption Key (AES256, also used for MO) IMEI Number
LG2K	1 2 3 6	SMS Gateway SMS Phone Number MT Encryption Key (AES256, also used for MO) IMEI Number
LT2K	6	IMEI Number
ME3K	1 2	SMS Gateway SMS Phone Number
PS3K	17	Device Key
QP3K	1 2 21 22 23 24	SMS Gateway SMS Phone Number Host or IP Port AES-128 Key AES-256 Key
SM3K	1 2 15	SMS Gateway SMS Phone Number MO Decryption Key (AES256/DES)
TL3K	1 2	SMS Gateway SMS Phone Number
WF5K	3 4 6	MT Encryption Key (AES256) MO Decryption Key (AES256) IMEI Number