MET TESTBED53 Commands - for internal WHOI MET module testing

file: logr_testbed53_cf_cmnd.html
21 Mar 2017

MET TESTBED53 Commands - Firmware Ver 4.14X with CompactFLASH

MET Logger always comes up running and logging in fixed configuration - see 'default' config below.

CFLASH NOTE 1 - Firmware Ver 4.xxX has been tested using SanDisk CompactFLASH cards (256 MB and 64 MB) with SanDisk CompactFLASH PC Card (PCMCIA) Adapters on WHOI VMLOGR53 Rev D CPU boards.

CFLASH NOTE 2 - CompactFLASH cards MUST be formatted using the I command choice in the FOK command menu. CompactFLASH cards may be read on a PC and will contain 2 files: a .INF user-defined Info file, and a .DAT Data file. Processing of the new .DAT file is identical to processing the data files from older PCMCIA-based loggers, since the data file record format is unchanged.

There are 3 possible configurations for the TESTBED53. Two types of MET modules (up to 5 of each type) may be tested depending on the configuration. Check the current configuration with STAT.

HRHPRC - HRH modules on ports 1-5, PRC modules on ports 6-10
LWRSWR - LWR modules on ports 1-5, SWR modules on ports 6-10
WNDBPR - WND modules on ports 1-5, BPR modules on ports 6-10

example ASIMET Module port assignments for HRHPRC configuration

(Port 1 thru Port 10 correspond to LOGRIF PC Board P1 thru P10)

Port 1 - HRH1
Port 2 - HRH2
Port 3 - HRH3
Port 4 - HRH4
Port 5 - HRH5
Port 6 - PRC1
Port 7 - PRC2
Port 8 - PRC3
Port 9 - PRC4
Port 10 - PRC5

Command Descriptions

- ALL COMMANDS ARE TERMINATED IN CARRIAGE RETURN <cr> - don't forget! It's assumed for all commands below

- Remember: Modified address mode only - PRECEDE ALL COMMANDS WITH # (full address not used)
- NOTE: The FULL command set is ONLY available when the TESTBED53 is NOT running (see STOP command).

A to echo "address\r\n" - artifact of IMET, simple confirmation of 'life'
- NOTE: address is NOT USED currently, but may be set/modified by UOK command below.
CLOCK to see current date/time setting. Responds with "yyyy/mm/dd hh:mm:ss\r\n"
CLOCK=yyyy/mm/dd hh:mm:ss to set date/time; Sampling MUST be STOPPED to set the clock.
D responds with a 10 lines of data, one for each port, from most recent sample interval; the values used depend on the particular ASIMET module test and unused (trailing) parameters are set to 0.0 .
- each line is terminated with \r\n
Firmware Ver 4.14X displays:
- Parm1 Parm2 Parm3 Parm4
- Parm1 Parm2 Parm3 Parm4
- Parm1 Parm2 Parm3 Parm4
- Parm1 Parm2 Parm3 Parm4
- Parm1 Parm2 Parm3 Parm4
- Parm1 Parm2 Parm3 Parm4
- Parm1 Parm2 Parm3 Parm4
- Parm1 Parm2 Parm3 Parm4
- Parm1 Parm2 Parm3 Parm4
- Parm1 Parm2 Parm3 Parm4
Parameter assignments as follows:
HRH Parm1 = RH%, Parm2 = T
PRC Parm1 = Precip Level

LWR Parm1 = Dome, Parm2 = Body, Parm3 = Thermopile, Parm4 = LWflux
SWR Parm1 = Swr

WND Parm1 = WndE, Parm2 = WndN, Parm3 = Vane degrees Avg, Parm4 = Compass Dir
BPR Parm1 = BP
FOK for menu-driven CompactFLASH command operations
- Sampling MUST be STOPPED for CFLASH command ops.
- Upon FOK command entry, and between each command, you will see a prompt:
Enter Flash Cmnd, ? or H for Help:
- a request for Help returns this message followed by another prompt:
```
    Flash Help (All commands end with Enter)

    C - Read card Capacity
    D - Read the card Directory
    E[I,D] - Erase the contents of the Info or Data files
    F[W,R] - Write or Read the Info File
    H{?} - Display this menu
    I - Format & Initialize the card file structures
    P - Read the next write & read sector Pointers
    R{H,A}{SEC} - Read the next card sector (see P command above)
             optional {H,A} -> Hex ASCII or printable ASCII
	     optional {SEC} -> specific sector number
    S - Read the CF status (reg 7 and the ERRORs (reg 1), disp as HEX-ASCII
    W{nnn} - Write 512 byte Test Msg to the Data file
             optional {nnn} -> 1-3 digits of additional sectors to write
    Q - Quit Flash operations

    Enter Flash Cmnd, ? or H for Help:
        
```
- description of FOK Menu Commands:
- C - displays card capacity info
- D - displays a card directory (similar to a DOS "dir" command output):
```
Volume in drive is TESTBED53
Directory of CF:
2017/02/24  19:10                   35 TBED53.INF
2017/02/25  16:42               523904 TBED53.DAT
               2 File(s)         523939 bytes
                              256179584 bytes free
       
```
- EI - erases the contents of the INFO file, and sets its size to 0
- ED - erases the contents of the DATA file, and sets its size to 0
- FR - reads the free-format ASCII contents of the INFO file
- FW - prompts for up to 600 characters of user info; CTRL-C terminates entry into the INFO file
- I - formats & initializes the CFLASH card for use in the logger. A series of prompts guides you through the process. This must be done before the logger will recognize the card and use it for data storage.
- P - reads the next write and read sector pointers. In particular, the next write sector pointer always indicates the last sector of data on the card. This is useful with the XMODE command.
```
  
Flash Write Pointer @ 1345
Flash Read Pointer @ 258
       
```
  The write sector pointer is always restored to the currently available sector for new data whenever the logger is powered up. The read pointer is reset to the INFO file sector on power up.
- R - read command allows a number of options, the most useful being the RH and RH{SEC} options. For example, to see what's in the last DATA sector, use the P command above to find the current write sector, then use that in the RH{SEC} command to see the values. So, for the value of the Flash Write Pointer above, send RH1345 to see the 512 bytes of that sector:
```
 
Reading Flash @ 1345

000  10 29 19 04 07 00 64 01 00 00 00 00 00 00 00 00 .)....d.........
010  00 00 0D F2 09 AC 00 00 08 F0 AD 2E 00 00 00 00 ................
020  00 00 00 00 00 00 00 00 00 00 00 00 30 D4 31 38 ............0.18
030  31 9C 32 00 07 5B CD 15 00 01 00 00 00 00 A5 A5 1.2..[..........
040  10 2A 19 04 07 00 65 01 00 00 00 00 00 00 00 00 .*....e.........
050  00 00 0D F2 09 AB 00 00 08 F5 AC F9 00 00 00 00 ................
060  00 00 00 00 00 00 00 00 00 00 00 00 30 D4 31 38 ............0.18
070  31 9C 32 00 07 5B CD 15 00 01 00 00 00 00 A5 A5 1.2..[..........
.
.
.
1B0  31 9C 32 00 07 5B CD 15 00 01 00 00 00 00 A5 A5 1.2..[..........
1C0  10 28 19 04 07 00 63 01 00 00 00 00 00 00 00 00 .(....c.........
1D0  00 00 0D F2 09 AA 00 00 08 D3 AD 6A 00 00 00 00 ...........j....
1E0  00 00 00 00 00 00 00 00 00 00 00 00 30 D4 31 38 ............0.18
1F0  31 9C 32 00 07 5B CD 15 00 01 00 00 00 00 A5 A5 1.2..[..........
      
```
  If you want to read subsequent contiguous sectors, just do an RH at the next prompt, and the next sector in sequence will display (1346 in this example). See Record Format to decode the HEX dump.
- S - CF status info - internal WHOI use only
- W{nnn} - writes test data to the current write sector in the DATA file. Used only for test. If you use this function, you should ED to erase the DATA file before deploying the logger, unless you wish to incur the wrath of your data processing guru!
- Q - quit Flash ops and return to logger command mode
- New CFLASH Card Prep - when installing a CFLASH card for the first time, it must be initialized for use in the logger. The "I" command, Format & Initialize card file structures is used to prepare the CFLASH card for use. You will be prompted for a Volume name, an INFO File name, and a DATA file name. The 3 character suffix of the INFO file is always .INF and the 3 character suffix of the DATA file is always .DAT Once formatting is complete, you can get a directory with a "D" command, or write user info into the INFO file with the "FW" command, then read the INFO file back with the "FR" command.

FS for CompactFLASH status and directory

- example - displays the following info:

Compact Flash Card present - Compact Flash OK!

Volume in drive is TESTBED53
Directory of CF:
2017/02/24  19:10                   35 TBED53.INF
2017/02/25  16:42               523904 TBED53.DAT
               2 File(s)         523939 bytes
                              256179584 bytes free

GO to start sampling (power up default - only used to restart after STOP for testing, new configuration, etc.) Responds with "Sampling GO\r\n". Sampling MUST be STOPPED.

HELP displays a brief list of all the commands. Each line is terminated in "\r\n". A truncated HELP output is displayed when LOGR53 is running (GO mode); i.e., only those commands available while running are displayed. To access the full command set, the LOGR53 must be STOPPED.

   Example of output in STOPPED mode:

   Firmware TESTLOGR53 v4.11X
   A - Address acknowledge
   CLOCK(=YYYY/MM/DD HH:MM:SS) - Read/Set RT clock date/time
   D - Send latest standard data
   F - Compact FLASH commands:
       FOK - Complete Sub-Menu
       FS - Status & Dir info only
   GO - Re-start sampling
   H - Display Help message
   STAT - System status info
   STATD - System status info & CFLASH Dir
   STOP - Stop sampling
   T - Test mode commands:
       TM - MET Module tests
   UOK - Update EEPROM constants
   XMODE - XMODEM Dump CFLASH card via RS232 console

STAT reports all current settings in multiline format. On an EEPROM failure, the first line will be "\r\nDEFAULT OPERATION\r\n".
- Normal Operation, STAT command:
  Instrument Address\r\n (not used)
  Model\r\n
  Serial Number\r\n\
  Latest Checkout/Calibration Date\r\n
  Firmware Name and Version\r\n (from EPROM)
  RTC date and time\r\n (CLOCK command format)
  Logging Interval and Current Tick\r\n
  Recent Record Interval (R-interval)\r\n
  CFLASH Card Present?\r\n
  (optional failure messages for any bad/missing modules)
  Test Type
  Sampling GO\r\n
```
    Example of STAT:

    LOG01
    Model: TESTLGR53
    SerNum: L12
    CalDat: 04MAR17
    Firmware: TESTLGR53 v4.11X
    RTClock: 2017/03/06  15:24:00
    Logging Interval: 60; Current Tick: 3
    Compact Flash Card present - Compact Flash OK
    Test type: HRHPRC
    Sampling GO

    
```
STATD reports as above, with the addition of directory info for the CFLASH card.
- Normal Operation, STATD command:
  Instrument Address\r\n (not used)
  Model\r\n
  Serial Number\r\n\
  Latest Checkout/Calibration Date\r\n
  Firmware Name and Version\r\n (from EPROM)
  RTC date and time\r\n (CLOCK command format)
  Logging Interval and Current Tick\r\n
  CFLASH Card Present?\r\n
  Several lines of Directory info, each terminated \r\n
  (optional failure messages for any bad/missing modules
  Test Type
  Sampling GO\r\n
```
    Example of STATD:

    LOG01
    Model: TESTLGR53
    SerNum: L12
    CalDat: 04MAR17
    Firmware: TESTLGR53 v4.11X
    RTClock: 2017/03/06  15:24:00
    Logging Interval: 60; Current Tick: 3
    Compact Flash Card present - Compact Flash OK!
    Volume in drive is TESTBED53
    Directory of CF:
    2017/03/04  19:10                 35 TBED53.INF
    2017/03/05  14:20             519168 TBED53.DAT
		2 File(s)         519203 bytes
			       256184320 bytes free
    Test type: HRHPRC
    Sampling GO

    
```
NOTE: Power to failed modules is cycled OFF for 45 seconds, then restored; At the next 1 minute interval, new data will NOT be ready - new data will appear at 2 minutes after the power was originally cycled off.
STOP to stop sampling and allow configuration changes or testing. Responds with "Sampling STOP\r\n".
TM Test all modules (Ports 1 thru 10 only, fixed format)
- On entry, displays "MET Module test command", then continuously tries to poll the 10 modules by sending a 'C' command to the default module addresses (e.g. #HRH01C and #PRC01C)
- displays one module per line, full 'C' command return string
```
Example (two HRH and on PRC attached for test):
MET Module test command
HRH1:  14.313  21.170   0.0   0.0
HRH2:  14.334  21.210   0.0   0.0
HRH3: not responding (not installed?)
HRH4:  14.326  21.179
HRH5: not responding (not installed?)
PRC6:  13.6
PRC7: not responding (not installed?)
PRC8: not responding (not installed?)
PRC9: not responding (not installed?)
PRC10: not responding (not installed?)
                
```
- Updates about every 5 seconds (longer if missing modules)
- To quit, hit ESC.
- NOTE: there is about a 2 second timeout delay on each bad/missing module
- Sampling MUST be STOPPED to use any test command.
UOK enter configuration update mode (held in EEPROM)
- Commands tagged with * will respond individually with their current settings if terminated immediately with <cr>; i.e. to see the current address, send ADR<cr>
- Remain in update mode until ABORT or WRTOK command.
- Sampling MUST be STOPPED to enter update mode.
  - ABORT to quit this mode without update; responds with "quitting...\r\n" after restoring original settings.
  - * ADR=xxxxx to set 1 to 5 character address (default is LOG01). These must be alpha-numeric. NOT USED
  - * CD=xxxxxxx to set a free format, 7 characters max, configuration date. For reference only, not used internally by instrument. Displayed in STAT[D] commands.
  - * RI=xxxx to set the logging interval (typically 60 seconds) The interval may be from 60 to 3600 seconds, in multiples of 60 seconds only! Displayed in STAT[D] commands. CAUTION: Long term testing has been performed only at the 60 second logging interval (RI=60)
  - * T=x to set a test type to H, L, or W (HRHPRC, LWRSWR, or WNDBPR)
    Restart required for new test type to take effect!
  - WRTOK to write all EEPROM parameters. Update mode exits upon completion of write.
XMODE XMODEM Dump CFLASH card via RS232 console
- Sampling MUST be STOPPED and logger comms MUST be set for RS232 to dump data via XMODEM
CompactFLASH cards will take FOREVER to read this way - the preferred method of reading data is to remove the CFLASH card from the LOGR53 and read it on a PC. Two files will be recognized by the PC, an INFO file which can contain up to 600 characters of user information, and a DATA file which contains the logger data records. See the FOK command above.
- This command is rudimentary; if you must dump data this way, use the FS command to display the current directory and file sizes on the CFLASH card. You can then estimate where to start dumping data, based on one 64 byte record per minute, and a CFLASH sector size of 512 bytes. Or use the FOK command to look at the HEX values of particular sectors to decide where to start the dump.
- Command dumps data from the requested starting sector for up to 2048 512-byte sectors (i.e. a maximum of 1 MB of data). Sector 322 is the first sector of the data file on the CFLASH card.
- On command entry, requests: Start sector # (322 is first, 0 aborts) -> followed by: Number of sectors (1 to 2048, default is 512) ->
- i.e. to get first MB of data (16384 logger records -> about 11 days), enter 322 as the start sector, and 2048 for the number of sectors.
- add 2048 to your start sector number to find the start of subsequent 1 MB portions of data; i.e. if you entered 322 to start at the first sector on the FLASH card, subsequent 1 MB portions of data start at sector 2370, 4418, etc...
- Typical example - the following description assumes PCPLUS for terminal software, but any terminal program capable of XMODEM transfer should work.
- On entry, LOGR53 will first prompt for start sector:
  Start sector # (322 is first, 0 aborts) ->
  Enter a valid sector # (see discussion above)
- followed by a prompt for number of sectors:
  Number of sectors (1 to 2048, default is 512) ->
  Enter a valid sector count (see discussion above)
- Next, you'll be prompted:
  Set terminal speed for 38400 then hit any key
- After setting speed and hitting a key, you will see:
  XMODEM Send Function
  Waiting for start...
- Start a transfer (PgDn in PCPLUS) - on completion, you will see something like:
  Sent 160 blocks - done
  Restore terminal speed to 9600 then hit any key
  NOTE:"blocks" here are XMODEM blocks of 128 bytes each
- After resetting speed to 9600 baud and hitting a key, LOGR53 will send a "\r\n"
- Ignore occasional gibberish when changing baud rates!
- See also Record Format.