From BUGwiki

Jump to: navigation, search

Overview

This page provides a detailed guide to help you connect to your BUG via SSH and with a VNC client. Some of the BUG programs you need to use to configure BUG run as GUI apps on BUG. Sometimes, these GUI apps are hard to use with the BUG Y.T. LCD because of its limited screen size.

Fortunately, BUGbase Y.T. has a built-in VNC server courtesy of x11vnc. The trick is to connect to your BUG with a VNC client, so you can take advantage of the larger screen area of your workstation.

Preqrequisites

Hardware Setup

At a minimum, for initial setup, you will need a BUGbase Y.T., a Stinger, and your development workstation running either Linux, MacOS, or Windows.

You also need a local area network and an extra ethernet cable for the BUGbase. To start, connect your BUG device to your local network through the Ethernet port on your Stinger.

Plug your BUGbase into a power source or make sure the device is fully/sufficiently charged. Turn on the BUGbase using the power switch/button. Now that the BUGbase is on and connected to the network, it will try to obtain an IP address via DHCP.

Using the serial port on the Stinger (and your favorite serial terminal program) Get the IP address assigned to the BUG:

bug20 login:  root
Last login: Fri Sep 24 21:18:29 +0100 2010 on /dev/ttyS2.
root@bug20:~# ifconfig eth0
root@jconnolly-bug20:~# ifconfig eth0
eth0      Link encap:Ethernet  HWaddr 00:19:D1:55:97:D8  
         inet addr:192.168.0.190  Bcast:192.168.255.255  Mask:255.255.0.0
         inet6 addr: fe80::219:d1ff:fe55:97d8/64 Scope:Link
         UP BROADCAST RUNNING MULTICAST  MTU:1492  Metric:1
         RX packets:178213 errors:0 dropped:0 overruns:0 frame:0
         TX packets:5086 errors:0 dropped:0 overruns:0 carrier:0
         collisions:0 txqueuelen:1000 
         RX bytes:24583079 (23.4 MiB)  TX bytes:681751 (665.7 KiB)
root@bug20:~#

Software Setup

SSH client: Windows users will need an SSH client like Putty. The remainder of this document will provide instructions and examples for a Unix audience.

VNC client: A number of free VNC client programs are available for Linux, Mac OS X, and Windows.

Unsupported

Windows: RealVNC viewer OSX: Chicken of the VNC

Supported

Linux: Vinagre

VNC Server: x11vnc This is already installed in BUG, but does not automatically run on startup.

Connecting to BUGbase

Connect via SSH

First, we need to connect to BUG via SSH in order to run x11vnc. Using your SSH client and the IP address obtained previously, connect to the BUGbase by entering the ip address and login credentials.

ssh root@192.168.0.190

When asked for the password, you can enter any text (or none at all) and press Enter. This step will also verify that you have the correct IP adddress and that your BUG is accessible over the network.

Starting Up the x11vnc Server

After logging in, we need to start up the x11vnc server.

# Verify x11vnc 
which x11vnc
# Run it
x11vnc &

Also, for improved VNC performance, you can try the ncache option:

x11vnc -ncache 10

At this point, you can leave your SSH session open.