Having your devices set up on Labstep makes a lot of things straightforward and efficient. However, it can be a little bit tricky to start with. We've created this article to make this whole process a lot simpler. Continue to read to learn how to set up all your devices perfectly. No special skills are needed, we promise!


Step 1 – Device Set-up:

  1. Navigate to the 'Instruments & Devices' page

  2. Click on 'New Device'

  3. Click on 'Untitled Device' and enter your Device's name

  4. Click on 'Add Metadata Field' to add any relevant metadata such as the Manufacturer, Model or Serial Number

Labstep team tip: You can also add Date fields such as 'Last Service Date' or 'Next Service Date' and File fields for attaching instruction manuals and other essential documents.

A GIF showing how to create a new device
  • 'Notes' tab → you can keep a record of recurring events such as services or calibrations.

  • 'Data' tab → you can see and search through all the data sent to Labstep by this Device.

A screenshot showing where to find the data and notes tab on a device's page
  • You can book a Device by selecting a date and time. You'll be able to view whether any of your collaborators have booked it on the same day/time. No more waiting to use a device!

A GIF showing how to book a device

Step 2 – Sending Data from a Device:

Devices can send three different types of data to Labstep.

  • Simple numeric measurements consisting of a number and a unit such as temperature, concentration or weight

  • Files such as .CSV files with raw data, output reports generated by larger instruments or even images

  • Free form text

To send numeric measures or free-form text from a device, you'll need to use the Labstep API. We provide a Python SDK.

Labstep team tip: If you're not comfortable working with the API, you can still send files from your devices with no coding required using the Labstep Device Client (See STEP 3).

A screenshot of what the labstepPy page looks like

Step 3 – Using the Labstep Device Client:

Please generate your Labstep API key first. Check out this article to learn how.

  1. Click here (PC) or here (Mac) to download the Device client

  2. After installation, a pop-up will appear

  3. Click 'add device' to get started

  4. Next, paste in your Labstep API key

  5. Hit enter

  6. Select the Device connected to the computer that you want to send data from, or you can create a new one if you haven't already

  7. Select the folder where the Device outputs data to

  8. Whenever a file is saved to this folder, the Device Client detects it and uploads it to Labstep. You should see a notification pop-up if the file was uploaded successfully.

  9. If you have multiple instruments connected to the same PC saving data to different folders, you can click 'add device' to watch other folders for different devices

  10. That's it!

Labstep team tip: If you're using a Mac and it is not letting you open the Labstep Folder Watcher, find out how you can override it here.

A GIF showing how to enable the Labstep Devices Client

Step 3 – Fetching data from a Device:

Data collected from your devices can be used to populate Data fields in your experiments with a single click.

  1. Type / (slash) in an experiment or protocol entry

  2. Click on 'Data'

  3. Click on 'Search measurement device'

  4. Select a device

  5. Specify the Data Type

  6. Specify the Label and other fields if necessary

  7. Click on 'Done'

Labstep team tip: You can also follow the same process by adding Data from the Data tab.

A GIF showing how to add a data field to fetch data from a device

Labstep team tip: Now, whenever you run this Experiment/Protocol, you can click 'Fetch from device', and it will fetch the most recent data of that type sent by the Device!

A GIF showing how to fetch data from a device

Labstep team tip: If you have fetched the wrong data point, you can click the 'plug' icon to select the correct data manually.

A GIF showing how to change which data was fetched


Still need help?

Contact us here or start a conversation with a member of our team using our in-app chat.

Did this answer your question?