From 84617ebc536f1a783f6978e96aa80b0bcdaf729d Mon Sep 17 00:00:00 2001 From: Manuel Weiser Date: Sun, 16 Feb 2025 11:18:43 +0100 Subject: [PATCH] feat: add German translation of README and link to it from the English version --- README.de.md | 155 +++++++++++++++++++++++++++++++++++++++++++++++++++ README.md | 2 + 2 files changed, 157 insertions(+) create mode 100644 README.de.md diff --git a/README.de.md b/README.de.md new file mode 100644 index 0000000..386cf35 --- /dev/null +++ b/README.de.md @@ -0,0 +1,155 @@ +# FilaMan - Filament Management System + +FilaMan ist ein Filament-Managementsystem für den 3D-Druck. Es verwendet ESP32-Hardware für Gewichtsmessungen und NFC-Tag-Management. +Benutzer können Filamentspulen verwalten, den Status des Automatic Material System (AMS) von Bablulab Druckern überwachen und Einstellungen über eine Weboberfläche vornehmen. +Das System integriert sich nahtlos mit der [Spoolman](https://github.com/Donkie/Spoolman) Filamentverwaltung, zusätzlich mit [Bambulab](https://bambulab.com/en-us) 3D-Druckern und sowie dem [Openspool](https://github.com/spuder/OpenSpool) NFC-TAG Format. + +![Scale](./img/scale_trans.png) + +Weitere Bilder finden Sie im [img Ordner](/img/) +oder auf meiner Website: [FilaMan Website](https://www.filaman.app) +Deutsches Erklärvideo: [Youtube](https://youtu.be/uNDe2wh9SS8?si=b-jYx4I1w62zaOHU) + +### ESP32 Hardware-Funktionen +- **Gewichtsmessung:** Verwendung einer Wägezelle mit HX711-Verstärker für präzise Gewichtsverfolgung. +- **NFC-Tag Lesen/Schreiben:** PN532-Modul zum Lesen und Schreiben von Filamentdaten auf NFC-Tags. +- **OLED-Display:** Zeigt aktuelles Gewicht, Verbindungsstatus (WiFi, Bambu Lab, Spoolman). +- **WLAN-Konnektivität:** WiFiManager für einfache Netzwerkkonfiguration. +- **MQTT-Integration:** Verbindet sich mit Bambu Lab Drucker für AMS-Steuerung. +- **NFC-Tag NTAG215:** Verwendung von NTAG215 wegen ausreichendem Speicherplatz auf dem Tag + +### Weboberflächen-Funktionen +- **Echtzeit-Updates:** WebSocket-Verbindung für Live-Daten-Updates. +- **NFC-Tag-Verwaltung:** + - Filamentdaten auf NFC-Tags schreiben. + - Verwendet das NFC-Tag-Format von [Openspool](https://github.com/spuder/OpenSpool) + - Ermöglicht automatische Spulenerkennung im AMS +- **Bambulab AMS-Integration:** + - Anzeige der aktuellen AMS-Fachbelegung. + - Zuordnung von Filamenten zu AMS-Slots. + - Unterstützung für externe Spulenhalter. +- **Spoolman-Integration:** + - Auflistung verfügbarer Filamentspulen. + - Filtern und Auswählen von Filamenten. + - Automatische Aktualisierung der Spulengewichte. + - Verfolgung von NFC-Tag-Zuweisungen. + +### Wenn Sie meine Arbeit unterstützen möchten, freue ich mich über einen Kaffee +Buy Me A Coffee + +## Detaillierte Funktionalität + +### ESP32-Funktionalität +- **Druckaufträge steuern und überwachen:** Der ESP32 kommuniziert mit dem Bambu Lab Drucker. +- **Drucker-Kommunikation:** Nutzt MQTT für Echtzeit-Kommunikation mit dem Drucker. +- **Benutzerinteraktionen:** Das OLED-Display bietet sofortiges Feedback zum Systemstatus. + +### Weboberflächen-Funktionalität +- **Benutzerinteraktionen:** Die Weboberfläche ermöglicht Benutzern die Interaktion mit dem System. +- **UI-Elemente:** Enthält Dropdown-Menüs für Hersteller und Filamente, Buttons zum Beschreiben von NFC-Tags und Echtzeit-Statusanzeigen. + +## Hardware-Anforderungen + +### Komponenten +- **ESP32 Entwicklungsboard:** Jede ESP32-Variante. +[Amazon Link](https://amzn.eu/d/aXThslf) +- **HX711 Wägezellen-Verstärker:** Für Gewichtsmessung. +[Amazon Link](https://amzn.eu/d/1wZ4v0x) +- **OLED Display:** 128x64 SSD1306. +[Amazon Link](https://amzn.eu/d/dozAYDU) +- **PN532 NFC Modul:** Für NFC-Tag-Operationen. +[Amazon Link](https://amzn.eu/d/8205DDh) +- **NFC-Tag:** NTAG215 +[Amazon Link](https://amzn.eu/d/fywy4c4) + +### Pin-Konfiguration +| Komponente | ESP32 Pin | +|-------------------|-----------| +| HX711 DOUT | 16 | +| HX711 SCK | 17 | +| OLED SDA | 21 | +| OLED SCL | 22 | +| PN532 IRQ | 32 | +| PN532 RESET | 33 | +| PN532 SCK | 14 | +| PN532 MOSI | 13 | +| PN532 MISO | 12 | +| PN532 CS/SS | 15 | + +## Software-Abhängigkeiten + +### ESP32-Bibliotheken +- `WiFiManager`: Netzwerkkonfiguration +- `ESPAsyncWebServer`: Webserver-Funktionalität +- `ArduinoJson`: JSON-Verarbeitung +- `PubSubClient`: MQTT-Kommunikation +- `Adafruit_PN532`: NFC-Funktionalität +- `Adafruit_SSD1306`: OLED-Display-Steuerung +- `HX711`: Wägezellen-Kommunikation + +## Installation + +### Voraussetzungen +- **Software:** + - [PlatformIO](https://platformio.org/) in VS Code + - [Spoolman](https://github.com/Donkie/Spoolman) Instanz +- **Hardware:** + - ESP32 Entwicklungsboard + - HX711 Wägezellen-Verstärker + - Wägezelle (Gewichtssensor) + - OLED Display (128x64 SSD1306) + - PN532 NFC Modul + - Verbindungskabel + +### Schritt-für-Schritt Installation +1. **Repository klonen:** + ```bash + git clone https://github.com/ManuelW77/Filaman.git + cd FilaMan + ``` +2. **Abhängigkeiten installieren:** + ```bash + pio lib install + ``` +3. **ESP32 flashen:** + ```bash + pio run --target upload + ``` +4. **Ersteinrichtung:** + - Mit dem "FilaMan" WLAN-Zugangspunkt verbinden. + - WLAN-Einstellungen über das Konfigurationsportal vornehmen. + - Weboberfläche unter `http://filaman.local` oder der IP-Adresse aufrufen. + +## Dokumentation + +### Relevante Links +- [PlatformIO Dokumentation](https://docs.platformio.org/) +- [Spoolman Dokumentation](https://github.com/Donkie/Spoolman) +- [Bambu Lab Drucker Dokumentation](https://www.bambulab.com/) + +### Tutorials und Beispiele +- [PlatformIO erste Schritte](https://docs.platformio.org/en/latest/tutorials/espressif32/arduino_debugging_unit_testing.html) +- [ESP32 Webserver Tutorial](https://randomnerdtutorials.com/esp32-web-server-arduino-ide/) + +## Lizenz + +Dieses Projekt ist unter der MIT-Lizenz lizenziert. Siehe [LICENSE](LICENSE) Datei für Details. + +## Materialien + +### Nützliche Ressourcen +- [ESP32 Offizielle Dokumentation](https://docs.espressif.com/projects/esp-idf/en/latest/esp32/) +- [Arduino Bibliotheken](https://www.arduino.cc/en/Reference/Libraries) +- [NFC Tag Informationen](https://learn.adafruit.com/adafruit-pn532-rfid-nfc/overview) + +### Community und Support +- [PlatformIO Community](https://community.platformio.org/) +- [Arduino Forum](https://forum.arduino.cc/) +- [ESP32 Forum](https://www.esp32.com/) + +## Verfügbarkeit + +Der Code kann getestet und die Anwendung kann vom [GitHub Repository](https://github.com/ManuelW77/Filaman) heruntergeladen werden. + +### Wenn Sie meine Arbeit unterstützen möchten, freue ich mich über einen Kaffee +Buy Me A Coffee \ No newline at end of file diff --git a/README.md b/README.md index e6c17d5..30e0d70 100644 --- a/README.md +++ b/README.md @@ -1,5 +1,7 @@ # FilaMan - Filament Management System +[Deutsche Version](README.de.md) + FilaMan is a filament management system for 3D printing. It uses ESP32 hardware for weight measurement and NFC tag management. Users can manage filament spools, monitor the status of the Automatic Material System (AMS) and make settings via a web interface. The system integrates seamlessly with [Bambulab](https://bambulab.com/en-us) 3D printers and [Spoolman](https://github.com/Donkie/Spoolman) filament management as well as the [Openspool](https://github.com/spuder/OpenSpool) NFC-TAG format.