Connecting with VNC
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.
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:~#
- 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.
- 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.
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.