DEVICE
DRIVERS
FUNCTIONS
(FUNCTIONS FOR THE MODEL 5C7-361, 5C7-362
and 5C7-366 TEMPERATURE
CONTROLLER)
SESSION FUNCTIONS
OPEN SESSION -
sessionOpen
oi7_sessionOpen(rsrcName
As String, modelNumber
As String, validDevAddr As Integer) As Long
rsrcName
A VISA resource string.
For COM1 use "ASRL1::INSTR".
For COM2 use "ASRL2::INSTR".
Examples: "GPIB0::4::INSTR" or "ASRL1::INSTR"
modelNumber
An Oven Industries' temperature controller model number.
Example: "5C7-366"
validDevAddr
The RS-485 address of an active temperature controller. The device
driver will establish communications with this controller in order to
determine
if it (the device driver) is able to communicate with the RS-485 loop.
Valid values are -1 to cancel this feature, 0 (zero) if there is only
one
temperature controller, or a number from 1 thru 98.
Example:
oi7_sessionOpen("ASRL1::INSTR", "5C7-366", 1)
CLOSE SESSION
- sessionClose
oi7_sessionClose() As Long
SESSION ERROR
- read
SessionError
READ: oi7_readSessionError(errorNumber
As
Long,errorSource as String, errorDescription as String)
As
Long
SAMPLING FUNCTIONS
INPUT1 - read
Temperature
READ: oi7_readTemperature(RS485Addr
As Integer, temperature As Single) as long
DESIRED CONTROL VALUE - read
TemperatureSetPoint
READ: oi7_readTemperatureSetPoint(RS485Addr
As Integer, temperature As Single) As Long
DISCUSSION:
TemperatureSetPoint is always your actual
set point temperature.
This is read only.
TemperatureSetPoint corresponds to what
Oven Industries calls
the DESIRED CONTROL VALUE in their controller SERIAL COMMUNICATIONS
documentation..
TemperatureSet is the same as TemperatureSetPoint
with
some controllers. However, if your controller is capable of using two
sensors
and if it is capable of differential control, the actual set point
would
be a temperature settting that is influenced by a couple of factors. If
the temperature is being set by an external potentiometer, then TemperatureSet
is meaningless.
TemperatureSet corresponds to what Oven
Industries calls the
FIXED DESIRED CONTROL VALUE in their controller SERIAL COMMUNICATIONS
documentation.
If you have used the Oven Industries' Setup program, this corresponds
to
the FIXED SET TEMP field.
Use oi7_setTemperatureSet to set the
fixed set temperature value.
And then you can use oi7_readTemperatureSet to check on your
setting.
Even though, with some controllers, oi7_readTemperatureSetPoint
and oi7_readTemperatureSet return the same result, use oi7_readTemperatureSetPoint
to determine the current set point temperature for display, graphing or
logging. That way your software still functions correctly even if you
later
use second sensor and differential control features, or external
control
features.
POWER OUTPUT -
read
OutputPower - (Percentage: -100 to
+100)
READ: oi7_readOutputPower(RS485Addr
As Integer, percentOutput
As Single) As Long
ALARM STATUS -
read
AlarmStatus - (0, 1, 2 = No alarm, High, Low)
READ: oi7_readAlarmStatus(RS485Addr
As Integer, alarmStatus
As Integer) As Long
TUNING FUNCTIONS
FIXED DESIRED CONTROL
SETTING
If Control Type is Deadband or PID - set/read
TemperatureSet - (temperature)
WRITE: oi7_setTemperatureSet(RS485Addr
As
Integer, temperature As Single) As Long
READ: oi7_readTemperatureSet(RS485Addr As
Integer, temperature As Single) As Long
If Control Type is Differential - set/read
TemperatureDifferentialSet - (As
temperature value)
WRITE:
oi7_setTemperatureDifferentialSet(RS485Addr
As Integer, temperature As Single) As Long
READ: oi7_readTemperatureDifferentialSet(RS485Addr
As Integer, temperature As Single) As Long
If Control Type is Computer - set/read OutputPowerSet
- (As percentage: -100.0 to 100.0)
WRITE: oi7_setOutputPowerSet(RS485Addr
As
Integer, powerLevel As Single) As Long
READ: oi7_readOutputPowerSet(RS485Addr As
Integer, powerLevel As Single) As Long
PROPORTIONAL BANDWIDTH
- set/read
PIDProportionalBandwidth
WRITE:
oi7_setPIDProportionalBandwidth(RS485Addr
As Integer, temperature As Single) As Long
READ: oi7_readPIDProportionalBandwidth(RS485Addr
As Integer, temperature As Single) As Long
INTEGRAL GAIN
- set/read
PIDIntegralGain - (repeats
per minute)
WRITE: oi7_setPIDIntegralGain(RS485Addr
As
Integer, repeatsPerMinute As Single) As Long
READ: oi7_readPIDIntegralGain(RS485Addr
As Integer, repeatsPerMinute As Single) As Long
DERIVATIVE GAIN
- set/read
PIDDerivativeGain - (cycles
per minute)
WRITE: oi7_setPIDDerivativeGain(RS485Addr
As Integer, minutes As Single) As Long
READ: oi7_readPIDDerivativeGain(RS485Addr
As Integer, minutes As Single) As Long
CONTROL DEADBAND SETTING
- set/read
Deadband
WRITE: oi7_setDeadband(RS485Addr
As Integer, temperature
As Single) As Long
READ: oi7_readDeadband(RS485Addr As
Integer, temperature As Single) As Long
CALIBRATION FUNCTIONS
INPUT1 OFFSET
- set/read
Input1Offset
WRITE: oi7_setInput1Offset(RS485Addr
As Integer, temperature
As Single) As Long
READ: oi7_readInput1Offset(RS485Addr
As Integer, temperature As Single) As Long
HEAT MULTIPLIER
- set/read
OutputHeatSideMultiplier - (0.00 to
1.00)
WRITE:
oi7_setOutputHeatSideMultiplier(RS485Addr
As Integer, multiplier As Single) As Long
READ: oi7_readOutputHeatSideMultiplier(RS485Addr
As Integer, multiplier As Single) As Long
CONFIGURATION FUNCTIONS
POWER ON/OFF -
set/read
OutputPowerOnOff - (True, False)
WRITE: oi7_setOutputPowerOnOff(RS485Addr
As
Integer, enabled As Boolean) As Long
READ: oi7_readOutputPowerOnOff(RS485Addr
As Integer, enabled As Boolean) As Long
CONTROL TYPE -
set/read
ControlType - (0, 1, 2 = Deadband, PID, Computer)
WRITE: oi7_setControlType(RS485Addr
As Integer, controlType
As Integer) As Long
READ: oi7_readControlType(RS485Addr
As Integer, controlType As Integer) As Long
RS485 ADDRESS
- set/read
AddressOfDevice - (1 to 98)
WRITE: oi7_setAddressOfDevice(RS485Addr
As
Integer, address As Integer) As Long
READ: oi7_readAddressOfDevice(RS485Addr
As Integer, address As Integer) As Long
ALARM FUNCTIONS
ALARM LATCH RESET
- alarmLatchReset
oi7_alarmLatchReset(RS485Addr
As Integer)
As Long
ALARM TYPE - set/read
AlarmType - (0, 1, 2 = None, Tracking, Fixed)
WRITE: oi7_setAlarmType(RS485Addr
As Integer, alarmType
As Integer) As Long
READ: oi7_readAlarmType(RS485Addr As
Integer, alarmType As Integer) As Long
OUTPUT SHUTDOWN IF ALARM
- set/read
AlarmShutsDownOutput - (True, False)
WRITE:
oi7_setAlarmShutsDownOutput(RS485Addr
As Integer, enabled As Boolean) As Long
READ: oi7_readAlarmShutsDownOutput(RS485Addr
As Integer, enabled As Boolean) As Long
HIGH ALARM SETTING
- set/read
AlarmSetHigh - (temperature)
WRITE: oi7_setAlarmSetHigh(RS485Addr
As Integer, temperature
As Single) As Long
READ: oi7_readAlarmSetHigh(RS485Addr
As Integer, temperature As Single) As Long
LOW ALARM SETTING
- set/read AlarmSetLow
- (temperature)
WRITE: oi7_setAlarmSetLow(RS485Addr
As Integer, temperature
As Single) As Long
READ: oi7_readAlarmSetLow(RS485Addr
As Integer, temperature As Single) As Long
ALARM DEADBAND
- set/read
AlarmDeadband
WRITE: oi7_setAlarmDeadband(RS485Addr
As Integer, temperature
As Single) As Long
READ: oi7_readAlarmDeadband(RS485Addr
As Integer, temperature As Single) As Long
ALARM LATCH ENABLE
- set/read
AlarmLatchEnable - (True, False)
WRITE: oi7_setAlarmLatchEnable(RS485Addr
As
Integer, enabled As Boolean) As Long
READ: oi7_readAlarmLatchEnable(RS485Addr
As Integer, enabled As Boolean) As Long
|
Device
Drivers
