M-Labs/artiq
2
0
Fork 2
mirror of https://github.com/m-labs/artiq.git synced 2024-12-25 03:08:27 +08:00
Code Issues Projects Releases Wiki Activity

doc: some precisions about controllers

Browse Source
This commit is contained in:
Sebastien Bourdeauducq 2014-10-28 11:43:06 +08:00
parent d5a3f3ef51
commit 8d305e3117
3 changed files with 6 additions and 4 deletions
Show Stats Download Patch File Download Diff File Expand all files Collapse all files

2
artiq/language/core.py
View File

@ -84,7 +84,7 @@ def array(element, count):
class AutoContext:
"""Base class to automate device and parameter management.
"""Base class to automate device and parameter discovery.
Drivers and experiments should in most cases overload this class to
obtain the parameters and devices (including the core device) that they

3
doc/manual/core_drivers_reference.rst
View File

@ -1,8 +1,7 @@
Core drivers reference
======================
These drivers are for peripherals closely integrated into the core device, which do not
follow the controller paradigm.
These drivers are for peripherals closely integrated into the core device, which do not use the controller mechanism.
:mod:`artiq.coredevice.rtio` module
-----------------------------------

5
doc/manual/writing_a_driver.rst
View File

@ -1,7 +1,7 @@
Writing a driver
================
These instructions cover writing a simple driver for a "slow" device, that uses the controller paradigm.
These instructions cover writing a simple driver for a "slow" device, that uses the controller mechanism.
The controller
--------------
@ -52,6 +52,8 @@ and verify that you can connect to the TCP port: ::
The client
----------
Controller clients are small command-line utilities that expose certain functionalities of the drivers. They are optional, and not used very often - typically for debugging and testing.
Create a ``hello-client`` file with the following contents: ::
#!/usr/bin/env python3
@ -74,6 +76,7 @@ Run it as before, while the controller is running. You should see the message ap
$ ./hello-controller
message: Hello World!
When using the driver in an experiment, for simple cases the ``Client`` instance can be returned by the :class:`artiq.language.core.AutoContext` mechanism and used normally as a device.
Command-line arguments
----------------------