Files
LookingGlass/obs/frame_scheduler.h
Geoffrey McRae 8a04037c9b [obs] scheduler: serialize cadence controls
Track the LGMP serial for each accepted frame-schedule message and wait
for its acknowledgement before sending another. Preserve pending RESET,
IMMEDIATE, and feedback state after definite enqueue failures.

Use bounded retry polling and request one fresh immediate frame after an
ambiguous pointer-queue fault recovers.
2026-08-06 18:02:08 +10:00

78 lines
2.5 KiB
C

/**
* Looking Glass
* Copyright © 2017-2026 The Looking Glass Authors
* https://looking-glass.io
*
* This program is free software; you can redistribute it and/or modify it
* under the terms of the GNU General Public License as published by the Free
* Software Foundation; either version 2 of the License, or (at your option)
* any later version.
*
* This program is distributed in the hope that it will be useful, but WITHOUT
* ANY WARRANTY; without even the implied warranty of MERCHANTABILITY or
* FITNESS FOR A PARTICULAR PURPOSE. See the GNU General Public License for
* more details.
*
* You should have received a copy of the GNU General Public License along
* with this program; if not, write to the Free Software Foundation, Inc., 59
* Temple Place, Suite 330, Boston, MA 02111-1307 USA
*/
#ifndef LG_OBS_FRAME_SCHEDULER_H
#define LG_OBS_FRAME_SCHEDULER_H
#include <lgmp/client.h>
#include <stdbool.h>
#include <stdint.h>
typedef struct LGFrameScheduler
{
bool supported;
bool sourceActive;
bool active;
bool resetPending;
bool immediatePending;
bool feedbackDirty;
bool controlPending;
bool controlFaulted;
uint32_t clientID;
uint32_t generation;
uint32_t controlSerial;
uint64_t period;
uint64_t lastSend;
uint64_t lastTick;
uint64_t nextControlCheck;
uint64_t controlRetryDelay;
int64_t phaseError;
uint32_t feedbackFrameSerial;
uint32_t feedbackScheduleEpoch;
uint32_t feedbackDeadlineSerial;
unsigned feedbackSamples;
uint32_t readyFrameSerial;
uint32_t readyGeneration;
uint32_t readyScheduleEpoch;
uint32_t readyDeadlineSerial;
uint64_t readyTime;
}
LGFrameScheduler;
void lgFrameSchedulerInit(LGFrameScheduler * scheduler, bool supported,
uint32_t clientID);
void lgFrameSchedulerSetActive(LGFrameScheduler * scheduler, bool active);
void lgFrameSchedulerSetPeriod(LGFrameScheduler * scheduler,
uint64_t period, uint64_t tickTime);
void lgFrameSchedulerRequestImmediate(LGFrameScheduler * scheduler);
void lgFrameSchedulerObserveFrame(LGFrameScheduler * scheduler,
uint32_t frameSerial, uint32_t generation, uint32_t scheduleEpoch,
uint32_t deadlineSerial, uint64_t readyTime);
void lgFrameSchedulerFeedback(LGFrameScheduler * scheduler,
uint32_t frameSerial, uint32_t generation, uint32_t scheduleEpoch,
uint32_t deadlineSerial, uint64_t tickTime);
void lgFrameSchedulerUpdate(LGFrameScheduler * scheduler,
PLGMPClientQueue queue, uint64_t now);
#endif