> ## Documentation Index
> Fetch the complete documentation index at: https://docs.atomscale.ai/llms.txt
> Use this file to discover all available pages before exploring further.

# RHEED Settings Reference

> Every setting of the RHEED Camera (GenTL) integration, by section

The configuration form groups settings into sections. Settings marked **Advanced** appear only with Show advanced settings turned on. Settings that belong to a frame source or mode you didn't choose are hidden, and their values revert to defaults when you apply.

## Auto Values

Many fields default to **Auto**: leave them blank and the integration chooses the value and adjusts it as it runs. While the integration runs, a blank Auto field shows the value it is using, muted, beside Managed. Enter a value to pin it. To hand a field back, click Auto Manage next to it and apply.

An integration configured before Auto values were introduced keeps its saved values, so it captures exactly as it did before the update. Use Auto Manage to move a field to Auto.

## Growth Details

| Field | Default | Description |
| - | - | - |
| **Stage Rotation** | Detected | Stage speed in RPM, from 1 to 600, for faster first results on a rotating stage. Left blank, Atomscale detects whether the stage rotates. |

## Frame Source

| Field | Default | Description |
| - | - | - |
| **Frame Source** | Network (GVSP Tap) | **Network (GVSP Tap)**, **Standard (GenTL)**, or **Synthetic (Testing)**. See [Choose a Frame Source](https://docs.atomscale.ai/gateway/rheed.md#choose-a-frame-source). |
| **Camera IP Address** | Auto | Network only. Left blank, Start finds the camera, remembers it, and follows it if its address changes. Click Detect to pick a camera now, or enter its IPv4 address to pin it. |
| **GenTL Producer** | Blank (search) | Standard only. Full path to the vendor `.cti` file. |
| **Camera** | Blank (only camera) | Standard only. The camera's serial number or ID, when the producer reports more than one camera. |

### Advanced Network Settings

Leave these at their defaults unless troubleshooting or Atomscale support asks you to change them.

| Field | Default | Description |
| - | - | - |
| **Capture Interface IP** | Blank (detect) | The local adapter address to capture on. Set it when detection picks the wrong adapter, or to the monitor adapter in a mirror setup. |
| **Original Stream Destination IP** | Blank | Mirror setups only: the primary camera-facing adapter's address. Requires **Capture Interface IP**. |
| **Stream Destination Port** | Auto | Auto learns the port from the first complete frame. Set it to pin a specific stream. |
| **Capture Mode** | NIC Miniport Tap (Pktmon) | See [Capture Modes](https://docs.atomscale.ai/gateway/rheed/network-capture.md#capture-modes). |
| **Pktmon Component ID** | Auto | Pktmon mode only. The Packet Monitor component of the camera's network adapter, from `pktmon list`. |
| **Allow Promiscuous Capture** | Off | Promiscuous mode only. Authorizes putting the adapter in promiscuous mode. |
| **Capture Receive Buffer** | Auto | Memory for packets waiting to be processed, 1 to 1024 MiB. Auto starts generous and grows while capture loses packets, within this computer's memory budget. |
| **Raw Frame Queue Capacity** | Auto | Complete frames that may wait for processing. Auto holds about two seconds of frames, from 48 to 256, and holds more while frames are dropped for lack of room. |
| **Pixel Byte Order** | auto | How multi-byte pixel values are decoded. |
| **Validation Frames** | 8 | Consecutive matching frames required before frames are delivered. |
| **Validation Timeout** | 3000 ms | How long startup validation may run after frames begin arriving. |
| **Traffic Report Timeout** | 10000 ms | How long silence may last before a diagnostic, and before an auto-learned port is released. |
| **In-Flight Blocks** | Auto (8) | Frames assembled at once, 1 to 8. Auto allows the most, so a frame can wait for a resent packet while the next frames arrive. |
| **Frame Retention** | Auto | How long an incomplete frame waits for its remaining packets, 0 to 1000 ms. Auto starts at 10 ms and waits longer while that recovers late packets. |
| **Frame Size Limit** | 134217728 bytes | Largest frame accepted. |
| **Diagnostic Event Capacity** | 256 | Recent events kept for failure reports. |

## Downsampling

| Field | Default | Description |
| - | - | - |
| **Spatial Downsampling** | Off | Halves the width and height of uploaded frames. |
| **Downsampling Method** | Drop Pixels | Shown with Spatial Downsampling on. **Drop Pixels** keeps one pixel of each 2 × 2 block; **Average Pixels** averages them. |
| **Upload Frame Rate Limit** | No limit | The most frames per second to upload, up to 120. Extra frames are skipped; the camera's rate doesn't change. |

## Uploading

| Field | Default | Description |
| - | - | - |
| **Frames Per Chunk** | Auto | Frames grouped into each upload, from 1 to 256. Auto groups about one second of frames at the stream's rate. Lower values reduce delay before frames reach Atomscale, at the cost of more upload overhead. |
| **Upload Backlog Size Limit** (advanced) | Auto | See [Disk Buffering](https://docs.atomscale.ai/gateway/uploads.md#disk-buffering). |
| **Free Disk Space To Keep** (advanced) | 1 GB | See [Disk Buffering](https://docs.atomscale.ai/gateway/uploads.md#disk-buffering). |

## Sessions & Image

| Field | Default | Description |
| - | - | - |
| **Data Item Boundary Mode** | Frame Activity | See [Recording Sessions](https://docs.atomscale.ai/gateway/rheed/sessions.md). |
| **Session Gap** | 120 seconds | Frame Activity only. Seconds without an active frame before the data item closes. |
| **Minimum Mean Intensity** | Auto | Frame Activity only. Minimum average brightness (0 to 255) for a frame to count as active. Auto learns it from frames with the beam off; see [Frame Activity](https://docs.atomscale.ai/gateway/rheed/sessions.md#frame-activity). |
| **kSA Communication Host** | `127.0.0.1` | kSA Acquisition Status only. The computer running kSA 400. |
| **kSA Communication Port** | 1800 | kSA Acquisition Status only. The kSAComm port in kSA 400. |
| **kSA Status Poll Interval** | 1 second | kSA Acquisition Status only. How often to check kSA 400's state. |
| **White Point** (advanced) | Auto (full scale) | The pixel value mapped to white when converting to 8-bit. Set it only when images from a high bit-depth camera look too dark. |

## Diagnostics

All advanced.

| Field | Default | Description |
| - | - | - |
| **Activity Summary Interval** | 10 minutes | How often capture statistics are written to the activity log. |
| **Performance Instrumentation** | Off | Adds detailed timing to the activity log. Turn on only while troubleshooting. |
| **Diagnostics Only** | Off | Checks the camera and stream without creating data items or uploading. |


This documentation is built and hosted on [Mintlify](https://mintlify.com), a developer documentation platform.