80 lines
2.1 KiB
C++
80 lines
2.1 KiB
C++
|
/*
|
||
|
|
* This Source Code Form is subject to the terms of the Mozilla Public
|
||
|
|
* License, v. 2.0. If a copy of the MPL was not distributed with this
|
||
|
|
* file, You can obtain one at http://mozilla.org/MPL/2.0/.
|
||
|
|
*/
|
||
|
|
#pragma once
|
||
|
|
|
||
|
|
#include "okapi/api/control/closedLoopController.hpp"
|
||
|
|
#include "okapi/api/units/QTime.hpp"
|
||
|
|
|
||
|
|
namespace okapi {
|
||
|
|
/**
|
||
|
|
* Closed-loop controller that steps iteratively using the step method below.
|
||
|
|
*
|
||
|
|
* `ControllerOutput::controllerSet()` should set the controller's target to the input scaled by
|
||
|
|
* the output bounds.
|
||
|
|
*/
|
||
|
|
template <typename Input, typename Output>
|
||
|
|
class IterativeController : public ClosedLoopController<Input, Output> {
|
||
|
|
public:
|
||
|
|
/**
|
||
|
|
* Do one iteration of the controller.
|
||
|
|
*
|
||
|
|
* @param ireading A new measurement.
|
||
|
|
* @return The controller output.
|
||
|
|
*/
|
||
|
|
virtual Output step(Input ireading) = 0;
|
||
|
|
|
||
|
|
/**
|
||
|
|
* Returns the last calculated output of the controller.
|
||
|
|
*/
|
||
|
|
virtual Output getOutput() const = 0;
|
||
|
|
|
||
|
|
/**
|
||
|
|
* Set controller output bounds.
|
||
|
|
*
|
||
|
|
* @param imax max output
|
||
|
|
* @param imin min output
|
||
|
|
*/
|
||
|
|
virtual void setOutputLimits(Output imax, Output imin) = 0;
|
||
|
|
|
||
|
|
/**
|
||
|
|
* Sets the (soft) limits for the target range that controllerSet() scales into. The target
|
||
|
|
* computed by `controllerSet()` is scaled into the range `[-itargetMin, itargetMax]`.
|
||
|
|
*
|
||
|
|
* @param itargetMax The new max target for `controllerSet()`.
|
||
|
|
* @param itargetMin The new min target for `controllerSet()`.
|
||
|
|
*/
|
||
|
|
virtual void setControllerSetTargetLimits(Output itargetMax, Output itargetMin) = 0;
|
||
|
|
|
||
|
|
/**
|
||
|
|
* Get the upper output bound.
|
||
|
|
*
|
||
|
|
* @return the upper output bound
|
||
|
|
*/
|
||
|
|
virtual Output getMaxOutput() = 0;
|
||
|
|
|
||
|
|
/**
|
||
|
|
* Get the lower output bound.
|
||
|
|
*
|
||
|
|
* @return the lower output bound
|
||
|
|
*/
|
||
|
|
virtual Output getMinOutput() = 0;
|
||
|
|
|
||
|
|
/**
|
||
|
|
* Set time between loops.
|
||
|
|
*
|
||
|
|
* @param isampleTime time between loops
|
||
|
|
*/
|
||
|
|
virtual void setSampleTime(QTime isampleTime) = 0;
|
||
|
|
|
||
|
|
/**
|
||
|
|
* Get the last set sample time.
|
||
|
|
*
|
||
|
|
* @return sample time
|
||
|
|
*/
|
||
|
|
virtual QTime getSampleTime() const = 0;
|
||
|
|
};
|
||
|
|
} // namespace okapi
|