Documentation/Maemo PC Connectivity Tutorial/Installation

m (1 revision)
(reformat images, wikify slightly, add links)
 
(One intermediate revision not shown)
Line 1: Line 1:
-
 
-
= 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.
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).
+
Maemo PC Connectivity fully supports the Maemo [[Open development/Maemo roadmap/Fremantle|Fremantle]] platform and devices (such as [[Nokia N900|N900]]) and the Maemo [[Open development/Maemo roadmap/Diablo|Diablo]] platform and devices (such as [[Nokia N800|N800]], [[Nokia N810|N810]] and [[Nokia N810WME|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.
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'''
; '''Cygwin'''
-
: is a Linux-like environment for Windows. With Cygwin <ref name=r1>Cygwin Project. http://cygwin.org/</ref> 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).
+
: is a Linux-like environment for Windows. With Cygwin <ref name="r1">Cygwin Project. http://cygwin.org/</ref> 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'''
; '''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 <ref name=r2>MacPorts Project. http://www.macports.org/</ref> 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.
+
: 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 <ref name="r2">MacPorts Project. http://www.macports.org/</ref> 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 <span><font face="monospace">maemo-pc-connectivity</font></span> on the maemo.org extras repository, which installs the necessary components on the Maemo device, and separate operating-system-specific <span><font face="monospace">host-pc-connectivity</font></span> installation packages on maemo.org Garage, which install the components needed on the host PC.
+
Maemo PC Connectivity provides an easy-to-install meta package <code>maemo-pc-connectivity</code> on the maemo.org [[extras|extras repository]], which installs the necessary components on the Maemo device, and separate operating-system-specific <code>host-pc-connectivity</code> installation packages on maemo.org Garage, which install the components needed on the host PC.
-
= Installation To Maemo Device =
+
== 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).
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 ==
+
=== One-Click-Install ===
-
The easiest way to install <span><font face="monospace">maemo-pc-connectivity</font></span> to the Maemo device is to use the one-click-install file.
+
The easiest way to install <code>maemo-pc-connectivity</code> to the Maemo device is to use the one-click-install file.
-
To do this on Diablo, point the browser to this [http://pc-connectivity.garage.maemo.org/maemo-pc-connectivity-diablo.install address]. When the download dialog appears, choose the '''Open''' option. Now the Application Manager should open and install <span><font face="monospace">maemo-pc-connectivity</font></span> and all its dependencies.
+
To do this on Diablo, point the browser to this [http://pc-connectivity.garage.maemo.org/maemo-pc-connectivity-diablo.install address]. When the download dialog appears, choose the '''Open''' option. Now the Application Manager should open and install <code>maemo-pc-connectivity</code> and all its dependencies.
If you use Fremantle, you should use this [http://pc-connectivity.garage.maemo.org/maemo-pc-connectivity-fremantle.install address] for one-click-installation with a Maemo device.
If you use Fremantle, you should use this [http://pc-connectivity.garage.maemo.org/maemo-pc-connectivity-fremantle.install address] for one-click-installation with a Maemo device.
-
== Installing with Application Manager ==
+
=== 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 [[#fig:pc_connectivity_mpc_maemo_repository|2.3]]) and fill in the following fields:
+
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 [[#figure-pc_connectivity_mpc_maemo_repository|2.3]]) and fill in the following fields:
* '''Catalogue Name:''' Maemo extras-devel
* '''Catalogue Name:''' Maemo extras-devel
Line 36: Line 33:
* '''Components:''' free non-free
* '''Components:''' free non-free
-
If you use Diablo, replace the value of the '''Distribution''' field from <span><font face="monospace">fremantle</font></span> to <span><font face="monospace">diablo</font></span> and use Maemo <span><font face="monospace">extras</font></span> repository instead of <span><font face="monospace">extras-devel</font></span>.
+
If you use Diablo, replace the value of the '''Distribution''' field from <code>fremantle</code> to <code>diablo</code>.
 +
<div id="figure-pc_connectivity_mpc_maemo_repository">
 +
[[Image:mpc_maemo_repository.png|frame|center|alt=Screenshot of New catalogue dialog|Figure 2.1: New catalogue]]
 +
</div>
-
 
+
Next, install the [http://maemo.org/packages/view/maemo-pc-connectivity/ maemo-pc-connectivity package]. This package installs all the Maemo PC Connectivity components.
-
{| summary="New catalogue"
+
-
|+ align="BOTTOM" |'''Figure 2.1:''' New catalogue
+
-
|-
+
-
|
+
-
[[Image:mpc_maemo_repository.png|Image mpc_maemo_repository]]
+
-
|}
+
-
 
+
-
 
+
-
 
+
-
Next, install the <span><font face="monospace">maemo-pc-connectivity</font></span> package. This package installs all the Maemo PC Connectivity components.
+
== Installing VNC for a Diablo Device ==
== 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 <span><font face="monospace">hildon-desktop</font></span> package.
+
To get X11VNC working properly on a Diablo device, you must install a modified version of the Diablo platform <code>hildon-desktop</code> package.
-
{|
+
{{ambox|text=On Fremantle, VNC is already installed by <code>maemo-pc-connectivity</code> package.}}
-
|-
+
-
| [[Image:dialog-information.png]]
+
-
| '''Note:'''  On Fremantle, the VNC is already installed by <span><font face="monospace">maemo-pc-connectivity</font></span> package.
+
-
|}
+
-
To install X11VNC to a Maemo Diablo device and update the modified <span><font face="monospace">hildon-desktop</font></span> package, follow these steps:
+
To install X11VNC to a Maemo Diablo device and update the modified <code>hildon-desktop</code> package, follow these steps:
-
Add the line below to the <span><font face="monospace">/etc/apt/sources.list</font></span> file on your Maemo device:
+
Add the line below to the <code>/etc/apt/sources.list</code> file on your Maemo device:
  deb http://pc-connectivity.garage.maemo.org/repository diablo free
  deb http://pc-connectivity.garage.maemo.org/repository diablo free
Line 73: Line 59:
  $ apt-get install hildon-desktop
  $ apt-get install hildon-desktop
-
= Installation To Host PC =
+
== 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.
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 ==
+
=== Linux - Ubuntu ===
Ready-made installation packages currently available are for Ubuntu Intrepid systems.
Ready-made installation packages currently available are for Ubuntu Intrepid systems.
Line 83: Line 69:
You must follow these steps to install Maemo PC Connectivity on Ubuntu Linux:
You must follow these steps to install Maemo PC Connectivity on Ubuntu Linux:
-
Open Synaptic application, figure [[#fig:pc_connectivity_mpc_linux_synaptic_open|2.2]].
+
Open Synaptic application, figure [[#figure-pc_connectivity_mpc_linux_synaptic_open|2.2]].
 +
<div id="figure-pc_connectivity_mpc_linux_synaptic_open">
 +
[[Image:mpc_linux_synaptic_open.png|frame|center|alt=Screenshot of Synaptic|'''Figure 2.2:''' Start Synaptic]]
 +
</div>
 +
Under the '''Settings''' menu, select the '''Repository''' option, figure [[#figure-pc_connectivity_mpc_maemo_repository|2.3]].
-
{| summary="Start Synaptic"
+
<div id="figure-pc_connectivity_mpc_maemo_repository">
-
|+ align="BOTTOM" |'''Figure 2.2:''' Start Synaptic
+
[[Image:mpc_linux_synaptic_repository.png|frame|center|alt=Screenshot of repositories list|Figure 2.3: Repositories]]
-
|-
+
</div>
-
|
+
-
[[Image:mpc_linux_synaptic_open.png|Image mpc_linux_synaptic_open]]
+
-
|}
+
-
 
+
Click on the '''Add''' button to add a new repository, figure [[#figure-pc_connectivity_mpc_linux_synaptic_repository_add|2.4]]. You must type in the following repository information:
-
 
+
-
Under the '''Settings''' menu, select the '''Repository''' option, figure [[#fig:pc_connectivity_mpc_maemo_repository|2.3]].
+
-
 
+
-
 
+
-
 
+
-
{| summary="Repositories"
+
-
|+ align="BOTTOM" |'''Figure 2.3:''' Repositories
+
-
|-
+
-
|
+
-
[[Image:mpc_linux_synaptic_repository.png|Image mpc_linux_synaptic_repository]]
+
-
|}
+
-
 
+
-
 
+
-
 
+
-
Click on the '''Add''' button to add a new repository, figure [[#fig:pc_connectivity_mpc_linux_synaptic_repository_add|2.4]]. You must type in the following repository information:
+
  deb http://pc-connectivity.garage.maemo.org/repository intrepid main
  deb http://pc-connectivity.garage.maemo.org/repository intrepid main
 +
<div id="figure-pc_connectivity_mpc_linux_synaptic_repository_add">
 +
[[Image:mpc_linux_synaptic_repository_add.png|frame|center|alt=Screenshot of third-party software window in Synaptic|Figure 2.4: Third-Party Software]]
 +
</div>
 +
Click on the '''Close''' button. To get all information about the packages available on the added repository, click on the '''Reload''' button, figure [[#figure-pc_connectivity_mpc_linux_synaptic_reload|2.5]].
-
{| summary="Third-Party Software"
+
<div id="figure-pc_connectivity_mpc_linux_synaptic_reload">
-
|+ align="BOTTOM" |'''Figure 2.4:''' Third-Party Software
+
[[Image:mpc_linux_synaptic_reload.png|frame|center|alt=Screenshot of Synaptic reload dialog|Figure 2.5: Reload]]
-
|-
+
</div>
-
|
+
-
[[Image:mpc_linux_synaptic_repository_add.png|Image mpc_linux_synaptic_repository_add]]
+
-
|}
+
 +
in the '''Quick search''' field, type <code>host-pc-connectivity</code>. The <code>host-pc-connectivity</code> package is displayed on the list, figure [[#figure-pc_connectivity_mpc_linux_synaptic_select_package|2.6]].
 +
<div id="figure-pc_connectivity_mpc_linux_synaptic_select_package">
 +
[[Image:mpc_linux_synaptic_select_package.png|frame|center|alt=Screenshot of Synaptic while marking for installation|Figure 2.6: Mark for Installation]]
 +
</div>
-
Click on the '''Close''' button. To get all information about the packages available on the added repository, click on the '''Reload''' button, figure [[#fig:pc_connectivity_mpc_linux_synaptic_reload|2.5]].
+
Right-click on the <code>host-pc-connectivity</code> package. Select the '''Mark for installation''' option and click on the '''Apply''' button, figure [[#figure-pc_connectivity_mpc_linux_synaptic_install_package|2.7]].
-
 
+
-
 
+
-
 
+
-
{| summary="Reload"
+
-
|+ align="BOTTOM" |'''Figure 2.5:''' Reload
+
-
|-
+
-
|
+
-
[[Image:mpc_linux_synaptic_reload.png|Image mpc_linux_synaptic_reload]]
+
-
|}
+
-
 
+
-
 
+
-
 
+
-
in the '''Quick search''' field, type <span><font face="monospace">host-pc-connectivity</font></span>. The <span><font face="monospace">host-pc-connectivity</font></span> package is displayed on the list, figure [[#fig:pc_connectivity_mpc_linux_synaptic_select_package|2.6]].
+
-
 
+
-
 
+
-
 
+
-
{| summary="Mark for Installation"
+
-
|+ align="BOTTOM" |'''Figure 2.6:''' Mark for Installation
+
-
|-
+
-
|
+
-
[[Image:mpc_linux_synaptic_select_package.png|Image mpc_linux_synaptic_select_package]]
+
-
|}
+
-
 
+
-
 
+
-
 
+
-
Right-click on the <span><font face="monospace">host-pc-connectivity</font></span> package. Select the '''Mark for installation''' option and click on the '''Apply''' button, figure [[#fig:pc_connectivity_mpc_linux_synaptic_install_package|2.7]].
+
-
 
+
-
 
+
-
 
+
-
{| summary="Apply"
+
-
|+ align="BOTTOM" |'''Figure 2.7:''' Apply
+
-
|-
+
-
|
+
-
[[Image:mpc_linux_synaptic_install_package.png|Image mpc_linux_synaptic_install_package]]
+
-
|}
+
-
 
+
 +
<div id="figure-pc_connectivity_mpc_linux_synaptic_install_package">
 +
[[Image:mpc_linux_synaptic_install_package.png|frame|center|alt=Screenshot of Synptic installing packages|Figure 2.7: Apply]]
 +
</div>
Follow the instructions on the screen. After that, Host PC Connectivity is installed on your host PC.
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 <span><font face="monospace">/etc/apt/sources.list</font></span> file:
+
If you prefer, you can install Host PC Connectivity manually. First, you must add the following line to the <code>/etc/apt/sources.list</code> file:
  deb http://pc-connectivity.garage.maemo.org/repository intrepid main
  deb http://pc-connectivity.garage.maemo.org/repository intrepid main
Line 176: Line 120:
== Linux - Fedora ==
== Linux - Fedora ==
-
It is necessary to add the Host PC Connectivity repository to the host PC repository list in order to install the <span><font face="monospace">host-pc-connectivity</font></span> package. As Fedora does not have any graphical application for adding a new repository, all processes, repository additions and <span><font face="monospace">host-pc-connectivity</font></span> installations are described through the command line.
+
It is necessary to add the Host PC Connectivity repository to the host PC repository list in order to install the <code>host-pc-connectivity</code> package. As Fedora does not have any graphical application for adding a new repository, all processes, repository additions and <code>host-pc-connectivity</code> 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 <span><font face="monospace">/etc/yum.conf</font></span> file:
+
To enable the Host PC Connectivity repository on Fedora Linux 11, you must add the following lines at the end of the <code>/etc/yum.conf</code> file:
-
[pc-connectivity]
+
<pre>
-
name=PC-Connectivity Fedora $releasever - $basearch
+
[pc-connectivity]
-
failovermethod=priority
+
name=PC-Connectivity Fedora $releasever - $basearch
-
baseurl=http://pc-connectivity.garage.maemo.org/yum/base/$releasever/$basearch
+
failovermethod=priority
-
enabled=1
+
baseurl=http://pc-connectivity.garage.maemo.org/yum/base/$releasever/$basearch
-
gpgcheck=0
+
enabled=1
 +
gpgcheck=0
 +
</pre>
-
Then, to install the <span><font face="monospace">host-pc-connectivity</font></span> package, you must only execute:
+
Then, to install the <code>host-pc-connectivity</code> package, you must only execute:
  $ yum check-update
  $ yum check-update
  $ sudo yum install host-pc-connectivity
  $ sudo yum install host-pc-connectivity
-
== Microsoft Windows ==
+
=== Microsoft Windows ===
-
To install <span><font face="monospace">PC-Connectivity.exe</font></span> 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 [http://www.cygwin.com/ 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.
+
To install <code>PC-Connectivity.exe</code> 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 [http://www.cygwin.com/ 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.
-
{|
+
{{ambox|text=Current Cygwin 1.7 releases have problems with X11 in the Maemo environment because they do not yet implement all needed X11 extensions (such as composite). If you plan to use a Windows environment with Maemo ESbox Eclipse IDE it is recommended to use Windows XP SP3 with Cygwin 1.5 because that combination has been tested to work. Cygwin 1.5 can be installed from this [http://www.cygwin.com/setup-legacy.exe Cygwin legacy product] link.}}
-
|-
+
-
| [[Image:dialog-information.png]]
+
-
| '''Note:'''  Current Cygwin 1.7 releases have problems with X11 in the Maemo environment because they do not yet implement all needed X11 extensions (such as composite). If you plan to use a Windows environment with Maemo ESbox Eclipse IDE it is recommended to use Windows XP SP3 with Cygwin 1.5 because that combination has been tested to work. Cygwin 1.5 can be installed from this [http://www.cygwin.com/setup-legacy.exe Cygwin legacy product] link.
+
-
|}
+
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:
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:
Line 211: Line 153:
* X11/xdpyinfo
* X11/xdpyinfo
-
After Cygwin has been succesfully installed, download the latest <span><font face="monospace">PC-Connectivity.exe</font></span> installer from [https://garage.maemo.org/frs/?group_id=801 PC Connectivty Garage] project. Run the installation and follow the on-screen instructions given during installation.
+
After Cygwin has been succesfully installed, download the latest <code>PC-Connectivity.exe</code> installer from [https://garage.maemo.org/frs/?group_id=801 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.
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 ==
+
=== 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:
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 [[#fig:pc_connectivity_mpc_mac_isntalling_bt|2.8]].
+
Open '''System Preferences''' under the '''Hardware''' category, and select the '''Bluetooth''' option, figure [[#figure-pc_connectivity_mpc_mac_isntalling_bt|2.8]].
 +
<div id="figure-pc_connectivity_mpc_mac_isntalling_bt">
 +
[[Image:mpc_mac_installing_bt.png|frame|center|alt=Screenshot of Bluetooth preferences|Figure 2.8: Bluetooth]]
 +
</div>
 +
Make sure Bluetooth is '''On''' and '''Discoverable''', figure [[#figure-pc_connectivity_mpc_mac_installing_bt_discoverable|2.9]]. Then, click on the '''Advanced''' button.
-
{| summary="Bluetooth"
+
<div id="figure-pc_connectivity_mpc_mac_installing_bt_discoverable">
-
|+ align="BOTTOM" |'''Figure 2.8:''' Bluetooth
+
[[Image:mpc_mac_installing_bt_discoverable.png|frame|center|alt=Screenshot of advanced Bluetooth preferences|Figure 2.9: Advanced]]
-
|-
+
</div>
-
|
+
-
[[Image:mpc_mac_installing_bt.png|Image mpc_mac_installing_bt]]
+
-
|}
+
-
 
+
-
 
+
-
 
+
-
Make sure Bluetooth is '''On''' and '''Discoverable''', figure [[#fig:pc_connectivity_mpc_mac_installing_bt_discoverable|2.9]]. Then, click on the '''Advanced''' button.
+
-
 
+
-
 
+
-
 
+
-
{| summary="Advanced"
+
-
|+ align="BOTTOM" |'''Figure 2.9:''' Advanced
+
-
|-
+
-
|
+
-
[[Image:mpc_mac_installing_bt_discoverable.png|Image mpc_mac_installing_bt_discoverable]]
+
-
|}
+
-
 
+
-
 
+
-
 
+
-
Select the '''Share my Internet connection with other Bluetooth devices''' option, figure [[#fig:pc_connectivity_mpc_mac_installing_bt_internet|2.10]].
+
-
 
+
-
 
+
-
 
+
-
{| summary="Share my Internet connection with other Bluetooth devices"
+
-
|+ align="BOTTOM" |'''Figure 2.10:''' Share my Internet connection with other Bluetooth devices
+
-
|-
+
-
|
+
-
[[Image:mpc_mac_installing_bt_internet.png|Image mpc_mac_installing_bt_internet]]
+
-
|}
+
 +
Select the '''Share my Internet connection with other Bluetooth devices''' option, figure [[#figure-pc_connectivity_mpc_mac_installing_bt_internet|2.10]].
 +
<div id="figure-pc_connectivity_mpc_mac_installing_bt_internet">
 +
[[Image:mpc_mac_installing_bt_internet.png|frame|center|alt=Screenshot of Internet connection sharing with Bluetooth devices|Figure 2.10: Share my Internet connection with other Bluetooth devices]]
 +
</div>
Click the '''OK''' button to finalise the configuration.
Click the '''OK''' button to finalise the configuration.
-
After Bluetooth has been succesfully configured, download the latest <span><font face="monospace">PC-Connectivity.dmg</font></span> installer file from [https://garage.maemo.org/frs/?group_id=801 PC Connectivity Garage] project. Open the installer and follow the on-screen installation instructions.
+
After Bluetooth has been succesfully configured, download the latest <code>PC-Connectivity.dmg</code> installer file from [https://garage.maemo.org/frs/?group_id=801 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 [http://www.macports.org MacPorts] project site.
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 [http://www.macports.org MacPorts] project site.
 +
== References ==
 +
<references />
-
== References ==
+
[[Category:Documentation]]
-
<references />
+

Latest revision as of 13:56, 4 November 2010

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 [1] 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 [2] 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.

Contents

[edit] 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).

[edit] 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.

[edit] 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:

If you use Diablo, replace the value of the Distribution field from fremantle to diablo.

File:Mpc maemo repository.png
Figure 2.1: New catalogue

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

[edit] 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.

Image:Ambox_notice.png
On Fremantle, VNC is already installed by maemo-pc-connectivity 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

[edit] 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.

[edit] 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.

File:Mpc linux synaptic open.png
Figure 2.2: Start Synaptic

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
File:Mpc linux synaptic repository add.png
Figure 2.4: Third-Party Software

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.

File:Mpc linux synaptic select package.png
Figure 2.6: Mark for Installation

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

[edit] 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

[edit] 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.

Image:Ambox_notice.png
Current Cygwin 1.7 releases have problems with X11 in the Maemo environment because they do not yet implement all needed X11 extensions (such as composite). If you plan to use a Windows environment with Maemo ESbox Eclipse IDE it is recommended to use Windows XP SP3 with Cygwin 1.5 because that combination has been tested to work. Cygwin 1.5 can be installed from this Cygwin legacy product link.

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.

[edit] 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.

File:Mpc mac installing bt.png
Figure 2.8: Bluetooth

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.

File:Mpc mac installing bt internet.png
Figure 2.10: Share my Internet connection with other Bluetooth devices

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.

[edit] References

  1. Cygwin Project. http://cygwin.org/
  2. MacPorts Project. http://www.macports.org/