Documentation/Maemo PC Connectivity Tutorial/Installation

= Installation =

The Maemo PC Connectivity product consists of two parts, Maemo PC Connectivity that installs the necessary services and configuration tools to the Maemo device, and the operating-system-specific Host PC Connectivity that installs the necessary clients to the host PC to be used to access Maemo PC Connectivity services from the Maemo device. The Maemo PC Connectivity product includes many standard services available for Linux PCs by default. Most of the services require some user expertise to be able to install and configure them properly. Maemo PC Connectivity aims to provide easy installation and configuration of these services for both the Maemo device and the host PC, and also support for other than just Linux host PC operating systems.

Maemo PC Connectivity fully supports the Maemo Fremantle platform and devices (such as N900) and the Maemo Diablo platform and devices (such as N800, N810 and N810 WiMAX).

The host PC operating systems supported are Linuxes, Mac OS X Leopard and Snow Leopard, Windows XP SP3, Windows Vista SP2 and Windows 7. On Windows and Mac OS X PCs it is required to install special Linux porting framework before Host PC Connectivity installation in order to fully utilise Maemo PC Connectivity functionality.


 * Cygwin
 * is a Linux-like environment for Windows. With Cygwin  installed, users have access to many standard UNIX utilities. They can be used from one of the provided shells (such as bash) or from the Windows Command Prompt. Additionally, programmers may write Win32 console or GUI applications that make use of the standard Microsoft Win32 API and/or the Cygwin API. As a result, it is possible to easily port many significant UNIX programs without the need for extensive changes to the source code. This includes configuring and building most of the available GNU software (including the development tools included with the Cygwin distribution).


 * MacPorts
 * is an easy-to-use system for compiling, installing, and upgrading either command-line, X11 or Aqua based open-source software on the Mac OS X operating system. MacPorts  project provides the command-line driven Linux-like software packages, and through them easy access to thousands of ports that simplify the task of compiling and installing open-source software on your Mac.

Maemo PC Connectivity provides an easy-to-install meta package maemo-pc-connectivity on the maemo.org extras repository, which installs the necessary components on the Maemo device, and separate operating-system-specific host-pc-connectivity installation packages on maemo.org Garage, which install the components needed on the host PC.

= Installation To Maemo Device =

Maemo PC Connectivity fully supports the Maemo Fremantle platform and devices (such as N900) and the Maemo Diablo platform and devices (like N800, N810 and N810 WiMAX).

One-Click-Install
The easiest way to install maemo-pc-connectivity to the Maemo device is to use the one-click-install file.

To do this on Diablo, point the browser to this address. When the download dialog appears, choose the Open option. Now the Application Manager should open and install maemo-pc-connectivity and all its dependencies.

If you use Fremantle, you should use this address for one-click-installation with a Maemo device.

Installing with Application Manager
To install Maemo PC Connectivity on a Fremantle-based Maemo device, the Maemo extras-devel repository must be added. To do this, open the Application Manager, then Repository catalogs (see figure 2.3) and fill in the following fields:


 * Catalogue Name: Maemo extras-devel
 * Web Address: http://repository.maemo.org/extras-devel
 * Distribution: fremantle
 * Components: free non-free

If you use Diablo, replace the value of the Distribution field from fremantle to diablo and use Maemo extras repository instead of extras-devel.

Next, install the maemo-pc-connectivity package. This package installs all the Maemo PC Connectivity components.

Installing VNC for a Diablo Device
To get X11VNC working properly on a Diablo device, you must install a modified version of the Diablo platform hildon-desktop package.

To install X11VNC to a Maemo Diablo device and update the modified hildon-desktop package, follow these steps:

Add the line below to the /etc/apt/sources.list file on your Maemo device:

deb http://pc-connectivity.garage.maemo.org/repository diablo free

Execute the following commands:

$ apt-get update $ apt-get install x11vnc $ apt-get install hildon-desktop

= Installation To Host PC =

The host PC operating systems supported are Linuxes, Mac OS X Leopard and Snow Leopard, Windows XP, Windows Vista and Windows 7. On Windows and Mac OS X PCs it is required to install Linux as a porting framework before Host PC Connectivity installation in order to fully utilise the Maemo PC Connectivity functionality.

Linux - Ubuntu
Ready-made installation packages currently available are for Ubuntu Intrepid systems.

You must follow these steps to install Maemo PC Connectivity on Ubuntu Linux:

Open Synaptic application, figure 2.2.

Under the Settings menu, select the Repository option, figure 2.3.

Click on the Add button to add a new repository, figure 2.4. You must type in the following repository information:

deb http://pc-connectivity.garage.maemo.org/repository intrepid main

Click on the Close button. To get all information about the packages available on the added repository, click on the Reload button, figure 2.5.

in the Quick search field, type host-pc-connectivity. The host-pc-connectivity package is displayed on the list, figure 2.6.

Right-click on the host-pc-connectivity package. Select the Mark for installation option and click on the Apply button, figure 2.7.

Follow the instructions on the screen. After that, Host PC Connectivity is installed on your host PC.

If you prefer, you can install Host PC Connectivity manually. First, you must add the following line to the /etc/apt/sources.list file:

deb http://pc-connectivity.garage.maemo.org/repository intrepid main

Then you should run:

$ apt-get update $ apt-get install host-pc-connectivity

Linux - Fedora
It is necessary to add the Host PC Connectivity repository to the host PC repository list in order to install the host-pc-connectivity package. As Fedora does not have any graphical application for adding a new repository, all processes, repository additions and host-pc-connectivity installations are described through the command line.

To enable the Host PC Connectivity repository on Fedora Linux 11, you must add the following lines at the end of the /etc/yum.conf file:

[pc-connectivity] name=PC-Connectivity Fedora $releasever - $basearch failovermethod=priority baseurl=http://pc-connectivity.garage.maemo.org/yum/base/$releasever/$basearch enabled=1 gpgcheck=0

Then, to install the host-pc-connectivity package, you must only execute:

$ yum check-update $ sudo yum install host-pc-connectivity

Microsoft Windows
To install PC-Connectivity.exe on a Windows XP, Windows Vista or Windows 7 system, you must install Cygwin before the Host PC Connectivity installation. You can download the Cygwin installation package from here. If you are using a Windows 7 or Vista version, install Cygwin 1.7 or later. For Windows XP, install Cygwin version 1.5 if you run into any problems with Cygwin 1.7.

Remember to choose a installation path on your system without spaces during installation. Besides the default packages of Cygwin, the Maemo environment also requires the following optional packages to be installed:


 * Admin/cygrunsrv
 * Net/nfs-server
 * Net/openssh
 * Net/rsync
 * X11/xinit
 * X11/xdpyinfo

After Cygwin has been succesfully installed, download the latest PC-Connectivity.exe installer from PC Connectivty Garage project. Run the installation and follow the on-screen instructions given during installation.

The installer configures the SSHD. Install it as a service and start it. On Windows 7 and Vista, the Cygwin configuration script creates a new user with administrator privileges and with a random password for the SSHD service. This new user is used to run the SSHD service independently on a user who has been logged in to the Windows PC.

Mac OS X
To install Host PC Connectivity on Mac OS X Leopard or Snow Leopard, you must first switch on the Bluetooth network to be able to configure it for Maemo usage. To do this, follow these steps:

Open System Preferences under the Hardware category, and select the Bluetooth option, figure 2.8.

Make sure Bluetooth is On and Discoverable, figure 2.9. Then, click on the Advanced button.

Select the Share my Internet connection with other Bluetooth devices option, figure 2.10.

Click the OK button to finalise the configuration.

After Bluetooth has been succesfully configured, download the latest PC-Connectivity.dmg installer file from PC Connectivity Garage project. Open the installer and follow the on-screen installation instructions.

To have an environment similar to Cygwin on Windows, you can install MacPorts on Mac OS. The MacPorts project is an open-source community initiative to design an easy-to-use system for compiling, installing, and upgrading either command-line, X11 or Aqua-based open-source software on the Mac OS X operating system. You can find the MacPorts documentation and installation packages from the MacPorts project site.