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);
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
1.1k Dec 30, 2022
10 Sep 23, 2021
3 Feb 3, 2022
1 Nov 25, 2021
241 Jan 3, 2023
524 Dec 26, 2022
1 Feb 12, 2022
1 Nov 4, 2022
11 Dec 24, 2022
16 Nov 20, 2022
2 Jul 21, 2022
1.2k Jan 1, 2023
54 Jan 3, 2023
5 Jun 14, 2023
5 Oct 23, 2023
3 Dec 23, 2022
4 Dec 28, 2022