controllerPidKmp

1.0.1indexed

Lightweight, extensible PID controller offering customizable kp/ki/kd, time-based integration/derivative, anti-windup, output limits and auto-mode — easy to embed in control loops with deterministic math.

AndroidJVMNative·Murilo-Migliati/controllerPidKmp

Stars

—

Used by

dependents

—

Health

/ 100

Kotlin PID Controller (KMP)

A lightweight and extensible PID controller library written in Kotlin Multiplatform (KMP) — designed to bring precise control algorithms to Android, iOS, and desktop systems with minimal effort.

This project is a refactored and extended version of the original Simple PID Controller by Mark Lundberg.
While the core logic was inspired by Lundberg’s work, this implementation was rebuilt from scratch in Kotlin, focusing on cross-platform performance, type safety, and developer experience.

✨ Features

🧠 Clean, lightweight, and multiplatform-ready.
⚙️ Fully customizable PID gains (kp, ki, kd).
🕒 Supports time-based integration and derivative control.
🧩 Designed for easy embedding in control loops (motors, sensors, processes, etc.).
🔄 Built-in support for anti-windup, output limits, and auto-mode.
📱 Works seamlessly across Android, iOS, and JVM targets.

🚀 Installation

Available on Maven Central:

Maven

<dependency>
    <groupId>io.github.murilo-migliati</groupId>
    <artifactId>controllerPidKmp</artifactId>
    <version>1.0.1</version>
</dependency>

Gradle (Groovy DSL)

implementation "io.github.murilo-migliati:controllerPidKmp:1.0.1"

Gradle (Kotlin DSL)

implementation("io.github.murilo-migliati:controllerPidKmp:1.0.1")

✅ Note: Always check the latest version on Maven Central.

🧮 Example Usage

// The correct import (based on your 'namespace')
import com.murilomigliati.pid.PIDController

fun  {
     pid = PIDController(
        kp = ,
        ki = ,
        kd = ,
        setpoint = 
    )

     humidity = 
    
    
    repeat() {
         output = pid.call(humidity)
        println()
        
        
         (output != ) {
            humidity += output /  
        }
    }
}

⚖️ License

This project is licensed under the MIT License.
It includes conceptual work derived from Mark Lundberg’s Simple PID Controller.

MIT License

Copyright (c) 2025 Murilo Migliati

Permission is hereby granted, free of charge, to any person obtaining a copy
of this software and associated documentation files ...

🧩 Platforms Supported

🧠 Design Philosophy

This library focuses on:

Cross-platform compatibility through KMM.
Type safety using Double.
Deterministic math, for predictable control behavior.
Modular architecture, enabling extensions or custom backends.

🛣️ Roadmap

Unit tests for all platforms
Add time-based tuning utilities
Integrate simulation helpers for embedded systems
Provide Compose multiplatform demo

🙌 Credits

Original idea by Mark Lundberg — Simple PID Controller
Refactored and modernized for Kotlin Multiplatform by Murilo Migliati

🧑‍💻 Contributing

Contributions are welcome!
Feel free to open issues or submit pull requests to improve performance, portability, or API clarity.

Related libraries

Surfaced from shared tags and platforms — no rankings paid for.

kviewmodel--mpp★ 47

adeo-opensourceLightweight library for implementing MVVM or MVI patterns, compatible with Jetpack Compose, XML, and UIKit. Supports shared and custom ViewModel exception handlers and integrates with Odyssey for navigation.Shared: kotlin-dsl

compose-keyhandler★ 45

Loop312Enables key event handling by mapping keys to actions and executing them while pressed, suitable for interactive applications. Offers fine control over key event variables.Shared: kotlin-dsl

LocoLaser★ 33

PocketByteTool for importing localized strings from external sources to various project formats, including XML, JSON, and INI files. Supports multiple platforms and integrates with Google Sheets for streamlined localization management.Shared: kotlin-dsl

ylcs-kmp★ 27

rachel-ylcsRapid development framework integrating logic, services and UI with modular DSL, type-safe APIs, flexible navigation, native components, custom themes, responsive layout, and client-server collaboration.Shared: kotlin-dsl

JetWhale★ 22

kitakkunExtensible, plugin-based debugging platform with runtime-loadable modules, DSL configuration, simultaneous session support, and type-safe serialized communication for customizable debugging workflows.Shared: kotlin-dsl

K2D★ 20

glureauGenerates mermaid class and sequence diagrams and markdown tables from source code, supports regex include/exclude rules, inheritance-based selection, customizable rendering, and hyperlink integration.Shared: kotlin-dsl

Android	✅	Fully supported
JVM	✅	Compatible with any JVM project
iOS	✅	Build with KMM native targets
macOS / Linux	✅	Via Kotlin/Native