2.16.2.1.10 Device icon element

The device icon display element represents a device in the M&C user interface. It displays the status of the device by it's color/shape and gives access to the device details panel panel for this particular device by a mouse click.

The attributes listed below may be configured to customize a display element of this type:

• Device name: The name of the device this element stands for.
• Icon: Selects the device icon / image from dropdown list to display. Once you selected the icon preview will be displayed below the icon input field. The sat-nms software at least provides three predefined icons for this purpose:
  • : device-rectangle.gif
  • : device-square.gif
  • : device-minirect.gif
• Privilege level: The privilege level necessary to change this parameter. The predefined screens of the software use 100. In your own screens you may set certain parameters to higher privilege levels, limiting the group of operators permitted to change the parameter.
• Show device name: Check this checkbox to display the name of the device as a label in the icon. Unchecked can be useful if very small icons are used in which the label would not fit, or if a label is to be used that is different from the name of the device.
• Font: Font contains two options:
  • Font: The font attribute applies to the text shown in the parameter field itself. The label text is shown with the standard ("plain") font size for all font selections except the smallest one. In the latter case the label is drawn using this small font size, too.
  • Color: The color attribute of a parameter element sets the color of the label shown above the entry field. The text in the parameter field itself always is shown in the default text color of the selected look & feel. Colors may be specified by using a hexadecimal RGB notation. You may click to the color example field in order to open a color chooser dialog and select the color from there.
• Signal if device actually is redundant: Check this checkbox to apply a special coloring for devices which are in the redundant signal path of a redundancy switching facility.
  • Redundancy signal ID: The message ID of a parameter which gives the information if the device actually operates as the redundant one or if it is operational. For a 1:1 TWTA redundancy this could be the position parameter of the waveguide switch which selects the signal from the two TWTAs
  • Redundancy signal value: If the value of the parameter addressed by above message ID matches the value given in this field, the device icon is shown as "redundant" (depends in the icon set used, the factory icon sets use a blue background color for this).

Using customized images

You may supply your own images for the device icon display element. To do so, place seven images into the ./images directory named "xxxxx.gif", "xxxxx-F.gif" (fault), "xxxxx-C.gif" (communication fault), "xxxxx-S.gif (fault suppressed)", "xxxxx-R.gif" (redundant), "xxxxx-O.gif" (out of service) and "xxxxx-M.gif" (maintenance). You should consider the following:

• All images should be of the same size.
• The software places the device name at the lower left corner of the image using the selected font and color. All four images should use appropriate colors in this area to keep the device name visible.
• Beside GIF-images the software also accepts PNG images (file extension .png) and JPG images (file extension .jpg). All images of a set must be of the same type (GIF/PNG/JPG).

Using a customized 'transmitting' emblem

For devices which provide the 'info.signal.on' parameter to report that the device is actually transmitting or receiving, the device icon shows an emblem at it's upper right corner. The software uses the 'signal-on-emblem.png' image as a default for this.

You may define individual emblems for each image set by placing a "xxxxx-X.gif" (or .png/.jpg) image in the ./images folder with xxxxx being the base name of the device icon. The software will use this file for the transmitting emblem of this particular icon set. The file extension of the emblem must match the extension of the base icon image.