Skip to content
Merged
Show file tree
Hide file tree
Changes from all commits
Commits
File filter

Filter by extension

Filter by extension

Conversations
Failed to load comments.
Loading
Jump to
Jump to file
Failed to load files.
Loading
Diff view
Diff view
Binary file added docs/flex/docs/images/camera-default.png
Loading
Sorry, something went wrong. Reload?
Sorry, we cannot display this file.
Sorry, this file is invalid so it cannot be displayed.
Binary file added docs/flex/docs/images/camera-location.png
Loading
Sorry, something went wrong. Reload?
Sorry, we cannot display this file.
Sorry, this file is invalid so it cannot be displayed.
Binary file added docs/flex/docs/images/robot-details.png
Loading
Sorry, something went wrong. Reload?
Sorry, we cannot display this file.
Sorry, this file is invalid so it cannot be displayed.
34 changes: 34 additions & 0 deletions docs/flex/docs/opentrons-app.md
Original file line number Diff line number Diff line change
Expand Up @@ -97,6 +97,38 @@ Click the three-dot menu (⋮) on the module card to choose from available comma
| **Temperature** | <ul><li>Set module temperature / Deactivate module</li></ul> |
| **Thermocycler** | <ul><li>Set lid temperature / Deactivate lid</li><li>Open lid / Close lid</li><li>Set block temperature / Deactivate block</li></ul> |

## 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:

<div class="instruction-list" markdown>

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.

</div>

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.

<figure class="screenshot" markdown>
![Details page showing enabled camera](./images/robot-details.png)
</figure>

### 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.
Expand All @@ -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.
Comment on lines 146 to 147
Copy link
Contributor

Choose a reason for hiding this comment

The reason will be displayed to describe this comment to others. Learn more.

It's strange that this note breaks up the list here. Either:

  • Put it after the entire list (most like previous revision).
  • Put it inside the Download run log bullet (indented so it's contained in that list item).

Copy link
Contributor Author

Choose a reason for hiding this comment

The reason will be displayed to describe this comment to others. Learn more.

This is maybe for the other PRs that got merged together, not for the camera PR?


- **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.
14 changes: 13 additions & 1 deletion docs/flex/docs/system-description/robot.md
Original file line number Diff line number Diff line change
Expand Up @@ -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

Expand Down Expand Up @@ -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.
Expand Down
Loading