base on Firmware for the Original Prusa MINI, Original Prusa MK4 and the Original Prusa XL 3D printers by Prusa Research. # Buddy This repository includes source code and firmware releases for the Original Prusa 3D printers based on the 32-bit ARM microcontrollers. The currently supported models are: - Original Prusa MINI/MINI+ - Original Prusa MK3.5 - Original Prusa MK3.9 - Original Prusa MK4 - Original Prusa XL ## Getting Started ### Requirements - Python 3.8 or newer ### Cloning this repository Run `git clone https://github.com/prusa3d/Prusa-Firmware-Buddy.git`. ### Building (on all platforms, without an IDE) Run `python utils/build.py`. The binaries are then going to be stored under `./build/products`. - Without any arguments, it will build a release version of the firmware for all supported printers and bootloader settings. - To generate `.bbf` versions of the firmware, use: `./utils/build.py --generate-bbf`. - Use `--build-type` to select build configurations to be built (`debug`, `release`). - Use `--preset` to select for which printers the firmware should be built. - By default, it will build the firmware in "prerelease mode" set to `beta`. You can change the prerelease using `--prerelease alpha`, or use `--final` to build a final version of the firmware. - Use `--host-tools` to include host tools in the build (`bin2cc`, `png2font`, ...) - Find more options using the `--help` flag! #### Examples: Build the firmware for MINI and XL in `debug` mode: ```bash python utils/build.py --preset mini,xl --build-type debug ``` Build the firmware for MINI using a custom version of gcc-arm-none-eabi (available in `$PATH`) and use `Make` instead of `Ninja` (not recommended): ```bash python utils/build.py --preset mini --toolchain cmake/AnyGccArmNoneEabi.cmake --generator 'Unix Makefiles' ``` #### Windows 10 troubleshooting If you have python installed and in your PATH but still getting cmake error `Python3 not found.` Try running python and python3 from cmd. If one of it opens Microsoft Store instead of either opening python interpreter or complaining `'python3' is not recognized as an internal or external command, operable program or batch file.` Open `manage app execution aliases` and disable `App Installer` association with `python.exe` and `python3.exe`. ### Development The build process of this project is driven by CMake and `build.py` is just a high-level wrapper around it. As most modern IDEs support some kind of CMake integration, it should be possible to use almost any editor for development. Below are some documents describing how to setup some popular text editors. - [Visual Studio Code](doc/editor/vscode.md) - [Vim](doc/editor/vim.md) - [Eclipse, STM32CubeIDE](doc/editor/stm32cubeide.md) - [Other LSP-based IDEs (Atom, Sublime Text, ...)](doc/editor/lsp-based-ides.md) #### Contributing If you want to contribute to the codebase, please read the [Contribution Guidelines](doc/contributing.md). #### XL and Puppies With the XL, the situation gets a bit more complex. The firmware of XLBuddy contains firmwares for the puppies (Dwarf and Modularbed) to flash them when necessary. We support several ways of dealing with those firmwares when developing: 1. Build Dwarf/Modularbed firmware automatically and flash it on startup by XLBuddy (the default) - The Dwarf & ModularBed firmware will be built from this repo. - The puppies are going to be flashed on startup by the XLBuddy. The puppies have to be running the [Puppy Bootloader](http://github.com/prusa3d/Prusa-Bootloader-Puppy). 2. Build Dwarf/Modularbed from a given source directory and flash it on startup by XLBuddy. - Specify `DWARF_SOURCE_DIR`/`MODULARBED_SOURCE_DIR` CMake cache variable with the local repo you want to use. - Example below would build modularbed's firmware from /Projects/Prusa-Firmware-Buddy-ModularBed and include it in the xlBuddy firmware. ``` cmake .. --preset xl_release_boot -DMODULARBED_SOURCE_DIR=/Projects/Prusa-Firmware-Buddy-ModularBed ``` - You can also specify the build directory you want to use: ``` cmake .. --preset xl_release_boot \ -DMODULARBED_SOURCE_DIR=/Projects/Prusa-Firmware-Buddy-ModularBed \ -DMODULARBED_BINARY_DIR=/Projects/Prusa-Firmware-Buddy-ModularBed/build ``` 3. Use pre-built Dwarf/Modularbed firmware and flash it on startup by xlBuddy - Specify the location of the .bin file with `DWARF_BINARY_PATH`/`MODULARBED_BINARY_PATH`. - For example ``` cmake .. --preset xl_release_boot -DDWARF_BINARY_PATH=/Downloads/dwarf-4.4.0-boot.bin ``` 4. Do not include any puppy firmware, and do not flash the puppies by XLBuddy. ``` -DENABLE_PUPPY_BOOTLOAD=NO ``` - With the `ENABLE_PUPPY_BOOTLOAD` set to false, the project will disable Puppy flashing & interaction with Puppy bootloaders. - It is up to you to flash the correct firmware to the puppies (noboot variant). 5. Keep bootloaders but do not write firmware on boot. ``` -DPUPPY_SKIP_FLASH_FW=YES ``` - With the `PUPPY_SKIP_FLASH_FW` set to true, the project will disable Puppy flashing on boot. - You can keep other puppies that are not debugged in the same state as before. - Use puppy build config with bootloaders (e.g. `xl-dwarf_debug_boot`) on one or more puppies. - Recommend breakpoint at the end of `puppy_task_body()` to prevent buddy from resetting the puppy immediately when puppy stops on breakpoint. See /ProjectOptions.cmake for more information about those cache variables. #### Running tests ```bash mkdir build-tests cd build-tests cmake .. make tests ctest . ``` The simplest way to to debug (step through) a test is to specify CMAKE_BUILD_TYPE when configuring `cmake -DCMAKE_BUILD_TYPE=Debug ..` , build it with `make tests` as previously stated and then run the test with `gdb <path to test binary>` e.g. `gdb tests/unit/configuration_store/eeprom_unit_tests`. ## Flashing Custom Firmware To install custom firmware, you have to break the appendix on the board. Learn how to in the following article https://help.prusa3d.com/article/zoiw36imrs-flashing-custom-firmware. ## Feedback - [Feature Requests from Community](https://github.com/prusa3d/Prusa-Firmware-Buddy/labels/feature%20request) ## Credits - [Marlin](https://marlinfw.org/) - 3D printing core driver - [Klipper](https://www.klipper3d.org/) - input shaper code based on Klipper ## License The firmware source code is licensed under the GNU General Public License v3.0 and the graphics and design are licensed under Attribution-NonCommercial-ShareAlike 4.0 International (CC BY-NC-SA 4.0). Fonts are licensed under different license (see [LICENSE](LICENSE.md)). ", Assign "at most 3 tags" to the expected json: {"id":"1966","tags":[]} "only from the tags list I provide: [{"id":77,"name":"3d"},{"id":89,"name":"agent"},{"id":17,"name":"ai"},{"id":54,"name":"algorithm"},{"id":24,"name":"api"},{"id":44,"name":"authentication"},{"id":3,"name":"aws"},{"id":27,"name":"backend"},{"id":60,"name":"benchmark"},{"id":72,"name":"best-practices"},{"id":39,"name":"bitcoin"},{"id":37,"name":"blockchain"},{"id":1,"name":"blog"},{"id":45,"name":"bundler"},{"id":58,"name":"cache"},{"id":21,"name":"chat"},{"id":49,"name":"cicd"},{"id":4,"name":"cli"},{"id":64,"name":"cloud-native"},{"id":48,"name":"cms"},{"id":61,"name":"compiler"},{"id":68,"name":"containerization"},{"id":92,"name":"crm"},{"id":34,"name":"data"},{"id":47,"name":"database"},{"id":8,"name":"declarative-gui "},{"id":9,"name":"deploy-tool"},{"id":53,"name":"desktop-app"},{"id":6,"name":"dev-exp-lib"},{"id":59,"name":"dev-tool"},{"id":13,"name":"ecommerce"},{"id":26,"name":"editor"},{"id":66,"name":"emulator"},{"id":62,"name":"filesystem"},{"id":80,"name":"finance"},{"id":15,"name":"firmware"},{"id":73,"name":"for-fun"},{"id":2,"name":"framework"},{"id":11,"name":"frontend"},{"id":22,"name":"game"},{"id":81,"name":"game-engine "},{"id":23,"name":"graphql"},{"id":84,"name":"gui"},{"id":91,"name":"http"},{"id":5,"name":"http-client"},{"id":51,"name":"iac"},{"id":30,"name":"ide"},{"id":78,"name":"iot"},{"id":40,"name":"json"},{"id":83,"name":"julian"},{"id":38,"name":"k8s"},{"id":31,"name":"language"},{"id":10,"name":"learning-resource"},{"id":33,"name":"lib"},{"id":41,"name":"linter"},{"id":28,"name":"lms"},{"id":16,"name":"logging"},{"id":76,"name":"low-code"},{"id":90,"name":"message-queue"},{"id":42,"name":"mobile-app"},{"id":18,"name":"monitoring"},{"id":36,"name":"networking"},{"id":7,"name":"node-version"},{"id":55,"name":"nosql"},{"id":57,"name":"observability"},{"id":46,"name":"orm"},{"id":52,"name":"os"},{"id":14,"name":"parser"},{"id":74,"name":"react"},{"id":82,"name":"real-time"},{"id":56,"name":"robot"},{"id":65,"name":"runtime"},{"id":32,"name":"sdk"},{"id":71,"name":"search"},{"id":63,"name":"secrets"},{"id":25,"name":"security"},{"id":85,"name":"server"},{"id":86,"name":"serverless"},{"id":70,"name":"storage"},{"id":75,"name":"system-design"},{"id":79,"name":"terminal"},{"id":29,"name":"testing"},{"id":12,"name":"ui"},{"id":50,"name":"ux"},{"id":88,"name":"video"},{"id":20,"name":"web-app"},{"id":35,"name":"web-server"},{"id":43,"name":"webassembly"},{"id":69,"name":"workflow"},{"id":87,"name":"yaml"}]" returns me the "expected json"