Loading...
Searching...
No Matches
capture_arbiter.h
Go to the documentation of this file.
42 * @param filename Bounded PANGEA_CAMERA_V1 flat key=value file; prefix c/a/l identifies the sensor.
69 * @return Random nonzero token after successful profile initialization; not an authentication key.
78void capture_arbiter_set_scope(const union usher_capture_arbiter_state_union *scope, uint64_t now_us);
86bool capture_arbiter_offer(const union usher_capture_arbiter_shoot_union *request, uint64_t now_us);
92 * @return True when the caller must dispatch work and eventually call capture_arbiter_complete().
95bool capture_arbiter_take(uint32_t ready_mask, uint64_t now_us, union dc_shot_union *shot, uint8_t *mask);
114bool capture_arbiter_result(union usher_capture_arbiter_result_union *result, uint32_t ready_mask);
141void capture_arbiter_pose_sample(const union usher_pose_sample_union *sample, uint64_t earliest_us, uint64_t latest_us);
151bool capture_arbiter_pose_at(uint64_t time_us, uint64_t time_error_us, union dc_shot_union *shot,
153/** @brief Resolve one bounded observation; wait_us is 0 on the serial thread, at most 200000 in workers. */
154bool capture_arbiter_observation_pose(struct capture_observation *observation, uint64_t wait_us);
158bool capture_arbiter_frame_timing(const char *filename, unsigned camera_id, struct capture_observation *observation);
161 * @param camera_id Sensor identity; configured profile dimensions must match the JPEG and record.
169bool capture_arbiter_frame_pose(const char *filename, unsigned camera_id, const union dc_shot_union *request,
bool capture_arbiter_set_overlap(double overlap)
Set the overlap floor for deliberate predictive delay, not FC shot spacing.
Definition capture_arbiter.c:286
void capture_arbiter_pose_invalidate(void)
Forget pose history when synchronization is lost; keep saved coverage.
Definition capture_arbiter.c:562
bool capture_arbiter_pending(void)
Check whether waiting or active survey work remains.
Definition capture_arbiter.c:516
void capture_arbiter_pose_sample(const union usher_pose_sample_union *sample, uint64_t earliest_us, uint64_t latest_us)
Add a pose only after the caller has established bounded clock alignment.
Definition capture_arbiter.c:571
bool capture_arbiter_set_camera_capacity(unsigned camera_id, unsigned capacity)
Set admission from a backend's actual capacity, independent of camera ID.
Definition capture_arbiter.c:295
bool capture_arbiter_frame_timing(const char *filename, unsigned camera_id, struct capture_observation *observation)
Read embedded capture identity from a stable JPEG; true need not qualify timing.
Definition capture_arbiter.c:739
bool capture_arbiter_take(uint32_t ready_mask, uint64_t now_us, union dc_shot_union *shot, uint8_t *mask)
Admit the oldest ready camera intention after optional coverage evaluation.
Definition capture_arbiter.c:450
void capture_arbiter_set_enforce(bool enforce)
Enable coverage-based suppression and limited delay, or observe decisions only.
Definition capture_arbiter.c:279
bool capture_arbiter_owns(int32_t number)
Identify a shot whose active survey ownership must not be superseded.
Definition capture_arbiter.c:526
bool capture_arbiter_frame_pose(const char *filename, unsigned camera_id, const union dc_shot_union *request, union dc_shot_union *exposure, double *uncertainty_m)
Associate embedded exposure evidence with this JPEG before geotagging.
Definition capture_arbiter.c:795
uint32_t capture_arbiter_session_id(void)
Return the peer-session token, or zero when survey mode is not configured.
Definition capture_arbiter.c:304
void capture_arbiter_set_scope(const union usher_capture_arbiter_state_union *scope, uint64_t now_us)
Refresh survey authorization or cancel waiting work when scope is withdrawn.
Definition capture_arbiter.c:312
bool capture_arbiter_result(union usher_capture_arbiter_result_union *result, uint32_t ready_mask)
Pop a bounded best-effort result for UART transmission.
Definition capture_arbiter.c:501
void capture_arbiter_acquired(int32_t number, unsigned camera_id, uint64_t now_us)
Learn acquisition latency separately from slower JPEG publication.
Definition capture_arbiter.c:536
void capture_arbiter_complete(const union dc_shot_union *shot, unsigned camera_id, bool saved, bool exposure_pose_valid, double uncertainty_m, uint64_t now_us)
Release admission and optionally credit verified saved coverage.
Definition capture_arbiter.c:459
bool capture_arbiter_observation_pose(struct capture_observation *observation, uint64_t wait_us)
Resolve one bounded observation; wait_us is 0 on the serial thread, at most 200000 in workers.
Definition capture_arbiter.c:712
bool capture_arbiter_load_camera(const char *filename)
Load one camera's measured profile without guessing geometry from its ID.
Definition capture_arbiter.c:238
void capture_arbiter_stop(void)
Cancel waiting intentions, retaining active-image ownership and saved coverage.
Definition capture_arbiter.c:553
bool capture_arbiter_pose_at(uint64_t time_us, uint64_t time_error_us, union dc_shot_union *shot, double *uncertainty_m)
Interpolate within trusted nearby pose samples, never across a long gap.
Definition capture_arbiter.c:707
bool capture_arbiter_offer(const union usher_capture_arbiter_shoot_union *request, uint64_t now_us)
Split a survey request into bounded per-camera intentions.
Definition capture_arbiter.c:334
Sensor observation times, aligned poses, and optional frame-arrival evidence.
Fixed-memory geometric coverage accounting, independent of camera I/O.
Definition capture_timing.h:41
Definition usher_protocol.h:51
Best-effort USHER-to-FC terminal result for one camera and shot number.
Definition usher_protocol.h:368
FC-to-USHER spatial observation request, not a physical shutter acknowledgement.
Definition usher_protocol.h:358
FC-to-USHER survey authorization, independent of individual shot requests.
Definition usher_protocol.h:349
Definition usher_protocol.h:261
Shared FC/MORA byte-stream UART framing, messages and payload layouts.