OSS4ITS Reference Implementation – Test Plan

Chapter 1. Introduction

This document presents the test scenarios that will be used to verify reference implementation of Open Source Software for Intelligent Transportation Systems (OSS4ITS) software suite to demonstrate the full functionality of the software system as part of the OSS4ITS project sponsored by the Office of Operations Research and Development (HRDO), Federal Highway Administration (FHWA). The Leidos team will confirm the performance standards are met as documented in this test plan based on project documentation and input from team members.

Purpose and Objective

This Reference Implementation Test Plan presents the test methods that shall use OSS4ITS Software suite of applications including V2X Hub, ODE, SDC and CARMA components e.g., CARMA Platform, CARMA Cloud, and CARMA Messenger to demonstrate the full functionality for the Work Zone Data Exchange use case. Leidos will establish connections between the Work Zone Data Collection tool, CARMA Cloud, CARMA Platform, V2X Hub, Operation Data Environment, and SDC as defined in the OSS4ITS architecture and will stand up the reference implementation on the TFHRC Cloud. This plan ensures hardware, software and functional requirements have been met in order to demonstrate the Work Zone Data Exchange use case successfully.

This plan may be modified to incorporate comments or contributions or findings from FHWA and the OSS4ITS software team. It is expected that the use case may evolve through the course of design, development, implementation, and testing. Therefore, the Test Plan should be modified to capture the changing requirements during the agile development life cycle. In addition, the test cases defined here may also be later refined as needed based on the outcome of the verification testing.

TEST VERIFICATION AND SCOPE

The scope of this document is limited to testing of the vehicle features and infrastructure applications under the Work Zone Data Exchange use case. This test plan represents the latest agreed-to scenarios with FHWA and Leidos. In addition, this test plan documents the test approach, methodology, roles and responsibilities, schedule, equipment, facilities, and test cases for each work zone scenario.

Leidos will use the fleet of FHWA automated passenger cars to verify functionality for the Work Zone Data Exchange use case.

The Leidos team shall work together with FHWA to gather their inputs into this plan. Leidos shall respond to answer any questions and incorporate any changes resulting from peer reviews or discussions.

The success of the verification testing will be based on the successful demonstration of the individual use case scenarios without any severity one issues. All issues must be addressed, and the resolutions agreed upon. Table 1 below shows the task breakdown and participation of various teams in executing these tasks.

Table 1. Organization Task Breakdown

Task

Leidos

FHWA

Verification Test Plan Development

X

 

Verification Test Plan Peer Review

X

X

Verification Testing Logistics and Coordination

X

 

Verification Testing Readiness Review

X

X

Verification Testing Execution

X

 

Verification Test Results Documentation

X

 

 

Chapter 2. Test Approach

Leidos is working with FHWA to identify the list of features that need to be verified and tested for each of the Work Zone Data Exchange use case scenarios. Each test case shall include a high-level description of the use case scenario, its ODD, its targeted test facility, its sequence of events, and it’s high-level list of features to be tested. It will describe the cooperation that can take place between an equipped vehicle and other vehicles, roadside equipment, and Transportation Management Services (TMS).

In addition, Leidos reviewed the National Highway Traffic Safety Agency (NHTSA) pre-published version for “A Framework for Automated Driving System Testable Cases and Scenarios” for ADS test case/evaluation guidance and approaches. From this NHTSA documentation, the test case template has been updated to include the following elements, specific to each test scenario based on the test site availability.

Operational Design Domain (ODD) – An ODD describes the specific operating domain(s) in which an ADS feature is designed to function with respect to roadway types, speed range, lighting conditions (day and/or night), weather conditions, and other operational constraints. ODD will likely vary for each ADS feature, even if there is more than one ADS feature on a vehicle.

Object and Event Detection and Response (OEDR) – OEDR refers to “the subtasks of the DDT that include monitoring the driving environment (detecting, recognizing, and classifying objects and events and preparing to respond as needed) and executing an appropriate response to such objects and events (i.e., as needed to complete the DDT and/or DDT fallback)” (SAE International, 2016).

Leidos shall provide the final draft of the verification test plan to GTM for review, in order to communicate the final features being developed for each Work Zone use case and potentially leveraged to develop their own validation test plan.

Documentation

A Verification Test Report shall be compiled to summarize the test results and identify outstanding issues. Failures, as well as any deviations or workarounds, will be recorded.

Assumptions and Constraints

The bulleted list below explains the assumptions and/or constraints expected prior to the testing or demonstration:

  • Test personnel have at least a basic understanding of the CARMA platform in both configuration and troubleshooting

  • Test personnel are properly trained and licensed to operate CARMA vehicles

  • The test is conducted in at a legal, controlled, and safe environment

Test Evaluation

Each test case shall be recorded with a pass or fail in the test report. All failures, as well as any deviations from the procedure or workarounds, will be recorded as well with severity levels defined below. Each test case needs to pass based on back to back testing or 2 out of 3 runs, unless otherwise specified.

Severity

Definitions

1

Prevent the accomplishment of an essential/critical capability.

Causes severe disruption, and results in the permanent absence of one or more required features of the system, and no work around is known.

Jeopardize safety, security, or another requirement.

2

Adversely affect the accomplishment of an essential capability but a work-around solution is known.

Causes major disruption of access to one or more required features of the system.

3

Causes minor disruption of access to one or more required features of the system.

4

Result in user/operator inconvenience or annoyance but does not affect a required operational or mission-essential capability.

 

As mentioned in the scope, this test plan represents the latest agreed-to-scenarios with FHWA and Leidos. Therefore, there may be some deviations between the test plan and requirements for the individual use cases and scenarios.

Chapter 3. Test Schedule and Personnel

This section contains a high-level test schedule, personnel required to execute the tests, and a description of several documents that should be used to record test activities and results.

Test Schedule

The verification testing of each of the Work Zone Data Exchange use case scenarios shall occur at USDOT TFHRC as agreed upon with the client. The targeted dates and order of the verification testing of each of the use cases could be adjusted based on development schedule and particular circumstances.

Table 2. Work Zone Data Exchange Scenario Testing Schedule

Scenario

Test Facility

Leidos Verification Testing

Validation Testing

Work Zone Management (WZM)

TFHRC

TFHRC

TFHRC

 

The daily schedule of activities during verification testing shall be discussed at least a week prior to the event. The schedule shall describe the anticipated daily activities, including an estimated duration and assignments of each task, if possible. During the week of testing, there shall be a daily team wrap up to discuss the accomplishments, issues and plans for the day. The schedule will be reviewed or adjusted daily based on the team’s progress. Some activities may not be necessary or may be carried out concurrently. The test schedule assumes no interruption of testing activities due to weather or any other unexpected delays.

An example schedule can be seen below. The test team should move down the test plan from top to bottom. This will ensure that new functionality is tested only after the technologies it depends on are deemed safe and acceptable. The below schedule only serves as an initial sample guide and does not account for changes in testing conditions such as needing to switch locations or adverse weather. A separate spreadsheet shall be used for the official schedule.

Table 3. Example Daily Testing Schedule

Time

Monday

Tuesday

Wednesday

Thursday

Friday

8am – 9am

Arrival and setup at the test facility.

 

Review testing prioritization and schedule.

 

Safety Inspection

 

Review testing prioritization and schedule.

 

Safety Inspection

 

Review testing prioritization and schedule.

 

Safety Inspection

 

Review testing prioritization and schedule.

 

Safety Inspection

 

Review testing prioritization and schedule.

 

Safety Inspection

 

9pm - 4pm

Verification Testing

Verification Testing

Verification Testing

Verification Testing

Verification Testing

4pm – 5pm

Daily Tag-up to review results and action items

Daily Tag-up to review results and action items

Daily Tag-up to review results and action items

Daily Tag-up to review results and action items

Daily Tag-up to review results and action items

 

Departure and tear down at the test facility.

The procedures for the safety inspections shall be developed prior to the test event on a separate document. The safety inspection shall include the in-stock and after-market hardware visual inspections, sensor calibration checks, vehicle controller and application safety overrides, and test facility operational basic safety procedures.

Personnel

The following staff is anticipated to complete the activities in the estimated amount of time listed in Chapter 3. Test Schedule and Personnel. Listed below are the general personnel required for executing the test verification plan and documenting its results.

NOTE: Some roles except for the Vehicle Operator/Safety Driver may be combined such that a single person can assume multiple roles for an individual test case.

Test Lead

The designated Test Lead will make final decisions on pass/fail criteria of individual test cases, based on reports from the Data Recorder/Tester. Additionally, the Test Lead will be responsible for overseeing the overall test schedule, prioritizing the tasks and test cases, and communicating support needs with supporting organizations.

Vehicle Operator/Safety Driver

The Vehicle Operator will be responsible for safe operation of the vehicle throughout the test runs, including during test set-up, experimental runs, and post-test activities. Vehicle Operators shall hold a valid driver’s license for the class of the vehicle, may be trained in advanced vehicle control techniques, and shall be oriented to the special situations they will face during testing. The Vehicle Operator shall expect to receive instructions on test execution and expectations from the Tester and shall report any confusion or concerns both before and during the tests to all involved parties.

The operator will wear a seat belt at all times, remain alert for direction from Traffic Safety Controllers on the roadside (if any), and be responsible for compliance with traffic law at all times. The operator shall refrain from using cell phones or other handheld wireless communication devices while driving, except for communications with others in the test team directly related to the execution of those tests. The operator will be responsible for confirming the selected parameters to the Data Recorder for each test run, validating the entrance criteria, verifying the readiness of test equipment, and announcing the start and end of each test run. The operator will narrate any relevant observations during testing for the Data Recorder to ensure that any test irregularities or results are properly documented.

At all times, the operator will be responsible for navigating incidents, exceptions, cancellations, or re-scheduling tests in the event of a failure that prevents a test from being executed.

Passenger/Observer

The Passenger may occupy a seat of the test vehicle during testing activities to monitor the user interface of the application. The Passenger will wear a seatbelt at all times and remain alert for any discrepancies in the expected application performance and notify the operator if a manual override is necessary.

Data Recorder

The Data Recorder is responsible for recording the outputs and overall results of each test. The data recorder will wear a seatbelt at all times and ride in either the back or front of the vehicle with a copy of the test cases. The data recorder will read out test instructions and write down results as dictated by the operator. The Data Recorder shall be responsible for making an initial assessment of whether the test was successful. However, the data recorder will provide all observations to the Test Lead at the end of the test day for final confirmation of test success or resolution of failed tests.

Tester

The Tester will coordinate the different scenarios or operations that need to be tested during each run to each Vehicle Operator. The Tester shall confirm all the configuration parameters that need to be implemented on the vehicles before the start of each run. Additionally, the Tester shall be responsible for instructing the Vehicle Operator on test execution plans and expectations of results. The Tester can choose to sit at the back or front of the vehicle and can also assume the role of Passenger and/or Data Recorder.

Software Engineer

The Software Engineer is responsible for supporting any software or configuration issues during the test run. The Software Engineer can be asked to ride in the vehicles to support testing and troubleshoot any issues/anomalies on the spot. The Software Engineer can choose to sit at the back or front of the vehicle, and can also assume the roles of Passenger, Tester and/or Data Recorder. During debugging/troubleshooting, the Software Engineer can redeploy software or change configuration parameters before the start of each run.

Traffic Safety Monitor

If a test is occurring in an area where traffic may be present, then a project team member will work outside of any test vehicle, wear a reflective vest, and block or monitor traffic as necessary for the test to be executed safely. This person must have an easy means of communicating with someone inside the vehicle to help coordinate test execution such as to alert the safety driver of a conflict using a 2-way radio.


Chapter 4. Test Environment

The FHWA has selected TFHRC as the site to conduct the Work Zone Data Exchange use case scenario demonstration as described in Chapter 3 Test Schedule and Personnel.

Although use cases studied may cover a spectrum of conditions, the Leidos team will limit the testing on closed test tracks, at daylight and in mild weather. At this time, there are no plans of performing any of the described tests on public roads.

Prior to conducting tests, the test environment should be inspected for safety, all hardware and software required to execute the test cases are readily available, and no other barriers exist that would prevent a proper demonstration of the vehicle capabilities.

For the physical and safety inspections, the vehicle should be positioned in the well-lit area and stationery in order to visually inspect the interior and exterior of the vehicle’s in-stock and after-market hardware installed prior to conducting the tests.



Test Facility

The Turner-Fairbank Highway Research Center (TFHRC) has been selected as the test facility for these tests. Its ODD constraints are described in the subsections below.

Name: Turner-Fairbank Highway Research Center (TFHRC)
Address: 6300 Georgetown Pike, McLean, VA 22101

Source: Google

Figure 1. Turner Fairbank Highway Research Center Campus

ODD – Physical Infrastructure

ODD Elements

Examples

Roadway Types

two-lane, one way taper work zone

Roadway Surfaces

asphalt

Roadway Edges and Markings

shoulder (paved), curb, cones

Roadway Geometry

straightaways, curves, hills

 

ODD – Operational Constraints

ODD Elements

Description

Minimum Speed Limit

5 MPH

Maximum Speed Limit

25 MPH

Traffic Density

Low traffic

Automated Vehicles

Allowed

 

ODD – Objects

ODD Elements

Description

Signage (Signs (e.g., stop, yield, pedestrian, railroad, school zone, etc.), traffic signals (flashing, school zone, fire department zone, etc.), crosswalks, railroad crossing, stopped buses, construction signage, first responder signals, distress signals, roadway user signals, hand signals)

Cones or Construction Equipment (if available), Dummy Construction Workers (if available)

Roadway Users (Vehicle types (cars, light trucks, large trucks, buses, motorcycles, wide-load, emergency vehicles, construction equipment, horse-drawn carriages/buggies), stopped vehicles, moving vehicles (manual, autonomous), pedestrians, cyclists)

Any vehicles

Non-roadway User Obstacle/Objects (Animals (e.g., dogs, deer, etc.), shopping carts, debris (e.g., pieces of tire, trash, ladders), construction equipment, pedestrians, cyclists)

None expected or shall be used during this testing.

 

ODD – Environmental Conditions

ODD Elements

Description

Weather (e.g., wind, rain, snow, sleet, temperature)

Clear and calm (Preferred scenario)

Light rain is tolerable

Light wind is allowed, but high-speed gusts must be avoided.

No falling snow or sleet or icy roads

A small amount of liquid water, slush or packed snow on roadway is acceptable

Weather-induced Roadway Conditions

None

Particulate Matter (e.g., fog, smoke, smog, dust/dirt, mud)

None. Clear visibility.

Illumination

Day

 

ODD – Connectivity

ODD Elements

Description

Vehicles

Cellular, DSRC, C-V2X allowable

Traffic Density Information (e.g., crowdsourced data (e.g., Waze) and V2I)

N/A

Remote Fleet Management System (supported by remote operation)

N/A

Infrastructure Sensors and communications (e.g., WZ alert, VRUs, GPS, 3-D high-definition maps, weather data, data on cloud)

RSU, GPS, 3-D high-definition maps

 

ODD – Zones

ODD Elements

Description

School/Construction Zones

N/A

Traffic Management Zones

Work Zone

Geo-Fencing

TFHRC campus

 

Test Vehicles

One CARMA vehicle is ADS Level 3+ capable as enabled by the CARMA Platform and equipped with an OBU to exchange messages with other vehicles and CARMA Cloud. It has a human machine interface that indicates current status and alerts to the vehicle operator and test engineer.

More information about these vehicles can be found on the CARMA Confluence page, specifically in the CARMA Vehicle Specification Brochure found in the Brochures section (link can be found in the references section).

 

Chapter 5. Test Data Collection, Analysis and Processing

Refer to the CARMA V3 Data Management Plan (DMP) that describes what data will be acquired or produced, how data will be collected and managed, and what mechanisms will be used to appropriately share and preserve the data with USDOT during and after the course of the research project. This DMP identifies the organizations, tools, and functions necessary to carry out effective data management for its stakeholders.

 

Chapter 6. Test Scenario Overview

This chapter provides an overview of the Work Zone Data Exchange use case to be executed, in order to establish the general approach to verifying each scenario.

Overview

Title: ADS-Equipped Vehicle Navigating a Two-Lane, One-Way Traffic Taper Work Zone

The subject of this situational analysis is an ADS feature who’s specified ODD includes operation of ADS-equipped vehicles safely navigating a work zone on a two-lane roadway with one lane blocked. A work zone will be designated on a one way two-lane roadway on the WZDC tool. A segment of the travel lanes shall be blocked with cones used to signify the construction area. The CARMA vehicle shall start from a predetermined static starting location before the work zone and engage CARMA “Route Following” by selecting a route. The vehicle will travel in the direction towards the work zone and begin broadcasting its route via DSRC in the form of a MobilityPath message and a Traffic Control Request for traffic rules. This TCR will be received by the RSU, sent to V2X Hub, which will forward it to CARMA Cloud. CARMA Cloud will return all known traffic rules associated with incidents (including those from the WZDC tool) and return these to V2X Hub in the form of TCMs. V2X Hub then sends the TCM to the RSU which is broadcast via DSRC. These TCMs are received by the vehicle and the route is adjusted to avoid the blocked lane. The vehicle will continue through the work zone, navigating around the closed lane. As the vehicle travels through the work zone, it will be broadcasting BSMs. These BSMs will be broadcast via DSRC, received by the RSU, and forwarded to the V2X Hub. The V2X Hub then forwards these BSMs to ODE, which then sends them to SDC. SDC receives these BSMs and converts them to a kml file to be viewed.

ODD Characteristics

In addition to the test facility ODD, the following supersedes:

  • Maximum Speed limit of 25 MPH

  • Maximum work zone speed limit of 10MPH

  • Two-lane, one-way arterial street (or similar)

  • An HD map describing the normal road geometry and traffic controls

 

OEDR Characteristics

  • Objects

    • Cones or Construction Equipment (if available)

    • Dummy Construction Workers (if available)

  • Signs and Signals

    • Traffic Signal

    • Geofencing

Key Features

WZDC Tool

  • Generate work zone configuration in the WZDC web interface.

  • Download configuration to vehicle to drive work zone to generate GPS “breadcrumb” and mark lane closures and workers present.

  • Upload breadcrumbs to the WZDC web interface.

  • Verify work zone lane closures and workers present and publish.

CARMA Cloud

  • Work Zone Management RSM (XML format) download from WZDC tool REST endpoint.

  • TCMs generated from RSM XMLs and displayed on web interface

CARMA Platform

  • The CARMA vehicle broadcasts a TCR message from its OBU via DSRC containing the bounding box of the route it plans to drive.

  • The CARMA vehicle receives the TCM message in response to the TCR, reduces its speed appropriately and drives around the work zone area, switching lanes to the lane that is open. The following features from CARMA Core ADS will be displayed:

    • Cooperative Lane Coordination (CLC) – Lane Change

V2X Hub

  • Receives TCR messages from CARMA vehicle and forwards them to CARMA Cloud

  • Receives TCM messages from CARMA Cloud and forward them to RSU.

  • Receives BSM messages from the vehicle via the RSU and forward them to ODE.

ODE (Operational Data Environment)

  • Receives BSM messages from the V2X Hub and sends them to SDC.

SDC (Secure Data Commons)

  • Receives BSM messages from ODE for analysis and KML file generation.

 

Failure Behaviors

  • Unable to demonstrate the features listed above.

  • Unable to demonstrate the sequence of events described below.

  • Severity one issues or anomalies occur that prevent the proper execution and completion of the use case demonstration.

 

Test Route

The test route for this use case at TFHRC can be found in Figure 2.

Source: V2X TMC Data Collection Website

Figure 2. Work Zone Management Scenario Testing Route

Equipment

  • One CARMA vehicle

  • Cones or dummy construction equipment

  • RSU on the infrastructure, connected to local network

  • V2X Hub, connected to the local network and CARMA Cloud

 

Test Cases

Test Case RI-01

Test Case #

RI-01

Test Case

Work Zone Data Collection Tool Configuration

Objective

Create, verify, and publish a work zone on the WZDC tool

Entrance Criteria

The WZDC tool is online and accessible

 

There are no active work zones on the selected Test Route

 

A vehicle equipped with a GPS is available to drive the Test Route

 

A laptop is available with the Work Zone Data Collection Toolset installed and the GPS is connected to the laptop

Data Inputs

Work zone details, GPS data

Data Outputs

RSM XML

Exit Criteria

The work zone is published and the RSM xml is accessible

Test Procedures

Step Description

Expected Outcome

1

Navigate to the WZDC tool website:

 

neaeraconsulting.com/v2x_home

 

The WZDC tool website is displayed (V2X TMC Data Collection Website)

2

Click Configuration Creator under V2X WorkZone Data Exchange

The Configuration Creator is shown

3

On the WZDC tool website under “Configuration File”, fill in “Work Zone Description” and “Road Name” and verify that the file name matches the file name updates accordingly.

Work zone description and road name are filled in and the file name is correct.

4

At the bottom of the screen, click the Next button.

 

The Configuration Data tab is displayed.

5

Under “Lane Information”, set the following values:

 

Number of Lanes: 2

Vehicle Path Data Lane: 1

The Lane Information values are set.

6

Under “Speed Limits”, set the following values:

 

Normal Speed: 30

At the Ref. Point: 20

When Workers are Present: 10

The Speed Limits values are set.

7

Under “Start Date”, select today’s date and under “Start Time” select a time before the current time.

The Start Date and Start Time are set.

8

Under “Days of Week”, select all days.

The Days of Week value is set.

9

Under “End Date”, select tomorrow’s date and under “End Time” enter 12:00:00.

The End Date and End Time are set.

10

Click the Next button.

The Map Location tab is displayed.

11

In the search box, type TFHRC and select the first option.

The map is centered on TFHRC.

12

Click on the map at the desired start location to place the beginning marker for the workzone and click again to place the end marker.

The workzone start and end points are set along a road at TFHRC.

13

Click the Next button.

The Additional Information tab is displayed.

14

Under “Event Status” select Active. The direction property is to describe the direction of traffic. Other fields on this page are optional and can be filled if needed.

The Event Status isset to active.

15

Set the Direction property to the desired direction of traffic.

The Direction is set.

16

Click the Next button.

The Lane Options tab is displayed.

17

Under “Lane Types”, set Lane Number 1 to left-lane and Lane Number 2 to right-lane.

The Lane Types are set.

18

Click the Next button.

The Metadata tab is displayed.

19

Fill in the required fields (as shown by a red asterisk).

The required fields under metadata are filled out.

20

Click the Save button at the bottom of the screen.

The work zone configuration is saved and the user is returned to the Configuration File tab.

21

Under the existing configuration files in the left panel, select the created work zone and click the Publish button at the bottom of the screen.

The work zone configuration is published and appears in the right panel.

22

Under the published configuration files in the right panel, select the published work zone and click the Download File button at the bottom of the screen.

The configuration file json is downloaded.

23

Get into the vehicle and connect the GPS to the laptop.

The GPS is connected.

24

On the laptop, open a console window and navigate to the Work_Zone_Data_Collection_Toolset/Work Zone Data Collection Tool directory.

The Work Zone Data Collection Tool directory is opened and contains the python WZDC_tool.py.

25

Run the script with python WZDC_tool.py using the command:

 

python WZDC_tool.py

The WZDC tool is started.

26

Click “Choose Local Config File” and select the downloaded configuration.

The configuration file is uploaded and the tool indicates “GPS DEVICE IS FOUND”.

27

Drive the vehicle to a point well before the work zone begins.

The vehicle is stopped well before the work zone.

28

Click “Begin Data Collection” and drive in the open lane of the work-zone.

Bread crumb data is collected and saved when the vehicle enters the work zone

29

Click the Lane 2 button at the beginning of the desired lane closure and again and the end of the desired lane closure.

The lane closure is captured.

30

Continue driving until the end of the work zone is reached.

When the vehicle reaches the end of the work zone, the WZDC tool will exit and save the bread crumb data to a csv in the WZ_VehPathData directory.

31

On the WZDC website, navigate to the Upload tab and click the Upload button to upload the collected csv data.

The csv file is successfully uploaded to the website.

32

On the WZDC website, navigate to the “Verification” tab, select your work zon, and click load visualization.

A RSM map should pop up and show the work zone information.

33

If the work zone needs to be edited, make the appropriate changes and click Verify Markers, Confirm Edit, and Save Work Zone.

The work zone data should be successfully published.

34

Click Verify Work Zone Data and Publish.

The work zone is published

35

On the WZDC website, go to the “Published” tab and select the published work zone.

The published work zone is displayed.

36

Check the box for XML Roadside Safety Message and click Download Workzone Data.

The RSM XML is downloaded.

 



Test Case RI-02

Test Case #

RI-02

Test Case

Work Zone Data Collection Tool to CARMA Cloud Interface

Objective

Verify CARMA Cloud can receive RSM XMLs from the WZDC tool and display them on the CARMA Cloud interface

Entrance Criteria

The WZDC tool is online and accessible by CARMA Cloud

 

CARMA Cloud is online and accessible by the WZDC tool

 

There is an active work zone in the WZDC tool

Data Inputs

RSM XML

Data Outputs

CARMACloud lane closure visualization

Exit Criteria

The work zone is visible on the CARMA Cloud interface

Test Procedures

Step Description

Expected Outcome

1

Navigate to the “Published” tab of the WZDC website, find the created work zone and select it.

The created work zone is correctly visualized on the website map.

2

Start an SSH session with CARMA Cloud.

A SSH session is opened with the CARMA Cloud instance.

3

Open the log file /opt/tomcat/logs/carmacloud.log search for the published work-zone name.

RSMs for the created work zone are included in the logs when they are imported.

4

Navigate to the carma-cloud webpage (https://www.carma-cloud.com/) and login.

The CARMA Cloud interface is shown

5

Verify the created work zone is shown on the CARMA Cloud map.

Lane closure is present on the CARMA-Cloud web page.

6

Click on Edit mode and select the created work zone

A popup is display showing the blockage is of type RSM

 



Test Case RI-03

Test Case #

RI-03

Test Case

CARMA Cloud and CARMA Platform communication through V2X Hub

Objective

Verify CARMA Cloud can receive a TCR from CARMA Platform and respond with a TCM .

Entrance Criteria

 

A CARMA Cloud instance is running and is accessible by the V2X Hub via the required tunnels

 

A CARMA vehicle is available and capable of running a route within range of the RSU

 

A closed lane is configured within the desired route using the CARMA Cloud interface (closure must be added within the last 24 hours)

 

An RSU is running and configured to forward received DSRC TCRs and TCMs to port 5398 of the V2X Hub

 

The following DSRC Message Manager Plugin values are set:

Destination_1: <IP of RSU>:1516

Messages_Destination_1 = …{ "TmxType": "TMSG05-P", "SendType": "TMSG05-P", "PSID": "0x8003" }…

 

The following Message Receiver Plugin values are set:

IP = IP of V2X Hub

Port = 5398

 

The Message Receiver plugin is enabled

 

The CARMA Cloud plugin is enabled

 

Data Inputs

CARMA TCR message

Data Outputs

CARMA TCM message

Exit Criteria

CARMA TCM messages are received by the CARMA Vehicle

Test Procedures

Step Description

Expected Outcome

1

Startup the CARMA platform on the vehicle and drive it to a place on the desired route within range of the RSU but do not select a route

The CARMA vehicle is within range of the RSU but no TCRs are broadcast because a route has not been selected

2

Select a route on the CARMA platform

A route is successfully loaded and the vehicle starts to broadcast TCRs via DSRC

3

Open the Messages tab on V2X Hub and verify an entry for the sent TCR is added and the Count increases (show as TMSG04-P)

An entry for TMSG04-P exists and increments in Count

4

On the CARMA vehicle, enter the following command:

 

rostopic echo /messages/outgoing_geofence_control

Outgoing TCRs are show on the output as they are sent by the vehicle

5

In Messages tab on V2X Hub and verify an entry for the TCM is added and the Count increases (shown as TMSG05-P)

An entry for TMSG05-P exists and increments in Count

6

On the CARMA vehicle, enter the following command:

 

rostopic echo /messages/incoming_geofence_control

TCMs are show on the output as they are received by the vehicle

 



Test Case RI-04

Test Case #

RI-04

Test Case

CARMA Platform Work Zone Navigation

Objective

Verify a the CARMA vehicle can navigate around the work zone using the TCR from CARMA Cloud and V2X Hub can receive BSMs and forward them to ODE as Kafka messages

Entrance Criteria

An OBU is configured and broadcasting BSMs within range of the RSU

 

An ODE instance is running and is accessible by the V2X Hub and the ODE web interface is accessible (<ip of ODE>:8080)

 

The following Message Receiver Plugin values are set:

IP = IP of V2X Hub

Port = 26789

 

An RSU is running and configured to forward received DSRC BSMs to port 26789 of the V2X Hub

 

The Message Receiver plugin is enabled and receiving BSMs

 

The following ODE Logger Plugin values are set:

KafkaBrokerIp = the IP of the ODE instance

Data Inputs

TCM, BSM

Data Outputs

Kafka BSM messages

Exit Criteria

The CARMA vehicle drives the Test Route and navigates around the work zone. V2X Hub receives the vehicle’s BSMs and sends them to ODE.

Test Procedures

Step Description

Expected Outcome

1

Verify the CARMA vehicle is broadcasting BSMs

An entry for BSMs is visible in the Messages tab of V2X Hub and the count is increasing

2

Open the ODE Demonstration Web console

The ODE Demonstration Web Console is opened

3

Click the Disconnect Websocket button

The websocket is disconnected and the Disconnect Websocket button is grayed out

4

Click the Connect Websocket button

The websocket is connected and the Connect Websocket button is grayed out

5

Under Listen for Kafka Messages, click the Clear Messages button

The Kafka Message box is cleared

6

Open an SSH session to the ODE instance and enter the command “docker ps”

The following containers are shown as running:

jpo-ode_ode_1

jpo-ode_kafka_1

jpo-ode_zookeeper_1

jpo-ode_cvpep_bsm_depositor_1

7

Enable the ODE Logger plugin and record the current time

The ODE Logger plugin is enabled and the indicator light turns green. The time is recorded

8

Observe the BSM Kafka messages appear in the ODE Demonstration Console

BSM Kafka messages appear in the ODE

9

Engage the CARMA vehicle into autonomous driving mode

The vehicle begins to drive the Test Route

10

Verify the CARMA vehicle changes lanes to avoid the work zone

The CARMA vehicle successfully changes lanes before the work zone

11

Verify the CARMA vehicle returns to the starting lane once it has passed the work zone

The CARMA vehicle returns the starting lane after it has passed the work zone

12

Disable the ODE Logger Plugin and record the current time

The ODE Logger plugin is disabled and BSMs stop being sent to ODE. The time is recorded

 

 



Test Case RI-05

Test Case #

RI-05

Test Case

Secure Data Commons

Objective

Verify the Secure Data Commons can receive data from ODE and convert it to a kml file

Entrance Criteria

BSM data has been sent to ODE

 

An ODE instance is running and is accessible by the V2X Hub and the ODE web interface is accessible (<ip of ODE>:8080)

 

The tester has access to SDC and BSM_to_KML.py is on their network

 

Python is installed on the SDC workstation.

 

Data Inputs

BSM JSON format files

Data Outputs

KML format files and visualization in google earth

Exit Criteria

The kml file is downloaded from SDC and successfully shows the path of the vehicle

Test Procedures

Step Description

Expected Outcome

1

Login to the SDC website:

 

https://beta-portal-sdc.dot.gov/home

 

Workstations are displayed at the top right menu.

2

Click the Workstations header, and find a VM listed on the table and then click the Start button in the action column.

The VM is started and the Start button becomes a Stop button.

3

Click the “Launch” button

The Windows login page is displayed

4

Login to Windows and open cyberduck software

The cyberduck connection page is shown

5

Click the “Open Connection” button.

The Open Connection popup is shown.

6

In the top dropdown, select “S3 (Credentials from EC2 Instance Metadata)” and click Connect.

A list of AWS S3 buckets is displayed.

7

Locate and expand “prod.sdc.dot.gov.data-lake.standardized-data”

A list of folders is displayed.

8

Find the “oss4its” folder, and expand this folder.

A list of folders, including BSM, folder is displayed.

9

Expand the BSM folder, and navigate to recorded date time 2021/mm/dd/hh folder

A list of BSM JSON files is displayed.

10

Choose one file and right click on the file name.

A list of options are shown.

11

Click Download to download the file with BSM data.

The file download begins.

12

After the download is complete, navigate to the download folder and open the file to verify it contains BSM data.

The downloaded file contains BSM data.

13

Open Anaconda Prompt.

An Anaconda Promp terminal is displayed.

14

Navigate to where the BSM_to_KML.py script is.

Run the BSM_to_KML.py script with below command:

 

“python BSM_to_KML.py <output filename> <bucket name> <bucket folder> <start time> <end time>

 

(eg. python BSM_to_KML.py bsm_output.kml prod.sdc.dot.gov.data-lake.standardized-data /oss4its/BSM/ 2021/08/17/05 2021/08/17/06)

KML files are generate for each BSM json in the S3 bucket between the selected dates.

15

Navigate to and expand the team bucket:

 

prod.sdc.gov.team.oss4its

The team bucked is expanded.

16

Expand and select the export_requests folder

The folder is expanded

17

Click the Upload button and select the output kml file and then click Choose

The file is uploaded

18

Navigate back to the SDC website and click the Datasets header

The datasets are shown

19

Find the uploaded output kml file and click the button under the export column and fill in the required information.

 

NOTE: System administrator approval may be required to export the file

The file is exported and is available to download

20

Click the checkbox next to the output kml file and click the Download button

The file is downloaded

21

Navigate to Google Earth:

 

earth.google.com

 

Google Earth is shown.

22

Create a new project from the left menu and click the New Project button.

The new project options are shown.

23

Click Import KML file from computer and select the download file.

The KML file is imported into Google Earth and the vehicle’s driven path is shown.

 

LIST OF ABBREVIATIONS

Acronym

Expanded Form

ACM

American Center for Mobility (Test track)

ADS

automated driving systems

AStuff

AutonomouStuff

CARMA

Cooperative Automation Research for Mobility Applications

CCA

Cooperative Collision Avoidance

CDA

Cooperative Driving Automation

CDL

Commercial Driver’s License

CLC

Cooperative Lane Coordination

CTS

Cooperative Traffic Signals

DDT

Dynamic Driving Task

DOT

Department of Transportation

DMP

Data Management Plan

ECBS

Electronically Controlled Braking Systems

FHWA

Federal Highway Administration

FLETC

Federal Law Enforcement Training Centers

FMCSA

Federal Motor Carriers Safety Administration

GPS

Global Positioning System

GTM

Government Task Manager

HMA

Hot Mix Asphalt

MDOT

Michigan Department of Transportation

NHTSA

National Highway Traffic Safety Agency

ODD

Operational Design Domain

OEDR

Object And Event Detection And Response

PoC

Proof of Concept

POV

Principal Other Vehicle

ROS

Robot Operating System (Software Library)

RSM

Road Safety Message

RSU

Road-Side Unit

RWM

Road Weather Management

SAE

Society of Automotive Engineers

SPAT

Signal Phasing And Timing

STOL

Saxton Transportation Operations Laboratory

SV

Subject Vehicle

TCM

Traffic Control Message

TCR

Traffic Control Request

TRC

Transportation Research Center (Test track)

TIM

Traffic Incident Message

TMS

Transportation Management Service

V2I

Vehicle-to-Infrastructure

V2V

Vehicle-to-Vehicle

VRU

Vulnerable Road User

WZM

Work Zone Management

 

References

CARMA Confluence: https://usdot-carma.atlassian.net/wiki/spaces/CAR/pages/40861883/CARMA+Outreach+Materials

Work Zone Data Collection Toolset: https://github.com/TonyEnglish/Work_Zone_Data_Collection_Toolset

SAE. “J2735SET: Dedicated Short Range Communications (DSRC) Message Set DictionaryTM
Set - SAE International.” SAE International, SAE International, 30 Mar. 2016, www.sae.org/standards/content/j2735set_201603.

 



 

 

 

 

 

 



 

 

 

 

 

 

 

 

 

 

 

 

 

 

 

 

 

 

U.S. Department of Transportation

Federal Highway Administration

Office of Operations

1200 New Jersey Avenue, SE

Washington, DC 20590

 

Office of Operations website

 

August 2021