M-Labs
/
artiq
mirror of https://github.com/m-labs/artiq.git
2
0
Fork 2
Code Issues Projects Releases Wiki Activity

doc/rtio: fix description of idle kernel/reset

This commit is contained in:
Robert Jördens 2016-08-25 10:20:10 +02:00
parent 69ea3d3cc0
commit 552146bd08
1 changed files with 3 additions and 2 deletions
Show Stats Download Patch File Download Diff File Expand all files Collapse all files

5
doc/manual/rtio.rst
View File

@ -132,5 +132,6 @@ If a previous kernel sets timeline cursor far in the future this effectively loc
It also means that a kernel is not guaranteed to always be executed with positive slack. It also means that a kernel is not guaranteed to always be executed with positive slack.
Therefore, when switching experiments it can be adequate to clear the RTIO FIFOs and initialize the timeline cursor to "sometime in the near future" using :meth:`artiq.coredevice.core.Core.reset`. Therefore, when switching experiments it can be adequate to clear the RTIO FIFOs and initialize the timeline cursor to "sometime in the near future" using :meth:`artiq.coredevice.core.Core.reset`.
The example idle kernel implements this mechanism.
To accommodate for seamless handover the idle kernel is is only executed when no other experiment is pending and when there is significant negative slack. Since it never waits for any input, it will rapidly fill the output FIFOs and would produce a large positive slack.
To avoid large positive slack and to accommodate for seamless handover the idle kernel will only run when no other experiment is pending and the example will wait before submitting events until there is significant negative slack.