Revelacao publica do projeto

NebulaTor

Um upgrade projetado pela CN3D para BIQU/BTT Nebula Extruder, desenvolvido em torno de melhor manuseio de filamento, sensores, manutencao e sistema de corte integrado.

Arquivos em breve: a documentacao esta publica agora, arquivos STL estao planejados depois, e CAD/STEP apenas apos validacao final.

Documentacao publica ativaBase BIQU / BTT Nebula ExtruderSTL em breveCAD apos validacao

Explorar documentacao Ver em acao

Render em angulo do NebulaTor mostrando a janela frontal, a alavanca do idler, o mecanismo de pre-carga da mola e o lado do motor.

Docs publicadasRevelacao publica do projeto e documentacao

STL depoisArquivos imprimiveis planejados apos validacao

CAD mais tardeCAD/STEP planejados apos validacao final

KlipperLogica de firmware de desenvolvimento documentada

Status de desenvolvimento do firmware

O repositorio inclui uma referencia de configuracao Klipper para o NebulaTor. Ela define variaveis de carga e descarga, valores do extrusor, macros de carga e descarga, configuracao NeoPixel, um botao de descarga e o comportamento do sensor de filamento.

O firmware mostrado aqui documenta a logica de desenvolvimento atual. Os arquivos de configuracao finais e validados serao publicados com a documentacao do projeto.

Conceitos de firmware

Plataforma

A referencia de configuracao atual foi escrita para Klipper.

Macros de carga e descarga

NEBULA_LOAD_FILAMENT e NEBULA_UNLOAD_FILAMENT controlam o movimento do filamento usando variaveis compartilhadas.

Valores do extrusor

A configuracao documenta rotation_distance 51.75, gear_ratio 11.25:1 e max_extrude_only_distance 200.0.

Logica do botao e do sensor

A configuracao de desenvolvimento usa entradas gcode_button para o botao de descarga e o sensor de filamento.

Dependencia do controlador

Os nomes de pinos no repositorio sao exemplos especificos de uma placa e devem ser adaptados pelo usuario.

Controle do cortador

O cortador faz parte do sistema de hardware; o comportamento publico final do firmware para os pacotes de lancamento ainda precisa ser validado.

Configuration explanation

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.

Trechos seguros

Referencia do extrusor

Valores principais documentados na referencia Klipper atual.

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

Variaveis de carga / descarga

Distancias e velocidades sao centralizadas antes de serem usadas pelas macros.

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

Nomes de macros

A pagina documenta a finalidade das macros sem publicar uma configuracao final para download.

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.

O que os usuarios devem adaptar

Nomes da placa e dos pinos.
Fiação dos sensores e do botao.
Comportamento de pausa/retomada.
Pino NeoPixel e comportamento da cadeia.
Quaisquer configuracoes finais de lancamento publicadas com o pacote validado.

Diagrama de bobinagem do motor Nebula no manual do projeto.