background image

Instruction manual Wav WaveGuide Server

Appendix 2:

 

Properties file “wgs.properties”

The WGS.properties file is used in the startup procedure to configure the system. Below a wgs.properties file is 

printed. To modify the configuration this file should be edited.

There are two ways to edit the file :

1. Copy the file to your own computer. Edit it and copy it back to the WaveGuide Server. Copy can be done 

via ftp or via a ssh connection. To edit the file use a editor and not a word processor as the latter adds all 

kind of extra characters to the text.

2. Edit the file on the system itself. Make a ssh connection and use the editor program “

nano

” to edit the file

at the WaveGuide Server. A ssh connection can be established from a Linux console. From a windows 
computer this can be done with the freeware program “

putty”

.  Beside a ssh connection also a telnet 

session will work.

Use the ip address given in the display of the WaveGuide Server (with push button 2 you go to the group network 

info and then with button1 you scroll between ip address and hostname). 

When you start a ssh connection it takes a few seconds to obtain the request for login name and password (default 

these are both 

radac

). 

First have a look in the /config directory.

ls /config

this gives a listing of the files in this directory. Two files are always there wgs.properties and wgs.properties.bak. 

Sometimes also a file wgs.properties.error is present. This error file is created when the system could not start 
with wgs.properties file because it is corrupt. In that case the system copies the corrupt wgs.properties file to  

wgs.properties.error and copies also a wgs.default file to wgs.properties. This is done to start the system anyway.  

to start the program “

nano”

 type :

nano  /config/wgs.properties

To go through the text use the arrow keys. The use of the editor is explained in the lower part of the screen. To 
save the edited version use as indicated 

Ctr O 

plus 

enter

 to confirm. To exit 

nano

 type 

Ctr X

. To restart the 

system the best is to switch the WaveGuide Server off and on again.

If something goes wrong and the system does not start as expected it might be the best to replace the 

wgs.properties by its back up version. You can do this in a ssh session by typing:

cp  /config/wgs.properties.bak  /config/wgs.properties

To remove the wgs.properties.error file type :

rm  /config/wgs.properties.error

Version 4.1

24 of 30

Oct 2013

Warning:

  Editing the wgs.properties file is risky.  The system can stop working.

Editing should be done by a skilled person. In case the file is damaged one back

up file is present at the system to bring the system back to its defaults.

Summary of Contents for WaveGuide

Page 1: ...Instruction manual WaveGuide WaveGuide Server Radac bv Elektronicaweg 16b 2628 XG DELFT Phone 31 15 890 32 03 Email info radac nl www radac nl...

Page 2: ...Instruction manual WaveGuide WaveGuide Server Version 4 1 2 of 30 Oct 2013...

Page 3: ...Instruction manual WaveGuide WaveGuide Server Version 4 1 3 of 30 Oct 2013...

Page 4: ...ity of the measurements 11 Set sample rate and mounting height and pipe diameter 12 Set system date time 13 Data distribution 14 Data distribution 14 Using the system 17 Parameters 17 Spectra 18 Data...

Page 5: ...ith the server via a RS485 serial link allowing a maximum cable length of 1200m All facilities are made easily available via the build in web server and the standard web browser at your own computer T...

Page 6: ...l structures as bridge pillars quay walls legs of an oil rig etc It is recommended to mount the WaveGuide at a minimum distance of 0 1x the height of the pole or qua wall The sensor has four mounting...

Page 7: ...e WaveGuide Server via an RS 485 connection A B and signal ground The cable must be twisted pairs and shielded eg Novasub DLR3 The maximum length is 1200 m The shielding must be connected to ground to...

Page 8: ...e screw connectors The right connector is to connect the radar and the supply Pins 1 2 and 3 are to be connected to the corresponding terminals 1 2 and 3 in the radar The link is RS485 To facilitate a...

Page 9: ...via a cross cable Inside the WaveGuide Server there is a PC104 computer with a Linux operating system It takes about 2 minutes to start up and during that time the display indicates STARTING WGS After...

Page 10: ...adcasting for a DHCP server in the network to obtain an IP address If there is no DHCP server responding the WGS will become a DHCP server itself with default ip address 192 168 111 71 A computer that...

Page 11: ...figuration you need to be an authorized user Therefore an authorization dialogue will appear when the user tries to change a configuration item The authorization will become invalid after 5 minutes of...

Page 12: ...aveGuide Server started correctly but there is no connection with the radar Check the cabling If the communication is OK and the temperature is given but the number of invalid measurements is to high...

Page 13: ...nd mounting height and pipe diameter This can be done in the Configure radar window The radar configuration is protected by an authorization dialog Sample rates of 5 2 56 2 and 1 28 Hz can be selected...

Page 14: ...accurate Therefore facilities are available to keep track of the correct time First the WaveGuide Server tries to synchronize its time to a time server which is often available in a network This is d...

Page 15: ...as COM2 9600 8 1 NONE NONE If a non valid string is filled the help info will appear The format for the network message is http ip address port e g http 192 168 111 103 8032 The subscriptions may not...

Page 16: ...NAME PARAMETER VALUE PARAMETER VALUE PARAMETER VALUE PARAMETER UNIT If all values in the message are not available only one NaN will appear Examples time 1306937346768 sensor standpijp Radcan 410 0 0...

Page 17: ...7 1615004E 4 7 975558E 4 7 6214876E 4 7 1647903E 4 7 6107396E 4 6 847791E 4 6 6441507E 4 4 567583E 4 7 3393347E 4 8 3342794E 4 7 177321E 4 8 320104E 4 9 631133E 4 4 7024636E 4 5 479116E 4 7 0798665E 4...

Page 18: ...60 60 DataProcessorGetData1 H H1 H5 H10 DataProcessorStoreData1 H H1 H5 H10 This indicates that from the SWAP processing is performed with an interval of 1 minute Default the processing period is 20...

Page 19: ...In the wave processing also the energy density spectrum is calculated This past ten can be asked for The interval between these spectra is equal to the calculation interval of the wave processing as...

Page 20: ...ty of usb disks and usb flash drives are delivered with FAT32 Mount the drive The system does not couple the drive automatically This should be done via the push buttons at the WaveGuide Server data l...

Page 21: ...d easily to another computer Login name and password are the same as to modify the settings default they are both radac Configure network At startup the WaveGuide Server will try to obtain its network...

Page 22: ...12 TE0 Band energy from 10Czz f in the range f 500 1000 mHz cm2 13 TE1 Band energy from 10Czz f in the range f 200 500 mHz cm2 14 TE1_M Band energy from 10Czz f in the range f 200 1000 mHz cm2 15 TE2...

Page 23: ...analysis period 38 Ndlr_H Number of valid subseries of the signal in the vertical direction 39 Ngd_zP percentage of vertical wave motion datapoints that do not contain error code before pre processing...

Page 24: ...the config directory ls config this gives a listing of the files in this directory Two files are always there wgs properties and wgs properties bak Sometimes also a file wgs properties error is presen...

Page 25: ...he first radar RadarID0 radcan RadarDriver0 nl radac wgs radar driver RadCan RadarDriverProperties0 COM4 115200 8 1 NONE NONE RadarHeartbeat0 nl radac wgs core DefaultHeartbeat RadarHeartbeatPeriod0 3...

Page 26: ...Time 0 storage in blocks MaximumStorageTime 144 TimeFrameDuration 1 DisplayID0 0 DisplayRadar0 radcan DisplayData0 heave H10 Hm0 Ngd_zP Tm02 HTE3 Fp Hmax HCM AV10_H DisplayDriverProperties0 COM5 11520...

Page 27: ...ill appear Once the WaveGuide program has started you can return to the Linux konsole by stopping the WaveGuide debug proces that sends its info to the comport This is done by sending a break followed...

Page 28: ...ed and in this spectrum also called reflection diagram the reflection peak is determined see figure 1 below Automatic Doppler correction If the water level rises the frequency of the return signal inc...

Page 29: ...Instruction manual WaveGuide WaveGuide Server Version 4 1 29 of 30 Oct 2013 Fig 1 Principle of Doppler correction in WaveGuide 973 up down...

Page 30: ...ximately 10 5cadar123 kg Casing material stainless steel 316 Electrical Radar frequency 9 9 10 2 GHz Modulation triangular FM Emission The emitted microwave energy is far below acceptable limits for e...

Reviews: