blob: 15d84eaecdf82fa5fe5d182ed7d2c4cf1334ade2 [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"
John Park33858a32018-09-28 23:05:48 -070010#include "aos/logging/logging.h"
Austin Schuh3a378462019-01-04 21:48:04 -080011#include "frc971/control_loops/drivetrain/down_estimator.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_);
Austin Schuh8c76a9b2022-03-16 21:33:48 -0700222 if (yaw_gyro_zeroer_.full() && yaw_gyro_zeroer_.GetRange() < kMaxYawGyroZeroingRange) {
James Kuszmaulc53de4a2022-03-12 21:32:06 -0800223 yaw_gyro_zero_ = yaw_gyro_zeroer_.GetAverage()(0);
Austin Schuh8c76a9b2022-03-16 21:33:48 -0700224 VLOG(1) << "Zeroed to " << *yaw_gyro_zero_ << " Range "
225 << yaw_gyro_zeroer_.GetRange();
James Kuszmaulc53de4a2022-03-12 21:32:06 -0800226 }
227 }
228 ready_ = yaw_gyro_zero_.has_value();
229 if (ready_) {
230 last_gyro_rate_ = last_gyro_rate_ - yaw_gyro_zero_.value();
231 }
232 break;
233 case GyroType::IMU_X_GYRO:
234 case GyroType::IMU_Y_GYRO:
235 case GyroType::IMU_Z_GYRO:
236 case GyroType::FLIPPED_IMU_Z_GYRO:
237 ready_ = imu_zeroer_.Zeroed();
238 break;
239 }
James Kuszmaulddc69702021-03-24 21:55:03 -0700240
241 // TODO(james): How aggressively can we fault here? If we fault to
242 // aggressively, we might have issues during startup if wpilib_interface takes
243 // too long to start publishing IMU measurements.
Austin Schuh9993fb32017-03-15 20:17:46 -0700244 if (monotonic_now > last_gyro_time_ + chrono::milliseconds(20)) {
245 last_gyro_rate_ = 0.0;
246 }
247
James Kuszmaul1798c072022-02-13 15:32:11 -0800248 if (imu_values_fetcher_.valid()) {
249 localizer_->Update(
250 {last_last_voltage_(kLeftVoltage), last_last_voltage_(kRightVoltage)},
251 monotonic_now, position->left_encoder(), position->right_encoder(),
252 down_estimator_.avg_recent_yaw_rates(),
253 down_estimator_.avg_recent_accel());
254 } else {
255 localizer_->Update(
256 {last_last_voltage_(kLeftVoltage), last_last_voltage_(kRightVoltage)},
257 monotonic_now, position->left_encoder(), position->right_encoder(),
258 last_gyro_rate_, Eigen::Vector3d::Zero());
259 }
Austin Schuhfb0f35c2021-02-14 21:25:29 -0800260
261 // If we get a new message setting the absolute position, then reset the
262 // localizer.
263 if (localizer_control_fetcher_.Fetch()) {
264 VLOG(1) << "localizer_control "
265 << aos::FlatbufferToJson(localizer_control_fetcher_.get());
266 localizer_->ResetPosition(
267 monotonic_now, localizer_control_fetcher_->x(),
268 localizer_control_fetcher_->y(), localizer_control_fetcher_->theta(),
269 localizer_control_fetcher_->theta_uncertainty(),
270 !localizer_control_fetcher_->keep_current_theta());
271 }
272
273 kf_.set_index(ControllerIndexFromGears());
274
Austin Schuh6613a072016-01-06 19:54:48 -0800275 {
Diana Burgessd0180f12018-03-21 21:24:17 -0700276 Eigen::Matrix<double, 4, 1> Y;
Alex Perrycb7da4b2019-08-28 19:35:56 -0700277 Y << position->left_encoder(), position->right_encoder(), last_gyro_rate_,
Diana Burgessd0180f12018-03-21 21:24:17 -0700278 last_accel_;
Austin Schuh6613a072016-01-06 19:54:48 -0800279 kf_.Correct(Y);
Austin Schuhfb0f35c2021-02-14 21:25:29 -0800280 }
281}
282
283Eigen::Matrix<double, 2, 1> DrivetrainFilters::VoltageError() const {
284 static_assert(kLeftError + 1 == kRightError);
285 Eigen::Matrix<double, 2, 2> error_K;
286 error_K << kf_.controller().K(kLeftVoltage, kLeftError), 0.0, 0.0,
287 kf_.controller().K(kRightVoltage, kRightError);
288 const Eigen::Matrix<double, 2, 1> voltage_error =
289 error_K * kf_.X_hat().block<2, 1>(kLeftError, 0);
290 return voltage_error;
291}
292
293void DrivetrainFilters::UpdateObserver(Eigen::Matrix<double, 2, 1> U) {
294 last_last_voltage_ = last_voltage_;
295
296 kf_.UpdateObserver(last_voltage_, dt_config_.dt);
297
298 last_voltage_ = U;
299}
300
301int DrivetrainFilters::ControllerIndexFromGears() const {
302 if (MaybeHigh(left_gear_)) {
303 if (MaybeHigh(right_gear_)) {
304 return 3;
305 } else {
306 return 2;
307 }
308 } else {
309 if (MaybeHigh(right_gear_)) {
310 return 1;
311 } else {
312 return 0;
James Kuszmaul891f4f12020-10-31 17:13:23 -0700313 }
Austin Schuh6613a072016-01-06 19:54:48 -0800314 }
Austin Schuhfb0f35c2021-02-14 21:25:29 -0800315}
316flatbuffers::Offset<GearLogging> DrivetrainFilters::CreateGearLogging(
317 flatbuffers::FlatBufferBuilder *fbb) const {
318 GearLogging::Builder gear_logging_builder(*fbb);
319 gear_logging_builder.add_left_state(static_cast<uint32_t>(left_gear_));
320 gear_logging_builder.add_right_state(static_cast<uint32_t>(right_gear_));
321 gear_logging_builder.add_left_loop_high(MaybeHigh(left_gear_));
322 gear_logging_builder.add_right_loop_high(MaybeHigh(right_gear_));
323 gear_logging_builder.add_controller_index(ControllerIndexFromGears());
324 return gear_logging_builder.Finish();
325}
Austin Schuh6613a072016-01-06 19:54:48 -0800326
Austin Schuhfb0f35c2021-02-14 21:25:29 -0800327Gear DrivetrainFilters::ComputeGear(
328 double shifter_position, const constants::ShifterHallEffect &shifter_config,
329 bool high_requested) const {
330 if (shifter_position < shifter_config.clear_low) {
331 return Gear::LOW;
332 } else if (shifter_position > shifter_config.clear_high) {
333 return Gear::HIGH;
334 } else {
335 if (high_requested) {
336 return Gear::SHIFTING_UP;
337 } else {
338 return Gear::SHIFTING_DOWN;
339 }
340 }
341}
342
343DrivetrainLoop::DrivetrainLoop(const DrivetrainConfig<double> &dt_config,
344 ::aos::EventLoop *event_loop,
345 LocalizerInterface *localizer,
346 const ::std::string &name)
James Kuszmaul61750662021-06-21 21:32:33 -0700347 : frc971::controls::ControlLoop<Goal, Position, Status, Output>(event_loop,
348 name),
Austin Schuhfb0f35c2021-02-14 21:25:29 -0800349 dt_config_(dt_config),
350 filters_(dt_config, event_loop, localizer),
351 dt_openloop_(dt_config_, filters_.kf()),
352 dt_closedloop_(dt_config_, filters_.kf(), localizer),
353 dt_spline_(dt_config_),
354 dt_line_follow_(dt_config_, localizer->target_selector()) {
355 event_loop->SetRuntimeRealtimePriority(30);
James Kuszmaul75a18c52021-03-10 22:02:07 -0800356 for (size_t ii = 0; ii < trajectory_fetchers_.size(); ++ii) {
357 trajectory_fetchers_[ii].fetcher =
358 event_loop->MakeFetcher<fb::Trajectory>("/drivetrain");
359 }
360}
361
362void DrivetrainLoop::UpdateTrajectoryFetchers() {
James Kuszmaul99af8b52021-03-28 10:50:15 -0700363 if (dt_spline_.trajectory_count() >= trajectory_fetchers_.size()) {
364 aos::monotonic_clock::time_point min_time = aos::monotonic_clock::max_time;
365 size_t min_fetcher_index = 0;
366 size_t fetcher_index = 0;
367 // Find the oldest spline to forget.
368 for (auto &fetcher : trajectory_fetchers_) {
369 CHECK_NE(fetcher.fetcher.context().monotonic_event_time,
370 monotonic_clock::min_time);
371 if (fetcher.fetcher.context().monotonic_event_time < min_time &&
372 !dt_spline_.IsCurrentTrajectory(fetcher.fetcher.get())) {
373 min_time = fetcher.fetcher.context().monotonic_event_time;
374 min_fetcher_index = fetcher_index;
375 }
376 ++fetcher_index;
377 }
378
379 dt_spline_.DeleteTrajectory(
380 trajectory_fetchers_[min_fetcher_index].fetcher.get());
381 trajectory_fetchers_[min_fetcher_index].in_use = false;
382 }
383
James Kuszmaul75a18c52021-03-10 22:02:07 -0800384 for (auto &fetcher : trajectory_fetchers_) {
385 const fb::Trajectory *trajectory = fetcher.fetcher.get();
386 // If the current fetcher is already being used by the SplineDrivetrain,
387 // don't touch it.
388 // We have to check both in_use and HasTrajectory because if
389 // in_use is true and HasTrajectory() is false, that implies that the
390 // SplineDrivetrain has finished executing the trajectory and disposed of
391 // it; if in_use is false and HasTrajectory() is true, that implies that
392 // this fetcher is at the same point in the queue as another fetcher, and
393 // that the other fetcher is the one that we are using to keep the message
394 // pinned.
395 // TODO(james): Consider garbage-collecting splines once we run out of
396 // fetchers.
397 if (fetcher.in_use && dt_spline_.HasTrajectory(trajectory)) {
398 continue;
399 }
400 fetcher.in_use = false;
401 // Go through and find the next Trajectory that isn't already held by the
402 // SplineDrivetrain, and add it.
403 while (fetcher.fetcher.FetchNext()) {
404 trajectory = fetcher.fetcher.get();
405 if (!dt_spline_.HasTrajectory(trajectory)) {
406 fetcher.in_use = true;
407 dt_spline_.AddTrajectory(trajectory);
408 break;
409 }
410 }
411 }
Austin Schuhfb0f35c2021-02-14 21:25:29 -0800412}
413
414void DrivetrainLoop::RunIteration(
415 const drivetrain::Goal *goal, const drivetrain::Position *position,
416 aos::Sender<drivetrain::Output>::Builder *output,
417 aos::Sender<drivetrain::Status>::Builder *status) {
418 const monotonic_clock::time_point monotonic_now =
419 event_loop()->monotonic_now();
420
421 if (!has_been_enabled_ && output) {
422 has_been_enabled_ = true;
423 }
424
425 if (WasReset()) {
426 filters_.Reset(monotonic_now, position);
427 }
428
James Kuszmaul75a18c52021-03-10 22:02:07 -0800429 UpdateTrajectoryFetchers();
430
Austin Schuhfb0f35c2021-02-14 21:25:29 -0800431 filters_.Correct(monotonic_now, position);
432
433 // Set the gear-logging parts of the status
434 CHECK(status);
435 flatbuffers::Offset<GearLogging> gear_logging_offset =
436 filters_.CreateGearLogging(status->fbb());
437
438 dt_openloop_.SetPosition(position, filters_.left_gear(),
439 filters_.right_gear());
Austin Schuh093535c2016-03-05 23:21:00 -0800440
Austin Schuh872723c2019-12-25 14:38:09 -0800441 ControllerType controller_type = ControllerType::POLYDRIVE;
Brian Silverman17f503e2015-08-02 18:17:18 -0700442 if (goal) {
Alex Perrycb7da4b2019-08-28 19:35:56 -0700443 controller_type = goal->controller_type();
Brian Silverman17f503e2015-08-02 18:17:18 -0700444
Alex Perrycb7da4b2019-08-28 19:35:56 -0700445 dt_closedloop_.SetGoal(goal);
446 dt_openloop_.SetGoal(goal->wheel(), goal->throttle(), goal->quickturn(),
447 goal->highgear());
448 dt_spline_.SetGoal(goal);
449 dt_line_follow_.SetGoal(monotonic_now, goal);
Brian Silverman17f503e2015-08-02 18:17:18 -0700450 }
451
Alex Perrycb7da4b2019-08-28 19:35:56 -0700452 dt_openloop_.Update(robot_state().voltage_battery());
Brian Silverman17f503e2015-08-02 18:17:18 -0700453
Alex Perrycb7da4b2019-08-28 19:35:56 -0700454 dt_closedloop_.Update(output != nullptr &&
Austin Schuh872723c2019-12-25 14:38:09 -0800455 controller_type == ControllerType::MOTION_PROFILE);
Austin Schuh78379ea2019-01-04 20:39:45 -0800456
James Kuszmaule39cbcf2019-02-27 20:48:34 -0800457 const Eigen::Matrix<double, 5, 1> trajectory_state =
Austin Schuhfb0f35c2021-02-14 21:25:29 -0800458 filters_.trajectory_state();
James Kuszmaule39cbcf2019-02-27 20:48:34 -0800459
James Kuszmaul897ef1a2020-10-25 17:51:10 -0700460 {
461 // TODO(james): The regular Kalman Filter's voltage error terms are
462 // currently unusable--either don't use voltage error at all for the spline
463 // following code, or use the EKF's voltage error estimates.
464 const Eigen::Matrix<double, 2, 1> voltage_error =
Austin Schuhfb0f35c2021-02-14 21:25:29 -0800465 0 * filters_.VoltageError();
James Kuszmaul897ef1a2020-10-25 17:51:10 -0700466 dt_spline_.Update(
467 output != nullptr && controller_type == ControllerType::SPLINE_FOLLOWER,
468 trajectory_state, voltage_error);
469 }
James Kuszmaule39cbcf2019-02-27 20:48:34 -0800470
James Kuszmaul38e79642019-03-09 15:48:27 -0800471 dt_line_follow_.Update(monotonic_now, trajectory_state);
Alex Perrya71badb2019-02-06 19:40:41 -0800472
Alex Perrycb7da4b2019-08-28 19:35:56 -0700473 OutputT output_struct;
474
Austin Schuh78379ea2019-01-04 20:39:45 -0800475 switch (controller_type) {
Austin Schuh872723c2019-12-25 14:38:09 -0800476 case ControllerType::POLYDRIVE:
Alex Perrycb7da4b2019-08-28 19:35:56 -0700477 dt_openloop_.SetOutput(output != nullptr ? &output_struct : nullptr);
Austin Schuh78379ea2019-01-04 20:39:45 -0800478 break;
Austin Schuh872723c2019-12-25 14:38:09 -0800479 case ControllerType::MOTION_PROFILE:
Alex Perrycb7da4b2019-08-28 19:35:56 -0700480 dt_closedloop_.SetOutput(output != nullptr ? &output_struct : nullptr);
Austin Schuh78379ea2019-01-04 20:39:45 -0800481 break;
Austin Schuh872723c2019-12-25 14:38:09 -0800482 case ControllerType::SPLINE_FOLLOWER:
Alex Perrycb7da4b2019-08-28 19:35:56 -0700483 dt_spline_.SetOutput(output != nullptr ? &output_struct : nullptr);
Alex Perry731b4602019-02-02 22:13:01 -0800484 break;
Austin Schuh872723c2019-12-25 14:38:09 -0800485 case ControllerType::LINE_FOLLOWER:
Alex Perrycb7da4b2019-08-28 19:35:56 -0700486 if (!dt_line_follow_.SetOutput(output != nullptr ? &output_struct
487 : nullptr)) {
James Kuszmaul5bc6fc92019-03-01 21:50:06 -0800488 // If the line follow drivetrain was unable to execute (generally due to
489 // not having a target), execute the regular teleop drivetrain.
Alex Perrycb7da4b2019-08-28 19:35:56 -0700490 dt_openloop_.SetOutput(output != nullptr ? &output_struct : nullptr);
James Kuszmaul5bc6fc92019-03-01 21:50:06 -0800491 }
James Kuszmaule39cbcf2019-02-27 20:48:34 -0800492 break;
Brian Silverman17f503e2015-08-02 18:17:18 -0700493 }
494
Austin Schuh093535c2016-03-05 23:21:00 -0800495 // The output should now contain the shift request.
496
Brian Silverman17f503e2015-08-02 18:17:18 -0700497 // set the output status of the control loop state
498 if (status) {
Austin Schuh093535c2016-03-05 23:21:00 -0800499 Eigen::Matrix<double, 2, 1> linear =
Austin Schuhfb0f35c2021-02-14 21:25:29 -0800500 dt_config_.LeftRightToLinear(filters_.DrivetrainXHat());
Austin Schuh093535c2016-03-05 23:21:00 -0800501 Eigen::Matrix<double, 2, 1> angular =
Austin Schuhfb0f35c2021-02-14 21:25:29 -0800502 dt_config_.LeftRightToAngular(filters_.DrivetrainXHat());
Austin Schuh093535c2016-03-05 23:21:00 -0800503
Austin Schuhfb0f35c2021-02-14 21:25:29 -0800504 angular(0, 0) = filters_.localizer_theta();
Austin Schuh093535c2016-03-05 23:21:00 -0800505
506 Eigen::Matrix<double, 4, 1> gyro_left_right =
Austin Schuhd91c0d22016-10-15 21:24:28 -0700507 dt_config_.AngularLinearToLeftRight(linear, angular);
Austin Schuh093535c2016-03-05 23:21:00 -0800508
Alex Perrycb7da4b2019-08-28 19:35:56 -0700509 const flatbuffers::Offset<CIMLogging> cim_logging_offset =
James Kuszmaulaf5dfad2020-01-03 20:02:54 -0800510 dt_openloop_.PopulateShiftingStatus(status->fbb());
511
512 const flatbuffers::Offset<PolyDriveLogging> poly_drive_logging_offset =
Alex Perrycb7da4b2019-08-28 19:35:56 -0700513 dt_openloop_.PopulateStatus(status->fbb());
Austin Schuh093535c2016-03-05 23:21:00 -0800514
James Kuszmaul3e1bb272020-01-17 18:38:19 -0800515 const flatbuffers::Offset<DownEstimatorState> down_estimator_state_offset =
Austin Schuhfb0f35c2021-02-14 21:25:29 -0800516 filters_.PopulateDownEstimatorState(status->fbb(), monotonic_now);
James Kuszmaul2215d922020-02-11 17:17:26 -0800517
James Kuszmaul3c5b4d32020-02-11 17:22:14 -0800518 const flatbuffers::Offset<LocalizerState> localizer_offset =
Austin Schuhfb0f35c2021-02-14 21:25:29 -0800519 filters_.PopulateLocalizerState(status->fbb());
James Kuszmaul3c5b4d32020-02-11 17:22:14 -0800520
James Kuszmaul2215d922020-02-11 17:17:26 -0800521 const flatbuffers::Offset<ImuZeroerState> zeroer_offset =
Austin Schuhfb0f35c2021-02-14 21:25:29 -0800522 filters_.PopulateImuZeroerState(status->fbb());
James Kuszmaul3e1bb272020-01-17 18:38:19 -0800523
Alex Perrycb7da4b2019-08-28 19:35:56 -0700524 flatbuffers::Offset<LineFollowLogging> line_follow_logging_offset =
525 dt_line_follow_.PopulateStatus(status);
526 flatbuffers::Offset<TrajectoryLogging> trajectory_logging_offset =
527 dt_spline_.MakeTrajectoryLogging(status);
Austin Schuh093535c2016-03-05 23:21:00 -0800528
Austin Schuhfb0f35c2021-02-14 21:25:29 -0800529 Status::Builder builder = status->MakeBuilder<Status>();
Austin Schuh3a378462019-01-04 21:48:04 -0800530
Alex Perrycb7da4b2019-08-28 19:35:56 -0700531 dt_closedloop_.PopulateStatus(&builder);
Austin Schuh3a378462019-01-04 21:48:04 -0800532
Austin Schuh95771d92021-01-23 14:42:25 -0800533 builder.add_estimated_left_position(gyro_left_right(kLeftPosition));
534 builder.add_estimated_right_position(gyro_left_right(kRightPosition));
Austin Schuh41565602016-02-28 20:10:49 -0800535
Austin Schuh95771d92021-01-23 14:42:25 -0800536 builder.add_estimated_left_velocity(gyro_left_right(kLeftVelocity));
537 builder.add_estimated_right_velocity(gyro_left_right(kRightVelocity));
Alex Perrycb7da4b2019-08-28 19:35:56 -0700538
539 if (dt_spline_.enable()) {
540 dt_spline_.PopulateStatus(&builder);
541 } else {
Austin Schuhfb0f35c2021-02-14 21:25:29 -0800542 builder.add_robot_speed((filters_.DrivetrainXHat(kLeftVelocity) +
543 filters_.DrivetrainXHat(kRightVelocity)) /
544 2.0);
Alex Perrycb7da4b2019-08-28 19:35:56 -0700545 builder.add_output_was_capped(dt_closedloop_.output_was_capped());
Austin Schuhfb0f35c2021-02-14 21:25:29 -0800546 builder.add_uncapped_left_voltage(
547 filters_.DrivetrainUUncapped(kLeftVoltage));
548 builder.add_uncapped_right_voltage(
549 filters_.DrivetrainUUncapped(kRightVoltage));
Alex Perrycb7da4b2019-08-28 19:35:56 -0700550 }
551
Austin Schuhfb0f35c2021-02-14 21:25:29 -0800552 builder.add_left_voltage_error(filters_.DrivetrainXHat(kLeftError));
553 builder.add_right_voltage_error(filters_.DrivetrainXHat(kRightError));
554 builder.add_estimated_angular_velocity_error(
555 filters_.DrivetrainXHat(kAngularError));
556 builder.add_estimated_heading(filters_.localizer_theta());
Alex Perrycb7da4b2019-08-28 19:35:56 -0700557
Austin Schuhfb0f35c2021-02-14 21:25:29 -0800558 builder.add_x(filters_.x());
559 builder.add_y(filters_.y());
560 builder.add_theta(::aos::math::NormalizeAngle(filters_.localizer_theta()));
Alex Perrycb7da4b2019-08-28 19:35:56 -0700561
Alex Perrycb7da4b2019-08-28 19:35:56 -0700562 builder.add_cim_logging(cim_logging_offset);
James Kuszmaulaf5dfad2020-01-03 20:02:54 -0800563 builder.add_poly_drive_logging(poly_drive_logging_offset);
Alex Perrycb7da4b2019-08-28 19:35:56 -0700564 builder.add_gear_logging(gear_logging_offset);
565 builder.add_line_follow_logging(line_follow_logging_offset);
566 builder.add_trajectory_logging(trajectory_logging_offset);
James Kuszmaul3e1bb272020-01-17 18:38:19 -0800567 builder.add_down_estimator(down_estimator_state_offset);
James Kuszmaul3c5b4d32020-02-11 17:22:14 -0800568 builder.add_localizer(localizer_offset);
James Kuszmaul2215d922020-02-11 17:17:26 -0800569 builder.add_zeroing(zeroer_offset);
milind1f1dca32021-07-03 13:50:07 -0700570
571 builder.add_send_failures(status_failure_counter_.failures());
572
573 status_failure_counter_.Count(status->Send(builder.Finish()));
Brian Silverman17f503e2015-08-02 18:17:18 -0700574 }
Austin Schuh209f1702015-11-29 17:03:00 -0800575
James Kuszmaulddc69702021-03-24 21:55:03 -0700576 // If the filters aren't ready/valid, then disable all outputs (currently,
577 // this only happens if the IMU is faulted or has not zeroed).
578 // TODO(james): Add exceptions so that during competitive play the driver
579 // can retain minimal control of the robot.
580 if (!filters_.Ready()) {
581 output_struct.left_voltage = 0.0;
582 output_struct.right_voltage = 0.0;
583 }
584
Austin Schuh209f1702015-11-29 17:03:00 -0800585 double left_voltage = 0.0;
586 double right_voltage = 0.0;
587 if (output) {
Alex Perrycb7da4b2019-08-28 19:35:56 -0700588 left_voltage = output_struct.left_voltage;
589 right_voltage = output_struct.right_voltage;
Austin Schuhfb0f35c2021-02-14 21:25:29 -0800590 filters_.set_left_high_requested(output_struct.left_high);
591 filters_.set_right_high_requested(output_struct.right_high);
Austin Schuh209f1702015-11-29 17:03:00 -0800592 }
593
Alex Perrycb7da4b2019-08-28 19:35:56 -0700594 const double scalar = robot_state().voltage_battery() / 12.0;
Austin Schuh209f1702015-11-29 17:03:00 -0800595
596 left_voltage *= scalar;
597 right_voltage *= scalar;
598
Austin Schuh209f1702015-11-29 17:03:00 -0800599 // To validate, look at the following:
600
601 // Observed - dx/dt velocity for left, right.
602
603 // Angular velocity error compared to the gyro
604 // Gyro heading vs left-right
605 // Voltage error.
606
Austin Schuhfb0f35c2021-02-14 21:25:29 -0800607 {
608 Eigen::Matrix<double, 2, 1> U;
609 U(kLeftVoltage) = left_voltage;
610 U(kRightVoltage) = right_voltage;
611 filters_.UpdateObserver(U);
612 }
Alex Perrycb7da4b2019-08-28 19:35:56 -0700613
614 if (output) {
milind1f1dca32021-07-03 13:50:07 -0700615 output->CheckOk(output->Send(Output::Pack(*output->fbb(), &output_struct)));
Alex Perrycb7da4b2019-08-28 19:35:56 -0700616 }
Brian Silverman17f503e2015-08-02 18:17:18 -0700617}
618
Alex Perrycb7da4b2019-08-28 19:35:56 -0700619flatbuffers::Offset<Output> DrivetrainLoop::Zero(
620 aos::Sender<Output>::Builder *output) {
621 Output::Builder builder = output->MakeBuilder<Output>();
622 builder.add_left_voltage(0);
623 builder.add_right_voltage(0);
624 builder.add_left_high(dt_config_.default_high_gear);
625 builder.add_right_high(dt_config_.default_high_gear);
626 return builder.Finish();
Adam Snaiderbc918b62016-02-27 21:03:39 -0800627}
628
Austin Schuh6197a182015-11-28 16:04:40 -0800629} // namespace drivetrain
Brian Silverman17f503e2015-08-02 18:17:18 -0700630} // namespace control_loops
Comran Morshed5323ecb2015-12-26 20:50:55 +0000631} // namespace frc971