Difference between revisions of "Drivers"

From SweepMe! Wiki
Jump to navigation Jump to search
m (Afischer moved page Device Class to Drivers: Name change)

Revision as of 20:29, 24 May 2022

Several Modules can load Devices and they are represented by Device Classes which are small code snippets allowing you to include and use any equipment with SweepMe!. It basically is a python file called main.py written in the programming language python 3.6 (32bit) (https://www.python.org/).

Download

Version manager

You can download or update Devices via the Version Manager which is part of the SweepMe! installation. (>= v.1.5.4 needed)

Direct download

Direct download is possible via an account and appropriate rights. Please contact us if you need an account.

Upload

To make SweepMe! a powerful tool, we are relying on you! Help us to build up a large library of Devices. Implement your own Device Classes and upload your files to our webpage. Contact us and request an account. Using the dashboard, you can upload, manage, and share your Devices with other users.

Places and folders

SweepMe! can load Device Classes from different places:

pre-installed: These Device Classes come with your installation of SweepMe! You can find them in the folder 'Devices' of your SweepMe! installation, e.g "C:\SweepMe!\SweepMe!_1.5.4\Devices" if you use the suggested installation path

installed: These Device Classes are obtained using the [[version manager] (menu "Modules&Devices"). Every Device Class you download is versionized and will be copied to "C:\ProgramData\SweepMe!\Devices". These folders are read-only. Please, do not modify them to keep the file integrity. You can delete these versions using the version manager of SweepMe! Please also do not add any Device Class yourself, except you know why. You can make a copy of these files if you like to test modifications as described below.

custom: These Device Classes are placed in the public folder of SweepMe! called "CustomDevices". You can find this folder via the folder link on your desktop that was created during the installation or via the Menu of SweepMe! 'File' -> 'Open Folder' -> 'Public'. We recommend to use this folder to create your own Device Classes as this folder will not be changed if you install a newer version of SweepMe! so that you can still access your Device Class with any further SweepMe! version.

These different kinds of Device Classes are shown in the version manager of SweepMe! having the label pre-installed, installed, or custom.

Structure

SweepMe! searches for new Device Classes in the folders described above. Each Device Class has to have a name of the following structure:

<Type of the Module>-<Name of the manufacturer>_<Name of the device model>

Examples:

  • SMU-Keithley_2400
  • LCRmeter-HP_4284A
  • Logger-PC_Mouse

The <Type of the Module> must be related to the Modules provided by SweepMe! and every Module provides different functionality to control a certain type of equipment.

The Device Class itself is a file which always has the name "main.py" and which can load further python modules, [dll]s, or simple text files as needed to get your Device Class working.

The Sequencer procedure provides various standard functions which can be used at certain points during the run of the measurement sequence.

Documentation

Each device class that has been uploaded to sweep-me.net automatically gets a webpage here [[1]]. One can find there further details about the instrument, the handling of the driver, and links to manufacturer or the manual. Feel free to contact us if further information are needed.

Creating new Device Classes

You can implement Device Classes on your own into SweepMe!. How to program a Device Class is described here: Device Class Programming

Create a copy of an existing one

  • Open SweepMe!'s version manager using the menu 'Modules & Devices'
  • Navigate to the Device you like to copy and choose a version
  • Right-click the version and choose "Copy to public folder 'CustomDevices'"
  • Right-click on the new version and select "Open in folder" or "Open in editor" to find or modify

Create a new one using the version manager

  • Open SweepMe!'s version manager using the menu 'Modules & Devices'.
  • Navigate to the Device you like to copy and choose a version.
  • Right-click the version and choose "Copy to public folder 'CustomDevices'".
  • Open the public folder "CustomDevices" (e.g. using the main menu via File -> Open folder -> Devices -> public).
  • Rename the folder regarding module name, manufacturer and model.
  • Delete the info.ini file if the new Device Class was not automatically removed.
  • Restart SweepMe! to reload all Device Classes.

Manually create one

  • Open the public folder "CustomDevices" (e.g. using the main menu via File -> Open folder -> Devices -> public).
  • Create a folder with module name, manufacturer and model as defined above
  • Add a main.py
  • Insert the minimal working example as given in Device Class Programming


Open/Modify

You can open any Device Class out of SweepMe! with included Pnotepad editor. Any change to the Device Class will automatically affect its operation after saving the file and starting a new run. Versions that have the origin 'installed' cannot be modifed as they are versionized. Use the Device Class Programming guide to find all possibilities.