Active source development for Tinymovr has moved to a private repository as of v3.0.0. This public repository continues to host:
- Documentation in
docs/, built and published at https://tinymovr.readthedocs.io.- Releases with attached binaries (firmware, Python wheel, Studio Web) on the Releases page.
The source code in this repository reflects the state at v3.0.0 and is no longer updated. To use the latest firmware or Studio, download the latest release artifacts.
The source in this repository reflects the state at v3.0.0 and remains available under its original per-directory licenses:
- Firmware (
firmware/) — MIT- Hardware (
hardware/) — MIT- Documentation (
docs/) — MIT- Studio Python and the overall project — GPLv3 (see root
LICENSE.txtandstudio/LICENSE)Those terms remain in effect for the code as of v3.0.0. Releases from v3.1 onward are distributed by MotionLayer P.C. as proprietary binaries built from a private codebase; their source is not published.
For support: Discord · Discussions · Issues · tinymovr.com
Tinymovr is an affordable motor controller with integrated encoder and CAN bus for precise control of 3-phase brushless motors (PMSMs).
This repository holds the open source firmware, client library, hardware designs and documentation source.
Note
This is the latest stable version of the Tinymovr Firmware and Studio app. For the legacy 0.x.x version, check out the legacy branch.
Please visit the Quick Start Guide
Full documentation is available at Readthedocs.
Please visit the Discussions Page and the Discord Server to ask any questions. If you are unable to find an answer to your question, you are welcome to start a new discussion or ask away at our Discord server.
If you would like to propose a feature or think you have found a bug, open a new issue.
Note: The
mainbranch reflects the latest release. Development happens on develop.
The repository is organized as follows:
firmware: Firmware for the PAC5527 MCU in Tinymovr
studio: Tinymovr Studio client software and library
hardware: Designs and drawings for related hardware
docs: User documentation source (built with Sphinx)
See also: Developer documentation in root (ARCHITECTURE.md, CONTRIBUTING.md, etc.)
For contributors and AI agents working with the codebase:
- ARCHITECTURE.md - System design and module organization
- CONTRIBUTING.md - Setup, workflow, and PR process
- SAFETY.md - Safety-critical constraints (read before modifying firmware)
- CLAUDE.md - Navigation guide for AI agents
Additional technical documentation:
- AVLOS_GUIDE.md - Protocol modification workflow
- CONVENTIONS.md - Code style and patterns
- TESTING.md - Testing practices
- STRUCTURE.md - Directory organization
- PAC5527_NOTES.md - MCU architecture
We use SemVer for versioning. For the versions available, see the tags on this repository.
Pull requests are welcome. For major changes, please open an issue first to discuss what you would like to change.
New contributors: See CONTRIBUTING.md for setup instructions and workflow.
AI agents: See CLAUDE.md for navigation and guidelines.
BLDC-Design-Help Repository, with lots of useful information and Tinymovr benchmarks