Raspberry Pi klaarmaken voor een klant

A Tailscale voor onderhoud op afstand 10 min

1. Maak een account op tailscale.com en installeer Tailscale op je eigen pc (aanmelden met hetzelfde account).
2. Tailscale-beheer → Settings → Keys → Generate auth key. Zet Reusable aan. Kopieer de sleutel (tskey-auth-…) en bewaar hem veilig (wachtwoordbeheerder).

Met Tailscale log je van overal in op elke Pi, zonder iets in de router van de klant te veranderen.

B SSH-sleutel op je pc 2 min

In PowerShell (enkel als je nog geen sleutel hebt; druk telkens op Enter):

ssh-keygen -t ed25519

Je publieke sleutel toon je met:

type $env:USERPROFILE\.ssh\id_ed25519.pub

C Raspberry Pi Imager instellen 5 min

1. Installeer Raspberry Pi Imager.
2. Kies je model, Raspberry Pi OS Lite (64-bit) (bij "Raspberry Pi OS (other)") en de SD-kaart of SSD.
3. Bij instellingen aanpassen:
   • Gebruiker bukinex met een wachtwoord (bewaar het).
   • Tijdzone Europe/Brussels, toetsenbord be.
   • Tabblad Services: SSH aan, "alleen publieke sleutel", plak je publieke sleutel (stap B).
4. Bewaar de instellingen: volgende keer hoef je enkel de hostnaam aan te passen.

1 Pi flashen 5 min

Raspberry Pi Imager met je bewaarde instellingen, enkel de hostnaam aanpassen naar:

2 Opstarten in jouw netwerk 2 min

Kaart of SSD in de Pi, netwerkkabel aan je router, voeding erop. Wacht een minuut. Test in PowerShell (antwoord "yes" op de vraag):

Lukt het niet? Kijk in je router welk IP-adres de Pi kreeg en gebruik bukinex@192.168.x.x.

3 Alles installeren 15 min wachten

In PowerShell, in de projectmap knx-planner:

Installatiecommando maken voor deze klant

Dit ene commando doet alles: updates, Tailscale, automatische veiligheidsupdates, herstart bij vastlopen, onze software, de koppeling met dit beheerpaneel en (als Cloudflare gekoppeld is) het adres en de toegang voor de klant.

Staat er nog tskey-auth-... in? Vervang het door je sleutel uit stap A, of zet die sleutel eenmalig bij de Worker (TAILSCALE_KEY), dan staat hij er vanzelf in.

4 Controleren 2 min

• De Pi staat in je Tailscale-lijst als .
• De visualisatie opent op .
• Zet het project erop: planner → Visualisatie → Busverbinding → adres van de Pi → Project naar deze server sturen.

5 Installeren 10 min

1. Pi met een netwerkkabel aan de router (of aan dezelfde switch als de KNX IP-interface), officiële voeding erop.
2. Controleer dat de KNX IP-interface en de Sonos in hetzelfde netwerk zitten (zelfde router, geen gastnetwerk).
3. Open op je gsm of laptop in het netwerk van de klant de visualisatie (via Tailscale: ) → Busverbinding: Zoeken naar de KNX-interface en verbinden, en Sonos zoeken.
4. Test een lamp, een screen en de muziek.

↻ Bijwerken en onderhoud

Nieuwste versie van onze software op de Pi zetten:

Inloggen op de Pi:

Logboek van het serverprogramma bekijken (na het inloggen):

journalctl -u knx-planner -n 100 --no-pager

• Raspberry Pi 4 of 5 in een behuizing met koeling
• Officiële voeding (Pi 5: 27 W, Pi 4: 15 W)
• SSD, of een SD-kaart van het type "High Endurance"
• Netwerkkabel (± 1 à 2 m)
• Het IP-adres van de KNX IP-interface (uit ETS), voor het geval zoeken niet lukt

• De Pi is niet te vinden met .local: gebruik het IP-adres uit de router.
• Staat hier op "offline": stroom, netwerkkabel of internet bij de klant. De Pi komt vanzelf terug zodra het internet er weer is.
• KNX niet verbonden: IP-interface uit of van IP-adres veranderd; is er een tunnel vrij (ETS bezet er één)? Verbind opnieuw via Busverbinding.
• Sonos niet gevonden: zitten de speakers in hetzelfde netwerk (geen gastwifi)? Staan ze aan in de Sonos-app?