Keithley 2700 DMM
r3230 | dcl | 2011-07-05 16:23:52 +1000 (Tue, 05 Jul 2011) | 1 line
This commit is contained in:
Douglas Clowes
475
site_ansto/instrument/config/environment/sct_keithley_2700.tcl
Normal file
475
site_ansto/instrument/config/environment/sct_keithley_2700.tcl
Normal file
@@ -0,0 +1,475 @@
|
||||
# Define procs in ::scobj::xxx namespace
|
||||
# MakeSICSObj $obj SCT_<class>
|
||||
# The MakeSICSObj cmd adds a /sics/$obj node. NOTE the /sics node is not browsable.
|
||||
|
||||
|
||||
namespace eval ::scobj::k2700 {
|
||||
# Environment controllers should have at least the following nodes
|
||||
# /envcont/setpoint
|
||||
# /envcont/sensor/value
|
||||
proc debug_log {args} {
|
||||
set fd [open "/tmp/k2700.log" a]
|
||||
puts $fd "[clock format [clock seconds] -format "%T"] $args"
|
||||
close $fd
|
||||
}
|
||||
|
||||
# issue a command to read a register and expect a value response
|
||||
proc getValue {tc_root nextState cmd} {
|
||||
debug_log "getValue $cmd sct=[sct] root=$tc_root nextState=$nextState"
|
||||
sct send "$cmd"
|
||||
return $nextState
|
||||
}
|
||||
|
||||
proc setParm {tc_root nextState cmd} {
|
||||
debug_log "setParm root=$tc_root sct=[sct] cmd=$cmd target=[sct target]"
|
||||
set par "[sct target]"
|
||||
sct send "$cmd $par"
|
||||
debug_log "setParm send: $cmd $par"
|
||||
return idle
|
||||
return $nextState
|
||||
}
|
||||
|
||||
proc setText {tc_root nextState cmd} {
|
||||
debug_log "setText root=$tc_root sct=[sct] cmd=$cmd target=[sct target]"
|
||||
set par "[sct target]"
|
||||
sct send "$cmd \"$par\""
|
||||
debug_log "setText send: $cmd \"$par\""
|
||||
return idle
|
||||
return $nextState
|
||||
}
|
||||
|
||||
# issue a command with a value in the target property of the variable
|
||||
proc setValue {tc_root nextState cmd} {
|
||||
debug_log "setValue root=$tc_root sct=[sct] cmd=$cmd target=[sct target]"
|
||||
set par "[sct target]"
|
||||
sct send "$cmd $par"
|
||||
debug_log "setValue send: $cmd $par"
|
||||
return idle
|
||||
return $nextState
|
||||
}
|
||||
|
||||
proc chkWrite {tc_root} {
|
||||
set data [sct result]
|
||||
debug_log "chkWrite resp=$data sct=[sct] tc_root=$tc_root"
|
||||
if {[string equal -nocase -length 7 $data "ASCERR:"]} {
|
||||
sct geterror "$data"
|
||||
} elseif {[string equal -nocase -length 1 $data "?"]} {
|
||||
sct geterror "Error: $data"
|
||||
} else {
|
||||
set data [sct target]
|
||||
if {$data != [sct oldval]} {
|
||||
sct oldval $data
|
||||
sct update $data
|
||||
sct utime readtime
|
||||
debug_log "chkWrite new data for $tc_root [sct] result=$data"
|
||||
}
|
||||
}
|
||||
return idle
|
||||
}
|
||||
|
||||
proc setPoint {tc_root nextState cmd} {
|
||||
set catch_status [ catch {
|
||||
debug_log "setPoint $tc_root $nextState $cmd sct=[sct]"
|
||||
debug_log "setPoint: sct=[sct] target=[sct target] writestatus=[sct writestatus]"
|
||||
sct print "setPoint: sct=[sct] target=[sct target] writestatus=[sct writestatus]"
|
||||
set err_msg ""
|
||||
|
||||
if { $err_msg != "" } {
|
||||
sct print "error:$err_msg"
|
||||
debug_log "error:$err_msg"
|
||||
return -code error "$err_msg"
|
||||
}
|
||||
|
||||
set par "[sct target]"
|
||||
if {$par != [sct oldval]} {
|
||||
sct oldval $par
|
||||
sct update $par
|
||||
sct utime readtime
|
||||
debug_log "setPoint new data for $tc_root [sct] result=$par"
|
||||
}
|
||||
hset $tc_root/status "busy"
|
||||
sct print "status: busy"
|
||||
hset $tc_root/drive_state "START"
|
||||
} catch_message ]
|
||||
if {$catch_status != 0} {
|
||||
hsetprop $tc_root/setpoint driving 0
|
||||
return -code error $catch_message
|
||||
}
|
||||
sct print "setPoint: [hget $tc_root/drive_state]"
|
||||
return $nextState
|
||||
}
|
||||
|
||||
proc rdValue {tc_root} {
|
||||
debug_log "rdValue tc_root=$tc_root sct=[sct]"
|
||||
set data [sct result]
|
||||
if {[ catch {
|
||||
debug_log "rdValue $tc_root [sct] result=$data"
|
||||
} catch_message ]} {
|
||||
debug_log "rdValue $tc_root failure"
|
||||
}
|
||||
if {[string equal -nocase -length 7 $data "ASCERR:"]} {
|
||||
sct geterror "$data"
|
||||
set nextState idle
|
||||
} elseif {[string equal -nocase -length 1 $data "?"]} {
|
||||
sct geterror "Error: $data"
|
||||
set nextState idle
|
||||
} else {
|
||||
if { [hpropexists [sct] geterror] } {
|
||||
hdelprop [sct] geterror
|
||||
}
|
||||
set flds [split "$data" ","]
|
||||
scan [lindex $flds 0] "%f%s" value units
|
||||
debug_log "Read: $value $units from $data"
|
||||
if {$value != [sct oldval]} {
|
||||
sct oldval $value
|
||||
sct update $value
|
||||
sct utime readtime
|
||||
sct units $units
|
||||
debug_log "rdValue new data for $tc_root [sct] result=$value"
|
||||
}
|
||||
}
|
||||
return idle
|
||||
}
|
||||
|
||||
# This is the command phase of the state machine that drives the controller.
|
||||
# For each state, it sends the appropriate command to get values from, or set
|
||||
# values in the controller in a sequence intended to transition the controller
|
||||
# between states.
|
||||
proc getState {tc_root nextState cmd} {
|
||||
set my_state "[SplitReply [hgetprop $tc_root/device_state my_state]]"
|
||||
debug_log "getState $tc_root $nextState $cmd sct=[sct] state=$my_state"
|
||||
if {[ catch {
|
||||
if { [hpropexists [sct] geterror] } {
|
||||
hdelprop [sct] geterror
|
||||
}
|
||||
if {$my_state == "STATE_INIT"} {
|
||||
set my_cmd "SYSTEM:PRESET"
|
||||
hsetprop $tc_root/device_state my_state "STATE_IDN"
|
||||
#set nextState read
|
||||
set nextState idle
|
||||
} elseif {$my_state == "STATE_IDN"} {
|
||||
set my_cmd "*IDN?"
|
||||
} elseif {$my_state == "STATE_CHNL_SET"} {
|
||||
set my_cmd "SENS:FUNC \"VOLTS:DC\""
|
||||
set mmf [hval $tc_root/Control/MMF]
|
||||
set mbf [hval $tc_root/Control/MBF]
|
||||
set mun [hval $tc_root/Control/MUN]
|
||||
set my_cmd "CALC:FORM MXB;CALC:KMAT:MMF 1.0;CALC:KMAT:MBF 0.0;CALC:KMAT:MUN \"X\";CALC:STAT ON"
|
||||
hsetprop $tc_root/device_state my_state "STATE_CHNL_GET"
|
||||
#set nextState read
|
||||
set nextState idle
|
||||
} elseif {$my_state == "STATE_CHNL_GET"} {
|
||||
set my_cmd "CALC:STAT?"
|
||||
} elseif {$my_state == "STATE_FIELD"} {
|
||||
set my_cmd "FETCH?"
|
||||
} else {
|
||||
hsetprop $tc_root/device_state my_state "STATE_IDN"
|
||||
set my_cmd "*IDN?"
|
||||
}
|
||||
sct send "$my_cmd"
|
||||
debug_log "getState end $tc_root state=$my_state, cmd=$my_cmd"
|
||||
} catch_message ]} {
|
||||
debug_log "getState error: $catch_message"
|
||||
}
|
||||
set old_state $my_state
|
||||
set new_state "[SplitReply [hgetprop $tc_root/device_state my_state]]"
|
||||
if {"$new_state" != "$old_state"} {
|
||||
debug_log "getState change $old_state to $new_state"
|
||||
}
|
||||
debug_log "getState returns: $nextState"
|
||||
return $nextState
|
||||
}
|
||||
|
||||
# This is the response phase of the state machine that drives the controller.
|
||||
# For each state, it reads the appropriate command response from the controller
|
||||
# and, based on the response and internal variables performs a sequence
|
||||
# intended to transition the controller between states.
|
||||
|
||||
##
|
||||
# @brief Reads the current k2700 state and error messages.
|
||||
proc rdState {tc_root} {
|
||||
set my_state "[SplitReply [hgetprop $tc_root/device_state my_state]]"
|
||||
debug_log "rdState $tc_root sct=[sct] state=$my_state response=\"[sct result]\""
|
||||
set nextState {}
|
||||
if {[ catch {
|
||||
if { [hpropexists [sct] geterror] } {
|
||||
hdelprop [sct] geterror
|
||||
}
|
||||
set data "[sct result]"
|
||||
if {[string equal -nocase -length 7 $data "ASCERR:"]} {
|
||||
sct geterror "$data"
|
||||
set nextState idle
|
||||
} elseif {[string equal -nocase -length 1 $data "?"]} {
|
||||
sct geterror "Error: $data"
|
||||
set nextState idle
|
||||
} else {
|
||||
debug_log "rdState $tc_root state=$my_state, response=\"[sct result]\""
|
||||
if {$my_state == "STATE_INIT"} {
|
||||
hsetprop $tc_root/device_state my_state "STATE_IDN"
|
||||
set nextState read
|
||||
} elseif {$my_state == "STATE_IDN"} {
|
||||
set my_version "[sct result]"
|
||||
hsetprop $tc_root/device_state my_version "$my_version"
|
||||
hsetprop $tc_root/device_state my_state "STATE_CHNL_SET"
|
||||
set nextState read
|
||||
} elseif {$my_state == "STATE_CHNL_SET"} {
|
||||
hsetprop $tc_root/device_state my_state "STATE_CHNL_GET"
|
||||
set nextState read
|
||||
} elseif {$my_state == "STATE_CHNL_GET"} {
|
||||
hsetprop $tc_root/device_state my_state "STATE_FIELD"
|
||||
hsetprop [sct] chnl [sct result]
|
||||
set nextState read
|
||||
} elseif {$my_state == "STATE_FIELD"} {
|
||||
hset $tc_root/Setpoint "$data"
|
||||
hsetprop $tc_root/device_state my_state "STATE_FIELD"
|
||||
set nextState idle
|
||||
}
|
||||
}
|
||||
if { $nextState == "" } {
|
||||
set nextState idle
|
||||
}
|
||||
} catch_message ]} {
|
||||
debug_log "rdState error: $catch_message"
|
||||
}
|
||||
set old_state $my_state
|
||||
set new_state "[SplitReply [hgetprop $tc_root/device_state my_state]]"
|
||||
if {"$new_state" != "$old_state"} {
|
||||
debug_log "rdState change $old_state to $new_state"
|
||||
}
|
||||
if { "$nextState" == "" } {
|
||||
set nextState "idle"
|
||||
}
|
||||
debug_log "rdState returns: $nextState"
|
||||
return $nextState
|
||||
}
|
||||
|
||||
proc noResponse {} {
|
||||
return idle
|
||||
}
|
||||
proc wrtValue {wcmd args} {
|
||||
}
|
||||
|
||||
# check that a target is within allowable limits
|
||||
proc check {tc_root} {
|
||||
return OK
|
||||
}
|
||||
|
||||
# Check that the sensor is reading within tolerance of the setpoint.
|
||||
# Return 1 or 0 if it is or is not, respectively.
|
||||
proc checktol {tc_root currtime timecheck} {
|
||||
debug_log "checktol $tc_root $currtime $timecheck"
|
||||
return 1
|
||||
}
|
||||
|
||||
##
|
||||
# @brief Implement the checkstatus command for the drivable interface
|
||||
#
|
||||
# NOTE: The drive adapter initially sets the writestatus to "start" and will
|
||||
# only call this when writestatus!="start"
|
||||
proc drivestatus {tc_root} {
|
||||
if {[sct driving]} {
|
||||
return busy
|
||||
} else {
|
||||
sct print "drivestatus: idle"
|
||||
return idle
|
||||
}
|
||||
}
|
||||
|
||||
proc halt {tc_root} {
|
||||
debug_log "halt $tc_root"
|
||||
sct print "halt $tc_root"
|
||||
set my_driving [SplitReply [hgetprop $tc_root/setpoint driving]]
|
||||
hset $tc_root/drive_state "HALT"
|
||||
hsetprop $tc_root/device_state my_state "STATE_X"
|
||||
if { $my_driving } {
|
||||
hsetprop $tc_root/device_state my_state "STATE_A0"
|
||||
return read
|
||||
}
|
||||
return idle
|
||||
}
|
||||
|
||||
##
|
||||
# @brief createNode() creates a node for the given nodename with the properties and virtual
|
||||
# function names provided
|
||||
# @param scobj_hpath string variable holding the path to the object's base node in sics (/sample/tc1)
|
||||
# @param sct_controller name of the scriptcontext object (typically sct_xxx_yyy)
|
||||
# @param cmdGroup subdirectory (below /sample/tc*/) in which the node is to be created
|
||||
# @param varName name of the actual node typically representing one device command
|
||||
# @param readable set to 1 if the node represents a query command, 0 if it is not
|
||||
# @param writable set to 1 if the node represents a request for a change in settings sent to the device
|
||||
# @param drivable if set to 1 it prepares the node to provide a drivable interface
|
||||
# @param dataType data type of the node, must be one of none, int, float, text
|
||||
# @param permission defines what user group may read/write to this node (is one of spy, user, manager)
|
||||
# @param rdCmd actual device query command to be sent to the device
|
||||
# @param rdFunc nextState Function to be called after the getValue function, typically rdValue()
|
||||
# @param wrCmd actual device write command to be sent to the device
|
||||
# @param wrFunc Function to be called to send the wrCmd to the device, typically setValue()
|
||||
# @param allowedValues allowed values for the node data - does not permit other
|
||||
# @param klass Nexus class name (?)
|
||||
# @return OK
|
||||
proc createNode {scobj_hpath sct_controller cmdGroup varName readable writable\
|
||||
drivable dataType permission rdCmd rdFunc wrCmd\
|
||||
wrFunc allowedValues klass} {
|
||||
|
||||
set catch_status [ catch {
|
||||
# set ns ::scobj::k2700
|
||||
set ns "[namespace current]"
|
||||
set nodeName "$scobj_hpath/$cmdGroup/$varName"
|
||||
if {1 > [string length $cmdGroup]} {
|
||||
set nodeName "$scobj_hpath/$varName"
|
||||
}
|
||||
debug_log "Creating node $nodeName"
|
||||
hfactory $nodeName plain $permission $dataType
|
||||
if {$readable > 0} {
|
||||
hsetprop $nodeName read ${ns}::getValue $scobj_hpath $rdFunc $rdCmd
|
||||
hsetprop $nodeName $rdFunc ${ns}::$rdFunc $scobj_hpath
|
||||
set poll_period 30
|
||||
if { $readable >= 0 && $readable <= 9 } {
|
||||
set poll_period [lindex [list 0 1 2 3 4 5 10 15 20 30] $readable]
|
||||
}
|
||||
debug_log "Registering node $nodeName for poll at $poll_period seconds"
|
||||
$sct_controller poll $nodeName $poll_period
|
||||
}
|
||||
if {$writable == 1} {
|
||||
set parts [split "$wrFunc" "."]
|
||||
if { [llength $parts] == 2 } {
|
||||
set func_name [lindex $parts 0]
|
||||
set next_state [lindex $parts 1]
|
||||
hsetprop $nodeName write ${ns}::$func_name $scobj_hpath $next_state $wrCmd
|
||||
hsetprop $nodeName $next_state ${ns}::$next_state $scobj_hpath
|
||||
} else {
|
||||
hsetprop $nodeName write ${ns}::$wrFunc $scobj_hpath noResponse $wrCmd
|
||||
hsetprop $nodeName noResponse ${ns}::noResponse
|
||||
}
|
||||
hsetprop $nodeName writestatus UNKNOWN
|
||||
debug_log "Registering node $nodeName for write callback"
|
||||
$sct_controller write $nodeName
|
||||
}
|
||||
switch -exact $dataType {
|
||||
"none" { }
|
||||
"int" { hsetprop $nodeName oldval -1 }
|
||||
"float" { hsetprop $nodeName oldval -1.0 }
|
||||
default { hsetprop $nodeName oldval UNKNOWN }
|
||||
}
|
||||
if {1 < [string length $allowedValues]} {
|
||||
hsetprop $nodeName values $allowedValues
|
||||
}
|
||||
# Drive adapter interface
|
||||
if {$drivable == 1} {
|
||||
hsetprop $nodeName check ${ns}::check $scobj_hpath
|
||||
hsetprop $nodeName driving 0
|
||||
hsetprop $nodeName checklimits ${ns}::check $scobj_hpath
|
||||
hsetprop $nodeName checkstatus ${ns}::drivestatus $scobj_hpath
|
||||
hsetprop $nodeName halt ${ns}::halt $scobj_hpath
|
||||
}
|
||||
} message ]
|
||||
if {$catch_status != 0} {
|
||||
return -code error "in createNode $message"
|
||||
}
|
||||
return OK
|
||||
}
|
||||
|
||||
proc mk_sct_keithley_2700 {sct_controller klass tempobj} {
|
||||
set catch_status [ catch {
|
||||
# set ns ::scobj::k2700
|
||||
set ns "[namespace current]"
|
||||
|
||||
MakeSICSObj $tempobj SCT_OBJECT
|
||||
sicslist setatt $tempobj klass $klass
|
||||
sicslist setatt $tempobj long_name $tempobj
|
||||
|
||||
set scobj_hpath /sics/$tempobj
|
||||
# Group Node R W D type perm rdCmd rdFunc wrCmd wrFunc allowed
|
||||
set deviceCommand {\
|
||||
Control Math 0 1 0 text user {} {} {CALC:FORM} {setParm} {MXB}\
|
||||
Control MMF 0 1 0 float user {} {} {CALC:KMAT:MMF} {setValue} {}\
|
||||
Control MBF 0 1 0 float user {} {} {CALC:KMAT:MBF} {setValue} {}\
|
||||
Control MUN 0 1 0 text user {} {} {CALC:KMAT:MUN} {setText} {}\
|
||||
Control Stat 0 1 0 text user {} {} {CALC:STAT} {setParm} {ON,OFF}\
|
||||
Display Value 1 0 0 text internal {FETCH?} {rdValue} {} {} {}\
|
||||
{} Setpoint 0 0 0 text internal {} {} {} {} {}\
|
||||
Display X 0 0 0 text internal {} {} {} {} {}\
|
||||
}
|
||||
|
||||
hfactory $scobj_hpath/Control plain spy none
|
||||
hfactory $scobj_hpath/Display plain spy none
|
||||
|
||||
foreach {cmdGroup varName readable writable drivable dataType permission rdCmd rdFunc wrCmd wrFunc allowedValues} $deviceCommand {
|
||||
createNode $scobj_hpath $sct_controller $cmdGroup $varName $readable $writable $drivable $dataType $permission $rdCmd $rdFunc $wrCmd $wrFunc $allowedValues $klass
|
||||
}
|
||||
|
||||
hfactory $scobj_hpath/status plain spy text
|
||||
hset $scobj_hpath/status "idle"
|
||||
hsetprop $scobj_hpath/status values busy,idle
|
||||
|
||||
hfactory $scobj_hpath/device_state plain spy text
|
||||
hsetprop $scobj_hpath/device_state read ${ns}::getState $scobj_hpath rdState "X"
|
||||
hsetprop $scobj_hpath/device_state rdState ${ns}::rdState $scobj_hpath
|
||||
hsetprop $scobj_hpath/device_state oldval "UNKNOWN"
|
||||
hsetprop $scobj_hpath/device_state my_state "STATE_FIELD"
|
||||
hsetprop $scobj_hpath/device_state my_status "UNKNOWN"
|
||||
hsetprop $scobj_hpath/device_state my_version "UNKNOWN"
|
||||
|
||||
hfactory $scobj_hpath/drive_state plain mugger text
|
||||
hset $scobj_hpath/drive_state "UNKNOWN"
|
||||
|
||||
hfactory $scobj_hpath/remote_ctrl plain spy text
|
||||
hset $scobj_hpath/remote_ctrl "UNKNOWN"
|
||||
|
||||
hfactory $scobj_hpath/device_lasterror plain user text
|
||||
hset $scobj_hpath/device_lasterror ""
|
||||
|
||||
# if {[SplitReply [environment_simulation]]=="false"} {
|
||||
# $sct_controller poll $scobj_hpath/device_state 1 halt read
|
||||
# }
|
||||
|
||||
hsetprop $scobj_hpath type part
|
||||
foreach snsr {Display} {
|
||||
foreach {rootpath hpath klass priv} "\
|
||||
$scobj_hpath $snsr NXsensor spy\
|
||||
$scobj_hpath $snsr/Value sensor user\
|
||||
" {
|
||||
hsetprop $rootpath/$hpath klass $klass
|
||||
hsetprop $rootpath/$hpath privilege $priv
|
||||
hsetprop $rootpath/$hpath control true
|
||||
hsetprop $rootpath/$hpath data true
|
||||
hsetprop $rootpath/$hpath nxsave true
|
||||
}
|
||||
hsetprop $scobj_hpath/$snsr type part
|
||||
hsetprop $scobj_hpath/$snsr/value nxalias mm1_${snsr}_value
|
||||
hsetprop $scobj_hpath/$snsr/value mutable true
|
||||
hsetprop $scobj_hpath/$snsr/value sdsinfo ::nexus::scobj::sdsinfo
|
||||
}
|
||||
hsetprop $scobj_hpath privilege spy
|
||||
# ::scobj::hinitprops $tempobj setpoint
|
||||
} catch_message ]
|
||||
if {$catch_status != 0} {
|
||||
return -code error $catch_message
|
||||
}
|
||||
}
|
||||
namespace export mk_sct_keithley_2700
|
||||
}
|
||||
|
||||
##
|
||||
# @brief Create a Keithley 2700 Multimeter
|
||||
#
|
||||
# @param name, the name of the multimeter (eg mm1)
|
||||
# @param IP, the IP address of the device, this can be a hostname, (eg ca1-kowari)
|
||||
# @param port, the IP protocol port number of the device
|
||||
proc add_k2700 {name IP port terminator} {
|
||||
set fd [open "/tmp/k2700.log" a]
|
||||
if {[SplitReply [environment_simulation]]=="false"} {
|
||||
puts $fd "makesctcontroller sct_k2700 oxford ${IP}:$port"
|
||||
makesctcontroller sct_k2700 oxford ${IP}:$port $terminator
|
||||
}
|
||||
puts $fd "mk_sct_keithley_2700 sct_k2700 environment $name"
|
||||
mk_sct_keithley_2700 sct_k2700 environment $name
|
||||
close $fd
|
||||
}
|
||||
|
||||
puts stdout "file evaluation of sct_keithley_2700.tcl"
|
||||
set fd [open "/tmp/k2700.log" w]
|
||||
puts $fd "file evaluation of sct_keithley_2700.tcl"
|
||||
close $fd
|
||||
|
||||
namespace import ::scobj::k2700::*
|
||||
Reference in New Issue
Block a user