Sensoray 2600 - Manual (Page 47)

Sensoray 2600 Programming Guide
43
Gateway Action Scheduling
Benchmark: << 0.1 ms (no network transactions used).
Notes: This function converts the specified channel’s raw digitized value, which was previously acquired by calling
S26_Sched2612_RefreshData() , to a corrected value. The corrected value is computed by this function as
follows:
corrected_value = (raw_value - offset) * scale - tare
The offset , scale and tare values, and consequently the engineering units that apply to the returned value,
must have been previously established by calling S26_2612_RegisterZero() , S26_2612_RegisterSpan() and
S26_2612_RegisterTare() , or set with S26_2612_SetCalibrations() .
Note that this function performs its action when called, unlike many other middlware functions that simply
schedule future actions.
Example: // Get calibrated value on the 2612 at MM number 0, IOM port 10, channel 2.
S26_2612_GetCalibratedValue( 0, 10, 2, sample_pointer );
7.6.11 S26_2612_GetOffset()
Returns the offset value for one channel on a model 2612 IOM.
Prototype: double S26_2612_GetOffset( u32 hbd, IOMPORT IomPort, u8 chan );
Returns: Offset value.
Benchmark: << 0.1 ms (no network transactions used).
Notes: This function returns the offset calibration parameter from a previously calibrated channel. The returned value
can be used by S26_2612_SetCalibrations() to restore a channel calibration without having to perform a
physical calibration.
Note that this function performs its action when called, unlike many other middlware functions that simply
schedule future actions.
Example: // Get offset value on the 2612 at MM number 0, IOM port 10, channel 2.
S26_2612_GetOffset( 0, 10, 2 );
7.6.12 S26_2612_GetScale()
Returns the scale value for one channel on a model 2612 IOM.
Prototype: double S26_2612_GetScale( u32 hbd, IOMPORT IomPort, u8 chan );
Returns: Scale value.
Benchmark: << 0.1 ms (no network transactions used).
Parameter Type Description
hbd u32 MM handle.
IomPort u8 The IOM port number (on the MM) to which the target IOM is connected.
chan u8 The channel number that is to be registered. Legal values range from 0 to 3.
Parameter Type Description
hbd u32 MM handle.
IomPort u8 The IOM port number (on the MM) to which the target IOM is connected.
chan u8 The channel number that is to be registered. Legal values range from 0 to 3.