[RC-SDL] - Expanding Lights parameter

[KhrystynaDubovyk]

Remote Control – Lights – More Names and Status Values

Description:

As a mobile application, I want to know to get the status of additional vehicle lights.

Detailed description:

Mobile API Change

  <enum name="LightName">
    ......
+   <element name="REAR_CARGO_LIGHTS" value="512">
+     <description>
+       Cargo lamps illuminate the cargo area.
+     </description>
+   </element>
+   <element name="REAR_TRUCK_BED_LIGHTS" value="513">
+     <description>
+       Truck bed lamps light up the bed of the truck.
+     </description>
+   </element>
+   <element name="REAR_TRAILER_LIGHTS" value="514">
+     <description>
+       Trailer lights are lamps mounted on a trailer hitch.
+     </description>
+   </element>
+   <element name="LEFT_SPOT_LIGHTS" value="515">
+     <description>
+       It is the spotlights mounted on the left side of a vehicle.
+     </description>
+   </element>
+   <element name="RIGHT_SPOT_LIGHTS" value="516">
+     <description>
+       It is the spotlights mounted on the right side of a vehicle.
+     </description>
+   </element>
+   <element name="LEFT_PUDDLE_LIGHTS" value="517">
+     <description>
+       Puddle lamps illuminate the ground beside the door as the customer is opening or approaching the door.
+     </description>
+   </element>
+   <element name="RIGHT_PUDDLE_LIGHTS" value="518">
+     <description>
+       Puddle lamps illuminate the ground beside the door as the customer is opening or approaching the door.
+     </description>
+   </element>
    ......  
+   <element name="EXTERIOR_ALL_LIGHTS" value="905">
+     <description> Include all exterior lights around the vehicle. </description>
+   </element> 
  </enum>
  
  <enum name="LightStatus">
    <element name="ON"/>
    <element name="OFF"/>
+   <element name="RAMP_UP"/>
+   <element name="RAMP_DOWN"/>
+   <element name="UNKNOWN"/>
+   <element name="INVALID"/>
  </enum>
  
  <struct name="LightCapabilities">
    <param name="name" type="LightName" mandatory="true" />
-    <!-- Assuming light ON/OFF status is always available -->
+    <param name="statusAvailable" type="Boolean" mandatory="false">
+      <description>
+        Indicates if the status (ON/OFF) can be set remotely. App shall not use read-only values (RAMP_UP/RAMP_DOWN/UNKNOWN/INVALID) in a setInteriorVehicleData request.
+      </description>
+    </param>
  ......
  </struct>

HMI API Change

The changes are the same as that of the mobile API.

Diagram:

N/A

Links:

• Proposal: 0165-rc-lights-more-names-and-status-values.md
• Parent requirement: [SDL-RC] - LIGHT, AUDIO, HMI_SETTINGS, SEATS modules
• Technical task: issues/2172
• Questions: Expected results in cases with READ_ONLY code for SetInteriorVehicleData