first pass Autolab SC driver
r3082 | dcl | 2011-03-24 16:25:52 +1100 (Thu, 24 Mar 2011) | 1 line
This commit is contained in:
Douglas Clowes
423
site_ansto/instrument/config/environment/sct_autolab.tcl
Executable file
423
site_ansto/instrument/config/environment/sct_autolab.tcl
Executable file
@@ -0,0 +1,423 @@
|
||||
# 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::autolab {
|
||||
# Environment controllers should have at least the following nodes
|
||||
# /envcont/setpoint
|
||||
# /envcont/sensor/value
|
||||
proc debug_log {args} {
|
||||
set fd [open "../log/autolab.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
|
||||
}
|
||||
|
||||
# issue a command with a value in the target property of the variable
|
||||
proc setValue {tc_root nextState cmd} {
|
||||
debug_log "setValue cmd=$cmd sct=[sct] $tc_root"
|
||||
set par "[sct target]"
|
||||
sct send "$cmd $par"
|
||||
debug_log "setValue $cmd $par"
|
||||
return $nextState
|
||||
}
|
||||
|
||||
proc setCell {tc_root nextState cmd} {
|
||||
debug_log "setCell cmd=$cmd [sct target] sct=[sct] $tc_root"
|
||||
set par [string tolower [sct target]]
|
||||
if {$par == "on" || $par == "off"} {
|
||||
sct send "$cmd $par"
|
||||
}
|
||||
debug_log "setCell $cmd$par"
|
||||
return $nextState
|
||||
}
|
||||
|
||||
proc setMode {tc_root nextState cmd} {
|
||||
debug_log "setMode cmd=$cmd [sct target] sct=[sct] $tc_root"
|
||||
set par [string tolower [sct target]]
|
||||
if {$par == "potentiostat" || $par == "galvanostat"} {
|
||||
sct send "$par"
|
||||
}
|
||||
debug_log "setMode $par"
|
||||
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 { [hval $tc_root/Control/Pallet_Nam] != "A" && [hval $tc_root/Control/Pallet_Nam] != "B" } {
|
||||
set err_msg "Invalid Pallet_ Num: [hval $tc_root/Control/Pallet_Nam]"
|
||||
} elseif { [hval $tc_root/Control/Pallet_Idx] < 1 || [hval $tc_root/Control/Pallet_Idx] > 50 } {
|
||||
set err_msg "Invalid Pallet_Idx: [hval $tc_root/Control/Pallet_Idx]"
|
||||
}
|
||||
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"
|
||||
}
|
||||
if { [sct target] == 1 } {
|
||||
if { [string toupper [hval $tc_root/Control/Target_Loc]] == "BEAM" } {
|
||||
set cmd "SampToBeam [hval $tc_root/Control/Pallet_Nam] [hval $tc_root/Control/Pallet_Idx]"
|
||||
debug_log "sct send $cmd"
|
||||
sct send "$cmd"
|
||||
} elseif { [string toupper [hval $tc_root/Control/Target_Loc]] == "VACUUM" } {
|
||||
set cmd "SampToVac [hval $tc_root/Control/Pallet_Nam] [hval $tc_root/Control/Pallet_Idx]"
|
||||
debug_log "sct send $cmd"
|
||||
sct send "$cmd"
|
||||
} else {
|
||||
set err_msg "Invalid Target_Loc: [hval $tc_root/Control/Target_Loc]"
|
||||
sct print "error:$err_msg"
|
||||
debug_log "error:$err_msg"
|
||||
return -code error "$err_msg"
|
||||
}
|
||||
} elseif { [sct target] == 0 } {
|
||||
if { [string toupper [hval $tc_root/Control/Target_Loc]] == "BEAM" } {
|
||||
set cmd "SampRtn [hval $tc_root/Control/Pallet_Nam] [hval $tc_root/Control/Pallet_Idx]"
|
||||
debug_log "sct send $cmd"
|
||||
sct send "$cmd"
|
||||
} elseif { [string toupper [hval $tc_root/Control/Target_Loc]] == "VACUUM" } {
|
||||
set cmd "VacRtn [hval $tc_root/Control/Pallet_Nam] [hval $tc_root/Control/Pallet_Idx]"
|
||||
debug_log "sct send $cmd"
|
||||
sct send "$cmd"
|
||||
} else {
|
||||
set err_msg "Invalid Target_Loc: [hval $tc_root/Control/Target_Loc]"
|
||||
sct print "error:$err_msg"
|
||||
debug_log "error:$err_msg"
|
||||
return -code error "$err_msg"
|
||||
}
|
||||
} else {
|
||||
set err_msg "Invalid DRIVE target: [sct target]"
|
||||
sct print "error:$err_msg"
|
||||
debug_log "error:$err_msg"
|
||||
return -code error "$err_msg"
|
||||
}
|
||||
hset $tc_root/status "busy"
|
||||
sct print "status: busy"
|
||||
hsetprop $tc_root/setpoint driving 1
|
||||
} catch_message ]
|
||||
if {$catch_status != 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
|
||||
}
|
||||
if {$data != [sct oldval]} {
|
||||
debug_log "rdValue new data for $tc_root [sct] was=[sct oldval] now=$data"
|
||||
sct oldval $data
|
||||
sct update $data
|
||||
sct utime readtime
|
||||
}
|
||||
}
|
||||
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} {
|
||||
debug_log "getState $tc_root $nextState $cmd sct=[sct]"
|
||||
if {[ catch {
|
||||
if { [hpropexists [sct] geterror] } {
|
||||
hdelprop [sct] geterror
|
||||
}
|
||||
debug_log "getState sends: $cmd"
|
||||
sct send "$cmd"
|
||||
} catch_message ]} {
|
||||
debug_log "getState error: $catch_message"
|
||||
}
|
||||
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 autolab state and error messages.
|
||||
proc rdState {tc_root} {
|
||||
debug_log "rdState $tc_root sct=[sct] response=\"[sct result]\""
|
||||
set nextState {}
|
||||
if {[ catch {
|
||||
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 {
|
||||
set my_driving [SplitReply [hgetprop $tc_root/setpoint driving]]
|
||||
if { $my_driving } {
|
||||
if { [string toupper [sct result]] == "IDLE" } {
|
||||
hset $tc_root/status "idle"
|
||||
hsetprop $tc_root/setpoint driving 0
|
||||
hset $tc_root/sensor/value [hval $tc_root/setpoint]
|
||||
if {[hval $tc_root/Control/Rotate] > 0} {
|
||||
hset $tc_root/Control/Rotate 0
|
||||
}
|
||||
}
|
||||
}
|
||||
}
|
||||
} catch_message ]} {
|
||||
debug_log "rdState error: $catch_message"
|
||||
}
|
||||
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} {
|
||||
set setpoint [sct target]
|
||||
set lolimit [hval $tc_root/lowerlimit]
|
||||
set hilimit [hval $tc_root/upperlimit]
|
||||
if {$setpoint < $lolimit || $setpoint > $hilimit} {
|
||||
error "setpoint violates limits"
|
||||
}
|
||||
return OK
|
||||
}
|
||||
|
||||
##
|
||||
# @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 {[hval $tc_root/status] == "busy"} {
|
||||
return busy
|
||||
} elseif {[sct driving]} {
|
||||
return busy
|
||||
} else {
|
||||
return idle
|
||||
}
|
||||
}
|
||||
|
||||
proc halt {tc_root} {
|
||||
debug_log "halt $tc_root"
|
||||
sct print "halt $tc_root"
|
||||
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 nexus gumtree\
|
||||
drivable dataType permission rdCmd rdFunc wrCmd\
|
||||
wrFunc allowedValues klass} {
|
||||
|
||||
set catch_status [ catch {
|
||||
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 && "$wrFunc" != ""} {
|
||||
set pos [string first "." "$wrFunc"]
|
||||
if { $pos > 0 } {
|
||||
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
|
||||
}
|
||||
if {$nexus == 1} {
|
||||
hsetprop $nodeName type part
|
||||
hsetprop $nodeName klass $klass
|
||||
hsetprop $nodeName privilege $permission
|
||||
hsetprop $nodeName control true
|
||||
hsetprop $nodeName data true
|
||||
hsetprop $nodeName nxsave true
|
||||
hsetprop $nodeName data true
|
||||
}
|
||||
if {$gumtree == 1} {
|
||||
}
|
||||
} message ]
|
||||
if {$catch_status != 0} {
|
||||
return -code error "in createNode $message"
|
||||
}
|
||||
return OK
|
||||
}
|
||||
|
||||
proc mk_sct_autolab {sct_controller klass tempobj} {
|
||||
set catch_status [ catch {
|
||||
set ns "[namespace current]"
|
||||
|
||||
MakeSICSObj $tempobj SCT_OBJECT
|
||||
sicslist setatt $tempobj klass $klass
|
||||
sicslist setatt $tempobj long_name $tempobj
|
||||
|
||||
set scobj_hpath /sics/$tempobj
|
||||
|
||||
set deviceCommand {\
|
||||
Display State 1 0 1 1 0 text internal {STATE} {rdValue} {} {} {}\
|
||||
Display Potential 1 0 1 1 0 float internal {potential} {rdValue} {} {} {}\
|
||||
Display Current 1 0 1 1 0 float internal {current} {rdValue} {} {} {}\
|
||||
Display AppliedPotential 1 0 1 1 0 float internal {appliedpotential} {rdValue} {} {} {}\
|
||||
Display SampleVoltage 1 0 1 1 0 float internal {samplevoltage} {rdValue} {} {} {}\
|
||||
Display SampleCurrent 1 0 1 1 0 float internal {samplecurrent} {rdValue} {} {} {}\
|
||||
Control Mode 1 1 1 1 0 text user {mode} {rdValue} {} {setMode} {potentiostat,galvanostat}\
|
||||
Control Range 1 1 1 1 0 text user {range} {rdValue} {setrange} {setValue} {}\
|
||||
Control Cell 1 1 1 1 0 text user {cell} {rdValue} {cell} {setCell} {On,Off}\
|
||||
Control SaveAs 0 1 1 1 0 text user {} {} {saveas} {setValue} {}\
|
||||
Control SetPoint 1 1 1 1 0 float user {setpoint} {rdValue} {setpoint} {setValue} {}\
|
||||
}
|
||||
|
||||
hfactory $scobj_hpath/Display plain spy none
|
||||
hfactory $scobj_hpath/Control plain spy none
|
||||
|
||||
foreach {cmdGroup varName readable writable nexus gumtree drivable dataType permission rdCmd rdFunc wrCmd wrFunc allowedValues} $deviceCommand {
|
||||
createNode $scobj_hpath $sct_controller $cmdGroup $varName $readable $writable $nexus $gumtree $drivable $dataType $permission $rdCmd $rdFunc $wrCmd $wrFunc $allowedValues $klass
|
||||
}
|
||||
|
||||
} catch_message ]
|
||||
if {$catch_status != 0} {
|
||||
return -code error $catch_message
|
||||
}
|
||||
}
|
||||
namespace export mk_sct_autolab
|
||||
}
|
||||
|
||||
##
|
||||
# @brief Create an Autolab Controller
|
||||
#
|
||||
# @param name, the name of the Autolab
|
||||
# @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_autolab {name IP port } {
|
||||
set fd [open "../log/autolabp.log" a]
|
||||
if {[SplitReply [environment_simulation]]=="false"} {
|
||||
makesctcontroller sct_autolab std ${IP}:$port [binary format cc 0x0D 0x0A] 5.0
|
||||
}
|
||||
puts $fd "mk_sct_autolab sct_autolab environment $name"
|
||||
mk_sct_autolab sct_autolab environment $name
|
||||
close $fd
|
||||
}
|
||||
|
||||
puts stdout "file evaluation of sct_autolab.tcl"
|
||||
set fd [open "../log/autolab.log" w]
|
||||
puts $fd "file evaluation of sct_autolab.tcl"
|
||||
close $fd
|
||||
|
||||
namespace import ::scobj::autolab::*
|
||||
|
||||
add_autolab autolab 192.168.56.101 6000
|
||||
Reference in New Issue
Block a user