Measurand's FileGenerator allows you to create programs for Campbell Scientific data loggers to record information from ShapeArray (SAA) devices connected to it.
In SAASuite 3.0 or higher, File Generator is launched by clicking the Configure Logger Program button.
Figure 1: Launch FileGenerator by clicking the Configure Logger Program button
Figure 2: SAACR_FileGenerator
Step 1 - Optional, Retrieve Settings From a Previous File
Some settings can be retrieved from existing Campbell Scientific data logger program files that were created with File Generator (.cr8, .cr1, .cr1x, .cr3, .cr6, or .cr300 files). This is often helpful when you are simply adding another ShapeArray to an existing logger configuration. To do this, click the Open File button in the top right corner of the window, as shown in Figure 1, and select the desired file.
Figure 3: Selecting an existing logger program file
File Generator will now be populated with file details.
Figure 4: Details populated after selecting an existing file
Step 2 - Optional, Locate SAARecorder
The SAARecorder Folder field needs to point to the local installation folder for SAARecorder. If SAARecorder has been installed in a different location then click the Browse button to locate it.
NOTE: In most cases, you should not change the path to the SAARecorder folder. Only do this if you have moved the the SAARecorder to a location on your computer other than the default C:\Measurand Inc installation directory.
Figure 5: Settings for SAARecorder, Project Title, Preliminary Samples, and Reading Interval
Step 3 - Provide a Project Title
It is a good idea to specify a title or project name for your logger program by entering it into the Project Title field, as shown in Figure 3 above. This title will be written into the program. Although this field is not required, Measurand highly recommends supplying a project title.
NOTE: When entering a title for your project, non-alphanumeric characters should be avoided. By default, SAACR_FileGenerator will prevent the use of some characters (such as the comma); however, care should be taken with other punctuation characters. Some non-alphanumeric characters in the project title can cause issues with other software that works with the resulting data files.
Step 4 - Configure the Number of Preliminary Samples
Preliminary samples are taken before the reading interval starts and are an initial check that everything is working properly. The higher the number of samples the more time it will take. The default setting for this is 5 samples. Setting the Number of Preliminary Samples field to 0 will disable the collection of preliminary samples.
Step 5 - Configure the Reading Interval
The Reading Interval is the time between ShapeArray observations made within the program. The fastest (minimum) reading interval is 10 minutes. Going faster could cause the data logger to eventually crash. Units (Minutes or Hours) can be configured with the dropdown menu next to the Reading Interval text field, as shown in Figure 3 above.
Step 6 - Optional, Select SAAV Extend Site File
If you are generating a logger program for an SAAV Extend that has been lifted with added extensions, you must specify a site file that defines the order in which the extensions were added to the base array. To do this select the SAAV Extend checkbox and then click the Select button. This will open a dialog where you can locate and select the site file. Once selected, click the Open button to continue.
Step 7 - Select the Logger Type
In the Logger Type dropdown list, select which data logger this program is intended for. The selection made will determine the file extension for the files generated.
- CR800 creates a .cr8 file
- CR1000 creates a .cr1 file
- CR1000X creates a .cr1x file
- CR3000 creates a .cr3 file
- CR6 creates a .cr6 file
- CR300 creates a .cr300 file
Figure 6: The Logger Type, Channel, COM Port, Serial Number, and Averaging settings
Step 8 - Configure the Sensor Fields
The sensor fields area (SAA 1 - 20), as shown in Figure 4 above, is where the ShapeArrays are to be set up.
- Click the checkbox in the SAA column to turn a ShapeArray on or off
- Specify the interface to which your ShapeArray is connected in the 232(-5) Channel dropdown list.
- Specify the COM Port to which the ShapeArray is connected on the CS Data Logger
- Enter the Serial Number for the ShapeArray.
- In the Averaging field, enter the number of ShapeArray samples used to compute an average reading using the ‘Averaging in Array (AIA)’ feature of ShapeArrays
Step 9 - Generate the Program File
Click the Generate File button to create the data logger file. You will be prompted to select a location to save the file and to provide a file name for the program.
WARNING: Older versions of SAACR_FileGenerator created two files: a main program file and an SAA_Include file. If your version of SAACR_FileGenerator created two files, then Measurand highly recommends upgrading to the most recent version of the software. The latest version produces only a single program file that has many optimizations and bug fixes over programs created with earlier versions.
Figure 7: Selecting a location and filename for the program files
Step 10 - Optional, Add Custom Code for Non-ShapeArray Sensors
If you need to log data from non-ShapeArray sensors, such as piezometers or strain gauges, you will need to modify the program created by SAACR_FileGenerator to include code to collect and record the data. The program file should be edited in LoggerNet's CRBasic Editor to include the required code. The required code should be placed in the USER defined or USER program sections in the program file. These sections are delimited by START and END markers for ease of location. An example of one of these section is shown in Figure 6 below.
Figure 8: Custom code for non-ShapeArray sensors is inserted in specific locations in the main program file
Note: Measurand recommends consulting Campbell Scientific's support for assistance with the code required to log data from non-ShapeArray sensors.
Step 11 - Send the Program File to the Logger
NOTE: If you are reusing a Campbell Scientific logger previously used with other Measurand ShapeArrays, it is extremely important that you remove any existing logger programs and Include files before you connect the new ShapeArrays. This is most easily accomplished by formatting the logger through LoggerNet's Connect application or PC200W's File Control option.
Figure 9: LoggerNet Connect's File Control window