omap3530/Building_the_beagle_baseport.html
changeset 0 6663340f3fc9
equal deleted inserted replaced
-1:000000000000 0:6663340f3fc9
       
     1 <html>
       
     2 
       
     3 	<head>
       
     4 	<title>Symbian^2 on the Beagle Board</title>
       
     5 	</head>
       
     6 
       
     7 	<body>
       
     8 
       
     9 		<h1>Symbian^2 on the Beagle Board</h1>
       
    10 
       
    11 		<h2>Purpose and Scope</h2>
       
    12 
       
    13 		This document is a guide to running the the Symbian^2 on the Beagle board.
       
    14 
       
    15 		<h2>Getting the Symbian^2 release</h2>
       
    16 
       
    17 		<p>The beagle board base port will only work in conjuntion with the SOSCO patched version of Symbian^2. This assumes the following release <code>opps_baseline sf_2.0.b_003_SOSCO_OPPS_003_TMP</code>. This release must be installed acording to the by following the <a href="Notes:///802575210038D821/FF4EAD1C2A2A563580256A1C00306169/F2BBFBA8A95E5F19802575EE004BF976">steps on the OPP database</a>.</p>
       
    18 		
       
    19 		<p>Ensure that the Syborg rom builds and boots before proceeding.</p>
       
    20 
       
    21 
       
    22 		<h2>Getting the Beagle board baseport</h2>
       
    23 
       
    24 		<p>At the time of writing the Beagle board baseport is only available in the SOSCO perforce repositary. The source is located at:</p>
       
    25 
       
    26 		<pre>//LPD/development/baseporting/clean/beagleboard/personal/andrewps/foundation_latest/src/cedar/generic/base/omap3530/</pre>
       
    27 		
       
    28 		<p>There should be a CBR release coming soon.</p>
       
    29 		
       
    30 
       
    31 		<h2>Compiling the Beagle board baseport</h2>
       
    32 		
       
    33 		<p>Get the base source code by calling <code>getsource</code> on all components found using <code>envinfo | findstr base_</code>.</p>
       
    34 
       
    35 		<p>To compile the beagle board baseport use the metabld script <code>omap3530/buildscripts/reallycleanbuild.mbc</code>:</p>
       
    36 
       
    37 		<pre>metabld reallycleanbuild.mbc</pre>
       
    38 		
       
    39 		<p>I usually collect a log by doing something like</p>
       
    40 		
       
    41 		<pre>metabld reallycleanbuild.mbc 2>&1 | tee 20090714_1641_build_the_beagle_bsp.txt</pre>
       
    42 
       
    43 
       
    44 		<h2>Building a Beagle board textshell image</h2>
       
    45 
       
    46 		<p>To build a textshell rom the following lines have to be commented out of <code>\epoc32\include\bldvariant.hrh</code>.</p>
       
    47 
       
    48 		<pre>
       
    49 #include &lt;bldcodeline.hrh&gt;		
       
    50 #include &lt;bldprivate.hrh&gt;
       
    51 #include &lt;bldpublic.hrh&gt;
       
    52 #include &lt;bldregional.hrh&gt; 
       
    53 		</pre>
       
    54 
       
    55 		<p>Note that these lines must be put back to build a GUI image.</p>
       
    56 
       
    57 		<p>Use the standard textshell build comand:</p>
       
    58 
       
    59 		<pre>rom -v=beagle -i=armv5</pre>
       
    60 
       
    61 		<pre>rombuild rom.oby</pre>
       
    62 
       
    63 
       
    64 		<h2>Booting a Beagle board ROM</h2>
       
    65 
       
    66 		<p>Copy your image to an MMC or SD card and call it <code>BEAGLEARMV5D.IMG</code>. If your Beagle board is not setup to autoboot from removable media then you must connect to the bootloader configuration shell over the beagle boards serial connection and type the following:</p>
       
    67 
       
    68 		<pre>set bootcmd 'mmcinit ; fatload mmc 0:1 0x81000000 BEAGLEARMV5D.IMG ; go 0x81000000'; saveenv</pre>
       
    69 
       
    70 		<p>When you reboot the beagle board the textshell rom should be automatically loaded.</p>
       
    71 		
       
    72 		
       
    73 		<h2>Building a Beagle board S60 image</h2>
       
    74 		
       
    75 		<p>Ensure that <code>\epoc32\include\bldvariant.hrh</code> is clean.</p>
       
    76 		
       
    77 		<p>Update <code>\epoc32\rom\lpd_override\base.iby</code> to include the Beagle baseport:</p>
       
    78 		
       
    79 		<pre>
       
    80 #elif defined(__BEAGLE__)
       
    81 #include &lt;base_beagle.iby&gt;
       
    82 		</pre>
       
    83 		
       
    84 		<p>Copy the files <code>beagle.oby</code> and <code>base_beagle.iby</code> from <code>\epoc32\rom\include</code> into <code>\epoc32\rom\lpd_override\</code>.</p>
       
    85 		
       
    86 		<p>Build the s60 image using the following command:</p>
       
    87 		
       
    88 		<pre>call \epoc32\tools\buildrom_lpd.cmd beagle Symbian2.oby -D_EABI=ARMV5 -DCOLOR  -DSYMBIAN_EXCLUDE_IPSEC -D_PORTRAIT_ -es60ibymacros -nosymbols -D__LOCALES_01_IBY__</pre>
       
    89 		
       
    90 	</body>
       
    91 	
       
    92 </html>