New vehicle data: GearStatus

smartdevicelink · Mar 26, 2020 · 78bdb2e · 78bdb2e
1 parent c5132e0
commit 78bdb2e
Show file tree

Hide file tree

Showing 2 changed files with 139 additions and 13 deletions.
diff --git a/MOBILE_API.xml b/MOBILE_API.xml
@@ -1,7 +1,7 @@
 <?xml version="1.0" standalone="no"?>
 <?xml-stylesheet type="text/xml" href="protocol2html.xsl"?>
 
-<interface name="SmartDeviceLink RAPI" version="6.0.0" minVersion="1.0" date="2019-03-19">
+<interface name="SmartDeviceLink RAPI" version="6.2.0" minVersion="1.0" date="2019-03-19">
     <enum name="Result" internal_scope="base" since="1.0">
         <element name="SUCCESS">
             <description>The request succeeded</description>
@@ -545,7 +545,8 @@
         <element name="VEHICLEDATA_FUELCONSUMPTION" />
         <element name="VEHICLEDATA_EXTERNTEMP" />
         <element name="VEHICLEDATA_VIN" />
-        <element name="VEHICLEDATA_PRNDL" />
+        <element name="VEHICLEDATA_GEARSTATUS" since="6.2"/>
+        <element name="VEHICLEDATA_PRNDL" until="6.2"/>
         <element name="VEHICLEDATA_TIREPRESSURE" />
         <element name="VEHICLEDATA_ODOMETER" />
         <element name="VEHICLEDATA_BELTSTATUS" />
@@ -1186,7 +1187,7 @@
             <description>Longitude and latitude and altitude</description>
         </element>
     </enum>
-    
+
     <enum name="PRNDL" since="2.0">
         <description>The selected gear.</description>
         <element name="PARK">
@@ -1199,6 +1200,7 @@
             <description>No gear</description>
         </element>
         <element name="DRIVE">
+            <description>Regular Drive mode</description>
         </element>
         <element name="SPORT">
             <description>Drive Sport mode</description>
@@ -1222,12 +1224,44 @@
         </element>
         <element name="EIGHTH">
         </element>
+        <element name="NINTH" since="6.2">
+        </element>
+        <element name="TENTH" since="6.2">
+        </element>
         <element name="UNKNOWN">
         </element>
         <element name="FAULT">
         </element>
     </enum>
-
+
+    <enum name="TransmissionType" since="6.2">
+        <description>Type of transmission used in the vehicle.</description>
+        <element name="MANUAL">
+            <description>Manual transmission.</description>
+        </element>
+        <element name="AUTOMATIC">
+            <description>Automatic transmission.</description>
+        </element>
+        <element name="SEMI_AUTOMATIC">
+            <description>Semi automatic transmission.</description>
+        </element>
+        <element name="DUAL_CLUTCH">
+            <description>Dual clutch transmission.</description>
+        </element>
+        <element name="CONTINUOUSLY_VARIABLE">
+            <description>Continuously variable transmission(CVT).</description>
+        </element>
+        <element name="INFINITELY_VARIABLE">
+            <description>Infinitely variable transmission.</description>
+        </element>
+        <element name="ELECTRIC_VARIABLE">
+            <description>Electric variable transmission.</description>
+        </element>
+        <element name="DIRECT_DRIVE">
+            <description>Direct drive between engine and wheels.</description>
+        </element>
+    </enum>
+
     <enum name="ComponentVolumeStatus" since="2.0">
         <description>The volume status of a vehicle component.</description>
         <element name="UNKNOWN" internal_name="CVS_UNKNOWN">
@@ -4437,6 +4471,18 @@
         <param name="displayCapabilities" type="DisplayCapability" array="true" minsize="1" maxsize="1000" mandatory="false" since="6.0"/>
     </struct>
 
+    <struct name="GearStatus" since="6.2">
+        <param name="userSelectedGear" type="PRNDL" mandatory="false">
+            <description>Gear position selected by the user i.e. Park, Drive, Reverse</description>
+        </param>
+        <param name="actualGear" type="PRNDL" mandatory="false">
+            <description>Actual Gear in use by the transmission</description>
+        </param>
+        <param name="transmissionType" type="TransmissionType" mandatory="false">
+            <description>Tells the transmission type</description>
+        </param>
+    </struct>
+
     <!-- Requests/Responses -->
 
     <function name="RegisterAppInterface" functionID="RegisterAppInterfaceID" messagetype="request" since="1.0">
@@ -5847,8 +5893,14 @@
         <param name="turnSignal" type="Boolean" mandatory="false" since="5.0">
             <description>See TurnSignal</description>
         </param>
-        <param name="prndl" type="Boolean" mandatory="false">
+        <param name="gearStatus" type="Boolean" mandatory="false" since="6.2">
+            <description>See GearStatus</description>
+        </param>
+        <param name="prndl" type="Boolean" mandatory="false" deprecated="true" since="6.2">
             <description>See PRNDL</description>
+            <history>
+                <param name="prndl" type="Boolean" mandatory="false" since="1.0" until="6.2"/>
+            </history>
         </param>
         <param name="tirePressure" type="Boolean" mandatory="false">
             <description>See TireStatus</description>
@@ -5960,8 +6012,14 @@
         <param name="turnSignal" type="VehicleDataResult" mandatory="false" since="5.0">
             <description>See TurnSignal</description>
         </param>
-        <param name="prndl" type="VehicleDataResult" mandatory="false">
+        <param name="gearStatus" type="VehicleDataResult" mandatory="false" since="6.2">
+            <description>See GearStatus</description>
+        </param>
+        <param name="prndl" type="VehicleDataResult" mandatory="false" deprecated="true" since="6.2">
             <description>See PRNDL</description>
+            <history>
+                <param name="prndl" type="VehicleDataResult" mandatory="false" since="1.0" until="6.2"/>
+            </history>
         </param>
         <param name="tirePressure" type="VehicleDataResult" mandatory="false">
             <description>See TireStatus</description>
@@ -6052,8 +6110,14 @@
         <param name="turnSignal" type="Boolean" mandatory="false" since="5.0">
             <description>See TurnSignal</description>
         </param>
-        <param name="prndl" type="Boolean" mandatory="false">
+        <param name="gearStatus" type="Boolean" mandatory="false" since="6.2">
+            <description>See GearStatus</description>
+        </param>
+        <param name="prndl" type="Boolean" mandatory="false" deprecated="true" since="6.2">
             <description>See PRNDL</description>
+            <history>
+                <param name="prndl" type="Boolean" mandatory="false" since="1.0" until="6.2"/>
+            </history>
         </param>
         <param name="tirePressure" type="Boolean" mandatory="false">
             <description>See TireStatus</description>
@@ -6164,8 +6228,14 @@
         <param name="turnSignal" type="VehicleDataResult" mandatory="false" since="5.0">
             <description>See TurnSignal</description>
         </param>
-        <param name="prndl" type="VehicleDataResult" mandatory="false">
+        <param name="gearStatus" type="VehicleDataResult" mandatory="false" since="6.2">
+            <description>See GearStatus</description>
+        </param>
+        <param name="prndl" type="VehicleDataResult" mandatory="false" deprecated="true" since="6.2">
             <description>See PRNDL</description>
+            <history>
+                <param name="prndl" type="VehicleDataResult" mandatory="false" since="1.0" until="6.2"/>
+            </history>
         </param>
         <param name="tirePressure" type="VehicleDataResult" mandatory="false">
             <description>See TireStatus</description>
@@ -6259,8 +6329,14 @@
         <param name="vin" type="Boolean" mandatory="false">
             <description>Vehicle identification number</description>
         </param>
-        <param name="prndl" type="Boolean" mandatory="false">
+        <param name="gearStatus" type="Boolean" mandatory="false" since="6.2">
+            <description>See GearStatus</description>
+        </param>
+        <param name="prndl" type="Boolean" mandatory="false" deprecated="true" since="6.2">
             <description>See PRNDL</description>
+            <history>
+                <param name="prndl" type="Boolean" mandatory="false" since="1.0" until="6.2"/>
+            </history>
         </param>
         <param name="tirePressure" type="Boolean" mandatory="false">
             <description>See TireStatus</description>
@@ -6375,8 +6451,14 @@
         <param name="vin" type="String" maxlength="17" mandatory="false">
             <description>Vehicle identification number</description>
         </param>
-        <param name="prndl" type="PRNDL" mandatory="false">
+        <param name="gearStatus" type="GearStatus" mandatory="false" since="6.2">
+            <description>See GearStatus</description>
+        </param>
+        <param name="prndl" type="PRNDL" mandatory="false" deprecated="true" since="6.2">
             <description>See PRNDL</description>
+            <history>
+                <param name="prndl" type="PRNDL" mandatory="false" since="1.0" until="6.2"/>
+            </history>
         </param>
         <param name="tirePressure" type="TireStatus" mandatory="false">
             <description>See TireStatus</description>
@@ -8073,8 +8155,14 @@
         <param name="vin" type="String" maxlength="17" mandatory="false">
             <description>Vehicle identification number.</description>
         </param>
-        <param name="prndl" type="PRNDL" mandatory="false">
+        <param name="gearStatus" type="GearStatus" mandatory="false" since="6.2">
+            <description>See GearStatus</description>
+        </param>
+        <param name="prndl" type="PRNDL" mandatory="false" deprecated="true" since="6.2">
             <description>See PRNDL</description>
+            <history>
+                <param name="prndl" type="PRNDL" mandatory="false" since="1.0" until="6.2"/>
+            </history>
         </param>
         <param name="tirePressure" type="TireStatus" mandatory="false">
             <description>See TireStatus</description>

diff --git a/README.md b/README.md
@@ -1,7 +1,7 @@
 # SmartDeviceLink
 # RPC Spec
 
-###### Version: 6.0.0
+###### Version: 6.2.0
 
 ## Enumerations
 
@@ -387,6 +387,7 @@ Defines the data types that can be published and subscribed to.
 |`VEHICLEDATA_FUELCONSUMPTION`||
 |`VEHICLEDATA_EXTERNTEMP`||
 |`VEHICLEDATA_VIN`||
+|`VEHICLEDATA_GEARSTATUS`||
 |`VEHICLEDATA_PRNDL`||
 |`VEHICLEDATA_TIREPRESSURE`||
 |`VEHICLEDATA_ODOMETER`||
@@ -749,7 +750,7 @@ The selected gear.
 |`PARK`|Parking|
 |`REVERSE`|Reverse gear|
 |`NEUTRAL`|No gear|
-|`DRIVE`||
+|`DRIVE`|Regular Drive mode|
 |`SPORT`|Drive Sport mode|
 |`LOWGEAR`|1st gear hold|
 |`FIRST`||
@@ -760,10 +761,29 @@ The selected gear.
 |`SIXTH`||
 |`SEVENTH`||
 |`EIGHTH`||
+|`NINTH`||
+|`TENTH`||
 |`UNKNOWN`||
 |`FAULT`||
 
 
+### TransmissionType
+Type of transmission used in the vehicle.
+
+#### Elements
+
+| Value | Description | 
+| ---------- |:-----------:|
+|`MANUAL`|Manual transmission|
+|`AUTOMATIC`|Automatic transmission|
+|`SEMI_AUTOMATIC`|Semi automatic transmission|
+|`DUAL_CLUTCH`|Dual clutch transmission|
+|`CONTINUOUSLY_VARIABLE`|Continuously variable transmission(CVT)|
+|`INFINITELY_VARIABLE`|Infinitely variable transmission|
+|`ELECTRIC_VARIABLE`|Electric variable transmission|
+|`DIRECT_DRIVE`|Direct drive between engine and wheels|
+
+
 ### ComponentVolumeStatus
 The volume status of a vehicle component.
 
@@ -3114,6 +3134,17 @@ The systemCapabilityType identifies which data object exists in this struct. For
 |`displayCapabilities`|DisplayCapability[]|False||
 
 
+### GearStatus
+
+#### Parameters
+
+| Value |  Type | Mandatory | Description | 
+| ---------- | ---------- |:-----------: |:-----------:|
+|`userSelectedGear`|PRNDL|False|Gear position selected by the user i.e. Park, Drive, Reverse|
+|`actualGear`|PRNDL|False|Actual Gear in use by the transmission|
+|`transmissionType`|TransmissionType|False|Tells the transmission type|
+
+
 
 <div style="page-break-after: always;"></div>
 
@@ -3783,6 +3814,7 @@ Subscribes for specific published data items.
 |`fuelRange`|Boolean|False|The estimate range in KM the vehicle can travel based on fuel level and consumption|
 |`externalTemperature`|Boolean|False|The external temperature in degrees celsius|
 |`turnSignal`|Boolean|False|See TurnSignal|
+|`gearStatus`|Boolean|False|See GearStatus|
 |`prndl`|Boolean|False|See PRNDL|
 |`tirePressure`|Boolean|False|See TireStatus|
 |`odometer`|Boolean|False|Odometer in km|
@@ -3824,6 +3856,7 @@ Message Type: **response**
 |`fuelRange`|VehicleDataResult|False|The estimate range in KM the vehicle can travel based on fuel level and consumption|
 |`externalTemperature`|VehicleDataResult|False|The external temperature in degrees celsius.|
 |`turnSignal`|VehicleDataResult|False|See TurnSignal|
+|`gearStatus`|VehicleDataResult|False|See GearStatus|
 |`prndl`|VehicleDataResult|False|See PRNDL|
 |`tirePressure`|VehicleDataResult|False|See TireStatus|
 |`odometer`|VehicleDataResult|False|Odometer in km|
@@ -3864,6 +3897,7 @@ This function is used to unsubscribe the notifications from the subscribeVehicle
 |`fuelRange`|Boolean|False|The estimate range in KM the vehicle can travel based on fuel level and consumption|
 |`externalTemperature`|Boolean|False|The external temperature in degrees celsius.|
 |`turnSignal`|Boolean|False|See TurnSignal|
+|`gearStatus`|Boolean|False|See GearStatus|
 |`prndl`|Boolean|False|See PRNDL|
 |`tirePressure`|Boolean|False|See TireStatus|
 |`odometer`|Boolean|False|Odometer in km|
@@ -3905,6 +3939,7 @@ Message Type: **response**
 |`fuelRange`|VehicleDataResult|False|The estimate range in KM the vehicle can travel based on fuel level and consumption|
 |`externalTemperature`|VehicleDataResult|False|The external temperature in degrees celsius|
 |`turnSignal`|VehicleDataResult|False|See TurnSignal|
+|`gearStatus`|VehicleDataResult|False|See GearStatus|
 |`prndl`|VehicleDataResult|False|See PRNDL|
 |`tirePressure`|VehicleDataResult|False|See TireStatus|
 |`odometer`|VehicleDataResult|False|Odometer in km|
@@ -3946,6 +3981,7 @@ Non periodic vehicle data read request.
 |`externalTemperature`|Boolean|False|The external temperature in degrees celsius|
 |`turnSignal`|Boolean|False|See TurnSignal|
 |`vin`|Boolean|False|Vehicle identification number|
+|`gearStatus`|Boolean|False|See GearStatus|
 |`prndl`|Boolean|False|See PRNDL|
 |`tirePressure`|Boolean|False|See TireStatus|
 |`odometer`|Boolean|False|Odometer in km|
@@ -3988,6 +4024,7 @@ Message Type: **response**
 |`externalTemperature`|Float|False|The external temperature in degrees celsius|
 |`turnSignal`|TurnSignal|False|See TurnSignal|
 |`vin`|String|False|Vehicle identification number|
+|`gearStatus`|GearStatus|False|See GearStatus|
 |`prndl`|PRNDL|False|See PRNDL|
 |`tirePressure`|TireStatus|False|See TireStatus|
 |`odometer`|Integer|False|Odometer in km|
@@ -5075,6 +5112,7 @@ Callback for the periodic and non periodic vehicle data read function.
 |`externalTemperature`|Float|False|The external temperature in degrees celsius|
 |`turnSignal`|TurnSignal|False|See TurnSignal|
 |`vin`|String|False|Vehicle identification number.|
+|`gearStatus`|GearStatus|False|See GearStatus|
 |`prndl`|PRNDL|False|See PRNDL|
 |`tirePressure`|TireStatus|False|See TireStatus|
 |`odometer`|Integer|False|Odometer in km|