diff --git a/docs/flex/docs/images/camera-default.png b/docs/flex/docs/images/camera-default.png new file mode 100644 index 00000000000..79ded1f7062 Binary files /dev/null and b/docs/flex/docs/images/camera-default.png differ diff --git a/docs/flex/docs/images/camera-location.png b/docs/flex/docs/images/camera-location.png new file mode 100644 index 00000000000..8e5cbd5718a Binary files /dev/null and b/docs/flex/docs/images/camera-location.png differ diff --git a/docs/flex/docs/images/robot-details.png b/docs/flex/docs/images/robot-details.png new file mode 100644 index 00000000000..2814f1398d0 Binary files /dev/null and b/docs/flex/docs/images/robot-details.png differ diff --git a/docs/flex/docs/opentrons-app.md b/docs/flex/docs/opentrons-app.md index ca955004a25..8d68d4ab0d4 100644 --- a/docs/flex/docs/opentrons-app.md +++ b/docs/flex/docs/opentrons-app.md @@ -97,6 +97,38 @@ Click the three-dot menu (⋮) on the module card to choose from available comma | **Temperature** | | | **Thermocycler** | | +## Camera features and controls + +Every Flex comes equipped with a built-in 2-megapixel camera that can capture full HD still images and provides video of the deck and working area. Starting in robot software version 8.8, you can control the camera in the Opentrons App and from the touchscreen. When enabled, the camera provides: + +- Live, in-app monitoring during protocol runs. +- Automatic image capture at protocol-defined intervals. +- Automatic image capture in response to a crash or runtime error. +- The ability to download all still images in a single, compressed file (`.zip` format) after a protocol run. + +### Controls + +The camera is turned off by default. To turn on the camera and access its features: + +
+ +1. From the Opentrons App, click **Devices** and locate your robot. +2. For your selected robot, click the three-dot menu (⋮) and then click **Robot settings**. +3. Click the **Camera** tab to open the camera settings. +4. Click the Camera slider to enable or disable the camera. + +
+ +You can also see the camera's status, and turn it on and off, from the Peripherals section of the details page for your Flex. Click the three-dot menu (⋮) to enable or disable the camera. This example shows a Flex with its camera enabled. + +
+ ![Details page showing enabled camera](./images/robot-details.png) +
+ +### Downloading images + +All protocol images are available for download in the Recent Protocol Runs section of the robot details page. + ## Recent protocol runs The robot details page lists up to 20 recent protocol runs. This provides additional information compared to the touchscreen, which only shows the most recent run for each unique protocol. @@ -114,4 +146,6 @@ Each entry in the recent protocol runs list includes the protocol name, its time !!! note If you need to maintain a comprehensive record of all runs performed on your Flex, you must use the **Download run log** feature to save this information to your computer. +- **Download image files:** Save to your computer a `.zip` file containing all the still images taken during a protocol run, if the camera was enabled. + Flex *will not* retain information about more than 20 runs on the robot. Proceeding to the Run Setup screen generates an entry in the list and counts towards the maximum of 20 runs, even if you never begin the protocol. diff --git a/docs/flex/docs/system-description/robot.md b/docs/flex/docs/system-description/robot.md index b277c5d0bdf..54ded54e9ae 100644 --- a/docs/flex/docs/system-description/robot.md +++ b/docs/flex/docs/system-description/robot.md @@ -13,7 +13,7 @@ The *frame* of the Opentrons Flex robot provides rigidity and structural support The metal frame has openings for *side windows* and a *front door* made of transparent polycarbonate that let you see what's going on inside Flex. The front door hinges open for access to the interior of the system. With the front door open, you can attach instruments, modules, and deck fixtures; prepare the deck before a protocol; or manipulate the state of the deck during a protocol. -White LED strips on the inside top edges of the frame provide software-controllable ambient lighting. A 2-megapixel camera can photograph the deck and working area for recording and tracking protocol execution. +White LED strips on the inside top edges of the frame provide software-controllable ambient lighting. A 2-megapixel camera can [photograph the deck](../opentrons-app.md#camera-features-and-controls) and working area for recording and tracking protocol execution. ## Deck and working area @@ -66,6 +66,18 @@ Fixtures are unpowered. They do not contain electronic or mechanical components You can access the deck configuration settings from the touchscreen via the three-dot (⋮) menu and from the Opentrons App. See the [Deck Configuration section](../touchscreen/deck-config.md) of the Touchscreen chapter for more information. +## Camera + +The camera is mounted on the interior frame of the robot, in the upper corner of the enclosure near the front door. + +![Image showing robot front and interior camera](../images/camera-location.png) + +This fixed location gives you a wide-angle field of view of attached instruments, deck-mounted modules, and labware. + +![Default camera view](../images/camera-default.png) + +For information about using the camera, see [Camera features and controls](../opentrons-app.md#camera-features-and-controls). + ## Waste chute The Opentrons Flex Waste Chute transfers liquids, tips, tip racks, and well plates from the Flex enclosure to a trash receptacle placed below its external opening. The waste chute attaches to a deck plate adapter that fits in slot D3. It also comes with a special window half panel that lets the chute extend out of the front of the robot.