Skip to content

13robin37/FiatChamp

Β 
Β 

Folders and files

NameName
Last commit message
Last commit date

Latest commit

Β 

History

60 Commits
Β 
Β 
Β 
Β 
Β 
Β 
Β 
Β 
Β 
Β 
Β 
Β 
Β 
Β 

Repository files navigation

image FiatChamp πŸš—

Connect your FIAT, Jeep, Ram, Dodge, AlfaRomeo car or truck to Home Assistant. Needs a vehicle with enabled uconnect services and valid account.

  • Fiat: Works βœ…
  • Jeep: Works βœ…
  • Ram: Experimental ⚠️
  • Dodge: Unknown β›”
  • AlfaRomeo: Unknown β›”

I have created this addon for my own car (new Fiat Icon 500e) and its the only one i can test it with. Work in progress so expect some bugs. πŸ˜…

Example dashboard using sensors and entities provided by this addon:

image

Prerequisites

  • Official Home Assistant MQTT Addon (recommended) running or external mqtt broker. Broker must be connected to Home Assistant MQTT integration.

image

It looks like there are different uconnect services. Make sure your car works with one of the following uconnect sites. Older vehicles that only uses mopar.com do not seem to work.

Features

  • Imports values like battery level, tyre pressure, odometet etc. into Home Assistant.
  • Multiple Brands: Fiat, Jeep, Ram, Dodge, AlfraRomeo
  • Supports multiple cars on the same account.
  • Location tracking.
  • Home Assistant zones (home, work etc.) support.
  • Uses the same data source as the official app.
  • Remote commands (open doors, switch air conditioner on, ...) are supported since version 2.0. Some commands may not work with all cars. Available commands are:
    • "UpdateLocation" (updates gps location of the car)
    • "RefreshBatteryStatus" (refresh battery level %)
    • "DeepRefresh" (same as "RefreshBatteryStatus")
    • "Blink" (blink lights)
    • "ChargeNOW" (starts charging)
    • "Trunk" (open/close trunk lock)
    • "DoorLock" (open/close doors. See: "EnableDangerousCommands" option.)
    • "HVAC" (turn on the temperature preconditioning in the car. the official app does not support turning preconditioning off πŸ˜… See: "EnableDangerousCommands" option.)
  • Convert km to miles option.

What doesn't work (yet)?

  • Eco Reports (statistics). I could not find any API yet. The official app shows it so in theory it should be accessible.

What will NEVER work?

  • Things the fiat api does not support. Like real time tracking or adjusting the music volume. Maybe they add some new features in the future.

How to install

Follow the official docs:

https://www.home-assistant.io/addons/

Short version:

  • Switch on "Advanced Mode" in your users profile. (if you haven't already)
  • Go to Settings -> Add-ons -> ADD-ON STORE
  • Top right three dots. Add repo. https://github.com/wubbl0rz/FiatChamp
  • Top right three dots. Check for updates.
  • Refresh Page. (F5)
  • Store should show this repo now and you can install the addon.

Options / Usage

You dont have to configure MQTT. At startup the Addon will automatically connect to your Home Assistant MQTT Broker.

  • PIN is only needed if you want to send commands to your car. Its the same PIN used by the official app or website.
  • Use DEBUG carefully. It will dump many informations to the log including session tokens and sensitive informations.
  • Automatic refresh of location and battery level may drain your battery a bit more. The car have to wakeup some parts, read new values and sent them back. This will get executed every "Refresh interval" and at every command even if your car is not at home. Recommendation: Better use a Home Assistant automation instead. I have setup an automation that is triggered by plugging in the charger cable and then updates the battery level (by calling DeepRefresh) every 15 minutes until its 100% or charger is disconnected. ( see here for screenshots of my automations wubbl0rz#4 (comment) )
  • Only set "Dangerous commands" if you want to use unoffical commands that are not present in the the official app.
  • Mqtt override can be used if you want to utilize an external mqtt broker. You do not need this if you are using the official home assistant mqtt addon.

FAQ

Where is the data ?

inside the mqtt integration (click on "devices"). after a successful run there should be a new entry named "car" or the nickname you gave the car on the website.

image

if not then check the error logs output of the addon.

Why is location not working.

it should work. have a look at the attributes. main status depends on the zones you configured in home assistant. when the car is within the radius of a predefined zone at will show the zone name as location. otherwise status "away" or a custom string.

What is DeepRefresh ? How to update my battery charging level % ?

DeepRefresh is the "fiat language" for battery status update. The car sents only relatively rarely battery charging level % updates. If thats too slow for you press the "RefreshBatteryStatus" or "DeepRefresh" button (or call it in an automation) and the car should immediately update and sent back its current battery charging level %.

image

About

FIAT (uconnect) Home Assistant Addon πŸš—

Resources

License

Stars

Watchers

Forks

Releases

No releases published

Packages

No packages published

Languages

  • C# 96.1%
  • Shell 3.4%
  • Dockerfile 0.5%