Skip to content

DevHeadsCommunity/.github

Project - A template for a good README

Open-Source | Community-Driven | Real-World Ready

A high-efficiency, sensorless/sensored Field-Oriented Control (FOC) motor controller firmware designed for a golf cart. Built for reliability, smooth torque control, and energy efficiency—perfect for hobbyists and researchers.

Why Use This?

  • Precision Control: Smooth, efficient FOC for optimal motor performance.
  • Open & Hackable: Fully open-source, no vendor lock-in.
  • Proven in Real-World Use: Already powering a golf cart.
  • Active Community: Collaborate, improve, and get support from developers worldwide.

Project Goals

We’re building a robust, community-driven FOC motor controller that:

  • Simplifies high-performance motor control.
  • Encourages open collaboration—no black-box code or proprietary limitations.
  • Scales from DIY to production with modular, well-documented firmware.

Is This for You?

  • You’re a developer/tinkerer looking for a flexible FOC implementation.
  • You’re building/modifying a small EV and need reliable motor control.
  • You want to contribute to open-source embedded systems.

(If you need a plug-and-play commercial solution, check out [alternative product].)


Features

  • Field-Oriented Control (FOC) for smooth, efficient motor operation.
  • Supports [X] motor types (PMSM, BLDC, etc.) + [sensored/sensorless] modes.
  • Configurable for different battery packs (24V, 48V, etc.).
  • Real-world tested under golf cart load conditions.
  • Modular codebase for easy customization.

(See full feature list in the docs).


Quick Start

1. Hardware Setup

  • Supported Boards: [List compatible boards, e.g., STM32F4, ESP32].
  • Wiring Guide: [Link to schematic/pinout].

2. Flash the Firmware

git clone [email protected]:DevHeadsCommunity/Mordor.git
cd Mordor
west build -b mimxrt1060_evk
west flash

(See detailed installation guide for help.)

3. Configure & Tune

Edit config.h for your motor specs:

#define MOTOR_POLE_PAIRS 4
#define MAX_CURRENT 50.0 // Amps

(Need help? Join our [Discord/Forum] for support!)


Community Showcase

See what others are building with this project:

Join the Discussion!

We’re active on:

  • [Discord/Matrix/Slack] - [invite link]
  • [Forum/GitHub Discussions] - [link]
  • Contributions welcome! Check out the roadmap and good first issues.

License

Open-source under [MIT/BSD/Apache] – use, modify, and share freely!

Love this project? Give it a star to help it grow!


Why This Works

Clear value proposition upfront (FOC for golf carts).

Quick filtering (“Is this for me?” section).

Encourages engagement (showcase + community links).

Low barrier to entry (simple flash/configure commands).

About

DevHeads Community health files

Resources

License

MIT, Unknown licenses found

Licenses found

MIT
LICENSE
Unknown
COPYING

Code of conduct

Contributing

Stars

Watchers

Forks

Releases

No releases published

Packages

No packages published