1.0 GETTING STARTED
This document describes how to create and edit a device definition.
A device is the underlying object which one must define prior to define anything else such as fixture, device interface board, device pins or device control definitions. When creating a device, one must specify the device family which ties all definitions together. The device family also ties the test plan to the device object.
This documents assumes you have launched the Device Connection Editor. Refer to the the Device Connection Editor User's Guide for details of launching the Device Connection Editor.
2.0 DEVICE CONNECTION WINDOW
A device definition only contains attributes. The only area which is of importance for a device is the very top one, the attributes.
2.1 SELECTING DEVICE TAB PAGE
For creating and editing device, make sure you are on the device page by clicking the Device tab.
2.2 CREATING A NEW DEVICE
To create a new device, click on the Dev Conn > New Device... menu.
Device Title is the title of the device. It is used for device selection.
Device Family is used to tag all items that are related to the device. This tends to be very generic as it is used to filter choices to those related to the currently loaded device. Different variants of the device are identified by its Device Title.
Category is used for organizing the Guru objects. The categories must exist; one can create a new category by using the Guru Permissions Admin application.
Version is intended to be a revision number, typically 1.0, 1.1, etc.
For the Status field, the choices are alpha, beta, or released. alpha devices are in the initial stage of development, beta is intended for devices that are almost ready for production, and released devices are ready for production.
When done with entering the fields, click the OK button and the newly created device is available in Guru and displayed in the Device page.
2.3 LOADING AN EXISTING DEVICE
To load a device for viewing or editing, click on the Dev Conn > Load Device... menu to see a list of available devices in Guru.
Select the device to load, then click the OK button or double click on the selection to display the selected device in the Device page.
2.4 EDITING A DEVICE
A device only has device attributes which are displayed in the Device Attributes section of the Device Connection Editor window.
The following is a list of reserved keywords for device attributes.
category -- is used to organize the Guru objects.
device family -- is used to tag all items that are related to the device.
status -- status of the device (alpha, beta, or released).
title -- is used for device selection.
version -- is intended to be a revision number, typically 1.0, 1.1, etc.
2.4.1 ATTRIBUTES
Once a device is loaded, you can modify the contents of the device. The attributes section can contain any information the user would like to use to organize devices. Select the attribute row which you want to modify from the display, then click with the right mouse button (RMB) to see the options to edit, add, copy, or delete an attribute.
2.4.1.1 EDIT
The Edit menu allows you to edit a value of the selected attribute row. First, select a row, then RMB and select the Edit menu. There are two possibilities of edit window. For some attributes, the edit window shows a drop down list of values to choose or allows a new value to be entered. The following window is an example when you edit the "device family" attribute and it gives you a list of the available selections from Guru.
Other attributes require a typed in text value.
You can either select from the list or type in a new Value. When done modifying the Value field, click the OK button and the new value is displayed in the Device Connection Editor window.
2.4.1.2 ADD
The Add menu allows you to add a new attribute entry. To add an attribute, RMB and select the Add menu.
When done entering the Name and Value fields, click the OK button and the new value is displayed in the Device Connection Editor window.
2.4.1.3 COPY ROW
The Copy Row menu allows you to add a new attribute entry. Instead of starting with blank window where you type in both the Name and Value fields, it copies the information of the selected row to the edit window. You can modify the Name and Value fields. The currently selected row's Name and Value are displayed in the Copying/Adding Device Attribute window.
When done changing the Name and/or Value fields, click the OK button.
2.4.1.4 DELETE
The Delete menu allows you to remove an attribute entry. To delete an attribute, select the row which you want to remove, RMB and select Delete.
It asks you to confirm the deletion process.
Click the Yes button if you really want to delete the attribute; click the No button if you want to cancel the deletion process.
2.5 SAVING A DEVICE
When done making the changes, save the device by clicking the Dev Conn > Save Device menu.
It asks you to enter the Version and select a Status and click the OK button to save the device to Guru.
2.6 COPYING A DEVICE
Once the device is loaded, you can modify any of the attribute entries. When you're done modifying it, you can save it as a different device by selecting the Dev Conn > Save Device As... menu.
Since title is used for selections, it is preferred that title is used for the key differentiator. You can change the Title, Device Family, Category, Version, and/or Status fields. Click the OK button to save the device and the newly saved device is displayed in the Device Connection Editor window.
3.0 HANDS-ON
This section goes thru some exercises for device.
3.1 CREATING A NEW DEVICE
Create a new device with Device Title of ExampleDevice001, Device Familyof ExampleDevice001, Category of RI_DEMO, Versionof 1.0, and Statusof alpha.
3.2 LOADING A DEVICE
Load an existing device, such as, ExampleDevice001, all duts, etc.
3.3 EDITING A DEVICE
3.3.1 ADD ATTRIBUTE
Load the ExampleDevice001 device. Add an attribute called newAttr01 with value of newValue01.
3.3.2 EDIT ATTRIBUTE
Select the attribute newAttr01 and update the value to newValue03.
3.3.3 COPY ATTRIBUTE
Then, copy this new attribute to a different attribute copyAttr01 and value of newValue02.
3.3.4 DELETE ATTRIBUTE
Delete the newAttr01 attribute.
Then save the device.
3.4 SAVING A DEVICE
After completing the above tasks, save the device.
3.5 COPYING A DEVICE
Copy the ExampleDevice001 device to LabDevice002 and change the Device Family to LabDevice002.
6.0 REFERENCE
Refer to Device Connection Editor User's Guide for detail of the Device Connection Editor.