Introduction
ICD-002 is a network communication protocol based on XML. The protocol is used over standard TCP/IP client-server connections. It is used by the Swedish Transport Administration - Trafikverket.
Here is a PDF of the protocol documentation:
View file | ||
---|---|---|
|
Info |
---|
For customers and integrators intending to use ICD-002, the documents assume a reasonable working knowledge of network communications, XML and XSD. They are targeted at technical teams, typically with software development skills, who are integrating the output from ClearWay™ into external systems. |
...
The data is transmitted as the events occur, leading to real time reporting.
...
Configuring the ICD-002 Plugin
Witness supports integration with many different types of external systems through the use of plugins. These are stand-alone software libraries which are dynamically loaded by the Integration Manager and contain code which know how to convert the Witness data into the required format for the external system. Navtech Radar can easily develop bespoke plugins to interface with a specific type of equipment or application, however, ICD-002 has been developed to provide a comprehensive communication protocol which is based on open standards in order to make it as easy as possible to integrate with a large number of different systems.
Tip |
---|
The plugin can be selected during setup and will automatically be installed in the correct location. |
When installing ClearWay™, in the Choose Components page of the ClearWay™ Setup wizard, open Integration Plugin options and select ICD002:
Configuring the ICD-002 Plugin
When the plugin is installed and licensed, a plugin configuration with default settings is automatically generatedThe ICD-002 Plugin will appear as a node under the Integration Configurations folder within the Configuration Tree. The settings can be viewed and edited by enabling the Config Function, then selecting the plugin in Integration Configurations, within the Configuration Tree. Configuration settings will then be available in the Configuration Panel.
...
Info |
---|
Once you have made changes to the plugin configuration and committed the changes by saving, the plugin will automatically restart itself based on the new configuration. Note that any connections to 3rd party systems will be dropped during this restart. |
...
Status Transmission Interval (s): The interval at which the system sends Status reports.
Alarm Severity: The severity is an alarm filter. Only alarms of this severity or higher will be reported. Choose from from Unknown, Friend, Warning or Threat.
Sending ICD-002 Alarm Reports
...
The following table provides the equivalent settings for each ICD-002 alarm type:
Alarm Number | ICD-002 Alarm | Simulator Settings | Notes |
---|---|---|---|
1 | Slow Vehicle | Sub Type: Slow Classification: N/A | Highways Alarm |
2 | Stopped Vehicle | Sub Type: Stopped Classification: N/A | Highways Alarm |
3 | Reversing Vehicle | Sub Type: Reversing Classification: N/A | Highways Alarm |
4 | Person in the Road | Sub Type: Default Classification: Person | Highways Alarm |
5 | Debris in the Road | Sub Type: Debris Classification: Debris | Highways Alarm |
6 | Queue End | Sub Type: Queue Classification: N/A | Highways Alarm |
7 | Not connected | Health Type: PingTime Health Source: Radar | Health Alarm |
8 | Low Packet Rate | Health Type: PacketRate Health Source: Radar | Health Alarm |
9 | Low / High Temperature | Health Type: Temperature Health Source: Radar | Health Alarm |
10 | Low / High Rotation Speed | Health Type: Rotation Health Source: Radar | Health Alarm |
Status Report
The Status Report documentation is covered in the PDF protocol documentation (located in the Introduction https://navtechradar.atlassian.net/wiki/spaces/TUN/pages/edit-v2/2301231117#Introduction at the top of this page.
Here is an example ICD-002 status report which includes the InUse message and the Type which displays if the sensor is connected:
Code Block |
---|
<StatusReport xmlns:xsi="http://www.w3.org/2001/XMLSchema-instance" xmlns:xsd="http://www.w3.org/2001/XMLSchema" Reported="2024-07-24T09:27:01.2637384+01:00" SystemId="1" xmlns="ICDNAV002-StatusReport">
<Status SensorId="7" InUse="false" Type="NotConnected" />
<Status SensorId="10" InUse="false" Type="NotConnected" />
<Status SensorId="3" InUse="true" Type="Connected" />
<Status SensorId="11" InUse="false" Type="NotConnected" />
<Status SensorId="18" InUse="false" Type="NotConnected" />
<Status SensorId="17" InUse="false" Type="NotConnected" />
<Status SensorId="16" InUse="false" Type="NotConnected" />
<Status SensorId="6" InUse="true" Type="Connected" />
<Status SensorId="4" InUse="true" Type="Connected" />
<Status SensorId="13" InUse="false" Type="NotConnected" />
<Status SensorId="20" InUse="false" Type="NotConnected" />
<Status SensorId="8" InUse="false" Type="NotConnected" />
<Status SensorId="1" InUse="true" Type="Connected" />
<Status SensorId="19" InUse="false" Type="NotConnected" />
<Status SensorId="5" InUse="true" Type="Connected" />
<Status SensorId="12" InUse="false" Type="NotConnected" />
<Status SensorId="2" InUse="true" Type="Connected" />
<Status SensorId="15" InUse="false" Type="NotConnected" />
<Status SensorId="9" InUse="false" Type="NotConnected" />
<Status SensorId="14" InUse="false" Type="NotConnected" />
</StatusReport> |
...
Related Information
Filter by label (Content by label) | ||||||||
---|---|---|---|---|---|---|---|---|
|