Devices

The devices settings section allows you to configure devices that you may have connected to the Open mSupply system.

Viewing the device settings🔗

To view the display settings, go to Settings in the lower section of the navigation panel:

Admin: nav

You will see the list of settings sections:

Admin: collapsed

Click on the Devices section to begin.

You will require the Access server administration permission, as noted in the Permissions page

Label Printing🔗

Label printing support is very limited at this time! Label printers are used only for printing QR codes to identify cold chain equipment and basic prescription labels.

The label printing functionality is in an experimental state currently. There is limited support for label printers using the ZPL printer language.

Label Printing

Printing via Network🔗

Enter the IP address and other details of the printer. Click Save to save the details. Once saved, you can click the Test button to attempt to connect to the printer and fetch its configuration.

The label width and height values are not currently used - you can ignore those fields for now.

Printing via USB🔗

To print via USB, install Zebra Browser Print. Visit Zebra's Browser Print page and download the version for your operating system (Windows or Mac). USB printing is not supported on Android.

Once installed, visit Zebra's documentation page and follow the set up guide.

Return to the settings page and turn on the Print via USB switch to enable USB printing.

When enabled, USB printing will be used instead of network printing.

Barcode Scanners🔗

This section allows you to configure a USB barcode scanner for use with Open mSupply desktop. We support serial-mode and keyboard-mode scanners. The preference is serial scanners which we have found to be more reliable. The Zebra DS-22 is the recommended model.

On opening the barcode scanners section you may see the message Not connected:

Barcode scanner

even though you have a scanner plugged in. The system needs to be instructed that a scanner is available - here's how this is done:

Click the Detect button. A barcode will be shown:

Barcode scanner

Scan the barcode with your barcode scanner (this may take a few attempts!). You will see the following notification when successful:

Barcode scanner

and then the message is changed to the following:

Barcode scanner

You are now able to use the barcode scanner!