[RC-SDL] - Radio and Climate Parameter Update

[KhrystynaDubovyk]

Remote Control - Radio and Climate Parameter Update

Description:

As a mobile application, I want to know a list of HD sub-channel indexes with HD radio broadcasting and to be enabled to power climate control on or off.

Detailed description:

• Deprecate the availableHDs parameter in RadioControlData.
• Add a new parameter availableHdChannels to RadioControlData to allow an application to know what HD radio channel indexes are available.
• Add a new parameter climateEnable to ClimateControlData to allow an application to power on or off climate control.
• Update RadioControlCapabilities and ClimateControlCapabilities correspondingly.
• In addition, the minimum index of HD radio sub-channels will need to be changed from 1 to 0.

Mobile and HMI API

<struct name="RadioControlData" since="4.5">
...
<!-- new additions or changes -->
-   <param name="availableHDs" type="Integer" minvalue="1 maxvalue="7" mandatory="false" since="5.0">
+   <param name="availableHDs" type="Integer" minvalue="0" maxvalue="7" mandatory="false" deprecated="true" since="5.1">
        <description>number of HD sub-channels if available</description>
        <history>
            <param name="availableHDs" type="Integer" minvalue="1" maxvalue="3" mandatory="false" since="4.5" until="5.0"/>
        </history>
    </param>
    
+   <param name="availableHdChannels" type="Integer" minvalue="0" maxvalue="7" array="true" minsize="0" maxsize="8" mandatory="false" since="5.1">
+       <description>the list of available hd sub-channel indexes, empty list means no Hd channel is available, read-only </description>
+   </param>
    
-    <param name="hdChannel" type="Integer" minvalue="1" maxvalue="7" mandatory="false" since="5.0">
+    <param name="hdChannel" type="Integer" minvalue="0" maxvalue="7" mandatory="false" since="5.1">
        <description>Current HD sub-channel if available</description>
        <history>
            <param name="hdChannel" type="Integer" minvalue="1" maxvalue="3" mandatory="false" since="4.5" until="5.0"/>
+           <param name="hdChannel" type="Integer" minvalue="1" maxvalue="7" mandatory="false" since="5.0" until="5.1"/>
        </history>
    </param>
...
</struct>

<struct name="RadioControlCapabilities" since="4.5">
...
-    <param name="availableHDsAvailable" type="Boolean" mandatory="false">
+    <param name="availableHDsAvailable" type="Boolean" mandatory="false" deprecated="true" since="5.1">
        <description>
            Availability of the getting the number of available HD channels.
            True: Available, False: Not Available, Not present: Not Available.
        </description>
    </param>
+   <param name="availableHdChannelsAvailable" type="Boolean" mandatory="false" since="5.1">
+       <description>
+           Availability of the list of available HD sub-channel indexes.
+           True: Available, False: Not Available, Not present: Not Available.
+       </description>
+   </param>
...
</struct>



<struct name="ClimateControlCapabilities" since="4.5">
...
+   <param name="climateEnableAvailable" type="Boolean" mandatory="false" since="5.1">
+       <description>
+           Availability of the control of enable/disable climate control.
+           True: Available, False: Not Available, Not present: Not Available.
+       </description>
+   </param>
...
</struct>

<struct name="ClimateControlData" since="4.5">
...
+    <param name="climateEnable" type="Boolean" mandatory="false" since="5.1">
+    </param>
...
</struct>

Diagram:

N/A

Links:

• Proposal: 0213-rc-radio-climate-parameter-update
• Parent requirement: [RC-SDL] - Radio Parameter Update
• Technical task: issues/2162
• Questions: