From c327fa07bac8fc96e09696af38bf60b1a109a0ad Mon Sep 17 00:00:00 2001
From: paulbourelly999 <77466294+paulbourelly999@users.noreply.github.com>
Date: Thu, 5 Sep 2024 10:50:31 -0400
Subject: [PATCH] Update CDASimAdapter to accomadate changes in SensorConfig
 file (#640)

<!-- Thanks for the contribution, this is awesome. -->

# PR Details
## Description
### Background (Related changes)
This PR was created to accommodate changes in the Sensor Configuration
file introduced by this PR
(https://github.com/usdot-fhwa-stol/carma-streets/pull/427). To
summarize, the sensor configuration file format was changed to allow for
reference location to be specified in WGS84 coordinates or cartesian
coordinates. For Simulation cartesian coordinates work well since many
simulation environments do not have real-world equivalents and cartesian
coordinates are easy to pull from different map editors and viewers like
[JSOM](https://josm.openstreetmap.de/). For real world deployments
however WGS84 coordinates are far easier to use since using cartesian
coordinates introduces a dependency on an lanlet2 map for the area. It
is far easier to use built in or separate GPS devices to get a reference
location for a mounted sensor.
#### Old Format of Sensor Configuration JSON:
```json
[
  {
    "sensorId": "SomeID",
    "type": "SemanticLidar",
    "location": {
      "x": 1.0, /* in meters */
      "y": 2.0, /* in meters */
      "z": -3.2 /* in meters */
     },
     "orientation": {
       "yaw": 0.0,
       "pitch": 0.0,
       "roll": 0.0
      }
  }
]
```
#### New Format of Sensor Configuration JSON:
```json
[
  {
    "sensorId": "sensor_1",
    "type": "SemanticLidar",
    "ref": {
      "type": "CARTESIAN",
      "location": {
        "x": 1.0, /* in meters */
        "y": 2.0, /* in meters */
        "z": -3.2 /* in meters */
      },
       "orientation": {
        "yaw": 0.0,
        "pitch": 0.0,
        "roll": 0.0
        }
    }
  }
]
```

### Changes

This change in Sensor Configuration file means that we need to change
how we read and populate the registration message that goes out from the
CDASim Adapter Plugin to CDASim. The content of this registration
remains unchanged, we just need to read this information from the new
`ref` element in the Sensor Configuration JSON and populate the existing
registration. Lastly, we added logic for the registration to ignore any
sensor with a WGS84 reference location since we currently only have
support
```json
{
  "infrastructureId": "id_123",
  "location": {
    "x": 0,
    "y": 0,
    "z": 0
  },
  "rxMessageIpAddress": "127.0.0.1",
  "rxMessagePort": 8686,
  "sensors": {
    "sensorId": "sensor1",
    "type": "SemanticLidar",
    "location": {
      "x": 0.0,
      "y": 0.0,
      "z": 0.0
     },
     "orientation": {
       "yaw": 0.0,
       "pitch": 0.0,
       "roll": 0.0
      }
  },
  "simulatedInteractionPort": 7576,
  "timeSyncPort": 7575
}

```

<!--- Describe your changes in detail -->

## Related Issue
[FCP-37
](https://usdot-carma.atlassian.net/browse/FCP-37)<!--- This project
only accepts pull requests related to open issues -->
<!--- If suggesting a new feature or change, please discuss it in an
issue first -->
<!--- If fixing a bug, there should be an issue describing it with steps
to reproduce -->
<!--- Please link to the issue here: -->

## Motivation and Context
See description
<!--- Why is this change required? What problem does it solve? -->

## How Has This Been Tested?
Local Integration Testing and unit testing
<!--- Please describe in detail how you tested your changes. -->
<!--- Include details of your testing environment, and the tests you ran
to -->
<!--- see how your change affects other areas of the code, etc. -->

## Types of changes

<!--- What types of changes does your code introduce? Put an `x` in all
the boxes that apply: -->

- [x] Defect fix (non-breaking change that fixes an issue)
- [ ] New feature (non-breaking change that adds functionality)
- [ ] Breaking change (fix or feature that cause existing functionality
to change)

## Checklist:

<!--- Go over all the following points, and put an `x` in all the boxes
that apply. -->
<!--- If you're unsure about any of these, don't hesitate to ask. We're
here to help! -->

- [ ] I have added any new packages to the sonar-scanner.properties file
- [x] My change requires a change to the documentation.
- [x] I have updated the documentation accordingly.
- [x] I have read the **CONTRIBUTING** document.
[V2XHUB Contributing
Guide](https://github.com/usdot-fhwa-OPS/V2X-Hub/blob/develop/Contributing.md)
- [x] I have added tests to cover my changes.
- [x] All new and existing tests passed.
---
 src/v2i-hub/CDASimAdapter/README.md           |  82 ++++++++++++++++++
 .../docs/communication_diagram.png            | Bin 0 -> 39948 bytes
 .../CDASimAdapter/src/CDASimConnection.cpp    |  75 +++++++++++++---
 .../src/include/CDASimConnection.hpp          |  25 ++++--
 .../test/TestCDASimConnection.cpp             |  16 ++--
 src/v2i-hub/CDASimAdapter/test/sensors.json   |  46 +++++-----
 .../sensors_including_invalid_entries.json    |  48 ++++++++++
 7 files changed, 250 insertions(+), 42 deletions(-)
 create mode 100755 src/v2i-hub/CDASimAdapter/README.md
 create mode 100644 src/v2i-hub/CDASimAdapter/docs/communication_diagram.png
 create mode 100755 src/v2i-hub/CDASimAdapter/test/sensors_including_invalid_entries.json

diff --git a/src/v2i-hub/CDASimAdapter/README.md b/src/v2i-hub/CDASimAdapter/README.md
new file mode 100755
index 000000000..2267f3dba
--- /dev/null
+++ b/src/v2i-hub/CDASimAdapter/README.md
@@ -0,0 +1,82 @@
+# CDASim Adapter Plugin Plugin Documentation
+
+## Introduction
+
+This Plugin is an adapter for integration with the **CDASim Co-simulation** enviroment. 
+
+## Related Plugins
+
+A list of plugins related to the CDASim Adapter Plugin.
+
+### Immediate Forward Plugin
+
+For RSU Immediate Message Forwarding (IMF) functionality forward J2735 messages to CDASim.
+
+### Message Receiver Plugin
+
+The Message Receiver Plugin for receiving incoming J2735 message from CDASim.
+
+## Configuration/Deployment
+
+### System Configuration
+
+This plugin uses several system configuration parameters set as enviroment variables described below.
+
+**SIMULATION_MODE** – Environment variable for enabling simulation components for V2X-Hub. If set to "true" or "TRUE" simulation components will be enable. Otherwise, simulation components will not be enabled.
+
+**SIMULATION_IP** – Environment variable for storing IP address of CDASim application.
+
+**SIMULATION_REGISTRATION_PORT** – Environment variable for storing port on CDASim that handles registration attempts.
+
+**TIME_SYNC_PORT** – Environment varaible for storing port for receiving time sync messages from CDASim.
+
+**V2X_PORT** – Environment variable for storing port for receiving v2x messages from CDASim
+
+**SIM_V2X_PORT** – Environment variable for storing port for sending v2x messages to CDASim
+
+**V2XHUB_IP** – Environment variable for storing IP address of V2X Hub.
+
+**INFRASTRUCTURE_ID** – Environment variable for storing infrastructure id of V2X Hub.
+
+**SENSOR_JSON_FILE_PATH** – Environment variable for storing path to sensor configuration file. This is an optional simulation environment variable that allows for setting up simulated sensor for a V2X-Hub instance. Example file can be found in the **CDASimAdapterPlugin** tests [here](../src/v2i-hub/CDASimAdapter/test/sensors.json).
+
+### Plugin Configuration
+
+In addition to the system configuration, the CDASim Adapter also has plugin configuration parameters that can be set via the admin portal.
+
+**LogLevel**:The log level for this plugin"
+
+**X**:Cartesian X coordinate in simulated map (in meters).
+
+**Y**:Cartesian Y coordinate in simulated map (in meters).
+
+**Z**:Cartesian Z coordinate in simulated map (in meters).
+
+**MaxConnectionAttempts**:Number of connection attempts CDASimAdapter plugin will execute before failing. Valid values are any integers greater than or equal to 1. Any value less than 1 will result in unlimited connection attemtps.
+
+**ConnectionSleepTime**:Number of seconds to wait after a failed CDASim connection attempt, before retrying to establish connection. Valid values are equal or greater than 1. Any value less than 1 will be treated as 1.
+
+## Design
+
+### Communication
+
+![Alt text](docs/communication_diagram.png)
+The integration with the **CDASim Co-simulation** enviorment consists of 4 major parts:
+
+**Registration Adapter**: The CDASimAdapter will establish a unique connection with CDASim and provide configuration information about harware like RSUs or Sensors associated with V2X-Hub.
+
+**Time Adapter**: The CDASimAdapter will consume and broadcast simulation time from the CDASim enviromment to ensure all plugins are using simulation time in place of machine time.
+
+**Message Adapter**: The CDASimAdapter will forward V2X messages to CDASim for simulated radio broadcast. It will also listen for incoming simulated V2X message recptions for the RSUs it registered with CDASim.
+
+**Simulation Adapter**: This final part captures any simulated events V2X-Hub needs to listen for. An example is Sensor Detections. When registering a sensor with CDASim, the sensor is created and detections from that sensor need to be forwarded to V2X-Hub. The simulation adapter will listen for these events from CDASim and broadcast them on the TMX message bus for other plugin.
+
+### Messages
+
+**Time Sync Message**: A V2X-Hub message that all PluginClientClockAware plugins subscribe to when running V2X-Hub in the simulation environment. This updates the base class clock object to allow for seamless integration of plugins into the simulation environment. 
+
+**Sensor Detected Object**: V2X-Hub's generic message for detection data. This message is generated when the CDASim adapter receives a detection interaction for one of the sensors it registers.
+
+## Functionality Testing
+
+Included in this directory is a `scripts` directory that includes scripts to mock a CDASim Server listening for simulation registration events (`udp_socket_server.py`), time steps sent from CDASim (`send_timestep_udp.py`), and simulated detection events sent from CDASim (`send_sim_detected_object_udp.py`). These can be used to test functiontionality associated with the **CDASimAdapter Plugin**
diff --git a/src/v2i-hub/CDASimAdapter/docs/communication_diagram.png b/src/v2i-hub/CDASimAdapter/docs/communication_diagram.png
new file mode 100644
index 0000000000000000000000000000000000000000..14c1c92c4d2318411714a296302b8be2de48e69b
GIT binary patch
literal 39948
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
E0Z-NZjsO4v

literal 0
HcmV?d00001

diff --git a/src/v2i-hub/CDASimAdapter/src/CDASimConnection.cpp b/src/v2i-hub/CDASimAdapter/src/CDASimConnection.cpp
index 4ab7cabd7..1fe032cf3 100644
--- a/src/v2i-hub/CDASimAdapter/src/CDASimConnection.cpp
+++ b/src/v2i-hub/CDASimAdapter/src/CDASimConnection.cpp
@@ -54,12 +54,14 @@ namespace CDASimAdapter{
         //Sample sensors.json: https://raw.githubusercontent.com/usdot-fhwa-OPS/V2X-Hub/develop/src/v2i-hub/CDASimAdapter/test/sensors.json
         // Sensor configuration is an optional part of registration message.
         if ( !_sensor_json_file_path.empty() ) {
-            auto sensors_json_v = read_json_file(_sensor_json_file_path);
-            if(sensors_json_v.empty())
-            {
-                PLOG(logWARNING) << "Sensors JSON is empty!" << std::endl;
-            }     
-            message["sensors"] = sensors_json_v;
+            try {
+                auto sensors_json_v = read_sensor_configuration_file(_sensor_json_file_path);
+                message["sensors"] = sensors_json_v;
+            }
+            catch(const std::invalid_argument &e) {
+                PLOG(tmx::utils::logWARNING) << "Error occured reading sensor configuration file: " << e.what() 
+                    << std::endl << "Not sending any Sensor Registration information with CDASim Infrastructure Registration!";
+            }
         }
         else {
             PLOG(logWARNING) << "No sensors where configured for this V2X-Hub instance.";
@@ -234,14 +236,12 @@ namespace CDASimAdapter{
     }
 
     Json::Value CDASimConnection::read_json_file(const std::string& file_path) const{
-        Json::Value sensors_json_v;
         //Read file from disk
         std::ifstream in_strm;
         in_strm.open(file_path, std::ifstream::binary);
         if(!in_strm.is_open())
         {
-            PLOG(logERROR) << "File cannot be opened. File path: " << file_path <<std::endl;
-            return sensors_json_v;
+            throw std::invalid_argument("File cannot be opened. File path: " + file_path);
         }
         std::string line;
         std::stringstream ss;
@@ -261,8 +261,63 @@ namespace CDASimAdapter{
         JSONCPP_STRING err;
         if(!reader->parse(json_str.c_str(), json_str.c_str() + json_str.length(), &json_v, &err))
         {
-            PLOG(logERROR) << "Error parsing sensors from string: " << json_str << std::endl;
+            throw std::invalid_argument("Error parsing JSON from string: " + json_str);
         }
         return json_v;
     }
+
+    Json::Value CDASimConnection::read_sensor_configuration_file(const std::string &file_path) const {
+        // Sensor Configuration File JSON format
+        /*  {
+            "sensorId": "sensor_1",
+            "type": "SemanticLidar",
+            "ref": {
+                "type": "CARTESIAN",
+                "location": {
+                    "x": 1.0, 
+                    "y": 2.0, 
+                    "z": -3.2 
+                },
+                "orientation": { 
+                    "yaw": 0.0,
+                    "pitch": 0.0,
+                    "roll": 0.0
+                    }
+            }
+        } 
+        ] */
+        auto sensor_configuration = read_json_file(file_path);
+        Json::Value sensors_registration;
+        for ( int index = 0; index < sensor_configuration.size(); ++index ) {
+            Json::Value sensor;
+            if ( sensor_configuration[index]["ref"]["type"] != "CARTESIAN" ){
+                PLOG(logWARNING) << "Skipping sensor configuration for " + sensor["sensorId"].asString() + ". Invalid ref type! Only CARTESIAN ref type currently supported for CDASim!" ;
+                continue;
+            }
+            sensor["sensorId"] = sensor_configuration[index]["sensorId"];
+            sensor["type"] = sensor_configuration[index]["type"];
+            sensor["location"] = sensor_configuration[index]["ref"]["location"];
+            sensor["orientation"] =sensor_configuration[index]["ref"]["orientation"];
+            sensors_registration.append(sensor);
+        }
+        /** Sensor Registration JSON Format
+        [
+            {
+            "sensorId": "SomeID",
+            "type": "SemanticLidar",
+            "location": {
+                "x": 1.0, 
+                "y": 2.0, 
+                "z": -3.2 
+                },
+                "orientation": {
+                "yaw": 0.0,
+                "pitch": 0.0,
+                "roll": 0.0
+                }
+            }
+        ]
+        */
+        return sensors_registration;
+    }
 }
diff --git a/src/v2i-hub/CDASimAdapter/src/include/CDASimConnection.hpp b/src/v2i-hub/CDASimAdapter/src/include/CDASimConnection.hpp
index 3a9bdf1a4..7899af4f7 100644
--- a/src/v2i-hub/CDASimAdapter/src/include/CDASimConnection.hpp
+++ b/src/v2i-hub/CDASimAdapter/src/include/CDASimConnection.hpp
@@ -135,17 +135,26 @@ namespace CDASimAdapter {
                                 const tmx::utils::Point &location) const; 
             
             /**
-             * @brief Read Json file specified by the file path from disk, and convert the json into Json::Value object.
-             * @param file_path A string of file path in the host machine.
+             * @brief Helper method to read JSON file and return resulting Json::Value. 
+             * @param file_path A string of file path in the host machine to the JSON file.
              * @return A Json::Value object.
+             * @throw std::invalid_argument exception if no file is found or file is not readable for provided path.
             */
             Json::Value read_json_file(const std::string& file_path) const;
-             /**
-             * @brief Convert the Json string into Json::Value object.
-             * @param json_str A JSON string.
-             * @return A Json::Value object.
-            */
+            /**
+             * @brief Helper method to convert string JSON content to JSON::Value.
+             * @param json_str A JSON string content of Sensor Configuration JSON file
+             * @return A Json::Value object parsed from string.
+             * @throw std::invalid_argument exception if provided string is not valid JSON
+             */
             Json::Value string_to_json(const std::string &json_str) const;
+            /**
+             * @brief Method to read Sensor Configuration JSON file and return Sensor Registration information
+             * required for Infrastructure Registration to CDASim.
+             * @param file_path Path to Sensor Configuration file.
+             * @return Json::Value correspoding to Sensor Registration information for Infrastructure Registration to CDASim.
+             */
+            Json::Value read_sensor_configuration_file(const std::string &file_path) const;
 
             std::string _simulation_ip;
             uint _simulation_registration_port;
@@ -171,6 +180,8 @@ namespace CDASimAdapter {
             FRIEND_TEST(TestCDASimConnection, get_handshake_json_no_sensor_config);
             FRIEND_TEST(TestCDASimConnection, read_json_file);
             FRIEND_TEST(TestCDASimConnection, string_to_json);
+            FRIEND_TEST(TestCDASimConnection, read_sensor_configuration_file);
+
 
             
     };
diff --git a/src/v2i-hub/CDASimAdapter/test/TestCDASimConnection.cpp b/src/v2i-hub/CDASimAdapter/test/TestCDASimConnection.cpp
index 710dc49d8..80a47cc2f 100644
--- a/src/v2i-hub/CDASimAdapter/test/TestCDASimConnection.cpp
+++ b/src/v2i-hub/CDASimAdapter/test/TestCDASimConnection.cpp
@@ -101,20 +101,26 @@ namespace CDASimAdapter {
 
     TEST_F(TestCDASimConnection, read_json_file)
     {        
-        auto sensorJsonV = connection->read_json_file("Invalid_file_path" );
-        ASSERT_TRUE(sensorJsonV.empty());
+        EXPECT_THROW(connection->read_json_file("Invalid_file_path" ), std::invalid_argument);
         std::ifstream in_strm;
         in_strm.open(sensors_file_path, std::ifstream::binary);
         if(in_strm.is_open())
         {
-            sensorJsonV = connection->read_json_file(sensors_file_path );
+            auto sensorJsonV = connection->read_json_file(sensors_file_path );
             ASSERT_FALSE(sensorJsonV.empty());
         }        
     }
 
     TEST_F(TestCDASimConnection, string_to_json)
     {        
-        auto sensorJsonV = connection->string_to_json("Invalid Json");
-        ASSERT_TRUE(sensorJsonV.empty());
+        EXPECT_THROW(connection->string_to_json("Invalid Json"), std::invalid_argument);
+    }
+
+    TEST_F(TestCDASimConnection, read_sensor_configuration_file) {
+        auto sensor_registration = connection->read_sensor_configuration_file("../../CDASimAdapter/test/sensors_including_invalid_entries.json");
+        EXPECT_EQ(2, sensor_registration.size());
+        EXPECT_EQ("SomeID", sensor_registration[0]["sensorId"].asString());
+        EXPECT_EQ("SomeID2", sensor_registration[1]["sensorId"].asString());
+
     }
 }
\ No newline at end of file
diff --git a/src/v2i-hub/CDASimAdapter/test/sensors.json b/src/v2i-hub/CDASimAdapter/test/sensors.json
index 985496f8d..3f7cb1094 100755
--- a/src/v2i-hub/CDASimAdapter/test/sensors.json
+++ b/src/v2i-hub/CDASimAdapter/test/sensors.json
@@ -2,29 +2,35 @@
   {
     "sensorId": "SomeID",
     "type": "SemanticLidar",
-    "location": {
-      "x": 0.0,
-      "y": 0.0,
-      "z": 0.0
-     },
-     "orientation": {
-       "yaw": 0.0,
-       "pitch": 0.0,
-       "roll": 0.0
-      }
+    "ref": {
+      "type": "CARTESIAN",
+      "location": {
+        "x": 0.0,
+        "y": 0.0,
+        "z": 0.0
+      },
+      "orientation": {
+        "yaw": 0.0,
+        "pitch": 0.0,
+        "roll": 0.0
+        }
+    }
   },
   {
     "sensorId": "SomeID2",
     "type": "SemanticLidar",
-    "location": {
-      "x": 1.0,
-      "y": 2.0,
-      "z": 0.0
-     },
-     "orientation": {
-       "yaw": 23.0,
-       "pitch": 0.0,
-       "roll": 0.0
-      }
+    "ref": {
+      "type": "CARTESIAN",
+      "location": {
+        "x": 1.0,
+        "y": 2.0,
+        "z": 0.0
+      },
+      "orientation": {
+        "yaw": 23.0,
+        "pitch": 0.0,
+        "roll": 0.0
+        }
+    }
   }
 ]
\ No newline at end of file
diff --git a/src/v2i-hub/CDASimAdapter/test/sensors_including_invalid_entries.json b/src/v2i-hub/CDASimAdapter/test/sensors_including_invalid_entries.json
new file mode 100755
index 000000000..edf290686
--- /dev/null
+++ b/src/v2i-hub/CDASimAdapter/test/sensors_including_invalid_entries.json
@@ -0,0 +1,48 @@
+[
+  {
+    "sensorId": "SomeID",
+    "type": "SemanticLidar",
+    "ref": {
+      "type": "CARTESIAN",
+      "location": {
+        "x": 0.0,
+        "y": 0.0,
+        "z": 0.0
+      },
+      "orientation": {
+        "yaw": 0.0,
+        "pitch": 0.0,
+        "roll": 0.0
+        }
+    }
+  },
+  {
+    "sensorId": "sensor_1",
+    "type": "SemanticLidar",
+    "ref": {
+      "type": "WGS84",
+      "location": {
+        "latitude": 38.9549716548523, 
+        "longitude": -77.14935313519123, 
+        "altitude": 5.5 
+      }
+    }
+  }, 
+  {
+    "sensorId": "SomeID2",
+    "type": "SemanticLidar",
+    "ref": {
+      "type": "CARTESIAN",
+      "location": {
+        "x": 1.0,
+        "y": 2.0,
+        "z": 0.0
+      },
+      "orientation": {
+        "yaw": 23.0,
+        "pitch": 0.0,
+        "roll": 0.0
+        }
+    }
+  }
+]
\ No newline at end of file