0 — Quick checklist before starting

• Local or SSH access as a sudo user.
• Car available for registration mode during step 20.
• Note IPs and passwords so you can adjust the examples.
• You can use the COPY button to copy the content, paste & edit in notepad or right click tpo paste into the SSH window of the PI.
• After right clicking in the SSH window, just simply hit enter.
• The lines using NANO this is a text editor. To save, use CTRL+X to Exit, answer Y to save, and then ENTER to save it with the filename given.

Download the Raspberry PI imager here

1 — Install updates & base packages

Install required system packages.

Copysudo apt update

Copysudo apt upgrade

Install tools:

Copysudo apt install -y network-manager

2 — Install Go & pcap

Copysudo apt install -y golang

Copysudo apt install -y libpcap-dev

3 — Clone and build phev2mqtt

Clone repo and build the binary.

Copygit clone https://github.com/Roysteroonie/phev2mqtt.git

Move into the phev2mqtt directory.

Copycd phev2mqtt

Build it.

Copygo build

Test its working.

Copyphev2mqtt --help

Update the script for Phev2MQTT - Replace all details in white with your details.

Copysudo nano /etc/systemd/system/phev2mqtt.service

Copy[Unit]
Description=phev2mqtt service script
StartLimitIntervalSec=5
After=syslog.target network.target

[Service]
Type=exec
ExecStart=/usr/local/bin/phev2mqtt --config=/dev/null client mqtt --mqtt_server tcp://MQTT_SERVER_IP:1883/ --mqtt_username USERNAME --mqtt_password PASSWORD -v=debug

# Restart script if stopped
Restart=always
# Wait 30s before restart
RestartSec=30s

# Tag things in the log
# View with: sudo journalctl -f -u phev2mqtt -o cat
SyslogIdentifier=phev2mqtt

StandardOutput=syslog
StandardError=syslog

[Install]
WantedBy=multi-user.target

Install the binary system-wide:

Copysudo cp phev2mqtt /usr/local/bin/
sudo chmod 755 /usr/local/bin/phev2mqtt

Test connection to MQTT - Update the sections as per your configuration.

Copyphev2mqtt client mqtt --mqtt_server tcp://MQTT_SERVER_IP:1883/ --mqtt_username USERNAME --mqtt_password PASSWORD

Cursor will drop to the line below if the connection works. Use CTRL+C to stop

4 — Network scripts

Copysudo nano /etc/systemd/network/00-default.link

Paste in the following (using your details)

Copy[Match]
# This should be the 'real' (default) mac address of the Pi's wireless interface.
# To obtain this use "ip a" 
MACAddress=Your local mac address
	
[Link]
# This should be the MAC address to use to connect to the car, per above.
MACAddress=Your mac address from your mobile wifi for the car
NamePolicy=kernel database onboard slot path

Paste in the following (using your details)

Copysudo nano /etc/wpa_supplicant/wpa_supplicant.conf

Copyctrl_interface=DIR=/var/run/wpa_supplicant GROUP=netdev
update_config=1
country=GB # Change this to suit your local

network={
	ssid="YOUR CARS SSID"
	scan_ssid=1
	psk="WIFI PASSWORD"
}

5 — Setup connectivity to the car

Wake the car AP if needed (app or lock/unlock) then disconnect it:

Copynmcli

Expected: wlan0: disconnected "Broadcom BCM43438 combo and Bluetooth Low Energy" wifi (brcmfmac), "should be your phones mac address", hw, mtu 1500 when ECU is awake.

Create the WiFi connection to the car:

Copysudo nmcli connection add \
type wifi \
ifname wlan0 \
con-name Your Car SSID \
ssid Your Car SSID

Modify the WiFi connection to the car including mac address

Copysudo nmcli connection modify CAR WIFI SSID \
wifi-sec.key-mgmt wpa-psk \
wifi-sec.psk CAR WIFI PASSWORD \
802-11-wireless.cloned-mac-address MAC ADRESS USED ABOVE

Bring the connection up

Copysudo nmcli connection up Your Car SSID

If its worked, run "ip a" in the window, you should see this kind of output.

At this point, give the PI a reboot

Copysudo reboot

6 — Register client with the car

You can run ip a to make sure the wlan0 is connected to the car showing UP:

Copyphev2mqtt client register --address 192.168.8.46:8080 -v=debug

Successful registration shows logs ending with Success!. If it fails, ensure no other app is connected and the car is in registration mode.

7 — Set the phev2mqtt to auto start

Copysudo systemctl daemon-reload

Copysudo systemctl enable phev2mqtt.service

Copysudo systemctl start phev2mqtt.service

Lets check the logs:

Copysudo journalctl -u phev2mqtt.service -f

Example output:

If using mqtt explorer at this point you should see all the entries against phev.

On Home Assistant, go to Settings--> Devices & Services --> MQTT You should now see another devices named PHEV All done :o)

8 — Code for adding to a Dashboard

On Home Assistant, create or add to an existing dashboard. If New edit the dash, click the 3 dots top right and select Raw configuration editor, and paste the contents in replacing "YOUR CAR VIN" with yours. Then save

Copyviews:
  - title: Home
    cards:
      - type: horizontal-stack
        cards:
          - type: picture-elements
            elements:
              - type: state-icon
                entity: light.phev_"YOUR CAR VIN"_phev_park_lights
                style:
                  top: 95%
                  left: 30%
                icon: mdi:car-parking-lights
              - type: state-icon
                entity: light.phev_"YOUR CAR VIN"_phev_head_lights
                style:
                  top: 5%
                  left: 50%
                icon: mdi:car-light-high
              - type: state-icon
                entity: binary_sensor.phev_"YOUR CAR VIN"_phev_boot
                style:
                  top: 90%
                  left: 50%
                icon: mdi:car-connected
              - type: state-icon
                entity: binary_sensor.phev_"YOUR CAR VIN"_phev_bonnet
                style:
                  top: 17%
                  left: 50%
                icon: mdi:car
              - type: state-icon
                entity: binary_sensor.phev_"YOUR CAR VIN"_phev_front_passenger_door
                icon: mdi:car-door
                style:
                  top: 50%
                  left: 7%
              - type: state-icon
                entity: binary_sensor.phev_"YOUR CAR VIN"_phev_driver_door
                icon: mdi:car-door
                style:
                  top: 50%
                  left: 90%
              - type: state-icon
                entity: binary_sensor.phev_"YOUR CAR VIN"_phev_rear_left_door
                icon: mdi:car-door
                style:
                  top: 65%
                  left: 7%
              - type: state-icon
                entity: binary_sensor.phev_"YOUR CAR VIN"_phev_rear_right_door
                icon: mdi:car-door
                style:
                  top: 65%
                  left: 90%
              - type: state-icon
                entity: binary_sensor.phev_"YOUR CAR VIN"_phev_charger_connected
                style:
                  top: 80%
                  left: 90%
              - type: state-icon
                entity: binary_sensor.phev_"YOUR CAR VIN"_phev_locked
                style:
                  top: 60%
                  left: 50%
            image: https://ha.cactii.net/local/car-top-1.png
          - type: gauge
            tap_action:
              action: toggle
            entity: sensor.phev_"YOUR CAR VIN"_phev_battery
            unit: '%'
          - type: custom:button-card
            entity: binary_sensor.phev_"YOUR CAR VIN"_phev_charger_connected
            name: Charger
            aspect_ratio: 1/1.7
            tap_action:
              action: more-info
              entity: switch.phev_"YOUR CAR VIN"_phev_disable_charge_timer
            styles:
              grid:
                - position: relative
              custom_fields:
                notification:
                  - background-color: |
                      [[[
                        if (states['binary_sensor.phev_"YOUR CAR VIN"_phev_charging'].state == "on")
                          return "green";
                        return "red";
                      ]]]
                  - border-radius: 50%
                  - position: absolute
                  - left: 60%
                  - top: 10%
                  - height: 40px
                  - width: 40px
                  - font-size: 14px
                  - line-height: 40px
            custom_fields:
              notification: >
                [[[ return
                Math.floor(states['sensor.phev_"YOUR CAR VIN"_phev_charge_remaining'].state)
                +'m']]]
            state:
              - value: 'on'
                icon: mdi:power-plug
                label: Plugged In
              - value: 'off'
                icon: mdi:power-plug-off
                label: Unplugged
      - type: horizontal-stack
        cards:
          - show_name: true
            show_icon: true
            type: button
            tap_action:
              action: toggle
            entity: switch.phev_"YOUR CAR VIN"_phev_cool
          - show_name: true
            show_icon: true
            type: button
            tap_action:
              action: toggle
            entity: switch.phev_"YOUR CAR VIN"_phev_heat
          - show_name: true
            show_icon: true
            type: button
            tap_action:
              action: toggle
            entity: switch.phev_"YOUR CAR VIN"_phev_windscreen

If you find any mistakes or bad edits, please pop me a message and let me know, I