homebridge-jlr-remote

Jaguar Land Rover Remote Platform for Homebridge. This Homebridge platform supercedes the deprecated Jaguar Land Rover InControl plug-in.

You can download the Homebridge Platform from here.

Overview

The Jaguar Land Rover Remote Platform will provides Apple HomeKit-compatible services and controls for:

• Battery information (EVs-only);
• Charging information (EVs-only)
• Door lock/unlocking;
• Vehicle pre-conditioning;
• Vehicle information.

The platform will provide this for each car added to the configuration and that is associated with the account.

Configuring the platform

Example config.json:

{
    "platforms": [{
        "platform": "JaguarLandRoverRemote",
        "username": "foo@bar.uk",
        "password": "baa",
        "pin": 1234,
        "deviceId": "some UUID",
        "temperatureScale": "C",
        "vehicles": [{
            "name": "I-PACE",
            "vin": "1AAAAA111AA111111",
            "lowBatteryThreshold": 25,
            "targetTemperature": 21
        },{
            "name": "Range Rover",
            "vin": "2AAAAA111AA111111"
        }]
    }]
}

Platform configuraiton values

• name must be JaguarLandRoverRemote, as this defines the platform.
• username is the value you use to log into the Jaguar Land Rover Remote app.
• password is the value you use to log into the Jaguar Land Rover Remote app.
• pin is the value you use to unlock the Jaguar Land Rover Remote app.
• deviceId needs to be a unique device identifier to identify your Homebridge. You can generate one here.
• temperatureScale defines whether you want to configure climate control in Celcius or Fahrenheit.
  • Allowable values: C or F.
  • Default value: C.
• vehicles defines a list of vehicles that you want making available in the Apple Home app.

Vehicle configuration values

• Required: vin defines the vehicle identification number.
• Optional: name defines the name of the vehicle for use in the Home app and voice commands.
  • Default value: value returned from JLR Remote API.
• Optional: lowBatteryThresold defines the battery level below which the battery is considered to be low.
  • Allowable values: 0-99.
  • Default value: 25 for EVs, undefined for ICEs.
• Optional: targetTemperature define the default target temperature (in ℃) when preconditioning the vehicle.
  • Allowable values: LO: 15.5/60.0 - HI: 28.5/83.0 (°C/°F)
  • Default value: 22.0/71.5 (°C/°F)

Voice commands

If you use the example above, you would gain Siri commands like:

• "What is the charge level on the I-PACE?" (check the I-PACE's battery charge level)
• "Is the I-PACE charging?" (is the I-PACE charging?)
• "Is the I-PACE locked?" (check if the I-PACE is locked)
• "Turn on the I-PACE Preconditioning" (pre-condition the I-PACE)
• "Set the I-PACE Preconditioning to 18 degrees"
• "Open the I-PACE" (unlock the I-PACE)
• "Open the Range Rover" (unlock the Range Rover)
• "Turn on the I-PACE Preconditioning" (pre-condition on the I-PACE)
• "Heat the Range Rover to 21 degrees" (pre-condition on the Range Rover)

Acknowledgements

This Homebridge Platform is an extension of the Jaguar Land Rover InControl Homebridge plugin. It was based on the work of jlrpy and the excellent reverse engineering of the InControl API contributed by ardevd.