Sobat Firmware Prusa

Sobat

Repositori ini mencakup kode sumber dan rilis firmware untuk printer 3D Prusa Asli berdasarkan mikrokontroler ARM 32-bit.

Model yang didukung saat ini adalah:

• Prusa MINI/MINI+ Asli
• Prusa MK3.5 Asli
• Prusa MK3.9 Asli
• Prusa MK4 Asli
• Prusa XL Asli

Memulai

Persyaratan

• Python 3.8 atau lebih baru

Mengkloning repositori ini

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

Membangun (di semua platform, tanpa IDE)

Jalankan python utils/build.py . Biner tersebut kemudian akan disimpan di bawah ./build/products .

• Tanpa argumen apa pun, ini akan membuat versi rilis firmware untuk semua printer yang didukung dan pengaturan bootloader.
• Untuk menghasilkan firmware versi .bbf , gunakan: ./utils/build.py --generate-bbf .
• Gunakan --build-type untuk memilih konfigurasi build yang akan dibuat ( debug , release ).
• Gunakan --preset untuk memilih printer mana yang firmwarenya harus dibuat.
• Secara default, ini akan membuat firmware dalam "mode prarilis" yang disetel ke beta . Anda dapat mengubah prarilis menggunakan --prerelease alpha , atau menggunakan --final untuk membuat versi final firmware.
• Gunakan --host-tools untuk menyertakan alat host dalam build ( bin2cc , png2font , ...)
• Temukan opsi lainnya menggunakan tanda --help !

Contoh:

Bangun firmware untuk MINI dan XL dalam mode debug :

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

Buat firmware untuk MINI menggunakan versi khusus gcc-arm-none-eabi (tersedia dalam $PATH ) dan gunakan Make alih-alih Ninja (tidak disarankan):

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

Pemecahan masalah Windows 10

Jika Anda telah menginstal python dan di PATH Anda tetapi masih mendapatkan kesalahan cmake, Python3 not found. Coba jalankan python dan python3 dari cmd. Jika salah satunya membuka Microsoft Store alih-alih membuka juru bahasa python atau mengeluh 'python3' is not recognized as an internal or external command, operable program or batch file. Buka manage app execution aliases dan nonaktifkan asosiasi App Installer dengan python.exe dan python3.exe .

Perkembangan

Proses pembangunan proyek ini didorong oleh CMake dan build.py hanyalah pembungkus tingkat tinggi di sekitarnya. Karena sebagian besar IDE modern mendukung semacam integrasi CMake, hampir semua editor dapat digunakan untuk pengembangan. Di bawah ini adalah beberapa dokumen yang menjelaskan cara menyiapkan beberapa editor teks populer.

• Kode Visual Studio
• Vim
• Gerhana, STM32CubeIDE
• IDE berbasis LSP lainnya (Atom, Sublime Text, ...)

Berkontribusi

Jika Anda ingin berkontribusi pada basis kode, harap baca Pedoman Kontribusi.

XL dan Anak Anjing

Dengan XL, situasinya menjadi lebih rumit. Firmware XLBuddy berisi firmware untuk anak anjing (Dwarf dan Modularbed) untuk mem-flash-nya bila diperlukan. Kami mendukung beberapa cara menangani firmware tersebut saat mengembangkan:

1. Buat firmware Dwarf/Modularbed secara otomatis dan flash saat startup oleh XLBuddy (default)

   • Firmware Dwarf & ModularBed akan dibuat dari repo ini.
   • Anak-anak anjing akan di-flash saat startup oleh XLBuddy. Anak anjing harus menjalankan Puppy Bootloader.

2. Bangun Dwarf/Modularbed dari direktori sumber tertentu dan flash saat startup oleh XLBuddy.

   • Tentukan DWARF_SOURCE_DIR / MODULARBED_SOURCE_DIR CBuat variabel cache dengan repo lokal yang ingin Anda gunakan.
   • Contoh di bawah ini akan membuat firmware modularbed dari /Projects/Prusa-Firmware-Buddy-ModularBed dan memasukkannya ke dalam firmware xlBuddy.

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

   • Anda juga dapat menentukan direktori build yang ingin Anda gunakan:

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

3. Gunakan firmware Dwarf/Modularbed bawaan dan flash saat startup oleh xlBuddy

   • Tentukan lokasi file .bin dengan DWARF_BINARY_PATH / MODULARBED_BINARY_PATH .
   • Misalnya

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

4. Jangan sertakan firmware anak anjing apa pun, dan jangan mem-flash anak anjing tersebut dengan XLBuddy.

    -DENABLE_PUPPY_BOOTLOAD=NO
   

   • Dengan ENABLE_PUPPY_BOOTLOAD disetel ke false, proyek akan menonaktifkan flashing Puppy & interaksi dengan bootloader Puppy.
   • Terserah Anda untuk mem-flash firmware yang benar ke anak anjing (varian noboot).

5. Pertahankan bootloader tetapi jangan menulis firmware saat boot.

    -DPUPPY_SKIP_FLASH_FW=YES
   

   • Dengan PUPPY_SKIP_FLASH_FW disetel ke true, proyek akan menonaktifkan flashing Puppy saat boot.
   • Anda dapat menjaga anak anjing lain yang belum di-debug dalam kondisi yang sama seperti sebelumnya.
   • Gunakan konfigurasi puppy build dengan bootloader (misalnya xl-dwarf_debug_boot ) pada satu atau lebih anak anjing.
   • Rekomendasikan breakpoint di akhir puppy_task_body() untuk mencegah sobat menyetel ulang anak anjing segera ketika anak anjing berhenti pada breakpoint.

Lihat /ProjectOptions.cmake untuk informasi selengkapnya tentang variabel cache tersebut.

Menjalankan tes

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

Cara paling sederhana untuk men-debug (melangkah melalui) suatu pengujian adalah dengan menentukan CMAKE_BUILD_TYPE ketika mengonfigurasi cmake -DCMAKE_BUILD_TYPE=Debug .. , buat dengan make tests seperti yang dinyatakan sebelumnya dan kemudian jalankan tes dengan gdb misalnya gdb tests/unit/configuration_store/eeprom_unit_tests .

Mem-flash Firmware Khusus

Untuk menginstal firmware khusus, Anda harus memecahkan lampiran di papan. Pelajari caranya di artikel berikut https://help.prusa3d.com/article/zoiw36imrs-flashing-custom-firmware.

Masukan

• Permintaan Fitur dari Komunitas

Kredit

• Marlin - driver inti pencetakan 3D
• Klipper - memasukkan kode pembentuk berdasarkan Klipper

Lisensi

Kode sumber firmware dilisensikan di bawah GNU General Public License v3.0 dan grafis serta desainnya dilisensikan di bawah Attribution-NonCommercial-ShareAlike 4.0 International (CC BY-NC-SA 4.0). Font dilisensikan dengan lisensi yang berbeda (lihat LISENSI).