<!DOCTYPE HTML PUBLIC "-//W3C//DTD HTML 4.01 Transitional//EN"
"http://www.w3.org/TR/html4/loose.dtd">
<html>
<head>
<meta http-equiv="Content-Type" content="text/html; charset=iso-8859-1">
<title>Jbed for Windows Mobile RI readme</title>

<!--[

    Version:    $Id: //depot/customer/wince_67/dev/docs/manuals/jbedri/pocketpc2005/readme.html#1 $

    Last submitted: $Date: 2007/10/18 $

    Copyright 2006-2007 Esmertec AG. All Rights Reserved.

]-->

<!-- include standard stylesheet -->
<link rel="stylesheet" type="text/css"
      href="style.css"
      title="style sheet">

</head>

<body>

<a name="Top"></a>
<div id="top">

<table width="100%" border="0" cellspacing="0" cellpadding="0">
  <tr bgcolor="#6699FF"><td height="50" colspan="4">&nbsp;</td></tr>
  <tr bgcolor="#6699FF">
    <td width="10" height="25">&nbsp;</td>
    <td width="345"><a href="http://www.esmertec.com/">
      <img src="logo_2.gif" alt="Esmertec" width="205" height="41">
      </a></td>
    <td>&nbsp;</td>
    <td width="10">&nbsp;</td>
  </tr>
  <tr bgcolor="#6699FF">
    <td class="line_white" height="25">&nbsp;</td>
    <td class="line_white" width="400">&nbsp;</td>
    <td class="line_white" align="right">
      <a class="menu" href="../../../index.html">Home</a></td>
    <td class="line_white">&nbsp;</td>
  </tr>
  <tr><td class="line_blue" colspan="4">&nbsp;</td></tr>
</table>
</div><!-- End: Header area -->

<div id="bodyText">

    <h1>Jbed for Windows Mobile RI readme</h1>
<p>This document describes how to install Jbed for Windows Mobile RI on a Windows
Mobile device running PocketPC 2005.

<ul>
  <li><a href="#pre">Windows host prerequisites</a>
  <ul>
    <li><a href="#envVars">Define environment variables</a></li>
  </ul></li>
  <li><a href="#install">Install Jbed for Windows Mobile RI</a></li>
  <li><a href="#build">Build Jbed for Windows Mobile RI</a>
  <li><a href="#phone">Install the build onto the target phone</a></li>
  <li><a href="#run">Running MIDlets</a></li>
  <li><a href="#shortcuts">Creating shortcuts to run MIDlets</a></li>
  <li><a href="#disclaimer">Disclaimer</a></li>
</ul>

<p>
<hr>

<h2 id="pre">Windows host prerequisites</h2>
<p>It is assumed that you are familiar with the tools for the target architecture
(i.e. native compiler, cross-compiler, linker and debugger) of your target
hardware and can successfully build a simple application in C using the makefile
supplied by the OS vendor. You should then be able to download the built
application and run it on your hardware.

Jbed licensees will require tools for building and testing specific Jbed versions,
including:

<ul>
  <li>ActiveSync (latest version recommended)</li>
  <li>Java&#8482; Development Kit (JDK) - required to build and run Jbed (JDK
  1.4.2_05 or later is recommended).</li>
  <li>Perl - required for the build scripts and other utilities (ActivePerl 5.6 is
  recommended).</li>
  <li>Python - required for the build scripts and other utilities.</li>
  <li>Visual Studio 2005</li>
  <li>Windows Mobile 5.0 SDK for Pocket PC</li>
</ul>


<h3 id="envVars">Define environment variables</h3>

<p>The following are some of the environment variables that need to be defined
to build Jbed for Windows Mobile RI:

<ul>
  <li><code>JDK4_PATH</code> - points to the <code>bin</code> directory
    of JDK 1.4.</li>
  <li><code>MASTER</code> - points to the location of the masterpack on the
  local hard disk</li>
  <li><code>MSDevStudio8</code> - points to the location of the Microsoft Visual Studio
  2005 installation.</li>
  <li><code>MSVCVER</code> - set this variable to 8.</li>
  <li><code>PB500_BIN_DIR</code> - points to the <code>VC\ce\bin\x86_arm</code> directory of the
  Visual Studio 2005 installation.</li>
  <li><code>PERLCMD</code> - points to the location of the Perl executable.</li>
  <li><code>PYCMD</code> - points to the location of the Python executable.</li>
  <li><code>WCE500BaseDir</code> - points to the location of the
    <code>Windows CE Tools</code> directory (made available when Windows Mobile
    5.0 SDK is installed).</li>
  <li><code>WD</code> - points to the location of the working directory on your
  host. If you do not have a WD, set this to an empty directory.</li>
</ul>

<p>Refer to the <a href="../../develop/env-vars.html">Set environment variables</a>
 document in the <a href="../../develop/index.html">Developers Guide</a> for a full listing of
 environment variables.

<p>
<a href="#Top">Back to top</a>
<p>
<hr>

<h2 id="install">Install Jbed for Windows Mobile RI</h2>
<p>To install Jbed for Windows Mobile RI, open the self-installer and
follow the instructions.

<p>
<a href="#Top">Back to top</a>
<p>
<hr>



<h2 id="build">Build Jbed for Windows Mobile RI</h2>
<p>To build Jbed for Windows Mobile RI for PocketPC 2005,
execute the following command:

<pre>
  stdbuilds.py -b fbcc_pocketpc2005_nativeui build --wd
</pre>

<p>
<a href="#Top">Back to top</a>
<p>
<hr>

<h2 id="phone">Install the build onto the target phone</h2>

<p>To install the build onto the target phone, you must first generate a
<code>.cab</code> file using the <code>makecab.py</code> script, located in
the <code>os\win\ce\scripts\</code> directory. To generate a <code>.cab</code>
file, execute the following command:

<p>To run the script from the masterpack directory (default):
<pre>
  makecab.py -m
</pre>

<p>To run the script from the working directory:
<pre>
  makecab.py -w
</pre>

<p>Use the <code>-h</code> argument for more options.

<p>The following <code>.cab</code> file will then be generated to the
<code>%TARG_PREFIX%\Installer</code> directory:

<pre>
  setupJbed.CAB
</pre>

<p>Then perform the following steps:

<ol>
  <li>Download the <code>.cab</code> file onto the target device, using
      ActiveSync.</li>
  <li>Open the executable from within the target device.</li>
  <li>Follow the on-screen instructions.</li>
</ol>

<p>After installation, the Jbed executable will be available in the following directory:
  <ul>
    <li><code>\Storage\Program Files\Esmertec\FastBCC</code> </li>
  </ul>
<p>Select the following shortcut to run the Jbed RI for Windows Mobile:
<pre>
  jbed
</pre>

<p>
<a href="#Top">Back to top</a>
<p>
<hr>

<h2 id="run">Running MIDlets</h2>

<p>For information on how to use the AMS and navigate its menus, refer to the
<a href="../../user/ams/index.html">User Guide</a>.

<p>To set the limit for the maximum file system size to 8MB, add
<code>-DFile.maxStorageSize=8m</code> to the command-line arguments stored
in the shortcut that launches Jbed. See example of
<a href="#shortcuts">how to create shortcuts</a> in the next section.

<p>The given &lt;<code>size</code>&gt; is the number of bytes to use for the
file system (default is 4MB). Adding 'k' or 'm' after the size figure allows
for kilobyte and megabyte values, respectively. An example of its use is when
running MIDlets that require a larger file system than the default value.

<p>
<a href="#Top">Back to top</a>
<p>
<hr>

<h2 id="shortcuts">Creating shortcuts to run MIDlets</h2>

<p>Using a shortcut on Windows Mobile devices allows command-line
arguments to be stored in the <b>Properties</b> of the shortcut, avoiding the
need to re-type them every time you want to launch Jbed.

<p>To create a shortcut for a Jbed application, make sure that the
ActiveSync connection is established and perform the following steps
on your host PC:

<ol>
  <li>Open the ActiveSync <b>Explore</b> window:
  <ul class="normal">
    <li>Open the <code>\Storage\Program Files\Esmertec\FastBCC</code> directory.</li>
    <li>Right-click on <code>jbed.exe</code> and select <b>Create Shortcut</b>.
    <br>This creates the file <code>Shortcut to Jbed.exe.lnk</code>.</li>
  </ul></li>

  <li>Copy the new shortcut to your host.</li>


  <li>Edit the shortcut with a text editor. The content of the shortcut file
  is:<br>

  <br><code>50#"\Storage\Program Files\Esmertec\FastBCC\jbed.exe"</code>

  <br>where <code>50#</code> denotes that there are 50 characters in the string,
  including the quotes.</li>

  <li>Change the content to include the full classpath of your MIDlet.
  For example:
  <br>
  <code>90#"\Storage\Program Files\Esmertec\FastBCC\" -classpath "\Windows\testMidlet.jar" testMidlet</code> (FastBCC)
  </li>

  <li>Save the file on your PC.</li>
  <li>Copy it back to the device using the ActiveSync <b>Explore</b>
  window.</li>
</ol>

<p>You can now select the shortcut to run the MIDlet.

<p>
<a href="#Top">Back to top</a>
<p>
<hr>

<h2 id="disclaimer">Disclaimer</h2>
<p>This document, as well as the software described in it, is furnished under
license and may only be used or copied in accordance with the terms of such
license. Except as permitted by such license, no part of this publication may
be reproduced, stored in a retrieval system, or transmitted, in any form or by
any means, electronic, mechanical, recording, or otherwise, without the written
permission of Esmertec.

<p>Esmertec, Jbed, Jcap, Jeco, FastBCC, FastDAC, HostBCC and u@ are
trademarks or registered trademarks of Esmertec AG.

<p>Copyright &#169; 1998-2007 Esmertec AG.

<p>Java and all Java-based marks are trademarks or registered trademarks of Sun
Microsystems, Inc. Esmertec is independent of, and in no manner legally
affiliated with, Sun Microsystems, Inc. except as a licensee.

<p>All rights reserved for all marks. All use is subject to license terms.

<p>Headquarters:
<br>Esmertec
<br>Lagerstrasse 14
<br>CH-8600 D&uuml;bendorf
<br>Switzerland
<br>Phone +41 1 823 89 00
<br>Fax +41 1 823 89 99

<p>Further information about Esmertec and its worldwide offices is available
at <a href="http://www.esmertec.com">www.esmertec.com</a>.


<h2>Patents</h2>

<!--#IFDEF MIDP -->
<!--#IFDEF JVM_FBCC -->
<p>Jbed Advanced (with FastBCC) is protected by U.S. Pat. Nos:
6,964,039; 6,978,451;
<!--#ENDIF JVM_FBCC -->

<!--#IFDEF JVM_FDAC -->
<p>Jbed Advanced (with FastDAC) is protected by U.S. Pat. Nos:
6,766,513; 6,901,587; 6,944,637; 6,976,254;
7,007,005; 7,058,929; 7,069,549;
<!--#ENDIF JVM_FDAC -->

<!--#ELSE MIDP -->
<p>Jbed Advanced CDC is protected by U.S. Pat. Nos:
6,766,513; 6,862,728; 6,901,587; 6,944,637; 6,976,254;
7,007,005; 7,058,929; 7,069,549;
<!--#ENDIF MIDP -->

<p>
<a href="http://java.sun.com" target="_blank">
<img src="Java_Powered_25.gif" width="92" height="127"
alt="Java powered" hspace="22" vspace="22"></a>


<p>
<a href="#Top">Back to top</a>

</div> <!-- End: Body area -->



<!-- Footer area -->
<div id="bottom">

<table width="100%" border="0" cellspacing="0" cellpadding="0">
  <tr><td height="20" colspan="4">&nbsp;</td></tr>
  <tr bgcolor="#0066CC">
    <td height="20">&nbsp;</td>
    <td height="20" valign="middle" class="footer">
    Copyright &copy; 1998-2007 Esmertec AG. All Rights Reserved.</td>
    <td height="20" align="right" valign="middle" class="footer">
    Jbed for Windows Mobile RI, Version 6.7</td>
    <td height="20">&nbsp;</td>
  </tr>
  <tr><td height="20" colspan="4">&nbsp;</td></tr>
</table>
</div> <!-- End: Footer area -->

</body>
</html>


