INSTRUCTION MANUAL CSM1 Card Storage Module and CSMCOM and SMCRead Software Revision: 3/01 C o p y r i g h t ( c ) 1 9 9 3 - 2 0 0 1 C a m p b e l l S c i e n t i f i c , I n c .
Warranty and Assistance The CSM1 Card Storage Module is warranted by CAMPBELL SCIENTIFIC, INC. to be free from defects in materials and workmanship under normal use and service for twelve (12) months from date of shipment unless specified otherwise. Batteries have no warranty. CAMPBELL SCIENTIFIC, INC.'s obligation under this warranty is limited to repairing or replacing (at CAMPBELL SCIENTIFIC, INC.'s option) defective products.
LIMITED WARRANTY Campbell Scientific, Inc. warrants that the magnetic diskette on which the accompanying computer software is recorded and the documentation provided with it are free from physical defects in materials and workmanship under normal use. Campbell Scientific, Inc. warrants that the computer software itself will perform substantially in accordance with the specifications set forth in the Operator’s Manual published by Campbell Scientific, Inc. Campbell Scientific, Inc.
LICENSE FOR USE This software is protected by both United States copyright law and international copyright treaty provisions. You may copy it onto a computer to be used and you may make archival copies of the software for the sole purpose of backing-up Campbell Scientific, Inc. software and protecting your investment from loss. All copyright notices and labeling must be left intact.
CSM1 Card Storage Module Table of Contents PDF viewers note: These page numbers refer to the printed version of this document. Use the Adobe Acrobat® bookmarks tab for links to specific sections. 1. Introduction ............................................................................ 1 2. Specifications ........................................................................ 2 2.1 2.2 2.3 2.4 Datalogger Compatibility..........................................................................
CSM1 Card Storage Module Table of Contents B. Internal Data Formats and Pointers in the Card Memory ........................................................................... B-1 B.1 B.2 B.3 B.4 Byte Pairs ............................................................................................ B-1 File Structure ....................................................................................... B-1 Program Files .....................................................................................
CSM1 Card Storage Module The Card Storage Module system consists of a microprocessor-controlled read/write module (the CSM1) and removable credit card sized memory cards that hold data and/or datalogger programs in battery-backed memory. The memory cards are easily exchanged and transported to a computer for data retrieval. The module is quickly prepared for use, and features built-in status indicators for module operation and data storage.
CSM1 Card Storage Module FIGURE 1. CSM1 Case Below the card slot is a male 9-pin D connector. This is a Campbell Scientific serial port. An SC12 cable (supplied) is used to connect this port to the datalogger (for data storage) or SC532(A) interface (for data retrieval). The card slot and 9-pin connector are positioned together to allow the CSM1 to be mounted against the side wall of small enclosures, yet still allow the card to be removed, or the unit to be unplugged.
CSM1 Card Storage Module 2.2 Card Types Supported The CSM1 supports JEIDA 4, PCMCIA standard memory cards. Sizes of 256K to 2M are supported (256 bytes reserved for system use). Low resolution data format requires two bytes per data value with high resolution data occupying four bytes. Datalogger programs require the space as stored on disk, plus an overhead of approximately five bytes. Standard card sizes are 256K, 1M and 2M.
CSM1 Card Storage Module Weight: Card: CSM1: Construction: 30 g 350 g Anodized aluminum case. Two LEDs in case top indicate power-up status and data write operations. 1Type and capacity varies with card manufacturer and card size. Capacity 120 to 170mAh. 2These figures apply when the card is disconnected from an external power supply, i.e. the card is not plugged into the module and/or the module is not being powered by a datalogger.
CSM1 Card Storage Module 5. Plug the memory card into the CSM1. The card should be inserted with the end with the small connector holes placed into the connector. It should not be possible to insert the card the wrong way round. Push the card in until you feel a positive click and the small button next to the card pops out. 6. Plug the SC12 cable from the SC532(A) (or SC209 cable if using a PC201 card) into the 9-pin connector on the end of the CSM1. Observe the status LED on the top of the case.
CSM1 Card Storage Module NOTES 1) While performing the power up tests, the 'Write' LED will normally flash for a short period, before the status indicator flashes. This is caused by the CSM1 checking that it is able to write to the card. 2) It is important that the SC12 connector is plugged into the CSM1 and also into the SC532(A) or datalogger, with the connector held perpendicular to the end of the case.
CSM1 Card Storage Module TABLE 2. Sample CR10 Program Using P96 To Send Data To CSM1 *Table 1 Programs 01: 5 Sec. Execution Interval 01: Module Temperature (P17) 01: 1 Loc [:MOD TEMP ] 02: Thermocouple Temp (DIFF) (P14) 1: 1 Rep 2: 1 2.
CSM1 Card Storage Module an address of 1). For Instruction 96 it is also possible to write a filemark into the memory card, to effectively close an open file, by pressing 'C' after the address (displayed as '71--'). The CSM1 also supports data storage at 76800 baud, when output from the CR10 with the Burst Mode instruction. To do this specify the output code for 'Serial port, 76800 baud to SM192/716 Storage Module' (see CR10 manual for further details).
CSM1 Card Storage Module CAUTION As with ESX software, the datalogger does not check for the presence of the CSM1, so if the module is not connected data could be lost. Manual dumps to the module are done by setting the baud rate parameter of the *4 Mode to 9600 baud. Data is then dumped using the *9 Mode. When reading data that has been stored in the card in ASCII format using CSMCOM, you should select the format 'As stored (8-bit data)'.
CSM1 Card Storage Module next available memory in the card. Every two bytes of a .DLD file loaded into the card reduces the amount of space for data storage by one location. 5.1 Transferring Programs to/from Datalogger CR10 dataloggers, 21X dataloggers with OSX software and CR7 dataloggers with OS7 software can be instructed to transfer a program between the datalogger's memory and one of the eight program areas of the CSM1 memory card. This is done using the *D Mode: NOTE 1.
CSM1 Card Storage Module 6. Selected Operating Details 6.1 Inserting the Card in the CSM1 One of the features of the CSM1 is that you can either leave the card in the module and move the module from datalogger to datalogger (or from datalogger to office), or you can install the module with the datalogger and transport the memory cards between sites. Whichever is your chosen method of use, it is critical that the card is inserted into the module correctly.
CSM1 Card Storage Module does not move its internal pointers and consequently the CR10 does not get confirmation of successful data transfer at the end of the transmission; thus it does not move its SPTR. This means that no data is lost as the CR10 will send the whole block again. However, for a large block transmission from the datalogger, e.g. a manual dump of the whole memory, it can appear that the card suddenly becomes full without storing any data from the datalogger.
CSM1 Card Storage Module NOTE It is critical that line 4 does not go positive before line 20. This can either be done under careful software control, or by tying the two lines together at the SC532(A) and using just one line on the computer to pull the two lines high on the SC532(A). If it is not possible to control these lines by software, then the older SM232A is available that uses a mechanical switch to emulate setting the lines high or low. Please contact Campbell Scientific for further details. 7.
CSM1 Card Storage Module This is a blank page.
Appendix A. 9-Pin Storage Module Interface Pin 1 (input) 5V supply to CSM1. The minimum voltage for operation is 4.85V. Below approximately 4.85V the CSM1 will neither accept data nor communicate; it is disabled. The only time that this may cause a problem is when using Campbell Scientific equipment with the PC201 card. This uses the PC 5V supply to power the module. The 5V supply of some PCs may not be set up accurately and be below the minimum voltage for operation of the CSM1.
This is a blank page.
Appendix B. Internal Data Formats and Pointers in the Card Memory Knowledge of the format in which data is stored in the card memory is not normally necessary to use the CSM1. However, if you intend to save text files in the card or need to try to extract corrupted data, the following information may be useful. B.1 Byte Pairs All data stored in the card is stored in byte pairs.
Appendix B. Internal Data Formats and Pointers in the Card Memory The storage reference pointer (R): this points to the location where the CSM1 will write the next data value in the card. The display location pointer (L): this points to the location that will be the first value output in response to the C, F or HF commands. If this pointer points to a filemark or start of a program, no data is output by these commands. You must move the pointer past the filemark to get further data.
Appendix C. Card Batteries The make and type of battery supplied with the memory card can vary with the size and manufacturer of the card. Campbell Scientific reserves the right to supply cards of different manufacture with different battery sizes and types. The batteries fitted to the cards are readily obtainable from electrical suppliers. You must ensure that the replacement battery is compatible with those recommended by the manufacturer of the card.
Appendix C. Card Batteries To optimize the life of the back-up battery: a) Leave the card plugged into a powered-up CSM1 for as long as possible. b) When using the cards at very high or low temperatures, try to return them to a temperature close to room temperature as soon as they are unplugged from the CSM1, e.g. in a very cold situation, unplug the card and transfer it to the inside pocket of your coat.
Appendix D. Telecommunications Commands Once in the telecommunications mode the CSM1 responds to the commands listed below. To enter a command enter the characters followed by a carriage return character. The CSM1 does not support text correction using the backspace/delete characters; if an unexpected character is read, command entry is aborted and the prompt is returned. With the exception of the F and 0H commands, all commands finish with a carriage return/linefeed/prompt sequence on completion.
Appendix D. Telecommunications Commands An example of a status line is: V1.1 M16 B2 E0 P3 A80313 R50632 L2 D23455 C23922 D-2 nnnnnnG Move display pointer Moves the display pointer to a specified location nnnnnn. The status line is displayed after the pointer is moved. nnnnnnC Output ASCII data Outputs data in a comma delineated, ASCII format. nnnnnn arrays of data are dumped, or until the next filemark is reached. 0C means dump continuously until the next filemark.
Appendix D. Telecommunications Commands 0H Receive data Makes the CSM1 store any subsequent data sent to the CSM1 in the card. The CSM1 sends a carriage return, linefeed and '<' prompt when it is ready to receive the data. This mode can only be terminated by resetting the module, e.g. removing power or dropping the handshaking lines to the SC532(A). 4H Move dump pointer Moves the dump pointer to the current display pointer position, then displays the status line.
Appendix D. Telecommunications Commands nDP Send program Dumps the program stored in program area n. The CSM1 sends the program followed by a 2-byte binary checksum. The checksum includes all characters transmitted since the last prompt character. If the program area is empty the CSM1 sends the byte sequence 30 07 07 Hex, followed by the checksum and then the prompt. nSP Store program Store a program in program area n.
Appendix E. SC532A The SC532A differs from the SC532 in three ways: 1. 2. 3. Provides 12 V on PERIPHERAL Port pin 8 “ PROGRAM” mode Jack on SC532A POWER input The SC532A supplies 12 VDC via PERIPHERAL connector pin 8 for the purpose of powering 12 V peripherals. The SC532A’s internal jumper selects “ SC532” or “ PROG” mode. For the CSM1 leave the jumper in the factory default position of “ SC532.” “ PROG” is a special mode for satellite transmitters only.
This is a blank page.
CSMCOM SOFTWARE
This is a blank page.
CSMCOM Table of Contents PDF viewers note: These page numbers refer to the printed version of this document. Use the Adobe Acrobat® bookmarks tab for links to specific sections. 1. Installation .............................................................................. 1 2. Getting Started ...................................................................... 1 3. Menu Options ......................................................................... 2 3.1 T — Terminal Emulator: .........................
CSMCOM Table of Contents B. COM Port Addresses ....................................................... B-1 B.1 CSMCOM and COM3, COM4............................................................ B-1 B.2 CSMCOM and the PC201 Card .......................................................... B-1 B.3 PS/2 Computers and CSMCOM..........................................................
CSMCOM CSMCOM supports Campbell Scientific's Card Storage Module when the CSM1 or MCR1 is used as the card reader. It provides a simple and efficient way for you to extract data from a card. Most program functions can be accessed from the DOS command line, allowing you to incorporate the program in batch files for automated data extraction. SMCREAD supports PC card drives installed in the computer.
CSMCOM 3. Menu Options CSMCOM displays the menu options as follows: CSMCOM options: T -- Terminal emulator A -- Collect All data files U -- Collect Uncollected data files N -- Collect Newest data file L -- Collect one data file starting at a specified Location P -- Collect all Program files D -- Store a .
CSMCOM new file on the hard disk. For each file the message: 'xxxxxx: writing to file rootnn.dat' appears, where xxxxxx is the location of the start of the file. If CSMCOM finds a file that contains a program, it jumps over the program and displays 'no data found in this area'. This option can be aborted by pressing the Esc key. 3.
CSMCOM 3.7 D – Store a .DLD Program File This option is used to store a .DLD program file, as created by EDLOG, into one of the program areas of the card. CSMCOM first displays the current status of the program areas in the card to show you which areas are in use. Next CSMCOM asks you to enter the name of the .DLD file. CSMCOM appends the .DLD suffix if necessary. You are now asked in which card program area you wish to store the program. Enter a number between 1 and 8.
CSMCOM If an error does occur, use the E option several times to check if the position at which the error occurs is repeatable. If the test fails at different points in the card, then either the card or module may have a serious hardware fault. If other cards work with the module, then the card is at fault and should not be used. If the error always occurs in the same memory page, it is possible to use the card with reduced capacity. Please contact Campbell Scientific for further advice.
CSMCOM CSMCOM assumes a .DLD suffix for program files and a .DAT suffix for data files, unless you enter an alternative suffix or specify no suffix by terminating the filename with a '.' For options where only one file can be read from, or stored in the card, e.g. the name of a program to be stored in the card, CSMCOM asks you for a specific filename, where the prefix can be up to eight characters long. Where the option can generate several files on disk, e.g.
CSMCOM 5.2 C – Comma Delineated ASCII Arrays This format has array elements separated by commas. No element identifiers are included and all leading and trailing zeros are removed. Each array is terminated with a carriage return and linefeed. Comma delineated data is reasonably compact, can be imported into most analysis packages, and can also be read when printed (see example in section 4 of PC208 manual). 5.
CSMCOM would normally indicate either too high a baud rate has been selected for the computer hardware or that there is a hardware fault. 6.4 Battery Voltage Warnings If when the program is run, you get a warning in the module status window that shows the card battery as being 'DEAD!', the battery in the card is close to being, or is completely discharged. CAUTION Do not unplug the card from the module or unplug the module from its power source at this stage.
Appendix A. Command Line Operation A.1 Introduction All options in CSMCOM can be specified as command line parameters when the program is run. This enables semi-automated reading of the cards, as CSMCOM can be called from a DOS batch file. The parameters should be entered in the order that they would be entered when running CSMCOM. If you wish you can spell out the name of the option selected in full, as only the first character of the options is read by CSMCOM.
Appendix A. Command Line Operation A.2.3 Communications Baud Rate The normal communication speed between the PC and the CSM1 is 19200 baud. However, when CSMCOM first starts it performs a simple test on the speed of access to the serial port. If access is slow, as happens with older IBM PC computers, the baud rate is reduced to 9600. Some recent high-performance computers will reliably support serial communications at speeds higher than 19200 baud.
Appendix B. COM Port Addresses B.1 CSMCOM and COM3, COM4 While the addresses and interrupts associated with COM1 and COM2 are well known and supported, some variation exist in the interrupts and addresses associated with COM3 and COM4. The addresses and interrupts listed in the table below for COM3 and COM4 are 'standard' in many cases. Listed in the table are the addresses and interrupts (IRQ) supported by CSMCOM for all four COM ports.
This is a blank page.
SMCREAD SOFTWARE
This is a blank page.
SMCRead Card Reading Software User Guide Table of Contents PDF viewers note: These page numbers refer to the printed version of this document. Use the Adobe Acrobat® bookmarks tab for links to specific sections. 1. Getting Started ...................................................................... 1 1.1 Installation ................................................................................................1 1.2 Running SMCRead ........................................................................
SMCRead Card Reading Software User Guide Table of Contents Appendices A. PCMCIA Driver Software Notes ................................... A-1 A.1 General ................................................................................................ A-1 A.2 Loading the Drivers............................................................................. A-1 A.2.1 General ...................................................................................... A-1 A.2.2 SystemSoft CardSoft Drivers.............
SMCRead SMCRead provides a simple and efficient way for you to extract data from a CSM1 card and write the data to disk on a PC fitted with a PCMCIA card slot. Most program functions can be accessed from the DOS command line, allowing you to incorporate the program in batch files for automated data extraction. If you are familiar with Campbell Scientific’s SMCOM or CSMCOM programs you will find many aspects of the operation of SMCRead to be similar. 1. Getting Started 1.
SMCRead 2. Menu Options SMCRead now displays the menu options as follows: SMCRead options: T -- Terminal emulator A -- Read All data files U -- Read Unread data files N -- Read Newest data file L -- Read one data file starting at a specified Location P -- Read all Program files D -- Store a .
SMCRead file rootnn.dat’ appears, where ‘xxxxxx’ is the location of the start of the file. If SMCRead finds a file that contains a program, it jumps over the program and displays ‘no data found in this area’. While reading data from the card SMCRead writes a ‘.’ to the screen for every block of data read. The size of the block is approximately 1000 locations, but the exact block size can vary depending on the structure of the data stored in the card. This option can be aborted by pressing the ESC key. 2.
SMCRead As the program is being read from the card a ‘ . ’ is displayed for every 100 characters read from the card. 2.7 D — Store a .DLD Program File This option is used to store a .DLD program file, as created by Edlog, into one of the program areas of the card. SMCRead first displays the current status of the program areas in the card to show you which areas are in use. Next SMCRead asks you to enter the name of the .DLD file. SMCRead appends the .DLD suffix if necessary.
SMCRead 2.9 C — Clear Data Area Quickly This option is similar to the E option, with the exception that it does not do a full memory test. Instead SMCRead uses the ‘1249K’ command to erase the card memory and reset the pointers. Before this, SMCRead temporarily offloads all programs present in the card to disk. After erasure the programs are reloaded into the card so that only data is erased. As with the E option, you are asked to verify that you wish to proceed with erasing the card.
SMCRead Once you start this option the speed of operation will depend on the size of files stored in the card. The screen will scroll up when the listing reaches the bottom of the screen. You can pause the scanning of the card by pressing any key. ESC will quit out of the S option altogether. 2.11 Q — Quit Q quits SMCRead and returns to DOS. 3.
SMCRead 4. Data File Format Options Once you have specified a file name for a data collection option you are asked which format you want to use for storing the data on disk. The following message is shown: File Formats: D -- Printable ASCII arrays with IDs C -- Comma delineated ASCII arrays A -- As stored (8 bit data) Esc -- Escape Format: 4.1 D — Printable ASCII Data With IDs This is the format that is most readable when printed.
SMCRead 5. Additional Information on SMCRead Operation 5.1 Reading Data from More Than One Card SMCRead automatically detects the removal of a card from the card slot and will update the status window accordingly. SMCRead indicates the removal and insertion of a card by generating a series of short beeps. 5.2 Aborting Options Most SMCRead operations can be stopped by pressing the ESC key. You are then returned to the options menu. 5.
SMCRead As a first step in reading a corrupted card, try using the normal procedures to read the data out of the card. If the data files are corrupted, not read, or not complete then you should try to find out where the starting points of the files are by running the Terminal Emulator (T) option. Position the display pointer at the beginning of the card using the 1G command and then scan through the card repeatedly using the NFM command to find the start of each file.
SMCRead 5.5.3 Phoenix Drivers Socket Services 2.1 Version 1.00, Card Services Release 2.1 Version 1.00 These Phoenix drivers do not perform correctly with DOS programs running under Windows. To use SMCRead under Windows with these drivers you must use the PIF file provided (SMC_TOS.PIF). This forces the program to run full-screen, and prevents it from running in the background. You must not use the CRITICAL switch in the command line.
Appendix A. PCMCIA Driver Software Notes These notes are intended as a supplement to the documentation shipped with your PCMCIA drivers. For notes about running MemMaker or other automatic memory optimizers, read the MS DOS manual and also the section at the end of this document, entitled ‘Using MemMaker’. A.1 General The software is designed to work with the PCMCIA drivers: Card Services 2.1, which in turn requires socket services 2.1.
Appendix A. PCMCIA Driver Software Notes A.2.2 SystemSoft CardSoft Drivers Socket Services 2.1 Version 1.00, Card Services 2.1 Version 2.05 The minimum required drivers for SMCRead are shown as follows as they would appear in your CONFIG.SYS file (your PATH may differ ): DEVICE=C:\PCMCIA\SSVADEM.EXE DEVICE=C:\PCMCIA\CS.EXE DEVICE=C:\PCMCIA\CSALLOC.EXE C:\PCMCIA\CSALLOC.INI A.2.3 Ventura Micro CardWare Drivers Socket Services Level 2.1 Release 1.01, Card Services Level 2.1 Release 1.
Appendix A. PCMCIA Driver Software Notes The line in your CONFIG.SYS which sets up EMM.386 will look something like: DEVICE=C:\DOS\HIMEM.SYS DEVICE=C:\DOS\EMM386.EXE NOEMS If, after studying other memory requirements and memory use (such as the address space used by your video card) you decide that the memory area D0000 to DFFFF may be used by CardServices, then change your lines as shown below. DEVICE=C:\DOS\HIMEM.SYS DEVICE=C:\DOS\EMM386.
Appendix A. PCMCIA Driver Software Notes performance graphics card. Details are given here for expressly specifying to Card Services which region it is to use. If your system is already set up as described below and SMCRead still fails due to lack of resources, then you may need to increase the size of your memory range. A range of 64K (example: D0000-DFFFF) should be plenty. Unless you have many other specialized PCMCIA drivers you will not need to increase the size of this range. A.3.
Appendix A. PCMCIA Driver Software Notes A.3.4 Ventura/Award Card Services Driver The .INI file is CARDWARE.INI. The format of this file is explained in the file CWINI.TXT. The Ventura drivers that SMCRead was tested with did not auto detect memory ranges, so you must edit CARDWARE.INI. This is not a fearsome task however.
Appendix A. PCMCIA Driver Software Notes This is a blank page.
Appendix B. Command Line Operation B.1 Introduction All options in SMCRead can be specified as command line parameters when the program is run. This enables semi-automated reading of the cards as SMCRead can be called from a DOS batch file. The parameters should be entered in the order that they would be entered when running SMCRead. If you wish, you can spell out the name of the option selected in full, as only the first character of the option is read by SMCRead.
Appendix B. Command Line Operation Critical This parameter is used when running SMCRead under Windows to prevent task switching (see section 5.5). NOTE B-2 SMCRead has the same capability as GraphTerm, CSMCOM and SMCOM to send character strings.
Appendix C. SMCRead Error Messages Error: No card found in slot number # The PC cannot find the card in the slot specified. Error writing data to filename, check disk space and try again. A file system error has occurred when writing a program file to disk. Check for available disk space or disk corruption. Program nn not found. There is no program nn in the card. Error - no room on card. Shown when loading a .DLD program into a memory card when there is not enough space left.
Appendix C. SMCRead Error Messages Error writing data to disk, collection aborted. An unforeseen error has occurred when writing data to disk. No data stored in the card! The newest file does not contain any data! Invalid location specified in command line parameter! For the L option you have specified an invalid display location number in the DOS command line. Unable to move the display pointer to that location! check validity. The value entered may be too large for the card size in use.
This is a blank page.
Campbell Scientific Companies Campbell Scientific, Inc. (CSI) 815 West 1800 North Logan, Utah 84321 UNITED STATES www.campbellsci.com info@campbellsci.com Campbell Scientific Africa Pty. Ltd. (CSAf) PO Box 2450 Somerset West 7129 SOUTH AFRICA www.csafrica.co.za sales@csafrica.co.za Campbell Scientific Australia Pty. Ltd. (CSA) PO Box 444 Thuringowa Central QLD 4812 AUSTRALIA www.campbellsci.com.au info@campbellsci.com.au Campbell Scientific do Brazil Ltda.