blob: be4cf6f9a8653b009fd7473f5041f4f4b4efa430 [file] [log] [blame]
Comran Morshed5323ecb2015-12-26 20:50:55 +00001#include "frc971/control_loops/drivetrain/drivetrain.h"
Brian Silverman17f503e2015-08-02 18:17:18 -07002
Brian Silverman17f503e2015-08-02 18:17:18 -07003#include <sched.h>
James Kuszmaul61750662021-06-21 21:32:33 -07004
Brian Silverman17f503e2015-08-02 18:17:18 -07005#include <cmath>
Tyler Chatowbf0609c2021-07-31 16:13:27 -07006#include <cstdio>
Brian Silverman17f503e2015-08-02 18:17:18 -07007#include <memory>
Brian Silverman17f503e2015-08-02 18:17:18 -07008
James Kuszmaul61750662021-06-21 21:32:33 -07009#include "Eigen/Dense"
Philipp Schrader790cb542023-07-05 21:06:52 -070010
John Park33858a32018-09-28 23:05:48 -070011#include "aos/logging/logging.h"
Austin Schuh3a378462019-01-04 21:48:04 -080012#include "frc971/control_loops/drivetrain/drivetrain_config.h"
Alex Perrycb7da4b2019-08-28 19:35:56 -070013#include "frc971/control_loops/drivetrain/drivetrain_goal_generated.h"
14#include "frc971/control_loops/drivetrain/drivetrain_output_generated.h"
15#include "frc971/control_loops/drivetrain/drivetrain_position_generated.h"
16#include "frc971/control_loops/drivetrain/drivetrain_status_generated.h"
Comran Morshed5323ecb2015-12-26 20:50:55 +000017#include "frc971/control_loops/drivetrain/polydrivetrain.h"
18#include "frc971/control_loops/drivetrain/ssdrivetrain.h"
Austin Schuh3a378462019-01-04 21:48:04 -080019#include "frc971/control_loops/runge_kutta.h"
Alex Perrycb7da4b2019-08-28 19:35:56 -070020#include "frc971/queues/gyro_generated.h"
Brian Silverman17f503e2015-08-02 18:17:18 -070021#include "frc971/shifter_hall_effect.h"
Austin Schuhac17fba2020-03-28 15:55:33 -070022#include "frc971/wpilib/imu_batch_generated.h"
Brian Silverman17f503e2015-08-02 18:17:18 -070023
Austin Schuh9993fb32017-03-15 20:17:46 -070024using ::aos::monotonic_clock;
25namespace chrono = ::std::chrono;
Brian Silverman17f503e2015-08-02 18:17:18 -070026
Comran Morshed5323ecb2015-12-26 20:50:55 +000027namespace frc971 {
Brian Silverman17f503e2015-08-02 18:17:18 -070028namespace control_loops {
Austin Schuh6197a182015-11-28 16:04:40 -080029namespace drivetrain {
Brian Silverman17f503e2015-08-02 18:17:18 -070030
James Kuszmaulc53de4a2022-03-12 21:32:06 -080031namespace {
32// Maximum variation to allow in the gyro when zeroing.
Austin Schuh8c76a9b2022-03-16 21:33:48 -070033constexpr double kMaxYawGyroZeroingRange = 0.08;
34} // namespace
James Kuszmaulc53de4a2022-03-12 21:32:06 -080035
Austin Schuhfb0f35c2021-02-14 21:25:29 -080036DrivetrainFilters::DrivetrainFilters(const DrivetrainConfig<double> &dt_config,
37 ::aos::EventLoop *event_loop,
38 LocalizerInterface *localizer)
39 : dt_config_(dt_config),
Alex Perrycb7da4b2019-08-28 19:35:56 -070040 localizer_control_fetcher_(
41 event_loop->MakeFetcher<LocalizerControl>("/drivetrain")),
Austin Schuh73b6e3b2019-05-27 16:37:15 -070042 imu_values_fetcher_(
James Kuszmaule5f67dd2022-02-12 20:08:29 -080043 event_loop->TryMakeFetcher<::frc971::IMUValuesBatch>("/drivetrain")),
Austin Schuh1ea89bb2019-05-27 16:59:59 -070044 gyro_reading_fetcher_(
45 event_loop->MakeFetcher<::frc971::sensors::GyroReading>(
Alex Perrycb7da4b2019-08-28 19:35:56 -070046 "/drivetrain")),
Austin Schuhfb0f35c2021-02-14 21:25:29 -080047 down_estimator_(dt_config_),
James Kuszmaul3431d622019-02-17 17:07:44 -080048 localizer_(localizer),
Austin Schuh41565602016-02-28 20:10:49 -080049 kf_(dt_config_.make_kf_drivetrain_loop()),
Austin Schuh093535c2016-03-05 23:21:00 -080050 left_gear_(dt_config_.default_high_gear ? Gear::HIGH : Gear::LOW),
51 right_gear_(dt_config_.default_high_gear ? Gear::HIGH : Gear::LOW),
52 left_high_requested_(dt_config_.default_high_gear),
53 right_high_requested_(dt_config_.default_high_gear) {
Austin Schuhfb0f35c2021-02-14 21:25:29 -080054 last_voltage_.setZero();
55 last_last_voltage_.setZero();
James Kuszmaul61750662021-06-21 21:32:33 -070056 frc971::controls::HPolytope<0>::Init();
James Kuszmaul30aca502020-01-19 15:05:33 -080057 event_loop->OnRun([this]() {
58 // On the first fetch, make sure that we are caught all the way up to the
59 // present.
James Kuszmaule5f67dd2022-02-12 20:08:29 -080060 if (imu_values_fetcher_.valid()) {
61 imu_values_fetcher_.Fetch();
62 }
James Kuszmaul30aca502020-01-19 15:05:33 -080063 });
James Kuszmaul2215d922020-02-11 17:17:26 -080064 if (dt_config.is_simulated) {
65 down_estimator_.assume_perfect_gravity();
66 }
Austin Schuh209f1702015-11-29 17:03:00 -080067}
68
Austin Schuhfb0f35c2021-02-14 21:25:29 -080069flatbuffers::Offset<LocalizerState> DrivetrainFilters::PopulateLocalizerState(
70 flatbuffers::FlatBufferBuilder *fbb) {
71 return localizer_->PopulateStatus(fbb);
72}
73flatbuffers::Offset<ImuZeroerState> DrivetrainFilters::PopulateImuZeroerState(
74 flatbuffers::FlatBufferBuilder *fbb) {
75 return imu_zeroer_.PopulateStatus(fbb);
Austin Schuh093535c2016-03-05 23:21:00 -080076}
77
Austin Schuhfb0f35c2021-02-14 21:25:29 -080078flatbuffers::Offset<DownEstimatorState>
79DrivetrainFilters::PopulateDownEstimatorState(
80 flatbuffers::FlatBufferBuilder *fbb,
81 aos::monotonic_clock::time_point monotonic_now) {
82 return down_estimator_.PopulateStatus(fbb, monotonic_now);
Austin Schuh093535c2016-03-05 23:21:00 -080083}
84
Austin Schuhfb0f35c2021-02-14 21:25:29 -080085void DrivetrainFilters::Reset(aos::monotonic_clock::time_point monotonic_now,
86 const drivetrain::Position *position) {
87 // If all the sensors got reset (e.g., due to wpilib_interface restarting),
88 // reset the localizer and down estimator to avoid weird jumps in the
89 // filters.
90 down_estimator_.Reset();
91 // Just reset the localizer to the current state, except for the encoders.
92 LocalizerInterface::Ekf::State X_hat = localizer_->Xhat();
93 X_hat(LocalizerInterface::StateIdx::kLeftEncoder) = position->left_encoder();
94 X_hat(LocalizerInterface::StateIdx::kRightEncoder) =
95 position->right_encoder();
96 localizer_->Reset(monotonic_now, X_hat);
97}
Austin Schuh9993fb32017-03-15 20:17:46 -070098
Austin Schuhfb0f35c2021-02-14 21:25:29 -080099void DrivetrainFilters::Correct(aos::monotonic_clock::time_point monotonic_now,
100 const drivetrain::Position *position) {
Austin Schuh093535c2016-03-05 23:21:00 -0800101 // TODO(austin): Put gear detection logic here.
102 switch (dt_config_.shifter_type) {
103 case ShifterType::SIMPLE_SHIFTER:
104 // Force the right controller for simple shifters since we assume that
105 // gear switching is instantaneous.
106 if (left_high_requested_) {
107 left_gear_ = Gear::HIGH;
108 } else {
109 left_gear_ = Gear::LOW;
110 }
111 if (right_high_requested_) {
112 right_gear_ = Gear::HIGH;
113 } else {
114 right_gear_ = Gear::LOW;
115 }
116 break;
117 case ShifterType::HALL_EFFECT_SHIFTER:
Alex Perrycb7da4b2019-08-28 19:35:56 -0700118 left_gear_ = ComputeGear(position->left_shifter_position(),
Austin Schuh093535c2016-03-05 23:21:00 -0800119 dt_config_.left_drive, left_high_requested_);
Alex Perrycb7da4b2019-08-28 19:35:56 -0700120 right_gear_ = ComputeGear(position->right_shifter_position(),
Austin Schuh093535c2016-03-05 23:21:00 -0800121 dt_config_.right_drive, right_high_requested_);
122 break;
Adam Snaider18f44172016-10-22 15:30:21 -0700123 case ShifterType::NO_SHIFTER:
124 break;
Brian Silverman17f503e2015-08-02 18:17:18 -0700125 }
Brian Silverman17f503e2015-08-02 18:17:18 -0700126
James Kuszmaule5f67dd2022-02-12 20:08:29 -0800127 while (imu_values_fetcher_.valid() && imu_values_fetcher_.FetchNext()) {
Austin Schuhac17fba2020-03-28 15:55:33 -0700128 CHECK(imu_values_fetcher_->has_readings());
James Kuszmaul3e1bb272020-01-17 18:38:19 -0800129 last_gyro_time_ = monotonic_now;
Austin Schuhac17fba2020-03-28 15:55:33 -0700130 for (const IMUValues *value : *imu_values_fetcher_->readings()) {
131 imu_zeroer_.InsertMeasurement(*value);
132 if (!imu_zeroer_.Zeroed()) {
133 continue;
134 }
135 const aos::monotonic_clock::time_point reading_time(
136 std::chrono::nanoseconds(value->monotonic_timestamp_ns()));
137 if (last_imu_update_ == aos::monotonic_clock::min_time) {
138 last_imu_update_ = reading_time;
139 }
James Kuszmaul6d6e1302022-03-12 15:22:48 -0800140 down_estimator_.Predict(imu_zeroer_.ZeroedGyro().value(),
141 imu_zeroer_.ZeroedAccel().value(),
Austin Schuhac17fba2020-03-28 15:55:33 -0700142 reading_time - last_imu_update_);
James Kuszmaul3e1bb272020-01-17 18:38:19 -0800143 last_imu_update_ = reading_time;
144 }
James Kuszmaul3e1bb272020-01-17 18:38:19 -0800145 }
Diana Burgessd0180f12018-03-21 21:24:17 -0700146
James Kuszmaul3e1bb272020-01-17 18:38:19 -0800147 bool got_imu_reading = false;
James Kuszmaule5f67dd2022-02-12 20:08:29 -0800148 if (imu_values_fetcher_.valid() && imu_values_fetcher_.get() != nullptr) {
James Kuszmaulb7f45bb2020-02-26 20:27:48 -0800149 imu_zeroer_.ProcessMeasurements();
James Kuszmaul3e1bb272020-01-17 18:38:19 -0800150 got_imu_reading = true;
Austin Schuhac17fba2020-03-28 15:55:33 -0700151 CHECK(imu_values_fetcher_->has_readings());
James Kuszmaul0a981402021-10-09 21:00:34 -0700152 if (imu_values_fetcher_->readings()->size() > 0) {
153 const IMUValues *value = imu_values_fetcher_->readings()->Get(
154 imu_values_fetcher_->readings()->size() - 1);
155 switch (dt_config_.imu_type) {
156 case IMUType::IMU_X:
157 last_accel_ = -value->accelerometer_x();
158 break;
159 case IMUType::IMU_FLIPPED_X:
160 last_accel_ = value->accelerometer_x();
161 break;
162 case IMUType::IMU_Y:
163 last_accel_ = -value->accelerometer_y();
164 break;
165 case IMUType::IMU_Z:
166 last_accel_ = value->accelerometer_z();
167 break;
168 }
Diana Burgessd0180f12018-03-21 21:24:17 -0700169 }
Austin Schuh05c5a612016-04-02 15:10:25 -0700170 }
Austin Schuh05c5a612016-04-02 15:10:25 -0700171
Austin Schuh093535c2016-03-05 23:21:00 -0800172 // TODO(austin): Signal the current gear to both loops.
James Kuszmaul6d6e1302022-03-12 15:22:48 -0800173 bool imu_zeroer_zeroed = imu_zeroer_.Zeroed();
Austin Schuh093535c2016-03-05 23:21:00 -0800174
Campbell Crowley2527ed22017-02-17 21:10:02 -0800175 switch (dt_config_.gyro_type) {
176 case GyroType::IMU_X_GYRO:
James Kuszmaul3e1bb272020-01-17 18:38:19 -0800177 if (got_imu_reading) {
James Kuszmaul6d6e1302022-03-12 15:22:48 -0800178 last_gyro_rate_ =
179 imu_zeroer_zeroed ? imu_zeroer_.ZeroedGyro().value().x() : 0.0;
Campbell Crowley2527ed22017-02-17 21:10:02 -0800180 }
181 break;
182 case GyroType::IMU_Y_GYRO:
James Kuszmaul3e1bb272020-01-17 18:38:19 -0800183 if (got_imu_reading) {
James Kuszmaul6d6e1302022-03-12 15:22:48 -0800184 last_gyro_rate_ =
185 imu_zeroer_zeroed ? imu_zeroer_.ZeroedGyro().value().y() : 0.0;
Campbell Crowley2527ed22017-02-17 21:10:02 -0800186 }
187 break;
188 case GyroType::IMU_Z_GYRO:
James Kuszmaul3e1bb272020-01-17 18:38:19 -0800189 if (got_imu_reading) {
James Kuszmaul6d6e1302022-03-12 15:22:48 -0800190 last_gyro_rate_ =
191 imu_zeroer_zeroed ? imu_zeroer_.ZeroedGyro().value().z() : 0.0;
Campbell Crowley2527ed22017-02-17 21:10:02 -0800192 }
193 break;
Austin Schuh90b43b42019-01-04 07:45:05 +1100194 case GyroType::FLIPPED_IMU_Z_GYRO:
James Kuszmaul3e1bb272020-01-17 18:38:19 -0800195 if (got_imu_reading) {
James Kuszmaul6d6e1302022-03-12 15:22:48 -0800196 last_gyro_rate_ =
197 imu_zeroer_zeroed ? -imu_zeroer_.ZeroedGyro().value().z() : 0.0;
Austin Schuh90b43b42019-01-04 07:45:05 +1100198 }
199 break;
Campbell Crowley2527ed22017-02-17 21:10:02 -0800200 case GyroType::SPARTAN_GYRO:
Austin Schuh1ea89bb2019-05-27 16:59:59 -0700201 if (gyro_reading_fetcher_.Fetch()) {
Alex Perrycb7da4b2019-08-28 19:35:56 -0700202 last_gyro_rate_ = gyro_reading_fetcher_->velocity();
Austin Schuh9993fb32017-03-15 20:17:46 -0700203 last_gyro_time_ = monotonic_now;
Campbell Crowley2527ed22017-02-17 21:10:02 -0800204 }
205 break;
206 case GyroType::FLIPPED_SPARTAN_GYRO:
Austin Schuh1ea89bb2019-05-27 16:59:59 -0700207 if (gyro_reading_fetcher_.Fetch()) {
Alex Perrycb7da4b2019-08-28 19:35:56 -0700208 last_gyro_rate_ = -gyro_reading_fetcher_->velocity();
Austin Schuh9993fb32017-03-15 20:17:46 -0700209 last_gyro_time_ = monotonic_now;
Campbell Crowley2527ed22017-02-17 21:10:02 -0800210 }
211 break;
212 default:
Austin Schuhf257f3c2019-10-27 21:00:43 -0700213 AOS_LOG(FATAL, "invalid gyro configured");
Campbell Crowley2527ed22017-02-17 21:10:02 -0800214 break;
Austin Schuh9ab4d9d2016-02-16 23:55:44 -0800215 }
216
James Kuszmaulc53de4a2022-03-12 21:32:06 -0800217 switch (dt_config_.gyro_type) {
218 case GyroType::SPARTAN_GYRO:
219 case GyroType::FLIPPED_SPARTAN_GYRO:
220 if (!yaw_gyro_zero_.has_value()) {
221 yaw_gyro_zeroer_.AddData(last_gyro_rate_);
Philipp Schrader790cb542023-07-05 21:06:52 -0700222 if (yaw_gyro_zeroer_.full() &&
223 yaw_gyro_zeroer_.GetRange() < kMaxYawGyroZeroingRange) {
James Kuszmaulc53de4a2022-03-12 21:32:06 -0800224 yaw_gyro_zero_ = yaw_gyro_zeroer_.GetAverage()(0);
Austin Schuh8c76a9b2022-03-16 21:33:48 -0700225 VLOG(1) << "Zeroed to " << *yaw_gyro_zero_ << " Range "
226 << yaw_gyro_zeroer_.GetRange();
James Kuszmaulc53de4a2022-03-12 21:32:06 -0800227 }
228 }
229 ready_ = yaw_gyro_zero_.has_value();
230 if (ready_) {
231 last_gyro_rate_ = last_gyro_rate_ - yaw_gyro_zero_.value();
232 }
233 break;
234 case GyroType::IMU_X_GYRO:
235 case GyroType::IMU_Y_GYRO:
236 case GyroType::IMU_Z_GYRO:
237 case GyroType::FLIPPED_IMU_Z_GYRO:
238 ready_ = imu_zeroer_.Zeroed();
239 break;
240 }
James Kuszmaulddc69702021-03-24 21:55:03 -0700241
242 // TODO(james): How aggressively can we fault here? If we fault to
243 // aggressively, we might have issues during startup if wpilib_interface takes
244 // too long to start publishing IMU measurements.
Austin Schuh9993fb32017-03-15 20:17:46 -0700245 if (monotonic_now > last_gyro_time_ + chrono::milliseconds(20)) {
246 last_gyro_rate_ = 0.0;
247 }
248
James Kuszmaul1798c072022-02-13 15:32:11 -0800249 if (imu_values_fetcher_.valid()) {
250 localizer_->Update(
251 {last_last_voltage_(kLeftVoltage), last_last_voltage_(kRightVoltage)},
252 monotonic_now, position->left_encoder(), position->right_encoder(),
253 down_estimator_.avg_recent_yaw_rates(),
254 down_estimator_.avg_recent_accel());
255 } else {
256 localizer_->Update(
257 {last_last_voltage_(kLeftVoltage), last_last_voltage_(kRightVoltage)},
258 monotonic_now, position->left_encoder(), position->right_encoder(),
259 last_gyro_rate_, Eigen::Vector3d::Zero());
260 }
Austin Schuhfb0f35c2021-02-14 21:25:29 -0800261
262 // If we get a new message setting the absolute position, then reset the
263 // localizer.
264 if (localizer_control_fetcher_.Fetch()) {
265 VLOG(1) << "localizer_control "
266 << aos::FlatbufferToJson(localizer_control_fetcher_.get());
267 localizer_->ResetPosition(
268 monotonic_now, localizer_control_fetcher_->x(),
269 localizer_control_fetcher_->y(), localizer_control_fetcher_->theta(),
270 localizer_control_fetcher_->theta_uncertainty(),
271 !localizer_control_fetcher_->keep_current_theta());
272 }
273
274 kf_.set_index(ControllerIndexFromGears());
275
Austin Schuh6613a072016-01-06 19:54:48 -0800276 {
Diana Burgessd0180f12018-03-21 21:24:17 -0700277 Eigen::Matrix<double, 4, 1> Y;
Alex Perrycb7da4b2019-08-28 19:35:56 -0700278 Y << position->left_encoder(), position->right_encoder(), last_gyro_rate_,
Diana Burgessd0180f12018-03-21 21:24:17 -0700279 last_accel_;
Austin Schuh6613a072016-01-06 19:54:48 -0800280 kf_.Correct(Y);
Austin Schuhfb0f35c2021-02-14 21:25:29 -0800281 }
282}
283
284Eigen::Matrix<double, 2, 1> DrivetrainFilters::VoltageError() const {
285 static_assert(kLeftError + 1 == kRightError);
286 Eigen::Matrix<double, 2, 2> error_K;
287 error_K << kf_.controller().K(kLeftVoltage, kLeftError), 0.0, 0.0,
288 kf_.controller().K(kRightVoltage, kRightError);
289 const Eigen::Matrix<double, 2, 1> voltage_error =
290 error_K * kf_.X_hat().block<2, 1>(kLeftError, 0);
291 return voltage_error;
292}
293
294void DrivetrainFilters::UpdateObserver(Eigen::Matrix<double, 2, 1> U) {
295 last_last_voltage_ = last_voltage_;
296
297 kf_.UpdateObserver(last_voltage_, dt_config_.dt);
298
299 last_voltage_ = U;
300}
301
302int DrivetrainFilters::ControllerIndexFromGears() const {
303 if (MaybeHigh(left_gear_)) {
304 if (MaybeHigh(right_gear_)) {
305 return 3;
306 } else {
307 return 2;
308 }
309 } else {
310 if (MaybeHigh(right_gear_)) {
311 return 1;
312 } else {
313 return 0;
James Kuszmaul891f4f12020-10-31 17:13:23 -0700314 }
Austin Schuh6613a072016-01-06 19:54:48 -0800315 }
Austin Schuhfb0f35c2021-02-14 21:25:29 -0800316}
317flatbuffers::Offset<GearLogging> DrivetrainFilters::CreateGearLogging(
318 flatbuffers::FlatBufferBuilder *fbb) const {
319 GearLogging::Builder gear_logging_builder(*fbb);
320 gear_logging_builder.add_left_state(static_cast<uint32_t>(left_gear_));
321 gear_logging_builder.add_right_state(static_cast<uint32_t>(right_gear_));
322 gear_logging_builder.add_left_loop_high(MaybeHigh(left_gear_));
323 gear_logging_builder.add_right_loop_high(MaybeHigh(right_gear_));
324 gear_logging_builder.add_controller_index(ControllerIndexFromGears());
325 return gear_logging_builder.Finish();
326}
Austin Schuh6613a072016-01-06 19:54:48 -0800327
Austin Schuhfb0f35c2021-02-14 21:25:29 -0800328Gear DrivetrainFilters::ComputeGear(
329 double shifter_position, const constants::ShifterHallEffect &shifter_config,
330 bool high_requested) const {
331 if (shifter_position < shifter_config.clear_low) {
332 return Gear::LOW;
333 } else if (shifter_position > shifter_config.clear_high) {
334 return Gear::HIGH;
335 } else {
336 if (high_requested) {
337 return Gear::SHIFTING_UP;
338 } else {
339 return Gear::SHIFTING_DOWN;
340 }
341 }
342}
343
344DrivetrainLoop::DrivetrainLoop(const DrivetrainConfig<double> &dt_config,
345 ::aos::EventLoop *event_loop,
346 LocalizerInterface *localizer,
347 const ::std::string &name)
James Kuszmaul61750662021-06-21 21:32:33 -0700348 : frc971::controls::ControlLoop<Goal, Position, Status, Output>(event_loop,
349 name),
Austin Schuhfb0f35c2021-02-14 21:25:29 -0800350 dt_config_(dt_config),
351 filters_(dt_config, event_loop, localizer),
352 dt_openloop_(dt_config_, filters_.kf()),
353 dt_closedloop_(dt_config_, filters_.kf(), localizer),
354 dt_spline_(dt_config_),
355 dt_line_follow_(dt_config_, localizer->target_selector()) {
356 event_loop->SetRuntimeRealtimePriority(30);
James Kuszmaul75a18c52021-03-10 22:02:07 -0800357 for (size_t ii = 0; ii < trajectory_fetchers_.size(); ++ii) {
358 trajectory_fetchers_[ii].fetcher =
359 event_loop->MakeFetcher<fb::Trajectory>("/drivetrain");
360 }
361}
362
363void DrivetrainLoop::UpdateTrajectoryFetchers() {
James Kuszmaul99af8b52021-03-28 10:50:15 -0700364 if (dt_spline_.trajectory_count() >= trajectory_fetchers_.size()) {
365 aos::monotonic_clock::time_point min_time = aos::monotonic_clock::max_time;
366 size_t min_fetcher_index = 0;
367 size_t fetcher_index = 0;
368 // Find the oldest spline to forget.
369 for (auto &fetcher : trajectory_fetchers_) {
370 CHECK_NE(fetcher.fetcher.context().monotonic_event_time,
371 monotonic_clock::min_time);
372 if (fetcher.fetcher.context().monotonic_event_time < min_time &&
373 !dt_spline_.IsCurrentTrajectory(fetcher.fetcher.get())) {
374 min_time = fetcher.fetcher.context().monotonic_event_time;
375 min_fetcher_index = fetcher_index;
376 }
377 ++fetcher_index;
378 }
379
380 dt_spline_.DeleteTrajectory(
381 trajectory_fetchers_[min_fetcher_index].fetcher.get());
382 trajectory_fetchers_[min_fetcher_index].in_use = false;
383 }
384
James Kuszmaul75a18c52021-03-10 22:02:07 -0800385 for (auto &fetcher : trajectory_fetchers_) {
386 const fb::Trajectory *trajectory = fetcher.fetcher.get();
387 // If the current fetcher is already being used by the SplineDrivetrain,
388 // don't touch it.
389 // We have to check both in_use and HasTrajectory because if
390 // in_use is true and HasTrajectory() is false, that implies that the
391 // SplineDrivetrain has finished executing the trajectory and disposed of
392 // it; if in_use is false and HasTrajectory() is true, that implies that
393 // this fetcher is at the same point in the queue as another fetcher, and
394 // that the other fetcher is the one that we are using to keep the message
395 // pinned.
396 // TODO(james): Consider garbage-collecting splines once we run out of
397 // fetchers.
398 if (fetcher.in_use && dt_spline_.HasTrajectory(trajectory)) {
399 continue;
400 }
401 fetcher.in_use = false;
402 // Go through and find the next Trajectory that isn't already held by the
403 // SplineDrivetrain, and add it.
404 while (fetcher.fetcher.FetchNext()) {
405 trajectory = fetcher.fetcher.get();
406 if (!dt_spline_.HasTrajectory(trajectory)) {
407 fetcher.in_use = true;
408 dt_spline_.AddTrajectory(trajectory);
409 break;
410 }
411 }
412 }
Austin Schuhfb0f35c2021-02-14 21:25:29 -0800413}
414
415void DrivetrainLoop::RunIteration(
416 const drivetrain::Goal *goal, const drivetrain::Position *position,
417 aos::Sender<drivetrain::Output>::Builder *output,
418 aos::Sender<drivetrain::Status>::Builder *status) {
419 const monotonic_clock::time_point monotonic_now =
420 event_loop()->monotonic_now();
421
422 if (!has_been_enabled_ && output) {
423 has_been_enabled_ = true;
424 }
425
426 if (WasReset()) {
427 filters_.Reset(monotonic_now, position);
428 }
429
James Kuszmaul75a18c52021-03-10 22:02:07 -0800430 UpdateTrajectoryFetchers();
431
Austin Schuhfb0f35c2021-02-14 21:25:29 -0800432 filters_.Correct(monotonic_now, position);
433
434 // Set the gear-logging parts of the status
435 CHECK(status);
436 flatbuffers::Offset<GearLogging> gear_logging_offset =
437 filters_.CreateGearLogging(status->fbb());
438
439 dt_openloop_.SetPosition(position, filters_.left_gear(),
440 filters_.right_gear());
Austin Schuh093535c2016-03-05 23:21:00 -0800441
Austin Schuh872723c2019-12-25 14:38:09 -0800442 ControllerType controller_type = ControllerType::POLYDRIVE;
Brian Silverman17f503e2015-08-02 18:17:18 -0700443 if (goal) {
Alex Perrycb7da4b2019-08-28 19:35:56 -0700444 controller_type = goal->controller_type();
Brian Silverman17f503e2015-08-02 18:17:18 -0700445
Alex Perrycb7da4b2019-08-28 19:35:56 -0700446 dt_closedloop_.SetGoal(goal);
447 dt_openloop_.SetGoal(goal->wheel(), goal->throttle(), goal->quickturn(),
448 goal->highgear());
449 dt_spline_.SetGoal(goal);
450 dt_line_follow_.SetGoal(monotonic_now, goal);
Brian Silverman17f503e2015-08-02 18:17:18 -0700451 }
452
Alex Perrycb7da4b2019-08-28 19:35:56 -0700453 dt_openloop_.Update(robot_state().voltage_battery());
Brian Silverman17f503e2015-08-02 18:17:18 -0700454
Alex Perrycb7da4b2019-08-28 19:35:56 -0700455 dt_closedloop_.Update(output != nullptr &&
Austin Schuh872723c2019-12-25 14:38:09 -0800456 controller_type == ControllerType::MOTION_PROFILE);
Austin Schuh78379ea2019-01-04 20:39:45 -0800457
James Kuszmaule39cbcf2019-02-27 20:48:34 -0800458 const Eigen::Matrix<double, 5, 1> trajectory_state =
Austin Schuhfb0f35c2021-02-14 21:25:29 -0800459 filters_.trajectory_state();
James Kuszmaule39cbcf2019-02-27 20:48:34 -0800460
James Kuszmaul897ef1a2020-10-25 17:51:10 -0700461 {
462 // TODO(james): The regular Kalman Filter's voltage error terms are
463 // currently unusable--either don't use voltage error at all for the spline
464 // following code, or use the EKF's voltage error estimates.
465 const Eigen::Matrix<double, 2, 1> voltage_error =
Austin Schuhfb0f35c2021-02-14 21:25:29 -0800466 0 * filters_.VoltageError();
James Kuszmaul897ef1a2020-10-25 17:51:10 -0700467 dt_spline_.Update(
468 output != nullptr && controller_type == ControllerType::SPLINE_FOLLOWER,
469 trajectory_state, voltage_error);
470 }
James Kuszmaule39cbcf2019-02-27 20:48:34 -0800471
James Kuszmaul38e79642019-03-09 15:48:27 -0800472 dt_line_follow_.Update(monotonic_now, trajectory_state);
Alex Perrya71badb2019-02-06 19:40:41 -0800473
Alex Perrycb7da4b2019-08-28 19:35:56 -0700474 OutputT output_struct;
475
Austin Schuh78379ea2019-01-04 20:39:45 -0800476 switch (controller_type) {
Austin Schuh872723c2019-12-25 14:38:09 -0800477 case ControllerType::POLYDRIVE:
Alex Perrycb7da4b2019-08-28 19:35:56 -0700478 dt_openloop_.SetOutput(output != nullptr ? &output_struct : nullptr);
Austin Schuh78379ea2019-01-04 20:39:45 -0800479 break;
Austin Schuh872723c2019-12-25 14:38:09 -0800480 case ControllerType::MOTION_PROFILE:
Alex Perrycb7da4b2019-08-28 19:35:56 -0700481 dt_closedloop_.SetOutput(output != nullptr ? &output_struct : nullptr);
Austin Schuh78379ea2019-01-04 20:39:45 -0800482 break;
Austin Schuh872723c2019-12-25 14:38:09 -0800483 case ControllerType::SPLINE_FOLLOWER:
Alex Perrycb7da4b2019-08-28 19:35:56 -0700484 dt_spline_.SetOutput(output != nullptr ? &output_struct : nullptr);
Alex Perry731b4602019-02-02 22:13:01 -0800485 break;
Austin Schuh872723c2019-12-25 14:38:09 -0800486 case ControllerType::LINE_FOLLOWER:
Alex Perrycb7da4b2019-08-28 19:35:56 -0700487 if (!dt_line_follow_.SetOutput(output != nullptr ? &output_struct
488 : nullptr)) {
James Kuszmaul5bc6fc92019-03-01 21:50:06 -0800489 // If the line follow drivetrain was unable to execute (generally due to
490 // not having a target), execute the regular teleop drivetrain.
Alex Perrycb7da4b2019-08-28 19:35:56 -0700491 dt_openloop_.SetOutput(output != nullptr ? &output_struct : nullptr);
James Kuszmaul5bc6fc92019-03-01 21:50:06 -0800492 }
James Kuszmaule39cbcf2019-02-27 20:48:34 -0800493 break;
Brian Silverman17f503e2015-08-02 18:17:18 -0700494 }
495
Austin Schuh093535c2016-03-05 23:21:00 -0800496 // The output should now contain the shift request.
497
Brian Silverman17f503e2015-08-02 18:17:18 -0700498 // set the output status of the control loop state
499 if (status) {
Austin Schuh093535c2016-03-05 23:21:00 -0800500 Eigen::Matrix<double, 2, 1> linear =
Austin Schuhfb0f35c2021-02-14 21:25:29 -0800501 dt_config_.LeftRightToLinear(filters_.DrivetrainXHat());
Austin Schuh093535c2016-03-05 23:21:00 -0800502 Eigen::Matrix<double, 2, 1> angular =
Austin Schuhfb0f35c2021-02-14 21:25:29 -0800503 dt_config_.LeftRightToAngular(filters_.DrivetrainXHat());
Austin Schuh093535c2016-03-05 23:21:00 -0800504
Austin Schuhfb0f35c2021-02-14 21:25:29 -0800505 angular(0, 0) = filters_.localizer_theta();
Austin Schuh093535c2016-03-05 23:21:00 -0800506
507 Eigen::Matrix<double, 4, 1> gyro_left_right =
Austin Schuhd91c0d22016-10-15 21:24:28 -0700508 dt_config_.AngularLinearToLeftRight(linear, angular);
Austin Schuh093535c2016-03-05 23:21:00 -0800509
Alex Perrycb7da4b2019-08-28 19:35:56 -0700510 const flatbuffers::Offset<CIMLogging> cim_logging_offset =
James Kuszmaulaf5dfad2020-01-03 20:02:54 -0800511 dt_openloop_.PopulateShiftingStatus(status->fbb());
512
513 const flatbuffers::Offset<PolyDriveLogging> poly_drive_logging_offset =
Alex Perrycb7da4b2019-08-28 19:35:56 -0700514 dt_openloop_.PopulateStatus(status->fbb());
Austin Schuh093535c2016-03-05 23:21:00 -0800515
James Kuszmaul3e1bb272020-01-17 18:38:19 -0800516 const flatbuffers::Offset<DownEstimatorState> down_estimator_state_offset =
Austin Schuhfb0f35c2021-02-14 21:25:29 -0800517 filters_.PopulateDownEstimatorState(status->fbb(), monotonic_now);
James Kuszmaul2215d922020-02-11 17:17:26 -0800518
James Kuszmaul3c5b4d32020-02-11 17:22:14 -0800519 const flatbuffers::Offset<LocalizerState> localizer_offset =
Austin Schuhfb0f35c2021-02-14 21:25:29 -0800520 filters_.PopulateLocalizerState(status->fbb());
James Kuszmaul3c5b4d32020-02-11 17:22:14 -0800521
James Kuszmaul2215d922020-02-11 17:17:26 -0800522 const flatbuffers::Offset<ImuZeroerState> zeroer_offset =
Austin Schuhfb0f35c2021-02-14 21:25:29 -0800523 filters_.PopulateImuZeroerState(status->fbb());
James Kuszmaul3e1bb272020-01-17 18:38:19 -0800524
Alex Perrycb7da4b2019-08-28 19:35:56 -0700525 flatbuffers::Offset<LineFollowLogging> line_follow_logging_offset =
526 dt_line_follow_.PopulateStatus(status);
527 flatbuffers::Offset<TrajectoryLogging> trajectory_logging_offset =
528 dt_spline_.MakeTrajectoryLogging(status);
Austin Schuh093535c2016-03-05 23:21:00 -0800529
Austin Schuhfb0f35c2021-02-14 21:25:29 -0800530 Status::Builder builder = status->MakeBuilder<Status>();
Austin Schuh3a378462019-01-04 21:48:04 -0800531
Alex Perrycb7da4b2019-08-28 19:35:56 -0700532 dt_closedloop_.PopulateStatus(&builder);
Austin Schuh3a378462019-01-04 21:48:04 -0800533
Austin Schuh95771d92021-01-23 14:42:25 -0800534 builder.add_estimated_left_position(gyro_left_right(kLeftPosition));
535 builder.add_estimated_right_position(gyro_left_right(kRightPosition));
Austin Schuh41565602016-02-28 20:10:49 -0800536
Austin Schuh95771d92021-01-23 14:42:25 -0800537 builder.add_estimated_left_velocity(gyro_left_right(kLeftVelocity));
538 builder.add_estimated_right_velocity(gyro_left_right(kRightVelocity));
Alex Perrycb7da4b2019-08-28 19:35:56 -0700539
540 if (dt_spline_.enable()) {
541 dt_spline_.PopulateStatus(&builder);
542 } else {
Austin Schuhfb0f35c2021-02-14 21:25:29 -0800543 builder.add_robot_speed((filters_.DrivetrainXHat(kLeftVelocity) +
544 filters_.DrivetrainXHat(kRightVelocity)) /
545 2.0);
Alex Perrycb7da4b2019-08-28 19:35:56 -0700546 builder.add_output_was_capped(dt_closedloop_.output_was_capped());
Austin Schuhfb0f35c2021-02-14 21:25:29 -0800547 builder.add_uncapped_left_voltage(
548 filters_.DrivetrainUUncapped(kLeftVoltage));
549 builder.add_uncapped_right_voltage(
550 filters_.DrivetrainUUncapped(kRightVoltage));
Alex Perrycb7da4b2019-08-28 19:35:56 -0700551 }
552
Austin Schuhfb0f35c2021-02-14 21:25:29 -0800553 builder.add_left_voltage_error(filters_.DrivetrainXHat(kLeftError));
554 builder.add_right_voltage_error(filters_.DrivetrainXHat(kRightError));
555 builder.add_estimated_angular_velocity_error(
556 filters_.DrivetrainXHat(kAngularError));
557 builder.add_estimated_heading(filters_.localizer_theta());
Alex Perrycb7da4b2019-08-28 19:35:56 -0700558
Austin Schuhfb0f35c2021-02-14 21:25:29 -0800559 builder.add_x(filters_.x());
560 builder.add_y(filters_.y());
561 builder.add_theta(::aos::math::NormalizeAngle(filters_.localizer_theta()));
Alex Perrycb7da4b2019-08-28 19:35:56 -0700562
Alex Perrycb7da4b2019-08-28 19:35:56 -0700563 builder.add_cim_logging(cim_logging_offset);
James Kuszmaulaf5dfad2020-01-03 20:02:54 -0800564 builder.add_poly_drive_logging(poly_drive_logging_offset);
Alex Perrycb7da4b2019-08-28 19:35:56 -0700565 builder.add_gear_logging(gear_logging_offset);
566 builder.add_line_follow_logging(line_follow_logging_offset);
567 builder.add_trajectory_logging(trajectory_logging_offset);
James Kuszmaul3e1bb272020-01-17 18:38:19 -0800568 builder.add_down_estimator(down_estimator_state_offset);
James Kuszmaul3c5b4d32020-02-11 17:22:14 -0800569 builder.add_localizer(localizer_offset);
James Kuszmaul2215d922020-02-11 17:17:26 -0800570 builder.add_zeroing(zeroer_offset);
milind1f1dca32021-07-03 13:50:07 -0700571
572 builder.add_send_failures(status_failure_counter_.failures());
573
574 status_failure_counter_.Count(status->Send(builder.Finish()));
Brian Silverman17f503e2015-08-02 18:17:18 -0700575 }
Austin Schuh209f1702015-11-29 17:03:00 -0800576
James Kuszmaulddc69702021-03-24 21:55:03 -0700577 // If the filters aren't ready/valid, then disable all outputs (currently,
578 // this only happens if the IMU is faulted or has not zeroed).
579 // TODO(james): Add exceptions so that during competitive play the driver
580 // can retain minimal control of the robot.
581 if (!filters_.Ready()) {
582 output_struct.left_voltage = 0.0;
583 output_struct.right_voltage = 0.0;
584 }
585
Austin Schuh209f1702015-11-29 17:03:00 -0800586 double left_voltage = 0.0;
587 double right_voltage = 0.0;
588 if (output) {
Alex Perrycb7da4b2019-08-28 19:35:56 -0700589 left_voltage = output_struct.left_voltage;
590 right_voltage = output_struct.right_voltage;
Austin Schuhfb0f35c2021-02-14 21:25:29 -0800591 filters_.set_left_high_requested(output_struct.left_high);
592 filters_.set_right_high_requested(output_struct.right_high);
Austin Schuh209f1702015-11-29 17:03:00 -0800593 }
594
Alex Perrycb7da4b2019-08-28 19:35:56 -0700595 const double scalar = robot_state().voltage_battery() / 12.0;
Austin Schuh209f1702015-11-29 17:03:00 -0800596
597 left_voltage *= scalar;
598 right_voltage *= scalar;
599
Austin Schuh209f1702015-11-29 17:03:00 -0800600 // To validate, look at the following:
601
602 // Observed - dx/dt velocity for left, right.
603
604 // Angular velocity error compared to the gyro
605 // Gyro heading vs left-right
606 // Voltage error.
607
Austin Schuhfb0f35c2021-02-14 21:25:29 -0800608 {
609 Eigen::Matrix<double, 2, 1> U;
610 U(kLeftVoltage) = left_voltage;
611 U(kRightVoltage) = right_voltage;
612 filters_.UpdateObserver(U);
613 }
Alex Perrycb7da4b2019-08-28 19:35:56 -0700614
615 if (output) {
milind1f1dca32021-07-03 13:50:07 -0700616 output->CheckOk(output->Send(Output::Pack(*output->fbb(), &output_struct)));
Alex Perrycb7da4b2019-08-28 19:35:56 -0700617 }
Brian Silverman17f503e2015-08-02 18:17:18 -0700618}
619
Alex Perrycb7da4b2019-08-28 19:35:56 -0700620flatbuffers::Offset<Output> DrivetrainLoop::Zero(
621 aos::Sender<Output>::Builder *output) {
622 Output::Builder builder = output->MakeBuilder<Output>();
623 builder.add_left_voltage(0);
624 builder.add_right_voltage(0);
625 builder.add_left_high(dt_config_.default_high_gear);
626 builder.add_right_high(dt_config_.default_high_gear);
627 return builder.Finish();
Adam Snaiderbc918b62016-02-27 21:03:39 -0800628}
629
Austin Schuh6197a182015-11-28 16:04:40 -0800630} // namespace drivetrain
Brian Silverman17f503e2015-08-02 18:17:18 -0700631} // namespace control_loops
Comran Morshed5323ecb2015-12-26 20:50:55 +0000632} // namespace frc971