Symbian^2 on the Beagle Board

Purpose and Scope

This document is a guide to running the the Symbian^2 on the Beagle board.

Getting the Symbian^2 release

The beagle board base port will only work in conjuntion with the SOSCO patched version of Symbian^2. This assumes the following release opps_baseline sf_2.0.b_003_SOSCO_OPPS_003_TMP. This release must be installed acording to the by following the steps on the OPP database.

Ensure that the Syborg rom builds and boots before proceeding.

Getting the Beagle board baseport

At the time of writing the Beagle board baseport is only available in the SOSCO perforce repositary. The source is located at:

//LPD/development/baseporting/clean/beagleboard/personal/andrewps/foundation_latest/src/cedar/generic/base/omap3530/

There should be a CBR release coming soon.

Compiling the Beagle board baseport

Get the base source code by calling getsource on all components found using envinfo | findstr base_.

To compile the beagle board baseport use the metabld script omap3530/buildscripts/reallycleanbuild.mbc:

metabld reallycleanbuild.mbc

I usually collect a log by doing something like

metabld reallycleanbuild.mbc 2>&1 | tee 20090714_1641_build_the_beagle_bsp.txt

Building a Beagle board textshell image

To build a textshell rom the following lines have to be commented out of \epoc32\include\bldvariant.hrh.

#include <bldcodeline.hrh>		
#include <bldprivate.hrh>
#include <bldpublic.hrh>
#include <bldregional.hrh> 
		

Note that these lines must be put back to build a GUI image.

Use the standard textshell build comand:

rom -v=beagle -i=armv5
rombuild rom.oby

Booting a Beagle board ROM

Copy your image to an MMC or SD card and call it BEAGLEARMV5D.IMG. 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:

set bootcmd 'mmcinit ; fatload mmc 0:1 0x81000000 BEAGLEARMV5D.IMG ; go 0x81000000'; saveenv

When you reboot the beagle board the textshell rom should be automatically loaded.

Building a Beagle board S60 image

Ensure that \epoc32\include\bldvariant.hrh is clean.

Update \epoc32\rom\lpd_override\base.iby to include the Beagle baseport:

#elif defined(__BEAGLE__)
#include <base_beagle.iby>
		

Copy the files beagle.oby and base_beagle.iby from \epoc32\rom\include into \epoc32\rom\lpd_override\.

Build the s60 image using the following command:

call \epoc32\tools\buildrom_lpd.cmd beagle Symbian2.oby -D_EABI=ARMV5 -DCOLOR  -DSYMBIAN_EXCLUDE_IPSEC -D_PORTRAIT_ -es60ibymacros -nosymbols -D__LOCALES_01_IBY__