msl.equipment.resources.greisinger.gmh3000 module

Communicate with a Greisinger GMH 3000 Series thermometer.

class msl.equipment.resources.greisinger.gmh3000.GMH3000(record: EquipmentRecord)[source]

Bases: ConnectionSerial

Communicate with a Greisinger GMH 3000 Series thermometer.

The properties for a thermometer connection supports the following key-value pairs in the Connections Database:

'gmh_address': int, The GMH address of the device [default: 1]

Do not instantiate this class directly. Use the connect() method to connect to the equipment.

Parameters:

record (EquipmentRecord) – A record from an Equipment-Register Database.

channel_count() → int[source]

Get the number of channels.

Returns:

int – The channel count.

clear_max_value() → float[source]

Clear the maximum value stored in the device memory.

Returns:

float – The current value.

clear_min_value() → float[source]

Clear the minimum value stored in the device memory.

Returns:

float – The current value.

display_range() → tuple[float, float][source]

Get the range of the display.

Returns:

  • float – The minimum value that the device can display.

  • float – The maximum value that the device can display.

firmware_version() → tuple[int, int][source]

Get the version information of the firmware.

Returns:

  • int – The version number.

  • int – The version identifier.

id_number() → str[source]

Get the device ID (serial) number.

Returns:

str – The ID (serial) number of the device.

max_value() → float[source]

Get the maximum value that has been read.

Returns:

float – The maximum value that has been read since the device was turn on or since clear_max_value() was called.

measurement_range() → tuple[float, float][source]

Get the measurement range.

Returns:

  • float – The minimum value that the device can measure.

  • float – The maximum value that the device can measure.

min_value() → float[source]

Get the minimum value that has been read.

Returns:

float – The minimum value that has been read since the device was turn on or since clear_min_value() was called.

offset_correction() → float[source]

Get the offset-correction value.

The zero point (intercept in a linear calibration equation) of the measurement will be displaced by this value to compensate for deviations in the temperature probe or in the measuring device.

Returns:

float – The offset-correction value.

power_off_time() → int[source]

Get the power-off time.

Returns:

int – The number of minutes that the device will automatically power off as soon as this time has elapsed if no key is pressed or if no interface communication takes place. A value of 0 means that power off is disabled.

resolution() → int[source]

Get the measurement resolution.

Returns:

int – The number of digits after the decimal point that is acquired for the measured value.

scale_correction() → float[source]

Get the scale-correction factor.

The scale (slope in a linear calibration equation) of the measurement will be changed by this factor to compensate for deviations in the temperature probe or in the measuring device.

Returns:

float – The scale-correction factor.

set_power_off_time(minutes: int) → int[source]

Set the power-off time.

Parameters:

minutes (int) – The number of minutes that the device will automatically power off as soon as this time has elapsed if no key is pressed or if no interface communication takes place. A value of 0 means that power off is disabled.

Returns:

int – The actual power-off time that the device was set to. If you set the power-off time to a value greater than the maximum time allowed, the device automatically coerces the value to be the maximum time.

status() → int[source]

Get the system status.

The status value represents a bit mask:

Index

Value

Description

0

1

Max. alarm

1

2

Min. alarm

2

4

Display range overrun

3

8

Display range underrun

4

16

Reserved

5

32

Reserved

6

64

Reserved

7

128

Reserved

8

256

Measuring range overrun

9

512

Measuring range underrun

10

1024

Sensor error

11

2048

Reserved

12

4096

System fault

13

8192

Calculation not possible

14

16384

Reserved

15

32768

Low battery
Returns:

int – The system status.

unit() → str[source]

Get the measurement unit.

Returns:

str – The measurement unit.

value() → float[source]

Get the current measurement value.

Returns:

float – The current value.