Readme.txt: Edited on 10-Aug-2007 by RDM This file's default location is C:\SOLARSID\Docs Notice: This software and installer program is provided "AS-IS" the usual disclaimers about liability and damages apply. *** Also -- be advised that any contact information such as phone numbers or email addresses or personal information entered into this program will be put in the Datalog files that this program makes and uploaded to a database at Stanford University that is accessible to anyone via the Internet. This information is optional for the Data Logger Application (called SIDMON). Where things are located in the system and placed on the hard drive. The Directory Structure: C:\SOLARSID BIN = Binary files (applications, batch files, etc.) CONF = Configuration files Data = Your SID Data storage area Docs = Readme.txt (this file), SID Manual, and Technical manual, etc. EventLog = System log, errors, FTP pushes, etc. NotToSend = Disabled FTP Directory ToSend = Enabled FTP directory tmp = Temporary Work area for SIDMON and related applications. Shortcuts in the program group (under the START menu) to help you find things faster and access them easier: START > SOLARSID > Apps > FTP SID Monitor Data > SID Monitor Application Folders > DATA Folder > Documents Config > FTP > Disable FTP Directory > Enable FTP Directory > Edit FTP Config File > SID > Edit SIDMON Config File > Read Me info (shows this file) __Unistall__ > Are_you_Sure > Uninstall SID Software Components Q U I C K S T A R T --------------------- Before running SIDMON.EXE (The SID Monitor Console application) you need to configure the SIDMON_Config.txt file: From Windows: START > SOLARSID > Config > SID > Edit SIDMON Config File -or- From Command line, or folder browser: The Config directory that is under the main directory that you installed the program. The default directory is C:\SOLARSID\CONF With Notepad (or other text editor) inside of SIDMON_Config.txt, note: even if the line is too long to fit on the screen, please do not add linebreaks in the file because the SIDMON application parses these as end of a parameter's configuration. Set these variables with your information between < and >: Site = , Longitude = , Latitude = Device = DI-194RS, Port = COM* Channel = 1, DataType = SOLAR-SID, StationID = NLK, Frequency = 24.8 KHZ, MonitorID = , SampleRate = 5 Configuration file example: Site = RDM, Longitude = -122.12, Latitude = 37.65 Device = DI-194RS, Port = COM* Channel = 1, DataType = SOLAR-SID, StationID = NLK, Frequency = 24.8 KHZ, MonitorID = S-0001-FB-0010, SampleRate = 5 Channel = 2, DataType = SOLAR-SID, StationID = NAA, Frequency = 24.0 KHZ, MonitorID = S-0002-FB-0011, SampleRate = 5 To calculate your latitude from degrees, minutes, seconds to ddd.ff North is Positive South is Negative Latitude = Degrees + ( Minutes / 60 ) + ( Seconds / 3600 ) Example: N 37 39' 0" = + 37 + ( 39 / 60 ) + ( 0 / 3600 ) = + 37 + (0.65) + (0) = 37.65 To calculate your longitude from degrees, minutes, seconds to ddd.ff East is Positive West is Negative Longitude = Degrees + ( Minutes / 60 ) + ( Seconds / 3600 ) Example: W 122 7' 12" = - 122 + ( 7 / 60 ) + ( 12 / 3600) = - 122 + (0.1167) + (0.0033) = -122.12 F T P Y o u r D A T A ------------------------- When you are ready to start FTP-ing the files to Stanford. The following should be done: 1. Edit the FTP configuration file Windows: START > Programs > SOLARSID > Config > FTP > Edit FTP Config file -or- Commandline or Folder browser: located in the C:\SOLARSID\Conf\ftp_cmds.TXT directory Inside the file put your site name on the second line. Replace MY_SITE_NAME with the appropriate site name. lcd ToSend\Sending cd incoming/SID/MY_SITE_NAME mput *.csv quit 2. Enable the FTP directory. Windows: START > Programs > SOLARSID > Config > Enable FTP Directory -or- from the command line or Folder browser: rename "NotToSend" to "ToSend" This creates a sub directory called "ToSend". At the end of every UTC day (00:00 UTC) the day's worth of data is copied to this directory. 3. To send the data, you have two choices: a) Launch the batch file in the BIN directory SIDsend manually every day Windows: START > Programs > SOLARSID > Apps > FTP SID Monitor Data -or- from the command line or Folder browser: C:\SOLARSID\BIN\SIDsend.bat b) set a script file to do so automatically using the scheduling tool. (You must be an administrator to set this up and do this) C O N F I G D E T A I L S --------------------------- Config File Rules: 1) A '#' on a line is a comment / or commented out and the remainder of the line is ignored. 2) The syntax is simple: = [, = ]* For those that cannot read above, it says you put a name (keyword) followed by an equal sign, followed by a value. You do not type the angle brackets < and > around the words. you can put as many of these as you need per line. 3) The definitions in this file are per line and can be very long, Do not seperate Site, Device, or Channel keywords name-value pairs on different lines because A new line ends the current definition and begins a new one. This will cause a config error. 4) You can only use permitted keywords (see below) you cannot define your own keywords. 5) * DO NOT * put commas (,) between words, the parser will interpret this comma as a seperator for a new name-value pair. 6) Be aware (or beware) that anything that you define with these keywords will appear in the Data Log files this program generates and will be accessible with the EVERYONE in the world (via World-Wide Web) in a Database at Stanford University's Solar Center. Permitted Keywords (no other keywords are legal): KEYWORD Required? Example Value ---------- --------- ---------------------------------------------- Site: Site (Required) WSO (Wilcox Solar Observatory at Stanford) Longitude (Required) -122.08 Latitude (Required) 38.67 Comments (Optional) This is a comment Device: Device (Required) DI-194RS (currently the only device supported) Port (Required) COM* (find any comport with a DataQ) Example #2=> COM6 (or COM# where # is a number 1 thru 20) Channel: Channel (Required) 1 (For Dataq values are between 1 and 4) DataType (Required) SOLAR-SID (currently the only data type supported) (This keyword must follow after Channel = n) StationID (Required) NLK Frequency (Required) 24.8 KHz MonitorID (Required) S-0001-FB-0001 SampleRate (Required) 5 Seconds Range (Optional) -5 to +5 volts DateInstalled (Optional) 01-JAN-06 01:00:00 UTC Contact (Optional) JohnQPublic@WhateverMySiteIs.com Problems (Optional) This channel has a lot of noise on it Comments (Optional) This is a comment Observer (Optional) ABCD Credits: Setup Installer "InnoSetup" written by Jordan Russell jr-2005 AT jrsoftware.org http://www.jrsoftware.org/ Copyright (C) 1997-2005 Jordan Russell. All rights reserved. This software is provided "as-is," without any express or implied warranty. In no event shall the author be held liable for any damages arising from the use of this software. Permission is granted to anyone to use this software for any purpose, including commercial applications, and to alter and redistribute it, provided that the following conditions are met: ... If you use this software to distribute a product, an acknowledgment in the product documentation would be appreciated but is not required. SIDMON.exe Revision History: // // Ver 0.40 // - BUG: 31-Oct-2006 // Fixed Daylight savings time to use tm_isdst as opposed to the mislabled windows // _daylight. // - enhanced 'CALIBRATE' mode not to look like 'DATALOG' modes // Ver 0.31, RDM, 02-June-06 // - Fixed bug where the status file wrote to the disk more than it should // - Waiting for other bugs to find/fix before release // Ver 0.30, RDM, 31-May-06 // - BUG fix: Files in /tmp dir would not get deleted, the // file(s) would remain. // - added a feature that copies the files to a directory // named /ToSend that contain the files to upload (via ftp or whatever). // If the directory does not exist, then the files are not copied there. // - Added a "status" feature. the file /tmp/Console.txt // contains the current status, time, date, and health of // the system // Ver 0.20, RDM // - Fixed problems with WIN 98 system call // made everything internal to the program // I used functions rename() and unlink(), plus a // custom _CopyFile() function in DataCollector.cpp // to copy and move the files. // Ver 0.11, RDM // - Changed Event Log Filenames from YYYY_MMEventLog.txt // to YYYY_MM_EventLog.txt // - Added tmp Directory and copied current files to /Data // for each data measurement to prevent locking the file // when ftp (or graphing software) grabs the file. // Every 15 seconds it will attempt to move old files over // to the /Data directory // Ver 0.10, RDM: Ray Mitchell // - Initial version, first internal release to WSO // Coding assistance from Sam Penrose and Mitch Patenaude Students in the Master's program (now graduated) At the Math and Computer Science Department, California State University, East Bay (Formerally Hayward)