=============================
PoweredInterface Tango Device
=============================
The Tango interface provided by the :class:`~.future.PoweredInterface` device class.

Properties
----------
.. index::
	single: LoggingLevelDefault; PoweredInterface.LoggingLevelDefault

.. py:attribute:: LoggingLevelDefault
	:module: PoweredInterface

	Default logging level at device startup.

	:data type: DevUShort
	:default value: 4

.. index::
	single: LoggingTargetsDefault; PoweredInterface.LoggingTargetsDefault

.. py:attribute:: LoggingTargetsDefault
	:module: PoweredInterface

	Default logging targets at device startup.

	:data type: DevVarStringArray
	:default value: ['tango::logger']

Attributes
----------
.. index::
	single: State; PoweredInterface.State

.. py:attribute:: State
	:module: PoweredInterface

	The operational state of the device as enumeration.

	:access: READ
	:data type: DevState
	:data format: SCALAR

.. index::
	single: Status; PoweredInterface.Status

.. py:attribute:: Status
	:module: PoweredInterface

	More detailed textual information about the device's status.

	:access: READ
	:data type: DevString
	:data format: SCALAR

.. index::
	single: adminMode; PoweredInterface.adminMode

.. py:attribute:: adminMode
	:module: PoweredInterface

	The Admin Mode of the device.

	Set by a client to mark the device for science or only engineering.

	:access: READ_WRITE
	:data type: DevEnum
	:data format: SCALAR

.. index::
	single: buildState; PoweredInterface.buildState

.. py:attribute:: buildState
	:module: PoweredInterface

	Read the Build State of the device.

	:access: READ
	:data type: DevString
	:data format: SCALAR

.. index::
	single: commandedState; PoweredInterface.commandedState

.. py:attribute:: commandedState
	:module: PoweredInterface

	The last commanded Operating State of the device.

	Initial string is "None".  Only other strings it can change to is "OFF", "STANDBY" or "ON", following the Off(), Standby() or On() commands. If the state transition commands are long running commands the commanded state will only update when the long running command starts executing.

	:access: READ
	:data type: DevString
	:data format: SCALAR

.. index::
	single: healthInfo; PoweredInterface.healthInfo

.. py:attribute:: healthInfo
	:module: PoweredInterface

	Read the Health Info of the device.

	It provides an explanation for the currently reported Health State

	:access: READ
	:data type: DevString
	:data format: SPECTRUM
	:max_dim_x: 256

.. index::
	single: healthState; PoweredInterface.healthState

.. py:attribute:: healthState
	:module: PoweredInterface

	Read the Health State of the device.

	It interprets the current device condition and condition of all managed devices to set this.

	:access: READ
	:data type: DevEnum
	:data format: SCALAR

.. index::
	single: loggingLevel; PoweredInterface.loggingLevel

.. py:attribute:: loggingLevel
	:module: PoweredInterface

	Read the logging level of the device.

	Initialises to LoggingLevelDefault on startup.
	See :class:`~ska_control_model.LoggingLevel`

	:access: READ_WRITE
	:data type: DevEnum
	:data format: SCALAR

.. index::
	single: loggingTargets; PoweredInterface.loggingTargets

.. py:attribute:: loggingTargets
	:module: PoweredInterface

	Read the additional logging targets of the device.

	Note that this excludes the handlers provided by the ska_ser_logging
	library defaults - initialises to LoggingTargetsDefault on startup.

	:access: READ_WRITE
	:data type: DevString
	:data format: SPECTRUM
	:max_dim_x: 4

.. index::
	single: versionId; PoweredInterface.versionId

.. py:attribute:: versionId
	:module: PoweredInterface

	Read the Version Id of the device.

	:access: READ
	:data type: DevString
	:data format: SCALAR

Commands
--------
.. index::
	single: GetVersionInfo; PoweredInterface.GetVersionInfo

.. py:method:: GetVersionInfo() -> DevVarStringArray
	:module: PoweredInterface

	Get the version information of the device.

	:returns: The device class name and its package information.

.. index::
	single: Init; PoweredInterface.Init

.. py:method:: Init() -> DevVoid
	:module: PoweredInterface

	Reinitialise the Tango device.

.. index::
	single: On; PoweredInterface.On

.. py:method:: On() -> DevVarLongStringArray
	:module: PoweredInterface

	Turn the device on.

	:returns: [ResultCode][Status message or command ID]