Timewave DSP-D300 User manual

DSP-D300
ALERT/IFLOWS Decoder
Revision 3.6
© Copyright 2005-2009, Timewave Technology Inc., All Rights Reserved

Table of Contents
Overview............................................................................................................................. 7
DSP-D300 Operation.......................................................................................................... 8
Ethernet Operation.......................................................................................................... 8
Serial Operation .............................................................................................................. 8
USB Operation................................................................................................................ 8
NIST................................................................................................................................ 8
Status Commands............................................................................................................ 8
Alarms............................................................................................................................. 9
DSP-D300 Shell (Command Line) ................................................................................... 11
Accessing the Shell....................................................................................................... 11
SSH from UNIX or Cygwin ..................................................................................... 11
SSH from Windows .................................................................................................. 12
Type A Shell Commands.............................................................................................. 12
adduser ...................................................................................................................... 14
compareimage........................................................................................................... 14
deluser....................................................................................................................... 14
echo........................................................................................................................... 14
format........................................................................................................................ 15
iflows......................................................................................................................... 15
last............................................................................................................................. 15
levelhistory................................................................................................................ 16
listusers ..................................................................................................................... 16
loadimage/verifyimage ............................................................................................. 16
ls................................................................................................................................ 16
passwd....................................................................................................................... 17
ping ........................................................................................................................... 17
quit ............................................................................................................................ 17
reboot ........................................................................................................................ 17
regen.......................................................................................................................... 18
rm .............................................................................................................................. 18
set .............................................................................................................................. 19
status ......................................................................................................................... 20
stty............................................................................................................................. 21
time ........................................................................................................................... 21
updateimage .............................................................................................................. 21
uptime ....................................................................................................................... 22
ver ............................................................................................................................. 22
volume....................................................................................................................... 22
whoami...................................................................................................................... 22
Type B Shell Commands .............................................................................................. 23
date............................................................................................................................ 24
echo........................................................................................................................... 24

ifconfig...................................................................................................................... 24
iflows......................................................................................................................... 25
last............................................................................................................................. 25
levelhistory................................................................................................................ 25
loadimage/verifyimage ............................................................................................. 26
ls................................................................................................................................ 26
netstat ........................................................................................................................ 27
ping ........................................................................................................................... 27
quit ............................................................................................................................ 27
reboot ........................................................................................................................ 28
setnetwork................................................................................................................. 28
setpassword............................................................................................................... 29
settelnet ..................................................................................................................... 29
settimeout.................................................................................................................. 30
setverify..................................................................................................................... 30
status ......................................................................................................................... 31
threads....................................................................................................................... 31
updateimage .............................................................................................................. 32
version....................................................................................................................... 32
Control300 Control Program ............................................................................................ 34
File Menu...................................................................................................................... 35
Edit Menu...................................................................................................................... 35
View Menu.................................................................................................................... 36
Connections Menu ........................................................................................................ 36
Tools Menu ................................................................................................................... 37
Tools/Testing Menu.................................................................................................. 38
Tools/Update Menu .................................................................................................. 39
Window Menu .............................................................................................................. 39
Help Menu .................................................................................................................... 40
Configuration Manager................................................................................................. 41
Load from Disk......................................................................................................... 41
Save to Disk .............................................................................................................. 42
Load Configuration................................................................................................... 42
Save Configuration ................................................................................................... 42
Copy.......................................................................................................................... 42
Diagnostic Shell............................................................................................................ 43
Adjusting Input Threshold (Tuning)............................................................................. 44
Manual Tuning.......................................................................................................... 44
Ethernet Settings ........................................................................................................... 45
Options.......................................................................................................................... 45
General...................................................................................................................... 46
Device Options.............................................................................................................. 47
DSP Options.............................................................................................................. 47
Logging..................................................................................................................... 48
Log Format............................................................................................................ 48
Ports .......................................................................................................................... 49
4

Setting the IFLOWS filter............................................................................................. 49
Changing the Receive Frequency ................................................................................. 50
Test Data Generator ...................................................................................................... 51
Resetting the Processors ............................................................................................... 52
CommReadTW Diagnostic Program ................................................................................ 53
Adding a Port ................................................................................................................ 53
Auto-Recovery.............................................................................................................. 54
LogCompareTW Diagnostic Program .............................................................................. 56
Comparing..................................................................................................................... 57
Filtering......................................................................................................................... 57
Duplicates ................................................................................................................. 58
Source ....................................................................................................................... 58
Frequency.................................................................................................................. 58
Time .......................................................................................................................... 58
Appendix: Installation....................................................................................................... 60
Getting Started .............................................................................................................. 60
Check the Package Contents..................................................................................... 60
Package Contents.................................................................................................. 60
Other Hardware Needed ........................................................................................... 60
Computer System Requirements........................................................................... 60
Connecting the Cables .............................................................................................. 61
Install the Software ................................................................................................... 62
Turning it all on ........................................................................................................ 65
Installing the USB driver .......................................................................................... 65
Setting up the DSP-D300 for the first time............................................................... 66
Tuning................................................................................................................... 68
Setting up the Ethernet connection ....................................................................... 68
Factory Reset ................................................................................................................ 68
Appendix: Updating the PC Software............................................................................... 70
Appendix: Updating the Firmware ................................................................................... 72
Core CPU...................................................................................................................... 74
Version Revision Update .......................................................................................... 74
Full Update................................................................................................................ 75
DSP ............................................................................................................................... 84
Ethernet......................................................................................................................... 85
Appendix: About Timewave............................................................................................. 88
Appendix: Change Log ..................................................................................................... 90
Appendix: Theory of Operation........................................................................................ 92
Appendix: Connectors and Pinouts................................................................................... 94
I/O Assignment Table................................................................................................... 96
Appendix: IFLOWS Packets............................................................................................. 98
ADF............................................................................................................................... 98
BDF............................................................................................................................... 98
EIF................................................................................................................................. 98
Appendix: Troubleshooting ............................................................................................ 100
Appendix: Specifications................................................................................................ 104
5

Table of Figures .............................................................................................................. 106
Glossary .......................................................................................................................... 108
Index ............................................................................................................................... 110
6

Overview
The Timewave DSP-D300 is used to decode and filter radio reporting gauge data packets
that transmit in ALERT (Automated Local Evaluation in Real Time) formats over the
IFLOWS (Integrated Flood Observing and Warning System). The DSP-D300 connects
to the output of the radio receiver, and transmits the decoded data packets either to a
Local RS-232 device, a Filtered output for a Satellite RS-232 device, or via a Filtered
Ethernet port (for use over the Internet). DSP-D300 adjustments may be done via remote
access through the Ethernet port using SSH.
For system requirements and installation information, see Getting Started on page 45.
For details on how the D300 works internally, see Appendix: Theory of Operation on
page 92.
7

DSP-D300 Operation
The DSP-D300 has three categories of user-initiated Commands: Control, Status, and
Upgrade. All the Commands must be entered via USB or Ethernet via the Command
Prompt.
Ethernet Operation
The Control and Status can be initiated via the SSH server on the Ethernet port while the
unit is streaming ALERT data. See the section DSP-D300 Shell (Command Line) on
page 10 below.
Serial Operation
The Serial ports send the IFLOWS packets. All ALERT data must go to a computer
with a serial port. Both ports can be connected via the same computer.
USB Operation
The USB port is for control by the Control300 program. Please see the chapter on
the Control300 Control Program on page 24. Access to the Shell is at root level
automatically from the Control300 program.
NIST
The DSP-D300 supports the standard NIST protocol. However, if the D300 is not
connected to the Internet, or there is an intervening firewall, this will cause connection
problems. To override this, set the NIST time to disabled. This needs to be done from
the shell. See DSP-D300 Shell (Command Line) on page 10 for instructions on how to
use the shell.
$ SET NISTHost=Disabled
Note: Setting the NISTHost to Disabled will set the internal date to 1970. The internal
date may be manually set via the TIME command (page 21).
To re-enable NIST, set it to “Enabled”.
If a “Waiting for NIST server” appears on the boot then the NIST server is inaccessible
from the network. To disable the time check, disconnect the Ethernet cable, reboot, and
the D300 will boot in Offline mode. Activate the shell and disable NIST as described
above. Save, plug in the Ethernet cable, and Reboot.
Status Commands
A feature of Timewave DSP products is the ability to query them about their status. This
includes items such as
•internal operating temperature
8

•power supply voltage
•port activity
•firmware version numbers
To view this information, either monitor it from the Control300 program (See Control300
Control Program on page 24) or type “status” from the command line. See DSP-D300
Shell (Command Line) on page 10 for instructions on how to use the shell’s command
line.
Alarms
Another feature of the D300 is the alarm generator. Alarms are generated by:
•Watchdog timeout on the packets. (No packet activity for set period of time.)
•(Open for future expansion.)
These alarms may be set by entering the timeouts in the SET command line control. See
set on page 18.
The D300 will send an alarm for special conditions to a monitoring computer. The
computer must either have a port monitor running or use the “IFLOWS Monitor”. This
program has been is no longer supported, but is described here for clarity.
Figure 2: IFLOWS Monitor
The IFLOWS Monitor resides next to the clock on the Notify Bar. It uses an alarm bell
icon. By clicking on the icon, a menu appears for exiting or setting the options.
9

Figure 3: DSP-D300 Alarm Options Screen
There are four options for alarms: Message Box, Notify Message, Audio Alarm, or it may
be Disabled.
Message Box This will pop up a message box in the middle of the screen.
Notify Message This will pop up a notify message off of the monitor icon.
See Figure 4 below.
Audio This will play the WAV file selected.
Disabled This will disable all pop-up alarms.
Also, all alarms will be shown on the Options window.
Figure 4: Notify Message Alarm
10