mirror of
https://github.com/wpilibsuite/allwpilib
synced 2026-06-19 00:41:43 +00:00
For the previous couple of months, the PID tests have been hanging. The reason that the tests have been hanging lies with the Notifier, not the PID controller. Basically, a deadlock was occuring during Notifier destruction when the notifier destructor was called while the notifier interrupt handler was being called. Because the low-level interrupt manager waits for the interrupt handler to finish executing before disabling itself, the notifier destructor would not exit until the ProcessQueue function finished. However, at the same time, the handler was attempting to lock the queueMutex before continuing; the Notifier destructor had locked the queueMutex while wrapping things up, meaning that the last run of the handler would not complete until the destructor did, resulting in a deadlock. In order to repair this, I reduced the scope of the lock on the queueMutex in the destructor so that it only locks when absolutely necessary. This should work now. This bug was likely introduced over the summer when we updated to stl mutexes and locks, which may have messed up the original lock structure. This likely did not affect any teams, as it can only occur if you are actively destroying every* Notifier object present and if the destructor happens to be called while the handler is being run. *Note: the component of the destructor causing issues only ran if the last Notifier object is being destroyed. Change-Id: I38ba4e60816a2a8d523e927c25378390a0755444
58 lines
2.1 KiB
C++
58 lines
2.1 KiB
C++
/*----------------------------------------------------------------------------*/
|
|
/* Copyright (c) FIRST 2008. All Rights Reserved.
|
|
*/
|
|
/* Open Source Software - may be modified and shared by FRC teams. The code */
|
|
/* must be accompanied by the FIRST BSD license file in $(WIND_BASE)/WPILib. */
|
|
/*----------------------------------------------------------------------------*/
|
|
#pragma once
|
|
|
|
#include "ErrorBase.h"
|
|
#include "HAL/cpp/priority_mutex.h"
|
|
#include <thread>
|
|
#include <atomic>
|
|
|
|
typedef void (*TimerEventHandler)(void *param);
|
|
|
|
class Notifier : public ErrorBase {
|
|
public:
|
|
Notifier(TimerEventHandler handler, void *param = nullptr);
|
|
virtual ~Notifier();
|
|
|
|
Notifier(const Notifier&) = delete;
|
|
Notifier& operator=(const Notifier&) = delete;
|
|
|
|
void StartSingle(double delay);
|
|
void StartPeriodic(double period);
|
|
void Stop();
|
|
|
|
private:
|
|
static Notifier *timerQueueHead;
|
|
static priority_recursive_mutex queueMutex;
|
|
static priority_mutex halMutex;
|
|
static void *m_notifier;
|
|
static std::atomic<int> refcount;
|
|
|
|
static void ProcessQueue(
|
|
uint32_t mask, void *params); // process the timer queue on a timer event
|
|
static void
|
|
UpdateAlarm(); // update the FPGA alarm since the queue has changed
|
|
void InsertInQueue(
|
|
bool reschedule); // insert this Notifier in the timer queue
|
|
void DeleteFromQueue(); // delete this Notifier from the timer queue
|
|
TimerEventHandler m_handler; // address of the handler
|
|
void *m_param; // a parameter to pass to the handler
|
|
double m_period = 0; // the relative time (either periodic or single)
|
|
double m_expirationTime = 0; // absolute expiration time for the current event
|
|
Notifier *m_nextEvent = nullptr; // next Nofifier event
|
|
bool m_periodic = false; // true if this is a periodic event
|
|
bool m_queued = false; // indicates if this entry is queued
|
|
priority_mutex m_handlerMutex; // held by interrupt manager task while
|
|
// handler call is in progress
|
|
|
|
#ifdef FRC_SIMULATOR
|
|
static std::thread m_task;
|
|
static std::atomic<bool> m_stopped;
|
|
#endif
|
|
static void Run();
|
|
};
|