Skip to content
Merged
Show file tree
Hide file tree
Changes from 10 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.
44 changes: 44 additions & 0 deletions docs/flex/docs/opentrons-app.md
Original file line number Diff line number Diff line change
Expand Up @@ -97,6 +97,48 @@ 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.1 megapixel camera that can capture full HD still images and provides video of the deck and working area. Disabled until the release of robot software version 8.8, the camera is now enabled for control and use in the Opentrons App and from the touchscreen. When on, 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.

### Location

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)

### 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 +156,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.
2 changes: 1 addition & 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.1-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
Loading