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
DSP-D300 Shell (Command Line)
The shell is a UNIX style command line that allows the system to be configured. This is
similar to a UNIX bash shell or a DOS command prompt. A basic knowledge of
command line use is recommended for this section.
There are two versions of the command line shell, the first (hereafter called Type A) is
used with versions 1.0-3.5. The second (Type B) is a faster, simplified and standardized
one new to version 3.6 and higher.
Accessing the Shell
A new box has a “root” account with a password of “foo”. See the section below on
adduser (page 13) for adding more users for Type A shells.
SSH from UNIX or Cygwin
To connect via SSH to the D300, follow the following procedure:
$ssh 192.168.3.238 -lroot
OpenSSH Version OpenSSH_3.7p1, see http://www.openssh.org
Shell Version 1.0, Copyright (c) 2004-2005, Timewave Technology Inc.
Build Jul 1 2005 13:05:22 RC2
$
At this point the connection is complete. The “$” prompt is from the D300 shell.
Please note that the password prompt may take up to a minute to appear.
SSH is certified under the FIPS 140-2 regulations, and is applicable in the
following modes:
•**AES (128, 192, 256)
•*Triple-DES
•*RSA
•*HMAC-SHA-1
•**HMAC-MD5
•*HMAC-SHA-1 96
•*CAST-128
•*Blowfish
•*Arcfour
•#HMAC-RipeMD
•#HMAC-MD5 96;
* indicates an available mode
** indicates a common mode used for SSH 2.0
# indicates a common mode in SSH 2.0 that is not FIPS certified
11
There are many other modes available to SSH, but are not certified in the FIPS
nor are commonly used.
The DSP-D300 connection uses AES or HMAC-MD5 if available.
SSH from Windows
There are many SSH clients available for Windows. Included on the software
CD in the Tools directory is a public domain program called PuTTY. The latest
version of this may be retrieved from:
http://www.chiark.greenend.org.uk/~sgtatham/putty/
Procedure for PuTTY:
1. Click on “Connection”
2. Type the login name wanted into the “Auto-Login username” box.
3. Click on “Session”
4. Type the IP or URL of the DSP-D300 box into the “Host Name” box.
5. Make sure “SSH” is selected.
6. Click on “Open”.
7. A window will pop up, a few seconds later you will be prompted for the
password.
8. Enter the password for the login that you entered.
9. The shell should appear.
Type A Shell Commands
You may get a list of commands by typing “help” at the command line:
$ help
Internal Commands:
adduser user [pass] add user
deluser user delete user
dnslookup domain lookup specific domain name
echo argument echo the argument to the tty
last list the last 8 users who have logged in
listusers list the configured users
ls [-l] list the internal stored files
passwd user pass set user's password to pass
ping ipaddr test a connection
quit disconnect
reboot reboot the device
regen regenerate the keys
rm file remove a virtual file
set [param=value] show and change system settings
load abandon changed system settings
save save changed system settings
stty [value] show and change terminal settings
time [-s offlinetime] show [set] time
uptime time since boot
ver show version
whoami show currently logged in user
External Commands:
iflows [address [on/off/update]]
set/get the iflows filter
12
(address="all" to set all)
status show the status
volume left/right level set the volume to level (0 to -62 dB)
gain level set the gain to level (-24 to 62 dB)
levelhistory list recent audio levels
loadimage image ip upload new image from ip
verifyimage image ip verify new image from ip
compareimage verify new image from FLASH
updateimage update memory from loaded image
13
adduser
adduser user [password]
Parameters: user The name of the new user
password The password for the new user. If not given, the password
will be blank. See passwd for setting the password.
Description:
Adds a user to the user database.
Notes:
There are a total of 5 users possible. The user “root” cannot be renamed.
compareimage
compareimage
Description:
Compares a downloaded image (see loadimage) with the program already set in the FLASH. Used
to determine if a program update is necessary.
deluser
deluser user
Parameter: user The name of the user to remove
Description:
Removes a user from the user database.
Notes:
There are a total of 5 users possible. The user “root” cannot be removed.
echo
echo argument
Parameter: argument Any text
Description:
Copies the text typed.
14
format
format argument
Parameter: argument The only allowed value is “FLASH”
Description:
Erases the internal file system. Immediate rebuilding of the encryption keys will ensue at the next
boot. See regen.
iflows
iflows [address [setting]]
Parameter: address The address from 0-3071 to set. If not given, then the entire
filter table will be shown.
setting Turn it off or on or forces an update. If this is not given,
then the current setting will be returned.
Description:
Controls the IFLOWS filter.
Notes:
For the setting, “ON”, “YES”, “ENABLE”, and “1” may be used to enable to address. If the entire
filter is NOT selected, than updates will be forced before setting the addresses.
This is not a real-time update. There may be a lag of up to 10 minutes for updates. This includes
reboot.
last
last
Description:
Lists the recorded system events.
Notes:
The last 32 system events are recorded. There are three fields in the system event database: User,
Type, and Time. If the NIST time check is not enabled, the time may be invalid.
Field Possible Values Description
User Username,
root,
System Boot
The name of the user who created
the event.
Type SSH Remote,
Diagnostic
Remote or Local operation
Time The time (UTC)
15
levelhistory
levelhistory
Description:
List the last 40 recorded dB levels.
Notes:
dB levels are not updated in the shell more than a few times a second.
listusers
listusers
Description:
List the users currently using the DSP-D300.
Notes:
Any user logged into the console will be “root”.
loadimage/verifyimage
loadimage file ipaddress
verifyimage file ipaddress
Parameter: file The image file on the TFTP server. Usually “image.bin”
Ipaddress The IP Address of the TFTP server.
Description:
Downloads a new program image from a TFTP server. loadimage will load the new program into
memory, whereas verifyimage will check the downloaded image against an image already in
memory.
ls
ls [-l ]
Parameter: -l Show the long form of the file listing.
Description:
Show the virtual files on the DSP-D300.
Notes:
The format is based on the UNIX ls format.
16
passwd
passwd user pass
Parameters: user The name of the user to change the password for.
pass The new password for the user
Description:
Change a user’s password.
Notes:
There cannot be a blank password once the password is set.
ping
ping URL/IP
Parameters: URL The URL address of a domain.
Example: www.yahoo.com
IP The IP address to test
Example: 216.109.118.68
Description:
Test a connection.
Note:
Unlike the UNIX ping, this will only send one packet to test for a connection.
quit
quit
Description:
Exits the shell / Logs out.
reboot
reboot
Description:
Reboots the DSP-D300 to activate any saved changes. See also save.
Notes:
Changes must be saved with save before rebooting.
17
regen
regen
Description:
Regenerates the SSH keys.
Notes:
1. This can take up to half an hour.
2. Local keys on the calling PC will need to be reset to allow logins from the client SSH.
rm
rm file
Parameter: File Virtual file to remove.
Description:
Removes a file from the virtual filesystem.
Notes:
1. The virtual file SYS.DAT cannot be removed.
2. Removing the SSH keys will force an automatic key regen at the next boot. See regen.
18
set
set [setting=value]
Parameter: setting What to set
Value The value to set it to
Description:
Sets a system operating parameter.
Example:
$ set
IPAddress=216.43.106.185
IPMask=255.255.255.248
Gateway=216.43.106.190
MACAddress=00:40:9D:23:E3:1E
DNSServer1=209.253.113.18
DNSServer2=209.253.113.10
PacketTimeout=300 seconds
PacketTimeoutPort=3010
PacketTimeoutAddr=192.168.3.60
PacketMode=EIF
TelnetServer0=test1.timewave.com (216.43.106.188)
TelnetPort0=3000
TelnetRetry0=30 seconds
TelnetMode0=Raw
NIST host=Enabled
207.200.81.113 nist1.aol-ca.truetime.com - TrueTime, AOL
facility, Sunnyvale, California
$ set ipaddress=216.43.106.186
$ save
Saved. Reboot to activate changes.
$
Notes:
1. After changing a setting, the save command must be used to save the changes.
2. If changes are made but have not been saved, the load command may be used to restore them
to the last saved values.
3. After saving the changes, they will not be used until a reboot.
4. There are several standard settings:
19
Field Possible Values Description
IPAddress IP Address The IP address of the DSP-D300
IPMask IP Address The network mask.
Gateway IP Address The network gateway.
MACAddress IP Address The MAC address for the DSP-D300. It is
recommended that this is NOT changed from
the default. This is also printed on the internal
Ethernet module.
DNSServernIP Address The IP address of the primary, secondary, and
tertiary DNS servers.
PacketTimeout 0- 1073741823 seconds The idle timeout for packets. If no packet is
received within the timeout, a warning alarm is
sent.
PacketTimeoutPort Any port from 1 to 64000 The port for the Alarm. Standard is 23.
PacketTimeoutAddr IP Address The destination for the Alarm.
PacketMode EIF or BDF The mode the packets are sent to the server.
TelnetServernURL or IP address The URL or the IP address of the telnet server
to connect to. nrepresents the server number
from 0 to 14. Set the URL to “0” to disable
the telnet client connection.
TelnetPortnAny port from 1 to 64000 The port for the Telnet connection. Standard
is 23.
TelnetRetryn1-300 The number of seconds to wait to retry a failed
telnet connection.
TelnetModenRaw or Standard The type of telnet connection. Raw just sends
the packets. Standard will implement the
telnet protocol.
NIST host IP Address The discovered NIST host. Not user
changeable.
status
status
Description:
Give the system status.
Notes:
There are several parameters for the status:
CPU Temperature Current board temperature.
Board Voltage Current board voltage. Should be around 17 VDC.
COM1 I/O Bytes in and out the primary COM port and Telnet Clients.
COM2 I/O Bytes in and out the secondary COM port.
Signal Level The current audio level.
Signal Gain The current audio gain.
CPU Uptime How long the main processor has been running.
CPU Status The CPU status byte in hexadecimal.
Telnet Port Connection status for Telnet.
Shell Online Whether the shell is online or not.
20
Other manuals for DSP-D300
1
Table of contents
Other Timewave Media Converter manuals
