indicates a downloadable version.) the interfaces and intent definitions here. Common Interfaces
The Common Interfaces encapsulate behaviors that FCA requires for our apps but are not supported by Android™.
These interfaces will be implemented by all of the R1 HU suppliers allowing apps to run on any of our R1
Android™ platforms. You can download (
indicates a downloadable version.) the interfaces and intent definitions here.
Get Set-Up to start building apps to use these interfaces in Android™ Studio.
The Loader page has code and instructions on how to use the interfaces specified here in your app. Special instructions are required to implement a manager loader which will dynamically load the manager that is associated with the requested interfaces at runtime
You may also be interested in CAN Simulation. The CAN Simulator can transmit simulated CAN signal values using a java panel or scripted input in a CSV formatted file to an emulated Android device running on the same computer.
Interfaces and Intent Definitions:
Release Notes and Known Issues
| View | Download | Version | Date | Change Request | Change Description |
|---|---|---|---|---|---|
| View |
|
2.2 | 09/08/2020 | DCR16562-16563 | Approved MY22 release. Includes CAN dataAPI added to support M182/9 (ICE & BEV), ECO Coaching, Drive Alerts,Maserati MHEV, Maserati M240 Vehicle Info, BEV, Performance Pages, and Drive Modes,and "2+2 scheduling". A new API addedto allow 2nd party apps to share event informationwith the firmware. |
| View |
|
2.1 | 07/30/2020 | DCR16346-16347 | Approved MY22 release. Vehicle-Interface and Application Framework Changes to Support MY22 Features. Included are the ability to pre-install widgets on the home page, API to support rear seat entertainment, new signals to support electric vehicles, corrected tire pressure signals, ability to support FOTA push from FCA backend, added enhanced sound signals for Maserati Drive Modes, and updated API for Connected Profile. |
| View |
|
2.0 | 06/17/2020 | DCR16054-16055 | Approved MY22 release. Vehicle-Interface and Application Framework Changes to Support MY22 Features. Dynamic tab text as well as show and install conditions added for Alfa to the manifest. Removal of RFHub API and the API allowing the HU to be turned off. CAN data added to support new features. Added a new settings manager to retrieve settings maintained by the firmware. |
| View |
|
1.5 | 05/04/2020 | DCR15834-15835 | Approved, Added signals STATUS_CCAN13::PressureValue_LHF_Tyre, STATUS_CCAN13::PressureValue_LHR_Tyre, STATUS_CCAN13::PressureValue_RHF_Tyre, STATUS_CCAN13::PressureValue_RHR_Tyre, STATUS_CCAN13::InflationState_LHF_Tyre1, STATUS_CCAN13::InflationState_LHR_Tyre1, STATUS_CCAN13::InflationState_RHF_Tyre1, and STATUS_CCAN13::InflationState_RHR_Tyre1 for the Maserati M240 My Car app |
| View |
|
1.4 | 04/30/2020 | DCR15836-15838 | Approved, updates are pitch and roll transfer function update, clarification for platform version API, tire pressure return value update, added missed permission, and added AppManager error code. |
| View |
|
1.3 | 01/21/2020 | DCR15077 | Approved, changes to remove the firmware dependancy on protobuffers, addition of missing SRT CAN signals, and updated custom permissions apk. |
| View |
|
1.2 | 11/05/2019 | DCR14629 | Re-Release, Approved, refactored interface package names, added API permissions, moved the speed lockout API, AppManager updates, added API to support FOTA update, refactored several WiFi API in TBM Controller, removed enumerations for all proxies. |
| View |
|
1.2 | 10/25/2019 | DCR14629 | Approved, known issues fixed. |
| View |
|
1.1 | 8/19/2019 | DCR14224 | Approved, Loader stub added, known issues fixed, AppManager.java added, CAN data access classes updated, connectivity classes updated, TBM controller class updated. |
| View |
|
1.0 | 5/23/2019 | DCR13822 | Approved, initial version. |
CAE Interface contains all of the Common API interfaces for the release indicated. The interfaces prior to the CAE 2.2 release were broken down into multiple downloads. As of CAE 2.2 all of the interfaces will be available here.
Download FCA CAE Interfaces
| Download | Version | Date | Change Request | Change Description |
|---|---|---|---|---|
|
|
2.2 | 09/08/2020 | DCR16562-16563 | MY22 release. Includes CAN data API added to support M182/9 (ICE & BEV), ECO Coaching, Drive Alerts, Maserati MHEV, Maserati M240 Vehicle Info, BEV, Performance Pages, and Drive Modes, and "2+2 scheduling". A new API addedto allow 2nd party apps to share event information with the firmware. |
Base Interface is the base interface for all Common API interfaces.
Note: Base interface is now included with FCA Car Service (Connected).
Download FCA Base Interface
| Download | Version | Date | Change Request | Change Description |
|---|---|---|---|---|
| NA | 1.2 | 11/05/2019 | DCR14629 | MY21 re-release. Base interface is now included with FCA Car Service (Connected). |
|
|
1.0 | 5/23/2019 | DCR13822 | Approved, initial version. |
|
|
1.0 | 3/22/2019 | N/A | Pre-release, initial version. |
Application Manager contains intent and constant definitions for application management.
Sample code that uses the AppManager intents can be found on the Code Samples page.
Download AppManager
| Download | Version | Date | Change Request | Change Description |
|---|---|---|---|---|
|
|
2.1 | 07/30/2020 | DCR16346-16347 | MY22, no changes. Version updated and released as part of complete package. |
|
|
2.0 | 06/17/2020 | DCR16054-16055 | MY22, no changes. Version updated and released as part of complete package. |
|
|
1.5 | 05/04/2020 | DCR15834-15835 | MY21, no changes. Version updated and released as part of complete package. |
|
|
1.4 | 04/30/2020 | DCR15836-15838 | MY21, added ERROR_INSTALL_CONDITION to support install condition error checking. |
|
|
1.3 | 01/21/2020 | DCR15077 | MY21, Updated the sequence of events in clear personal data to better support handling TBM clear personal data failure. Changed references to ERROR_PACKAGE_NOT_FOUND to ERROR_APK_NOT_FOUND. |
|
|
1.2 | 11/05/2019 | DCR14629 | MY21 re-release. Added intent execution sequences, removed the phone check requirement, DRM will be a signed jar file, revised error codes, moved example code, updated parameters for each intent, added a second param to getDRM. |
|
|
1.2 | 10/25/2019 | DCR14629 | MY21, updates based on Harman proposal. Added error values for verify DRM to determine subscribed, registered. AppManager_intent.txt is no longer valid. |
|
|
1.1 | 8/19/2019 | DCR14224 | Approved. The intent definitions are now contained in a java class. The new AppManager.java overrides the previous AppManager_intent.txt definitions. AppManager_intent.txt is no longer valid. |
|
|
1.1 | 6/26/2019 | N/A | Pre-release. |
|
|
1.0 | 5/23/2019 | DCR13822 | Approved, initial version. |
|
|
1.0 | 3/22/2019 | N/A | Pre-release, initial version. |
Loader & Stub contains the manager loader interface and the manager stub that is used for compiling an app.
The managers that implement the Common App interfaces will be packaged in fca.loader.jar and the apps need to reference it in the manifest using the uses-library tag with android:name="fca.loader" and android:required="true".
Download Loader & Stub
| Download | Version | Date | Change Request | Change Description |
|---|---|---|---|---|
|
|
2.1 | 07/30/2020 | DCR16346-16347 | MY22, no changes. Version updated and released as part of complete package. |
|
|
2.0 | 06/17/2020 | DCR16054-16055 | MY22, no changes. Version updated and released as part of complete package. |
|
|
1.5 | 05/04/2020 | DCR15834-15835 | MY21, no changes. Released as part of complete package. |
|
|
1.4 | 04/30/2020 | DCR15836-15838 | MY21, no changes. Released as part of complete package. |
|
|
1.3 | 01/21/2020 | DCR15077 | MY21, no changes. Released as part of complete package. |
|
|
1.2 | 11/12/2019 | DCR14629 | MY21 missed content. |
|
|
1.2 | 11/05/2019 | DCR14629 | MY21 re-release. Updated version. |
|
|
1.2 | 10/25/2019 | DCR14629 | Approved. See release notes. |
|
|
1.1 | 8/19/2019 | DCR14224 | Approved. Loader Interface and manager stub added. |
|
|
1.1 | 6/26/2019 | N/A | Pre-release. |
TBM Controller is the interface for communication with the TBM.
Download TBMController
| Download | Version | Date | Change Request | Change Description |
|---|---|---|---|---|
|
|
2.1 | 07/30/2020 | DCR16346-16347 | MY22, no changes. Version updated and released as part of complete package. |
|
|
2.0 | 06/17/2020 | DCR16054-16055 | MY22, no changes. Version updated and released as part of complete package. |
|
|
1.5 | 05/04/2020 | DCR15834-15835 | MY21, no changes. Released as part of complete package. |
|
|
1.4 | 04/30/2020 | DCR15836-15838 | MY21, no changes. Released as part of complete package. |
|
|
1.3 | 01/21/2020 | DCR15077 | MY21, added comments that data is cleaned up on factory reset. |
|
|
1.2 | 11/05/2019 | DCR14629 | MY21 re-release. Removed getWiFiOnOff, onWiFiOnOffChanged, moved onWiFiStsChanged(int) from FcaSignalStatusChange to FcaWiFiStateChange to support VF658 behavior. Removed startECall as no use-cases could be found to support having two methods. Added method permissions. Removed TYPE_CALL_AutoAssistCall. Added a timeout exception to getWiFiPassword. |
|
|
1.2 | 10/25/2019 | DCR14629 | Approved. MY21, removed getWiFiOnOff, onWiFiOnOffChanged, moved onWiFiStsChanged(int) from FcaSignalStatusChange to FcaWiFiStateChange to support VF658 behavior. Removed startECall as no use-cases could be found to support having two methods. Added method permissions. Removed TYPE_CALL_AutoAssistCall. Added a timeout exception to getWiFiPassword. |
|
|
1.1 | 8/19/2019 | DCR14224 | Approved. Updated based on supplier comments. See release notes. |
|
|
1.1 | 6/26/2019 | N/A | Pre-release, updated 07/19/2019. |
|
|
1.0 | 5/23/2019 | DCR13822 | Approved, initial version. |
|
|
1.0 | 3/22/2019 | N/A | Pre-release, initial version. |
FCA Car Service (CAN) is the interface for getting, setting, and receiving change notifications for CAN data. You will find downloads for the Transfer Functions associated with these API on the CAN Data Retrieval page.
Download FCA Car Service CAN Interfaces
| Download | Version | Date | Change Request | Change Description |
|---|---|---|---|---|
|
|
2.1 | 07/30/2020 | DCR16346-16347 | MY22, please see release notes for updates to IEVManager, IVehicleComfortManager, IVehicleDriveStatusManager, IVehicleExtrasManager, and IVehicleStatusManager |
|
|
2.0 | 06/17/2020 | DCR16054-16055 | MY22, please see release notes for updates to IVehicleStatusManager, IEVManager, IVehicleDriveStatusManager, IEVManager, and IVehicleExtrasManager |
|
|
1.5 | 05/04/2020 | DCR15834-15835 | Added signals STATUS_CCAN13::PressureValue_LHF_Tyre, STATUS_CCAN13::PressureValue_LHR_Tyre, STATUS_CCAN13::PressureValue_RHF_Tyre, STATUS_CCAN13::PressureValue_RHR_Tyre, STATUS_CCAN13::InflationState_LHF_Tyre1, STATUS_CCAN13::InflationState_LHR_Tyre1, STATUS_CCAN13::InflationState_RHF_Tyre1, and STATUS_CCAN13::InflationState_RHR_Tyre1 for the Maserati M240 My Car app to IVehicleDriveStatusManager. |
|
|
1.4 | 04/30/2020 | DCR15836-15838 | Change return values from int to float for all TirePressXX methodsIVehicleDriveStatusManager. |
|
|
1.3 | 01/21/2020 | DCR15077 | MY21, added missing SRT signals. |
|
|
1.2 | 11/05/2019 | DCR14629 | MY21 re-release. See release notes. |
|
|
1.2 | 10/25/2019 | DCR14629 | Approved. Updated based on supplier comments. See release notes. |
|
|
1.1 | 8/19/2019 | DCR14224 | Approved. Updated based on supplier comments. See release notes. |
|
|
1.1 | 6/26/2019 | N/A | Pre-release. |
|
|
1.0 | 5/23/2019 | DCR13822 | Approved, initial version. |
|
|
1.0 | 3/22/2019 | N/A | Pre-release, initial version. |
FCA Car Service (Connected) are the interfaces for getting, setting, and receiving change notifications for connected services.
Download FCA Car Service Connected Interfaces
| Download | Version | Date | Change Request | Change Description |
|---|---|---|---|---|
|
|
2.1 | 07/30/2020 | DCR16346-16347 | MY22, please see release notes for updates to IProfileManager and IRSEManager. |
|
|
2.0 | 06/17/2020 | DCR16054-16055 | MY22, please see release notes for updates to ISettingsManager. |
|
|
1.5 | 05/04/2020 | DCR15834-15835 | MY21, no changes. Released as part of complete package. |
|
|
1.4 | 04/30/2020 | DCR15836-15838 | Added clarification for the return values for getPlatformVariant and getPlatformVersion methods in IVariantInfo. Removed comment that protobuf java 3.10.0 jar is required in IProfileManager. |
|
|
1.3 | 01/21/2020 | DCR15077 | MY21, removed protobuffer from connected profiles. |
|
|
1.2 | 11/05/2019 | DCR14629 | MY21 re-release. See release notes. |
|
|
1.2 | 10/25/2019 | DCR14629 | Approved. See release notes. |
|
|
1.1 | 8/19/2019 | DCR14224 | Approved. Updated based on supplier comments. See release notes. |
|
|
1.1 | 6/26/2019 | N/A | Pre-release. |
|
|
1.0 | 5/23/2019 | DCR13822 | Approved, initial version. |
|
|
1.0 | 3/22/2019 | N/A | Pre-release, initial version. |
FCA Car Service Exceptions are the exception classes used by the interfaces.
Download FCA Car Service Exceptions
| Download | Version | Date | Change Request | Change Description |
|---|---|---|---|---|
|
|
2.1 | 07/30/2020 | DCR16346-16347 | MY22, no changes. Version updated and released as part of complete package. |
|
|
2.0 | 06/17/2020 | DCR16054-16055 | MY22, no changes. Version updated and released as part of complete package. |
|
|
1.5 | 05/04/2020 | DCR15834-15835 | MY21, no changes. Released as part of complete package. |
|
|
1.4 | 04/30/2020 | DCR15836-15838 | MY21, no changes. Released as part of complete package. |
|
|
1.3 | 01/21/2020 | DCR15077 | MY21, no changes. Released as part of complete package. |
|
|
1.2 | 11/05/2019 | DCR14629 | MY21 re-release. Added param to InvalidId and added TimeoutException. |
|
|
1.0 | 5/23/2019 | DCR13822 | Approved, initial version. |
|
|
1.0 | 3/22/2019 | N/A | Pre-release, initial version. |
Updated: 09/16/2020, Android™ is a trademark of Google LLC