Skip to content

Commit 78bdb2e

Browse files
mkorniichukmkorniichuk
committed
New vehicle data: GearStatus
1 parent c5132e0 commit 78bdb2e

File tree

2 files changed

+139
-13
lines changed

2 files changed

+139
-13
lines changed

‎MOBILE_API.xml‎

Lines changed: 99 additions & 11 deletions
Original file line numberDiff line numberDiff line change
@@ -1,7 +1,7 @@
11
<?xml version="1.0" standalone="no"?>
22
<?xml-stylesheet type="text/xml" href="protocol2html.xsl"?>
33

4-
<interface name="SmartDeviceLink RAPI" version="6.0.0" minVersion="1.0" date="2019-03-19">
4+
<interface name="SmartDeviceLink RAPI" version="6.2.0" minVersion="1.0" date="2019-03-19">
55
<enum name="Result" internal_scope="base" since="1.0">
66
<element name="SUCCESS">
77
<description>The request succeeded</description>
@@ -545,7 +545,8 @@
545545
<element name="VEHICLEDATA_FUELCONSUMPTION" />
546546
<element name="VEHICLEDATA_EXTERNTEMP" />
547547
<element name="VEHICLEDATA_VIN" />
548-
<element name="VEHICLEDATA_PRNDL" />
548+
<element name="VEHICLEDATA_GEARSTATUS" since="6.2"/>
549+
<element name="VEHICLEDATA_PRNDL" until="6.2"/>
549550
<element name="VEHICLEDATA_TIREPRESSURE" />
550551
<element name="VEHICLEDATA_ODOMETER" />
551552
<element name="VEHICLEDATA_BELTSTATUS" />
@@ -1186,7 +1187,7 @@
11861187
<description>Longitude and latitude and altitude</description>
11871188
</element>
11881189
</enum>
1189-
1190+
11901191
<enum name="PRNDL" since="2.0">
11911192
<description>The selected gear.</description>
11921193
<element name="PARK">
@@ -1199,6 +1200,7 @@
11991200
<description>No gear</description>
12001201
</element>
12011202
<element name="DRIVE">
1203+
<description>Regular Drive mode</description>
12021204
</element>
12031205
<element name="SPORT">
12041206
<description>Drive Sport mode</description>
@@ -1222,12 +1224,44 @@
12221224
</element>
12231225
<element name="EIGHTH">
12241226
</element>
1227+
<element name="NINTH" since="6.2">
1228+
</element>
1229+
<element name="TENTH" since="6.2">
1230+
</element>
12251231
<element name="UNKNOWN">
12261232
</element>
12271233
<element name="FAULT">
12281234
</element>
12291235
</enum>
1230-
1236+
1237+
<enum name="TransmissionType" since="6.2">
1238+
<description>Type of transmission used in the vehicle.</description>
1239+
<element name="MANUAL">
1240+
<description>Manual transmission.</description>
1241+
</element>
1242+
<element name="AUTOMATIC">
1243+
<description>Automatic transmission.</description>
1244+
</element>
1245+
<element name="SEMI_AUTOMATIC">
1246+
<description>Semi automatic transmission.</description>
1247+
</element>
1248+
<element name="DUAL_CLUTCH">
1249+
<description>Dual clutch transmission.</description>
1250+
</element>
1251+
<element name="CONTINUOUSLY_VARIABLE">
1252+
<description>Continuously variable transmission(CVT).</description>
1253+
</element>
1254+
<element name="INFINITELY_VARIABLE">
1255+
<description>Infinitely variable transmission.</description>
1256+
</element>
1257+
<element name="ELECTRIC_VARIABLE">
1258+
<description>Electric variable transmission.</description>
1259+
</element>
1260+
<element name="DIRECT_DRIVE">
1261+
<description>Direct drive between engine and wheels.</description>
1262+
</element>
1263+
</enum>
1264+
12311265
<enum name="ComponentVolumeStatus" since="2.0">
12321266
<description>The volume status of a vehicle component.</description>
12331267
<element name="UNKNOWN" internal_name="CVS_UNKNOWN">
@@ -4437,6 +4471,18 @@
44374471
<param name="displayCapabilities" type="DisplayCapability" array="true" minsize="1" maxsize="1000" mandatory="false" since="6.0"/>
44384472
</struct>
44394473

4474+
<struct name="GearStatus" since="6.2">
4475+
<param name="userSelectedGear" type="PRNDL" mandatory="false">
4476+
<description>Gear position selected by the user i.e. Park, Drive, Reverse</description>
4477+
</param>
4478+
<param name="actualGear" type="PRNDL" mandatory="false">
4479+
<description>Actual Gear in use by the transmission</description>
4480+
</param>
4481+
<param name="transmissionType" type="TransmissionType" mandatory="false">
4482+
<description>Tells the transmission type</description>
4483+
</param>
4484+
</struct>
4485+
44404486
<!-- Requests/Responses -->
44414487

44424488
<function name="RegisterAppInterface" functionID="RegisterAppInterfaceID" messagetype="request" since="1.0">
@@ -5847,8 +5893,14 @@
58475893
<param name="turnSignal" type="Boolean" mandatory="false" since="5.0">
58485894
<description>See TurnSignal</description>
58495895
</param>
5850-
<param name="prndl" type="Boolean" mandatory="false">
5896+
<param name="gearStatus" type="Boolean" mandatory="false" since="6.2">
5897+
<description>See GearStatus</description>
5898+
</param>
5899+
<param name="prndl" type="Boolean" mandatory="false" deprecated="true" since="6.2">
58515900
<description>See PRNDL</description>
5901+
<history>
5902+
<param name="prndl" type="Boolean" mandatory="false" since="1.0" until="6.2"/>
5903+
</history>
58525904
</param>
58535905
<param name="tirePressure" type="Boolean" mandatory="false">
58545906
<description>See TireStatus</description>
@@ -5960,8 +6012,14 @@
59606012
<param name="turnSignal" type="VehicleDataResult" mandatory="false" since="5.0">
59616013
<description>See TurnSignal</description>
59626014
</param>
5963-
<param name="prndl" type="VehicleDataResult" mandatory="false">
6015+
<param name="gearStatus" type="VehicleDataResult" mandatory="false" since="6.2">
6016+
<description>See GearStatus</description>
6017+
</param>
6018+
<param name="prndl" type="VehicleDataResult" mandatory="false" deprecated="true" since="6.2">
59646019
<description>See PRNDL</description>
6020+
<history>
6021+
<param name="prndl" type="VehicleDataResult" mandatory="false" since="1.0" until="6.2"/>
6022+
</history>
59656023
</param>
59666024
<param name="tirePressure" type="VehicleDataResult" mandatory="false">
59676025
<description>See TireStatus</description>
@@ -6052,8 +6110,14 @@
60526110
<param name="turnSignal" type="Boolean" mandatory="false" since="5.0">
60536111
<description>See TurnSignal</description>
60546112
</param>
6055-
<param name="prndl" type="Boolean" mandatory="false">
6113+
<param name="gearStatus" type="Boolean" mandatory="false" since="6.2">
6114+
<description>See GearStatus</description>
6115+
</param>
6116+
<param name="prndl" type="Boolean" mandatory="false" deprecated="true" since="6.2">
60566117
<description>See PRNDL</description>
6118+
<history>
6119+
<param name="prndl" type="Boolean" mandatory="false" since="1.0" until="6.2"/>
6120+
</history>
60576121
</param>
60586122
<param name="tirePressure" type="Boolean" mandatory="false">
60596123
<description>See TireStatus</description>
@@ -6164,8 +6228,14 @@
61646228
<param name="turnSignal" type="VehicleDataResult" mandatory="false" since="5.0">
61656229
<description>See TurnSignal</description>
61666230
</param>
6167-
<param name="prndl" type="VehicleDataResult" mandatory="false">
6231+
<param name="gearStatus" type="VehicleDataResult" mandatory="false" since="6.2">
6232+
<description>See GearStatus</description>
6233+
</param>
6234+
<param name="prndl" type="VehicleDataResult" mandatory="false" deprecated="true" since="6.2">
61686235
<description>See PRNDL</description>
6236+
<history>
6237+
<param name="prndl" type="VehicleDataResult" mandatory="false" since="1.0" until="6.2"/>
6238+
</history>
61696239
</param>
61706240
<param name="tirePressure" type="VehicleDataResult" mandatory="false">
61716241
<description>See TireStatus</description>
@@ -6259,8 +6329,14 @@
62596329
<param name="vin" type="Boolean" mandatory="false">
62606330
<description>Vehicle identification number</description>
62616331
</param>
6262-
<param name="prndl" type="Boolean" mandatory="false">
6332+
<param name="gearStatus" type="Boolean" mandatory="false" since="6.2">
6333+
<description>See GearStatus</description>
6334+
</param>
6335+
<param name="prndl" type="Boolean" mandatory="false" deprecated="true" since="6.2">
62636336
<description>See PRNDL</description>
6337+
<history>
6338+
<param name="prndl" type="Boolean" mandatory="false" since="1.0" until="6.2"/>
6339+
</history>
62646340
</param>
62656341
<param name="tirePressure" type="Boolean" mandatory="false">
62666342
<description>See TireStatus</description>
@@ -6375,8 +6451,14 @@
63756451
<param name="vin" type="String" maxlength="17" mandatory="false">
63766452
<description>Vehicle identification number</description>
63776453
</param>
6378-
<param name="prndl" type="PRNDL" mandatory="false">
6454+
<param name="gearStatus" type="GearStatus" mandatory="false" since="6.2">
6455+
<description>See GearStatus</description>
6456+
</param>
6457+
<param name="prndl" type="PRNDL" mandatory="false" deprecated="true" since="6.2">
63796458
<description>See PRNDL</description>
6459+
<history>
6460+
<param name="prndl" type="PRNDL" mandatory="false" since="1.0" until="6.2"/>
6461+
</history>
63806462
</param>
63816463
<param name="tirePressure" type="TireStatus" mandatory="false">
63826464
<description>See TireStatus</description>
@@ -8073,8 +8155,14 @@
80738155
<param name="vin" type="String" maxlength="17" mandatory="false">
80748156
<description>Vehicle identification number.</description>
80758157
</param>
8076-
<param name="prndl" type="PRNDL" mandatory="false">
8158+
<param name="gearStatus" type="GearStatus" mandatory="false" since="6.2">
8159+
<description>See GearStatus</description>
8160+
</param>
8161+
<param name="prndl" type="PRNDL" mandatory="false" deprecated="true" since="6.2">
80778162
<description>See PRNDL</description>
8163+
<history>
8164+
<param name="prndl" type="PRNDL" mandatory="false" since="1.0" until="6.2"/>
8165+
</history>
80788166
</param>
80798167
<param name="tirePressure" type="TireStatus" mandatory="false">
80808168
<description>See TireStatus</description>

‎README.md‎

Lines changed: 40 additions & 2 deletions
Original file line numberDiff line numberDiff line change
@@ -1,7 +1,7 @@
11
# SmartDeviceLink
22
# RPC Spec
33

4-
###### Version: 6.0.0
4+
###### Version: 6.2.0
55

66
## Enumerations
77

@@ -387,6 +387,7 @@ Defines the data types that can be published and subscribed to.
387387
|`VEHICLEDATA_FUELCONSUMPTION`||
388388
|`VEHICLEDATA_EXTERNTEMP`||
389389
|`VEHICLEDATA_VIN`||
390+
|`VEHICLEDATA_GEARSTATUS`||
390391
|`VEHICLEDATA_PRNDL`||
391392
|`VEHICLEDATA_TIREPRESSURE`||
392393
|`VEHICLEDATA_ODOMETER`||
@@ -749,7 +750,7 @@ The selected gear.
749750
|`PARK`|Parking|
750751
|`REVERSE`|Reverse gear|
751752
|`NEUTRAL`|No gear|
752-
|`DRIVE`||
753+
|`DRIVE`|Regular Drive mode|
753754
|`SPORT`|Drive Sport mode|
754755
|`LOWGEAR`|1st gear hold|
755756
|`FIRST`||
@@ -760,10 +761,29 @@ The selected gear.
760761
|`SIXTH`||
761762
|`SEVENTH`||
762763
|`EIGHTH`||
764+
|`NINTH`||
765+
|`TENTH`||
763766
|`UNKNOWN`||
764767
|`FAULT`||
765768

766769

770+
### TransmissionType
771+
Type of transmission used in the vehicle.
772+
773+
#### Elements
774+
775+
| Value | Description |
776+
| ---------- |:-----------:|
777+
|`MANUAL`|Manual transmission|
778+
|`AUTOMATIC`|Automatic transmission|
779+
|`SEMI_AUTOMATIC`|Semi automatic transmission|
780+
|`DUAL_CLUTCH`|Dual clutch transmission|
781+
|`CONTINUOUSLY_VARIABLE`|Continuously variable transmission(CVT)|
782+
|`INFINITELY_VARIABLE`|Infinitely variable transmission|
783+
|`ELECTRIC_VARIABLE`|Electric variable transmission|
784+
|`DIRECT_DRIVE`|Direct drive between engine and wheels|
785+
786+
767787
### ComponentVolumeStatus
768788
The volume status of a vehicle component.
769789

@@ -3114,6 +3134,17 @@ The systemCapabilityType identifies which data object exists in this struct. For
31143134
|`displayCapabilities`|DisplayCapability[]|False||
31153135

31163136

3137+
### GearStatus
3138+
3139+
#### Parameters
3140+
3141+
| Value | Type | Mandatory | Description |
3142+
| ---------- | ---------- |:-----------: |:-----------:|
3143+
|`userSelectedGear`|PRNDL|False|Gear position selected by the user i.e. Park, Drive, Reverse|
3144+
|`actualGear`|PRNDL|False|Actual Gear in use by the transmission|
3145+
|`transmissionType`|TransmissionType|False|Tells the transmission type|
3146+
3147+
31173148

31183149
<div style="page-break-after: always;"></div>
31193150

@@ -3783,6 +3814,7 @@ Subscribes for specific published data items.
37833814
|`fuelRange`|Boolean|False|The estimate range in KM the vehicle can travel based on fuel level and consumption|
37843815
|`externalTemperature`|Boolean|False|The external temperature in degrees celsius|
37853816
|`turnSignal`|Boolean|False|See TurnSignal|
3817+
|`gearStatus`|Boolean|False|See GearStatus|
37863818
|`prndl`|Boolean|False|See PRNDL|
37873819
|`tirePressure`|Boolean|False|See TireStatus|
37883820
|`odometer`|Boolean|False|Odometer in km|
@@ -3824,6 +3856,7 @@ Message Type: **response**
38243856
|`fuelRange`|VehicleDataResult|False|The estimate range in KM the vehicle can travel based on fuel level and consumption|
38253857
|`externalTemperature`|VehicleDataResult|False|The external temperature in degrees celsius.|
38263858
|`turnSignal`|VehicleDataResult|False|See TurnSignal|
3859+
|`gearStatus`|VehicleDataResult|False|See GearStatus|
38273860
|`prndl`|VehicleDataResult|False|See PRNDL|
38283861
|`tirePressure`|VehicleDataResult|False|See TireStatus|
38293862
|`odometer`|VehicleDataResult|False|Odometer in km|
@@ -3864,6 +3897,7 @@ This function is used to unsubscribe the notifications from the subscribeVehicle
38643897
|`fuelRange`|Boolean|False|The estimate range in KM the vehicle can travel based on fuel level and consumption|
38653898
|`externalTemperature`|Boolean|False|The external temperature in degrees celsius.|
38663899
|`turnSignal`|Boolean|False|See TurnSignal|
3900+
|`gearStatus`|Boolean|False|See GearStatus|
38673901
|`prndl`|Boolean|False|See PRNDL|
38683902
|`tirePressure`|Boolean|False|See TireStatus|
38693903
|`odometer`|Boolean|False|Odometer in km|
@@ -3905,6 +3939,7 @@ Message Type: **response**
39053939
|`fuelRange`|VehicleDataResult|False|The estimate range in KM the vehicle can travel based on fuel level and consumption|
39063940
|`externalTemperature`|VehicleDataResult|False|The external temperature in degrees celsius|
39073941
|`turnSignal`|VehicleDataResult|False|See TurnSignal|
3942+
|`gearStatus`|VehicleDataResult|False|See GearStatus|
39083943
|`prndl`|VehicleDataResult|False|See PRNDL|
39093944
|`tirePressure`|VehicleDataResult|False|See TireStatus|
39103945
|`odometer`|VehicleDataResult|False|Odometer in km|
@@ -3946,6 +3981,7 @@ Non periodic vehicle data read request.
39463981
|`externalTemperature`|Boolean|False|The external temperature in degrees celsius|
39473982
|`turnSignal`|Boolean|False|See TurnSignal|
39483983
|`vin`|Boolean|False|Vehicle identification number|
3984+
|`gearStatus`|Boolean|False|See GearStatus|
39493985
|`prndl`|Boolean|False|See PRNDL|
39503986
|`tirePressure`|Boolean|False|See TireStatus|
39513987
|`odometer`|Boolean|False|Odometer in km|
@@ -3988,6 +4024,7 @@ Message Type: **response**
39884024
|`externalTemperature`|Float|False|The external temperature in degrees celsius|
39894025
|`turnSignal`|TurnSignal|False|See TurnSignal|
39904026
|`vin`|String|False|Vehicle identification number|
4027+
|`gearStatus`|GearStatus|False|See GearStatus|
39914028
|`prndl`|PRNDL|False|See PRNDL|
39924029
|`tirePressure`|TireStatus|False|See TireStatus|
39934030
|`odometer`|Integer|False|Odometer in km|
@@ -5075,6 +5112,7 @@ Callback for the periodic and non periodic vehicle data read function.
50755112
|`externalTemperature`|Float|False|The external temperature in degrees celsius|
50765113
|`turnSignal`|TurnSignal|False|See TurnSignal|
50775114
|`vin`|String|False|Vehicle identification number.|
5115+
|`gearStatus`|GearStatus|False|See GearStatus|
50785116
|`prndl`|PRNDL|False|See PRNDL|
50795117
|`tirePressure`|TireStatus|False|See TireStatus|
50805118
|`odometer`|Integer|False|Odometer in km|

0 commit comments

Comments
 (0)