# File: hallprobe.proto
# 
# Group3 DTM-151, Digital Telsameter protocol definitions
# 
# 
# Notes:
#   [Scaling]
#   We are using what's called the "calibration factor" to get the scaling 
#   functionality that we want.  Using the device's "scale" command ("Ln") 
#   computes a scale factor to make the field reading equal to the entered 
#   value n.  That particular functionality is provided by "setField".  
# 
#   [setField]
#   Uses the "calibrate" command ("Cn") to compute the calibration factor 
#   required to define the current field measurement as n.  These calibration 
#   factor for our purposes is referred to as scale.  See also "Scaling".
# 
# 
# Author: Wesley Moore
# Date:   Sept 2014
# 

OutTerminator = ""; 
InTerminator  = CR LF;
writetimeout  = 100;
readtimeout   = 1000; # milliseconds
replytimeout  = 1000; # milliseconds

#######################################
# Inputs
#######################################
getACDC {
    out "IG";
    in  " %c%*c";
}

getDigFltr {
    out "ID";
    in  " %d";
}

getDispMode {
    out "IN";
    in  " %c";
}

getField {
    out "F";
    in  " %f%(EGU)c";
#    @mismatch { in "%f\r\n "; }
}

getOffset {
    out "IO";
    in  " %f%(EGU)s";
}

getPeak {
    out "P";
    in  " %f%(EGU)c";
}

getRange {
    out "IR";
    in  " %d";
}

getScale { 
    out "IC";
    in  " %f";
}

getTemp {
    out "T";
    in  " %f%(EGU)c";
}

getZeroOffset {
    out "IZ";
    in  " %f%(EGU)c";
}

#######################################
# Outputs
#######################################
setACDC             {   out "%{GA|GD}";         }
setClrOffset        {   out "EO";               }
setClrPeak          {   out "EP";               }
setClrScale         {   out "EC";               }
setClrZeroOffset    {   out "EZ";               }
setDispMode         {   out "%{NH|NN|NT}";      }
setField            {   out "C%f\r\n";          }
setDigFltr          {   out "%{D0|D1}";         }
setOffset           {   out "O%f\r\n";          }
setRange            {   out "%{R0|R1|R2|R3}";   }
setScale            {   out "SC%f\r\n";         }
setUnits            {   out "%{UFG|UFT}";       }
setZero             {   out "Z\r\n";            }
setZeroOffset       {  out "SZ%f\r\n";          }