OpenScan Composer is a replacement firmware+software package for Raspberry Pi based OpenScan hardware which completely replaces the web based OpenScan interface. A custom network daemon running on the OpenScan device communicates with the Windows based Composer software in order to provide improved user friendliness, plug and play for supported cameras, faster photo capture rates (up to 150+ captures/minute at 16mp), automatic data streaming to your PC, automatic focus stacking and background removal, and project creation for processing the results in supported photogrammetry software.
This beta release supports the OpenScan Mini, Midi and Classic with either the Arducam IMX519, Arducam Hawkeye, or Raspberry Pi Camera 3, and automatic project creation for MetaShape Pro and Meshroom.
Requirements
- OpenScan Mini (v1/v2), Midi, or Classic with a Raspberry Pi Zero 2 (512mb) or better (Raspberry Pi 4b recommended).
- Original Greenshield or new Blackshield.
- Arducam IMX519 (16mp), Arducam Hawkeye (64mp), or Raspberry Pi Camera 3 (12mp).
- 8GB or larger SD card for firmware (32GB+ recommended).
- Windows 10 or higher.
- A fast network connection, ideally gigabit ethernet (recommended for captures above 16mp).
OpenScan Composer Firmware has been tested on the following Raspberry Pi editions:
- Raspberry Pi 4b (recommended)
- Raspberry Pi 5*
- Raspberry Pi 3b
- Raspberry Pi Zero 2 (16mp resolution limit)
*Raspberry Pi 5 is currently unable to make use of PDAF fast autofocus due to a Raspbian kernel issue. Autofocus will be slower with the Pi 5. This issue will hopefully resolved in a future version of the operating system.
Quick Start
This software is provided as-is, without any warranty, express or implied. Use of this software may cause hardware damage and is entirely at your own risk!
- Download the latest version of the firmware and software.
- Flash the firmware to your SD card.
- Install and run OpenScan Composer on your Windows PC.
Need more installation help? Start on the firmware page.
Firmware and Software already installed? Check out the tutorial for help performing your first scan.
Roadmap
The following features are planned for future release:
OpenScan Composer v0.9.0.2
- Multiple scan passes, add pass, resume project, and additional project processing and retake photo functionality.
- Automatic project generation for Reality Capture.
- Faster captures + additional scan patterns.
- Support for Helicon Focus stacking.
- Focus peeking.
- 3rd “Slider” motor support for BlackShield.
- Improved focus distance calibration for all cameras.
- Sensorless rotor homing (requires aftermarket TMC2209 stepper drivers).
OpenScan Composer v0.9.0.3+
- Auto+Stack focusing.
- Automatic focus level evaluation.
- Scan and focus level presets based on standard target sizes.
- Custom camera setup.
OSC Firmware v0.9.0.4
- WebSocket based control interface.
- REST API based control interface.