YARP
Yet Another Robot Platform
 
Loading...
Searching...
No Matches
IPidControl.h
Go to the documentation of this file.
1/*
2 * SPDX-FileCopyrightText: 2006-2021 Istituto Italiano di Tecnologia (IIT)
3 * SPDX-License-Identifier: BSD-3-Clause
4 */
5
6#ifndef YARP_DEV_PIDCONTROL_H
7#define YARP_DEV_PIDCONTROL_H
8
9#include <yarp/os/Vocab.h>
10#include <yarp/dev/api.h>
12#include <yarp/dev/PidEnums.h>
14
15namespace yarp::dev {
16class IPidControlRaw;
17class IPidControl;
18}
19
20
27{
28public:
32 virtual ~IPidControlRaw() {}
33
35
41 virtual bool setPidRaw(const PidControlTypeEnum& pidtype, int j, const Pid &pid) = 0;
42
48 virtual bool setPidsRaw(const PidControlTypeEnum& pidtype, const Pid *pids) = 0;
49
60 virtual bool setPidReferenceRaw(const PidControlTypeEnum& pidtype, int j, double ref) = 0;
61
71 virtual bool setPidReferencesRaw(const PidControlTypeEnum& pidtype, const double *refs) = 0;
72
79 virtual bool setPidErrorLimitRaw(const PidControlTypeEnum& pidtype, int j, double limit) = 0;
80
86 virtual bool setPidErrorLimitsRaw(const PidControlTypeEnum& pidtype, const double *limits) = 0;
87
94 virtual bool getPidErrorRaw(const PidControlTypeEnum& pidtype, int j, double *err) = 0;
95
100 virtual bool getPidErrorsRaw(const PidControlTypeEnum& pidtype, double *errs) = 0;
101
108 virtual bool getPidOutputRaw(const PidControlTypeEnum& pidtype, int j, double *out) = 0;
109
114 virtual bool getPidOutputsRaw(const PidControlTypeEnum& pidtype, double *outs) = 0;
115
122 virtual bool getPidRaw(const PidControlTypeEnum& pidtype, int j, Pid *pid) = 0;
123
129 virtual bool getPidsRaw(const PidControlTypeEnum& pidtype, Pid *pids) = 0;
130
137 virtual bool getPidReferenceRaw(const PidControlTypeEnum& pidtype, int j, double *ref) = 0;
138
143 virtual bool getPidReferencesRaw(const PidControlTypeEnum& pidtype, double *refs) = 0;
144
151 virtual bool getPidErrorLimitRaw(const PidControlTypeEnum& pidtype, int j, double *limit) = 0;
152
158 virtual bool getPidErrorLimitsRaw(const PidControlTypeEnum& pidtype, double *limits) = 0;
159
166 virtual bool resetPidRaw(const PidControlTypeEnum& pidtype, int j) = 0;
167
173 virtual bool disablePidRaw(const PidControlTypeEnum& pidtype, int j) = 0;
174
180 virtual bool enablePidRaw(const PidControlTypeEnum& pidtype, int j) = 0;
181
188 virtual bool setPidOffsetRaw(const PidControlTypeEnum& pidtype, int j, double v) = 0;
189
196 virtual bool isPidEnabledRaw(const PidControlTypeEnum& pidtype, int j, bool* enabled) = 0;
197};
198
206{
207public:
211 virtual ~IPidControl() {}
212
214
220 virtual bool setPid(const PidControlTypeEnum& pidtype, int j, const Pid &pid) = 0;
221
227 virtual bool setPids(const PidControlTypeEnum& pidtype, const Pid *pids) = 0;
228
239 virtual bool setPidReference(const PidControlTypeEnum& pidtype, int j, double ref) = 0;
240
250 virtual bool setPidReferences(const PidControlTypeEnum& pidtype, const double *refs) = 0;
251
258 virtual bool setPidErrorLimit(const PidControlTypeEnum& pidtype, int j, double limit) = 0;
259
265 virtual bool setPidErrorLimits(const PidControlTypeEnum& pidtype, const double *limits) = 0;
266
273 virtual bool getPidError(const PidControlTypeEnum& pidtype, int j, double *err) = 0;
274
279 virtual bool getPidErrors(const PidControlTypeEnum& pidtype, double *errs) = 0;
280
287 virtual bool getPidOutput(const PidControlTypeEnum& pidtype, int j, double *out) = 0;
288
293 virtual bool getPidOutputs(const PidControlTypeEnum& pidtype, double *outs) = 0;
294
301 virtual bool getPid(const PidControlTypeEnum& pidtype, int j, Pid *pid) = 0;
302
308 virtual bool getPids(const PidControlTypeEnum& pidtype, Pid *pids) = 0;
309
316 virtual bool getPidReference(const PidControlTypeEnum& pidtype, int j, double *ref) = 0;
317
322 virtual bool getPidReferences(const PidControlTypeEnum& pidtype, double *refs) = 0;
323
330 virtual bool getPidErrorLimit(const PidControlTypeEnum& pidtype, int j, double *limit) = 0;
331
337 virtual bool getPidErrorLimits(const PidControlTypeEnum& pidtype, double *limits) = 0;
338
345 virtual bool resetPid(const PidControlTypeEnum& pidtype, int j) = 0;
346
352 virtual bool disablePid(const PidControlTypeEnum& pidtype, int j) = 0;
353
359 virtual bool enablePid(const PidControlTypeEnum& pidtype, int j) = 0;
360
367 virtual bool setPidOffset(const PidControlTypeEnum& pidtype, int j, double v) = 0;
368
375 virtual bool isPidEnabled(const PidControlTypeEnum& pidtype, int j, bool* enabled) = 0;
376};
377
378// interface IPositionControl gets
381
382
383#endif // YARP_DEV_CONTROLBOARDINTERFACES_H
define control board standard interfaces
constexpr yarp::conf::vocab32_t VOCAB_PIDS
constexpr yarp::conf::vocab32_t VOCAB_PID
Interface for a generic control board device implementing a PID controller.
Definition IPidControl.h:27
virtual bool enablePidRaw(const PidControlTypeEnum &pidtype, int j)=0
Enable the pid computation for a joint.
virtual bool setPidRaw(const PidControlTypeEnum &pidtype, int j, const Pid &pid)=0
Set new pid value for a joint axis.
virtual bool getPidOutputRaw(const PidControlTypeEnum &pidtype, int j, double *out)=0
Get the output of the controller (e.g.
virtual bool setPidReferenceRaw(const PidControlTypeEnum &pidtype, int j, double ref)=0
Set the controller reference for a given axis.
virtual bool setPidOffsetRaw(const PidControlTypeEnum &pidtype, int j, double v)=0
Set an offset value on the ourput of pid controller.
virtual bool disablePidRaw(const PidControlTypeEnum &pidtype, int j)=0
Disable the pid computation for a joint.
virtual bool getPidsRaw(const PidControlTypeEnum &pidtype, Pid *pids)=0
Get current pid value for a specific joint.
virtual bool getPidReferencesRaw(const PidControlTypeEnum &pidtype, double *refs)=0
Get the current reference of all pid controllers.
virtual bool getPidErrorsRaw(const PidControlTypeEnum &pidtype, double *errs)=0
Get the error of all joints.
virtual bool getPidRaw(const PidControlTypeEnum &pidtype, int j, Pid *pid)=0
Get current pid value for a specific joint.
virtual bool getPidOutputsRaw(const PidControlTypeEnum &pidtype, double *outs)=0
Get the output of the controllers (e.g.
virtual bool setPidErrorLimitsRaw(const PidControlTypeEnum &pidtype, const double *limits)=0
Get the error limit for the controller on all joints.
virtual bool getPidErrorRaw(const PidControlTypeEnum &pidtype, int j, double *err)=0
Get the current error for a joint.
virtual bool getPidErrorLimitRaw(const PidControlTypeEnum &pidtype, int j, double *limit)=0
Get the error limit for the controller on a specific joint.
virtual ~IPidControlRaw()
Destructor.
Definition IPidControl.h:32
virtual bool isPidEnabledRaw(const PidControlTypeEnum &pidtype, int j, bool *enabled)=0
Get the current status (enabled/disabled) of the pid controller.
virtual bool getPidReferenceRaw(const PidControlTypeEnum &pidtype, int j, double *ref)=0
Get the current reference of the pid controller for a specific joint.
virtual bool getPidErrorLimitsRaw(const PidControlTypeEnum &pidtype, double *limits)=0
Get the error limit for all controllers.
virtual bool setPidErrorLimitRaw(const PidControlTypeEnum &pidtype, int j, double limit)=0
Set the error limit for the controller on a specific joint.
virtual bool setPidsRaw(const PidControlTypeEnum &pidtype, const Pid *pids)=0
Set new pid value on multiple axes.
virtual bool setPidReferencesRaw(const PidControlTypeEnum &pidtype, const double *refs)=0
Set the controller reference, multiple axes.
virtual bool resetPidRaw(const PidControlTypeEnum &pidtype, int j)=0
Reset the controller of a given joint, usually sets the current status of the joint as the reference ...
Interface for a generic control board device implementing a PID controller, with scaled arguments.
virtual bool setPid(const PidControlTypeEnum &pidtype, int j, const Pid &pid)=0
Set new pid value for a joint axis.
virtual bool getPidReference(const PidControlTypeEnum &pidtype, int j, double *ref)=0
Get the current reference of the pid controller for a specific joint.
virtual bool getPidOutput(const PidControlTypeEnum &pidtype, int j, double *out)=0
Get the output of the controller (e.g.
virtual bool getPidReferences(const PidControlTypeEnum &pidtype, double *refs)=0
Get the current reference of all pid controllers.
virtual bool resetPid(const PidControlTypeEnum &pidtype, int j)=0
Reset the controller of a given joint, usually sets the current status of the joint as the reference ...
virtual bool setPidOffset(const PidControlTypeEnum &pidtype, int j, double v)=0
Set offset value for a given controller.
virtual bool getPidErrorLimits(const PidControlTypeEnum &pidtype, double *limits)=0
Get the error limit for all controllers.
virtual bool getPidError(const PidControlTypeEnum &pidtype, int j, double *err)=0
Get the current error for a joint.
virtual bool getPidErrorLimit(const PidControlTypeEnum &pidtype, int j, double *limit)=0
Get the error limit for the controller on a specific joint.
virtual bool setPidErrorLimit(const PidControlTypeEnum &pidtype, int j, double limit)=0
Set the error limit for the controller on a specifi joint.
virtual bool disablePid(const PidControlTypeEnum &pidtype, int j)=0
Disable the pid computation for a joint.
virtual bool setPidErrorLimits(const PidControlTypeEnum &pidtype, const double *limits)=0
Get the error limit for the controller on all joints.
virtual bool getPidOutputs(const PidControlTypeEnum &pidtype, double *outs)=0
Get the output of the controllers (e.g.
virtual bool setPidReference(const PidControlTypeEnum &pidtype, int j, double ref)=0
Set the controller reference for a given axis.
virtual bool setPidReferences(const PidControlTypeEnum &pidtype, const double *refs)=0
Set the controller reference, multiple axes.
virtual bool getPidErrors(const PidControlTypeEnum &pidtype, double *errs)=0
Get the error of all joints.
virtual ~IPidControl()
Destructor.
virtual bool setPids(const PidControlTypeEnum &pidtype, const Pid *pids)=0
Set new pid value on multiple axes.
virtual bool enablePid(const PidControlTypeEnum &pidtype, int j)=0
Enable the pid computation for a joint.
virtual bool isPidEnabled(const PidControlTypeEnum &pidtype, int j, bool *enabled)=0
Get the current status (enabled/disabled) of the pid.
virtual bool getPids(const PidControlTypeEnum &pidtype, Pid *pids)=0
Get current pid value for a specific joint.
virtual bool getPid(const PidControlTypeEnum &pidtype, int j, Pid *pid)=0
Get current pid value for a specific joint.
Contains the parameters for a PID.
std::int32_t vocab32_t
Definition numeric.h:78
For streams capable of holding different kinds of content, check what they actually have.
Definition jointData.cpp:13
PidControlTypeEnum
Definition PidEnums.h:15
constexpr yarp::conf::vocab32_t createVocab32(char a, char b=0, char c=0, char d=0)
Create a vocab from chars.
Definition Vocab.h:27
The main, catch-all namespace for YARP.
Definition dirs.h:16
#define YARP_dev_API
Definition api.h:18