Stekkie installeren

1. Aansluiten

Steek Stekkie in de OBD-poort van je auto. Die zit meestal onder het dashboard aan de bestuurderskant, soms achter een klepje. Stekkie blijft daar zitten; hij krijgt stroom van de auto.

De eerste 5 minuten na het insteken blijft hij altijd wakker, zodat je rustig alles kunt instellen. Daarna gaat hij slapen zodra de auto uit is.

2. Verbinden met je WiFi

1. Een nieuwe Stekkie start na een minuut een eigen netwerk Stekkie-xxxx (open, zonder wachtwoord). xxxx zijn de laatste vier tekens van het MAC-adres.
2. Verbind je telefoon met dat netwerk. De instellingenpagina opent vanzelf. Gebeurt dat niet, ga dan naar http://4.3.2.1/instellingen.
3. Kies eerst een wachtwoord voor de instellingenpagina (gebruiker admin). Dat wachtwoord heb je later ook nodig voor updates.
4. Tik je thuisnetwerk aan in de lijst en vul het WiFi-wachtwoord in.

Heeft een opgeslagen netwerk een keer gewerkt, dan start het setup-netwerk niet meer vanzelf, ook niet als je onderweg buiten bereik bent. Klopt het wachtwoord niet, dan verschijnt het setup-netwerk na een minuut opnieuw.

Meer netwerken (thuis, werk)

Stekkie onthoudt tot 3 WiFi-netwerken en verbindt steeds met het sterkste bekende netwerk in de buurt. Lukt dat 30 seconden niet, dan zoekt hij opnieuw. Netwerken toevoegen en verwijderen doe je op /instellingen; je kunt thuis bijvoorbeeld alvast het netwerk van je werk intypen.

Sta je op een plek waar Stekkie nog geen netwerk kent? Houd dan het knopje (BOOT) 3 seconden ingedrukt terwijl Stekkie wakker is (net ingestoken, contact aan of tijdens het laden). Het lampje blijft dan branden en het setup-netwerk Stekkie-xxxx staat 10 minuten aan, zodat je het nieuwe netwerk kunt toevoegen.

3. MQTT en Home Assistant

Stekkie stuurt zijn gegevens naar een MQTT-broker, bijvoorbeeld de Mosquitto-add-on in Home Assistant. Zorg dat de MQTT-integratie in Home Assistant aan staat. Gebruik je geen MQTT, kijk dan bij webhook.

1. Open http://stekkie-xxxx.local/instellingen (of het IP-adres dat je router toont).
2. Vul bij MQTT de server in (bijv. 192.168.1.10 of homeassistant.local), en de gebruikersnaam en het wachtwoord van de broker.
3. Sla op. Binnen een minuut verschijnt het apparaat Stekkie in Home Assistant onder MQTT.

Zodra het contact van de auto een keer aan is geweest, leest Stekkie het VIN en herkent hij het model. Hij herstart dan eenmalig en het apparaat heet daarna Stekkie - merk model. Het tijdelijke apparaat ruimt hij zelf op.

In Home Assistant staat bij het apparaat ook een schakelaar Zenden: zet je die uit, dan luistert Stekkie alleen en vraagt hij niets meer op bij de auto. Hetzelfde kan met het vinkje op /instellingen.

4. Webhook (zonder MQTT)

Naast of in plaats van MQTT kan Stekkie dezelfde gegevens als JSON met een HTTP POST naar een adres sturen. Dat werkt met de webhook-trigger van Home Assistant, Node-RED, Homey, n8n of een eigen server. Stel het adres in op /instellingen bij Webhook; met het testvinkje stuurt Stekkie meteen een bericht.

Stekkie verstuurt op dezelfde momenten als bij MQTT, ook bij de uurlijkse meting tijdens de slaap. https:// werkt ook, maar zonder controle van het certificaat.

De belangrijkste velden in de JSON:

Daarnaast de extra waarden van je model, zoals bat_temp en charge_time.

Home Assistant zonder MQTT

Zet dit in configuration.yaml en kies zelf een geheim id:

template:
  - trigger:
      - trigger: webhook
        webhook_id: stekkie-geheim-id
        local_only: true
    sensor:
      - name: "Auto SoC"
        unique_id: stekkie_soc
        unit_of_measurement: "%"
        device_class: battery
        state: "{{ trigger.json.soc }}"
      - name: "Auto status"
        unique_id: stekkie_status
        state: "{{ trigger.json.state }}"
      - name: "Auto laadvermogen"
        unique_id: stekkie_power
        unit_of_measurement: "kW"
        device_class: power
        state: "{{ trigger.json.power_kw }}"

Het adres in Stekkie is dan http://homeassistant.local:8123/api/webhook/stekkie-geheim-id. Deze sensors houden hun waarde ook na een herstart van Home Assistant.

5. De webpagina van Stekkie

Zolang Stekkie wakker is, is hij in je netwerk bereikbaar op http://stekkie-xxxx.local/. De pagina's hebben dezelfde opmaak als deze website en werken zonder internet.

Op /instellingen kun je een eigen naam kiezen bij Naam op het netwerk, bijvoorbeeld egolf; Stekkie is dan bereikbaar op http://egolf.local/ (na een automatische herstart). Het volledige adres staat ook bovenaan de instellingenpagina en in Home Assistant onder het apparaat (Bezoeken).

6. Firmware bijwerken

1. Download de nieuwste .bin op de firmwarepagina.
2. Zorg dat Stekkie wakker is (contact aan, laden, of stekker eruit en erin).
3. Open http://stekkie-xxxx.local/update, log in met admin en je wachtwoord en kies het bestand.
4. Stekkie herstart met de nieuwe versie. Crasht die binnen 15 seconden, dan start automatisch de vorige weer.

Je instellingen en metingen blijven bewaard.

7. Slaap en bereikbaarheid

Twee minuten nadat de auto uit is gaat Stekkie in diepe slaap. Hij wordt vanzelf wakker bij laden of rijden, en geeft elk uur kort de 12V-spanning door (in Home Assistant is hij dan even online). In slaap is de webpagina niet bereikbaar.

Hulp nodig?

Werkt iets niet, kijk dan eerst in /log op de webpagina van Stekkie. Kom je er niet uit, stuur dan een mail met je bestelnummer en (een stuk van) de log.