Skip to main content

Machine Integration Overview

Barti's machine integration lets you transfer refractive data directly from your optical devices into a patient exam. Install the Barti Machine Integration app, connect it to your device's folder, and it handles the rest automatically.

D
Written by Dan Healey

Who this is for: All Barti users. Initial setup requires admin access — see How do I set up Barti's machine integration?.

Table of Contents

Supported devices

Marco Connect — any device supported by Marco Connect. Confirmed devices: Marco RT-5100, Marco RT-6100, Tonoref 2
​

Reichert Capture — any device supported by Reichert Capture. Confirmed devices:

  • Tonometers: AT550, AT555, Reichert 7, Reichert 7CR, Ocular Response Analyzer G3, PT100, TonoVera

  • Lensometers: AL200, AL500, AL700, LensChek Pro, LensChek Plus

  • Auto-refractors/keratometers: RK600, RK700, OptoChek Plus

  • Auto-phoroptors: AutoPhoroptor RS, Phoroptor VRx, Visutron 900, SightChek

  • Pachymeter: iPac

Topcon — CV-5000, KR-1, KR-800, CL-300. If other devices are configured to send data to the CV-5000, that data can also be pulled into Barti.
​

Huvitz (HDR-Mate) — HDR-7000, HDR-9000. Requires a Windows computer.
​

Essilor (CBOX / Essibox) — any device supported by CBOX. Confirmed devices: AKR300, CL-300, Vision-R 700

Requirements

The computer running the Barti Machine Integration app must be connected to the internet and running at all times. The app does not sync files retroactively.

Topcon (CV-5000, KR-1, KR-800, CL-300)

  • Computer must be on the same network as the device

  • Computer must have access to the network folder

  • Topcon device must be configured to send XML data to a network folder — contact Topcon support for help: 1-866-922-6278, Monday–Friday 8AM–8PM EST

Marco

  • Marco Connect must be installed, running at all times, and set to XML output

  • Marco Connect must run on the same computer as the Barti app

Reichert

  • Reichert Capture must be installed, running at all times, and set to XML output

  • Reichert Capture must run on the same computer as the Barti app

Huvitz

  • HDR-Mate must be installed, running at all times, and set to XML-Marco output

  • HDR-Mate must run on the same computer as the Barti app

  • Computer must be a Windows device

Essilor

  • CBOX must be powered on and connected to the same local network as the computer running the Barti app

  • All Essilor devices must be configured to output data via the CBOX in XML format

  • The computer must have persistent read/write access to the CBOX shared network folder

Step 1 — Find your device's file path

Before installing anything, find the folder path where your device exports its readings. Open a notepad so you can paste the path as you go.

Marco Connect

  1. Open Marco Connect and navigate to Tools > Options.

  2. Find the Output Path field.

    • If Use Default is checked, your file path is likely C:\Program Files (x86)\Marco Opthalmic\Marco Connect\Output

    • If Use Default is not checked, copy the path shown and paste it into your notepad.

  3. Click Cancel to close the Options box.

Reichert Capture

  1. Open Reichert Capture.

  2. Locate the Output XML File Path field.

  3. Confirm it is set to Local File.

  4. Copy the file path (e.g. C:\ReichertCapture\Output\Device1\) into your notepad.
    ​
    ​

Topcon

  1. On the device, hold down the Shift and Menu buttons simultaneously to open the Settings page.

  2. Select Data I/O > System Configuration > Data File Configuration.

  3. Confirm the file format is set to XML.

  4. Locate and copy the path to the shared folder into your notepad.
    ​
    ​

Huvitz (HDR-Mate)

  1. Open HDR-Mate.

  2. Navigate to Options > Data Receiving & Transfer > Export Directory.

  3. Confirm the following settings:

    • Data Receiving Option — Deleting Record: After Printed and Exported

    • Data Transfer Option — Deleting Record: After Transferred

    • Advanced > Export Type: XML-Marco

  4. Copy the file path (e.g. C:\Program Files (x86)\Huvitz\HDR-Mate) into your notepad.

Essilor (CBOX)

Locate the shared network folder path that the CBOX is configured to export data to and copy it into your notepad. Contact your Essilor representative if you're unsure where this is configured.

Step 2 — Install the Barti Machine Integration app

  1. Log into Barti with an admin account and navigate to Organization Settings > Integrations.

  2. Scroll down to the Machine Integration section.

  3. Click Download the Desktop App and save the file.
    ​
    ​


    ​

  4. Navigate to where the file was saved and double-click Barti Machine Integration.msi.

  5. Click Next > Next > Install > Finish.
    ​
    ​


​


​


​


​
You do not need to restart your computer after installation.

Step 3 — Configure the Barti Machine Integration app

  1. Open the newly installed Barti Machine Integration app.

  2. In Barti, navigate to Organization Settings > Integrations > Machine Integration.

  3. If you see "Machine Integration API Key not found," click Enable Integration.
    ​
    ​


    ​

  4. Click Copy API Key to copy your key to the clipboard.

  5. Switch to the Barti Machine Integration app and paste the key (Ctrl+V or Edit > Paste).

  6. Select your office location.

  7. Click Add Directory and select the file path you copied in Step 1.

  8. Select your device from the dropdown.

  9. Enable Delete after import.
    ​
    ​


    ​


    ​

  10. Click Finish Setup.

Step 4 — Import a reading into a patient exam

  1. Take a reading from your device.

  2. Export the reading using the device's Print or Output button. The Barti Machine Integration app picks it up automatically.

  3. In Barti, navigate to Exams > Imported Data.

  4. Find the reading you just imported, click the menu next to it, and select View to confirm the readings look correct.

  5. Open the patient's exam.

  6. Click Review Imported Data in the top-right corner of the exam.

  7. Select the reading from the list.

  8. Click Assign Imported Data to populate the exam fields.
    ​
    ​


    ​


    ​


    ​

Troubleshooting

The green icon isn't spinning when I export a reading.

Confirm Delete after import is enabled. Navigate to the file path on your computer — if a file is sitting there, the app may not have picked it up. Delete the file, reprint from the device, and watch whether a new file appears and then disappears. If it appears but doesn't disappear, delete it and try again. For Topcon devices, restart the device if the problem persists. If it still doesn't work, delete the file, restart the device, restart the computer, reopen the Barti app, and retry.

How do I access the Barti Machine Integration app log?

The app logs everything it does and shares the log with Barti automatically every 8 hours. To find the log file manually, open File Explorer, click the address bar, and paste: %APPDATA%\BartiMachineIntegration\BartiMachineIntegration

The log file is in the logs folder.

The app isn't recognizing my device's printout.

Confirm the file path in the app matches exactly where your device exports files. Navigate to that path, delete any existing file, and reprint from the device to confirm a new file is being created. If the app is working correctly, the file will appear and then disappear (if Delete after import is on).

Related articles

Did this answer your question?