docs: heater-shaker instruction manual

docs/heater-shaker/docs/adapters.md

@@ -0,0 +1,49 @@
+---
+title: "Heater-Shaker Module: Thermal Adapters"
+---
+
+# Thermal Adapters
+
+Aluminum thermal adapters help transfer heat from the Heater-Shaker to attached labware. The module comes with your choice of a universal flat adapter, a PCR well plate adapter, a 96-well flat bottom adapter, or a deep well adapter. You can also purchase additional adapters directly from the [modules section](https://opentrons.com/products/categories/modules) of the Opentrons website.
+
+![Universal adapter, PCR adapter, flat bottom adapater, deep well adapter images](images/thermal-adapters.png)
+
+## Supported Labware
+
+The listed thermal adapters are only compatible with the following labware.
+
+| Labware | API Load Name |
+| ---- | ---- |
+| [NEST 96 Well Plate 100 µL PCR Full Skirt][nest100] | `nest_96_wellplate_100ul_pcr_full_skirt` |
+| [NEST 96 Well Plate 200 µL Flat][nest200] | `nest_96_wellplate_200ul_flat` |
+| [NEST 96 Deep Well Plate 2 mL][nestDeepWell] | `nest_96_wellplate_2ml_deep` |
+| [Opentrons Tough 96 Well Plate 200 µL PCR Full Skirt][opentronsTough] | `opentrons_96_wellplate_200ul_pcr_full_skirt` |
+| [Corning 384 Well Plate 112 µL Flat][corning384] | `corning_384_wellplate_112ul_flat` |
+
+<!-- Reference links keep the table above tidy and neat -->
+[nest100]: https://labware.opentrons.com/nest_96_wellplate_100ul_pcr_full_skirt?category=wellPlate#/?loadName=nest_96_wellplate_100ul_pcr_full_skirt
+[nest200]: https://labware.opentrons.com/nest_96_wellplate_100ul_pcr_full_skirt?category=wellPlate#/?loadName=nest_96_wellplate_200ul_flat
+[nestDeepWell]: https://labware.opentrons.com/nest_96_wellplate_100ul_pcr_full_skirt?category=wellPlate#/?loadName=nest_96_wellplate_2ml_deep
+[opentronsTough]: https://labware.opentrons.com/nest_96_wellplate_100ul_pcr_full_skirt?category=wellPlate#/?loadName=opentrons_96_wellplate_200ul_pcr_full_skirt
+[corning384]: https://labware.opentrons.com/nest_96_wellplate_100ul_pcr_full_skirt?category=wellPlate#/?loadName=corning_384_wellplate_112ul_flat
+
+The Universal Flat Bottom Plate Adapter works with most flat- bottom ANSI/SLAS automation compliant labware. For more information, see the JSON Labware Schema section in the Labware chapter of the Flex Instruction Manual.
+
+## Attaching a Thermal Adapter
+
+<div class="instruction-list" markdown>
+
+1. Use the included T10 Torx screwdriver and Thermal Adapter Screw to attach your chosen adapter to the module.
+
+    !!!warning
+        Using a different screwdriver can strip the screws. Using different screws can damage the module.
+
+![Attaching an adapter to the module](images/adapter-attachment.png){style="width: 60%; margin-left: 0;"}
+
+2. Check the alignment of the thermal adapter. If properly attached, it will sit flush to the surface of the module.
+
+    ![Aligned and misaligned adapter image](images/adapter-alignment.png)
+
+3. Verify that the adapter is firmly attached. The adapter is secure when it doesn’t move while gently pulling on it and rocking it from side to side.
+
+</div>

docs/heater-shaker/docs/compliance.md

@@ -0,0 +1,135 @@
+---
+title: "Heater-Shaker Module: Safety Information and Regulatory Compliance"
+---
+
+# Safety Information and Regulatory Compliance
+
+Opentrons recommends that you follow the safe use specifications listed in this section and throughout this manual.
+
+## Environmental Conditions
+
+The Heater-Shaker should only be used indoors on a sturdy, dry, flat horizontal surface. It must be installed in a low-vibration environment with stable ambient conditions. Keep the Heater-Shaker away from direct sunlight or HVAC systems that may cause significant temperature or humidity changes.
+
+Opentrons has validated the Heater-Shaker’s performance in the conditions recommended for system operation. Operating the unit in these conditions helps provide optimal results. The following table lists and defines the environmental operating conditions for recommended use, acceptable for system operation, and for storage of your Heater-Shaker.
+
+<table>
+  <thead>
+    <tr>
+      <th>Environmental Conditions</th>
+      <th>Recommended</th>
+      <th>Acceptable</th>
+      <th>Storage and Transportation</th>
+    </tr>
+  </thead>
+  <tbody>
+    <tr>
+      <td>Ambient Temperatures</td>
+      <td>20-24 °C</td>
+      <td>20-25 °C</td>
+      <td>-10 to +60 °C</td>
+    </tr>
+    <tr>
+      <td>Relative Humidity</td>
+      <td>40-60%, non-condensing</td>
+      <td>80%</td>
+      <td>10-85%, non-condensing (below 30 °C)</td>
+    </tr>
+    <tr>
+      <td>Altitude</td>
+      <td>Up to 2000 m above sea level</td>
+      <td>Up to 2000 m above sea level</td>
+      <td>Up to 2000 m above sea level</td>
+    </tr>
+    <tr>
+      <td>Pollution Degree</td>
+      <td>2</td>
+      <td>2</td>
+      <td>2</td>
+    </tr>
+  </tbody>
+</table>
+
+The following table lists and defines use and storage standards for the Heater-Shaker.
+
+| Operating Conditions | Description |
+|----|----|
+| Recommended | Opentrons has validated the Heater-Shaker’s performance in the conditions recommended for system operation. Operating the Heater-Shaker in these conditions means you can expect the module to meet performance specifications for the module. |
+| Acceptable | These conditions are acceptable for system operation. The Heater-Shaker is safe to use in these conditions, but the module may not meet performance specifications. |
+| Storage | Storage and transportation conditions only apply when the device is completely disconnected from power and other equipment. |
+
+## Instrument Safety Warnings
+
+Warning symbols posted on the Heater-Shaker or listed here refer directly to the safe use of the instrument. Refer to the previous table for symbol definitions.
+
+<table>
+  <thead>
+    <tr>
+      <th>Symbol</th>
+      <th>Description</th>
+    </tr>
+  </thead>
+  <tbody>
+    <tr>
+      <td><img src="../images/hot-surface-warning.svg" alt="Hot surface warning symbol"></td>
+      <td><strong>CAUTION: Hot surface.</strong><br>
+        The Heater-Shaker generates enough heat to cause serious burns. Wear safety goggles or other eye protection at all times during operation. Always ensure the module returns to idle temperature before removing samples or the module. Always allow maximum clearance to avoid accidental burns.
+      </td>
+    </tr>
+    <tr>
+      <td><img src="../images/pinch-point-warning.svg" alt="Pinch point warning symbol"></td>
+      <td><strong>CAUTION: Pinch point.</strong><br>
+        The labware latch on the Heater-Shaker presents a pinch point hazard. Keep hands and fingers away from the module while the latch opens and closes.
+      </td>
+    </tr>
+  </tbody>
+</table>
+
+## Temperature Safety
+
+!!!warning
+    Never touch the module when its status light is red.
+
+During normal operation, the top plate, labware adapters, and labware on top of the Heater-Shaker can reach temperatures of up to 95 °C. Touching these surfaces while they are hot poses the risk of burns.
+
+To reduce the risk of burns, always check the color of the status light before touching the module. If the status light is red, the module may be hot to the touch. Do not touch the module if it is hot. Use the Opentrons App to deactivate the heater and allow the module to cool until the LED status light is solid white. If you must handle a module that is powered off, and you are unsure whether it is hot to the touch:
+
+- If you can do so _without touching any other part of the module_, press the power button to activate the module and check the color of the status light.
+
+- If you cannot safely press the power button, allow the module to cool for at least 10 minutes before touching it.
+
+### Powering Down
+
+When powering down the Heater-Shaker, ensure that it is idle (not shaking) and not hot to the touch. If the module’s status light is solid white, it is safe to handle. If the status light is red, the module is hot. Allow the Heater-Shaker to cool until the status light is white before powering it down. Turning off the power while the status light is red prevents other users from determining whether the module is hot to the touch. See the [LED Status Light section](specifications.md#led-status) for more information about these visual status indicators.
+
+Press the power button above the USB connector to turn off the module. You can unplug the power adapter once the module is powered down.
+
+## Standards Compliance
+
+The Heater-Shaker has been tested and found to be in compliance with all applicable requirements of the following safety and electromagnetic standards.
+
+### Safety
+
+- IEC/EN 61010-1 Safety­ Requirements­ for­ Electrical­ Equipment for­ Measurement,­ Control­, and Laboratory Use
+- IEC ­ 61010-2-010­ Requirement ­for­ Heating
+- IEC 61010-2-051: 2018­ Particular Requirements For Laboratory Equipment for Mixing and Stirring
+
+### Electromagnetic Compatibility
+
+- FCC part 15 subpart B class A
+- IEC/EN 61326-1 EMC Testing of Laboratory Equipment
+
+### Hazardous Substances
+
+RoHS compliant
+
+### FCC Warnings and Notes
+
+**Warning:** Changes or modifications to this unit not expressly approved by Opentrons Labworks Inc. could void the user’s authority to operate the equipment.
+
+**Note:** This equipment has been tested and found to comply with the limits for a Class A digital device, pursuant to part 15 of the FCC rules. These limits are designed to provide reasonable protection against harmful interference when the equipment is operated in a commercial environment. This equipment generates, uses, and can radiate radio frequency energy and, if not installed and used in accordance with the instruction manual, may cause harmful interference to radio communications. Operation of this equipment in a residential area is likely to cause harmful interference in which case the user will be required to correct the interference at their own expense.
+
+**Note regarding FCC compliance:** Although this instrument has been tested and found to comply with Part 15, Subpart B of the FCC Rules for a Class A digital device, please note that this compliance is voluntary, for the instrument qualifies as an “exempted device” under 47 CFR 15.103(c), in regard to the cited FCC regulations in effect at the time of manufacture.
+
+### CISPR 11 Class A
+
+**Caution:** This equipment is not intended for use in residential environments and may not provide adequate protection to radio reception in such environments.

docs/heater-shaker/docs/flex-installation.md

@@ -0,0 +1,75 @@
+---
+title: "Heater-Shaker Module: Flex Installation Instructions"
+---
+
+# Flex Attachment Instructions
+
+Installing the Heater-Shaker on your robot includes attaching it to the deck and calibrating it for the first time. The instructions here and on the touchscreen will help you get started. The tools you need are included with the module or in the User Kit that came with your Flex.
+
+## Attaching the Heater-Shaker
+
+<div class="instruction-list" markdown>
+
+1. Choose the supported slot you want to use for the module. Use the 2.5 mm screwdriver to remove the deck slot plate.
+
+2. Insert the Heater-Shaker into its caddy by aligning the power button on the module with the on/off switch on the caddy.
+
+    !!!tip
+        If you’re having trouble inserting the module into its caddy, the module’s power button is probably facing away from the caddy’s on/off switch. Turn the module so the power button faces the on/off switch and try again.
+
+3. Holding the module in the caddy, use the T10 Torx screwdriver to turn the anchor screws clockwise to tighten the anchors. The module is secure when it doesn’t move while gently pulling on it and rocking it from side to side.
+
+    !!!warning
+        The shaking motion of the Heater-Shaker requires anchoring to help ensure it does not dislodge itself while in operation.
+
+4. Connect the USB cable to the module.
+
+5. Connect power cable to the module. The Heater-Shaker has an asymmetrical 4-pin power connector. When connecting the power cable to the module:
+
+    - Match the connector's flat side to the flat side of the module's power port.
+    - Aligned cables attach easily; misaligned cables do not.
+    - _Do not_ plug the power cable into a wall outlet until instructed to do so.
+
+    <figure class="screenshot">
+    ![DIN power connector](images/din-power-connector.png)
+    </figure>
+
+6. Insert the caddy into the deck slot and route the power and USB cables through the removable side covers of the Flex.
+
+7. Connect the USB cable to a USB port on the Flex.
+
+8. Connect the power cable to a wall outlet. Gently press the on/off switch to turn the module on.
+
+</div>
+
+If the temperature and status LCDs are illuminated, the module is powered on.
+
+When successfully connected, the module appears in the Pipettes and Modules section on your robot’s device detail page in the Opentrons App. From there, you can control the module’s labware latch or run a test shake. See the [Software Control section](software-control.md) below.
+
+Next, you’ll calibrate the module.
+
+## Calibrating the Heater-Shaker
+
+When you first install a module on Flex, you need to run automated positional calibration. This process is similar to calibrating instruments like pipettes or the gripper. Module calibration ensures that the Flex moves to the exact correct location for optimal protocol performance. You do not have to recalibrate the module if you remove and reattach it to the same Flex.
+
+To calibrate the Heater-Shaker, turn on the power supply. This starts the calibration workflow process on the touchscreen. Instructions on the touchscreen will guide you through the calibration procedure, which is outlined below.
+
+!!!warning
+    The gantry and pipette will move during calibration. Keep your hands clear of the working area before tapping an action button on the touchscreen.
+
+<div class="instruction-list" markdown>
+
+1. Tap **Start setup** on the touchscreen. The robot checks the
+module’s firmware and updates it automatically, if required.
+
+2. Attach the Heater-Shaker’s calibration adapter to the module and tap **Confirm placement**.
+
+3. Attach the calibration probe to the pipette.
+
+4. Tap **Begin calibration**.
+
+5. After the calibration process is complete, remove the calibration adapter from the module and remove the calibration probe from the pipette.
+
+6. Tap **Exit**. Your module is now calibrated.
+
+</div>