Sensors

Connecting Sensors

Open mSupply supports multiple types of temperature sensors.

The methods for connecting each are described below.

mSupply temperature sensors

mSupply Foundation manufacturers its own mSupply temperature sensors.

These sensors can be connected to Open mSupply via integration with the mSupply Cold Chain application.

To configure the integration, you will need to configure a new mSupply user.

The user is a standard mSupply user, with the following configuration:

  • The default store assigned to the user is the store with which the temperature data will be associated.
  • The store will need to be part of the site that Open mSupply is synchronising with. Have a look at the Settings section to see which site omSupply is syncing with, and then the Synchronisation screen to check that your site includes the correct store.
  • The user must have the Open Supply permission of Cold chain API access (see below)

Cold chain API permission

From here, follow the steps in the mSupply Cold Chain application documentation for Integrating with mSupply Desktop using the new mSupply user credentials created above in place of the store credentials.

Fridge-tags and Q-tags

If you are using Berlinger Fridge-tags, you can import the data directly into Open mSupply. To do this, insert the USB of the Fridge-tag into your computer. Then click the Import Fridge-tag button:

Import fridge tag

This will open a file browsing window, allowing you to select the .txt file of the Fridge-tag data. Simply click on the file and wait for the import to complete.

Here's how the process looks (this is the mac desktop version):

Import fridge tag

You may need to wait for the text file to be generated after connecting the Fridge-tag to your computer.

The following Berlinger devices are compatible with Open mSupply:

DeviceBreach data displayedTemperature graph plotted
Q-tag CLm docYesYes
Q-tag CLm doc DYesYes
Q-tag CLm doc IceYesYes
Q-tag CLm doc Ice RYesYes
Q-tag CLm doc LYesYes
Q-tag CLm doc LRYesYes
Fridge-tag 2YesNo*
Fridge-tag 2EYesNo*
Fridge-tag 2LYesYes
Fridge-tag ULYesYes

*Logger device does not capture individual temperature logs

Viewing Sensors

Choose Cold chain > Sensors in the navigation panel.

goto sensors

You will be presented with a list of Sensors (if you don't see any, you may not have imported data yet or integrated with the mSupply Cold Chain app!).

From this screen you can view a list of Sensors and edit a Sensor.

Sensor list

Sensor list

  1. The list of Sensors is divided into 9 columns:
ColumnDescription
NameName of the Sensor
CCEAsset number of the cold chain equipment item which the sensor is associated with
LocationCurrent stock storage Location of the sensor
Serial NumberA unique identifier for the sensor
Battery LevelMost recent battery reading, in percentage
Last readingThe most recent temperature reported by the sensor
Date timeDate and time of the most recent activity for this sensor
Sensor typeThe manufacturer of the sensor, currently support options are mSupply & Berlinger
Breach typeIf the sensor has had a breach, this shows the type of the most recent breach
  1. The list can display a fixed number of sensors per page. On the bottom left corner, you can see how many sensors are currently displayed on your screen.

Page

  1. If you have more sensors than the current limit, you can navigate to the other pages by tapping on the page number or using the right of left arrows (bottom right corner).

Page

  1. You can also select a different number of rows to show per page using the option at the bottom right of the page.

Rows per page

Editing a sensor

Clicking on a row in the list will show you the details of that sensor

Sensor details

On this screen you can

  • Edit the name of the sensor
  • Link the sensor to a stock storage Location
The names of mSupply temperature sensors must be edited in the mSupply Cold Chain application

The other details of the sensor, such as battery level and last recorded temperature are also shown on this screen.