Server Utilities & Exceptions

Memory queues, custom exception definitions, and helper utilities.

Queues & Memory Management

FIREQ_SERVER.utils.memory_queue.MemoryBoundedQueue

Thread-safe queue that bounds by memory usage, not item count.

Custom Exceptions

FIREQ_SERVER.utils.exceptions.FireqHardwareError	Base exception for all hardware-related errors.
FIREQ_SERVER.utils.exceptions.DriverError	Error originating from a low-level driver.
FIREQ_SERVER.utils.exceptions.TimingError	Invalid timing parameters for an experiment.
FIREQ_SERVER.utils.exceptions.ConfigurationError	Invalid hardware configuration.
FIREQ_SERVER.utils.exceptions.FrequencyError	Raised when frequency is out of valid range.
FIREQ_SERVER.utils.exceptions.EnvelopeUploadError	Raised when envelope upload fails.
FIREQ_SERVER.utils.exceptions.WaveCompilationError	Raised when wave compilation fails.
FIREQ_SERVER.utils.exceptions.DMAError	DMA-related error.
FIREQ_SERVER.utils.exceptions.DMATimeoutError	Exception raised when a DMA transfer exceeds the allowed time limit.
FIREQ_SERVER.utils.exceptions.RecoverableDMAError	DMA error that occurred but data may still be recoverable.
FIREQ_SERVER.utils.exceptions.HardwareResourceError	Raised when a hardware resource cannot be accessed or allocated.
FIREQ_SERVER.utils.exceptions.HardwareStateError	Raised when hardware is in unexpected state.
FIREQ_SERVER.utils.exceptions.ClientDisconnectedError	Raised when the remote peer disconnects (gracefully or abruptly).
FIREQ_SERVER.utils.exceptions.IncompleteTransferError	Raised when a socket transfer was not completed successfully.
FIREQ_SERVER.utils.exceptions.InvalidPayloadError	Raised when payload parsing fails.