209 lines
6.0 KiB
Markdown
209 lines
6.0 KiB
Markdown
# 🏠 HomeMatic Anwesenheitserkennung via MikroTik
|
|
|
|
Automatische Anwesenheitserkennung für 2 iPhones im Heimnetz **Ebesch** (192.168.252.0/24).
|
|
Ein Python-Script läuft minütlich auf `ebesch-docker` und fragt den MikroTik-Router per REST-API ab — sind die iPhones im WLAN eingebucht, werden die HomeMatic-Systemvariablen auf *„zu Hause"* gesetzt.
|
|
|
|
---
|
|
|
|
## 🏗️ Architektur
|
|
|
|
```
|
|
┌─────────────────┐ REST API ┌──────────────────────────┐
|
|
│ ebesch-docker │ ────────────────► │ MikroTik RB5009 │
|
|
│ 192.168.252.10 │ /caps-man/ │ 192.168.252.254 │
|
|
│ (Cronjob 1min) │ registration- │ CAPsMAN → AP .253 │
|
|
│ │ table │ SSID: Aironet │
|
|
└────────┬────────┘ └──────────────────────────┘
|
|
│ ▲
|
|
│ statechange.cgi │ WiFi
|
|
▼ │
|
|
┌─────────────────┐ ┌──────────┴───────────────┐
|
|
│ HomeMatic CCU2 │ │ 📱 RP iPhone │
|
|
│ 192.168.252.12 │ │ 📱 Kerstins iPhone │
|
|
│ │ └──────────────────────────┘
|
|
│ Systemvariablen│
|
|
│ • Zone RPiPhone (1828)
|
|
│ • Zone Kerstins iPhone (4730)
|
|
│ • Anwesenheit (950)
|
|
└─────────────────┘
|
|
```
|
|
|
|
---
|
|
|
|
## 📋 Voraussetzungen
|
|
|
|
| Komponente | Gerät | IP |
|
|
|---|---|---|
|
|
| Script-Host | ebesch-docker | 192.168.252.10 |
|
|
| Router | MikroTik RB5009UPr+S+ | 192.168.252.254 |
|
|
| WLAN-AP | MikroTik RBcAPGi-5acD2nD (CAPsMAN) | 192.168.252.253 |
|
|
| HomeMatic | CCU2 | 192.168.252.12 |
|
|
|
|
**Software auf ebesch-docker:**
|
|
- Python 3.8+
|
|
- `requests` Bibliothek (via pip/venv)
|
|
|
|
---
|
|
|
|
## ⚙️ Erkennung
|
|
|
|
### Primär: CAPsMAN Registration Table
|
|
Zeigt alle **aktuell aktiv verbundenen** WLAN-Clients des APs.
|
|
→ Zuverlässigste Methode, da in Echtzeit.
|
|
|
|
### Fallback: ARP-Tabelle
|
|
Enthält zuletzt gesehene MAC/IP-Zuordnungen.
|
|
→ Greift wenn das iPhone kurz vom WLAN getrennt ist (Sleepmode).
|
|
|
|
### iOS MAC-Randomisierung (iOS 14+)
|
|
iPhones nutzen **pro SSID eine stabile private MAC-Adresse** (nicht die echte Hardware-MAC).
|
|
Diese bleibt für dieselbe SSID konstant, ist aber netzwerkspezifisch.
|
|
|
|
**MAC-Adresse herausfinden:**
|
|
```
|
|
iPhone → Einstellungen → WLAN → ⓘ neben "Aironet" → WLAN-Adresse
|
|
```
|
|
Diese Adresse in `config.ini` eintragen.
|
|
|
|
---
|
|
|
|
## 🚀 Installation
|
|
|
|
### 1. Repo auf ebesch-docker klonen
|
|
|
|
```bash
|
|
ssh ebesch-docker
|
|
cd /opt
|
|
git clone https://git.rwolff.homelinux.net/rpwolff/homematic-anwesenheit.git
|
|
cd homematic-anwesenheit
|
|
```
|
|
|
|
### 2. MAC-Adressen eintragen
|
|
|
|
```bash
|
|
nano config.ini
|
|
# [device.rp_iphone] → mac = XX:XX:XX:XX:XX:XX
|
|
# [device.kerstin_iphone] → mac = XX:XX:XX:XX:XX:XX
|
|
```
|
|
|
|
### 3. Installation ausführen
|
|
|
|
```bash
|
|
bash install.sh
|
|
```
|
|
|
|
Das Script:
|
|
- Legt `/opt/homematic-presence/` an
|
|
- Erstellt ein Python-venv mit `requests`
|
|
- Installiert einen Cronjob (`/etc/cron.d/homematic-presence`)
|
|
- Konfiguriert Log-Rotation
|
|
|
|
### 4. Testen
|
|
|
|
```bash
|
|
/opt/homematic-presence/venv/bin/python3 /opt/homematic-presence/presence_check.py \
|
|
--dry-run --verbose
|
|
```
|
|
|
|
### 5. Log beobachten
|
|
|
|
```bash
|
|
tail -f /var/log/homematic-presence.log
|
|
```
|
|
|
|
---
|
|
|
|
## 📊 HomeMatic Systemvariablen
|
|
|
|
| Variable | ISE-ID | Typ | `false` | `true` |
|
|
|---|---|---|---|---|
|
|
| Zone RPiPhone | 1828 | LOGIC | außer Haus | zu Hause |
|
|
| Zone Kerstins iPhone | 4730 | LOGIC | außer Haus | zu Hause |
|
|
| Anwesenheit | 950 | LOGIC | nicht anwesend | anwesend |
|
|
|
|
Die Variable **Anwesenheit** wird auf `true` gesetzt wenn mindestens eine Person zuhause ist.
|
|
|
|
---
|
|
|
|
## 🔧 Konfiguration (`config.ini`)
|
|
|
|
```ini
|
|
[mikrotik]
|
|
host = 192.168.252.254
|
|
user = admin
|
|
password = <siehe Bitwarden / Obsidian>
|
|
|
|
[homematic]
|
|
host = 192.168.252.12
|
|
combined_ise_id = 950 # Kombinierte Anwesenheit
|
|
|
|
[device.rp_iphone]
|
|
mac = XX:XX:XX:XX:XX:XX # Private WLAN-MAC für SSID "Aironet"
|
|
ise_id = 1828
|
|
label = RP iPhone
|
|
|
|
[device.kerstin_iphone]
|
|
mac = XX:XX:XX:XX:XX:XX # Private WLAN-MAC für SSID "Aironet"
|
|
ise_id = 4730
|
|
label = Kerstins iPhone
|
|
```
|
|
|
|
---
|
|
|
|
## 🔍 Troubleshooting
|
|
|
|
**CAPsMAN zeigt 0 Clients obwohl Gerät verbunden:**
|
|
```bash
|
|
# Router-Seite prüfen:
|
|
curl -u admin:<pw> http://192.168.252.254/rest/caps-man/registration-table
|
|
```
|
|
|
|
**HomeMatic-Variable ändert sich nicht:**
|
|
```bash
|
|
# XML-API direkt testen:
|
|
curl "http://192.168.252.12/config/xmlapi/statechange.cgi?ise_id=1828&new_val=true"
|
|
```
|
|
|
|
**Script manuell ausführen:**
|
|
```bash
|
|
/opt/homematic-presence/venv/bin/python3 \
|
|
/opt/homematic-presence/presence_check.py --verbose
|
|
```
|
|
|
|
**Cronjob-Status:**
|
|
```bash
|
|
systemctl status cron
|
|
grep homematic /var/log/syslog | tail -20
|
|
```
|
|
|
|
---
|
|
|
|
## 📁 Dateien
|
|
|
|
| Datei | Beschreibung |
|
|
|---|---|
|
|
| `presence_check.py` | Hauptscript: Router abfragen → HomeMatic setzen |
|
|
| `config.ini` | Konfiguration (MACs, IPs, Credentials) |
|
|
| `install.sh` | Einmalige Installation auf ebesch-docker |
|
|
| `README.md` | Diese Dokumentation |
|
|
|
|
---
|
|
|
|
## 🔒 Sicherheitshinweise
|
|
|
|
- `config.ini` enthält Passwörter → **nicht öffentlich committen**
|
|
- Das Repo ist öffentlich — `config.ini` ist in `.gitignore`
|
|
- Passwörter liegen in Bitwarden / Obsidian Firma
|
|
|
|
---
|
|
|
|
## 📅 Wartung
|
|
|
|
- RouterOS-Updates können CAPsMAN-API-Pfade ändern → Script ggf. anpassen
|
|
- iOS-Updates können MAC-Randomisierung beeinflussen → MACs ggf. neu auslesen
|
|
- HomeMatic-Firmware-Updates: ISE-IDs bleiben stabil
|
|
|
|
---
|
|
|
|
*Netz: Ebesch · 192.168.252.0/24 · SSID: Aironet · Repo: [git.rwolff.homelinux.net/rpwolff/homematic-anwesenheit](https://git.rwolff.homelinux.net/rpwolff/homematic-anwesenheit)*
|