A device is an item in your lab automation system that has an entry in a VWorks software device file. A device can be a robot, an instrument, or a location in a lab automation system that can hold a piece of labware.
The device file (*.dev) stores information for all the devices in an integrated system, including:
• Type of device (for example, Bravo device)
• Device configuration information (for example, approach height, allowed or prohibited labware, and so on)
• Profile to use
VWorks Plus. The software logs audit trails for device files, which are records of interest.
If you are setting up the Bravo Platform for the first time, you will create a device file. You add the Bravo device and the external devices to the device file.
To create a device file:
1 In the VWorks window, select File > New > Device. A Device File tab appears.
2 Select File > Save to save the device file.
3 In the Save File As dialog box, select the storage location, type the file name, and then click Save.
4 VWorks Plus only. If an audit trail is being logged for records in the development state, the Audit Comment dialog box opens. Select or type the audit comment, and then click OK.
Before you begin:
• Ensure that any devices are physically networked to the computer.
• Turn on the devices.
To add devices to a device file:
1 In the VWorks window, verify that the correct device file is open.
To open a device file, choose File > Open > Device. In the Open File dialog box, locate and select your device file (*.dev), and then click Open.
2 In the Available Devices area, double-click the Agilent Bravo icon. Or, drag the icon to the Device File tab.
Note: To show or hide the list of available devices, choose View > Available Devices.
3 In the Device File tab, select the Agilent Bravo‑n icon.
4 Under Agilent Bravo Properties, type a Name for the device.
Note: By default, the software assigns Bravo‑n, and increments the number for each Bravo device that you add.
To identify the specific Bravo, you can include the device serial number in the device name.
5 In the Profile list, select a profile for the device.
If the Profile list is empty, open Bravo Diagnostics and create a profile. Then return to the Profile list under Bravo Properties and select the new profile.

To use different configurations of the same device in different protocols, you can save time by creating a different device file for each configuration. For example, if you change the liquid-handling head on your
Bravo Platform, you can simply open the device file that contains the device with the appropriate profile instead of editing the profile selection in the device file.
6 On the Device File tab, expand the Bravo device icon to show the list of deck locations, and then click the location 1 icon. The corresponding location properties appear.
Set the desired values for the following properties. Use the default values for the remaining properties.
Property | Description |
---|
Allowed/prohibited labware
| Optional. Click  if you want to specify labware restrictions for this location. The Allowed/prohibited labware dialog box appears. For details on the labware classes, see Creating and assigning labware classes. Note: If the  button is not visible, click the empty field. |
BCR on side | If a barcode reader is set up at this location, you specify the side. |
Teachpoint for robot <robot name> | If the device is integrated with an external robot, specify whether the robot can access this location. In Bravo Diagnostics, specify whether the Bravo head should move to a safe location or can perform operations at other deck locations concurrently. Carefully plan which locations the external robot can access. |
Teachpoint for robot Agilent Bravo | The Bravo deck location teachpoint identity. For example, the deck location 3 identity is 3. |
Use for deadlock avoidance | Option to permit the location to be used for deadlock avoidance. Select Yes to permit labware to be moved to this location to avoid a deadlock in the system. Select No if you do not want to move random labware to this location to avoid deadlock. |
Stack Height | Type the maximum height (mm) for a labware stack at this location. |

Do not change the default value of the Teachpoint for robot Agilent Bravo property. For example, the deck location 1 teachpoint identity is 1, the identity of deck location 2 is 2, and so forth.
Repeat this step for each deck location.
7 Select File > Save.
If you are creating a new device file, the Save File As dialog box appears so that you can specify a name and location for your device file.
Alternatively, you can select File > Save All to save the device file and the current protocol file at the same time.
VWorks Plus only. If an audit trail is being logged for records in the development state, the Audit Comment dialog box opens. Select or type the audit comment, and then click OK.

If an external robot will access the
Bravo deck, ensure that you carefully plan which locations can be accessed and where the
Bravo head can be during the external robot’s access. See
Configuring external robot access.