# `TangoDevice`

digraph inheritancea794e2e61a { bgcolor=transparent; rankdir=UD; ratio=compress; size="8.0, 12.0"; "Logger" [URL="taurus-Logger.html#taurus.Logger",color=dodgerblue1,fillcolor=white,fontcolor=black,fontname="Vera Sans, DejaVu Sans, Liberation Sans, Arial, Helvetica, sans",fontsize=10,height=0.5,shape=box,style=rounded,target="_top",tooltip="The taurus logger class. All taurus pertinent classes should inherit"]; "TangoDevice" [URL="#taurus.core.tango.TangoDevice",color=dodgerblue1,fillcolor=white,fontcolor=black,fontname="Vera Sans, DejaVu Sans, Liberation Sans, Arial, Helvetica, sans",fontsize=10,height=0.5,shape=box,style=rounded,target="_top",tooltip="A Device object representing an abstraction of the PyTango.DeviceProxy"]; "TaurusDevice" -> "TangoDevice" [arrowsize=0.5,style="setlinewidth(0.5)"]; "TaurusDevice" [URL="taurus.core.taurusdevice-TaurusDevice.html#taurus.core.taurusdevice.TaurusDevice",color=dodgerblue1,fillcolor=white,fontcolor=black,fontname="Vera Sans, DejaVu Sans, Liberation Sans, Arial, Helvetica, sans",fontsize=10,height=0.5,shape=box,style=rounded,target="_top",tooltip="A Device object. Different schemes may assign different roles, but"]; "TaurusModel" -> "TaurusDevice" [arrowsize=0.5,style="setlinewidth(0.5)"]; "TaurusModel" [URL="taurus.core.taurusmodel-TaurusModel.html#taurus.core.taurusmodel.TaurusModel",color=dodgerblue1,fillcolor=white,fontcolor=black,fontname="Vera Sans, DejaVu Sans, Liberation Sans, Arial, Helvetica, sans",fontsize=10,height=0.5,shape=box,style=rounded,target="_top"]; "Logger" -> "TaurusModel" [arrowsize=0.5,style="setlinewidth(0.5)"]; }

class TangoDevice(name='', **kw)

  A Device object representing an abstraction of the PyTango.DeviceProxy object in the taurus.core.tango scheme

  Import from `taurus.core.tango` as:

      from taurus.core.tango import TangoDevice

  addListener(listener)
  cleanUp()

    The cleanUp. Default implementation does nothing Overwrite when necessary

  property description
  eventReceived(event_src, event_type, event_value)
  getAttribute(attrname)

    Returns the attribute object given its name

  getDescription(**kwargs)

    Deprecated since version 4.0: Use .description instead

  getDeviceProxy()
  getDisplayDescrObj(cache=True)

    A brief description of the model. Can be used as tooltip, for example.

  getDisplayValue(**kwargs)

    Deprecated since version 4.0: Use .state.name instead

  getHWObj(**kwargs)

    Deprecated since version 4.0: Use getDeviceProxy() instead

  getLockInfo(cache=False)
  getSWState(**kwargs)

    Deprecated since version 4.0: Use state instead

  getState(**kwargs)

    Deprecated since version 4.0: Use .stateObj.read().rvalue [Tango] or .state [agnostic] instead

  getStateObj(**kwargs)

    Deprecated since version 4.0: Use .stateObj [Tango] or .factory.getAttribute(state_full_name) [agnostic] instead

  getValueObj(**kwargs)

    Deprecated by TEP14. ..warning:

        this bck-compat implementation is not perfect because the
        rvalue of the returned TangoAttributeValue is now a member of
        TaurusDevState instead of TaurusSWDevState

    Deprecated since version 4.0: Use state [agnostic] or stateObj.read [Tango] instead

  isValidDev(**kwargs)

    see: `TaurusDevice.isValid()`

    Deprecated since version 4.0: Use getDeviceProxy() is not None instead

  lock(force=False)
  poll(attrs, asynch=False, req_id=None)

    optimized by reading of multiple attributes in one go

  removeListener(listener)
  property state

    Reimplemented from `TaurusDevice` to use Tango’s state attribute for diagnosis of the current state. It supports a “cache” kwarg

    Parameters:

      cache (bool) – If True (default), cache will be used when reading the state attribute of this device

    Returns:

    Return type:

      TaurusDevState

  property stateObj
  unlock(force=False)