[RC-SDL] - Interior Vehicle Data Subscription Management and Data Caching in SDL

[KhrystynaDubovyk]

GetInteriorVehicleData

Description:

As a mobile application, I want immediately get responses to GetInteriorVehicleData requests getting module data, module subscription status.

Detailed description:

Parameter appID is no longer needed in HMI API.

<function name="GetInteriorVehicleData" messagetype="request">
  <param name="moduleType" type="Common.ModuleType" mandatory="true" >
    <description>The module data to retrieve from the vehicle for that type</description>
  </param>
  <param name="subscribe" type="Boolean" mandatory="false" defvalue="false">
    <description>If subscribe is true, the head unit will send onInteriorVehicleData notifications for the module type</description>
  </param>
-  <param name="appID" type="Integer" mandatory="true">
-    <description>Internal SDL-assigned ID of the related application</description>
-  </param>
</function>

When there is no cache available and before SDL forwards a GetInteriorVehicleData request to HMI, SDL shall apply a rate limitation scheme.
SDL allows x number of GetVehicleData requests per second. The number x is 5 and it can be configured in smartDeviceLink.ini file. Similarly, SDL allows y number of GetInteriorVehicleData requests to forward to HMI. The number y shall be configurable in ini file.

[MAIN]
; Limitation for a number of GetVehicleData requests (the 1st value) per (the 2nd value) seconds
GetVehicleDataRequest = 5, 1
+; Limitation for a number of GetInteriorVehicleDataRequest requests (the 1st value) per (the 2nd value) seconds
+GetInteriorVehicleDataRequest = 20, 1

Diagram:

N/A

Links:

• Proposal: 0178-GetInteriorVehicleData
• Parent requirement: [SDL_RC] Current module status data GetInteriorVehicleData
• Technical task: issues/2318
• Questions: GetInteriorVehicleData(subscribe = false) by app unregistration, Limitation for GetInteriorVehicleDataRequest, GetInteriorVehicleData(subscribe = false) request when app is NOT subscribed to module