Skip to content

SoftwareController#

The software controller object is your gateway to the probe station control software. You can use it for project handling or displaying messages on the screen of the prober software.


method create_project(name: str)#

Create a new project.

Parameters#

Name Description
name The name of the new project.

Example#

Create a new project with a Sentio software controller.

probe_station = measmatic.GetDevice('device-probe-station')
probe_station.software_controller.create_project('myproject.trex')

method go_to_local()#

Switch probe station to local mode. Not all probe stations may support a local mode.

Example#

This command will enable the local mode of the probe station.

probe_station = measmatic.GetDevice('device-probe-station')
probe_station.software_controller.go_to_local()

method load_project(path: str)#

Load an existing project.

Parameters#

Name Description
path The path to the project file. (may be dependent different depending on the prober type)

Example#

Create a new project with a Sentio software controller.

probe_station = measmatic.GetDevice('device-probe-station')
probe_station.software_controller.load_project('myproject.trex')

method save_camera_image(path: str)#

Save a snapshot of a given camera. This functionality is only available if the probe station has a camera which is controlled by its software controller.

Parameters#

Name Description
path The path to the target image.

Example#

Create a new project with a Sentio software controller.

probe_station = measmatic.GetDevice('device-probe-station')
probe_station.software_controller.save_camera_image('myimage.jpg')

method save_project(path: str)#

Save the current project

Parameters#

Name Description
path This optional parameter is the path to the project file. If none is given project is saved to its current location.

Example#

Create a new project with a Sentio software controller.

probe_station = measmatic.GetDevice('device-probe-station')
probe_station.software_controller.save_project()

method set_view(view_name: str)#

Switch the software controller view.

Parameters#

Name Description
view_name A string representing the name of the view to switch to. Not all probe station controllers so support this

Example#

the following code will switch to SENTIO's vision module.

probe_station = measmatic.GetDevice('device-probe-station')
probe_station.software_controller.set_view('vision')

method show_message(message: str, caption: str, timeout_in_milliseconds: int)#

Display a message on the monitor controlled by the software controller.

Parameters#

Name Description
message A string representing the name of the view to switch to. Not all probe station controllers so support this
caption This is the caption of the message box. If the probe station does not allow setting a caption this parameter will
timeout_in_milliseconds The time after which the message will disappear. If the probe station does not support disappearing messages

Example#

The following command will open a window containing the text hello world. The window will be shown for 3 seconds.

probe_station = measmatic.GetDevice('device-probe-station')
probe_station.software_controller.show_message('hello world', 'My caption', 3000)