Michal
/
Prusa-Firmware-MMU
mirror of https://github.com/prusa3d/Prusa-Firmware-MMU
1
0
Fork 0
Code Issues Packages Projects Releases Wiki Activity
840 Commits
5 Branches
5 Tags
8.1 MiB
C 64%
C++ 29%
CMake 2.2%
Python 2.1%
Makefile 1.9%
Other 0.7%
 
 
 
 
 
 
Go to file
3d-gussner 8d9e9ea8b6 First update of README 2023-08-31 07:59:07 +02:00
.vscode Sync with MK3 2022-12-18 17:41:22 +00:00
cmake cmake: Set source epoch from the HEAD commit 2023-08-17 14:19:59 +02:00
lib Change USB strings 2023-08-11 10:14:59 +02:00
src Update to MMU3 2023-08-22 16:11:10 +02:00
tests Perform up to maximumBowdenLength while unloading to FINDA 2023-08-10 16:08:07 +02:00
utils Update build server config 2023-07-13 16:24:06 +02:00
.clang-format Disable preprocessor code indentation 2021-07-07 16:33:03 +02:00
.cmake-format.py Prepare parts of the build system 2021-04-19 07:03:47 +02:00
.gitignore Prepare parts of the build system 2021-04-19 07:03:47 +02:00
.pre-commit-config.yaml hooks: Update cmake-format to 0.6.13 2022-10-10 11:50:05 +02:00
CMakeLists.txt Update to MMU3 2023-08-22 16:11:10 +02:00
Doxyfile Update to MMU3 2023-08-22 16:11:10 +02:00
README.md First update of README 2023-08-31 07:59:07 +02:00
version.cmake Increase version to 3.0.1 2023-08-10 16:08:07 +02:00

README.md

Prusa-Firmware-MMU-Private

This repository includes source code and firmware releases for the Original Prusa Multi Material Upgrade based on 8-bit ATMEL microcontroller.

The currently supported models are:

  • Original Prusa MMU3
  • Original Prusa MMU2S

Getting Started

Requirements

  • Python 3.6 or newer (with pip)

Cloning this repository

Run git clone https://github.com/prusa3d/Prusa-Firmware-MMU.git.

How to prepare build env and tools

Run ./utils/bootstrap.py

bootstrap.py will now download all the "missing" dependencies into the .dependencies folder:

  • clang-format-9.0.0-noext
  • cmake-3.22.5
  • ninja-1.10.2
  • avr-gcc-7.3.0

How to build the preliminary project so far:

Now the process is the same as in the Buddy Firmware:

./utils/build.py

builds the `MMU3_..+`` in build/release folder

In case you'd like to build the project directly via cmake you can use an approach like this:

mkdir build
cd build
cmake .. -G Ninja -DCMAKE_TOOLCHAIN_FILE=../cmake/AvrGcc.cmake
ninja

It will produce a MMU3_<version>.hex file.

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
  • Vim
  • Other LSP-based IDEs (Atom, Sublime Text, ...)

Formatting

All the source code in this repository is automatically formatted:

If you want to contribute, make sure to install pre-commit and then run pre-commit install within the repository. This makes sure that all your future commits will be formatted appropriately. Our build server automatically rejects improperly formatted pull requests.

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).