Marlin

Documentação adicional pode ser encontrada na página inicial do Marlin. Teste este firmware e informe -nos se ele se comportar mal de alguma forma. Os voluntários estão de pé!

Filial do Bugfix de Marlin 2.1

Não para uso da produção. Use com cautela!

O Marlin 2.1 continua a suportar as placas AVR de 32 bits e 8 bits, enquanto adiciona suporte para até 9 eixos coordenados e até 8 extrusoras.

Esta filial é para patches para a mais recente versão de liberação 2.1.x. Periodicamente, essa filial formará a base para a próxima versão menor 2.1.x.

Faça o download das versões anteriores do Marlin na página de lançamentos.

Exemplo de configurações

Antes de construir o Marlin para sua máquina, você precisará de uma configuração para o seu hardware específico. Mediante solicitação, seu fornecedor ficará feliz em fornecer o código -fonte e as configurações completos da sua máquina, mas você precisará obter arquivos de configuração atualizados se desejar instalar uma versão mais recente do Marlin. Felizmente, os usuários do Marlin contribuíram com dezenas de configurações testadas para você começar. Visite o Repositório Marlinfirmware/Configurações para encontrar a configuração correta para o seu hardware.

Construindo Marlin 2.1

Para construir e fazer upload do Marlin, você usará uma dessas ferramentas:

• O código gratuito do Visual Studio usando a extensão do Marlin de construção automática.
• O Arduino IDE gratuito: veja a construção de Marlin com Arduino
• Você também pode usar o VSCode com o DevContainer: consulte a instalação do Marlin (vscode devContainer).

Marlin é otimizado para construir com a extensão da plataforma para o código do Visual Studio . Você ainda pode construir Marlin com Arduino IDE , e esperamos melhorar a experiência de construção do Arduino, mas neste momento a plataforma é a melhor escolha.

Placas AVR de 8 bits

Pretendemos continuar suportando placas AVR de 8 bits em perpetuidade, mantendo uma única base de código que pode se aplicar a todas as máquinas. Queremos que entusiastas casuais e Tinkerers e proprietários de máquinas mais antigas se beneficiem das inovações da comunidade tanto quanto aqueles com máquinas mais sofisticadas. Além disso, essas antigas máquinas baseadas em AVR geralmente são as melhores para seus testes e feedback!

Camada de abstração de hardware (HAL)

O Marlin inclui uma camada de abstração para fornecer uma API comum para todas as plataformas que ela tem como alvo. Isso permite que o código do Marlin aborde os detalhes das tarefas de movimento e interface do usuário nos níveis mais baixos e mais altos, sem sobrecarga do sistema, vinculando todos os eventos diretamente ao relógio de hardware.

Cada novo HAL abre um mundo de hardware. Neste momento, precisamos de HALs para o RP2040 e a família de conselhos Duet3D. Uma HAL que envolve um RTOS é um conceito interessante que pode ser explorado. Você sabia que o Marlin inclui um simulador que pode ser executado no Windows, MacOS e Linux? Junte-se à discórdia para ajudar a avançar esses subprojetos!

Plataformas suportadas

Plataforma	MCU	Placas de exemplo
Arduino Avr	Atega	Rampas, Melzi, Rambo
Teensy ++ 2.0	AT90USB1286	Printrboard
Arduino devido	Sam3x8e	Ramps-fd, radds, ramps4due
Esp32	Esp32	Fysetc e4, e4d@box, mrr
HC32	HC32	Ender-2 Pro, Voxelab Aquila
LPC1768	ARM® Cortex-M3	Mks sbase, re-arm, selena compact
LPC1769	ARM® Cortex-M3	Smoothieboard, Azteeg X5 Mini, TH3D Ezboard
STM32F103	ARM® Cortex-M3	Malyan M200, GTM32 PRO, MKS ROBIN, BTT SKR MINI
STM32F401	ARM® Cortex-M4	Armado, Rumba32, Skr Pro, Lerdge, Fysetc S6, Artilharia Ruby
Pico RP2040	Cortex duplo M0+	Bigtreetech skr pico
STM32F7X6	ARM® Cortex-M7	O Borg, Remram v1
STM32G0B1RET6	ARM® Cortex-M0+	Bigtreetech skr mini e3 v3.0
STM32H743XIT6	ARM® Cortex-M7	Bigtreetech skr v3.0, skr ez v3.0, skr se bx v2.0/v3.0
SAMD21P20A	ARM® Cortex-M0+	Adafruit Grand Central M4
SAMD51P20A	ARM® Cortex-M4	Adafruit Grand Central M4
Teensy 3.2/3.1	MK20DX256VLH7 ARM® Cortex-M4
Teensy 3.5	MK64FX512-VMD12 ARM® Cortex-M4
Teensy 3.6	MK66FX1MB-VMD18 ARM® Cortex-M4
Teensy 4.0	MIMXRT1062-DVL6B ARM® Cortex-M7
Teensy 4.1	MIMXRT1062-DVJ6B ARM® Cortex-M7
Linux Nativo	x86 / braço / risc-V	Raspberry Pi GPIO
Simulador	Windows, MacOS, Linux	OS da área de trabalho
Todos os quadros suportados	Todas as plataformas	Todas as placas

Suporte de marlin

A fila de problemas é reservada para relatórios de bugs e solicitações de recursos. Use os seguintes recursos para obter ajuda com a configuração e solução de problemas:

• Documentação de Marlin - documentação oficial do Marlin
• Marlin Discord - Discuta questões com usuários e desenvolvedores do Marlin
• Grupo do Facebook "Firmware Marlin"
• Fórum de Reprap.org Marlin
• Grupo do Facebook "Firmware Marlin para impressoras 3D"
• Configuração do Marlin no YouTube

Patches contribuindo

Você pode contribuir com patches enviando uma solicitação de tração para a ramificação (bugfix-2.1.x).

• Usamos ramificações nomeadas com um prefixo "bugfix" ou "dev" para corrigir erros e integrar novos recursos.
• Siga os padrões de codificação para ganhar pontos com os mantenedores.
• Envie solicitações de recursos e relatórios de bugs para a fila de problemas. Veja acima para obter suporte ao usuário.
• Sempre que você adicionar novos recursos, adicione um ou mais testes de construção ao buildroot/tests . Quaisquer testes adicionados a um PR serão executados nesse PR nos servidores Github assim que forem pressionados. Para minimizar a iteração, execute seus novos testes localmente, se possível.
  • Testes de construção local:
    • Todos: make tests-config-all-local
    • Único: make tests-config-single-local TEST_TARGET=...
  • Testes de construção local no Docker:
    • Todos: make tests-config-all-local-docker
    • Único: make tests-config-all-local-docker TEST_TARGET=...
  • Para executar todas as suítes de teste de unidade:
    • Usando PIO: platformio run -t test-marlin
    • Usando make: make unit-test-all-local
    • Usando Docker + Make: maker unit-test-all-local-docker
  • Para executar um único conjunto de testes de unidade:
    • Usando PIO: platformio run -t marlin_<test-suite-name>
    • Usando make: make unit-test-single-local TEST_TARGET=<test-suite-name>
    • Usando Docker + Make: maker unit-test-single-local-docker TEST_TARGET=<test-suite-name>
• Se o seu recurso puder ser testado, adicione um ou mais testes de unidade. Para obter mais informações, consulte nossa documentação sobre testes de unidade.

Colaboradores

Marlin está constantemente melhorando graças a um grande número de colaboradores de todo o mundo, trazendo suas especialidades e talentos. Agradecimentos enormes são devido a todos os colaboradores que correm regularmente os insetos, ajudam a direcionar o tráfego e basicamente impedem que Marlin se desmoronize. A existência contínua de Marlin não seria possível sem eles.

Marlin Firmware Design original do logotipo do Ahmet Cem Turan @ahmetcemTuran.

Liderança do projeto

Nome	Papel	Link	Doar
? Scott Lahteine	Líder do projeto	[@Thinkyhead]	? Doar
? Roxanne Neufeld	Admin	[@Roxy-3d]
? Keith Bennett	Admin	[@ThisisKeithB]	? Doar
? Jason Smith	Admin	[@sjasonsmith]
? Victor Oliveira	Admin	[@R talvezDodyV]
? Chris Pepper	Admin	[@p3p]
? Peter Ellens	Admin	[@ellensp]	? Doar
? Bob Kuhn	Admin	[@Bob-the-kuhn]
? Erik van der Zalm	Fundador	[@Erikzalm]

História da estrela

Licença

Marlin é publicado sob a licença da GPL porque acreditamos no desenvolvimento aberto. O GPL vem com direitos e obrigações. Se você usa o firmware do Marlin como o driver do seu produto aberto ou de código fechado, deve manter o Marlin aberto e fornecer seu código-fonte Marlin compatível para os usuários finais mediante solicitação. A maneira mais direta de cumprir a licença do Marlin é fazer um garfo de marlin no Github, executar suas modificações e direcionar usuários para o seu garfo modificado.