imakerplugin/com.nokia.s60tools.imaker.doc.user/html/tasks/taskPreferences.html
author dpodwall
Tue, 12 Jan 2010 13:17:53 -0600
changeset 0 61163b28edca
child 11 217e69fc5beb
permissions -rw-r--r--
initial EPL conversion
Ignore whitespace changes - Everywhere: Within whitespace: At end of lines:
0
61163b28edca initial EPL conversion
dpodwall
parents:
diff changeset
     1
<!DOCTYPE HTML PUBLIC "-//W3C//DTD HTML 4.01 Transitional//EN">
61163b28edca initial EPL conversion
dpodwall
parents:
diff changeset
     2
<?Pub Inc>
61163b28edca initial EPL conversion
dpodwall
parents:
diff changeset
     3
<html>
61163b28edca initial EPL conversion
dpodwall
parents:
diff changeset
     4
<head>
61163b28edca initial EPL conversion
dpodwall
parents:
diff changeset
     5
<meta http-equiv="content-type" content="text/html; charset=iso-8859-1" />
61163b28edca initial EPL conversion
dpodwall
parents:
diff changeset
     6
<meta http-equiv="content-style-type" content="text/css" />
61163b28edca initial EPL conversion
dpodwall
parents:
diff changeset
     7
<title>Managing preferences</title>
61163b28edca initial EPL conversion
dpodwall
parents:
diff changeset
     8
<link href="../book.css" type="text/css" rel="stylesheet" />
61163b28edca initial EPL conversion
dpodwall
parents:
diff changeset
     9
</head>
61163b28edca initial EPL conversion
dpodwall
parents:
diff changeset
    10
<body>
61163b28edca initial EPL conversion
dpodwall
parents:
diff changeset
    11
<h2>Managing preferences</h2>  
61163b28edca initial EPL conversion
dpodwall
parents:
diff changeset
    12
<p>Before you can build a ROM image, you must define the preferences for a configuration. In iMaker,
61163b28edca initial EPL conversion
dpodwall
parents:
diff changeset
    13
a configuration can be thought of as a container of product and other information.</p> 
61163b28edca initial EPL conversion
dpodwall
parents:
diff changeset
    14
<ol>
61163b28edca initial EPL conversion
dpodwall
parents:
diff changeset
    15
<li>Select the project that you want to use as the basis for image creation. </li>
61163b28edca initial EPL conversion
dpodwall
parents:
diff changeset
    16
<li>Select <b>Open iMaker Dialog...</b> option from the iMaker pulldown menu on the toolbar. iMaker Extension will now start scanning the environtment to query 
61163b28edca initial EPL conversion
dpodwall
parents:
diff changeset
    17
information from the underlying iMaker commandline tool. This may take a while, but this action occurs only once for each project.</li>
61163b28edca initial EPL conversion
dpodwall
parents:
diff changeset
    18
<li>When the <b>iMaker Dialog</b> is opened, it is populated with data from the active environment. Default product is selected if one is configured, otherwise the first product is selected. 
61163b28edca initial EPL conversion
dpodwall
parents:
diff changeset
    19
User can change the product using the <b>Change...</b> button. Example is shown bellow. <p><img
61163b28edca initial EPL conversion
dpodwall
parents:
diff changeset
    20
src="images/iMakerPluginPreferences.png"></p></li>
61163b28edca initial EPL conversion
dpodwall
parents:
diff changeset
    21
<li>Once data is filled in the fields, a flashable image can be created. Press
61163b28edca initial EPL conversion
dpodwall
parents:
diff changeset
    22
the <b>Run</b> button at the bottom of the dialog. Remember to add the desired targets to the <b>selected</b> list of targets.</li>
61163b28edca initial EPL conversion
dpodwall
parents:
diff changeset
    23
</ol> 
61163b28edca initial EPL conversion
dpodwall
parents:
diff changeset
    24
<h3>Saving the preferences for a configuration</h3> 
61163b28edca initial EPL conversion
dpodwall
parents:
diff changeset
    25
<p>To save the fields of a configuration to a file, do the following: </p><ol>
61163b28edca initial EPL conversion
dpodwall
parents:
diff changeset
    26
<li>Press the <b>Save as...</b></li>
61163b28edca initial EPL conversion
dpodwall
parents:
diff changeset
    27
<li>Choose the parent folder where to save the file, it is recommended to save under the selected project. See below image.<p><img src="images/iMakerPluginSaveAction.png"></p></li>
61163b28edca initial EPL conversion
dpodwall
parents:
diff changeset
    28
<li>All saved preferences are visible in the <b>configuration</b> combobox on the top of the dialog. Any of these saved files can be activated and used for image creation.</li>
61163b28edca initial EPL conversion
dpodwall
parents:
diff changeset
    29
61163b28edca initial EPL conversion
dpodwall
parents:
diff changeset
    30
<a name="management"></a><h3>Settings tab</h3> <p>To modify the values
61163b28edca initial EPL conversion
dpodwall
parents:
diff changeset
    31
of the variables of the selected product (or makefile), select the <b>Settings
61163b28edca initial EPL conversion
dpodwall
parents:
diff changeset
    32
</b> tab in the iMaker dialog. See the following example: </p><p><img src="images/iMakerPluginPreferencesDetails.png"> Through this tab user can override the default variable values in the iMaker core. Any modified parameter will be passed to iMaker cmd throuht execution command.</p> 
61163b28edca initial EPL conversion
dpodwall
parents:
diff changeset
    33
61163b28edca initial EPL conversion
dpodwall
parents:
diff changeset
    34
<a name="debug"></a><h3>Debug tab</h3>
61163b28edca initial EPL conversion
dpodwall
parents:
diff changeset
    35
<p>The debug tab allows user to add binary and data files to the image. These files can be added to different sections of the image. The binary files can be easy changed to debug versions. Currently CORE and ROFS sections are supported. 
61163b28edca initial EPL conversion
dpodwall
parents:
diff changeset
    36
Files cannot be added to UDA for example through this tab.<br>
61163b28edca initial EPL conversion
dpodwall
parents:
diff changeset
    37
<img src="images/debug_tab.png"></p>
61163b28edca initial EPL conversion
dpodwall
parents:
diff changeset
    38
61163b28edca initial EPL conversion
dpodwall
parents:
diff changeset
    39
<a name="platsim"></a><h3>Platsim tab</h3>
61163b28edca initial EPL conversion
dpodwall
parents:
diff changeset
    40
<p>The contents of the platsim tab will be enabled, when you select a valid platsim configuration from the main tab. The platsim configuration must define USE_PLATSIM variable, in order it to be 
61163b28edca initial EPL conversion
dpodwall
parents:
diff changeset
    41
consider as valid. This variable must be non-empty. Users can edit the platsim configuration makefile and add USE_PLATSIM=1 then restart carbide.c++. Currently only all target is supported. All 
61163b28edca initial EPL conversion
dpodwall
parents:
diff changeset
    42
target creates an image, which contains all image sections (core, rofsx, ...) and configures the selected platsim instance with the created image. Selecting (run platsim after image creation) checkbox causes 
61163b28edca initial EPL conversion
dpodwall
parents:
diff changeset
    43
platsim instance to be started in the end of the image creation process.<br>
61163b28edca initial EPL conversion
dpodwall
parents:
diff changeset
    44
<img src="images/platsim_tab.png"> </p> 
61163b28edca initial EPL conversion
dpodwall
parents:
diff changeset
    45
<div id="footer">Copyright &copy; 2009 Nokia Corporation and/or its subsidiary(-ies). All rights reserved. 	License: <a href="http://www.eclipse.org/legal/epl-v10.html">http://www.eclipse.org/legal/epl-v10.html</a>.</div>
61163b28edca initial EPL conversion
dpodwall
parents:
diff changeset
    46
</body>
61163b28edca initial EPL conversion
dpodwall
parents:
diff changeset
    47
</html>