0
+ − 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 <bldcodeline.hrh>
+ − 50 #include <bldprivate.hrh>
+ − 51 #include <bldpublic.hrh>
+ − 52 #include <bldregional.hrh>
+ − 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 <base_beagle.iby>
+ − 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>