@@ -60,10 +60,26 @@ pid_controller:
60
60
default_value : 0.0,
61
61
description : " Derivative gain for PID"
62
62
}
63
+ saturation : {
64
+ type : bool,
65
+ default_value : false,
66
+ description : " Enables output saturation. When true, the controller output is
67
+ clamped between u_clamp_max and u_clamp_min."
68
+ }
69
+ u_clamp_max : {
70
+ type : double,
71
+ default_value : 0.0,
72
+ description : " Upper output clamp."
73
+ }
74
+ u_clamp_min : {
75
+ type : double,
76
+ default_value : 0.0,
77
+ description : " Lower output clamp."
78
+ }
63
79
antiwindup : {
64
80
type : bool,
65
81
default_value : false,
66
- description : " Antiwindup functionality. When set to true, limits
82
+ description : " Anti-windup functionality. When set to true, limits
67
83
the integral error to prevent windup; otherwise, constrains the
68
84
integral contribution to the control output. i_clamp_max and
69
85
i_clamp_min are applied in both scenarios."
@@ -78,6 +94,30 @@ pid_controller:
78
94
default_value : 0.0,
79
95
description : " Lower integral clamp."
80
96
}
97
+ antiwindup_strategy : {
98
+ type : string,
99
+ default_value : " none" ,
100
+ description : " Specifies the anti-windup strategy. Options: 'back_calculation',
101
+ 'conditioning_technique', 'conditional_integration', or 'none'. Note that the
102
+ 'back_calculation' and 'conditioning_technique' strategies use the tracking_time_constant
103
+ parameter to tune the anti-windup behavior. When a strategy other than 'none' is selected,
104
+ it will override the controller's default anti-windup behavior." ,
105
+ validation : {
106
+ subset_of<> : [[
107
+ " back_calculation" ,
108
+ " conditioning_technique" ,
109
+ " conditional_integration" ,
110
+ " none"
111
+ ]]
112
+ }
113
+ }
114
+ tracking_time_constant : {
115
+ type : double,
116
+ default_value : 0.0,
117
+ description : " Specifies the tracking time constant for the 'back_calculation'
118
+ and 'conditioning_technique' strategies. If set to 0.0 when one of these
119
+ strategies is selected, a recommended default value will be applied."
120
+ }
81
121
feedforward_gain : {
82
122
type : double,
83
123
default_value : 0.0,
0 commit comments