Skip to content

User Guide

Ingvord edited this page May 3, 2018 · 14 revisions

User Guide

//TODO explain interface

How tos...

Add new Tango host

  1. Open Settings tab
  2. In the Tango host widget type new tango host {host}:{port}
  3. Click on + button

NOTE Devices tree updates when new tango_host is added

Add devices to Tango host

  1. Open Settings tab
  2. In the Tango Server Wizard widget fill in the required data

TODO image

NOTE Tango host must be selected prior adding devices, just click on the desired Tango host in Tango hosts widget

  1. In the Tango Server Wizard widget fill in the required data
  2. Click Create new Tango devices... button

NOTE Devices tree updates when new tango_host is added

Set devices filters

  1. Open Settings tab

  2. Set desired Tango devices filter e.g. "sys//" or "sys/tg_test/*"

  3. Click Apply filters button

Devices filter

NOTE this filter affects the way TangoWebapp fetches devices from the Tango REST server i.e. it fetches only non-filtered devices.

NOTE this filter may contain several values, they will be merged

How to filter Devices tree

Devices tree filter is just a simple text filter that filters the tree by the text e.g. "sys" or "tg". This does not affect interaction with the server.

Devices tree switch to device tree (attrs, cmds, pipes)

  • Add attr to dashboard

Dashboard

  • filter
  • remove
  • plot
  • is updated only when visible
  • limitation devices number ??? (~10)
  • status icon
  • readonly (writing attributes in device control panel);
  • device control panel updates automatically when attribute is selected in the list

Devices tree context menu

Device monitor

  • different from dashboard - all attributes of the device all ready added

Device properties view

  • describe each in two words
  • update attributes config (requires)

Device control panel

  • header (device name + exported)
  • filter by content
  • execute command
  • read/write/plot attribute
  • read pipe

bottom toolbar

  • request status
  • user log
  • application log
  • github

top toolbar

  • user name (opens settings)
  • log out

Advanced features

Change Tango REST API URL

  1. Open Settings tab

Scripting console

read attribute

return PlatformContext.rest.fetchHost('localhost:10000')
  .then(host => host.fetchDevice('sys/tg_test/1'))
  .then(device => device.fetchAttr('double_scalar'))
  .then(attr => attr.read())
  .then(value => value.value)