Basilisk Actuator Control Library
Hardware-agnostic library enabling control of of PMSM and BLDC Motors
|
Note: This library is currently under development. The architecture is fluid and subject to change.
This library is a hardware-agnostic library intended to support basic commutation of actuators. As of now, the following actuator types with associated commutation strategy are supported by this C++ library:
The following were, at one point, WIP, but are deprioritized in favour of a focus on BLDC software development.
The components shown in blue are implemented in this library; the user must implement the other modules as per their application. This affords flexibility when implementing the library as the user can adapt the various modules as required by the specific application.
The following commands are intended to be run on an Ubuntu 22.04 machine (and what is done right now in CI/CD). https://github.com/sahil-kale/basilisk-actuator-control-lib/issues/31 will track an eventual build system containerization. Follow the steps below for development:
bash scripts/setup.sh
- this will install packages on the system that are required for development.bash scripts/test.sh
to build the test cases.bash scripts/format.sh
to format the source code.bash scripts/linter.sh
to run the linter.API documentation is available here
Submit PR's against main
. PR's that modify the source code's functionality without a unit test will not be accepted unless determined that the functionality does not require one. CI will check test, lint, and format upon check-in.
General styling:
See the simulation hook-in here that employs Simulink. It is very scrappy at the moment and was used primarily for elementary modelling exposure and verification of actuator control strategies implemented in this library off-target. https://github.com/sahil-kale/basilisk-control-loop-sim