Prusa Firmware Buddy

Companheiro

Este repositório inclui código-fonte e versões de firmware para as impressoras 3D Prusa originais baseadas em microcontroladores ARM de 32 bits.

Os modelos atualmente suportados são:

• Prusa original MINI/MINI+
• Prusa MK3.5 original
• Prusa MK3.9 Original
• Prusa MK4 Original
• Prusa XL original

Começando

Requisitos

• Python 3.8 ou mais recente

Clonando este repositório

Execute git clone https://github.com/prusa3d/Prusa-Firmware-Buddy.git .

Construindo (em todas as plataformas, sem IDE)

Execute python utils/build.py . Os binários serão armazenados em ./build/products .

• Sem quaisquer argumentos, ele criará uma versão de lançamento do firmware para todas as impressoras suportadas e configurações do bootloader.
• Para gerar versões .bbf do firmware, use: ./utils/build.py --generate-bbf .
• Use --build-type para selecionar configurações de compilação a serem construídas ( debug , release ).
• Use --preset para selecionar para quais impressoras o firmware deve ser construído.
• Por padrão, ele criará o firmware no "modo de pré-lançamento" definido como beta . Você pode alterar o pré-lançamento usando --prerelease alpha ou usar --final para construir uma versão final do firmware.
• Use --host-tools para incluir ferramentas de host na compilação ( bin2cc , png2font , ...)
• Encontre mais opções usando o sinalizador --help !

Exemplos:

Construa o firmware para MINI e XL em modo debug :

python utils/build.py --preset mini,xl --build-type debug

Construa o firmware para MINI usando uma versão personalizada de gcc-arm-none-eabi (disponível em $PATH ) e use Make em vez de Ninja (não recomendado):

python utils/build.py --preset mini --toolchain cmake/AnyGccArmNoneEabi.cmake --generator ' Unix Makefiles ' 

Solução de problemas do Windows 10

Se você tem o python instalado e em seu PATH, mas ainda está recebendo o erro cmake Python3 not found. Tente executar python e python3 no cmd. Se um deles abrir a Microsoft Store em vez de abrir o interpretador python ou reclamar 'python3' is not recognized as an internal or external command, operable program or batch file. Abra manage app execution aliases e desative a associação App Installer com python.exe e python3.exe .

Desenvolvimento

O processo de construção deste projeto é conduzido pelo CMake e build.py é apenas um wrapper de alto nível em torno dele. Como a maioria dos IDEs modernos suporta algum tipo de integração com o CMake, deve ser possível usar praticamente qualquer editor para desenvolvimento. Abaixo estão alguns documentos que descrevem como configurar alguns editores de texto populares.

• Código do Visual Studio
• Vim
• Eclipse, STM32CubeIDE
• Outros IDEs baseados em LSP (Atom, Sublime Text, ...)

Contribuindo

Se você quiser contribuir com a base de código, leia as Diretrizes de Contribuição.

XL e Filhotes

Com o XL, a situação fica um pouco mais complexa. O firmware do XLBuddy contém firmwares para os filhotes (Dwarf e Modularbed) para atualizá-los quando necessário. Apoiamos diversas maneiras de lidar com esses firmwares durante o desenvolvimento:

1. Crie firmware Dwarf/Modularbed automaticamente e atualize-o na inicialização pelo XLBuddy (o padrão)

   • O firmware Dwarf & ModularBed será construído a partir deste repositório.
   • Os filhotes serão exibidos na inicialização pelo XLBuddy. Os filhotes devem estar executando o Puppy Bootloader.

2. Construa Dwarf/Modularbed a partir de um determinado diretório de origem e atualize-o na inicialização pelo XLBuddy.

   • Especifique a variável de cache DWARF_SOURCE_DIR / MODULARBED_SOURCE_DIR CMake com o repositório local que você deseja usar.
   • O exemplo abaixo construiria o firmware do modularbed a partir de /Projects/Prusa-Firmware-Buddy-ModularBed e o incluiria no firmware xlBuddy.

    cmake .. --preset xl_release_boot -DMODULARBED_SOURCE_DIR=/Projects/Prusa-Firmware-Buddy-ModularBed
   

   • Você também pode especificar o diretório de compilação que deseja usar:

    cmake .. --preset xl_release_boot 
       -DMODULARBED_SOURCE_DIR=/Projects/Prusa-Firmware-Buddy-ModularBed  
       -DMODULARBED_BINARY_DIR=/Projects/Prusa-Firmware-Buddy-ModularBed/build
   

3. Use firmware Dwarf/Modularbed pré-construído e atualize-o na inicialização por xlBuddy

   • Especifique o local do arquivo .bin com DWARF_BINARY_PATH / MODULARBED_BINARY_PATH .
   • Por exemplo

    cmake .. --preset xl_release_boot -DDWARF_BINARY_PATH=/Downloads/dwarf-4.4.0-boot.bin
   

4. Não inclua nenhum firmware de filhote e não atualize os filhotes pelo XLBuddy.

    -DENABLE_PUPPY_BOOTLOAD=NO
   

   • Com ENABLE_PUPPY_BOOTLOAD definido como falso, o projeto desabilitará o flash do Puppy e a interação com os bootloaders do Puppy.
   • Cabe a você atualizar o firmware correto para os filhotes (variante noboot).

5. Mantenha os bootloaders, mas não grave firmware na inicialização.

    -DPUPPY_SKIP_FLASH_FW=YES
   

   • Com PUPPY_SKIP_FLASH_FW definido como verdadeiro, o projeto desabilitará o flash do Puppy na inicialização.
   • Você pode manter outros filhotes que não foram depurados no mesmo estado de antes.
   • Use a configuração de compilação do filhote com bootloaders (por exemplo, xl-dwarf_debug_boot ) em um ou mais filhotes.
   • Recomende o ponto de interrupção no final de puppy_task_body() para evitar que o amigo reinicie o filhote imediatamente quando o filhote parar no ponto de interrupção.

Consulte /ProjectOptions.cmake para obter mais informações sobre essas variáveis ​​de cache.

Executando testes

mkdir build-tests
cd build-tests
cmake ..
make tests
ctest .

A maneira mais simples de depurar (passo a passo) um teste é especificar CMAKE_BUILD_TYPE ao configurar cmake -DCMAKE_BUILD_TYPE=Debug .. , construí-lo com make tests conforme declarado anteriormente e então executar o teste com gdb <path to test binary> por exemplo gdb tests/unit/configuration_store/eeprom_unit_tests .

Firmware personalizado piscando

Para instalar o firmware personalizado, você precisa quebrar o apêndice na placa. Aprenda como fazer isso no seguinte artigo https://help.prusa3d.com/article/zoiw36imrs-flashing-custom-firmware.

Opinião

• Solicitações de recursos da comunidade

Créditos

• Marlin - driver principal de impressão 3D
• Klipper - código do modelador de entrada baseado no Klipper

Licença

O código-fonte do firmware é licenciado sob a GNU General Public License v3.0 e os gráficos e design são licenciados sob Attribution-NonCommercial-ShareAlike 4.0 International (CC BY-NC-SA 4.0). As fontes são licenciadas sob licenças diferentes (consulte LICENÇA).