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.
- Connect a HDMI/DVI monitor to the RPI PCB
- Plug a USB Mouse in a free RPI USB port
- Plug a USB Keyboard in a free RPI USB port
- Plug Ethernet cable
- Fire power to RPI
Operating System setup
RPI is an ARM/Linux device. Here more information in OS installation process.
- Select “Raspbian” OS
- Click on “Install”
- Wait... (and wait)
- Login into RPI (user:pi password:raspberry)
Update and upgrade
- execute “sudo apt-get update”
- execute “sudo apt-get upgrade”
- wait (coffee, walkabout, a trip to New Zealand...)
Installation of required packages
- execute “sudo apt-get install mysql-server mysql-client” (set “root” as DB Manager password)
- execute “sudo apt-get install apache2 -y”
- (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:
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:
In the RPI shell (take care of upper/lower case), type in the following commands:
- sudo tar zxvf www.tgz -C /var/www/
- tar zxvf rpi.tgz
- cd RPI
- sudo sh setup.sh
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
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.
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.