homebridge-fordpass

homebridge-fordpass

Control your Ford vehicle in HomeKit using Homebridge with this plugin.

WARNING

Ford is locking accounts of users who use this plug-in. See #196 for more info.

Prerequisites

Your vehicle must be connected to FordPass Connect. Download the app or contact your local dealer to see if your vehicle is compatible with FordPass Connect.

Google Play Store  Apple AppStore

Installation

1. Install this plugin using: npm install -g --unsafe-perm homebridge-fordpass
2. Add username, passwrod, and vehicles to config.json
3. Run Homebridge

Config.json Example

{
    "batteryName": "Battery",
    "autoRefresh": true,
    "refreshRate": 30,
    "chargingSwitch": true,
    "plugSwitch": true,
    "application_id": "APPLICATION_ID",
    "client_id": "CLIENT_ID",
    "client_secret": "SECRET_ID",
    "code": "FORD_AUTH_CODE",
    "platform": "FordPass"
}

FordPass API Signup Process

1. First, you MUST have a FordPass account. If you don't, you will need to do that first and that's outside of the scope for these instructions. Start here
2. Sign up at FordPass API program at developer.ford.com.
3. Go to FordConnect and request access.
4. Create Application Credentials at https://developer.ford.com/my-developer-account/my-dashboard and copy Secret 1 Hint.
5. Paste Secret into "client_secret" property of config.
6. Construct this URL in your Browser:

https://fordconnect.cv.ford.com/common/login/?make=F&application_id=AFDC085B-377A-4351-B23E-5E1D35FB3700&client_id=30990062-9618-40e1-a27b-7c6bcb23658a&response_type=code&state=123&redirect_uri=https%3A%2F%2Flocalhost%3A3000&scope=access

1. application_id and client_id may be different. Review the FordPass API Documentation found in the Ford Developer website to verify if different. application_id goes into "application_id" of config and client_id goes into "client_id" of config.
2. Sign in with your FordPass login that you use for FordPass' app.
3. Select the car you wish to integrate with.
4. Click Authorize
5. The page will eventually send you to an invalid page. This is normal. Copy the URL into a notepad, delete everything from the beginning of the url until after code=
6. Take the remaining text and copy it for the FordPass Plugin config's "code" property.

Things to try

• "Hey siri, turn on my car."
• "Hey siri, is the mustang locked?"
• "Hey siri, lock the raptor."
• "Hey siri, what is the fuel level of my fusion?"

Donate to Support homebridge-fordpass

This plugin was made with you in mind. If you would like to show your appreciation for its continued development, please consider sponsoring me on Github.

_{^{Disclaimer: This plugin and its contributers are not affiliated with Ford Motor Company in any way.}}