CN3D Docs/Projekte/NebulaTor/Firmware
Offentliche Projektvorstellung

NebulaTor

Ein von CN3D entwickeltes Upgrade fur den BIQU/BTT Nebula Extruder, ausgelegt auf besseres Filamenthandling, Sensorik, Servicefreundlichkeit und ein integriertes Schneidsystem.

Dateien folgen: Dokumentation ist jetzt offentlich, STL-Dateien sind als nachster Schritt geplant, CAD/STEP erst nach finaler Validierung.

Dokumentation liveBIQU / BTT Nebula Extruder BasisSTL folgtCAD nach Validierung
Dokumentation ansehenIn Aktion ansehen
Schräge NebulaTor Darstellung mit Frontfenster, Idler-Hebel, Feder-Vorspannmechanismus und Motorseite.
Docs onlineOffentliche Projektvorstellung und Dokumentation
STL folgtDruckbare Dateien nach der Validierung geplant
CAD spaterCAD/STEP nach finaler Validierung geplant
KlipperEntwicklungslogik der Firmware dokumentiert

Firmware-Entwicklungsstatus

Das Repository enthält eine Klipper-Konfigurationsreferenz fur NebulaTor. Sie definiert Lade-/Entladevariablen, Extruderwerte, Lade-/Entlademakros, NeoPixel-Setup, einen Entladebutton und das Verhalten des Filamentsensors.

Die hier gezeigte Firmware dokumentiert die aktuelle Entwicklungslogik. Final validierte Konfigurationsdateien werden mit der Projektdokumentation veroffentlicht.

Firmware-Konzepte

Plattform

Die aktuelle Konfigurationsreferenz ist fur Klipper geschrieben.

Lade- und Entlademakros

NEBULA_LOAD_FILAMENT und NEBULA_UNLOAD_FILAMENT steuern die kontrollierte Filamentbewegung uber gemeinsame Variablen.

Extruderwerte

Die Konfiguration dokumentiert rotation_distance 51.75, gear_ratio 11.25:1 und max_extrude_only_distance 200.0.

Button- und Sensorlogik

Die Entwicklungskonfiguration nutzt gcode_button Einträge fur den Entladebutton und den Filamentsensor.

Controller-Abhängigkeit

Die Pin-Namen im Repository sind board-spezifische Beispiele und mussen vom Benutzer angepasst werden.

Cutter-Steuerung

Der Cutter ist Teil des Hardwaresystems; das finale offentliche Firmware-Verhalten fur Release-Pakete muss noch validiert werden.

Configuration explanation

Das Repository enthält eine Klipper-Konfigurationsreferenz fur NebulaTor. Sie definiert Lade-/Entladevariablen, Extruderwerte, Lade-/Entlademakros, NeoPixel-Setup, einen Entladebutton und das Verhalten des Filamentsensors.

The documented Klipper reference is organized around the extruder values, shared load/unload variables, the load and unload macros, NeoPixel setup, the unload button, and filament sensor behavior.

Sichere Auszuge

Extruder-Referenz

Kernwerte aus der aktuellen Klipper-Referenz.

[extruder]
rotation_distance: 51.75
gear_ratio: 11.25:1
max_extrude_only_distance: 200.0

Lade-/Entladevariablen

Distanzen und Geschwindigkeiten werden zentralisiert, bevor die Makros sie verwenden.

variable_unload_purge_distance: 35
variable_unload_distance: 120
variable_load_distance: 40
variable_load_purge_distance: 70

Makronamen

Die Seite dokumentiert den Zweck der Makros, ohne eine finale herunterladbare Konfiguration zu veroffentlichen.

NEBULA_UNLOAD_FILAMENT
NEBULA_LOAD_FILAMENT

Complete Klipper Configuration

[gcode_macro _NEBULA_VARIABLE]
# unload
variable_unload_purge_distance: 35   # (mm) purge a distance before unload to clean filament
variable_unload_purge_speed:    300  # (mm/min) purge speed
variable_unload_distance:       120  # (mm) unload distance
variable_unload_speed:          3000 # (mm/min) unload speed
# load
variable_load_distance:         40   # (mm) load distance
variable_load_speed:            1500 # (mm/min) load speed
variable_load_purge_distance:   70   # (mm) purge a distance after load
variable_load_purge_speed:      300  # (mm/min) purge speed
gcode:

[extruder]
rotation_distance: 51.75
gear_ratio: 11.25:1
max_extrude_only_distance: 200.0 # must be greater than the distance of the single segment above 

[respond]
default_type: echo

[gcode_macro NEBULA_UNLOAD_FILAMENT]
gcode:
  {% set nebula = printer['gcode_macro _NEBULA_VARIABLE'] %}
  {% set unload_purge_distance = nebula.unload_purge_distance %}
  {% set unload_purge_speed = nebula.unload_purge_speed %}
  {% set unload_distance = nebula.unload_distance %}
  {% set unload_speed = nebula.unload_speed %}

  SAVE_GCODE_STATE NAME=tmp_unload_state
  G91
  G92 E0
  M118 Nebula unload purging
  G1 E{unload_purge_distance} F{unload_purge_speed}
  M400
  M118 Nebula unloading
  G1 E-{unload_distance} F{unload_speed}
  M400
  RESTORE_GCODE_STATE NAME=tmp_unload_state

[gcode_macro NEBULA_LOAD_FILAMENT]
gcode:
  {% set nebula = printer['gcode_macro _NEBULA_VARIABLE'] %}
  {% set load_purge_distance = nebula.load_purge_distance %}
  {% set load_purge_speed = nebula.load_purge_speed %}
  {% set load_distance = nebula.load_distance %}
  {% set load_speed = nebula.load_speed %}

  SAVE_GCODE_STATE NAME=tmp_unload_state
  G91
  G92 E0
  M118 Nebula loading
  G1 E{load_distance} F{load_speed}
  M400
  M118 Nebula load purging
  G1 E{load_purge_distance} F{load_purge_speed}
  M400
  RESTORE_GCODE_STATE NAME=tmp_unload_state

[neopixel nebula_neopixel]
pin: EBBCan:PD3 # RGB pin（marked as RGB on extruder）, Modify this to match your mainboard！
chain_count: 2
color_order: GRB
initial_RED: 1.0
initial_GREEN: 1.0
initial_BLUE: 1.0

[gcode_button nebula_unload_button]
pin: ^!EBBCan:PB4 # Gcode Button pin（marked as GB on extruder）, Modify this to match your mainboard！
debounce_delay: 0.02
press_gcode:
release_gcode:
  {% if printer.print_stats.state != "printing" %}
    {% set fs = printer['gcode_button filament_sensor'] %}
    {% if fs.state == "RELEASED" %}
      NEBULA_UNLOAD_FILAMENT
    {% endif %}
  {% endif %}

[gcode_button filament_sensor]
pin: ^EBBCan:PB3 # Filament sensor pin（marked as FS on extruder）, Modify this to match your mainboard！
debounce_delay: 0.5
press_gcode:
  {% if printer.print_stats.state == "printing" %}
    PAUSE # [pause_resume] is required in printer.cfg
  {% endif %}
release_gcode:
  {% if printer.print_stats.state != "printing" %}
    NEBULA_LOAD_FILAMENT
  {% endif %}

Important sections

  • [extruder] reference values.
  • Load and unload variables used by the macros.
  • NEBULA_UNLOAD_FILAMENT and NEBULA_LOAD_FILAMENT macro entries.
  • NeoPixel setup.
  • Unload button and filament sensor behavior through gcode_button entries.

Comments and implementation notes

# Board and pin names are controller-specific.
# Sensor and unload-button wiring must match the user machine.
# Pause/resume and NeoPixel behavior must be validated before release use.

Was Benutzer anpassen mussen

  • Board- und Pin-Namen.
  • Sensor- und Button-Verkabelung.
  • Pause-/Resume-Verhalten.
  • NeoPixel-Pin und Verhalten der Kette.
  • Alle finalen Release-Einstellungen aus dem validierten Paket.
Nebula Motor-Wicklungsdiagramm aus dem Projektmanual.