Controlling the device locally

A microscope on display

Since the microscope uses a Raspberry Pi to control the hardware, by connecting a display, mouse, and keyboard, you can use OpenFlexure Connect on the microscope directly. You can launch OpenFlexure Connect from your application menu, under ‘Other’.

From here, ensure that the ‘Connect locally’ option is checked, then click ‘Connect’. After a few seconds, you should see a live preview of the microscope camera, and full software control over the device.

Controlling the device remotely

Through an existing network

OpenFlexure Connect works by sending commands to the microscope over a network connection. This means that if the Raspberry Pi is connected to the same (wired or wireless) network as your laptop, for example, you can remotely control the microscope from that device. In OpenFlexure Connect, on your remote device, select ‘Connect remotely’, enter the IP address of the Raspberry Pi in your microscope, and click ‘Connect’.

Direct via ethernet

On most modern computers, you can simply connect the Raspberry Pi directly to the device via an ethernet cable for simple, high-speed control. For many applications using a single microscope, this is a preferred setup. Generally, you don’t even need to know the IP address of the Raspberry Pi in this case. In OpenFlexure eV, on your remote device, select ‘Connect remotely’, enter microscope.local as your hostname, and click ‘Connect’.

Managing the microscope server

Our installer now includes various commands to simplify common tasks when using the OpenFlexure Microscope. From the terminal on your Raspberry Pi, you will have available commands such as:

ofm start - Start the server background service

ofm stop - Stop the server background service

ofm update - Pull and install the latest version of the OFM CLI itself

ofm upgrade - Pull and install the latest version of the server

For a complete list of available commands, run ofm help

Raspberry Pi configuration

Additional Raspberry Pi configuration options, such as network and interface settings, can be accessed by running sudo raspi-config from your terminal.

Developing plugins

Developer documentation for the microscope server software can be found on Read the Docs. This includes documentation and tutorials on developing plugins for the microscope software.

Please see our contribution guidelines for more information on contributing back to the project.

Changing stage configuration for Delta Stage

The geometry of the Delta Stage is different to the standard OpenFlexure Microscope. So that the movement of the stage is correct, you will need to change the stage configuration:

  1. In OpenFlexure Connect, when connected to your Delta Stage microscope, click Settings.
  2. Under MICROSCOPE SETTINGS, click Stage.
  3. Change the Stage geometry dropdown to SangaStage (Delta).