Set indicator state via Scenario.xosc file

Set indicator state via Scenario.xosc file

doc/source/advanced_topics/simulator/scenario_actions.rst

 ..
   *******************************************************************************
-  Copyright (c) 2023 Bayerische Motoren Werke Aktiengesellschaft (BMW AG)
+  Copyright (c) 2023-2024 Bayerische Motoren Werke Aktiengesellschaft (BMW AG)
 
   This program and the accompanying materials are made available under the
   terms of the Eclipse Public License 2.0 which is available at
@@ -16,7 +16,7 @@ Mapping of OpenSCENARIO Actions
 
 .. table::
    :class: tight-table
-   
+
    =================== =============
    Layer/Component	    API/Datatype
    =================== =============
@@ -31,7 +31,7 @@ AcquirePositionAction
 
 .. table::
    :class: tight-table
-   
+
    +--------------+-------------------------------------------------------------------------------------------------------+
    | API/Datatype | Used Methods/Classes/API                                                                              |
    +==============+=======================================================================================================+
@@ -57,7 +57,7 @@ AssignRouteAction
 
 .. table::
    :class: tight-table
-   
+
    +--------------+-------------------------------------------------------------------------------------------------------+
    | API/Datatype | Used Methods/Classes/API                                                                              |
    +==============+=======================================================================================================+
@@ -76,7 +76,7 @@ CustomCommandAction
 
 .. table::
    :class: tight-table
-   
+
    +--------------+-------------------------------------------------------------------------------------------------------+
    | API/Datatype | Used Methods/Classes/API                                                                              |
    +==============+=======================================================================================================+
@@ -99,7 +99,7 @@ FollowTrajectoryAction
 
 .. table::
    :class: tight-table
-   
+
    +--------------+-------------------------------------------------------------------------------------------------------+
    | API/Datatype | Used Methods/Classes/API                                                                              |
    +==============+=======================================================================================================+
@@ -132,7 +132,7 @@ LaneChangeAction
 
 .. table::
    :class: tight-table
-   
+
    +--------------+-------------------------------------------------------------------------------------------------------+
    | API/Datatype | Used Methods/Classes/API                                                                              |
    +==============+=======================================================================================================+
@@ -170,7 +170,7 @@ SpeedAction
 
 .. table::
    :class: tight-table
-   
+
    +--------------+-------------------------------------------------------------------------------------------------------+
    | API/Datatype | Used Methods/Classes/API                                                                              |
    +==============+=======================================================================================================+
@@ -196,7 +196,7 @@ TeleportAction
 
 .. table::
    :class: tight-table
-   
+
    +--------------+-------------------------------------------------------------------------------------------------------+
    | API/Datatype | Used Methods/Classes/API                                                                              |
    +==============+=======================================================================================================+
@@ -222,7 +222,7 @@ TrafficSignalAction
 
 .. table::
    :class: tight-table
-   
+
    +--------------+-------------------------------------------------------------------------------------------------------+
    | API/Datatype | Used Methods/Classes/API                                                                              |
    +==============+=======================================================================================================+
@@ -246,7 +246,7 @@ TrafficSignalStateAction
 
 .. table::
    :class: tight-table
-   
+
    +--------------+-------------------------------------------------------------------------------------------------------+
    | API/Datatype | Used Methods/Classes/API                                                                              |
    +==============+=======================================================================================================+
@@ -270,7 +270,7 @@ TrafficSinkAction
 
 .. table::
    :class: tight-table
-   
+
    +--------------+-------------------------------------------------------------------------------------------------------+
    | API/Datatype | Used Methods/Classes/API                                                                              |
    +==============+=======================================================================================================+
@@ -295,7 +295,7 @@ VisibilityAction
 
 .. table::
    :class: tight-table
-   
+
    +--------------+-------------------------------------------------------------------------------------------------------+
    | API/Datatype | Used Methods/Classes/API                                                                              |
    +==============+=======================================================================================================+
@@ -307,3 +307,27 @@ VisibilityAction
    +--------------+-------------------------------------------------------------------------------------------------------+
    | osi3         | x -- not implemented                                                                                  |
    +--------------+-------------------------------------------------------------------------------------------------------+
+
+LightStateAction
+----------------
+
+.. table::
+   :class: tight-table
+
+   +--------------+-------------------------------------------------------------------------------------------------------+
+   | API/Datatype | Used Methods/Classes/API                                                                              |
+   +==============+=======================================================================================================+
+   | OpenSCENARIO | **LightStateAction**                                                                                  |
+   +--------------+-------------------------------------------------------------------------------------------------------+
+   | mantle_api   | UpdateControlStrategies(VehicleLightStatesControlStrategy)                                            |
+   |              | MovementDomain::kNone                                                                                 |
+   +--------------+-------------------------------------------------------------------------------------------------------+
+   | openPASS     | Entity::SetVehicleLightState(mantle_api::LightState, mantle_api::LightType)                           |
+   +--------------+-------------------------------------------------------------------------------------------------------+
+   | osi3         | osi3::TrafficAction_CustomAction                                                                      |
+   +--------------+-------------------------------------------------------------------------------------------------------+
+
+.. note::
+
+   Currently only indicatorLeft, indicatorRight and warningLights of OpenSCENARIO VehicleLightType are supported in openPASS.
+   OpenSCENARIO LightStateAction attribute, transitionTime is not received from the OSE