Filaman/README.de.md

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 Filamentverwaltung, zusätzlich mit Bambulab 3D-Druckern und sowie dem Openspool NFC-TAG Format.

Weitere Bilder finden Sie im img Ordner
oder auf meiner Website: FilaMan Website
Deutsches Erklärvideo: Youtube

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
  • 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

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
• HX711 5kg Wägezellen-Verstärker: Für Gewichtsmessung. Amazon Link
• OLED 0.96 Zoll I2C weiß/gelb Display: 128x64 SSD1306. Amazon Link
• PN532 NFC NXP RFID-Modul V3: Für NFC-Tag-Operationen. Amazon Link
• NFC Tags Ntag215: RFID Tag Amazon Link

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 in VS Code
  • 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

Einfache Installation

1. **Gehe auf https://www.filaman.app/installer.html

2. **Stecke dein ESP an den Rechner und klicke Connect

3. **Wähle dein Device Port und klicke Intall

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.

Compile by yourself

1. Repository klonen:

   git clone https://github.com/ManuelW77/Filaman.git
   cd FilaMan
   

2. Abhängigkeiten installieren:

   pio lib install
   

3. ESP32 flashen:

   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
• Spoolman Dokumentation
• Bambu Lab Drucker Dokumentation

Tutorials und Beispiele

• PlatformIO erste Schritte
• ESP32 Webserver Tutorial

Lizenz

Dieses Projekt ist unter der MIT-Lizenz lizenziert. Siehe LICENSE Datei für Details.

Materialien

Nützliche Ressourcen

• ESP32 Offizielle Dokumentation
• Arduino Bibliotheken
• NFC Tag Informationen

Community und Support

• PlatformIO Community
• Arduino Forum
• ESP32 Forum

Verfügbarkeit

Der Code kann getestet und die Anwendung kann vom GitHub Repository heruntergeladen werden.

Wenn Sie meine Arbeit unterstützen möchten, freue ich mich über einen Kaffee