SYNOPSIS
loadrt latencybins [count=N|names=name1[,name2…]]
DESCRIPTION
Read availablebins pin for the number of bins available. Set the maxbinnumber pin for the number of ±;bins. Ensure maxbinnumber ≤ availablebins.
For maxbinnumber = N, the bins are numbered:
-
-N … 0 … +N bins
(the -0 bin is not populated)
(total effective bins = 2 * maxbinnumber + 1)
Set nsbinsize pin for the binsize (ns).
Iterate:
-
Set index pin to a bin number: 0 ≤ index ≤ maxbinnumber.
-
Read check pin and verify that check pin == index pin.
-
Read output pins:
-
pbinvalue is count for bin = +index
-
nbinvalue is count for bin = -index
-
pextra is count for all bins > maxbinnumber
-
nextra is count for all bins < maxbinnumber
-
latency-min is max negative latency
-
latency-max is max positive latency
-
If index is out of range (index < 0 or index > maxbinnumber) then pbinvalue = nbinvalue = -1. The reset pin may be used to restart.
The latency pin outputs the instantaneous latency.
Maintainers note: hardcoded for MAXBINNUMBER==1000
FUNCTIONS
- latencybins.N
PINS
- latencybins.N.maxbinnumber si32 in (default: 1000)
- latencybins.N.index si32 in
- latencybins.N.reset bool in
- latencybins.N.nsbinsize si32 in
- latencybins.N.check si32 out
- latencybins.N.latency si32 out
- latencybins.N.latency-max si32 out
- latencybins.N.latency-min si32 out
- latencybins.N.pbinvalue si32 out
- latencybins.N.nbinvalue si32 out
- latencybins.N.pextra si32 out
- latencybins.N.nextra si32 out
- latencybins.N.variance si32 out
- latencybins.N.availablebins si32 out (default: 1000)
AUTHOR
Dewey Garrett
LICENSE
GPL