docs/PHI5_ETHERNET_SETUP.md

# PHI5 ETHERNET SETUP

## Ziel
Phi5 über Ethernet statt USB verbinden für stabilere, schnellere Kommunikation.

## Hardware Anforderungen
- Phi5 mit Ethernet-Port (oder USB-Ethernet-Adapter)
- Router/Switch mit DHCP-Server
- Laptop mit Ethernet- oder WLAN-Verbindung im gleichen Netzwerk

## Schritt-für-Schritt Anleitung

### 1. Phi5 Netzwerk konfigurieren

#### Option A: Direkte Ethernet-Verbindung
```bash
# Auf Phi5 ausführen (über Terminal oder SSH)
sudo nano /etc/network/interfaces

# Füge hinzu (statische IP):
auto eth0
iface eth0 inet static
    address 192.168.1.100
    netmask 255.255.255.0
    gateway 192.168.1.1
    dns-nameservers 8.8.8.8 8.8.4.4
```

#### Option B: DHCP (empfohlen)
```bash
# Auf Phi5 ausführen
sudo nano /etc/network/interfaces

# Standard DHCP (bereits konfiguriert):
auto eth0
iface eth0 inet dhcp
```

### 2. Netzwerk testen

```bash
# Auf Phi5:
ping -c 4 8.8.8.8
hostname -I  # Zeige IP-Adresse

# Auf Laptop:
ping 192.168.1.100  # Ersetze mit Phi5 IP
```

### 3. SSH über Ethernet konfigurieren

#### .env Datei aktualisieren
```bash
# In .env Datei:
NOTE10_SSH_HOST=192.168.1.100  # Phi5 IP-Adresse
NOTE10_SSH_PORT=22
NOTE10_SSH_USER=pi
NOTE10_SSH_PASSWORD=your_password
NOTE10_SSH_METHOD=ethernet
```

### 4. SSH Verbindung testen

```bash
# Auf Laptop:
ssh pi@192.168.1.100

# Oder mit Passwort aus .env:
python note10_start_from_laptop.py
```

### 5. ORION-ROS2 Bridge konfigurieren

```bash
# In orion_ros2_edge_bridge.py:
NOTE10_ORION_URL=http://192.168.1.100:8080/orion/health
```

### 6. Netzwerk-Performance testen

```bash
# Bandbreite testen:
iperf3 -c 192.168.1.100

# Latenz testen:
ping -c 100 192.168.1.100 | grep rtt
```

## Troubleshooting

### Problem: SSH Verbindung schlägt fehl
```bash
# Lösung 1: Firewall prüfen
sudo ufw status
sudo ufw allow 22

# Lösung 2: SSH-Service starten
sudo systemctl status ssh
sudo systemctl restart ssh

# Lösung 3: Phi5 IP prüfen
ifconfig eth0
```

### Problem: Netzwerk nicht erreichbar
```bash
# Lösung 1: Router-Log prüfen
# Lösung 2: DHCP-Server prüfen
# Lösung 3: Kabel testen
```

### Problem: Langsame Verbindung
```bash
# Lösung: Ethernet-Kabel auf Cat5e oder Cat6 prüfen
# Lösung: Switch/Router auf Gigabit prüfen
```

## Performance Vergleich

| Methode | Latenz | Bandbreite | Stabilität |
|---------|--------|------------|------------|
| USB | ~5ms | ~480 Mbps | Mittel |
| Ethernet | ~1ms | ~1000 Mbps | Hoch |
| WLAN | ~10ms | ~300 Mbps | Mittel |

## Empfehlung
**Ethernet ist für PHI5 die beste Wahl** für:
- Stabile ROS2-Kommunikation
- Niedrige Latenz für Echtzeit-Entscheidungen
- Hohe Bandbreite für Daten-Transfer
- Bessere Sicherheit (kein Funk)

## Nächste Schritte
1. Phi5 mit Ethernet verbinden
2. IP-Adresse notieren
3. SSH-Verbindung testen
4. ORION-ROS2 Bridge starten
5. Performance messen