Welcome to PyTango 7 documentation!

Indices and tables

• Index
• Module Index
• Search Page

PyTango

The python Tango binding is made accessible using the module PyTango.

The PyTango python module implements the Python Tango Device and Database API mapping but also allow to write Tango device server using Python.

It then allows access from Python environment to the Tango high level C++ classes and structures (see “The TANGO Control system manual” for complete reference).

If you want to write Tango device server in Python using this PyTango module, you need Tango C++ library release 7.0 or above.

If you simply need to write Python script which act as Tango client only, older releases of tango can be used.

These Tango high level C++ classes and structures are exported to Python using the Boost.python library (see http://boost.sourceforge.net). Details on how to install the boost library and generate the python PyTango module from source code are available in the Readme files of this packages.

• Getting started
  • Dependencies on other libraries
  • Installing precompiled binaries
    • Linux
    • Windows
  • Compilation
    • Linux
  • A quick tour of client binding through real examples
    • Check PyTango version
    • Check Tango C++ version
    • Test the connection to the Device and get it’s current state
    • Execute commands with scalar arguments on a Device
    • Execute commands with more complex types
    • Reading and writing attributes
    • Registering devices
    • Setting up Device properties
  • A quick tour of Tango device server binding through an example
• The Tango Device Python API
  • DeviceProxy
  • AttributeProxy
  • Group
    • Group class
    • GroupReply classes
  • Information classes
    • Attribute
    • Command
    • Other
  • Storage classes
    • Attribute: DeviceAttribute
    • Command: DeviceData
  • Callback related classes
  • Event related classes
    • Event configuration information
    • Event arrived structures
  • History classes
  • Enumerations & other classes
    • Enumerations
    • Other classes
• The Tango Database Python API
• The Tango Device Server Python API
  • Importing python modules
  • The main part of a Python device server
  • The PyDsExpClass class in Python
  • Defining commands
  • Defining attributes
  • The PyDsExp class in Python
    • General methods
    • Implementing a command
    • Implementing an attribute
    • Dynamic attributes
  • Mixing Tango classes (Python and C++) in a Python Tango device server
  • Server API
    • Device classes
    • DeviceClass
    • Attribute classes
    • Util
• Exception Handling
  • Exception definition
  • Throwing exception in a device server
  • Exception API
• FAQ
  • Where are the usual bjam files?
  • I got a libbost_python error when I try to import PyTango module
  • My python code uses PyTango 3.0.4 API. How do I change to 7.0.0 API?
    • General rule of thumb for data types
    • Server
    • General
    • Optional
  • Why is there a “-Wstrict-prototypes” warning when I compile PyTango?
  • Why are there so many warnings when generating the documentation?

Revision

Contributers:M. Ounsy, A. Buteau, V. Forchì, E. Taurel, T. Coutinho, R. Suñe Last Update:July 27, 2009

History of modifications:

Date	Revision	Description	Author
18/07/03	1.0	Initial Version	M. Ounsy
06/10/03	2.0	Extension of the “Getting Started” paragraph	A. Buteau/M. Ounsy
14/10/03	3.0	Added Exception Handling paragraph	M. Ounsy
13/06/05	4.0	Ported to Latex, added events, AttributeProxy and ApiUtil	V. Forchì
13/06/05	4.1	fixed bug with python 2.5 and and state events new Database constructor	V. Forchì
15/01/06	5.0	Added Device Server classes	E.Taurel
15/03/07	6.0	Added AttrInfoEx, AttributeConfig events, 64bits, write_attribute	T. Coutinho
21/03/07	6.1	Added groups	T. Coutinho
15/06/07	6.2	Added dynamic attributes doc	E. Taurel
06/05/08	7.0	Update to Tango 6.1. Added DB methods, version info	T. Coutinho
10/07/09	8.0	Update to Tango 7. Major refactoring. Migrated doc	T. Coutinho/R. Suñe
24/07/09	8.1	Added migration info, added missing API doc	T. Coutinho/R. Suñe
27/07/09	8.2	Added migration info	T. Coutinho/R. Suñe

Version history:

version	Changes
7.0.0beta2	Bug fixes: DeviceImpl.set_value for scalar attributes DeviceImpl.push_***_event server commands with DevVar***StringArray as parameter or as return type in windows,a bug in PyTango.Util prevented servers from starting up Documentation: Improved FAQ Improved compilation chapter Improved migration information