docs: camera-enablement (#20175)

# Overview

Updates the Flex manual with basic information about the built-in
camera.

Sandbox: 

- Opentrons App:
https://sandbox.docs.opentrons.com/docs-camera-enablement/flex/opentrons-app/
(see also a bullet in the "Recent Protocol Runs" section that follows.
Explains downloading images.)

- Touchscreen > robot settings:
https://sandbox.docs.opentrons.com/docs-camera-enablement/flex/touchscreen/settings/

- System Description > Frame and enclosure:
https://sandbox.docs.opentrons.com/docs-camera-enablement/flex/system-description/robot/

RTC-884

## Test Plan and Hands on Testing

Making sure images and links work.

## Changelog

**Opentrons App chapter**: Modifies `opentrons-app.md` to include a new
section about the camera. Additional changes (more camera features) will
come with 8.9, so this first version is basic functionality.

**Touchscreen > Robot Settings**: Modifies `settings.md`. Updates the
ODD image that shows all the settings. This is
`touchscreen-settings.png`. No new text or text changes.

**System Description**: Modifies `robot.md`. In the "Frame and
Enclosure" section, adds link to Opentrons App chapter to text in the
sentence, "A 2.1-megapixel camera can photograph the deck and working
area..."


## Review requests

The "Camera features and controls" section in the App chapter is the
most significant change here. It introduces new information about the
camera. This first camera release is limited, other features (e.g. shown
in the Figma designs) aren't here and will be released later. Remember,
this focuses on the very basic features and functions.

## Risk assessment

Low but important. Want to give users enough to use the camera easily.

---------

Co-authored-by: Ed Cormany <[email protected]>

Author: jwwojak

docs/flex/docs/images/camera-default.png

@@ -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.
@@ -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.

docs/flex/docs/images/camera-location.png

@@ -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.