[Esbox-commits] r2008 - www/2nd_edition
eswartz at garage.maemo.org
eswartz at garage.maemo.org
Wed Aug 26 18:03:35 EEST 2009
Author: eswartz
Date: 2009-08-26 18:03:34 +0300 (Wed, 26 Aug 2009)
New Revision: 2008
Modified:
www/2nd_edition/installation.html
www/2nd_edition/installation_prereqs.html
www/2nd_edition/installation_product.html
Log:
Rewrite installation page to follow usability comments
Modified: www/2nd_edition/installation.html
===================================================================
--- www/2nd_edition/installation.html 2009-08-26 14:58:11 UTC (rev 2007)
+++ www/2nd_edition/installation.html 2009-08-26 15:03:34 UTC (rev 2008)
@@ -1,29 +1,30 @@
-<!DOCTYPE html PUBLIC "-//W3C//DTD XHTML 1.0 Transitional//EN" "http://www.w3.org/TR/xhtml1/DTD/xhtml1-transitional.dtd">
-<html xmlns="http://www.w3.org/1999/xhtml">
-<head>
- <meta http-equiv="content-type" content="text/html; charset=utf-8" />
- <title>Installation</title>
- <meta name="description" content="" />
- <meta name="keywords" content="esbox installation" />
- <link href="css/main.css" rel="stylesheet" type="text/css" />
- <link rel="stylesheet" href="css/lightbox.css" type="text/css" media="screen" />
- <link rel="shortcut icon" href="images/favicon.ico" />
- <script type="text/javascript" src="js/prototype.js"></script>
- <script type="text/javascript" src="js/scriptaculous.js?load=effects"></script>
- <script type="text/javascript" src="js/lightbox.js"></script>
-</head>
-<body>
- <script type="text/javascript">
+<!DOCTYPE html PUBLIC "-//W3C//DTD XHTML 1.0 Transitional//EN" "http://www.w3.org/TR/xhtml1/DTD/xhtml1-transitional.dtd">
+<html xmlns="http://www.w3.org/1999/xhtml"><head>
+
+
+ <meta http-equiv="content-type" content="text/html; charset=utf-8"><title>Installation</title>
+ <meta name="description" content="">
+ <meta name="keywords" content="esbox installation">
+ <link href="css/main.css" rel="stylesheet" type="text/css">
+ <link rel="stylesheet" href="css/lightbox.css" type="text/css" media="screen">
+ <link rel="shortcut icon" href="images/favicon.ico">
+ <script type="text/javascript" src="js/prototype.js"></script>
+ <script type="text/javascript" src="js/scriptaculous.js?load=effects"></script>
+ <script type="text/javascript" src="js/lightbox.js"></script></head><body>
+
+<script type="text/javascript">
var gaJsHost = (("https:" == document.location.protocol) ? "https://ssl." : "http://www.");
document.write(unescape("%3Cscript src='" + gaJsHost + "google-analytics.com/ga.js' type='text/javascript'%3E%3C/script%3E"));
</script>
- <script type="text/javascript">
+
+<script type="text/javascript">
var pageTracker = _gat._getTracker("UA-2565700-2");
pageTracker._initData();
pageTracker._trackPageview();
</script>
- <div id="header">
- <span id="img"><a href="index.html"><img src="images/marca.jpg" alt="logo" /></a></span>
+
+<div id="header">
+ <span id="img"><a href="index.html"><img src="images/marca.jpg" alt="logo"></a></span>
<ul id="menu">
<li><a href="index.html">home</a></li>
<li><a href="features.html">features</a></li>
@@ -34,7 +35,7 @@
</ul>
</div>
- <div id="banner">
+<div id="banner">
<div class="wrap">
<div id="box">
</div>
@@ -46,289 +47,585 @@
<div id="container">
<div id="content">
-<div style="float: right">
-ESbox is part of <a href="http://maemo.org/development/documentation/ide_integration/" target="_blank">maemo IDE Integration</a>
+<div style="float: right;">
+ESbox is part of <a href="http://maemo.org/development/documentation/ide_integration/" target="_blank">Maemo IDE Integration</a>
</div>
-<h2 id="requirements">PREREQUISITES</h2>
+<h2 id="installation">INSTALLATION</h2>
+<div style="font-size: 14px;">
+<ul>
+ <li><a href="#overview">Overview</a></li>
+ <li><a href="#supported">Supported environments</a></li>
+<li><a href="#getting">Installing ESbox IDE<br>
+</a></li>
+
+<li><a href="#devenv">Development Environment</a></li>
+<li><a href="#esbox">PC Connectivity</a></li>
+</ul>
+</div>
<p>
-ESbox may be installed in a Linux/i386 environment that supports Maemo SDKs <b>or</b> in a Linux, Windows, or Mac OS X host
-that supports VMware, VirtualBox, or QEMU.
</p>
-<div style="font-size: 14px">
-<ul>
- <li><a href="#all">All Environments</a></li>
- <li><a href="#native">Native Maemo Environments</a></li>
- <li><a href="#vm">Non-native Maemo Environments</a></li>
- <li><a href="#tablet">Tablet Environment</a></li>
- <li><a href="#esbox">ESbox Installation</a></li>
-</ul>
+
+
+<p id="overview">
+</p>
+<div id="group">
+
+<h3 id="heading">Overview
+</h3>
+<p>
+ESbox is an <a href="http://www.eclipse.org/">Eclipse-based</a>IDE.
+It is based on Eclipse Ganymede (3.4.2) and provides C/C++ and Python
+support, source editing, project building, run/debug/profiling, and
+Debian package deployment. ESbox communicates transparently with
+Scratchbox and one or more Maemo SDKs, available separately, to let you
+develop Maemo applications. ESbox can also communicate with your
+Maemo devices using the various network clients and servers available
+with the PC Connectivity project.<br>
+</p>
+<p>With ESbox, Scratchbox, Maemo SDK(s), and PC Connectivity installed,
+you can run, debug, and profile locally under emulator running in an X
+server, and also deploy the application to a Maemo device (N800, N810)
+to run, debug, and profile on hardware.
+</p>
+
+
+<h3>ESbox IDE</h3>
+
+<p>ESbox may be installed completely from an archive or added to
+an existing Eclipse 3.4.2 installation from our update sites.
+</p>
+<p>
+ESbox may be installed in a variety of hosts. The "Supported Environments"
+sections describes these. The "Getting ESbox" section describes
+how to find and install ESbox.</p>
+
+<h3>Virtual machine
+
+</h3>
+
+<p>Only Linux/x86 hosts natively run Scratchbox and Maemo SDKs.
+In other hosts, you must run Scratchbox and the Maemo SDK inside a
+Linux/x86 virtual machine. ESbox supports using virtual machines
+in this manner.
+</p>
+<p>The "Supported Environments"
+sections describes the VM engines supported.
+</p>
+<p>In ESbox, you can install a server virtual image using <strong>File > New > Other > Maemo Installers > Maemo SDK Virtual Image</strong>.</p>
+
+
+<h3>Development Environment
+</h3>
+<p>The development environment consists of Scratchbox and one or more
+Maemo SDKs. These are essential to Maemo development environment
+and ESbox is useless without them. </p>
+<p>ESbox does not ship with Scratchbox or any Maemo SDK, but<span style="font-style: italic;"> </span>it includes wizards that allow you to install them. See <strong>File > New > Other > Maemo Installers > Scratchbox 1 </strong>and<strong> ... > Scratchbox 1 Targets</strong>. <br>
+</p>
+<p>If you want to install these yourself, see <a href="http://maemo.org/development/sdks/">the Maemo SDK site</a> for more information.<br>
+
+</p>
+
+<h3>PC Connectivity</h3>
+<p>In order to run, debug, profile, or install your
+application on hardware, the PC Connectivity project provides
+convenient installation packages allowing you to use ssh, sbrsh, NFS, rsync, avahi,
+etc. between your PC and your Maemo device. There is a host component (for the machine running Eclipse,
+and also for the virtual machine, if you have to use one) and a target
+component (for the device).
+</p>
+<p>The "Supported Environments"
+sections describes the Maemo releases and devices supported.
+</p>
+<p>Find the complete description and installation instructions on the
+ <a href="http://pc-connectivity.garage.maemo.org/" target="_blank">PC connectivity project web site</a>.
+</p>
+
</div>
+<p>
+</p>
+<p id="supported">
+</p>
-<p id="all"/>
<div id="group">
-<h3 id="heading">All Environments</h3>
+<h3 id="heading">Supported Environments
+</h3>
+
+<h3>Hosts supported</h3>
+
+<table style="border: 1px solid black ; border-padding: 2px; border-style: solid; border-collapse: collapse; text-align: left; width: 100%;" cellpadding="2" cellspacing="2">
+ <tbody>
+ <tr style="border: 1px solid black ;padding: 2px; background-color: #ee8; ">
+ <th style="vertical-align: top;">Host
+ </th>
+ <th style="vertical-align: top;">Virtual Machine Required
+ </th>
+ <th style="vertical-align: top;">Supported?
+ </th>
+ <th style="vertical-align: top;">Tested?
+ </th>
+ </tr>
+ <tr style="border: 1px solid black; padding: 2px; background-color: #cfc;">
+ <td style="vertical-align: top;">Ubuntu Linux/x86 Hardy, Intrepid, Jaunty, or newer
+ </td>
+ <td style="vertical-align: top;">No [3]
+ </td>
+ <td style="vertical-align: top;">Yes
+ </td>
+ <td style="vertical-align: top;">Yes
+ </td>
+ </tr>
+ <tr style="border: 1px solid black;padding: 2px; ">
+ <td style="vertical-align: top;">Other Linux/x86 distros
+ </td>
+ <td style="vertical-align: top;">No [3]
+ </td>
+ <td style="vertical-align: top;">Maybe [1]
+ </td>
+ <td style="vertical-align: top;">No
+ </td>
+ </tr>
+ <tr style="border: 1px solid black;padding: 2px; ">
+ <td style="vertical-align: top;">Other Linux
+ </td>
+ <td style="vertical-align: top;">Yes
+ </td>
+ <td style="vertical-align: top;">Maybe [2]
+ </td>
+ <td style="vertical-align: top;">No
+ </td>
+ </tr>
+ <tr style="border: 1px solid black;padding: 2px; background-color: #cfc;">
+ <td style="vertical-align: top;">Windows XP/Vista
+ </td>
+ <td style="vertical-align: top;">Yes
+ </td>
+ <td style="vertical-align: top;">Yes
+</td>
+ <td style="vertical-align: top;">Yes
+ </td>
+ </tr>
+ <tr style="border: 1px solid black;padding: 2px; ">
+ <td style="vertical-align: top;">Windows 7
+ </td>
+ <td style="vertical-align: top;">Yes
+ </td>
+ <td style="vertical-align: top;">Maybe [2]
+ </td>
+ <td style="vertical-align: top;">No
+ </td>
+ </tr>
+ <tr style="border: 1px solid black;padding: 2px; background-color: #cfc;">
+ <td style="vertical-align: top;">Mac OS X Intel
+ </td>
+ <td style="vertical-align: top;">Yes
+ </td>
+ <td style="vertical-align: top;">Yes
+</td>
+ <td style="vertical-align: top;">Yes
+ </td>
+ </tr>
+ <tr style="border: 1px solid black;padding: 2px; ">
+ <td style="vertical-align: top;">Mac OS X PPC
+ </td>
+ <td style="vertical-align: top;">Yes
+ </td>
+ <td style="vertical-align: top;">Maybe [2]
+ </td>
+ <td style="vertical-align: top;">No
+ </td>
+ </tr>
+ </tbody>
+</table>
<p>
-All environments share some prerequisites.
+[1] If the Scratchbox 1 and Maemo SDKs run properly, and Eclipse runs properly, then ESbox should work.
</p>
+<p>
+[2] If Eclipse runs properly and virtual machine software runs properly, then ESbox should work.
+</p>
+<p>
+[3] But you may use a virtual machine, if you want.
+</p>
+
+<h3>Virtual machine engines supported</h3>
+
<ul>
- <li>Java 1.5 or newer (for hosting Eclipse 3.4.2)
- <ul>
- <li>Sun Java 5.0+</li>
- <li>IBM JRE 5.0+</li>
- <li>OpenJDK 6+</li>
- <li class="warning">GNU gcj is not supported</li>
-
- <li>Installing JDK in Ubuntu Hardy or newer:
- <ol>
- <li>Note that JRE must be installed outside Scratchbox
-environment.</li>
- <li>Add the following line to your <tt>/etc/apt/sources.list</tt>:<br/>
- <tt>deb http://us.archive.ubuntu.com/ubuntu gutsy universe multiverse</tt>
- </li>
- <li>Install JRE 1.5.0 or newer:<br/>
- <tt>sudo apt-get update<br/>sudo apt-get install sun-java5-jre<br/></tt>
- </li>
- <li>Set the Java VM as default <br/>
- <tt>sudo update-alternatives --config java <br/></tt>
-and select the option with <tt>/usr/lib/jvm/java-1.5.0-sun/jre/bin/java</tt><br/>
- </li>
- </ol>
- </li>
-
- <li>Or install <a href="http://java.sun.com/javase/downloads/index_jdk5.jsp">Sun Java 5.0+</a> or
- <a href="http://java.sun.com/javase/downloads/index.jsp">Sun Java 6</a></li>
- <li>Or install <a href="http://www.ibm.com/developerworks/java/jdk/index.html">IBM JRE 5.0+</a></li>
- <li>Or install <a href="http://openjdk.java.net/">OpenJDK 6+</a></li>
-
- </ul>
- <p/>
- </li>
- <li>Host PC Connectivity
- <ul>
- <li>Host PC connectivity provides host-side software, like ssh and sbrsh clients and utilities and the tightvnc viewer.</li>
- <li>Find the complete details on the
- <a href="http://pc-connectivity.garage.maemo.org" target="_blank">PC connectivity project web site</a>.
- </li>
- </ul>
- <p/>
- </li>
+<li>VMware Workstation / Server / Player
+ <ul>
+ <li>Workstation or Server recommended for easiest
+configuration. Otherwise you need to hand-edit *.vmx files and
+cannot use VMware Tools to accelerate the machine.
+ </li>
+ </ul>
+</li>
+<li>Sun VirtualBox 2.2 or newer
+ <ul>
+ <li>Performance is reasonable and configuration is easy, but it is not as fast as VMware.
+ </li>
+ </ul>
+</li>
+<li>QEMU system emulation
+ <ul>
+ <li>Not recommended, since even with Kqemu acceleration on
+Windows, the performance is quite slow. Without it, performance
+is awful.</li>
+ </ul>
+</li>
</ul>
+
+<h3>Maemo Releases supported</h3>
+
+
+<p>
+The <a href="http://tablets-dev.nokia.com/" target="_blank">Nokia Internet Tablet OS</a> releases supported are:
+</p>
+
+<ul>
+<li>OS2008 Diablo</li><li>Fremantle</li>
+ <li class="note">Older releases may work, but PC Connectivity 2nd Edition is not supported on them;
+ you must manually set up networking and SSH.
+ </li>
+</ul>
+
+
+
+<p>
+</p>
+
</div>
+<p>
+</p>
-<p id="native"/>
+<p id="getting">
+</p>
+
<div id="group">
-<h3 id="heading">Native Maemo Environments</h3>
+<h3 id="heading">Installing ESbox IDE<br>
+
+</h3>
+<h3><a href="installation_product.html">Method 1: Full Product Archive (recommended)</a></h3>
+
+
+
+
+<ul>
+<li>ESbox is distributed as a full Eclipse product archive, which
+contains Eclipse, the Mica framework, and ESbox. This is the
+easiest way to ensure you have the right versions of the plugins and
+features.
+</li><li>Download it, extract it, and get started!
+<a href="installation_product.html">Follow these instructions</a>.
+ </li>
+</ul>
+
+
+
+
<p>
-Native environments can host Maemo SDKs directly.
+
</p>
-<h3>Linux/i386 </h3>
+
+
+<h3><a href="installation_update_site.html">Method 2: Eclipse Update Site</a></h3>
+
+
+
+
<ul>
- <li>Linux versions supported (in order of Maemo SDK compatibility)
+<li>If you have a custom Eclipse 3.4.2 installation or want to build one,
+ you can use the Eclipse Software Updates mechanism to
+ download and install and upgrade Mica and ESbox from the Internet.
+ Follow <a href="installation_update_site.html">these instructions</a>.</li>
+</ul>
+
+
+<p>
+
+
+<strong>NOTE: Both the installation via the Full Product Archive and
+the Eclipse Update Site can be upgraded using Eclipse's Software
+Updates.</strong>
+
+</p>
+
+<h3>Java runtime
+</h3>
+<p>
+ESbox is an Eclipse application, which needs Java to run.
+</p>
+
+ <b>Eclipse 3.4.2 needs Java 1.5 or newer:</b>
<ul>
- <li>Ubuntu 8.10 (Intrepid)</li>
- <li>Ubuntu 8.04 LTS (Hardy)</li>
- <li><span style="text-decoration: line-through">Ubuntu 9.04 (Jaunty)</span>
- <i>Note: Fremantle beta SDKs currently have
- <a href="http://maemo.org/development/sdks/maemo_5-0_installation/#sdkissue" target="_blank">
- serious issues with Xephyr</a> in Jaunty
- </i>
+ <li><a href="http://java.sun.com/javase/downloads/index_jdk5.jsp">Sun Java 5.0</a>
+ or <a href="http://java.sun.com/javase/downloads/index.jsp">Sun Java 6</a>
</li>
- <li>Other Debian-based Linuxes</li>
- <li>Other Linuxes</li>
+ <li><a href="http://www.ibm.com/developerworks/java/jdk/index.html">IBM JRE 5.0+</a></li>
+ <li><a href="http://openjdk.java.net/">OpenJDK 6+</a></li>
+ <li class="warning">GNU gcj is not supported</li>
</ul>
- </li>
- <li>Scratchbox and Maemo SDK
- <ul>
- <li>Maemo 4.1.x Diablo</li>
- <li>Maemo 5.0.x Fremantle</li>
- <li class="note">ESbox can install Scratchbox 1 and Diablo/Fremantle Maemo SDKs</li>
- <li>If you want to install these yourself, see <a href="http://maemo.org/development/sdks/">the Maemo SDK site</a>.</li>
- <li class="note">Older SDKs may work but are not supported</li>
- </ul>
- </li>
- <li>Nested X Server (for hosting emulation)
- <ul>
- <li>Xephyr</li>
- <li>In Debian Linux: <tt>sudo apt-get install xephyr</tt></li>
- </ul>
- </li>
-</ul>
+
+ <p>
+ You can find these JREs as packages in your distribution or download them directly from their
+ websites.
+ </p>
</div>
-<p id="vm"/>
-<div id="group">
+<p id="devenv">
-<h3 id="heading">Non-Native Maemo Environments</h3>
+</p><div id="group">
+
+<h3 id="heading">Development Environment<br>
+</h3>
+
+<h3>Virtual machine images (non-Linux)</h3>
+
+<p>If you are running ESbox outside of Linux/x86, you install the Scratchbox and Maemo components
+on a Linux/x86 virtual machine.
+</p>
<p>
-When the Maemo SDK is not hosted on your OS, you can run ESbox on the host and
-use the Maemo SDK through a virtual machine. ESbox hides most of the details for you!
-</p>
-<p>
- See <a href="virtual_machines.html">Virtual Machines</a> page for installation and configuration details.
+The Maemo Eclipse Integration project provides Linux/x86 images suitable for use
+with VMware, VirtualBox, and QEMU.
+See the <a href="http://maemovmware.garage.maemo.org">Maemo SDK VM Image project page</a> for more information on configuring and installing virtual machines.
</p>
-<h3>Other Linux</h3>
+
+<div id="group"><ul>
+<li class="note">ESbox can install a Maemo SDK VM image for you
+using the wizard <strong>File > New > Other > Maemo Installers > Maemo SDK VM Image</strong>.
+</li></ul></div>
+
+
+<p>You will need to <a href="virtual_machines.html">configure ESbox to use the virtual machine</a> so that ESbox
+knows where to find or install Scratchbox and the Maemo SDKS.
+</p>
+
+<h3>Scratchbox and Maemo SDK</h3>
+<p>To build and run C/C++ or Python applications you will need to
+install the Maemo development environment in a Linux/x86 machine
+(either your host or a VM).
+ </p>
+
<ul>
- <li>Linux versions supported
- <ul>
- <li>Not officially tested</li>
- <li>Any on which you can run Eclipse</li>
- </ul>
+
+ <li>Scratchbox
+ <p>Scratchbox enables building and emulating programs
+ in a transparent cross-compilation and cross-execution environment.
+ </p>
+ <ul>
+ <li>Scratchbox 1 is the primary cross environment for Maemo development</li>
+ <li class="note">Scratchbox 2 is a newer cross environment which overcomes several issues
+ with Scratchbox 1, but it is not officially supported or tested in ESbox.</li>
+ </ul>
+
</li>
- <li>Virtual Machines Supported
- <ul>
- <li>VMware Workstation / Server / Player</li>
- <li>Sun VirtualBox</li>
- <li>QEMU <i>(not recommended, since no acceleration is available)</i></li>
- </ul>
- </li>
- <li>Nested X Server (for hosting emulation)
- <ul>
- <li>Xephyr</li>
- <li>In Debian Linux: <tt>sudo apt-get install xephyr</tt></li>
- </ul>
- </li>
+
+
+ <li>Maemo SDKs
+
+
+ <ul><li>Maemo 4.1.x Diablo</li>
+ <li>Maemo 5.0.x Fremantle
+ <ul>
+ <li><span style="font-weight: bold;">NOTE: </span>Fremantle SDKs require the Nokia closed binaries to function properly.
+ </li>
+ </ul>
+ </li>
+ <li class="note">Older SDKs (for either variant of Scratchbox) may work but are not supported.</li>
+
+ </ul>
+ </li>
+
+ <li>Nokia closed binaries
+ <p>Maemo SDKs are open-source, but some components installed on the device and available to the SDK are closed-source.
+ These <b>must</b> be installed for Fremantle SDKs to operate properly under emulation.
+ </p>
+ </li>
</ul>
-<p/>
-<h3>Windows</h3>
+
+
+<div id="group"><ul>
+<li class="note">ESbox can install Scratchbox 1, Diablo/Fremantle
+Maemo SDKs, and Nokia closed binaries using wizards under <strong>File > New > Other > Maemo Installers</strong>.
+</li></ul></div>
+
+<h3>X Server</h3>
+
+<p>When running or debugging locally during development, an X11 server runs on the Eclipse host
+and displays your programs in the Maemo Application Framework
+(Maemo AF). </p>
+
+<p><b>NOTE:</b> X servers are available on all platforms, but the Fremantle SDK imposes some high
+requirements on the X server.
+Linux-on-Linux development will yield the best results (quality and performance).
+On other hosts, there are workarounds for known issues.
+</p>
+
<ul>
- <li>Windows Versions supported
+<li>Linux
<ul>
- <li>Windows XP SP3</li>
- <li>Windows Vista SP3</li>
+ <li>The Xephyr nested server is recommended.</li>
+ <li>In Debian Linux: <tt>sudo apt-get install xephyr</tt></li>
</ul>
+</li>
+<li>Windows
+<ul>
+ <li>You can use the server from the Cygwin/X project, by installing <a href="http://www.cygwin.com">Cygwin</a> and the <strong>xorg-xserver</strong> package.
</li>
- <li>Virtual Machines Supported
- <ul>
- <li>VMware Workstation / Server / Player</li>
- <li>Sun VirtualBox</li>
- <li>QEMU with KQEMU</li>
- </ul>
+ <li>For
+the Fremantle SDK, you must use a desktop bit depth of 16 bits.
+The X server uses the same bit depth as the desktop, so this means the
+desktop must be configured to "Medium (16 bit)" under <strong>Control Panel > Display Properties > Settings> Color Quality.</strong> If this is not done, application windows will be corrupted.
</li>
- <li>X Server (for hosting emulation)
- <ul>
- <li>Xephyr is provided by Host PC connectivity.</li>
- </ul>
- </li>
</ul>
+</li>
-<p/>
-<h3>Mac OS X</h3>
-<ul>
- <li>Common requirements, plus...</li>
- <li>MacOS X Versions supported
+<li>Mac OS X
<ul>
- <li>MacOS X Leopard (Intel)</li>
- </ul>
+ <li>The Xephyr server is recommended. This runs natively in Quartz.</li>
+ <li>Find this in the <a href="http://xquartz.macosforge.org/trac/wiki/X112.3.3" target="_blank">Xquartz project</a>.
+ </li>
+ <li>For
+the Fremantle SDK, only 16-bit displays are supported. If you use a 32-bit display, application windows will be corrupted
+or blank.</li>
+ <li>
+Xephyr uses the same bit depth as the desktop, so this means the desktop must
+be configured to "Thousands of colors" under <strong>System Preferences > Display > Colors</strong>.
</li>
- <li>Virtual Machines Supported
- <ul>
- <li>VMware Fusion</li>
- <li>Sun VirtualBox</li>
- <li>QEMU via Q [kju:] <i>(not recommended, since no acceleration is available)</i></li>
- </ul>
- </li>
- <li>X Server (for hosting emulation)
- <ul>
- <li>Xephyr</li>
- <li>Find this in the <a href="http://xquartz.macosforge.org/trac/wiki/X112.3.3" target="_blank">Xquartz project</a>.</li>
- </ul>
- </li>
+ <li>If
+you cannot reconfigure your display (as happens on MacBooks), then you
+can work around this by disabling the MIT-SHM extension.
+Add "-extension MIT-SHM" to the command line pattern under <strong>Window > Preferences > ESbox > X Server</strong>.
+
+ </li>
+
+ </ul>
+</li>
</ul>
</div>
-<p id="tablet"/>
+<p id="tablet">
+</p>
<div id="group">
-<h3 id="heading">Tablet Environment</h3>
+<h3 id="heading">PC Connectivity
+</h3>
<p>
-To use ESbox effectively with the Nokia Internet Tablet, be sure you are using
-a supported OS and have installed supporting software to make connecting easy.
+In
+order to communicate with your Maemo device, a set of daemons and
+utilities are needed on the host and target to fully communicate with the Maemo device.
</p>
-<h3>N800, N810</h3>
-<ul>
- <li><a href="http://tablets-dev.nokia.com/" target="_blank">Nokia Internet Tablet OS</a>
- <ul>
- <li>OS2008 Diablo</li>
- <li>Fremantle</li>
- <li class="note">ESbox can flash these environments onto your device.
- <p><em>File > New > Other > Maemo Installers > Flash Images to Device</em></p></li>
- </ul>
- </li>
- <li>Maemo PC Connectivity
- <ul>
- <li>Maemo PC connectivity provides device-side SSH, sbrsh, NFS, and VNC servers and configuration utilities</li>
- <li>Find the complete description and installation instructions on the
- <a href="http://pc-connectivity.garage.maemo.org" target="_blank">PC connectivity project web site</a>.
- </li>
- </ul>
- <p/>
- </li>
-</ul>
+<h3>Host PC Connectivity</h3>
+<p>
+Host PC connectivity provides host-side software, like ssh
+and sbrsh clients, the Maemo flasher, rsync, FTP client, and the
+tightvnc viewer. These are packaged together conveniently for installation on Linux/x86,
+Windows, and Mac OS X Intel. </p>
+<p>
-</div>
+Install the Host PC Connectivity
+package on the machine running Eclipse.
+</p>
+<p>
+<b>NOTE:</b> for non-Linux installations, you also need to install Host PC connectivity <span style="font-style: italic;">inside the VM</span> to use sbrsh.
+</p>
-<p id="esbox"/>
-<h2 id="installation">ESBOX INSTALLATION</h2>
+<p>
+ Find the complete details for both on the
+ <a href="http://pc-connectivity.garage.maemo.org/" target="_blank">PC connectivity project web site</a>.
+</p>
+<p>
+</p>
+<h3>Target (Maemo) PC Connectivity
+</h3>
+<p>
+On the Maemo device, you need the other half of PC Connectivity, containing the servers that match the clients installed
+on the host side. The PC Connectivity requires either a Diablo and Fremantle release.
+</p>
+<div id="group"><ul><li class="note">ESbox can flash OS images onto your device using the <em>File > New > Other > Maemo Installers > Flash Images to Device</em>
+wizard.
+</li></ul></div>
+<p>Find the complete description and installation instructions on the
+ <a href="http://pc-connectivity.garage.maemo.org" target="_blank">PC connectivity project web site</a>.
+ </p>
+ <p>
+
+</p>
-<h3><a href="installation_product.html">Method 1: Full Product Archive (recommended)</a></h3>
-<ul>
-<li>
-ESbox is distributed as a full Eclipse product archive. Download it, extract it, and get started!
-<a href="installation_product.html">Follow these instructions</a>.
-</li>
-</ul>
-<p/>
+</div>
-<h3><a href="installation_update_site.html">Method 2: Eclipse Update Site</a></h3>
-<ul>
- <li>If you have a custom Eclipse 3.4.2 installation or want to build one,
- you can use the Eclipse Software Updates mechanism to
- download and install and upgrade ESbox from the Internet.
- Follow <a href="installation_update_site.html">these instructions</a>.</li>
- <li class="note">Both installation via the Full Product Archive and this method will be upgradeable in the future.</li>
-</ul>
+<p>
-<p/>
+</p></div>
+<p style="text-align: right;"><a href="index.html" target="_parent"><img src="images/li_back.jpg" alt="back" title="back"></a></p>
</div>
-<p style="text-align: right"><a href="index.html" target="_parent"><img
- src="images/li_back.jpg" alt="back" title="back" /></a></p>
</div>
-</div>
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
<div id="footer">
<div class="part">
- <table width="100%" cellspacing="5px" style="bgcolor:#000">
- <tr class="white">
- <td><a href="http://esbox.garage.maemo.org" target="_blank"><img src="images/ma_es.jpg" alt="esbox" title="esbox" /></a></td>
+ <table style="" cellspacing="5" width="100%">
+ <tbody><tr class="white">
+ <td><a href="http://esbox.garage.maemo.org" target="_blank"><img src="images/ma_es.jpg" alt="esbox" title="esbox"></a></td>
<td valign="middle">is a part of</td>
- <td><a href="http://wiki.percomp.org" target="_blank"><img src="images/ma_pe.jpg" alt="percomp" title="percomp" /></a></td>
+ <td><a href="http://wiki.percomp.org" target="_blank"><img src="images/ma_pe.jpg" alt="percomp" title="percomp"></a></td>
<td valign="middle">developed by</td>
- <td><a href="http://embedded.ufcg.edu.br" target="_blank"><img src="images/ma_emb.jpg" alt="embedded" title="embedded" /></a></td>
+ <td><a href="http://embedded.ufcg.edu.br" target="_blank"><img src="images/ma_emb.jpg" alt="embedded" title="embedded"></a></td>
<td valign="middle">in cooperation with</td>
- <td><a href="http://www.indt.org.br/" target="_blank"><img src="images/ma_indt.jpg" alt="indt" title="indt" /></a></td>
+ <td><a href="http://www.indt.org.br/" target="_blank"><img src="images/ma_indt.jpg" alt="indt" title="indt"></a></td>
<td valign="middle">and</td>
- <td><a href="http://maemo.org/" target="_blank"><img src="images/ma_ma.jpg" alt="maemo.org" title="maemo.org" /></a></td>
+ <td><a href="http://maemo.org/" target="_blank"><img src="images/ma_ma.jpg" alt="maemo.org" title="maemo.org"></a></td>
</tr>
- </table>
+ </tbody></table>
</div>
<p class="right">© Copyright 2007 - 2009, INdT, 2008 - 2009 Nokia</p>
</div>
-</body>
-</html>
+
+</body></html>
\ No newline at end of file
Modified: www/2nd_edition/installation_prereqs.html
===================================================================
--- www/2nd_edition/installation_prereqs.html 2009-08-26 14:58:11 UTC (rev 2007)
+++ www/2nd_edition/installation_prereqs.html 2009-08-26 15:03:34 UTC (rev 2008)
@@ -51,8 +51,28 @@
<p>
Any installation of ESbox needs this software.
</p>
+
<div id="group">
+<h3 id="heading">Linux host (desktop or VM)</h3>
+<ul>
+<li>ESbox uses Scratchbox, which always runs on Linux/x86. (Your
+Eclipse host may run in other OSes as long as a VM is available
+to run Linux.)
+</li>
+<li>Verify against the prerequisites for Scratchbox and the Maemo SDK.
+We have found in testing that you need Linux kernel 2.6.28 or newer for
+recent builds of Scratchbox 1. For further information:
+<p><a href="http://maemo.org/development/sdks/maemo_5_beta_2_sdk_installation/">Maemo SDK page</a>
+</p>
+<p><a href="http://scratchbox.org/documentation/user/scratchbox-1.0/html/installdoc.html#AEN47">(probably obsolete) Scratchbox page</a>
+</p>
+</li>
+</ul>
+</div>
+
+<div id="group">
+
<h3 id="heading">Java</h3>
<ul>
<li>Installing JDK in Ubuntu Gutsy or newer:
@@ -88,7 +108,7 @@
<li>PC connectivity consists of software allowing the PC and device to communicate.
<ul>
<li>Maemo PC connectivity provides device-side software and configuration</li>
- <li>Host PC connectivity provides host-side software </li>
+ <li>Host PC connectivity provides host-side (Eclipse) software </li>
</ul>
</li>
<li>Find the complete details for both on the
Modified: www/2nd_edition/installation_product.html
===================================================================
--- www/2nd_edition/installation_product.html 2009-08-26 14:58:11 UTC (rev 2007)
+++ www/2nd_edition/installation_product.html 2009-08-26 15:03:34 UTC (rev 2008)
@@ -60,27 +60,54 @@
<h3 id="heading">Product Archives</h3>
+<p>
+ The archives come in two parts: one common archive, containing the bulk of the installation,
+ and an OS-specific archive.</p>
+<p > If your host OS is not represented, please
+ <a href="installation_update_site.html">use update sites</a> for the best results.
+</p>
+<p>Download the following archives:
+ </p>
<ul>
- <li>The archives come in two parts: one common archive, containing the bulk of the installation,
- and an OS-specific archive.</li>
- <li class="warn"> If your host OS is not represented, please
- <a href="installation_update_site.html">use update sites</a> for the best results.
+ <li>Linux/x86:
+ <ul>
+ <li><a href="https://garage.maemo.org/frs/download.php/6362/esbox_2.0.0-I200907021536-common.zip">Beta 2 Common Components</a></li>
+ <li><a href="https://garage.maemo.org/frs/download.php/6362/esbox_2.0.0-I200907021536-linux.gtk.x86.zip">Beta 2 Linux/GTK Support</a></li>
+ </ul>
</li>
- <li>Steps:
- <ol>
- <li>Download: <a href="https://garage.maemo.org/frs/shownotes.php?release_id=2719">ESbox 2.0.0M5 Release</a>
- </li>
+ <li>Windows/x86:
+ <ul>
+ <li><a href="https://garage.maemo.org/frs/download.php/6362/esbox_2.0.0-I200907021536-common.zip">Beta 2 Common Components</a></li>
+ <li><a href="https://garage.maemo.org/frs/download.php/6362/esbox_2.0.0-I200907021536-win32.win32.x86.zip">Beta 2 Win32 Support</a></li>
+ </ul>
+ </li>
+ <li>MacOS X Intel:
+ <ul>
+ <li><a href="https://garage.maemo.org/frs/download.php/6362/esbox_2.0.0-I200907021536-common.zip">Beta 2 Common Components</a></li>
+ <li><a href="https://garage.maemo.org/frs/download.php/6362/esbox_2.0.0-I200907021536-macosx.carbon.x86.zip">Beta 2 MacOS X Intel Support</a></li>
+ </ul>
+ </li>
+</ul>
+
+<h3 id="heading">Installing and Running</h3>
+
+<p>
+ Extract and install the archives:
+ </p>
+ <ol>
<li>Unzip the *-common.zip and *-<host OS>.zip archive into the same directory of your choice.
</li>
- <li>If using a Sun Java JRE, edit <tt>esbox.ini</tt> to adjust maximum memory usage (-Xmx, -XX:MaxPermSize).
+ <li>If using a Sun Java JRE, you may want to edit <tt>esbox.ini</tt> to adjust maximum memory usage (<tt>-Xmx, -XX:MaxPermSize</tt>).
</li>
- <li>Run: <tt>./esbox</tt> (Linux)</li>
- <li>Run: <tt>.\esbox.exe</tt> (Win32)</li>
- <li>Run: <tt>./esbox.app/Contents/MacOS/esbox</tt> (MacOS X)</li>
- </ol>
- </li>
-</ul>
-
+ <li>Run the main executable:
+ <ul>
+ <li> <tt>./esbox</tt> (Linux)</li>
+ <li> <tt>.\esbox.exe</tt> (Win32)</li>
+ <li><tt>./esbox.app/Contents/MacOS/esbox</tt> (MacOS X)</li>
+ </ul>
+ </li>
+ </ol>
+
</div>
</div>
More information about the Esbox-commits
mailing list