[Esbox-commits] r1228 - trunk/org.maemo.esbox.help/html/reference
eswartz at garage.maemo.org
eswartz at garage.maemo.org
Fri Feb 13 23:08:45 EET 2009
Author: eswartz
Date: 2009-02-13 23:08:44 +0200 (Fri, 13 Feb 2009)
New Revision: 1228
Modified:
trunk/org.maemo.esbox.help/html/reference/FAQ.html
Log:
Merge FAQ updates from rev 1227 from work_Ed branch
Modified: trunk/org.maemo.esbox.help/html/reference/FAQ.html
===================================================================
--- trunk/org.maemo.esbox.help/html/reference/FAQ.html 2009-02-13 21:06:17 UTC (rev 1227)
+++ trunk/org.maemo.esbox.help/html/reference/FAQ.html 2009-02-13 21:08:44 UTC (rev 1228)
@@ -1,264 +1,654 @@
-<!DOCTYPE HTML PUBLIC "-//W3C//DTD HTML 3.2 Final//EN">
-<html lang="en">
-<head>
- <meta name="copyright" content="Copyright (c) INdT 2007-2008. This page is made available under license. For full details see the LEGAL in the documentation book that contains this page." >
- <meta http-equiv="Content-Language" content="en-us">
- <meta http-equiv="Content-Type" content="text/html; charset=UTF-8">
- <title>Frequently-Asked Questions: ESbox</title>
- <link rel="stylesheet" type="text/css" href="../help.css">
-</head>
-
-<body>
-<h1>FAQ</h1>
-
-<![CDATA[=========================================================]]>
-
-<div class="h2"><!-- no 'id' or 'title' attribute for TOC -->
-<h2>Table of Contents</h2>
-
-<h4>General questions:</h4>
-<p></p>
-<ul>
- <li><a href="#what">What is ESbox?</a></li>
- <li><a href="#licensed">How is ESbox licensed?</a></li>
- <li><a href="#organized">How is the ESbox Project organized?</a></li>
- <li><a href="#releases">How do I find out about future releases of the ESbox?</a></li>
- <li><a href="#support">Which operating systems does ESbox support?</a></li>
- <li><a href="#ask">How do I ask questions?</li>
- <li><a href="#bug">How do I report a bug or request a feature?</a></li>
-</ul>
-
-<h4> </h4>
-<h4>Download and Installation:</h4>
-<p></p>
-<ul>
- <li><a href="#howtos">Are there complete HowTos for setting up the ESbox?</a></li>
- <li><a href="#build">Which ESbox build should I download?</a></li>
- <li><a href="#uninstall">How do I uninstall ESbox?</a></li>
-</ul>
-
-
-<![CDATA[=========================================================]]>
-
-<hr/>
-
-<![CDATA[-----------------------------------------------------------]]>
-
-<div class="h2" id="general-questions" title="general-questions">
-<h2>General questions:</h2>
-
-<div class="h3" id="what" title="what">
-<h3>What is ESbox?</h3>
-
-<p>
-ESbox is an Eclipse product for developing applications and libraries
-on the Maemo software platform.
-</p>
-<p>
-ESbox is strongly integrated with Scratchbox,
-reducing time and effort for configuration and increasing the productivity for
-Linux-based embedded systems development. It supports C/C++ and Python programming
-languages. Maemo 4.x and future SDKs will be supported.
-</p>
-<p>
-ESbox also supports deploying, running, and debugging applications and
-libraries on the Nokia Internet Tablet.
-</p>
-</div>
-
-<![CDATA[-----------------------------------------------------------]]>
-
-
-<div class="h3" id="licensed" title="licensed">
-<h3>How is ESbox licensed?</h3>
-
-<p>
-This software is produced by the ESbox team combined with third party
-software developed from other Open Source Projects. This software has been
-licensed under <a href="../about_files/epl-v10.html">Eclipse Public License
-Version 1.0 ("EPL")</a>.</p>
-
-</div>
-
-<![CDATA[-----------------------------------------------------------]]>
-
-
-<div class="h3" id="organized" title="organized">
-<h3>How is the ESbox Project organized?</h3>
-
-<p>
-ESbox consists of three major layers:
-
-<ul>
-<li>Eclipse platform </li>
-
-<blockquote>
-A popular and extensible framework for developing IDEs. See <a href="http://www.eclipse.org">the eclipse.org website</a>.
-</blockquote>
-
-<li>Maemo IDE Common Architecture</li>
-<blockquote>
-A plugin framework supporting both the ESbox and PluThon products, which provides
-an extensible platform for Maemo development:
-<ul>
-<li>Unified project model, with C/C++ and Python implementations</li>
-<li>Linux development (e.g. Debian packaging)</li>
-<li>SSH, SBRSH, and RSE support for connecting with Maemo devices</li>
-<li>and more! See <a href="https://garage.maemo.org/projects/mica/">the Mica project website</a>
-for more information.</li>
-</ul>
-</blockquote>
-
-<li>ESbox product</li>
-<blockquote>
-A targeted set of product plugins, providing the top-level project and import
-wizards, this help, graphics, and user interface modifications giving ESbox its
-unique feel as a product.
-</blockquote>
-
-</ul>
-
-</div>
-
-<![CDATA[-----------------------------------------------------------]]>
-
-
-<div class="h3" id="releases" title="releases">
-<h3>How do I find out about future releases of ESbox?</h3>
-
-<p>
-To find out about futures releases see:
-<a href="https://garage.maemo.org/news/?group_id=192">ESbox News</a>
-</p>
-
-</div>
-
-<![CDATA[-----------------------------------------------------------]]>
-
-
-<div class="h3" id="support" title="support">
-<h3>Which operating systems does ESbox support?</h3>
-
-<p>
-The ESbox product runs on Linux (32 or 64 bit), Windows XP/Vista, and Mac OS X.
-</p>
-<p>
-The underlying Scratchbox, on the other hand, only runs on Linux/i386. To support
-non-Linux hosts, ESbox can communicate with a virtual machine hosting the Maemo SDK.
-(Currently these are available through links on the
-<a href="https://garage.maemo.org/plugins/wiki/index.php?ESboxOutsideLinuxWithVirtualMachine&id=192&type=g">
-Preleases wiki page</a>.)
-</p>
-<p>ESbox, though Mica, operates essentially the same way regardless of which host you're
-running on. A limitation, though, is that your projects or workspace must be visible
-to both Scratchbox and the host. When Scratchbox is running on a virtual machine,
-we support this via Samba sharing from the host to the VM.
-</p>
-
-</div>
-
-<![CDATA[-----------------------------------------------------------]]>
-
-<div class="h3" id="ask" title="ask">
-<h3>How do I ask questions?</h3>
-
-<p>
-The <a href="https://garage.maemo.org/">garage.maemo.org</a> website provides some mailing
-<a href="https://garage.maemo.org/mail/?group_id=192">lists</a>. Choose a list
-to browse, search, and post messages. Keep in mind that these newsgroups are public,
-so do not include any confidential information in your questions. You should
-also read "How to ask questions the smart way" by Eric Raymond before participating
-in the newsgroups.
-
-</p>
-
-</div>
-
-<![CDATA[-----------------------------------------------------------]]>
-
-
-<div class="h3" id="bug" title="bug">
-<h3>How do I report a bug or request a feature?</h3>
-
-<p>
-The bug and feature trackers are stored at the
-<a href="https://garage.maemo.org/tracker/?group_id=192">ESbox project page</a>.
-</p>
-<p>
-Before entering a bug report, you should search to see if someone else
-has already entered a bug report similar to yours. If you find a bug report
-that outlines the problem you are seeing, you can simply annotate it with your
-comments to let the developers know that you have also hit the bug. Also you
-can add yourself to the "Monitor" list of the bug so that you will be notified
-when the status of the bug changes or
-someone adds comments.</p>
-
-
-</div>
-
-</div>
-
-<div class="h2" id="download" title="download">
-<h2>Download and Installation:</h2>
-
-<![CDATA[-----------------------------------------------------------]]>
-
-<div class="h3" id="howtos" title="howtos">
-<h3>Are there complete HowTos for setting up ESbox?</h3>
-
-<p>
-ESbox itself is fully packaged and ready to run. You only need to unzip it somewhere
-and run the "ESbox" executable inside.
-</p>
-<p>
-Setting up the Scratchbox and Maemo SDKs is still a bit of a manual effort, though,
-if you do not use a virtual machine.
-See <a href="http://maemovmware.garage.maemo.org/">the Maemo VMware Appliance</a>
-site for a convenient image with everything (Linux, Scratchbox, Maemo SDKs, and ESbox) installed .
-</p>
-<p>
-Full integration information is supplied here <a href="http://maemo.org/development/documentation/ide_integration/">http://maemo.org/development/documentation/ide_integration/</a>.
-</p>
-
-<h3>Which ESbox build should I download? </h3>
-
-<p>Download one of the 2.0.0 product builds for your operating system from
-<a href="https://garage.maemo.org/frs/?group_id=192">the ESbox Files section</a>.
-
-This will provide a full Eclipse environment with Eclipse, Mica, and ESbox.
-</p>
-
-<b>Manual installation</b>
-
-<p>
-If you want to add ESbox features to your existing Ganymede installation, see the
-<a href="http://esbox.garage.maemo.org/esbox_installation.html">
-instructions</a> for installing from the ESbox update site.
-</p>
-
-<div class="h3" id="uninstall" title="uninstall">
-<h3>How do I uninstall ESbox?</h3>
-
-<p>
-Removing plugins from Eclipse is easy, so no particular uninstaller is needed.
-You can browse and manage your configuration from the Product Configuration dialog.
-Open the Product Configuration dialog by clicking Help > Software Updates >
-Manage Configuration.
-
-<ul>
- <li>Disabling a feature: select the feature and click Disable in the right pane of
- the dialog. This option is available only when the feature is currently enabled,
- and the feature is either an optional feature or a root feature (not included
- by other features).</li>
- <li>Enabling a feature: First, ensure Show Disabled Features is turned on in the
- tool bar. Then, select a disabled optional or root feature and click Enable in
- the right pane of the dialog.</li>
- <li>Uninstalling a feature: features that you have installed using the update
- manager can be uninstalled, provided they are already disabled, or that they are
- optional or root features. If the feature is disabled, make sure Show Disabled
- Features is turned on in the tool bar. Select the feature and click Uninstall in
- the right page of the dialog.</li>
-</p>
-
-</body>
-</html>
\ No newline at end of file
+<!DOCTYPE HTML PUBLIC "-//W3C//DTD HTML 4.0 Transitional//EN">
+<HTML>
+<HEAD>
+ <META HTTP-EQUIV="CONTENT-TYPE" CONTENT="text/html; charset=windows-1252">
+ <TITLE>Frequently-Asked Questions: ESbox</TITLE>
+ <META NAME="GENERATOR" CONTENT="OpenOffice.org 2.3 (Win32)">
+ <META NAME="CREATED" CONTENT="0;0">
+ <META NAME="CHANGED" CONTENT="20090213;15011649">
+ <META NAME="copyright" CONTENT="Copyright (c) INdT 2007-2008. This page is made available under license. For full details see the LEGAL in the documentation book that contains this page.">
+ <META NAME="CHANGEDBY" CONTENT="Ed Swartz">
+ <META NAME="CHANGEDBY" CONTENT="Ed Swartz">
+ <META NAME="CHANGEDBY" CONTENT="Ed Swartz">
+ <META HTTP-EQUIV="Content-Language" CONTENT="en-us">
+ <STYLE TYPE="text/css">
+ <!--
+ H1 { color: #000000; font-family: "Arial", sans-serif; font-size: 18pt }
+ P { color: #000000; font-family: "Arial", sans-serif; font-size: 10pt }
+ H2 { color: #000000; font-family: "Arial", sans-serif; font-size: 14pt }
+ H3 { color: #000000; font-family: "Arial", sans-serif; font-size: 11pt }
+ H4 { color: #000000; font-family: "Arial", sans-serif; font-size: 10pt; font-style: italic }
+ BLOCKQUOTE { color: #000000; font-family: "Arial", sans-serif; font-size: 10pt }
+ A:link { color: #006699 }
+ -->
+ </STYLE>
+</HEAD>
+<BODY LANG="en-US" TEXT="#000000" LINK="#006699" BGCOLOR="#ffffff" DIR="LTR">
+<H1>FAQ</H1>
+<H2><!-- no 'id' or 'title' attribute for TOC -->Table of Contents</H2>
+<H4>General questions:</H4>
+<UL>
+ <LI><P STYLE="margin-bottom: 0in"><A HREF="#what">What is ESbox?</A>
+ </P>
+ <LI><P STYLE="margin-bottom: 0in"><A HREF="#licensed">How is ESbox
+ licensed?</A>
+ </P>
+ <LI><P STYLE="margin-bottom: 0in"><A HREF="#organized">How is the
+ ESbox Project organized?</A>
+ </P>
+ <LI><P STYLE="margin-bottom: 0in"><A HREF="#releases">How do I find
+ out about future releases of ESbox?</A>
+ </P>
+ <LI><P STYLE="margin-bottom: 0in"><A HREF="#support">Which operating
+ systems does ESbox support?</A>
+ </P>
+ <LI><P STYLE="margin-bottom: 0in"><A HREF="#ask">How do I ask
+ questions? </A>
+ </P>
+ <LI><P><A HREF="#bug">How do I report a bug or request a feature?</A>
+ </P>
+</UL>
+<H4>Download and Installation:</H4>
+<UL>
+ <LI><P STYLE="margin-bottom: 0in"><A HREF="#howtos">Are there
+ complete HowTos for setting up ESbox?</A>
+ </P>
+ <LI><P STYLE="margin-bottom: 0in"><A HREF="#build">Which ESbox build
+ should I download?</A>
+ </P>
+ <LI><P><A HREF="#uninstall">How do I uninstall ESbox?</A>
+ </P>
+</UL>
+<H4>Development with Scratchbox:</H4>
+<UL>
+ <LI><P STYLE="margin-bottom: 0in"><A HREF="#scratchbox-esbox|region">How
+ do I work with Scratchbox in ESbox?</A></P>
+ <LI><P STYLE="margin-bottom: 0in"><A HREF="#esbox-windows-osx|region">How
+ do I work with ESbox in Windows or Mac OS X?</A></P>
+ <LI><P STYLE="margin-bottom: 0in"><A HREF="#new-scratchbox-sdk|region">How
+ do I install new versions of Scratchbox or new SDKs?</A></P>
+ <LI><P STYLE="margin-bottom: 0in"><A HREF="#new-scratchbox-targets|region">How
+ do I install new Scratchbox targets?</A></P>
+ <LI><P STYLE="margin-bottom: 0in"><A HREF="#synchronize-packages|region">How
+ do I synchronize packages with my project?</A></P>
+</UL>
+<H4>Working with Nokia Internet Tablets:</H4>
+<UL>
+ <LI><P STYLE="margin-bottom: 0in"><A HREF="#development-setup|region">How
+ do I set up my tablet for development?</A></P>
+ <LI><P STYLE="margin-bottom: 0in"><A HREF="#configure-for-esbox|region">How
+ do I configure my tablet for use with ESbox?</A></P>
+ <LI><P STYLE="margin-bottom: 0in"><A HREF="#run-debug-tablet|region">How
+ do I run and debug on a tablet?</A></P>
+ <LI><P STYLE="margin-bottom: 0in"><A HREF="#networking-issues|region">How
+ do I resolve networking issues?</A></P>
+</UL>
+<DIV ID="general-questions" DIR="LTR">
+ <H2>General questions:</H2>
+ <DIV ID="what" DIR="LTR">
+ <H3>What is ESbox?</H3>
+ <P>ESbox is an Eclipse product for developing applications and
+ libraries on the Maemo software platform.
+ </P>
+ <P>ESbox is strongly integrated with Scratchbox, reducing time and
+ effort for configuration and increasing the productivity for
+ Linux-based embedded systems development. It supports C/C++ and
+ Python programming languages. Maemo 4.x and future SDKs will be
+ supported.
+ </P>
+ <P>ESbox also supports deploying, running, and debugging
+ applications and libraries on the Nokia Internet Tablet.
+ </P>
+ </DIV>
+ <DIV ID="licensed" DIR="LTR">
+ <H3>How is ESbox licensed?</H3>
+ <P>This software is produced by the ESbox team combined with third
+ party software developed from other Open Source Projects. This
+ software has been licensed under <A HREF="../../../../../sources/sources/sources/maemo-esbox-mica/esbox/org.maemo.esbox.help/html/about_files/epl-v10.html">Eclipse
+ Public License Version 1.0 ("EPL")</A>.</P>
+ </DIV>
+ <DIV ID="organized" DIR="LTR">
+ <H3>How is the ESbox Project organized?</H3>
+ <P>ESbox consists of three major layers:
+ </P>
+ <UL>
+ <LI><P>Eclipse platform
+ </P>
+ <BLOCKQUOTE>A popular and extensible framework for developing
+ IDEs. See <A HREF="http://www.eclipse.org/">the eclipse.org
+ website</A>.
+ </BLOCKQUOTE>
+ <LI><P>Maemo IDE Common Architecture
+ </P>
+ <BLOCKQUOTE STYLE="margin-bottom: 0in">A plugin framework
+ supporting both the ESbox and PluThon products, which provides an
+ extensible platform for Maemo development:
+ </BLOCKQUOTE>
+ <UL>
+ <LI><BLOCKQUOTE STYLE="margin-bottom: 0in">Unified project model,
+ with C/C++ and Python implementations
+ </BLOCKQUOTE>
+ <LI><BLOCKQUOTE STYLE="margin-bottom: 0in">Linux development
+ (e.g. Debian packaging)
+ </BLOCKQUOTE>
+ <LI><BLOCKQUOTE STYLE="margin-bottom: 0in">SSH, SBRSH, and RSE
+ support for connecting with Maemo devices
+ </BLOCKQUOTE>
+ <LI><BLOCKQUOTE>and more! See <A HREF="https://garage.maemo.org/projects/mica/">the
+ Mica project website</A> for more information.
+ </BLOCKQUOTE>
+ </UL>
+ <LI><P>ESbox product
+ </P>
+ <BLOCKQUOTE>A targeted set of product plugins, providing the
+ top-level project and import wizards, this help, graphics, and
+ user interface modifications giving ESbox its unique feel as a
+ product.
+ </BLOCKQUOTE>
+ </UL>
+ </DIV>
+ <DIV ID="releases" DIR="LTR">
+ <H3>How do I find out about future releases of ESbox?</H3>
+ <P>To find out about futures releases see: <A HREF="https://garage.maemo.org/news/?group_id=192">ESbox
+ News</A>
+ </P>
+ </DIV>
+ <DIV ID="support" DIR="LTR">
+ <H3>Which operating systems does ESbox support?</H3>
+ <P>The ESbox product runs on Linux (32 or 64 bit), Windows
+ XP/Vista, and Mac OS X.
+ </P>
+ <P>The underlying Scratchbox, on the other hand, only runs on
+ Linux/i386. To support non-Linux hosts, ESbox can communicate with
+ a virtual machine hosting the Maemo SDK. (Currently these are
+ available through links on the <A HREF="https://garage.maemo.org/plugins/wiki/index.php?ESboxOutsideLinuxWithVirtualMachine&id=192&type=g">Preleases
+ wiki page</A>.)
+ </P>
+ <P>ESbox, though Mica, operates essentially the same way regardless
+ of which host you're running on. A limitation, though, is that your
+ projects or workspace must be visible to both Scratchbox and the
+ host. When Scratchbox is running on a virtual machine, we support
+ this via Samba sharing from the host to the VM.
+ </P>
+ </DIV>
+ <DIV ID="ask" DIR="LTR">
+ <H3>How do I ask questions?</H3>
+ <P>The <A HREF="https://garage.maemo.org/">garage.maemo.org</A>
+ website provides some mailing <A HREF="https://garage.maemo.org/mail/?group_id=192">lists</A>.
+ Choose a list to browse, search, and post messages. Keep in mind
+ that these newsgroups are public, so do not include any
+ confidential information in your questions. You should also read
+ "How to ask questions the smart way" by Eric Raymond
+ before participating in the newsgroups.
+ </P>
+ </DIV>
+ <DIV ID="bug" DIR="LTR">
+ <H3>How do I report a bug or request a feature?</H3>
+ <P>The bug and feature trackers are stored at the <A HREF="https://garage.maemo.org/tracker/?group_id=192">ESbox
+ project page</A>.
+ </P>
+ <P>Before entering a bug report, you should search to see if
+ someone else has already entered a bug report similar to yours. If
+ you find a bug report that outlines the problem you are seeing, you
+ can simply annotate it with your comments to let the developers
+ know that you have also hit the bug. Also you can add yourself to
+ the "Monitor" list of the bug so that you will be
+ notified when the status of the bug changes or someone adds
+ comments.</P>
+ </DIV>
+</DIV>
+<DIV ID="download" DIR="LTR">
+ <H2>Download and Installation:</H2>
+ <DIV ID="howtos" DIR="LTR">
+ <H3>Are there complete HowTos for setting up ESbox?</H3>
+ <P>ESbox itself is fully packaged and ready to run. You only need
+ to unzip it somewhere and run the "ESbox" executable
+ inside.
+ </P>
+ <P>Setting up the Scratchbox and Maemo SDKs is still a bit of a
+ manual effort, though, if you do not use a virtual machine. See <A HREF="http://maemovmware.garage.maemo.org/">the
+ Maemo VMware Appliance</A> site for a convenient image with
+ everything (Linux, Scratchbox, Maemo SDKs, and ESbox) installed .
+ </P>
+ <P>Full integration information is supplied here
+ <A HREF="http://maemo.org/development/documentation/ide_integration/">http://maemo.org/development/documentation/ide_integration/</A>.
+ </P>
+ <H3>Which ESbox build should I download?
+ </H3>
+ <P>Download one of the 2.0.0 product builds for your operating
+ system from <A HREF="https://garage.maemo.org/frs/?group_id=192">the
+ ESbox Files section</A>. This will provide a full Eclipse
+ environment with Eclipse, Mica, and ESbox.
+ </P>
+ <P><B>Manual installation</B>
+ </P>
+ <P>If you want to add ESbox features to your existing Ganymede
+ installation, see the <A HREF="http://esbox.garage.maemo.org/esbox_installation.html">instructions</A>
+ for installing from the ESbox update site.
+ </P>
+ </DIV>
+ <DIV ID="uninstall" DIR="LTR">
+ <H3>How do I uninstall ESbox?</H3>
+ <P>Removing plugins from Eclipse is easy, so no particular
+ uninstaller is needed. You can browse and manage your configuration
+ from the Product Configuration dialog. Open the Product
+ Configuration dialog by clicking Help > Software Updates >
+ Manage Configuration.
+ </P>
+ <UL>
+ <LI><P STYLE="margin-bottom: 0in">Disabling a feature: select the
+ feature and click Disable in the right pane of the dialog. This
+ option is available only when the feature is currently enabled,
+ and the feature is either an optional feature or a root feature
+ (not included by other features).
+ </P>
+ <LI><P STYLE="margin-bottom: 0in">Enabling a feature: First,
+ ensure Show Disabled Features is turned on in the tool bar. Then,
+ select a disabled optional or root feature and click Enable in the
+ right pane of the dialog.
+ </P>
+ <LI><P>Uninstalling a feature: features that you have installed
+ using the update manager can be uninstalled, provided they are
+ already disabled, or that they are optional or root features. If
+ the feature is disabled, make sure Show Disabled Features is
+ turned on in the tool bar. Select the feature and click Uninstall
+ in the right page of the dialog.
+ </P>
+ </UL>
+ </DIV>
+</DIV>
+<DIV ID="development-scratchbox" DIR="LTR">
+ <H2><A NAME="download"></A>Development in Scratchbox</H2>
+ <DIV ID="scratchbox-esbox" DIR="LTR"><A NAME="scratchbox-esbox|region"></A>
+ <H3><A NAME="howtos"></A>How do I work with Scratchbox in ESbox?</H3>
+ <H4>System configuration</H4>
+ <P>When you first use a command or run a wizard that needs
+ Scratchbox, ESbox will automatically scan for Scratchbox 1 and
+ Scratchbox 2 installations. Currently these conditions must be met:</P>
+ <UL>
+ <LI><P>Scratchbox 1: <B>sb-conf </B><SPAN STYLE="font-weight: medium">visible
+ on PATH or located in</SPAN> <B>/scratchbox/tools/bin</B></P>
+ <LI><P STYLE="font-weight: medium">Scratchbox 2: <B>sb2-config </B>and
+ <B>sb2 </B>visible on PATH</P>
+ </UL>
+ <P STYLE="font-weight: medium">If the programs are not found, then
+ the respective Scratchbox will not be usable.</P>
+ <H4>Metaphors in ESbox</H4>
+ <P>In ESbox, a Scratchbox 1 or 2 installation is called an “SDK”.
+ An individual target (like DIABLO_ARMEL) is a “target”.</P>
+ <P>See the preference page <B>Window > Preferences > Maemo >
+ Installed Targets </B><SPAN STYLE="font-weight: medium">to confirm
+ and modify the Scratchbox installations. You should see a node for
+ Scratchbox 1 and/or 2, based on what you have installed, and
+ entries for each recognized target underneath. If not, try the
+ </SPAN><B>Refresh </B><SPAN STYLE="font-weight: medium">button. </SPAN>
+ </P>
+ <DIV ID="esbox-windows-osx" DIR="LTR"><A NAME="esbox-windows-osx|region"></A>
+ <H3>How do I work with ESbox in Windows or Mac OS X?</H3>
+ <P>The Maemo SDK and tools only run on Linux/x86 at the moment,
+ but you may run ESbox on Windows or Mac OS X. To do this, ESbox
+ can use a <B>virtual machine</B> to handle all the building and
+ running work.</P>
+ <P>The preference page <B>Window > Preferences > ESbox >
+ Build Machines </B><SPAN STYLE="font-weight: medium">is the
+ gateway to configuring this facility. </SPAN>
+ </P>
+ <H4>Latest information</H4>
+ <P>Please see the ESbox project wiki page for the latest details,
+ as this FAQ may be out of date:
+ <A HREF="https://garage.maemo.org/plugins/wiki/index.php?ESboxOutsideLinuxWithVirtualMachine&id=192&type=g"><U>UsingESboxOutsideLinuxWithVirtualMachine</U></A></P>
+ <P>page covers:</P>
+ <UL>
+ <LI><P><A HREF="https://garage.maemo.org/plugins/wiki/index.php?refs=ESboxOutsideLinuxWithVirtualMachine&id=192&type=g"><FONT COLOR="#000000"><SPAN STYLE="text-decoration: none"><FONT FACE="Arial, sans-serif"><FONT SIZE=2>VMware
+ configuration</FONT></FONT></SPAN></FONT></A></P>
+ <LI><P><A HREF="https://garage.maemo.org/plugins/wiki/index.php?refs=ESboxOutsideLinuxWithVirtualMachine&id=192&type=g"><FONT COLOR="#000000"><SPAN STYLE="text-decoration: none"><FONT FACE="Arial, sans-serif"><FONT SIZE=2>QEMU
+ configuration</FONT></FONT></SPAN></FONT></A></P>
+ <LI><P><A HREF="https://garage.maemo.org/plugins/wiki/index.php?refs=ESboxOutsideLinuxWithVirtualMachine&id=192&type=g"><FONT COLOR="#000000"><SPAN STYLE="text-decoration: none"><FONT FACE="Arial, sans-serif"><FONT SIZE=2>Windows
+ and Mac OS X specific setup</FONT></FONT></SPAN></FONT></A></P>
+ </UL>
+ <H4 STYLE="text-decoration: none">Virtual machines</H4>
+ <P STYLE="text-decoration: none">The Maemo Eclipse Integration
+ project provides some preconfigured virtual machine images which
+ you may use with ESbox, which have Scratchbox 1 and Diablo SDKs
+ preinstalled.
+ </P>
+ <P STYLE="text-decoration: none">These images are distributed as
+ VMware *.vmdk images, but they may be used in VMware, QEMU, or
+ VirtualBox, since the disk format is common, and there are no
+ VMware-specific programs installed.</P>
+ <P><SPAN STYLE="text-decoration: none">For Windows hosts, use a
+ Gutsy Ubuntu Linux image from:
+ <<A HREF="http://embedded.ufcg.edu.br/~raul/files/maemo_server_gutsy/">http://embedded.ufcg.edu.br/~raul/files/maemo_server_gutsy/</A>>
+ </SPAN>
+ </P>
+ <P><SPAN STYLE="text-decoration: none">For Mac OS X hosts, use a
+ Hardy Ubuntu Linux image from:
+ <<A HREF="http://embedded.ufcg.edu.br/~raul/files/maemo_server_hardy/">http://embedded.ufcg.edu.br/~raul/files/maemo_server_hardy/</A>></SPAN></P>
+ <P STYLE="text-decoration: none"><I>* These are temporary
+ locations; consult the wiki page for more information.</I></P>
+ <P STYLE="text-decoration: none"><I>* There are different images
+ because Samba has different showstopper bugs interacting with the
+ two hosts. </I>
+ </P>
+ <H4 STYLE="text-decoration: none">Shared folders</H4>
+ <P STYLE="text-decoration: none">A requirement for using virtual
+ machines in this way is that <SPAN STYLE="font-weight: medium">projects
+ must be </SPAN><B>visible </B><SPAN STYLE="font-weight: medium">to
+ the virtual machine through a </SPAN><B>shared folder</B><SPAN STYLE="font-weight: medium">.
+ The Eclipse workspace is hosted on the host filesystem, and the
+ Linux VM builds programs inside this shared folder. (This isn't
+ the best way, especially since Windows doesn't support the same
+ attributes as a Unix filesystem, but it's the most expedient.)</SPAN></P>
+ <P STYLE="text-decoration: none"><SPAN STYLE="font-weight: medium">Usually
+ you will share a </SPAN><B>workspace folder </B><SPAN STYLE="font-weight: medium">from
+ the host and mount it in the virtual machine, so that building and
+ running will work.</SPAN></P>
+ <P STYLE="text-decoration: none"><SPAN STYLE="font-weight: medium">Optionally
+ you can share </SPAN><B>scratchbox </B><SPAN STYLE="font-weight: medium">folders
+ to the host so that C/C++ indexing will find your headers.</SPAN></P>
+ <P STYLE="text-decoration: none"><SPAN STYLE="font-weight: medium">The
+ </SPAN><B>Build Machines</B> <SPAN STYLE="font-weight: medium">preference
+ page lets you specify how folders are shared between the host and
+ the virtual machine.</SPAN></P>
+ </DIV>
+ <DIV ID="new-scratchbox-sdk" DIR="LTR"><A NAME="new-scratchbox-sdk|region"></A>
+ <H3 STYLE="text-decoration: none">How do I install new versions of
+ Scratchbox or new SDKs?</H3>
+ <P STYLE="text-decoration: none">In the current edition, you must
+ install these outside ESbox using a standard script from maemo.org
+ (e.g. “maemo-scratchbox-install_...sh” or
+ “maemo-sdk-<SPAN STYLE="font-weight: medium">install_....sh”
+ ). </SPAN>
+ </P>
+ <P STYLE="font-weight: medium; text-decoration: none">Due to the
+ conditions needed to locate Scratchbox 1 or Scratchbox 2 mentioned
+ above, you can usually only use one installation at a time.</P>
+ <P STYLE="text-decoration: none"><SPAN STYLE="font-weight: medium">Use
+ the “Refresh” button under </SPAN><B>Window >
+ Preferences > Maemo > Installed Targets </B><SPAN STYLE="font-weight: medium">to
+ let ESbox know about the changes.</SPAN></P>
+ </DIV>
+ <DIV ID="new-scratchbox-targets" DIR="LTR"><A NAME="new-scratchbox-targets|region"></A>
+ <H3 STYLE="text-decoration: none">How do I install new Scratchbox
+ targets?</H3>
+ <P STYLE="text-decoration: none">In the preference page <B>Window
+ > Preferences > Maemo > Installed Targets</B><SPAN STYLE="font-weight: medium">,
+ you may install new Scratchbox 2 rootstraps using the “New”
+ button. </SPAN>
+ </P>
+ <P STYLE="font-weight: medium; text-decoration: none">You may also
+ create new Scratchbox 1 targets this way, through a wizard that
+ mirrors the way “sb-menu” works when you setup a new
+ target, but currently no rootstrap is installed -- this must be
+ done manually.</P>
+ </DIV>
+ <DIV ID="synchronize-packages" DIR="LTR"><A NAME="synchronize-packages|region"></A>
+ <H3 STYLE="text-decoration: none">How do I synchronize packages
+ with my project?</H3>
+ <P STYLE="text-decoration: none">When you create a new project
+ (<B>File > New > Project > Maemo C or C++ Project </B>or
+ <B>File > New > Project > Maemo Python Project</B>), or
+ when you invoke the <B>Project > Validate Installed Packages</B>
+ command, ESbox will help you install the packages required by one
+ or more projects into one or more Scratchbox rootstraps or with
+ configured Nokia Internet Tablets (see the next section).</P>
+ <P STYLE="text-decoration: none">ESbox will scan autotools-based
+ projects for the packages implied by the PKG_CONFIG_CHECK macros
+ in configure.ac and install these if missing. For other projects,
+ default metapackages recommended by the Maemo Eclipse Integration
+ project will be installed.</P>
+ <H4 STYLE="text-decoration: none">Networking setup</H4>
+ <P STYLE="text-decoration: none">Be sure to visit the <B>Network
+ Connections </B><SPAN STYLE="font-weight: medium">preferences
+ before updating packages, so any proxy settinges are established.
+ Even if you start an operation and find it fails, you can
+ generally </SPAN><B>Cancel </B><SPAN STYLE="font-weight: medium">the
+ operation, use the </SPAN><B>View Log </B><SPAN STYLE="font-weight: medium">command
+ to avoid closing the wizard, then go </SPAN><B>Back </B><SPAN STYLE="font-weight: medium">and
+ then </SPAN><B>Next </B><SPAN STYLE="font-weight: medium">again to
+ retry.</SPAN></P>
+ <H4 STYLE="text-decoration: none">If you can't connect to any
+ repositories...</H4>
+ <P STYLE="text-decoration: none">At the time of this writing,
+ there are some seriously annoying issues where no combination of
+ settings will seem to allow you to connect to the repositories to
+ update packages inside scratchbox. This is exacerbated when using
+ proxies or running Scratchbox in a virtual machine on a Windows or
+ Mac OS X host. This is either a problem in scratchbox, in ESbox,
+ in VMware, or in the maemo.org hosting providers, or some
+ combination – you choose :).</P>
+ <P STYLE="text-decoration: none">As a last resort, you may to edit
+ <B>/etc/hosts </B><SPAN STYLE="font-style: normal"><SPAN STYLE="font-weight: medium">inside
+ each Scratchbox rootstrap and enter a manual address for
+ repository.maemo.org, e.g.:</SPAN></SPAN></P>
+ <P STYLE="font-style: normal; text-decoration: none"><B>206.57.28.43
+ repository.maemo.org</B></P>
+ <P STYLE="margin-bottom: 0in; font-weight: medium; text-decoration: none">
+ (<B>ping </B>the repository.maemo.org address before using the
+ example, since the addresses may change.)</P>
+ <P STYLE="margin-bottom: 0in"><BR>
+ </P>
+ <P STYLE="margin-bottom: 0in; font-weight: medium; text-decoration: none">
+ When updating packages inside a Nokia Internet Tablet, you may
+ also need to disconnect any “static” USB, WLAN, or
+ Bluetooth connections and directly connect the tablet to a WLAN
+ that can access the Internet, otherwise traffic may simply flow
+ into the host computer and die there.</P>
+ </DIV>
+ </DIV>
+</DIV>
+<DIV ID="InternetTablets" DIR="LTR">
+ <H2 STYLE="text-decoration: none">Working with Nokia Internet
+ Tablets</H2>
+ <DIV ID="development-setup" DIR="LTR"><A NAME="development-setup|region"></A>
+ <H3 STYLE="text-decoration: none">How do I set up my tablet for
+ development?</H3>
+ <P STYLE="text-decoration: none">The first important step is to
+ install the <B>maemo-pc-connectivity</B> metapackage. This will
+ install the proper servers on your tablet so you can access it from
+ your PC for the purpose of remote SSH launching, copying files,
+ debugging, and using Scratchbox Remote Shell.
+ </P>
+ <P STYLE="text-decoration: none">You also need to set up your
+ tablet for R&D mode (so you may become root, and install Debian
+ packages, update the system from ESbox, etc).</P>
+ <P STYLE="text-decoration: none">Also, you must install the
+ host-side programs needed for communication with the tablet
+ programs in maemo-pc-connectivity. (These are preinstalled in the
+ virtual machine images.)</P>
+ <P><SPAN STYLE="text-decoration: none"><B>All the details </B></SPAN><SPAN STYLE="text-decoration: none"><SPAN STYLE="font-weight: medium">are
+ on this page:
+ </SPAN></SPAN><SPAN STYLE="text-decoration: none"><<A HREF="http://maemo.org/development/documentation/pc_connectivity/">http://maemo.org/development/documentation/pc_connectivity/</A>>.</SPAN></P>
+ <P><BR><BR>
+ </P>
+ </DIV>
+ <DIV ID="configure-for-esbox" DIR="LTR"><A NAME="configure-for-esbox|region"></A>
+ <H3 STYLE="text-decoration: none">How do I configure my tablet for
+ use with ESbox?</H3>
+ <P STYLE="text-decoration: none">ESbox integrates the Eclipse
+ Remote System Explorer project, which provides a common framework
+ for interacting with remote machines.
+ </P>
+ <P STYLE="text-decoration: none">ESbox will automatically create a
+ connection called “Nokia Internet Tablet” which is
+ preconfigured with the standard USB address (192.168.2.15). Open
+ the <B>Remote Systems </B><SPAN STYLE="font-weight: medium">view
+ (</SPAN><B>Window > Show View > Other > Remote Systems >
+ Remote Systems</B><SPAN STYLE="font-weight: medium">) to see this.</SPAN></P>
+ <P STYLE="text-decoration: none">If you're using a different
+ connection type, like WLAN or Bluetooth, you will need to manually
+ reconfigure the connection. Right-click the connection and select
+ <B>Properties </B><SPAN STYLE="font-weight: medium">and then </SPAN><B>Host.
+ </B><SPAN STYLE="font-weight: medium">Edit the address and/or
+ username accordingly.</SPAN></P>
+ <P><BR><BR>
+ </P>
+ </DIV>
+ <DIV ID="run-debug-tablet" DIR="LTR"><A NAME="run-debug-tablet|region"></A>
+ <H3 STYLE="text-decoration: none"><A NAME="howtos1"></A>How do I
+ run and debug on a tablet?</H3>
+ <P><SPAN STYLE="text-decoration: none">ESbox supports running and
+ debugging C/C++ and Python programs on a Nokia Internet Tablet. The
+ N800 and N810 series are currently supported. Please <A HREF="#How do I set up my tablet for development_|outline">set
+ up your tablet for development</A> first.</SPAN></P>
+ <P STYLE="text-decoration: none">After you create or import a
+ project, you may right-click and invoke <B>Run / Debug As ... >
+ Maemo Remote Application. </B><SPAN STYLE="font-weight: medium">Choose
+ the “</SPAN><B>Copy via RSE</B>” <SPAN STYLE="font-weight: medium">download
+ selection method, and then select the “</SPAN><B>Nokia
+ Internet Tablet</B>” <SPAN STYLE="font-weight: medium">connection.</SPAN></P>
+ <P STYLE="font-weight: medium; text-decoration: none">When this
+ fails, see the next entry.</P>
+ <H3><BR><BR>
+ </H3>
+ </DIV>
+ <DIV ID="networking-issues" DIR="LTR"><A NAME="networking-issues|region"></A>
+ <H3 STYLE="text-decoration: none">How do I resolve networking
+ issues?</H3>
+ <P STYLE="text-decoration: none">Network configurations can be
+ tricky (and doubly, or triply so, if you are running on Windows or
+ OS X). You can expect to become familiar with the “Connection
+ problem” dialog.</P>
+ <P><SPAN STYLE="text-decoration: none">The primary line of defense
+ is to make sure the connection works from the command line and that
+ all the daemons and configurations are set up properly. See
+ <<A HREF="http://maemo.org/development/documentation/pc_connectivity/">http://maemo.org/development/documentation/pc_connectivity/</A>>
+ for details. Also, be sure you understand the utilities provided in
+ the maemo-pc-connectivity project and follow the instructions for
+ configuring various types of networks. See
+ <<A HREF="http://pc-connectivity.garage.maemo.org/">http://pc-connectivity.garage.maemo.org/</A>>
+ for the project page.</SPAN></P>
+ <P STYLE="text-decoration: none">The second line of defense is to
+ understand how ESbox uses Eclipse preferences to influence the
+ network.</P>
+ <P STYLE="text-decoration: none">The <B>Window > Preferences >
+ General > Network Connections </B><SPAN STYLE="font-weight: medium">preference
+ contains the HTTP proxy configuration. This will be used when
+ communicating with apt repositories (when validating packages). If
+ you do use a proxy, be sure your host and your tablet are both
+ referenced in the “No proxy” section. (Note: from my
+ experience, you need to specify exact IP addresses here; wildcards
+ and “slash notation” do not work.)</SPAN></P>
+ <P STYLE="font-weight: medium; text-decoration: none">ESbox will
+ not use a proxy when directly contacting the tablet, since it
+ assumed to be local to the machine.</P>
+ <DIV ID="Section14" DIR="LTR">
+ <H4 STYLE="text-decoration: none">General issues with virtual
+ machines and networking:</H4>
+ <P STYLE="text-decoration: none">For <B>most networking scenarios,
+ </B><SPAN STYLE="font-weight: medium">the tablet must be visible
+ </SPAN><B>to the host</B><SPAN STYLE="font-weight: medium">. In
+ other words, they should be on the same network.</SPAN></P>
+ <P STYLE="text-decoration: none">For <B>SBRSH usage, </B><SPAN STYLE="font-weight: medium">t</SPAN>he
+ tablet <SPAN STYLE="font-weight: medium">must be visible </SPAN><B>to
+ the virtual machine</B><SPAN STYLE="font-weight: medium">, not to
+ the host. This is because sbrsh mounts the filesystem from a
+ scratchbox rootstrap, and sbrsh runs inside the virtual machine.</SPAN></P>
+ <P STYLE="font-weight: medium; text-decoration: none">NOTE: you
+ may be smarter than me and know how to route network traffic
+ between the host and the VM when it uses a private subnet. If so,
+ please share (file a bug or enhancement request against ESbox or
+ the PC connectivity projects in garage.maemo.org).</P>
+ <P STYLE="text-decoration: none"><SPAN STYLE="font-weight: medium">In
+ general, I have the best experience using a LAN on a network
+ common to the host, virtual machine, and device. This requires the
+ </SPAN><B>Bridged Networking </B><SPAN STYLE="font-weight: medium">configuration
+ in VMware.</SPAN></P>
+ </DIV>
+ <DIV ID="Section13" DIR="LTR">
+ <H4 STYLE="text-decoration: none">For USB networking:</H4>
+ <P STYLE="text-decoration: none">By default, a USB connection will
+ <B>mount </B><SPAN STYLE="font-weight: medium">the removable
+ storage from the tablet into your computer. Use the </SPAN><B>Connection
+ Switcher</B> <SPAN STYLE="font-weight: medium">toolbar icon (in
+ newer versions of maemo-pc-connectivity) or the </SPAN><B>USB
+ Networking </B><SPAN STYLE="font-weight: medium">control panel
+ applet (in older versions) to change the USB connection into a
+ networking connection.</SPAN></P>
+ <P STYLE="text-decoration: none">Typically the addresses used are
+ static: <B>192.168.2.15 </B><SPAN STYLE="font-weight: medium">(for
+ the tablet) and </SPAN><B>192.168.2.14 </B><SPAN STYLE="font-weight: medium">(for
+ the host).</SPAN></P>
+ <P STYLE="text-decoration: none"><SPAN STYLE="font-weight: medium">If
+ the command-line connection (verified with “ssh”) does
+ not work, and the tablet is configured for USB networking, use
+ </SPAN>“<B>sudo ifdown usb0; sudo ifup usb0” </B><SPAN STYLE="font-weight: medium">to
+ try to reset. This should fix things.</SPAN></P>
+ <P STYLE="text-decoration: none"><SPAN STYLE="font-weight: medium">In
+ VMware, an icon in the toolbar or the </SPAN><B>VM > Removable
+ Devices > Netchip RNDIS / Ethernet Gadget </B><SPAN STYLE="font-weight: medium">menu
+ will help you quickly “connect” the tablet to the VM
+ or to the host.</SPAN></P>
+ <P STYLE="font-weight: medium; text-decoration: none">QEMU (at
+ this writing) does not support USB at all, so you will probably
+ need to use WLAN.</P>
+ </DIV>
+ <DIV ID="Section12" DIR="LTR">
+ <H4 STYLE="text-decoration: none">For WLAN networking:</H4>
+ <P STYLE="text-decoration: none">The newest <B>maemo-pc-connectivity</B>
+ package will let you use an ad-hoc “devel” network
+ access point.
+ </P>
+ <P STYLE="text-decoration: none">In this network configuration,
+ the addresses are static: <B>192.168.4.15 </B><SPAN STYLE="font-weight: medium">and
+ </SPAN><B>192.168.4.14</B><SPAN STYLE="font-weight: medium">. </SPAN>
+ </P>
+ <P STYLE="font-weight: medium; text-decoration: none">You may also
+ use an external wireless access point. This probably means that
+ the tablet will receive a semirandom IP address from the DHCP
+ server.
+ </P>
+ <P STYLE="font-weight: medium; text-decoration: none">In either
+ case, you will need to verify the address and update the RSE
+ connection:</P>
+ <UL>
+ <LI><P STYLE="text-decoration: none"><SPAN STYLE="font-weight: medium">In
+ the tablet, run </SPAN><B>Utilities > X Terminal</B><SPAN STYLE="font-weight: medium">.</SPAN></P>
+ <LI><P STYLE="text-decoration: none"><SPAN STYLE="font-weight: medium">Execute
+ “</SPAN><B>/sbin/ifconfig</B>” <SPAN STYLE="font-weight: medium">to
+ see what address is assigned to the “</SPAN><B>wlan0</B>”
+ <SPAN STYLE="font-weight: medium">interface.</SPAN></P>
+ <LI><P STYLE="text-decoration: none"><SPAN STYLE="font-weight: medium">Copy
+ this address into the </SPAN><B>Remote Systems </B><SPAN STYLE="font-weight: medium">view
+ under </SPAN><B>Nokia Internet Tablet ></B> <B>Properties >
+ Host</B><SPAN STYLE="font-weight: medium">. </SPAN>
+ </P>
+ </UL>
+ <P STYLE="text-decoration: none"><SPAN STYLE="font-weight: medium">Existing
+ </SPAN><B>Copy via RSE </B><SPAN STYLE="font-weight: medium">launch
+ configurations should continue to work, as well as any wizards or
+ commands that reference the connection by name.</SPAN></P>
+ </DIV>
+ <DIV ID="Section11" DIR="LTR">
+ <H4 STYLE="text-decoration: none">For Bluetooth networking:</H4>
+ <P><SPAN STYLE="text-decoration: none"><I>This is supported, but I
+ personally know little about it :) The documentation on the <A HREF="http://pc-connectivity.garage.maemo.org/">PC
+ connectivity project page</A> should have more details than me.</I></SPAN></P>
+ <P STYLE="text-decoration: none">In this network configuration,
+ the addresses are static: <B>192.168.3.15 </B><SPAN STYLE="font-weight: medium">and
+ </SPAN><B>192.168.3.14</B><SPAN STYLE="font-weight: medium">. </SPAN>
+ </P>
+ <P STYLE="font-weight: medium; text-decoration: none">As with
+ WLAN, the address should be copied into the RSE connection:</P>
+ <UL>
+ <LI><P STYLE="text-decoration: none"><SPAN STYLE="font-weight: medium">In
+ the tablet, run </SPAN><B>Utilities > X Terminal</B><SPAN STYLE="font-weight: medium">.</SPAN></P>
+ <LI><P STYLE="text-decoration: none"><SPAN STYLE="font-weight: medium">Execute
+ “</SPAN><B>/sbin/ifconfig</B>” <SPAN STYLE="font-weight: medium">to
+ see what address is assigned to the “</SPAN><B>bnep0</B>”
+ <SPAN STYLE="font-weight: medium">interface.</SPAN></P>
+ <LI><P STYLE="text-decoration: none"><SPAN STYLE="font-weight: medium">Copy
+ this address into the </SPAN><B>Remote Systems </B><SPAN STYLE="font-weight: medium">view
+ under </SPAN><B>Nokia Internet Tablet ></B> <B>Properties >
+ Host</B><SPAN STYLE="font-weight: medium">. </SPAN>
+ </P>
+ </UL>
+ <P STYLE="text-decoration: none"><SPAN STYLE="font-weight: medium">Existing
+ </SPAN><B>Copy via RSE </B><SPAN STYLE="font-weight: medium">launch
+ configurations should continue to work, as well as any wizards or
+ commands that reference the connection by name.</SPAN></P>
+ </DIV>
+ </DIV>
+</DIV>
+</BODY>
+</HTML>
\ No newline at end of file
More information about the Esbox-commits
mailing list