search

smartdevicelink / sdl_requirements

Collection of requirements/technical tasks for new sdl_core features
BSD 3-Clause "New" or "Revised" License
2 stars 7 forks source link

[RC-SDL] - Audio Source AM/FM/XM/DAB #102

Open KhrystynaDubovyk opened 6 years ago

KhrystynaDubovyk commented 6 years ago

Description:

_As an RC mobile application, I want to know last used radio band with sending fewer SetInteriorVehicleDatarequests.

Detailed description:

The RADIO_TUNER is to be to replaced with three enumeration elements AM, FM and XM. The changes are applicable for both the MOBILE_API and HMI_API.

  <enum name="PrimaryAudioSource">
    <description>Reflects the current primary audio source (if selected).</description>
    ...
    <element name="MOBILE_APP">
    </element>
-    <element name="RADIO_TUNER">
-      <description>Radio may be on AM, FM or XM</description>
-    </element>
+    <element name="AM">
+    </element>
+    <element name="FM">
+    </element>
+    <element name="XM">
+    </element>
+    <element name="DAB">
+    </element>
  </enum>

Because the parameters (audio source, radio band, and radio frequency) belong to two different remote control moduleTypes, in order to set the audio source to a specific radio station or radio frequency, a mobile application needs to send two setInteriorVehicleData requests in sequence.
The first request sets the audio source to AM/FM/XM with targeted moduleType=AUDIO.
The second request sets the desired frequency of AM/FM radio or station number of XM radio with targeted moduleType=RADIO.

Diagram:

N/A

Links: