Professional Documents
Culture Documents
Data Communication UMRR Traffic Management - UMRR11
Data Communication UMRR Traffic Management - UMRR11
DATA COMMUNICATION
TRAFFIC MANAGEMENT SENSOR
UMRR-11
CONTENTS
1 Document Control ................................................................................................................................... 5
1 DOCUMENT CONTROL
1.1 ABBREVIATIONS
CAN Controller Area Network
PC Personal Computer
TMC Traffic Management Configurator
UDT Universal Data Transmission
UMRR Universal Medium Range Radar
2 INTRODUCTION
This document explains in detail the sensor data communication and protocols. All data communication
with the smartmicro sensor is based on a Controller Area Network (CAN) message structure. However, it is
also possible to use RS485 or Ethernet1 for communication. In these cases, the CAN messages will be
wrapped and transmitted as payload of the respective data format.
1 the Ethernet option may require additional or special hardware. Available in future firmware release.
3 COMMAND MESSAGES
Command messages are used to transmit new parameters or initiate various actions of the sensors. It is
broadcasted but the destination sensor is the only one to execute the command. If the destination ID is set
to 255 = broadcast, all sensors in a network will execute the command.
Command messages may be initiated by the PC and are transmitted to the sensors.
MESSAGE 1 (HEADER)
Table 3-1 Message 1 of the UART Command version 4
Data Data Data Data Data Data Data Data
Byte 7 Byte 6 Byte 5 Byte 4 Byte 3 Byte 2 Byte 1 Byte 0
Details:
- UAT-ID: The UAT-ID is the unique ID for UAT commands. The UAT-ID of the header message is not
important. It is possible to use the UAT-ID of the first UAT command.
- Message index: Each UAT command has a sequence number. The message index starts always
with 0 and in the following message the index gets incremented by one. For the third message, the
message index is two.
Please note: The UAT V4 Command is able to transmit more than one command message in one UAT
block. However, the UMRR-11 sensor is not able to receive more than 5 command messages in one UAT
block per sensor cycle. If it is needed to send more command messages to the sensor, it is recommended
to send multiple UAT V4 blocks with a maximum of 5 single sensor commands in further sensor cycles.
Every command (e.g., parameter, commands, and status requests) of the UAT command version 4
consists of 2 command messages, which are described in the following table. This table shows the
content of the first command message.
Table 3-2 Command message of the UAT-format version 4
Data Data Data Data Data Data Data Data
Byte 7 Byte 6 Byte 5 Byte 4 Byte 3 Byte 2 Byte 1 Byte 0
Details:
- UAT-ID: The UAT-ID is the unique ID for the UAT command. Both UAT command messages
have the same ID.
- Message Index: See Message 1 Header
- Parameter number: Parameter number
- Dim0..Dim1: Dim0…1 give the information which arrays indexes is used in which dimension in
the parameter structure. To analyze the command, compare the number of dimensions with
the parameter structure dimension. It should be equal otherwise ignore the command.
- Message Type: Describes the type of the command. See Table 1
The example shows a spline x-position parameter with the following values:
Par No: 0 = x-position of a spline
Value: ## = x position value [m]
Action: 301 = spline x & y parameters)
I1 == Dim0 = spline 8 (spline 0…21 possible)
I2 == Dim1 = spline control point 1 (control point 0 …5 possible)
0 Command
1 Status Request
2 Parameter write
3 Parameter read
- Command: A command has only influence of the next cycle. A command is not storable and cannot
read out (i.e.: Sensor-Reset)
- Status request: Sensor request for specific data, which the sensor shall send. (i.e.: Firmware
version)
- Parameter write: Changes a specific parameter value
- Parameter read: Read out a specific parameter. Nothing will be changed
- Parameter write/read: Changes a parameter and read it out after changing (verifying)
Hi-Byte Low-Byte
Details:
- UAT-ID: see Message 1 (Chapter 0)
- Message Index: see message 1 (Chapter 0)
- Parameter Data-Byte 0..4: parameter data
- Data Format: described the data format
0 Integer
1 Float (smartmicro)
3.1.1.1 EXAMPLE
Sent Parameter 201 as Action 2000, UAT v4:
Message1:
Byte 1..0: 0x07D0 = UAT ID == action number (2000)
Byte 2: 0x00 == Message Index
Byte 3: 0x04 == Format version number
Byte 4: 0xFF == Destination ID (0xFF == broadcast)
Byte 5: 0x01 == number of instructuions
Byte 7..6: 0x9550 == CRC checksum
Message2:
Byte 1..0: 0x07D0 = UAT ID == action number (2000)
Byte 2: 0x01 == Message Index
Byte 3: 0x02 == Message type (2== parameter write)
Byte 5..4: 0x00C9 == Param Number (=201)
Byte 7..6: 0x0000 == Dimensions
Message3:
Byte 1..0: 0x07D0 = UAT ID == action number (2000)
Byte 2: 0x02 == Message Index
Byte 3: 0x00 == Data Format (0= integer)
Byte 7..4: 0x00000001 == Value (=1)
Description:
Start Sequence Header Checksum Ident Length ____Data____ Checksum
Interpretation:
Table 3-4 Start-Sequence and Header with Checksum
Start Sequence Header CRC Header
Byte 0 Byte 0 Byte 1 Byte 2 Byte 3 Byte 4 Byte 5 Byte 6 Byte 7 Byte 8 Byte 9 Byte 10
0x7E 01 0C 00 21 04 00 00 00 00 04 76
Byte 1 Byte 0 Byte 0 Byte 0 Byte 1 Byte 2 Byte 3 Byte Byte Byte Byte 7
4 5 6
03 FB 08 D0 07 00 04 FF 01 50 95
03 FB 08 D0 07 01 02 C9 00 00 00
03 FB 08 D0 07 02 00 01 00 00 00
Byte 1 Byte 0
EE 7D
CRC calculation for the whole message without the CRC-16 value:
Table 4-2
DSP Status Meaning
4 DSP initiated break of the can load sequence (e.g., message counter incorrect)
or
Message-Specification sensor_control:
Message Type: sensor_control
Identifier: ID0 0x500
Format: Intel (little endian)
Time since Time since Time since Time since spare Source spare Sensor
sensor sensor sensor sensor Device status
start_3 start_2 start_1 start_0
(int)
= ID in the
network
Event indicator (Bit 0 to 3): Indicates that a diagnostic event occurred. (see diagnostic bits)
Message-Specification object_control:
Message Type: object_control
Identifier: ID0 0x501
Format: Intel (little endian)
Mode_Signal1 0 0 1 0 u1 0 0 0
Data explanation:
- Object length: Object length – representation of the detected vehicle class
o Each class has a predefined default length
o The classes will be encoded as follows:
Table 5-7 coded length of classes
Length Class Comment
Details:
- Object ID:
o Internal track / object ID
o All IDs are retained during lifetime of an object
Example:
Object messages: 0502 08 44 92 00 13 E10 03 9A 32
Table 5-8 HEX to binary number
Byte No. 0 1 2 3 4 5 6 7
ModBit 0 0x0 0 - 0
0 0…1 reserved - - - 2
Based on the mode signal within Bit14…16 the Statistic_Output_i has to be interpreted as follows:
Table 6-5 Mode Bits Value:0 Volume Count Output
Byte Bit Statistic_Output_i Resolution Offset Value Type Bits
Table 6-7 Mode Bits Value:2 Mode: 85th percentile Speed Output
Byte Bit Statistic_Output_i Resolution Offset Value Type Bits
Elements Message
Identifier: 0x786
DLC: 4
Source: UMRR sensor
Destination: Controller
Table 6-15 QUEUE APPLICATION OUTPUT DATA
Byte Bit Description Resolution Offset Values Bits
The response messages have the same identifier (0x700) and an additional UDT Index, in order to separate
the data payload.
The message scheme for UATv1 is 17000-17001-17002-17003-17000 in sequence. The messages are
described in the following tables.
Data explanation:
- Version number: (UAT version) 1, 2,3 or 4.
- u16_counter: sequential counter incremented at each parameter read in this cycle.
- Result:
o 0: no error
o 1: unspecified error
o 2: parameter not present
o 4: action not present
o 8: wrong device ID
(High Byte) (Low Byte) (High Byte) (Low Byte) (High-Byte) (Low-Byte)
Sensor Run Sensor Run Time Low Word (32 bit) 4 20 2003 Status Int
Time low (power cycle or restart resets the
timer)
Sensor Run Sensor Run Time High Word (32 bit) 4 21 2003 Status Int
Time high (power cycle or restart resets the
timer)
Tseg2: 7
Tsjw: 2
Presc: 1
Synchronization on one Edge only.
10.2 MAC
The software requires a hardware-specific device driver to control the MAC component. It is typically part
of the processor and part of the CSP. On MAC layer, each device must have a unique identification called
MAC address. The MAC address consists of two values, a fixed registered smartmicro identification and a
unique device number. The device MAC address is part of the OTP data of a device and set during
production. It is not possible to change the MAC address.
smartmicro Device#
MAC: 90-DF-B7-XX-XX-XX
10.3 IP
The software supports IPv4. Every device type has the same default IP, subnet mask and gateway. It is
possible to change those values of a device by parameterization. Optionally, the software has a DHCP
client feature for automatized IP distribution. The software also supports IP multicast for the Alive
(network discovery) feature.
Table 10-1: Parameterization IP level
Parameter Default Comment
The software resolve the IP addresses of other devices in the Alive network discovery setup.
10.4 UDP
The UDP packet interface and protocol implementation is the (proprietary) smartmicro transport protocol
[see chapter 11 smartmicro transport protocol], which features network discovery [2], logging [3] and CAN
message-based data exchange [4]. The data exchange requires an open UDP port for incoming datagrams.
TABLE 10-2: PARAMETERIZATION UDP LEVEL
Parameter Default Comment
Incoming UDP port 55555 Open port is 55555 in IANA free range 49152-65535 [6]
The software resolve the incoming UDP ports of other devices in the Alive network discovery setup.
Data Stream OBJECT_LIST Device sends the target list to a specific client ID.
Client ID 0x01000001
10.9
10.9
10.9 ALIVE PROTOCOL
10.9.3 TIMING
- A client shall send an Alive message not more than once every tALIVE_PERIOD.
- A client should send Alive messages with an interval as close to tALIVE_PERIOD as possible.
- When a client receives an Alive message from another client, it shall consider this client active for
at least tALIVE_TIMEOUT_MIN and no longer than tALIVE_TIMEOUT_MAX.
- When a client receives an Alive message from another client, it should consider this client active for
a time as close to tALIVE_TIMEOUT_MIN as possible.
tALIVE_PERIOD = 1s
tALIVE_TIMEOUT_MIN = 5s
tALIVE_TIMEOUT_MAX = 10s
10.9.4 HEADER
Table 10-4: Protocol Header
Byte offset Data words
VERSION MAJOR
Size: 1 byte
Format: Unsigned integer
Range: 1 … 255
Description: The major version of the protocol.
VERSION MINOR
Size: 1 byte
Format: Unsigned integer
Range: 0 … 255
Description: The minor version of the protocol.
10.9.5 BODY
Table 10-5: Data of the Body
Byte Offset Byte 0 Byte 1 Byte 2 Byte 3
0 Client ID
4 IP v4 address
CLIENT ID
Size: 4 byte
Format: Unsigned integer
Range: 0 … (232 – 1)
Description: The Smartmicro client ID.
IP V4 ADDRESS
Size: 4 byte
Format: Unsigned integer
Range: 0 … (232 – 1)
Description: The IP v4 address of the device in 32-bit representation.
UDP PORT
Size: 2 byte
Format: Unsigned integer
Range: 1 … (216 – 1)
Description: The open UDP port for incoming UDP datagrams.
Table 11-2: Application protocol types (APT) defined for smartmicro transport protocol
APT Description
Bit63
11.1.8 FLAGS
The flags field is mandatory in protocol version 1 and 2 if optional information is added to the header. The
bits in the 32-Bit flag value define whether parts of the optional header are present (1) or not (0). If more
than one flag is activated, the content is attached in the following order:
Table 11-4: Header Flags
Flag Name Added Header Content
5…31 Reserved -
11.1.10 TIMESTAMP
The timestamp is a 64-Bit UTC time, and the format is given by the NTP standard. The timestamp is
optional and can be activated by the corresponding flag via the flag field.
For the 16-Bit CRC calculation CCITT (polynom X^16 + X^12 + X^5 + 1), the start value is always 0xFFFF.
The CRC is calculated over the complete payload block.
Every data message consists of its own message ID, the number of used data bytes, and the data bytes
themselves. The message decoding is described earlier in this document.
1 Low
10
7E 01 0C 00 6E 04 00 00 00 00 AB 65
05 00 08 10 00 00 00 3A 12 06 00 05 01 08 14 01 4B 07 B8 14 00 00 05 02 08 BE E1 F5 23 23 00 8D 00 05
03 08 F6 E2 F5 23 23 00 8D 01 05 04 08 2E E4 F5 23 23 00 8D 02 A6 31
Description:
Start Sequence Header CRC
Ident Length ____Data____Ident Length ____Data____Ident Length ____Data____Ident Length
____Data____Ident Length ____Data____ CRC
Interpretation:
Table 11-6: Interpretation example of the Header block
Start Sequence Header CRC Header
Byte 0 Byte Byte Byte Byte Byte Byte Byte Byte Byte Byte Byte
0 1 2 3 4 5 6 7 8 9 10
0x7E 01 0C 00 6E 04 00 00 00 00 AB 65
Byte 1 Byte 0 Byte 0 Byte 0 Byte 1 Byte 2 Byte 3 Byte 4 Byte 5 Byte 6 Byte 7
05 00 08 10 00 00 00 3A 12 06 00
05 01 08 14 01 4B 07 B8 14 00 00
05 02 08 BE E1 F5 23 23 00 8D 00
05 03 08 F6 E2 F5 23 23 00 8D 01
05 04 08 2E E4 F5 23 23 00 8D 02
CRC Payload
Byte 1 Byte 0
A6 31
7E 01 14 00 21 04 00 00 00 18 01 00 00 01 00 02 C3 D5 39 9A 03 FB 08 D0 07 00 04 FF 01 50 95 03 FB 08
D0 07 01 02 C9 00 00 00 03 FB 08 D0 07 02 00 01 00 00 00 EE 7D
Description:
Start Sequence Header Checksum Ident Length ____Data____ Ident Length ____Data____ Ident Length
____Data____ Checksum
Interpretation:
Table 11-8: Interpretation example of the Start Sequence
Start Sequence
Byte 0
0x7E
01 14 00 21 04 00 00 00 18 01 00 00 01 00 02 C3 D5
Byte 9 Byte 10
39 9A
Byte 1 Byte 0 Byte 0 Byte 0 Byte 1 Byte 2 Byte 3 Byte 4 Byte 5 Byte 6 Byte 7
03 FB 08 D0 07 00 04 FF 01 50 95
03 FB 08 D0 07 01 02 C9 00 00 00
03 FB 08 D0 07 02 00 01 00 00 00
Byte 1 Byte 0
EE 7D
Not all products and/or product features may be available in all countries and regions. For legal reasons features may be deleted from
products or smartmicro may refuse to offer products. Statements, technical information and recommendations contained herein are believed
to be accurate as of the stated date. smartmicro disclaims any and all liability for any errors, inaccuracies or incompleteness contained in this
document or in any other disclosure relating to the product.
To the extent permitted by applicable law, smartmicro disclaims (i) any and all liability arising out of the application or use of the product or
the data contained herein, (ii) any and all liability of damages exceeding direct damages, including - without limitation - indirect, consequential
or incidental damages, and (iii) any and all implied warranties, including warranties of the suitability of the product for particular purposes.
Statements regarding the suitability of products for certain types of applications are based on smartmicro’s knowledge of typical requirements
that are often placed on smartmicro products in generic/general applications. Statements about the suitability of products for a
particular/specific application, however, are not binding. It is the customer’s/user’s responsibility to validate that the product with the
specifications described is suitable for use in the particular/specific application. Parameters and the performance of products may deviate
from statements made herein due to particular/specific applications and/or surroundings. Therefore, it is important that the customer/user
has thoroughly tested the products and has understood the performance and limitations of the products before installing them for final
applications or before their commercialization. Although products are well optimized to be used for the intended applications stated, it must
also be understood by the customer/user that the detection probability may not be 100% and that the false alarm rate may not be zero.
The information provided, relates only to the specifically designated product and may not be applicable when the product is used in
combination with other materials or in any process not defined herein. All operating parameters, including typical parameters, must be
validated for each application by the customer’s/user’s technical experts. Customers using or selling smartmicro products for use in an
application which is not expressly indicated do so at their own risk.
This document does not expand or otherwise modify smartmicro’s terms and conditions of purchase, including but not being limited to the
warranty. Except as expressly indicated in writing by smartmicro, the products are not designed for use in medical, life-saving or life-sustaining
applications or for any other application in which the failure of the product could result in personal injury or death.
No license, expressed or implied, by estoppel or otherwise, to any intellectual property rights is granted by this document or by any conduct of
smartmicro. Product names and markings noted herein may be trademarks of their respective owners.
Please note that the application of the product may be subject to standards or other regulations that may vary from country to country.
smartmicro does not guarantee that the use of products in the applications described herein will comply with such regulations in any country.
It is the customer’s/user’s responsibility to ensure that the use and incorporation of products comply with regulatory requirements of their
markets.
If any provision of this disclaimer is, or is found to be, void or unenforceable under applicable law, it will not affect the validity or enforceability
of the other provisions of this disclaimer.