Remember me

Lost Password?

Register now!
Who is Online
9 user(s) are online (8 user(s) are browsing Wiki)

Members: 0
Guests: 9

[Main Page]

HardWaves Surfer Setup

From C-Labs Home

Main Page | Recent changes | View source | Page history | Switch to MediaWiki mode

Printable version | Disclaimers | Privacy policy



The “Surfer” USB dongle implements a WINE base-station.

A base-station acts as gateway of the WINE network. From the point of view of the host, Surfer is a just a serial TTY.

Surfer an be hosted on:

  • normal PCs
  • embedded systems (like RaspBerry PI, BeagleBone, Arduino)
  • NAS (like most of Synology models)

WARNING! An Internet connection is required. Also a minimal skill in Unix/Linux shell use is required.

A beginner guide may help Unix/Linux newbies. Keep in mind that shell commands require “Enter” to execute.



Please, for general information about RPI board and accessories refer to Raspberry-PI home.

WARNING! A console (monitor, keyboard and mouse) access to RPI is required. Expert users can use a SSH connection.

Hardware setup

  1. Connect a HDMI/DVI monitor to the RPI PCB
  2. Plug a USB Mouse in a free RPI USB port
  3. Plug a USB Keyboard in a free RPI USB port
  4. Plug Ethernet cable
  5. Fire power to RPI

Operating System setup

RPI is an ARM/Linux device. Here more information in OS installation process.

  1. Select “Raspbian” OS
  2. Click on “Install”
  3. Wait... (and wait)
  4. Login into RPI (user:pi password:raspberry)

Update and upgrade

  1. execute “sudo apt-get update”
  2. execute “sudo apt-get upgrade”
  3. wait (coffee, walkabout, a trip to New Zealand...)

Installation of required packages

  1. execute “sudo apt-get install mysql-server mysql-client” (set “root” as DB Manager password)
  2. execute “sudo apt-get install apache2 -y”
  3. (optional) execute “sudo apt-get install links”

Test WEB server (see WEB server installation).

The optional text-based links browser can download files from WEB pages directly on the RPI .

HardWaves Software setup

From the download area you get PDF documents and files for the selected target. Files are typically available in a zipped TAR format (.tgz extension), and may include a setup shell script.

Required files are:

  1. [WINE binaries]
  2. [Whole Web Archive]

Copy these files to RPI, possibly into the “home” directory of the “pi” (default) user (here a good howto).

To load directly on your RPI, you can alternatively use "wget" command:

wget -O rpi.tgz https://www.c-labs-wt.com/modules/wfdownloads/visit.php\?cid=4\&lid=2
wget -O www.tgz https://www.c-labs-wt.com/modules/wfdownloads/visit.php\?cid=4\&lid=3

In the RPI shell (take care of upper/lower case), type in the following commands:

  1. sudo tar zxvf www.tgz -C /var/www/
  2. tar zxvf rpi.tgz
  3. cd RPI
  4. sudo sh setup.sh
  5. cd

At this point you can clean the home directory, removing the RPI subdir, rpi.tgz and www.tgz, typing in:

  • rm -rf RPI
  • rm www.tgz
  • rm rpi.tgz
  • sync

Then, you can restart the RPI typing in “sudo reboot”.

Surfing the Surfer

Access to Surfer (and to the WINE network) requires a decent browser, running on your PC.

Regardless of the hardware platform in use, to verify the operation of the system YOU MUST know its IP address.

IP Address

The IP address can be obtained by typing the "ipconfig" command in system the shell.

There are several other ways to grab IP address. Since Linux is quite similar in any platform, you can refer here.


The installed WEB platform should be independent from the browser in use, but recent versions of FireFox and Chrome are preferred.

Any case, if you want to use Internet Explorer, IE10 or higher is required.


To test the web operation, open your browser and type the URL:


Change “aaa.bbb.ccc.ddd” with the IP address (see above).


If page looks like the one above, all is OK.

Retrieved from "https://www.c-labs-wt.com/modules/mediawiki/index.php?title=HardWaves_Surfer_Setup"

This page has been accessed 18,084 times.

This page was last modified 15:37, 3 November 2014. Content is available under C-Labs Home.