Files
ManuelW77andClaude Opus 5 a5ba8a901a Make WiFi TX power configurable, document ESP32-S3 pins
The transmit power was hardcoded to 19.5 dBm. Some setups need a lower
value (device right next to the AP, weak 3.3V rail), so it is now a user
setting instead of a per-chip constant.

- wlan.cpp: load/save/apply TX power (0.1 dBm steps, NVS key wifi_txpwr,
  default 195), re-applied on GOT_IP so it survives a reconnect
- website.cpp: /api/wifi-power GET/POST with validation
- setup.html: "WiFi Settings" card
- README.md/README.de.md: pin table gets an ESP32-S3 column plus a warning
  that GPIO19/20 are the native USB data lines
- config.cpp: same warning next to the HX711 pin definitions

Co-Authored-By: Claude Opus 5 <noreply@anthropic.com>
2026-09-20 12:42:13 +02:00

11 KiB
Raw Permalink Blame History

FilaMan - Filament Management System

⚠️ Wichtig: Ab Version 3.0.0 erfordert dieses System das FilaMan-System Backend. Frühere direkte Integrationen (Spoolman, MQTT, Bambu Lab) wurden in das zentrale FilaMan-System verschoben.

FilaMan ist ein Werkzeug zur Filamentverwaltung für den 3D-Druck. Es verwendet ESP32-Hardware zur Gewichtsmessung und Verwaltung von NFC-Tags. Benutzer können Filamentspulen verwalten und das Gerät über eine Weboberfläche konfigurieren. Das System integriert sich nahtlos in das FilaMan-System.

NEU ab 3.3.1: Eine abgespeckte Version ohne Waage ist ebenfalls möglich. Details finden sich unter NFC-only Modus.

Waage

Weitere Bilder finden Sie im img Ordner oder auf meiner Website: FilaMan Website Deutsches Erklärvideo: Youtube Discord Server: https://discord.gg/my7Gvaxj2v

NEU: Recycling Fabrik

Recycling Fabrik

FilaMan wird von der Recycling Fabrik unterstützt. Die Recycling Fabrik wird in Kürze FilaMan-kompatible NFC-Tags auf ihren Spulen anbieten. Dies hat den Vorteil, dass die Spulen automatisch erkannt und über die FilaMan-Waage direkt in das FilaMan-System importiert werden können.

Was ist die Recycling Fabrik?

Die Recycling Fabrik ist ein deutsches Unternehmen, das sich der Entwicklung und Herstellung von nachhaltigem 3D-Druck-Filament verschrieben hat. Ihre Filamente bestehen zu 100 % aus recyceltem Material von Endkunden und aus der Industrie – für eine umweltbewusste und ressourcenschonende Zukunft.

Weitere Informationen und Produkte finden Sie hier: www.recyclingfabrik.com


Detailliertere Informationen zur Nutzung: Wiki

ESP32 Hardware-Features

  • Gewichtsmessung: Verwendung einer Wägezelle mit HX711-Verstärker für präzises Gewichts-Tracking.
  • NFC-Tag Lesen/Schreiben: PN532-Modul zum Lesen und Schreiben von Filamentdaten auf NFC-Tags.
  • OLED-Display: Zeigt aktuelles Gewicht und Verbindungsstatus (WiFi, FilaMan-System) an.
  • WiFi-Konnektivität: WiFiManager für einfache Netzwerkkonfiguration.
  • NFC-Tag NTAG213 NTAG215: Verwendung von NTAG213, besser NTAG215 wegen ausreichendem Platz auf dem Tag.

Weboberflächen-Features

  • Echtzeit-Updates: WebSocket-Verbindung für Live-Datenaktualisierungen.
  • NFC-Tag-Verwaltung:
    • Schreiben von Filamentdaten auf NFC-Tags.
    • Unterstützt automatische Spulenerkennung in kompatiblen Systemen.
  • FilaMan-System Integration:
    • Synchronisierung der Spulendaten mit dem zentralen Backend.
    • 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

Unterstützung von Hersteller-Tags

🎉 Spannende Neuigkeiten! FilaMan unterstützt jetzt Hersteller-Tags - NFC-Tags, die direkt von Filamentherstellern vorprogrammiert geliefert werden!

Erster Hersteller-Partner: RecyclingFabrik

Wir freuen uns bekannt zu geben, dass RecyclingFabrik der erste Filamenthersteller sein wird, der FilaMan unterstützt, indem er NFC-Tags im FilaMan-Format auf seinen Spulen anbietet!

In Kürze: RecyclingFabrik-Spulen werden NFC-Tags enthalten, die sich automatisch in Ihr FilaMan-System integrieren, wodurch eine manuelle Einrichtung entfällt und perfekte Kompatibilität gewährleistet wird.

Funktionsweise von Hersteller-Tags

Wenn Sie einen Hersteller-NFC-Tag zum ersten Mal scannen:

  1. Automatische Markenerkennung: FilaMan erkennt den Hersteller und erstellt die Marke im FilaMan-System.
  2. Erstellung des Filamenttyps: Alle Materialspezifikationen werden automatisch hinzugefügt.
  3. Spulenregistrierung: Ihre spezifische Spule wird mit korrektem Gewicht und Spezifikationen registriert.
  4. Zukünftige Schnellerkennung: Nachfolgende Scans nutzen die Schnellerkennung für sofortige Gewichtsmessung.

Für detaillierte technische Informationen: Dokumentation zu Hersteller-Tags (Englisch)

Vorteile für Benutzer

  • ✅ Keine manuelle Einrichtung - Einfach scannen und wiegen.
  • ✅ Perfekte Datengenauigkeit - Vom Hersteller verifizierte Spezifikationen.
  • ✅ Sofortige Integration - Nahtlose Kompatibilität mit dem FilaMan-System.
  • ✅ Zukunftssicher - Tags funktionieren mit jedem FilaMan-kompatiblen System.

Detaillierte Funktionalität

ESP32-Funktionalität

  • Benutzerinteraktionen: Das OLED-Display bietet sofortiges Feedback zum Systemstatus, einschließlich Gewichtsmessungen und Verbindungsstatus.

Weboberflächen-Funktionalität

  • Benutzerinteraktionen: Die Weboberfläche ermöglicht es Benutzern, mit dem System zu interagieren, das Gerät zu konfigurieren und den Status zu überwachen.
  • UI-Elemente: Enthält Formulare zur Registrierung, Schaltflächen für Waagenaktionen und Echtzeit-Statusanzeigen.

Hardware-Anforderungen

  • ESP32 Development Board: Jede ESP32-Variante. Amazon Link
  • HX711 5kg Wägezellenverstärker: Für die Gewichtsmessung. Amazon Link
  • OLED 0,96 Zoll I2C weiß/gelbes Display: 128x64 SSD1306. Amazon Link
  • PN532 NFC NXP RFID-Modul V3: Für NFC-Tag-Operationen. Amazon Link
  • NFC-Tags NTAG213 NTAG215: RFID-Tag. Amazon Link
  • TTP223 Touch-Sensor (optional): Für TARA per Knopfdruck/Berührung. Amazon Link

Pin-Konfiguration

Komponente ESP32 Pin ESP32-S3 Pin
HX711 DOUT 16 5
HX711 SCK 17 6
OLED SDA 21 8
OLED SCL 22 9
PN532 IRQ 32 15
PN532 RESET 33 16
PN532 SDA 21 8
PN532 SCL 22 9
TTP223 I/O 25 7

Die I2C-Pins sind die Arduino-Standardwerte des jeweiligen Chips und werden im Code nicht explizit gesetzt.

!! ESP32-S3: GPIO19/GPIO20 nicht für den HX711 verwenden. Das sind die nativen USB-Datenleitungen (D-/D+), die auf dem DevKitC-1 an der "USB"-Buchse liegen. Der HX711 wird dort nur unzuverlässig erkannt.

!! Stellen Sie sicher, dass die DIP-Schalter am PN532 auf I2C eingestellt sind. Verwenden Sie den 3V-Pin des ESP für den Touch-Sensor.

Verkabelung

meineVerkabelung meineVerkabelung

Die Wägezelle wird an die meisten HX711-Module wie folgt angeschlossen: E+ rot E- schwarz A- weiß A+ grün

Software-Abhängigkeiten

ESP32-Bibliotheken

  • WiFiManager: Netzwerkkonfiguration
  • ESPAsyncWebServer: Webserver-Funktionalität
  • ArduinoJson: JSON-Parsing und -Erstellung
  • Adafruit_PN532: NFC-Funktionalität
  • Adafruit_SSD1306: OLED-Display-Steuerung
  • HX711: Kommunikation mit der Wägezelle

Installation

Voraussetzungen

  • Software:
  • Hardware:
    • ESP32 Development Board
    • HX711 Wägezellenverstärker
    • Wägezelle (Gewichtssensor)
    • OLED-Display (128x64 SSD1306)
    • PN532 NFC-Modul
    • Verbindungskabel

Schritt-für-Schritt-Installation

Einfache Installation

  1. Gehen Sie zum FilaMan Installer

  2. Schließen Sie Ihr Gerät an und drücken Sie die Connect-Taste.

  3. Wählen Sie Ihren Geräte-Port aus und drücken Sie Install.

  4. Ersteinrichtung:

    • Verbinden Sie sich mit dem "FilaMan" WiFi-Access-Point.
    • Konfigurieren Sie die WiFi-Einstellungen über das Captive Portal.
    • Greifen Sie über http://filaman.local oder die IP-Adresse auf die Weboberfläche zu.

Selbst kompilieren

  1. Repository klonen:
    git clone https://github.com/ManuelW77/Filaman-System-esp32.git
    cd Filaman-System-esp32
    
  2. Abhängigkeiten installieren:
    pio lib install
    
  3. ESP32 flashen:
    pio run --target upload
    
  4. Ersteinrichtung:
    • Verbinden Sie sich mit dem "FilaMan" WiFi-Access-Point.
    • Konfigurieren Sie die WiFi-Einstellungen über das Captive Portal.
    • Greifen Sie über http://filaman.local oder die IP-Adresse auf die Weboberfläche zu.

Dokumentation

Tutorials und Beispiele

Lizenz

Dieses Projekt steht unter der MIT-Lizenz. Weitere Informationen finden Sie in der Datei LICENSE.

Materialien

Nützliche Ressourcen

Community und Support

Verfügbarkeit

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

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

Buy Me A Coffee