1 0:00:00,00 --> 0:00:03,00 2 0:00:03,00 --> 0:00:09,13 The VWorks software uses different files and databases to run protocols, as this diagram shows. 3 0:00:09,13 --> 0:00:12,15 One of the files it needs is the device file. 4 0:00:12,15 --> 0:00:23,23 A device file contains the list of devices the software will communicate with and control, the communication settings for each device, and the configuration settings for each device. 5 0:00:23,23 --> 0:00:31,29 In this tutorial, I will walk you through basic steps of creating a device file and setting up different devices in the VWorks software. 6 0:00:31,29 --> 0:00:37,03 Let’s assume that in my lab, the devices are physically set up, as shown in this diagram. 7 0:00:37,03 --> 0:00:44,24 I have a BenchCel Workstation that consists of the BenchCel device, the Bravo Platform, and a Multidrop device. 8 0:00:44,24 --> 0:00:48,05 To create a device file, I need to follow these steps. 9 0:00:48,05 --> 0:00:52,27 First, I need to create a device file and add devices in the file. 10 0:00:52,27 --> 0:00:58,23 For each device, I will create a profile and set the communication and configuration parameters. 11 0:00:58,23 --> 0:01:04,13 During this step, I will also initialize the profile to establish communication with the device. 12 0:01:04,13 --> 0:01:12,05 If the device is a robot, I will set teachpoints so that the robot will know where to go to pick and place labware. 13 0:01:12,05 --> 0:01:19,03 Let’s begin. My first step is to create a device file and add the devices in the file. 14 0:01:19,03 --> 0:01:33,23 To create a device file, in the VWorks window, I'm going to click the File menu, select New, and then select Device. Notice that a new Device File tab appears. 15 0:01:33,23 --> 0:01:48,05 I want to save the file. So on the File menu, I'll select Save. I'll save the file in the default location, … 16 0:01:48,05 --> 0:01:54,09 and type a name for the new device file. In this example, I'll call it demo video. I'll click Save. Notice the name appears on the device file tab. 17 0:01:54,09 --> 0:01:57,15 And now I can add the devices to the device file. 18 0:01:57,15 --> 0:02:05,27 First, I'll locate the BenchCel device in the Available Devices area, then I'll double-click the BenchCel icon to add it to the device file. 19 0:02:05,27 --> 0:02:11,07 Notice the BenchCel icon appears in the device file, or demo video tab. 20 0:02:11,07 --> 0:02:21,12 Next, I want to add the Bravo device. I'll look for it in the Available Devices area, and then I'll drag it into the device file. That’s another way to add a device. 21 0:02:21,12 --> 0:02:29,05 Finally, because I don’t want to scroll through a large list of devices, I'll type Multidrop in the filter text box to locate it. 22 0:02:29,05 --> 0:02:35,14 As I type, the software starts to filter the list of available devices that match what I’ve typed so far. 23 0:02:35,14 --> 0:02:40,12 When Multidrop appears, I'll double-click the icon to add it to the device file. 24 0:02:40,12 --> 0:02:45,20 At this point, I have created a device file and finished adding all of the devices. 25 0:02:45,20 --> 0:02:51,26 I’m now ready to create a profile for each device and set the communication and configuration parameters. 26 0:02:51,26 --> 0:02:55,17 I want to create a profile for the Multidrop device first. 27 0:02:55,17 --> 0:03:04,19 So in my device file, I select the Multidrop device, and then click Device Diagnostics to open the Multidrop Diagnostics dialog box. 28 0:03:04,19 --> 0:03:15,09 Notice that I’m in the Profiles tab. To create a profile for the Multidrop device, in the Profiles tab, I'll click Create a new profile, type a name for the profile 29 0:03:15,09 --> 0:03:23,17 (in this example, I will call it multidrop), and click OK. The new profile name appears in the Profile Management area. 30 0:03:23,17 --> 0:03:31,18 To set up communication with the multidrop, I'll select the COM port I am using to connect the Multidrop with the computer running the VWorks software. 31 0:03:31,18 --> 0:03:37,19 In this example, the Multidrop is connected to the COM1 port on the controlling computer. 32 0:03:37,19 --> 0:03:44,25 Next, I'll select the Multidrop model that I’m using. In this example, I’m using the Multidrop 384. 33 0:03:44,25 --> 0:03:53,25 The Multidrop 384 only permits me to select the Prime option. In this example, I want to prime the device every time it is initialized. 34 0:03:53,25 --> 0:03:58,16 So I'll select the option, and use the default priming volume. 35 0:03:58,16 --> 0:04:03,28 I’m finished with the profile, so I'll click Update this profile to save the changes. 36 0:04:03,28 --> 0:04:08,29 To establish communication with the Multidrop device, I'll click Initialize this profile. 37 0:04:08,29 --> 0:04:18,25 If, at this point, I get an error message about no response from the device, it is probably because the device is not connected to the controlling computer, or it is connected to 38 0:04:18,25 --> 0:04:27,10 the wrong COM port. I can fix these easily, and then click Retry in the error message dialog box to initialize communication. 39 0:04:27,10 --> 0:04:35,11 I can also get this type of error message if I’m in simulation mode. In this case, I can click Ignore in the error dialog box. 40 0:04:35,11 --> 0:04:41,12 The device initialization is successful, so I'll click OK to return to the VWorks window. 41 0:04:41,12 --> 0:04:50,13 To make sure the Multidrop device is using the correct profile, I'm going to select the profile I just created, here in the Multidrop Properties area. 42 0:04:50,13 --> 0:04:53,16 And now I’ll create a profile for the Bravo device. 43 0:04:53,16 --> 0:05:02,27 To do that, I am going to select the Bravo device in my device file, and then click Device diagnostics to open the Bravo Diagnostics dialog box. 44 0:05:02,27 --> 0:05:14,13 In the Profiles tab, I'll click Create a new profile, type a name for the profile (in this example, I will call it 384ST, because that’s the pipette head I’ll be using), 45 0:05:14,13 --> 0:05:21,03 and click OK. The new profile name appears in the Profile Management area. 46 0:05:21,03 --> 0:05:30,08 Now I need to select a pipette head. In this example, I’m using the 384ST Series III head, so I'll select that one. 47 0:05:30,08 --> 0:05:40,14 As soon as I select a pipette head, the software displays a message to warn me that I’ve changed the head type and that other profile settings are affected by this change. 48 0:05:40,14 --> 0:05:46,24 I want to use the default settings appropriate for the pipette head I selected, so I'll click Yes. 49 0:05:46,24 --> 0:05:58,29 Next, because I’m using disposable tips, I can select a teaching tip. In this example, I am going to use the default 30-uL tip for teaching. 50 0:05:58,29 --> 0:06:05,01 In addition, I want to check head type during initialization, so I will leave the default selection alone. 51 0:06:05,01 --> 0:06:09,21 To set up communication with the Bravo device, I'll go to the Connection area. 52 0:06:09,21 --> 0:06:17,28 I know my Bravo device is connected via Ethernet, so I'll select that, and click Find available device to locate it in the network. 53 0:06:17,28 --> 0:06:25,24 In the Discover BioNet Devices dialog box that appears, I'll select the network card that the Bravo device is connected to. 54 0:06:25,24 --> 0:06:31,22 In this example, I know the Bravo device is connected to the Broadcom card, so I'll select it. 55 0:06:31,22 --> 0:06:41,29 The list of devices on that Broadcom network appears above. I'll look for and select the Bravo device I want in the list, based on its MAC address, which I know. 56 0:06:41,29 --> 0:06:49,08 Note that to successfully communicate with the robot, the device must show New or Matched in the Status column. 57 0:06:49,08 --> 0:06:52,19 I'll click OK to return to Bravo Diagnostics. 58 0:06:52,19 --> 0:06:58,21 Notice the Bravo ID appears in the box. In this example, my Bravo is called 0. 59 0:06:58,21 --> 0:07:04,29 For the remaining parameters in the Miscellaneous area, I’ll go ahead and use the default selections and values. 60 0:07:04,29 --> 0:07:09,08 For a description of these parameters, see the Bravo Platform User Guide. 61 0:07:09,08 --> 0:07:14,20 I finished setting up the profile, so I'll click Update this profile to save the changes. 62 0:07:14,20 --> 0:07:20,01 And to establish communication with the Bravo device, I'll click Initialize this profile. 63 0:07:20,01 --> 0:07:24,17 At this point, I need to set a teachpoint at each deck location. 64 0:07:24,17 --> 0:07:32,03 Let’s assume I’ve done that by following the instructions in the Bravo Platform User Guide, and I just updated the profile and initialized. 65 0:07:32,03 --> 0:07:36,03 So I can click OK to return to the VWorks window. 66 0:07:36,03 --> 0:07:44,07 To make sure the Bravo device is using the correct profile, I'm going to select the profile I just created, here in the Bravo Properties area. 67 0:07:44,07 --> 0:07:48,01 Lastly, I’ll create a profile for my BenchCel device. 68 0:07:48,01 --> 0:07:57,20 To do that, I'm going to select the BenchCel device in my device file, and then click Device diagnostics to open the BenchCel Diagnostics dialog box. 69 0:07:57,20 --> 0:08:09,19 In the Profiles tab, I'll click Create a new profile, type a name for the profile (for example, I will call it BenchCel 6R, because the device I’m using has 6 stacker heads), 70 0:08:09,19 --> 0:08:15,05 and click OK. The new profile name appears in the Profile Management area. 71 0:08:15,05 --> 0:08:19,28 To set up communication with the BenchCel device, I'll go to the Settings area. 72 0:08:19,28 --> 0:08:28,22 I know my BenchCel device is connected via Ethernet, so I'll select that, and click Find available device to locate it in the network. 73 0:08:28,22 --> 0:08:36,16 In the Discover BioNet Devices dialog box that appears, I'll select the network card that the BenchCel device is connected to. 74 0:08:36,16 --> 0:08:42,05 In this example, I know the BenchCel device is connected to the Realtek card, so I'll select it. 75 0:08:42,05 --> 0:08:49,27 The list of devices on that Realtek network appears above. I'll look for and select the BenchCel device I want in the list. 76 0:08:49,27 --> 0:08:59,08 In this case, there is only one BenchCel device, and it has the Matched status. Also, I know this is the correct one, because I know its MAC address. 77 0:08:59,08 --> 0:09:10,29 I'll click OK to return to BenchCel Diagnostics. Notice the BenchCel ID appears in the box. In this example, my BenchCel device is called BenchCel6R. 78 0:09:10,29 --> 0:09:18,19 Next, I'll select the number of stacks. In this example, my BenchCel device has 6 stacks, so I'll select 6. 79 0:09:18,19 --> 0:09:29,02 For robot devices, whenever you create a new profile, a new teachpoint file is created, and its file name and location is shown in the Teachpoint File area. 80 0:09:29,02 --> 0:09:40,14 The teachpoint file name is always called Teachpoints, with the profile name as its suffix. In this example, the new teachpoint file name is Teachpoints_benchCel6R. 81 0:09:40,14 --> 0:09:47,27 For now, this new teachpoint file contains only the factory-set stacker coordinates. It does not contain other teachpoint information. 82 0:09:47,27 --> 0:09:50,01 I’ll set the teachpoints in a minute. 83 0:09:50,01 --> 0:09:55,07 I finished setting up the profile, so I'll click Update this profile to save the changes. 84 0:09:55,07 --> 0:10:04,11 And to establish communication with the BenchCel device, I'll click Initialize this profile. 85 0:10:04,11 --> 0:10:08,22 At this point, I have created a device file and added the devices, 86 0:10:08,22 --> 0:10:11,21 and created a profile for each device. 87 0:10:11,21 --> 0:10:21,10 Because the BenchCel device is the robot in the workstation, I need to teach the robot, or set teachpoints, so it knows where to pick up and place labware. 88 0:10:21,10 --> 0:10:28,12 To set teachpoints, I will use the commands and parameters in the BenchCel Diagnostics Controls tab. 89 0:10:28,12 --> 0:10:36,04 Before I begin, I must physically load the labware I want to use for the teaching process in BenchCel Stacker 1. 90 0:10:36,04 --> 0:10:40,27 Let’s say I’ve done that, and now I’m ready to set the teachpoints. 91 0:10:40,27 --> 0:10:44,06 In BenchCel Diagnostics, I'll go to the Controls tab. 92 0:10:44,06 --> 0:10:52,20 Notice that there is a graphical representation of the BenchCel device that shows the robot’s current position and the status of all 6 stacks. 93 0:10:52,20 --> 0:10:57,22 The first thing I want to do is select the labware I am using for the teaching process. 94 0:10:57,22 --> 0:11:06,00 In this example, the labware I loaded in Stacker 1 is the 384 Greiner flat-bottom labware. So I'll select it. 95 0:11:06,00 --> 0:11:32,11 Next, I want the robot to hold the labware that is currently in Stacker 1. So at Stacker 1, I'll select Load Labware, and then select Downstack from Stacker 1. 96 0:11:32,11 --> 0:11:42,18 Then I'll click Go home to move the robot to its home position. 97 0:11:42,18 --> 0:11:57,28 I want to disable the X and Theta motors so that I can manually move the robot around. So I'll clear the check boxes for X and Theta. 98 0:11:57,28 --> 0:12:08,02 Now I can physically move the robot to the first teachpoint. In this example, I will set the teachpoint at the Bravo device first. It’s to the left of the BenchCel device. 99 0:12:08,02 --> 0:12:18,27 At the Bravo device, I'll position the BenchCel robot arms so that the microplate they're holding rests on deck location 9. Then I'll click New teachpoint. 100 0:12:18,27 --> 0:12:26,08 In the Teachpoint Details dialog box that appears, I'll type a name for the teachpoint. In this example, I'll call it bravo. 101 0:12:26,08 --> 0:12:35,09 Then I'll click Use current positions to record the BenchCel robot’s coordinates. Notice the coordinate values appear for Theta, X, and Z. 102 0:12:35,09 --> 0:12:38,04 I’ll go ahead and click Save and Exit. 103 0:12:38,04 --> 0:12:42,15 A new teachpoint called bravo appears in the graphical display area. 104 0:12:42,15 --> 0:12:47,04 Now I want to set a teachpoint at the Multidrop device. So I’ll do the same thing. 105 0:12:47,04 --> 0:13:04,14 I'll physically move the BenchCel robot to the Multidrop device and position the robot so that the microplate rests on the Multidrop plate stage. 106 0:13:04,14 --> 0:13:06,24 I'll click New teachpoint. 107 0:13:06,24 --> 0:13:14,00 In the Teachpoint Details dialog box that appears, I'll type a name for the teachpoint. This time, I'll call it multidrop. 108 0:13:14,00 --> 0:13:20,26 Then I'll click Use current positions to record the BenchCel robot’s coordinates. Notice the red Theta value. 109 0:13:20,26 --> 0:13:25,17 This means the robot is out of its Theta range, so I need to adjust it slightly. 110 0:13:25,17 --> 0:13:32,12 After making some adjustments at the teachpoint, I'll click Use current positions. Now the value is OK. 111 0:13:32,12 --> 0:13:42,28 I’ll go ahead and click Save and Exit. The multidrop teachpoint appears in the graphical display area. 112 0:13:42,28 --> 0:13:46,11 I want to home the robot so I'll click Go home. 113 0:13:46,11 --> 0:13:54,12 I’m getting this message because I turned off the Theta- and X-axis motors earlier. To home the robot, the motors have to be turned on. 114 0:13:54,12 --> 0:14:00,27 So I'll click Yes to turn them back on. And the robot moves to its home position. 115 0:14:00,27 --> 0:14:05,01 I finished setting the teachpoints, so I can put the labware away now. 116 0:14:05,01 --> 0:14:11,02 At Stacker 1, I'll select Upstack to Stacker 1. The robot upstacks the labware. 117 0:14:11,02 --> 0:14:18,29 Then I'll click Go home to home the robot. 118 0:14:18,29 --> 0:14:29,15 Now I need to save the changes. So I'll click the Profiles tab, and then click Update this profile. 119 0:14:29,15 --> 0:14:32,27 I'll click OK to return to the VWorks window. 120 0:14:32,27 --> 0:14:42,22 In the BenchCel Properties area, I'll select the profile I just created, which is benchCel 6R. 121 0:14:42,22 --> 0:14:48,11 And now I want to save the device file. I'll click the Save File icon on the toolbar. 122 0:14:48,11 --> 0:14:56,01 Lastly, I'll click Initialize all devices to establish communication with all of the devices in the device file. 123 0:14:56,01 --> 0:15:05,14 I have finished setting the teachpoints. Now the BenchCel teachpoint file contains the factory-set stacker teachpoints as well as the new bravo and multidrop teachpoints. 124 0:15:05,14 --> 0:15:14,11 Next, I must associate each teachpoint in the teachpoint file with the correct device in the device file. So I’ll start with the BenchCel device. 125 0:15:14,11 --> 0:15:22,11 Let me expand the BenchCel device and select Stacker 1. 126 0:15:22,11 --> 0:15:29,27 For Teachpoint for robot BenchCel – 1, I'll select Stacker 1 from the list of existing teachpoints in the teachpoint file. 127 0:15:29,27 --> 0:15:35,22 So the factory-set Stacker 1 teachpoint is now associated with the Stacker 1 device. 128 0:15:35,22 --> 0:15:45,04 For Stack Height, I will use the 460 selection as shown, because the maximum height of my BenchCel stacker racks are 460 mm. 129 0:15:45,04 --> 0:15:50,27 Note that I will use the default selection for deadlock avoidance, and the other properties do not apply. 130 0:15:50,27 --> 0:15:54,24 I will do the same for the remaining BenchCel Stackers, 2 through 6. 131 0:15:54,24 --> 0:16:04,02 I'll select Stacker 2 and set the properties like I did for the first stacker. 132 0:16:04,02 --> 0:16:12,22 Stacker 3. 133 0:16:12,22 --> 0:16:20,15 Stacker 4. 134 0:16:20,15 --> 0:16:28,03 Stacker 5. 135 0:16:28,03 --> 0:16:36,21 And finally, stacker 6. 136 0:16:36,21 --> 0:16:44,23 Next, I’ll associate the bravo teachpoint I set earlier with the correct Bravo deck location. So I'll expand the Bravo device. 137 0:16:44,23 --> 0:16:57,24 There are 9 Bravo deck locations. When I set the teachpoint at the Bravo earlier, I set it at location 9. So I will select 9. 138 0:16:57,24 --> 0:17:06,05 For Teachpoint for robot BenchCel – 1, I'll select bravo from the list of existing teachpoints in the teachpoint file. 139 0:17:06,05 --> 0:17:13,20 In my workstation setup, I don’t have a barcode reader at deck location 9. So I am not going to set these barcode properties. 140 0:17:13,20 --> 0:17:21,16 I will use the default selection for deadlock avoidance, and the remaining properties do not apply. So I’m done with the Bravo device. 141 0:17:21,16 --> 0:17:27,00 Finally, I’ll associate the multidrop teachpoint I set earlier with the multidrop plate stage. 142 0:17:27,00 --> 0:17:30,17 First, I'll expand the multidrop device and select the Stage. 143 0:17:30,17 --> 0:17:38,02 For Teachpoint for robot BenchCel – 1, I'll select multidrop from the list of existing teachpoints in the teachpoint file. 144 0:17:38,02 --> 0:17:45,17 In my workstation setup, I don’t have a barcode reader at the Multidrop plate stage. So I am not going to set the barcode properties. 145 0:17:45,17 --> 0:17:50,16 I will use the default selection for deadlock avoidance, and the Door property does not apply. 146 0:17:50,16 --> 0:17:52,24 So I’m done with the device file. 147 0:17:52,24 --> 0:18:01,09 Before I do anything else, I better save the device file. To do that, I'll click the Save icon on the toolbar. The file is now updated. 148 0:18:01,09 --> 0:18:05,07 I can now use the device file to run my protocols. 149 0:18:05,07 --> 0:18:08,14