[Esbox-commits] r1018 - trunk/org.maemo.esbox.help/html/gettingstarted
jeffc at garage.maemo.org
jeffc at garage.maemo.org
Tue Dec 2 06:08:49 EET 2008
Author: jeffc
Date: 2008-12-02 06:08:48 +0200 (Tue, 02 Dec 2008)
New Revision: 1018
Added:
trunk/org.maemo.esbox.help/html/gettingstarted/virtualmachine.html
Modified:
trunk/org.maemo.esbox.help/html/gettingstarted/BasicTutorial.html
trunk/org.maemo.esbox.help/html/gettingstarted/CompilingCMaemoProject.html
trunk/org.maemo.esbox.help/html/gettingstarted/ConfigurationTutorial.html
trunk/org.maemo.esbox.help/html/gettingstarted/CreatingAMaemoProject.html
trunk/org.maemo.esbox.help/html/gettingstarted/CreatingProjectTemplates.html
trunk/org.maemo.esbox.help/html/gettingstarted/CreatingPythonProject.html
trunk/org.maemo.esbox.help/html/gettingstarted/DebuggingCMaemoApplications.html
trunk/org.maemo.esbox.help/html/gettingstarted/DebuggingPythonMaemoApplications.html
trunk/org.maemo.esbox.help/html/gettingstarted/ExternalizeString.html
trunk/org.maemo.esbox.help/html/gettingstarted/Introduction.html
trunk/org.maemo.esbox.help/html/gettingstarted/ProfilingMaemoApplications.html
trunk/org.maemo.esbox.help/html/gettingstarted/RunningCProject.html
trunk/org.maemo.esbox.help/html/gettingstarted/RunningPythonProject.html
trunk/org.maemo.esbox.help/html/gettingstarted/SettingPreferences.html
trunk/org.maemo.esbox.help/html/gettingstarted/SettingsSbrshConfiguration.html
Log:
updated info and screenshots
Modified: trunk/org.maemo.esbox.help/html/gettingstarted/BasicTutorial.html
===================================================================
--- trunk/org.maemo.esbox.help/html/gettingstarted/BasicTutorial.html 2008-12-02 04:07:35 UTC (rev 1017)
+++ trunk/org.maemo.esbox.help/html/gettingstarted/BasicTutorial.html 2008-12-02 04:08:48 UTC (rev 1018)
@@ -10,7 +10,7 @@
<body>
<h2 class="style1">Basic Tutorial</h2>
-<p>Shows step by step how to create a ESbox project.</p>
+<p>Creating a Maemo project</p>
<ul>
<li><strong><a href="CreatingAMaemoProject.html">
@@ -25,13 +25,13 @@
Creating a Python Project
</a></strong></li></ul>
-<p>Now with ESbox project created, Let's compile.</p><ul>
+<p>Compiling Maemo project</p><ul>
<li><strong><a href="CompilingCMaemoProject.html">
Compiling a C/C++ Maemo Project
</a></strong></li></ul>
-<p>Finally, running projects.</p><ul>
+<p>Running projects</p><ul>
<li><a href="RunningCProject.html"><STRONG>
Running C/C++ Maemo Project
@@ -40,7 +40,7 @@
Running Python Maemo Project
</a></strong></li></ul>
-<p>Debugging projects.</p><ul>
+<p>Debugging projects</p><ul>
<li><a href="DebuggingCMaemoApplications.html"><STRONG>
Debugging C/C++ Maemo Project
</STRONG></a></li>
@@ -48,14 +48,14 @@
Debugging Python Maemo Project
</a></strong></li></ul>
-<p>Analysis of Performance.</p><ul>
+<p>Analyzing Performance</p><ul>
<li><strong><a href="ProfilingMaemoApplications.html">
Profiling C/C++ application
</a></strong></li></ul>
-<p>Helping extraction of strings.</p><ul>
+<p>Extracting strings</p><ul>
<li><strong><a href="ExternalizeString.html">
-Externalize string on C/C++ application.
-</a></strong></li></ul>
+Externalize string on C/C++ application</a></strong></li>
+</ul>
</body>
</html>
Modified: trunk/org.maemo.esbox.help/html/gettingstarted/CompilingCMaemoProject.html
===================================================================
--- trunk/org.maemo.esbox.help/html/gettingstarted/CompilingCMaemoProject.html 2008-12-02 04:07:35 UTC (rev 1017)
+++ trunk/org.maemo.esbox.help/html/gettingstarted/CompilingCMaemoProject.html 2008-12-02 04:08:48 UTC (rev 1018)
@@ -11,29 +11,26 @@
<h2 class="style1">Compiling a C/C++ Maemo Project</h2>
-<p>When an Automake C/C++ Maemo Project is created, it is automatically compiled.</p>
-<p>If you created a Makefile C/C++ Maemo Project, you need to provide a makefile.</p>
-
+<p>When an Automake C/C++ Maemo Project is created, it is automatically compiled. If you create a Makefile C/C++ Maemo Project, you need to provide a makefile.</p>
<p>When you build a project, output from make is displayed in the Console view.
Makefile actions are displayed in the Make Targets view.</p>
For more information about creating a make target <a href="../tasks/CreateMakeTarget.html">click here</a>.
-<p></p>
<p>To build your C/C++ Maemo Project:</p>
<ul>
<li> In the Project Explorer or C/C++ view, select a project.</li>
<li> Right click on a project and select Build Application (context menu varies depending upon which view is active)</li>
- <li> Options include generating a configure script, run your configure script (same as ./configure) or build your project.</li>
+ <li> Options include generating a configure script (Generate Configure), run your configure script (Configure) (same as ./configure) or build your project (Build All).</li>
<p></p>
- <img src="../images/build.jpg" alt="build" width="549" height="670">
+ <img src="../images/buildapp.png" alt="build" width="452" height="524">
<p></p>
<li> The screenshot below shows the effect of clicking Build All. The Console view displays the output of the make utility.</li>
<p></p>
- <img src="../images/build1.jpg" alt="build1" width="1036" height="768">
+ <img src="../images/consoleoutput.png" alt="build1" width="693" height="210">
</ul>
<p> </p>
Modified: trunk/org.maemo.esbox.help/html/gettingstarted/ConfigurationTutorial.html
===================================================================
--- trunk/org.maemo.esbox.help/html/gettingstarted/ConfigurationTutorial.html 2008-12-02 04:07:35 UTC (rev 1017)
+++ trunk/org.maemo.esbox.help/html/gettingstarted/ConfigurationTutorial.html 2008-12-02 04:08:48 UTC (rev 1018)
@@ -11,9 +11,7 @@
<body>
-<h3>Project Configuration Tutorial</h3>
-
-<p></p>
+<h2>Project Configuration</h2>
<ul>
<li><strong><a href="SettingPreferences.html">
Setting Preferences
Modified: trunk/org.maemo.esbox.help/html/gettingstarted/CreatingAMaemoProject.html
===================================================================
--- trunk/org.maemo.esbox.help/html/gettingstarted/CreatingAMaemoProject.html 2008-12-02 04:07:35 UTC (rev 1017)
+++ trunk/org.maemo.esbox.help/html/gettingstarted/CreatingAMaemoProject.html 2008-12-02 04:08:48 UTC (rev 1018)
@@ -14,7 +14,7 @@
</head>
<body>
-<h2 class="style1">Creating a new C/C++ Maemo project</h2>
+<h2 class="style1">Creating a C/C++ Maemo project</h2>
<p>The following steps describe how to create a project that contains your source code and related files.
A project has an associated builder that can incrementally compile source
@@ -25,23 +25,21 @@
<p>To create a new C/C++ Maemo project:</p>
<ol>
- <li>Select <strong>File > New > C/C++ Maemo Project</strong> from the main menu bar to open the New Project wizard.</li>
- <p>Depending on which view is currently active, you may have to select <strong>Project...</strong> then expand the <strong>C</strong> folder and select <strong><em>M</em> C/C++ Maemo Project</strong>.</p>
- <p><img src="../images/esbox0.jpg" alt="esbox0" width="600" height="368"></p>
+ <li>Select <strong>File > New > C/C++ Maemo Project</strong> from the main menu bar to open the New Project wizard.
+ <p><img src="../images/newmaemoproject.png" alt="esbox0" width="632" height="179"></p>
+ </li>
<li>In the Template Project Type window, select a project template and click Next. You can choose an empty project in the Simple group. Select a template to display related information in the bottom information box. Check the "Filter templates based on enabled SDKs" box to only display templates based on installed and enabled SDKs. </li>
- <p><img src="../images/esbox1.jpg" alt="esbox1" width="525" height="850"></p>
+ <p><img src="../images/projecttemplate.png" alt="esbox1" width="525" height="726"></p>
<li>In the Project Configuration Dialog, type your project name in the Project name field. You can use the default workspace location to store the new project or uncheck the "Use default location" option to browse to a different folder. Select a build target for the project. To show all installed build targets unrelated to the selected template, uncheck the "Filter build targets based on selected template" option. </li>
- <p><img src="../images/esbox2.jpg" alt="esbox2" width="525" height="556"></p>
+ <p><img src="../images/projconfig.png" alt="esbox2" width="493" height="518"></p>
<li>Click <STRONG>Next</STRONG> to display the Basic Settings dialog.</li>
- <p><img src="../images/esbox3.jpg" alt="esbox3" width="525" height="483"></p>
- <li>Click <STRONG>Finish</STRONG> to create project. If the C/C++ perspective is not currently set as the default, you are prompted to associate the project with the C/C++ perspective. Click Yes.</li>
+ <p><img src="../images/basicsettings.png" alt="esbox3" width="484" height="343"></p>
+ <li>Click <STRONG>Finish</STRONG> to create project. If the C/C++ perspective is not currently set as the default, you are prompted to associate the project with the C/C++ perspective. Click Yes.</li><br \>
- <p><img src="../images/esbox4.jpg" alt="create project" width="524" height="482"></p>
+ <li>The Console output will display information related to the project creation and suggest ways to fix any errors.</li>
- <li>The Console output will display information related to the project creation and suggest ways to fix any errors.</li>
-
- <p><img src="../images/esbox5.jpg" alt="console" width="772" height="251"></p>
+ <p><img src="../images/console.png" alt="console" width="693" height="210"></p>
</ol>
</body>
Modified: trunk/org.maemo.esbox.help/html/gettingstarted/CreatingProjectTemplates.html
===================================================================
--- trunk/org.maemo.esbox.help/html/gettingstarted/CreatingProjectTemplates.html 2008-12-02 04:07:35 UTC (rev 1017)
+++ trunk/org.maemo.esbox.help/html/gettingstarted/CreatingProjectTemplates.html 2008-12-02 04:08:48 UTC (rev 1018)
@@ -14,7 +14,7 @@
</head>
<body>
-<h2 class="style1">Creating a Hello World Application</h2>
+<h2 class="style1">Creating HelloWorld Project from Template</h2>
<p>In this tutorial, you will use the CDT to create a simple 'Hello World' application.
This tutorial describes the process of creating a new C/C++ Maemo project where the
@@ -23,18 +23,18 @@
<p>To create a hello world project:</p>
<ol>
<li>Select <strong>File > New > Project...</strong> from the main menu bar to open the New Project wizard.</li>
- <p><img src="../images/newproject.png" alt="new project" width="667" height="330"></p>
+ <p><img src="../images/newproj.png" alt="new project" width="634" height="175"></p>
<li>In the New Project dialog, select the folder with the name C, click C/C++ Maemo Project and click Next to start the new C/C++ maemo project wizard.</li>
- <p><img src="../images/newproject1.png" alt="new"></p>
+ <p><img src="../images/newproj_selectwiz.png" alt="new" width="525" height="500"></p>
<li>Select the Hello World project and click Next. Additional information for each project template is displayed in the information box. </li>
- <p><img src="../images/newproject2.png" alt="new" width="559" height="718"></p>
+ <p><img src="../images/newproj_template.png" alt="new" width="525" height="726"></p>
<li>In the Project name field, enter a name for the project and select an installed build target.</li>
- <p><img src="../images/newproject3.png" alt="target"></p>
+ <p><img src="../images/newproj_config.png" alt="target" width="503" height="505"></p>
<li>Next, you can specify the basic properties for the new project,
such as your name and version.</li>
- <p><img src="../images/newproject4.png" alt="new" width="559" height="447"></p>
+ <p><img src="../images/newproj_basic.png" alt="new" width="503" height="505"></p>
<li>Click <STRONG>Finish</STRONG>. If the C/C++ perspective is not currently set as the default, you are prompted to display the C/C++ perspective. Click Yes.</li>
</ol>
Modified: trunk/org.maemo.esbox.help/html/gettingstarted/CreatingPythonProject.html
===================================================================
--- trunk/org.maemo.esbox.help/html/gettingstarted/CreatingPythonProject.html 2008-12-02 04:07:35 UTC (rev 1017)
+++ trunk/org.maemo.esbox.help/html/gettingstarted/CreatingPythonProject.html 2008-12-02 04:08:48 UTC (rev 1018)
@@ -21,17 +21,16 @@
<li>Select <strong>File > New > Project...</strong> from the main menu bar to open the New Project wizard.</li>
<li>In the New Project, select the folder with the name Pydev, click Python Maemo Project and click Next to start the project wizard.</li>
<p><img src="../images/newpythonproject.png" alt="python" width="525" height="500"></p>
- <li>On this page, type your project name in the Project name field.</li>
- <li> Choose a python template in Project types.</li>
- <li>Choose a platform target and SDK.</li>
- <p><img src="../images/newpythonproject1.png" alt="python1" width="621" height="532"></p>
- <p> </p>
- <li> Click <STRONG>Next</STRONG> to set basic settings.</li>
- <p> </p>
- <p><img src="../images/newpythonproject2.png" alt="basic" width="621" height="532"></p>
+ <li>On this page, select a project template.</li>
+ <p><img src="../images/newpythonproject1.png" alt="python1" width="525" height="500"></p>
+ <li>Click <STRONG>Next</STRONG> to define project name and build target.</li>
+ <p><img src="../images/newproj_pythonconfig.png" alt="configurations" width="525" height="500"></p>
+ <li>Click <STRONG>Next</STRONG> to set basic settings.
+ <p><img src="../images/newproj_pythonbasic.png" alt="basic" width="525" height="379"></p>
+ </li>
<li> Click <STRONG>Finish</STRONG>.</li>
<li> You are prompted to associate this project with the Pydev perspective. Click Yes, if desired.</li>
- <p><img src="../images/python9.jpg" alt="python9"></p>
+ <p><img src="../images/newproj_pydevperspec.png" alt="python9" width="544" height="192"></p>
</ol>
</body>
Modified: trunk/org.maemo.esbox.help/html/gettingstarted/DebuggingCMaemoApplications.html
===================================================================
--- trunk/org.maemo.esbox.help/html/gettingstarted/DebuggingCMaemoApplications.html 2008-12-02 04:07:35 UTC (rev 1017)
+++ trunk/org.maemo.esbox.help/html/gettingstarted/DebuggingCMaemoApplications.html 2008-12-02 04:08:48 UTC (rev 1018)
@@ -16,54 +16,55 @@
<h2 class="style1">Debugging a C/C++ Maemo Application</h2>
-In oder to debug a C/C++ application, it is necessary that you compile the application using GCC debugger flags (e.g,
--g). If you want to use remote debugging, it is necessary to configure Sbrsh (see <a href="SettingsSbrshConfiguration.html">Setting Sbrsh Configuration</a>) You can also set
-breakpoints in the code. Just right-click on the left-side editor
+To debug a C/C++ application, it is necessary that you compile the application using GCC debugger flags (e.g,
+-g). If you want to use remote debugging, it is necessary to configure Sbrsh (see <a href="SettingsSbrshConfiguration.html">Setting Sbrsh Configuration</a>). You can also set
+breakpoints in the code. Right-click on the left-side editor
margin and add a breakpoint.
-<p><img src="../images/debug9.jpg" width="824" height="526"></p>
+<p><img src="../images/breakpoint.png" width="595" height="531"></p>
<p></p>
-<p>ESbox has 3 different types of debuggers:</p>
+<p>Maemo provides five different types of debuggers:</p>
<ul>
- <li>ESbox GDB Debugger</li>
- <li>ESbox
+ <li>gdb/mi</li>
+ <li>gdb Debugger</li>
+ <li>gdbserver Debugger</li>
+ <li>Maemo
gdbserver Debugger on Device</li>
- <li>ESbox gdbserver Local Debugger</li>
+ <li>Maemo gdbserver Local Debugger</li>
</ul>
+<p>Select <strong>Run > Run Configurations...</strong> or <strong>Run > Debug Configurations...</strong> and select the Debugger tab for a local or remote run or debug configuration you have created.</p>
+<p><img src="../images/debuggertab.png" alt="Debug tab" width="630" height="373"></p>
<p> </p>
-<p>Select <strong>Run > Open Run Dialog...</strong> or <strong>Run > Open Debug Dialog...</strong> and select the Debugger tab for a local or remote run or debug configuration you have created.</p>
-<p><img src="../images/pref_images/debugtab_maintab.png" alt="Debug tab" width="642" height="452"></p>
-<p> </p>
<p>The debugger types are selected from a dropdown list in the Debugger tab of the Run or Debug dialog.</p>
-<p> </p>
-<p><img src="../images/pref_images/debugtab_debuggerlist.png" alt="debuggers" width="651" height="415"></p>
-<p> </p>
-<p> ESbox
- GDB Debugger is designed to be used in Scratchbox targets that use
- compilers for X86 architecture.</p>
-<p>ESbox gdbserver Debugger
+<p><img src="../images/debuggers.png" alt="debuggers" width="518" height="109"></p>
+<p> GDB Debugger is designed to be used in Scratchbox targets that use
+ compilers for the X86 architecture.</p>
+<p>Maemo gdbserver Debugger
on Device is used to debug applications that are running on the Internet
Tablet.</p>
-<p>ESbox gdbserver Local Debugger is designed to be used in Scratchbox targets that use
+<p>Maemo gdbserver Local Debugger is designed to be used in Scratchbox targets that use
compilers for the ARM architecture.</p>
<p>To debug your C/C++ Maemo Project:</p>
<ul><li>In the C/C++ Projects view, select a project.</li>
<li>Right click on the application and select <strong>Debug As > Maemo Local Application</strong>.</li>
<p></p>
- <p><img src="../images/debug10.jpg" width="743" height="721"><br>
+ <p><img src="../images/debuglocalapp.png" width="678" height="606"><br>
</p>
<p></p>
+ <li>If Maemo is not running, you will be prompted to launch it. Click Yes to launch Maemo.</li>
+ <li>If a breakpoint is set in your source code, you will also be prompted to open the Debug Perspective.</li>
<li>The Debug perspective is opened and various information about your application is shown: memory map, registers,
variables, etc. The programmer can also follow the control flow of the
application.</li>
<p></p>
- <p><img src="../images/debug5.jpg" width="1036" height="768"></p>
-
+ <p><img src="../images/debugperspec.png" width="968" height="673"></p>
</ul>
<p> </p>
<h3>Related Topic</h3>
-<p><a href="../concepts/RemoteDebugging.html">Remote Debugging</a> </p>
+<ul>
+ <li><a href="../concepts/RemoteDebugging.html">Remote Debugging</a></li>
+</ul>
</body>
</html>
Modified: trunk/org.maemo.esbox.help/html/gettingstarted/DebuggingPythonMaemoApplications.html
===================================================================
--- trunk/org.maemo.esbox.help/html/gettingstarted/DebuggingPythonMaemoApplications.html 2008-12-02 04:07:35 UTC (rev 1017)
+++ trunk/org.maemo.esbox.help/html/gettingstarted/DebuggingPythonMaemoApplications.html 2008-12-02 04:08:48 UTC (rev 1018)
@@ -36,25 +36,27 @@
<br>
-<img src="../images/debug7.jpg" width="1024" height="560"></p>
+<img src="../images/setbreakpoint.png" width="578" height="672"></p>
<p></p>
<p>To debug:</p>
-<ul>
- <p></p>
+<ul><li> In the Pydev Package Explorer view, select a project.</li>
+ <li> Right click on the python script and select <strong>Debug As > Python Maemo Local Application.</strong></li>
- <li> In the Pydev Package Explorer view, select a project.</li>
- <li> Right click on the python script and select <strong>Debug As > Python Maemo Local Application </strong>or select <strong>Python Maemo Remote Application</strong>; as appropriate.</li>
-
- <p><img src="../images/debug8.jpg" width="799" height="709"></p>
+ <p><img src="../images/debugpythonlocal.png" width="716" height="442"></p>
<p> </p>
- <li> The Debug perspective is opened and various information about your application is shown: variables, breakpoints, etc. The programmer can also follow the control flow of the application.</li>
- <p><img src="../images/debug6.jpg"></p>
+ <li>If Maemo is not running, you will be prompted to launch it. Click Yes to launch Maemo.</li>
+ <li>If a breakpoint is set in your source code, you will also be prompted to open the Debug Perspective.</li>
+ <li>The Debug perspective is opened and various information about your application is shown: variables, breakpoints, etc. The programmer can also follow the control flow of the application. Click Resume button (or F8) to continue with application execution.</li>
+ <p><img src="../images/debug_python.png" width="968" height="673"></p>
+ <li>If you receive errors and Debug perspective is not opened, make sure that the Python interpreter is defined in the preferences setting. Select <strong>Window > Preferences > Pydev > Interpreter - Python</strong> to define the location of the Python Interpreters.</li>
+ <p align="left"><img src="../images/pref_pythonint.png" alt="python interpreter" width="693" height="726"></p>
</ul>
- <h3>Related Topics</h3>
- <p><a href="SettingsSbrshConfiguration.html">Setting Sbrsh Preferences</a></p>
- <p><a href="SettingPreferences.html">Setting Preferences</a> </p>
- <p> </p>
+<h3>Related Topics</h3>
+ <ul>
+ <li><a href="SettingsSbrshConfiguration.html">Setting Sbrsh Preferences</a></li>
+ <li><a href="SettingPreferences.html">Setting Preferences</a></li>
+</ul>
</body>
</html>
Modified: trunk/org.maemo.esbox.help/html/gettingstarted/ExternalizeString.html
===================================================================
--- trunk/org.maemo.esbox.help/html/gettingstarted/ExternalizeString.html 2008-12-02 04:07:35 UTC (rev 1017)
+++ trunk/org.maemo.esbox.help/html/gettingstarted/ExternalizeString.html 2008-12-02 04:08:48 UTC (rev 1018)
@@ -18,26 +18,25 @@
<p>The Externalize Strings wizard allows you to refactor a compilation unit
-such that strings used in the compilation unit can be translated to different languages.
-</p>
+such that strings used in the compilation unit can be translated to different languages.</p>
<p>To externalize strings:</p>
<ol>
- <li>Select a project and right-click to display the popup menu and select <strong>Source > Externalize String</strong>.</li>
- <p><img src="../images/externalize01.jpg" alt="Externalize String"></p>
- <li>Select the file that should be externalized.</li>
- <p><img src="../images/externalize02.jpg" alt="File that should be externalized"></p>
- <li>A Wizard will appear showing strings that will be externalized. You can define the name of the output file, msgstr, and msgid.</li>
- <p><img src="../images/externalize03.jpg" alt="Externalize Wizard"></p>
+ <li>Select a project in Project Explorer and right-click to display the popup menu and select <strong>Source > Externalize Strings</strong>.</li>
+ <p><img src="../images/extractstrings.png" alt="Externalize String" width="430" height="459"></p>
+ <li>Select the file(s) that should be externalized to enable the Externalize button, then click Externalize.</li>
+ <p><img src="../images/extractstrings1.png" alt="File that should be externalized" width="400" height="500"></p>
+ <li>A Wizard will appear showing strings that will be externalized. You can define the name of the output file, msgstr, and msgid. Click on a message string or message id to make a change.</li>
+ <p><img src="../images/extractstrings2.png" alt="Externalize Wizard" width="719" height="726"></p>
<li>Click Finish.</li>
</ol>
-<p>A couple of files will be generated (<strong>POTFILE.in</strong> and <strong>outputName.po</strong>) which will be placed in the <strong>YourProject/po/</strong> directory.</p>
+<p>A couple of files will be generated (<strong>POTFILE.in</strong> and <strong>outputName.po</strong>) which will be placed in the <strong><em>ProjectName</em>/po/</strong> directory.</p>
<ul>
<li>POTFILES.in contains the list of source code files that will be localized.</li>
- <li> outputName.po includes translated text.</li>
+ <li> <em>outputName</em>.po includes translated text.</li>
</ul>
-<p>The Console view may output some warnings which usually are not serious, but should be checked.</p>
+<p>The Console view will output warnings and errors.</p>
<p><b>For example:</b></p>
<p>In your source code, you probably have many strings, which eventually are shown in the user interface. For example:</p>
Modified: trunk/org.maemo.esbox.help/html/gettingstarted/Introduction.html
===================================================================
--- trunk/org.maemo.esbox.help/html/gettingstarted/Introduction.html 2008-12-02 04:07:35 UTC (rev 1017)
+++ trunk/org.maemo.esbox.help/html/gettingstarted/Introduction.html 2008-12-02 04:08:48 UTC (rev 1018)
@@ -26,7 +26,7 @@
<h4 align="left" class="style1">Target</h4>
<ul>
<p>
- The active toolchain and configuration currently used. A target uses a selected toolchain and contains a filesystem to use, and a related configuration. You can have multiple targets, even if they all use the same toolchains. This makes it easy to try something different, or start a parallel target to test things from scratch. Examples of targets are CHINOOK_ARMEL and CHINOOK_X86.</p>
+ The active toolchain and configuration currently used. A target uses a selected toolchain and contains a filesystem to use, and a related configuration. You can have multiple targets, even if they all use the same toolchains. This makes it easy to try something different, or start a parallel target to test things from scratch. Examples of targets are DIABLO_ARMEL and DIABLO_X86.</p>
</ul>
<h4 align="left" class="style1">Platform</h4>
@@ -41,7 +41,6 @@
</ul>
<h4 align="left" class="style1">SDK</h4>
-<ul>
<p>
SDK is typically a set of development tools that allows a software engineer
to create applications for a specific software framework or something similar.
@@ -53,18 +52,13 @@
<ul>
<li>Latest stable: maemo 4.0.1 Chinook</li>
</ul>
-</p>
<p>
OS2007 for N800 developers
<ul>
<li>Latest stable: maemo 3.x Bora</li>
</ul>
-</p>
-<p>Nokia 770 developers
-<ul>
+<p>Nokia 770 developers<ul>
<li>Latest: maemo 2.2 Gregale</li>
</ul>
-</p>
-
</body>
</html>
\ No newline at end of file
Modified: trunk/org.maemo.esbox.help/html/gettingstarted/ProfilingMaemoApplications.html
===================================================================
--- trunk/org.maemo.esbox.help/html/gettingstarted/ProfilingMaemoApplications.html 2008-12-02 04:07:35 UTC (rev 1017)
+++ trunk/org.maemo.esbox.help/html/gettingstarted/ProfilingMaemoApplications.html 2008-12-02 04:08:48 UTC (rev 1018)
@@ -31,20 +31,18 @@
select an X86 Scratchbox target with the tool properly installed.</p>
<p>To run Valgrind, right-click on the application (binary for C/C++
-projects or the Python script for Python projects) and select <strong>Run As > Valgrind Memory Profiler</strong>.</p>
+projects or the Python script for Python projects) and select <strong>Run As > Local Valgrind Memory Profiler</strong>.<br>
<br>
-<br>
-<img src="../images/profiling0.jpg" width="789" height="743"><br>
+<img src="../images/valgrind.png" width="509" height="428"><br>
</h2>
-<p> </p>
+</p>
<p>The Valgrind tool runs your application on the X86 target and the result is
shown in the Valgrind view. All problems found by Valgrind are shown as a
tree: problem as parent nodes and details of the problems as children
nodes.</p>
+<p><img src="../images/profiling1.jpg"><br>
+</p>
<p> </p>
-<img src="../images/profiling1.jpg"><br>
-
-<p> </p>
<h3>Using OProfile</h3>
<p>OProfile is a system-wide profiler for Linux systems and
can profile all running code. It consists of a kernel driver and a daemon for collecting sample data,
@@ -62,10 +60,6 @@
configuration for Oprofile yourself, please see
<a href="../tasks/CreateOprofileconfig.html">Creating a OProfile Run Launch Configuration</a>.</p>
-<br>
-<img src="../images/profiling6.jpg" width="764" height="633">
-<br>
-<p> </p>
<p>After OProfile starts, ESbox launches your application on the device.
Then a dialog will pop up letting you decide when to stop profiling data collecting.
After you click OK on the dialog, OProfile data collecting will
Modified: trunk/org.maemo.esbox.help/html/gettingstarted/RunningCProject.html
===================================================================
--- trunk/org.maemo.esbox.help/html/gettingstarted/RunningCProject.html 2008-12-02 04:07:35 UTC (rev 1017)
+++ trunk/org.maemo.esbox.help/html/gettingstarted/RunningCProject.html 2008-12-02 04:08:48 UTC (rev 1018)
@@ -26,12 +26,12 @@
<ol>
- <li> In the C/C++ Maemo Projects view, select a project.</li>
- <li> Click <strong>Run As > Open Run Dialog</strong>.</li>
- <li> In the Configurations box, select Maemo Local Application or Maemo Remote Application.</li>
+ <li> In the C/C++ perspective, select a project.</li>
+ <li> Click <strong>Run As > Run Configurations...</strong></li>
+ <li> Select Maemo Local Application or Maemo Remote Application.</li>
<li> <img src="../images/pref_images/new.png" alt="new" width="18" height="18">Click the New button. The name of the new project is displayed in the Configurations box located on the leftside of window. The default name is the name of the project.</li>
<li> Click the Main tab.</li>
- <p><img src="../images/run_main.png" alt="Main" width="855" height="640"></p>
+ <p><img src="../images/run_main.png" alt="Main" width="844" height="559"></p>
<li>Do the following:
<ul>
<li>In the Name box, type a descriptive name for this launch configuration.</li>
@@ -41,9 +41,9 @@
</li>
<p>Make sure that the right target has been chosen.</p>
- <li>Select the project in Project Explorer, right-click and select <strong>Properties. </strong>Then select <strong>ESbox Build Target</strong>.</li>
+ <li>Select the project in Project Explorer, right-click and select <strong>Properties. </strong>Then select <strong>Maemo Build ConfigurationsTarget</strong>.</li>
<li>Select the correct build target for this project, which is used to cross-compile and run your application.</li>
- <p><img src="../images/pref_images/installed_targets.png" alt="targets" width="772" height="558"></p>
+ <p><img src="../images/maemobuildconfigs.png" alt="targets" width="822" height="574"></p>
<p>For more information about targets <a href="../tasks/CreateNewTarget.html">click here</a>.</p>
@@ -51,12 +51,12 @@
<li>Click on Maemo (M) button.</li>
</ol>
-<p>Now with everything set up, select <strong>Run as > Maemo Local Application</strong> or <strong>Maemo Remote Application</strong>; as appropriate.</p>
+<p>Now with everything set up, select the project, right-click and select <strong>Run as > Maemo Local Application</strong>.</p>
-<p><img src="../images/run1.jpg" alt="run2" width="782" height="701"></p>
-<p> </p>
<h3>Related Topics</h3>
-<p><a href="SettingsSbrshConfiguration.html">Setting Sbrsh Preferences</a></p>
-<p><a href="DebuggingCMaemoApplications.html">Debugging a C/C++ Maemo Project</a></p>
+<ul>
+ <li><a href="SettingsSbrshConfiguration.html">Setting Sbrsh Preferences</a></li>
+ <li><a href="DebuggingCMaemoApplications.html">Debugging a C/C++ Maemo Project</a></li>
+</ul>
</body>
</html>
Modified: trunk/org.maemo.esbox.help/html/gettingstarted/RunningPythonProject.html
===================================================================
--- trunk/org.maemo.esbox.help/html/gettingstarted/RunningPythonProject.html 2008-12-02 04:07:35 UTC (rev 1017)
+++ trunk/org.maemo.esbox.help/html/gettingstarted/RunningPythonProject.html 2008-12-02 04:08:48 UTC (rev 1018)
@@ -36,18 +36,18 @@
<li>Click on Maemo (M) button.</li>
- <li>In the Pydev Projects view, select a project.</li>
- <li>Select <strong>Run As > Python Maemo Local Application</strong> or <strong>Run As > Python Maemo Remote Application</strong>; as desired.</li>
- <p><img src="../images/python3.jpg" alt="python3" width="798" height="687"></p>
+ <li>In the Pydev Projects view, select a project script file.</li>
+ <li>Right-click and select <strong>Run As > Python Maemo Local Application</strong> or <strong>Run As > Python Maemo Remote Application</strong>; as appropriate.</li>
+ <p><img src="../images/runpython.png" alt="python3" width="760" height="672"></p>
</ol>
+<p> </p>
<p><span style="font-weight: bold;">NOTE</span>: You can only run files that are in your project.</p>
-
<p>After the first run, if you select Ctrl+F11, the last file ran is re-run.</p>
-<p> </p>
<h3>Related Topics</h3>
-<p><a href="SettingsSbrshConfiguration.html">Setting Sbrsh Preferences</a></p>
-<p><a href="SettingPreferences.html">Setting Preferences</a> </p>
-<p> </p>
+<ul>
+ <li><a href="SettingsSbrshConfiguration.html">Setting Sbrsh Preferences</a></li>
+ <li><a href="SettingPreferences.html">Setting Preferences</a></li>
+</ul>
</body>
</html>
Modified: trunk/org.maemo.esbox.help/html/gettingstarted/SettingPreferences.html
===================================================================
--- trunk/org.maemo.esbox.help/html/gettingstarted/SettingPreferences.html 2008-12-02 04:07:35 UTC (rev 1017)
+++ trunk/org.maemo.esbox.help/html/gettingstarted/SettingPreferences.html 2008-12-02 04:08:48 UTC (rev 1018)
@@ -15,69 +15,56 @@
<body>
-<h1 class="style1">Setting Preferences</h1>
+<h1>Setting Preferences</h1>
<p>
The first thing a user should do is set the preferences for using Scratchbox, since the rest
of the functionality of the plug-ins depends on these settings. Once the Eclipse IDE is
-running with the plug-ins, the preferences may be set by selecting <strong>Window > Preferences...</strong> and expanding the ESbox group.</p>
+running with the plug-ins, the preferences may be set by selecting <strong>Window > Preferences...</strong> and expanding the Maemo group.</p>
<p>
-The ESbox page allows you to define the syntax used to invoke commands inside Scratchbox (this varies between Scratchbox versions) and the root directory of
+The Maemo page allows you to define the syntax used to invoke commands inside Scratchbox (this varies between Scratchbox versions) and the root directory of
the user's sandbox environment.</p>
<p></p>
-<img src="../images/preferences.jpg" alt="preferences1" width="900" height="558"><br>
+<img src="../images/pref_images/maemo_pref.png" alt="preferences1" width="892" height="477"><br>
<br>
<p> </p>
<h2><a name="env"></a>Environment</h2>
-<p>The <strong>Environment</strong> page allows you to define Scratchbox environment variables. Click the New button to specify the variable Name and Value. Inside that dialog you can click Variables to select from a list of build variables. </p>
+<p>The <strong>Environment</strong> page allows you to define Scratchbox environment variables. Click the New button to specify the variable Name and Value.</p>
+<p><img src="../images/pref_images/pref_maemo_env.png" alt="environment" width="804" height="495"></p>
<p> </p>
-<p><img src="../images/pref_images/env.png" alt="environment" width="736" height="558"></p>
-<p><img src="../images/variables.png" alt="variables" width="392" height="601"></p>
-<p> </p>
-<p> </p>
-<h2><a name="gaz"></a>Gazpacho</h2>
-<p>The <strong>Gazpacho</strong> page gets its name from the common graphical user interface editor Gazpacho. Gazpacho
- is an advanced gui editor. You can specify to "Use xhost command to start Gazpacho in Maemo" and enter a command for starting Xhost.</p>
-<p></p>
-<p><img src="../images/pref_images/gazpacho.png" alt="Gazpacho" width="737" height="559"><br>
- <br>
-</p>
<h2><a name="int"></a>Installed Targets</h2>
<p>The Installed Targets page allows you to add or remove scratchbox targets. Click New to launch a wizard that guides you through the steps to add a target.</p>
-<p><strong>CAUTION:</strong> If you select an existing target and click <strong>Remove</strong>, the complete installation of the SDK will be removed from your filesystem.</p>
+<p><strong>CAUTION:</strong> If you select an existing target and click <strong>Remove</strong>, the complete installation of the SDK will be removed from your filesystem!</p>
+<p><img src="../images/pref_images/targets.png" alt="installed targets" width="692" height="492"></p>
<p> </p>
-<p><img src="../images/pref_images/targets.png" alt="installed targets" width="690" height="558"></p>
-<p> </p>
<blockquote>
<h3><a name="newtarget"></a>Creating a New Target</h3>
- <p>Click the <strong>New</strong> button to launch a wizard for creating a new target. If both scratchbox1 and scratchbox2 are installed, then a dialog will appear requesting you to choose which version of scratchbox to use for the new target. </p>
- <p><img src="../images/pref_images/new_target.png" alt="define target" width="542" height="185"></p>
- <h4> </h4>
+ <p>Click the <strong>New</strong> button to launch a wizard for creating a new target. If both scratchbox1 and scratchbox2 are installed, then a dialog will appear requesting you to choose which version of scratchbox to use for the new target.</p>
<h4>Scratchbox 1 Wizard</h4>
<p>If you choose scratchbox 1, the following wizard dialogs will appear.</p>
<p>Enter a name for the new target and select Next. </p>
- <p><img src="../images/pref_images/new_target_sb1_1.png" alt="target name" width="480" height="421"></p>
+ <p><img src="../images/pref_images/new_target_sb1_1.png" alt="target name" width="512" height="448"></p>
<p> </p>
<p>Select a compiler for the new target and select Next. </p>
- <p><img src="../images/pref_images/new_target_sb1_2.png" alt="compiler" width="480" height="421"></p>
+ <p><img src="../images/pref_images/new_target_sb1_2.png" alt="compiler" width="512" height="448"></p>
<p> </p>
<p>Select a devkit and click Next. </p>
- <p><img src="../images/pref_images/new_target_sb1_3.png" alt="Devkit" width="480" height="421"></p>
+ <p><img src="../images/pref_images/new_target_sb1_3.png" alt="Devkit" width="512" height="448"></p>
<p> </p>
<p>Select a CPU-transparency method and click Next.</p>
- <p>The recommended setting for the CPU transparency method is "qemu-arm-0.8.2-sb2". The sbrsh method should be manually configured to take advantage of sshfs.More information is located at: http://maemo-sdk.garage.maemo.org/sbrsh-sshfs.html.</p>
- <p><img src="../images/pref_images/new_target_sb1_4.png" alt="cpu" width="480" height="421"></p>
+ <p>The recommended setting for the CPU transparency method is "qemu-arm-0.8.2-sb2". The sbrsh method should be manually configured to take advantage of sshfs. More information is located at: http://maemo-sdk.garage.maemo.org/sbrsh-sshfs.html.</p>
+ <p><img src="../images/pref_images/new_target_sb1_4.png" alt="cpu" width="512" height="448"></p>
<p> </p>
<p>If <strong>sbrsh</strong> is selected in the CPU-transparency method dialog, additional dialogs are provided to enter the target and host addresses.</p>
<p>Enter the Target Device Address. </p>
- <p><img src="../images/pref_images/new_target_sb1_5.png" alt="target address" width="529" height="421"></p>
+ <p><img src="../images/pref_images/new_target_sb1_5.png" alt="target address" width="512" height="448"></p>
<p> </p>
<p>Enter the hostname or ip address and click Finish. </p>
- <p><img src="../images/pref_images/new_target_sb1_6.png" alt="hostname" width="529" height="421"></p>
+ <p><img src="../images/pref_images/new_target_sb1_6.png" alt="hostname" width="512" height="448"></p>
<p> </p>
<h4>Scratchbox 2 Wizard </h4>
<p>If you choose scratchbox 2 for a new target, the following wizard dialogs will appear.</p>
@@ -96,29 +83,25 @@
<p> </p>
<p>Select a CPU-transparency method and click Next. </p>
<p><img src="../images/pref_images/new_target_sb2_4.png" alt="sb4" width="550" height="433"></p>
- <p> </p>
<p>If <strong>sbrsh</strong> is selected in the CPU-transparency method dialog, additional dialogs are provided to enter the target and host addresses.</p>
<p>Enter the Target Device Address.</p>
- <p><img src="../images/pref_images/new_target_sb1_5.png" alt="target address" width="529" height="421"></p>
+ <p>Enter the hostname or ip address and click Finish.</p>
<p> </p>
- <p>Enter the hostname or ip address and click Finish. </p>
- <p><img src="../images/pref_images/new_target_sb1_6.png" alt="hostname" width="529" height="421"></p>
- <p> </p>
</blockquote>
<h2><a name="sbox1"></a>Scratchbox 1</h2>
<p>Define your sandbox root directory and command template for Scratchbox 1. </p>
-<p><img src="../images/pref_images/sbox1.png" alt="sbox1" width="832" height="472"></p>
+<p><img src="../images/pref_images/sbox1.png" alt="sbox1" width="1012" height="475"></p>
<p> </p>
<h2><a name="sbox2"></a>Scratchbox 2</h2>
<p>Define your mapping mode, level of messages that you want logged, and command template for Scratchbox 2.</p>
-<p><img src="../images/pref_images/sbox2.png" alt="sbox2" width="832" height="472"></p>
+<p><img src="../images/pref_images/sbox2.png" alt="sbox2" width="912" height="563"></p>
<p> </p>
<h2><a name="ssh"></a>SSH</h2>
<p>Use the SSH page to configure secure shell settings for communicating with a device.</p>
-<p><img src="../images/pref_images/ssh.png" alt="ssh" width="864" height="473"></p>
+<p><img src="../images/pref_images/ssh.png" alt="ssh" width="922" height="575"></p>
<p> </p>
<h2><a name="xsr"></a>X Server</h2>
<p>The X Server page contains commands for starting the X Server.</p>
-<p><img src="../images/pref_images/xserver.png" alt="xserver" width="996" height="473"></p>
+<p><img src="../images/pref_images/xserver.png" alt="xserver" width="930" height="472"></p>
</body>
</html>
Modified: trunk/org.maemo.esbox.help/html/gettingstarted/SettingsSbrshConfiguration.html
===================================================================
--- trunk/org.maemo.esbox.help/html/gettingstarted/SettingsSbrshConfiguration.html 2008-12-02 04:07:35 UTC (rev 1017)
+++ trunk/org.maemo.esbox.help/html/gettingstarted/SettingsSbrshConfiguration.html 2008-12-02 04:08:48 UTC (rev 1018)
@@ -16,14 +16,13 @@
<body>
-<h2 class="style1">Setting Sbrsh preferences</h2>
+<h2 class="style1">Setting Sbrsh Preferences</h2>
<p>To use Sbrsh (Scratchbox Remote Shell) to run or debug a C/C++ or Python Maemo application remotely on a device, sbrsh settings can be configured in a new Run or Debug remote launch configuration.
-Select a project in the Project Explorer and select <strong>Run > Open Run Dialog... </strong>or<strong> Run > Open Debug Dialog... </strong> to display the Run or Debug configuration page. Create a new or select an existing Maemo Remote Application then select the Download tab. Select Mount via SBRSH in the Download Method dropdown list.</p>
-<p> </p>
-<h3>SBRSH Client Configuration Method: Automatic (screenshot from Python related project) </h3>
-<p><img src="../images/pref_images/sbrsh_download.png" alt="sbrsh download" width="871" height="616"><br>
+Select a project in the Project Explorer and select <strong>Run > Run Configurations... </strong>or<strong> Run > Debug Configurations... </strong> to display the Run or Debug configuration page. Create a new or select an existing Maemo Remote Application then select the Download tab. Select Mount via SBRSH in the Download Method dropdown list.</p>
+<h3>SBRSH Client Configuration Method: Automatic</h3>
+<p><img src="../images/pref_images/sbrsh_download.png" alt="sbrsh download" width="969" height="482"><br>
<br>
</p>
<table width="770" border="1" cellspacing="3" cellpadding="3">
@@ -39,11 +38,11 @@
<td>SBRSH configuration file and mount points are automatically created. The configuration file is created under the current project folder for each launch configuration associated with the project. The mount point is the path where the binaries will be copied and executed. Sbrsh mounts the mount point. The mount point (target binary path) will be determined by checking which SBRSH mount for the current SBRSH target has the host folder that contains the debugged program. The debugger will invoke the sbrsh command to launch the application or gdbserver on the device.</td>
</tr>
<tr>
- <td>Host PC Name or IP:</td>
+ <td>Host address:</td>
<td>Enter name or IP address of the host PC connecting the host and the device (where the physical connection may be USB, Bluetooth or IR). Default IP address is 192.168.2.14. Note that a name entered should be resolvable in the /etc/hosts file on the device.</td>
</tr>
<tr>
- <td>Target Device Name or IP:</td>
+ <td>Target address:</td>
<td>Enter name or IP address of target device. Default value is 192.168.2.15. Note that a name entered should be resolvable in the /etc/hosts file on the host.</td>
</tr>
<tr>
@@ -51,11 +50,11 @@
<td>This button allows you to view the content of the auto-generated SBRSH configuration file when a valid host name/IP and target name/IP are entered. The default location of the sbrsh configuration file is in /home/<em>USER</em>/.sbrsh) and the sbrsh executable file is assumed to be in /usr/bin/sbrsh or /home/USER/sbrsh.</td>
</tr>
</table>
-<p><img src="../images/pref_images/sbrsh_viewer.png" alt="viewer" width="537" height="550"></p>
+<p><img src="../images/pref_images/sbrsh_viewer.png" alt="viewer" width="539" height="532"></p>
<p> </p>
<p> </p>
<h3>SBRSH Client Configuration Method: Custom (screenshot from C/C++ related project) </h3>
-<p><img src="../images/pref_images/sbrsh_download_custom.png" alt="sbrsh custom" width="680" height="472"></p>
+<p><img src="../images/pref_images/sbrsh_download_custom.png" alt="sbrsh custom" width="646" height="317"></p>
<p> </p>
<table width="770" border="1" cellspacing="3" cellpadding="3">
<caption>
@@ -87,6 +86,6 @@
</tr>
</table>
<p> </p>
-<p><img src="../images/pref_images/sbrsh_edit.png" alt="edit dialog" width="732" height="772"></p>
+<p><img src="../images/pref_images/sbrsh_edit.png" alt="edit dialog" width="738" height="754"></p>
</body>
</html>
Added: trunk/org.maemo.esbox.help/html/gettingstarted/virtualmachine.html
===================================================================
--- trunk/org.maemo.esbox.help/html/gettingstarted/virtualmachine.html (rev 0)
+++ trunk/org.maemo.esbox.help/html/gettingstarted/virtualmachine.html 2008-12-02 04:08:48 UTC (rev 1018)
@@ -0,0 +1,74 @@
+<!DOCTYPE HTML PUBLIC "-//W3C//DTD HTML 4.01 Transitional//EN"
+"http://www.w3.org/TR/html4/loose.dtd">
+<html>
+<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>Running ESbox on other operating systems</title>
+ <link rel="stylesheet" type="text/css" href="../help.css">
+</head>
+
+<body>
+<h2>Running ESbox on other operating systems</h2>
+<h3>Overview</h3>
+<P>The maemo SDK, scratchbox, and rootstraps only work on Linux/x86. If you want to use ESbox in Windows, or Linux/x86-64, then you can do this by hooking up ESbox with an appropriately configured virtual machine.</P>
+<P>ESbox exposes the concept of "Build Machines". For Linux/x86 hosts, the host serves as a build machine. For other hosts, only a virtual machine can be a build machine.</P>
+<P>ESbox will use an SSH connection with the virtual machine to perform builds, launch/debug applications, and configure sb1/sb2 rootstraps.</P>
+<P>Projects in Eclipse must be visible to both the host and the virtual machine (VM). This requires some folders to be shared between them.</P>
+<h3>Virtual machine configuration </h3>
+<P>The plan is to support VMware, QEMU, and VirtualBox. VMware is recommended for speed. QEMU is recommended for freedom and ease of setup. VirtualBox is allowed but not directly supported since it does not appear to allow sharing virtual machine iamges.</P>
+<P>The maemo VMware image project (<A
+href="http://maemosdk.garage.maemo.org">http://maemosdk.garage.maemo.org</A>) will release a new edition (after v0.9) which provides an image optimized for maemo SDK building and application launching. It will not include a GUI or other end-user applications but will be minimally configured for ESbox.</P>
+<P>The amount of setup needed for a VM to work properly is not trivial, but a stock image should work as long as it has SSH and Samba support. For SSH the "UseDNS" flag should be turned off, and to support Samba, you need an often-running cron job to resynchronize the clock with the host, to avoid timestamp issues when building.</P>
+<h3>Windows configuration </h3>
+<UL>
+ <LI>VMware Player, Server, and Workstation are supported (tested with version 6) </LI>
+</UL>
+<UL>
+ <LI>QEMU is supported. Tested with QEMU 0.9.1-windows (<A
+href="http://www1.interq.or.jp/t-takeda/qemu/qemu-0.9.1-windows.zip">http://www1.interq.or.jp/t-takeda/qemu/qemu-0.9.1-windows.zip</A>) and the acceleration module KQemu-1.3.0pre11-install.exe (<A
+href="http://www.h6.dion.ne.jp/~kazuw/qemu-win/Kqemu-1.3.0pre11-install.exe">http://www.h6.dion.ne.jp/~kazuw/qemu-win/Kqemu-1.3.0pre11-install.exe</A>). </LI>
+</UL>
+<UL>
+ <LI>An X server is needed to launch the Maemo emulator. The default settings assume you've installed Cygwin/X, with Cygwin at c:\cygwin. Edit ESbox > X Server preferences to configure. </LI>
+</UL>
+<h3>ESbox (virtual) machine configuration </h3>
+<UL>
+ <LI>Configuration is under ESbox > Build Machines. If you navigate here before configuring anything, or try to create a project and launch first, you need to select either VMware or QEMU as a virtual machine and adjust the configuration accordingly.</LI>
+</UL>
+<P>The Machine Access and Shared Folder settings should be optimally configured for QEMU already, but you may need to edit these depending on your configuration, especially in VMware where the network settings must be manually configured. </P>
+<UL>
+ <LI>Use the "Apply and Validate" button to run through a series of tests to validate that the machine is configured properly.</LI>
+</UL>
+<h3>ESbox Machine Access </h3>
+<P>The Machine Access tab allows you to configure the networking and authentication with the VM. </P>
+<P><EM>User</EM> is the account which acts as the agent for all operations with the VM. This must have passwordless "sudo" access. </P>
+<P><EM>Password</EM> is the account for the user account. <STRONG>NOTE</STRONG>: the password is saved in preferences but in an encrypted form, but, due to current design quirks, this password can still show up in <EM>plaintext</EM> in SSH filesystem URIs. </P>
+<P><EM>Target address</EM> is the address used to access the VM. This may be an IP address or a name. You will probably need to discover this experimentally unless you use a static address. </P>
+<P><EM>Target SSH port</EM> is the SSH port. This defaults to 2222. (The default for normal SSH usage is 22, but if the Target address is 127.0.0.1, this port must be remapped to avoid conflicts with the host.) </P>
+<P><EM>Host address</EM> is the name of the host as seen from the VM -- this is <strong>never</strong> 127.0.0.1. The value depends on the kind of networking you're using with the VM. For QEMU, the default is 10.0.2.2 since the IP is shared with the VM and a private subnet is used to reference the host. For VMware, it depends on the VMnet you have chosen. Probably you'll need to find this by logging into the VM (maemo/maemo) and invoking "ifconfig". </P>
+<P><EM>Target Samba port</EM> is used to allow sharing of files to and from the host. It's normally 139 or 445. It defaults to 4445, though, to allow two-way Samba access between the host and target when the target address is 127.0.0.1. </P>
+<h3>ESbox Shared Folders </h3>
+<P>Currently we require Eclipse projects to be visible to both the host and target. (Most Eclipse code assumes that all files are visible on the host. We don't yet support the notion of a project fully hosted remotely.) </P>
+<P>Additionally, the project must be visible to scratchbox. Sbox 1 has some restrictions here, but sbox 2 is looser. A convenient solution is to make the shared folder visible twice, once in a normal location under the user's home folder, and again in the parallel location visible to sbox 1. (The user's home should be shared identically amongst any sbox 1 target to maximize the benefit, else you need to share yet again for every rootstrap.) </P>
+<P>Thus, the Shared Folders portion of the VM configuration page will let ESbox know how to map paths. Each mapping is considered in order, so list sbox 1 mappings at the end. </P>
+<P>ESbox has some support for automatically mounting shares into the VM, since this is a commonly needed task when the VM is started and stopped. Note, however, ESbox will not configure shares for you or validate whether your settings make any sense -- the provided share must be manually configured. </P>
+<P><EM>Host</EM> tells the place where a share will be seen on the Eclipse host. </P>
+<P><EM>Target</EM> tells the place where a share will be seen on the VM. </P>
+<P><EM>Direction</EM> (the arrow in the middle) tells who provides the share. When it points to the target, the host is providing a share to the target, and vice versa. This is used when auto-mounting. </P>
+<P><EM>Name</EM> is the share name, as used in Samba/SMB. (e.g. "c:\users\shared" might be shared as "Public User Share".) If this is unspecified, the last segment of the share directory is used. </P>
+<P><EM>Auto</EM> tells whether ESbox will attempt to mount the share itself. Currently it can only handle mounts into Linux. If the mount is into Windows you need to set this up yourself (set to "No"). </P>
+<P><EM>Type</EM> is the share type. This is fixed to <EM>SMB</EM> for now. </P>
+<h3>Networking configuration </h3>
+<UL>
+ <LI>You need to be on a LAN for the PC <-> VM communication to work properly, as far as I know. Otherwise shared folders will not work and you'll get a lot of mysterious timeouts when trying to mount. </LI>
+</UL>
+<UL>
+ <LI>For VMware, you need to enable NAT and redirect SSH to port 2244 (or something >1024). Edit > Virtual Network Settings > NAT > <host> > Edit > Port Forwarding > "Host Port = 2244, VM IP Addreess = <actual runtime address :p>:22" </LI>
+</UL>
+<UL>
+ <LI>VMware changes port mapping for the WHOLE SYSTEM so if you switch between QEMU and VMware, you must use different SSH ports. </LI>
+</UL>
+</body>
+</html>
Property changes on: trunk/org.maemo.esbox.help/html/gettingstarted/virtualmachine.html
___________________________________________________________________
Name: svn:mime-type
+ text/plain
More information about the Esbox-commits
mailing list