Connecting with VNC

From BUGwiki

Jump to: navigation, search



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.


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:  Bcast:  Mask:
         inet6 addr: fe80::219:d1ff:fe55:97d8/64 Scope:Link
         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)

Software Setup


Windows: RealVNC viewer OSX: Chicken of the VNC


Linux: Vinagre

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@

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.

Connecting with VNC

Start the VNC client on your workstation and create a new connection to the BUG IP address. If successful, a new window will open showing the BUG desktop as shown below (on Ubuntu using vinagre vnc client):


Through VNC, you can control the BUG's keyboard and mouse inputs with your own. With the larger screen on your workstation, you can proceed to configure the Network Manager or use other GUI programs installed on BUG.

See Also

Personal tools