Files
Jungfraujoch/image_pusher/ImagePusher.h
T
leonarski_fandClaude Opus 4.8 086129f767 receiver: count only images the pusher accepted
images_sent was incremented right after image_pusher.SendImage(*loc), but the
ZeroCopyReturnValue overload was void and, for the TCP pusher, asynchronous: it
silently drops the image (releases the slot and returns) when there is no live
connection or the 2 s enqueue deadline expires. So images_sent over-counted on a
broken/slow writer connection and disagreed with the ACK-based GetImagesWritten().

Make SendImage(ZeroCopyReturnValue&) return whether the image was accepted
(enqueued/handed off) and only increment images_sent on success. The slot is
still released on the drop path. The authoritative delivered count remains
GetImagesWritten() (total_data_acked_ok for TCP). File/ZMQ pushers return true on
accept, preserving their previous always-counted behaviour.

Co-Authored-By: Claude Opus 4.8 <noreply@anthropic.com>
2026-06-18 14:24:48 +02:00

74 lines
2.8 KiB
C++

// SPDX-FileCopyrightText: 2024 Filip Leonarski, Paul Scherrer Institute <filip.leonarski@psi.ch>
// SPDX-License-Identifier: GPL-3.0-only
#pragma once
#include <vector>
#include "../common/DiffractionExperiment.h"
#include "../common/JFJochMessages.h"
#include "../common/ZeroCopyReturnValue.h"
#include "../common/Logger.h"
#include "../frame_serialize/CBORStream2Serializer.h"
enum class ImagePusherType {HDF5, CBOR, TCP, ZMQ, Test, None};
struct ImagePusherStatus {
ImagePusherType pusher_type = ImagePusherType::None;
std::vector<std::string> address = {};
size_t connected_writers = 0;
std::optional<size_t> images_written = 0;
std::optional<size_t> images_write_error = 0;
std::vector<int64_t> writer_fifo_utilization;
};
struct ImagePusherQueueElement {
const uint8_t *image_data;
ZeroCopyReturnValue *z;
bool end;
};
void PrepareCBORImage(DataMessage& message,
const DiffractionExperiment &experiment,
void *image, size_t image_size);
class ImagePusher {
protected:
std::vector<uint8_t> serialization_buffer;
CBORStream2Serializer serializer;
ImagePusher();
public:
virtual void StartDataCollection(StartMessage& message) = 0;
virtual bool EndDataCollection(const EndMessage& message) = 0; // Non-blocking
virtual bool SendImage(const uint8_t *image_data, size_t image_size, int64_t image_number) = 0;
// Returns true if the image was accepted (handed to the writer / enqueued for
// sending), false if it was dropped (e.g. no TCP connection, or the enqueue
// deadline expired). Ownership is settled either way: on a false return the
// slot has already been release()d. The authoritative count of images actually
// delivered is GetImagesWritten() (ACK-based for TCP).
virtual bool SendImage(ZeroCopyReturnValue &z);
virtual bool SendCalibration(const CompressedImage& message) = 0;
virtual std::string Finalize(); // Ensure that all streams are closed, can throw exception
virtual std::string GetWriterNotificationSocketAddress() const;
virtual ~ImagePusher() = default;
virtual std::string PrintSetup() const = 0;
virtual std::vector<std::string> GetAddress() const { return {}; }
virtual std::optional<uint64_t> GetImagesWritten() const { return std::nullopt; }
virtual std::optional<uint64_t> GetImagesWriteError() const { return std::nullopt; }
virtual size_t GetConnectedWriters() const { return 0; };
virtual ImagePusherType GetType() const = 0;
virtual std::vector<int64_t> GetWriterFifoUtilization() const { return {}; }
ImagePusherStatus GetStatus() const {
return ImagePusherStatus{
GetType(),
GetAddress(),
GetConnectedWriters(),
GetImagesWritten(),
GetImagesWriteError(),
GetWriterFifoUtilization()
};
}
};