Versions Compared

Key

  • This line was added.
  • This line was removed.
  • Formatting was changed.

...

When the RediGate restarts, the values in Scratchpad areas are all set to zero/empty and the type is set to INTEGER.  An Scratchpad elements are global to a Channel (shared in common among all PODs and devices on a Channel), but each Channel has its own set of numeric Scratchpad elements (-1 to -40). An element in the Scratchpad can have its value and type changed each time a POD program writes to it.  Once written to, the element retains its value and type (INTEGER, REAL or STRING) until the next write, even between successive executions of different PODs.

...

This section gives some examples of POD programs to illustrate the POD programming methods.  The sample ACE configurations for the programs illustrated here can be downloaded from http https://ftp.elecsyscorp.com/ACE/PODDemoConfigurations.zip

See the RediGate Configuration Manual for a more complete explanation of the configuration properties of the individual ACE objects.  This section will primarily focus on explaining how the POD logic works, with only minimal discussion on the other parts of the configuration.

...

      The first parameter is the numeric register address of pointing to a STRING-256 data type containing the Directory path and root filename. Examples would be Example: The first register contains 46001, where register 46001 is a STRING-256 register that might contain "/tmp/cflash/MeterLogs/IonMeter1" and or "/tmp/usb/Floats/Voltages".  The Data Logger function will verify that the directories exist and will append more information to the file name consisting of the Year-Month-Day, Starting Data Address by Number of Data Items, Time Stamp mode, and either ".csv" or ".bin".  For example the first file name could be "../IonMeter1~2012IonMeter1..2012-12-25_30001x012_TS.csv" for December 25th 2012, data from 30001 through 30012 saved as comma separated values with a Time Stamp.

...

      The fourth parameter is Maximum number of files to be stored in the destination directory portion of the file name.  At midnight the logger will see if the oldest file in the destination directory should be removed.  Plus any “FILENAME*.csv” or “FILENAME*.bin” file will be gzip-compressed and renamed to either “FILENAME*.csv.mvCSV.gz”  or  “FILENAME*.bin.mvBIN.gz”.  When the user copies the compressed files to a Windows PC then the freeware program “7-Zip” can uncompress them.  The ‘.mv” ".CSV" or ".BIN" is appended to prevent compressing a continuing live log file.

      The fifth parameter is zero if the files are stored as binary records, and 1 if the data is to be stored as comma separated (CSV) values (future versions might store XML formatted records).  If in binary mode then Boolean and INT8 registers will occupy one byte.  INT16 occupy two bytes, INT32 and REAL32 use four bytes, STRING-32 use 32 bytes and STRING-256 uses 256 bytes.  Data is ‘Little Endian’.  CSV file records are terminated with a “,EOL” (for End Of Line) plus a ‘NEW LINE’.

      The sixth parameter determines if a Time Stamp is to be prepended to each record.  CSV records will have the HH,MM,SS,mSec, values in military mode (0-23 hours, using system timezone).  The Binary mode time stamp will be an INT32 number of seconds since Jan 1, 1970 (using UTC timezone) followed by an INT32 microseconds.  The File Name will either have “_TS” or “_noTS” whether the records are Time Stamped or not Time Stamped.  A sample CSV record with Time-Stamp could appear as (at 13:23:09.774  or  1:23 PM) with PI, Feet-In-Mile, and Body Temperature as: 13,23,9,774,3.14,5280,98.6,EOL

...

NOTE 1: Be careful to use a unique File name for each Starting Data point or else the file management function will delete more files associated with the lower addressed set of data.  A TILDE (~) character separates Two dots (..) separate the end of the base File Name from the appended Date Stamp and other appended characters.

...