Ecosyste.ms: Awesome
An open API service indexing awesome lists of open source software.
https://github.com/katyo/uctl-d
Generic control library for low-end hardware
https://github.com/katyo/uctl-d
Last synced: 16 days ago
JSON representation
Generic control library for low-end hardware
- Host: GitHub
- URL: https://github.com/katyo/uctl-d
- Owner: katyo
- Created: 2020-07-24T14:34:55.000Z (over 4 years ago)
- Default Branch: master
- Last Pushed: 2020-11-01T09:58:53.000Z (about 4 years ago)
- Last Synced: 2024-10-30T16:12:07.834Z (2 months ago)
- Language: D
- Size: 4.76 MB
- Stars: 2
- Watchers: 3
- Forks: 0
- Open Issues: 0
-
Metadata Files:
- Readme: README.md
Awesome Lists containing this project
README
# Generic control library for low-end hadrware
[](https://dlang.org/)
[](https://opensource.org/licenses/MIT)
[](https://github.com/katyo/uctl-d/actions?query=workflow%3ACI)
This library intended to simplify developing control algorithms for bare-metal low-end hardware such as microcontrollers without FPU.
## Overview
This library consist of independent components which grouped by filters, regulators, transformers, modulators, models and utils, such as clampers, scalers and etc.
Also it includes some widely used math functions approximations, which can be configured to reach optimal balance between precision and speed.
The filters and regulators can be configured in a human-friendly way without using obscure artifical coefficients.
In addition to standard floating-point types, this library introduces easy to use range-based fixed-point type, which can help to make control algorithms so efficient to fit to low-end integer microcontrollers without floating-point unit (FPU).
To get easy developing, debugging, testing and verivication all components can operate both with floating-point and fixed-point values.
### Optimization techniques
When you targeted to FPU-less hardware in order to get best possible performance and reduce firmware size you should use only binary fixed-point arithmetic because internally it operates with integers.
Also you should avoid exceeding platform word size when it is possible without lossing required precision.
### Implementation notes
Fixed point arithmetic has well known problems with overflowing especially on multiplication. Also it has well known problems with precision loss on division. Using range-based arithmetic can help to avoid that problems by selecting optimal type for each operation. To get it works this library utilizes metaprogramming features of programming language on types level.
### Why D? Why not C++ or Rust or something else
Only limited subset of programming languages can be used for microcontrollers firmware development. Traditionally this is _C_ and _C++_ and now is _Rust_ also.
Different programming languages have different metaprogramming capabilities. Previously I tried implement similar libraries with _C++_ and even _Rust_. But in practice was not so easy to reach planned goals using it.
Template system of _C++_ technically has needed capabilities but it isn't so clear and flexible but much more poor and tricky.
_Rust_ is missing type-level constants itself but it has alternative solutions like `typenum` which allows to do it but it isn't so easy to use especially for non-integers.
_D_ has powerful compile-time function evaluation (CTFE) engine and also much more clear, flexible and easy to use template system.
In my experience currently _D_ is a best choice to achieve the goals pursued by this library.