1
0
jcktrue.dk/content/project/controllib/index.md
Jens True 4fb876bcb0
All checks were successful
continuous-integration/drone/push Build is passing
COntrol library idea
2021-07-21 21:27:11 +02:00

2.9 KiB

title summary authors tags categories date external_link image url_code url_pdf url_slides url_video slides
Control Library A library for quick and easy implementation of regulation and control loops. (PID)
2021-07-21T20:49:38+02:00
caption focal_point preview_only
Control loop false

{{% callout note %}} Concept phase. No implementation yet. {{% /callout %}}

Concept

Implement commonly used algorithms used in control loops. This typically covers PID control loops and their supporting elements. (Filters, scaling, glitch detection etc).

Why

Control loops typically interact with the real world. The real world is complex enough without an added layer of code complexity. The goal of the project is to keep the implementation clear and easy to understand. Code that is easy to undersstand is easy to modify and adapt.

How

Implement in C++ taking advantage of object orientated features to present a clean API for the user. Should not rely on integer math and optimization. Floats and integers both have their pros and cons. Floating Point are avaible on most micro controllers and the user should not worry about premature optimization. Slow routines may be updated at a later time if the need arises. The library should remain cross-platform to ensure the code may be used for embedded development and on the desktop. (All the way from Arduino to Windows). Reflect Control loop diagrams as closely as possible.

TDD

Unit test individual components to ensure their reliability before integration. Compare with other implementations for correcteness taking into account floating point (in)accuracy.

Features

  • PID controller
    • P/PI/PID
    • Various clamping/anti-windup strategies.
  • Filters
    • Exponentional Moving Average
    • Rolling average
    • Kalman Filter
    • FIR/IIR
  • Detection
    • Inside/Outside range, inhibit time, hysteresis, glitch protection
    • Deadbands
  • Ramp / Fade
    • Expontential, Linear
  • Generators
    • Sine, Square, Triangle, Sawtooth
  • Utils
    • Linear scaling (Y=ax+b)
    • Polyominal
    • Map
  • Limit

Example

graph LR;
  Input-->Map-->Filter-->Error-->PID-->Limit-->Output;