8000 GitHub - TinyMPC/TinyMPC: Model-predictive control for microcontrollers
[go: up one dir, main page]

Skip to content

TinyMPC/TinyMPC

Repository files navigation

TinyMPC: Model-Predictive Control on Resource-Constrained Microcontrollers

If you have any questions related to the solver, visit the GitHub Discussions page. This guarantees accessibility for everyone.

The documentation is available at tinympc.org

High-level language interfaces with detailed examples and code generation are available in Python, Julia, and MATLAB.

Building

For Windows - Enable wsl before following prompts below

  1. On terminal, clone this repo
git clone https://github.com/TinyMPC/TinyMPC.git
  1. Navigate to root directory and run
cd TinyMPC && mkdir build && cd build
  1. Run CMake configure step
cmake ..
  1. Build TinyMPC
cmake --build .

Examples

  • Run the quadrotor_hovering example
./examples/quadrotor_hovering
  • Run the codegen_cartpole example then follow the same building steps inside that directory
./examples/codegen_cartpole

Citing TinyMPC

If you are using TinyMPC, we encourage you to

  • Cite the related papers:
@inproceedings{tinympc,
      title={TinyMPC: Model-Predictive Control on Resource-Constrained Microcontrollers}, 
      author={Khai Nguyen and Sam Schoedel and Anoushka Alavilli and Brian Plancher and Zachary Manchester},
      year={2024},
      booktitle={IEEE International Conference on Robotics and Automation (ICRA)},
}
@misc{tinympc-conic-codegen,
      title={Code Generation and Conic Constraints for Model-Predictive Control on Microcontrollers with Conic-TinyMPC}, 
      author={Ishaan Mahajan and Khai Nguyen and Sam Schoedel and Elakhya Nedumaran and Moises Mata and Brian Plancher and Zachary Manchester},
      year={2025},
      eprint={2403.18149},
      archivePrefix={arXiv},
}
@inproceedings{tinympc-adaptive,
      title={Robust and Efficient Embedded Convex Optimization through First-Order Adaptive Caching}, 
      author={Ishaan Mahajan and Brian Plancher},
      booktitle={IEEE/RSJ International Conference on Intelligent Robots and Systems (IROS)},
      year={2025}
}
  • Put a star ⭐ on this repository.

Excited to hear your TinyMPC success stories—share them with us!

Bug reports and support

Please report any issues via the Github issue tracker. All types of issues are welcome including bug reports, documentation typos, feature requests and so on.

Running on MCUs

Numerical benchmarks against other solvers on MCUs are available here.

TinyMPC on the Crazyflie

TinyMPC-integrated firmware on the Crazyflie nano-quadrotor is available here.

TinyMPC-AL

An earlier version (not optimized) which can deal with nonlinear dynamics (e.g., bicycle models) is available here.

Notes

Releases

No releases published

Packages

No packages published

Contributors 10

Languages

0