Add comprehensive installation documentation

- Created bilingual installation guides (German/English)
- Added detailed kernel driver diagnosis procedures
- Included step-by-step Device Tree Overlay setup
- Enhanced troubleshooting for Rock OS CAN support
- Updated README files with latest specifications
- Removed obsolete CSV export file
This commit is contained in:
2025-12-03 10:06:00 +01:00
parent 2800bbccf3
commit 76194ac415
5 changed files with 263 additions and 77 deletions

119
doc/Installation.de.md Normal file
View File

@@ -0,0 +1,119 @@
# 🛠️ EWS Installation Guide
> 🌍 **Sprachen:** [English](Installation.en.md) | [Deutsch](Installation.de.md)
Ein umfassender Leitfaden zur Installation des Device Tree Overlays und der Kernelmodule für das Universal Voron Power & CAN HAT (EWS).
## 📚 Inhaltsverzeichnis
- [🛠️ EWS Installation Guide](#-ews-installation-guide)
- [📚 Inhaltsverzeichnis](#-inhaltsverzeichnis)
- [🏔️ Radxa Rock OS](#-radxa-rock-os)
- [🔍 Kernel-Treiber Diagnose](#-kernel-treiber-diagnose)
- [📄 Device Tree Setup (DTS)](#-device-tree-setup-dts)
- [⚠️ Wichtige Hinweise](#-wichtige-hinweise)
## 🏔️ Radxa Rock OS
Beim Rock OS variiert die CAN-Unterstützung von Version zu Version. Eine sorgfältige Diagnose ist daher vor der Installation erforderlich.
### 🔍 Kernel-Treiber Diagnose
#### Schritt 1: Verfügbare Module prüfen
Zuerst überprüfen wir, ob die erforderlichen Kernelmodule vorhanden sind:
```bash
find /lib/modules/$(uname -r)/kernel/drivers/net/can -name "*.ko*"
```
Sind in der Liste Dateien mit Namen enthalten, die `rockchip_canfd` oder `m_can` enthalten, sind die Module vorhanden und alles sollte funktionieren.
#### Schritt 2: Kernel-Konfiguration überprüfen
Falls keine Module gefunden wurden, prüfen wir die Kernel-Konfiguration:
```bash
grep -E "CONFIG_CAN_ROCKCHIP|CONFIG_CAN_FD" /boot/config-$(uname -r)
```
#### 🚦 Diagnose-Ergebnisse
##### ✅ Fall A: `CONFIG_CAN_ROCKCHIP=y`
- **Status:** ✅ OK
- **Bedeutung:** Der Treiber ist fest im Kernel integriert
- **Hinweis:** Erscheint NICHT unter `lsmod` und hat keine `.ko` Datei
- **Aktion:** Das Overlay reicht zur Aktivierung
##### ⚠️ Fall B: `CONFIG_CAN_ROCKCHIP=m`
- **Status:** ⚠️ Prüfung erforderlich
- **Bedeutung:** Der Treiber ist ein ladbares Modul
- **Prüfung:** Modul-Datei suchen:
```bash
find /lib/modules/$(uname -r) -name "rockchip_canfd.ko*"
```
- **Falls Datei fehlt:** Kernel-Pakete reinstallieren:
```bash
sudo apt install --reinstall linux-image-rk3588*
```
##### ❌ Fall C: `# CONFIG_CAN_ROCKCHIP is not set`
- **Status:** ❌ KRITISCHER FEHLER
- **Symptom:** Ausgabe enthält `# CONFIG_CAN_ROCKCHIP is not set` und meist auch `# CONFIG_CAN_M_CAN is not set`
- **Bedeutung:** Kernel wurde ohne CAN-Controller-Unterstützung kompiliert
- **Problem:** Der Treiber fehlt komplett
- **DKMS-Option:** ⚠️ Praktisch unmöglich bei SoC-internen Treibern
- **Lösung:** 🔄 Zwingender Wechsel des Betriebssystems/Kernels (z.B. Armbian Vendor Kernel)
### 📄 Device Tree Setup (DTS)
Nach erfolgreicher Kernel-Diagnose kann das CAN-Overlay installiert werden:
#### Installation über Radxa Setup-Tool
1. **📁 Verzeichnis wechseln**
```bash
cd dts
```
2. **🛠️ Radxa Setup starten**
```bash
sudo rsetup
```
3. **🧭 Navigation im Setup-Menü**
- Navigiere zu `Overlays` ➜ `Install 3rd party overlay`
4. **📋 Overlay auswählen**
- Wähle `rk3588-can1-m1.dts` aus der Liste
5. **🔄 System neustarten**
```bash
sudo reboot
```
#### ✅ Installation verifizieren
Nach dem Neustart sollte die CAN-Schnittstelle verfügbar sein:
```bash
ip link show can1
```
**Erwartete Ausgabe:**
```
3: can1: <NOARP> mtu 72 qdisc noop state DOWN mode DEFAULT group default qlen 10
link/can
```
## ⚠️ Wichtige Hinweise
- 🔧 **Jumper-Einstellungen:** Stelle sicher, dass alle Jumper auf dem EWS-Board korrekt gesetzt sind
- 🚨 **Neustart erforderlich:** Das System muss nach der Overlay-Installation neu gestartet werden
- 📋 **Interface-Name:** Die CAN-Schnittstelle wird als `can1` im System verfügbar sein
- 🔌 **Verkabelung:** Überprüfe alle Verbindungen vor der ersten Inbetriebnahme
- 🏔️ **OS-Kompatibilität:** Diese Anleitung bezieht sich speziell auf Radxa Rock OS
---
> **💡 Tipp:** Bei persistenten Problemen empfiehlt sich der Wechsel zu Armbian mit Vendor Kernel für bessere CAN-Unterstützung.
> **Hinweis:** Dies ist die Originaldokumentation in deutscher Sprache. Eine englische Übersetzung finden Sie in [Installation.en.md](Installation.en.md).