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
Discord Server: https://discord.gg/vMAx2gf5

Es gibt jetzt auch ein Wiki, dort sind nochmal alle Funktionen beschrieben: Wiki

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 NTAG213 NTAG215: Verwendung von NTAG213, besser 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.
  • Unterstützt das Spoolman Octoprint Plugin

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 NTAG213 NTA215: 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 SDA	21
PN532 SCL	22

Achte darauf, dass am PN532 die DIP-Schalter auf I2C gestellt sind

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

Wichtiger Hinweis

Du musst Spoolman auf DEBUG Modus setzten, da man bisher in Spoolman keine CORS Domains setzen kann!

# Enable debug mode
# If enabled, the client will accept requests from any host
# This can be useful when developing, but is also a security risk
# Default: FALSE
#SPOOLMAN_DEBUG_MODE=TRUE

Schritt-für-Schritt Installation

Einfache Installation

1. Gehe auf FilaMan Installer

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