#include "Measurement.h" #include "Config.h" #include bool Measurement::start(float hz, float duty, float tolerance, uint32_t timeMs, uint8_t repeats, uint8_t settleCycles) { if (!task_ && xTaskCreate(taskEntry, "optical-rx", 4096, this, 4, &task_) != pdPASS) return false; expectedHz_ = static_cast(hz + 0.5f); if (!expectedHz_ || !timeMs || !repeats || repeats > 10 || !makePeriodLimits(expectedHz_, duty, tolerance, receiver_.tickHz(), limits_) || !receiver_.start(expectedHz_)) return false; repeats_ = repeats; settleCycles_ = settleCycles; settleLeft_ = settleCycles; stepTimeMs_ = (timeMs + MEASUREMENT_PROGRESS_STEPS - 1U) / MEASUREMENT_PROGRESS_STEPS; stepTicks_ = static_cast(receiver_.tickHz()) * timeMs / (1000ULL * MEASUREMENT_PROGRESS_STEPS); if (!stepTicks_) stepTicks_ = 1; totalSteps_ = repeats * MEASUREMENT_PROGRESS_STEPS; currentStep_ = currentRepeat_ = 0; stats_.reset(); memset(repeatPeriods_, 0, sizeof(repeatPeriods_)); publishStats(); measurementStartTick_ = deadlineTick_ = 0; startedMs_ = millis(); measurementStartMs_ = lastPeriodMs_ = 0; currentRepeat_ = 0; expectedPeriodMs_ = static_cast((1000ULL + expectedHz_ - 1U) / expectedHz_); if (!expectedPeriodMs_) expectedPeriodMs_ = 1; state_ = MeasureState::SETTLING; xTaskNotifyGive(task_); return true; } void Measurement::taskEntry(void *context) { static_cast(context)->taskLoop(); } void Measurement::taskLoop() { for (;;) { ulTaskNotifyTake(pdTRUE, portMAX_DELAY); while (state_ == MeasureState::SETTLING || state_ == MeasureState::RUNNING) processOnce(); } } void Measurement::fail(FailReason reason) { if (stats_.reason == FailReason::NONE) stats_.reason = reason; publishStats(); receiver_.stop(); state_ = MeasureState::FAIL; } void Measurement::completeStep() { receiver_.stop(); stats_.droppedItems += receiver_.takeDroppedItems(); if (receiver_.overflowed()) { fail(FailReason::GLITCH); return; } ++currentStep_; publishStats(); if (currentStep_ < totalSteps_) { state_ = MeasureState::STEP_READY; return; } for (uint8_t i = 0; i < repeats_; ++i) if (!repeatPeriods_[i]) { fail(FailReason::TOO_FEW_PERIODS); return; } state_ = MeasureState::PASS; } void Measurement::publishStats() { portENTER_CRITICAL(&statsMux_); publishedStats_ = stats_; portEXIT_CRITICAL(&statsMux_); } bool Measurement::statsSnapshot(StageStats &out) const { portENTER_CRITICAL(&statsMux_); out = publishedStats_; portEXIT_CRITICAL(&statsMux_); return out.periods && out.periodSum; } MeasureState Measurement::processOnce() { if (state_ != MeasureState::SETTLING && state_ != MeasureState::RUNNING) return state_; if (receiver_.overflowed()) { fail(FailReason::GLITCH); return state_; } bool receivedPeriod = false; for (;;) { const size_t periodCount = receiver_.readPeriods(periodBatch_, PERIOD_BATCH_SIZE, pdMS_TO_TICKS(2)); stats_.droppedItems += receiver_.takeDroppedItems(); if (!periodCount) break; receivedPeriod = true; for (size_t periodIndex = 0; periodIndex < periodCount; ++periodIndex) { if (state_ != MeasureState::SETTLING && state_ != MeasureState::RUNNING) return state_; const PulsePeriod &period = periodBatch_[periodIndex]; if (state_ == MeasureState::SETTLING) { if (settleLeft_) --settleLeft_; if (!settleLeft_) { measurementStartTick_ = period.startTick + period.periodTicks; deadlineTick_ = measurementStartTick_ + stepTicks_; currentRepeat_ = currentStep_ / MEASUREMENT_PROGRESS_STEPS; measurementStartMs_ = lastPeriodMs_ = millis(); state_ = MeasureState::RUNNING; } continue; } const uint64_t endTick = period.startTick + period.periodTicks; if (period.startTick < measurementStartTick_) continue; // leading incomplete period if (endTick > deadlineTick_) { completeStep(); return state_; } // trailing incomplete period ++repeatPeriods_[currentRepeat_]; const FailReason r = evaluatePeriodFast(period, receiver_.tickHz(), limits_, currentRepeat_ + 1, stats_); if (r != FailReason::NONE) { fail(r); return state_; } } } if (receivedPeriod && state_ == MeasureState::RUNNING) lastPeriodMs_ = millis(); const uint64_t edgeBasedTimeout = static_cast(PWM_SETTLE_CYCLES + NO_SIGNAL_TIMEOUT_PERIODS) * expectedPeriodMs_ + 20; const uint64_t rmtBatchTimeout = static_cast(RMT_MIN_RECEIVE_SYMBOLS + NO_SIGNAL_TIMEOUT_PERIODS) * expectedPeriodMs_ + 20; const uint64_t settleTimeout = edgeBasedTimeout > rmtBatchTimeout ? edgeBasedTimeout : rmtBatchTimeout; if (state_ == MeasureState::SETTLING && millis() - startedMs_ > settleTimeout) fail(FailReason::NO_SIGNAL); if (state_ == MeasureState::RUNNING && measurementStartTick_) { const uint32_t now = millis(); const uint32_t edgeTimeoutMs = expectedPeriodMs_ * NO_SIGNAL_TIMEOUT_PERIODS + 2; if (now - measurementStartMs_ < stepTimeMs_ && now - lastPeriodMs_ > edgeTimeoutMs) { fail(FailReason::LOST_EDGE); return state_; } if (now - measurementStartMs_ > stepTimeMs_ + expectedPeriodMs_ + 2) completeStep(); } return state_; } MeasureState Measurement::update() { return state_; } bool Measurement::continueAfterDisplay() { if (state_ != MeasureState::STEP_READY) return false; if (!receiver_.start(expectedHz_)) { fail(FailReason::UNSUPPORTED); return false; } settleLeft_ = settleCycles_; measurementStartTick_ = deadlineTick_ = 0; startedMs_ = millis(); measurementStartMs_ = lastPeriodMs_ = 0; state_ = MeasureState::SETTLING; xTaskNotifyGive(task_); return true; } void Measurement::abort() { if (state_ == MeasureState::SETTLING || state_ == MeasureState::RUNNING || state_ == MeasureState::STEP_READY) fail(FailReason::ABORTED); }