rt-history: An RT-safe history log with error checking
This is a bounded wait-free thread synchronization primitive which allows you to record the time evolution of some data on one thread and be able to query the last N data points on other threads.
By definition of wait-free synchronization, the producer and consumer threads cannot wait for each other, so in bad conditions (too small a buffer size, too low a thread's priority, too loaded a system...), two race conditions can occur:
- The producer can be too fast with respect to consumers, and overwrite historical data which a consumer was still in the process of reading. This buffer overrun scenario is reported, along with the degree of overrun that occurred, which can be used to guide system parameter adjustments so that the error stops occurring.
- The producer can be too slow with respect to consumers, and fail to write a sufficient amount of new data inbetween two consumer readouts. The precise definition of this buffer underrun error is workload-dependent, so we provide the right tool to detect it in the form of a latest data point timestamp, but we do not handle it ourselves.
let (mut input, output) = RTHistory::<u8>::new(8).split();
let in_buf = [1, 2, 3];
input.write(&in_buf[..]);
let mut out_buf = [0; 3];
assert_eq!(output.read(&mut out_buf[..]), Ok(3));
assert_eq!(in_buf, out_buf);
4 Dec 28, 2022
2.3k Dec 30, 2022
7 Aug 5, 2022
120 Dec 19, 2022
827 Jan 4, 2023
6 Apr 5, 2022
8 Sep 15, 2022
7 Jan 9, 2023
240 Dec 28, 2022
6 Dec 19, 2022
4 Oct 23, 2022
5 Jul 7, 2023
3 Apr 1, 2024
8 Sep 16, 2024
256 Jan 2, 2023
23 Dec 16, 2022
359 Nov 27, 2022
700 Dec 27, 2022
1.1k Dec 30, 2022
1 Nov 4, 2022
11 Dec 24, 2022
16 Nov 20, 2022
2 Jul 21, 2022
61 Jul 24, 2024
1.2k Jan 1, 2023
3 Dec 23, 2022
54 Jan 3, 2023
5 Jun 14, 2023
5 Oct 23, 2023