Skip to content

Rapp: Add device pages for RappLasers and Rapp_UGA42. #203

New issue

Have a question about this project? Sign up for a free GitHub account to open an issue and contact its maintainers and the community.

Sign up for GitHub

By clicking “Sign up for GitHub”, you agree to our terms of service and privacy statement. We’ll occasionally send you account related emails.

Already on GitHub? Sign in to your account

Merged
nicost merged 1 commit into from
Jan 16, 2026
Merged

Rapp: Add device pages for RappLasers and Rapp_UGA42. #203

Show file tree
Hide file tree
Changes from all commits
Commits
Show all changes
1 commit
Select commit
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
5 changes: 4 additions & 1 deletion _pages/Device_Support.md
View file
Open in desktop
Original file line number Diff line number Diff line change
Expand Up @@ -386,6 +386,7 @@ release](Download_Micro-Manager_Latest_Release).
- [Oxxius](Oxxius) - Oxxius Laser Controller
- [Oxxius\_combiner](Oxxius_combiner) - Oxxius combiner;
hub for multiple laser sources
- [RappLasers](RappLasers) - Rapp laser controllers
- [PolychromeV](PolychromeV) - Illumination system from
Till Photonics
- [Prairie Aurora Laser
Expand Down Expand Up @@ -454,8 +455,10 @@ release](Download_Micro-Manager_Latest_Release).
Stabilization from [BIG](http://big.umassmed.edu)
- [PriorPureFocus](PriorPureFocus) - Hardware autofocus device from Prior
- [PyDevice](PyDevice) (Experimental) - Devices controlled by Python scripts
- [Rapp](Rapp) - Rapp UGA40 photobleaching/photoactivation
- [Rapp](Rapp) - Rapp UGA-40 photobleaching/photoactivation
unit
- [Rapp_UGA42](Rapp_UGA42) - Rapp UGA-42 galvo scanner for
phototargeting
- [SimpleAutofocus](SimpleAutofocus) - Image-based
autofocus software 'device'.
- [SpectralLMM5](SpectralLMM5) - Spectral laser line
Expand Down
55 changes: 55 additions & 0 deletions _pages/RappLasers.md
View file
Open in desktop
Original file line number Diff line number Diff line change
@@ -0,0 +1,55 @@
---
autogenerated: false
title: RappLasers
redirect_from: /wiki/RappLasers
layout: page
---

| | |
|------------|--------------------------------------|
| Summary: | Rapp Laser Controller |
| Author: | Nico Stuurman |
| License: | BSD |
| Platforms: | Windows |
| Devices: | Rapp laser controllers |

------------------------------------------------------------------------

The RappLasers device adapter controls Rapp laser controllers, providing
shutter control, light output control, and intensity adjustment for Rapp
laser systems. For convencience, the laser are implemented as shutters. The shutter will only work in Software control mode and will control the "Light" (laser on/off) rather than the "Shutter".

## Properties

| Property | Description |
|---------------|--------------------------------------------------------------------------------------------------|
| Port | Serial COM port for communication with the laser controller |
| Shutter | Controls the hardware shutter (Open/Closed). This is more of a safety shutter that is not meant to be switched fast and often. |
| Light | Controls the software laser output (On/Off) |
| Intensity (%) | Sets the laser power from 0-100% |
| ControlMode | Selects the control mode: Software, External-Mix, External-Digital, RMI-Mix, RMI-Digital, External-Analog, or RMI-Analog |
| SerialNumber | Read-only device serial number |
| LaserName | Read-only device model identifier |

## Control Modes

The laser supports multiple control modes:

- **Software** (default): Laser is controlled entirely through software commands
- **External-Mix**: Mixed external control
- **External-Digital**: Digital external triggering
- **RMI-Mix**: Mixed RMI control
- **RMI-Digital**: Digital RMI control
- **External-Analog**: Analog external control
- **RMI-Analog**: Analog RMI control

External refers to BNC connectors on the controller, RMI to another type of connector (first time I have heard of these, and I can not find them with a few searches, so maybe something Rapp specific).

## Installation

Configure the laser controller in the Hardware Configuration Wizard by
selecting "RappLasers" from the device list and specifying the appropriate
COM port. Standard (default) serial port settings will work.

## Normal Usage
Most often, these lasers will be used in conjunction with the Rapp UGA-42 device for photo-bleaching/photo-activation. In that case, make sure to open the shutter, and set the ControMode to RMI-Mix. This is most conveniently done in the System-Startup configuration. Please note that in RMI-Mix (or External-Mix) modes the Light and Intensity controls will not work (they are replaces by the external inputs).
65 changes: 65 additions & 0 deletions _pages/Rapp_UGA42.md
View file
Open in desktop
Original file line number Diff line number Diff line change
@@ -0,0 +1,65 @@
---
autogenerated: false
title: Rapp_UGA42
redirect_from: /wiki/Rapp_UGA42
layout: page
---

| | |
|------------|--------------------------------------|
| Summary: | Rapp UGA-42 Galvo Scanner |
| Author: | Nico Stuurman |
| License: | BSD |
| Platforms: | Windows |
| Devices: | Rapp UGA-42 |

------------------------------------------------------------------------

The Rapp UGA-42 is a galvanometer-based laser targeting system for
photobleaching, photoactivation, and other phototargeting applications.
It uses galvo mirrors to precisely position laser beams through the
microscope objective to target specific locations in the specimen.

This device adapter is similar to the original [Rapp](Rapp) adapter for
the UGA-40, but is designed for the newer UGA-42 hardware.

The Micro-Manager [Projector Plugin](Projector_Plugin) allows microscope
operators to calibrate the UGA42 with the camera and to draw spots or
regions of interest on an image and phototarget these areas
using the UGA-42.

## Features

- Multi-laser support (Laser 1 through 4
- Point-and-fire capability for single-spot targeting
- Polygon support for complex ROI targeting
- Sequence automation for programmed scanning patterns
- TTL triggering with configurable edge detection

## Properties

| Property | Description |
|---------------------|-------------------------------------------------------------------------------------------------|
| LaserPor | Selects which laser to use (Laser 1 - 4) |
| LaserIntensity | Controls analog voltage send to the laser, hence laser intensity |
| LaserType | Continuous or pulsed |
| MaxIntensity | Max Laser Intensity |
| MinIntensity | Minimum Laser Intensity |
| SpotSize | Laser spot diameter for ROI rastering calculations, relative number of unknown dimensions |
| TTLTriggerBehavior | For TTL triggering, selects Rising Edge or Falling Edge |
| TTLTriggerMode | Select "None" for software control. I have not yet tested other modes, but they should work." |
| TickTime | The UGA 42 has an internal "clock" and operates with sequential time slots ("ticks"), This property sets the duration of a tick in microseconds. Default is 50, minimum is 40, maximum is 1000. |


## Installation

The UGA-42 requires the files "obsTools.dll" and "ROE UGA-42 SDK.DLL" in the micro-manager installation directory. The code was build agains UGA-42 SDK_1139, and it can not be guaranteed that other versions will work. If you do not have these files, please contact Rapp support and request them. The Rapp UGA42 should be auto-detected. Leave the debug property set to false (setting it to true will dramatizally slow down communication with the device). This device adapter currently only supports one UGA42.


## See Also

- [Rapp](Rapp) - Original adapter for the UGA-40
- [RappLasers](RappLasers) - Lasers for use with the UGA42. You may need these to open the safety shutter of your Rapp Lasers and to set the laser into RMI-Mix controlmode.
- [Projector Plugin](Projector_Plugin) - For interactive phototargeting