Tango Device Server User's Guide

|  |  |  |  | ## TANGO Device Server

# Starter for Tango Administration
Device Commands Description
Starter Class

Revision: - Author: verdier

## 1 - Init

- Description: This commands re-initialise a device keeping the same network connection.
  After an Init command executed on a device, it is not necessary for client to re-connect to the device.
  This command first calls the device delete_device() method and then execute its init_device() method.
  For C++ device server, all the memory allocated in the nit_device() method must be freed in the delete_device() method.
  The language device desctructor automatically calls the delete_device() method.
- Argin:
  DEV_VOID : none.
- Argout:
  DEV_VOID : none.
- Command allowed for:
  - Tango::UNKNOWN
  - Tango::ON
  - Tango::ALARM
  - Tango::MOVING

## 2 - State

- Description: This command gets the device state (stored in its device_state data member) and returns it to the caller.
- Argin:
  DEV_VOID : none.
- Argout:
  DEV_STATE : State Code
- Command allowed for:
  - Tango::UNKNOWN
  - Tango::ON
  - Tango::ALARM
  - Tango::MOVING

## 3 - Status

- Description: This command gets the device status (stored in its device_status data member) and returns it to the caller.
- Argin:
  DEV_VOID : none.
- Argout:
  CONST_DEV_STRING : Status description
- Command allowed for:
  - Tango::UNKNOWN
  - Tango::ON
  - Tango::ALARM
  - Tango::MOVING

## 4 - DevStartAll

- Description: Start all device servers controlled on the host for the argin level.
- Argin:
  DEV_SHORT : Startup level.
- Argout:
  DEV_VOID :
- Command allowed for:
  - Tango::UNKNOWN
  - Tango::ON
  - Tango::ALARM
  - Tango::MOVING

## 5 - DevStopAll

- Description: Stop all device servers controlled on the host for the argin level.
- Argin:
  DEV_SHORT : Startup Level.
- Argout:
  DEV_VOID :
- Command allowed for:
  - Tango::UNKNOWN
  - Tango::ON
  - Tango::ALARM
  - Tango::MOVING

## 6 - DevGetRunningServers

- Description: Control the running process from property list. And return the list of the processes which are really running.
- Argin:
  DEV_BOOLEAN : True for all servers. False for controlled servers only.
- Argout:
  DEVVAR_STRINGARRAY : List of the processes which are running.
- Command allowed for:
  - Tango::UNKNOWN
  - Tango::ON
  - Tango::ALARM
  - Tango::MOVING

## 7 - DevGetStopServers

- Description: Control the running process from property list. And return the list of the processes which are not running.
- Argin:
  DEV_BOOLEAN : True for all servers. False for controlled servers only.
- Argout:
  DEVVAR_STRINGARRAY : List of the processes which are not running.
- Command allowed for:
  - Tango::UNKNOWN
  - Tango::ON
  - Tango::ALARM
  - Tango::MOVING

## 8 - DevStart

- Description: Start the specified server.
- Argin:
  DEV_STRING : Server to be started.
- Argout:
  DEV_VOID :
- Command allowed for:
  - Tango::UNKNOWN
  - Tango::ON
  - Tango::ALARM
  - Tango::MOVING

## 9 - DevStop

- Description: Stop the specified server.
- Argin:
  DEV_STRING : Servero be stopped.
- Argout:
  DEV_VOID :
- Command allowed for:
  - Tango::UNKNOWN
  - Tango::ON
  - Tango::ALARM
  - Tango::MOVING

## 10 - DevReadLog

- Description: At server startup, its standard error is redirected to a log file. This command will read this file and return the read string from the file.
- Argin:
  DEV_STRING : server name and domain
- Argout:
  CONST_DEV_STRING : ig Starter/corvus)
- Command allowed for:
  - Tango::UNKNOWN
  - Tango::ON
  - Tango::ALARM
  - Tango::MOVING

## 11 - HardKillServer

- Description: Hard kill a server (kill -9)
- Argin:
  DEV_STRING : Server name
- Argout:
  DEV_VOID :
- Command allowed for:
  - Tango::UNKNOWN
  - Tango::ON
  - Tango::ALARM
  - Tango::MOVING

## 12 - NotifyDaemonState

- Description: Returns the Notify Daemon state.
- Argin:
  DEV_VOID :
- Argout:
  DEV_STATE : Tango::ON if Notify daemon is running else Tango::FAULT.
- Command allowed for:
  - Tango::UNKNOWN
  - Tango::ON
  - Tango::ALARM
  - Tango::MOVING

## 13 - UpdateServersInfo

- Description: Indicate to the device server than the information about servers to be controlled has been modified. The device server must read the database to update the servers info list. If the default case, this command is sent by Database server itself.
- Argin:
  DEV_VOID :
- Argout:
  DEV_VOID :
- Command allowed for:
  - Tango::UNKNOWN
  - Tango::ON
  - Tango::ALARM
  - Tango::MOVING

TANGO is an open source project hosted by : | Core and Tools : CVS repository on tango-cs project Device Servers : CVS repository on tango-ds project