mvista23ise.com

XAPP969(v1.
1)February23,2007www.
xilinx.
com12006-2007Xilinx,Inc.
Allrightsreserved.
AllXilinxtrademarks,registeredtrademarks,patents,andfurtherdisclaimersareaslistedathttp://www.
xilinx.
com/legal.
htm.
PowerPCisatrademarkofIBMInc.
Allothertrademarksandregisteredtrademarksarethepropertyoftheirrespectiveowners.
Allspecificationsaresubjecttochangewithoutnotice.
NOTICEOFDISCLAIMER:Xilinxisprovidingthisdesign,code,orinformation"asis.
"Byprovidingthedesign,code,orinformationasonepossibleimplementationofthisfeature,application,orstandard,Xilinxmakesnorepresentationthatthisimplementationisfreefromanyclaimsofinfringement.
Youareresponsibleforobtaininganyrightsyoumayrequireforyourimplementation.
Xilinxexpresslydisclaimsanywarrantywhatsoeverwithrespecttotheadequacyoftheimplementation,includingbutnotlimitedtoanywarrantiesorrepresentationsthatthisimplementationisfreefromclaimsofinfringementandanyimpliedwarrantiesofmerchantabilityorfitnessforaparticularpurpose.
SummaryThisapplicationnoteoutlinesthestepsforsettingupandusingtheEmbeddedDevelopmentKit(EDK)andLinux2.
6.
ItshowshowtosetupadevelopmentenvironmentandhowtorunLinux2.
6ontheembeddedIBMPowerPC405(PPC405)processoravailableontheML405EvaluationPlatform.
Thedocumentconsistsofthefollowingsections:"Introduction""InstallingtheSoftware""SettinguptheDevelopmentEnvironmentforLinux2.
6""StartingaDesign""BuildingtheLinux2.
6Kernel""GeneratinganACEFileandBootingLinuxonML405"IncludedSystemsThisapplicationnoteincludesaTemacadapterinthefollowingfile:www.
xilinx.
com/bvdocs/appnotes/xapp969.
zipIntroductionThisapplicationnoteoutlinesthestepsforgettingstartedwiththeEDK(8.
2.
02iversionandlater)andLinux2.
6forbothMontaVistaandWindRiverLinuxdistributions.
Table1liststherequiredtoolsforgettingstarted.
ApplicationNote:EmbeddedProcessingXAPP969(v1.
1)February23,2007GettingStartedwithEDKandLinux2.
6Author:SrikanthVemulaRTable1:RequiredToolsItemDetailsHostWorkstationAdeskPCoralaptopwithaCD-ROMdriveandsufficientharddiskspace.
TheWindRiverLinuxEdition1.
3canbeinstalledonaRedHatEnterpriseLinux(RHEL)WorkStation(WS)3,update5,andWS4,update1,fortheIntelX86platform.
TheMontaVistaLinuxProfessionalEdition4.
0.
1canbeinstalledonMicrosoftWindows2000XPSP1&SP2,RedHat9.
0,RHELWS3,RHELES3,Solaris8,SusePro9.
2,andSuseEnterprise9.
2fortheIntelX86platform.
CompactFlashwriterACompactFlashwriter.
MostofthesewritersareUSB-based.
ML405includingthefactoryCompactFlashcardSeehttp://www.
xilinx.
com/ml405.
XilinxISEinstallationCDsSeehttp://www.
xilinx.
com/isetopurchaseorevaluatethelatestXilinxISEtools.
InstallingtheSoftwareXAPP969(v1.
1)February23,2007www.
xilinx.
com2RInstallingtheSoftwareInstallingXilinxISEInserttheISECDintotheCD-ROMdriveandfollowtheinstallationinstructions.
Whenfinished,installanyrequiredServicePacks.
InstallingXilinxEDKInserttheEDKCDintotheCD-ROMdriveandfollowtheinstallationinstructions.
Whenfinished,installanyrequiredServicePacks.
InstallingLinux2.
6InstallingMontaVistaLinuxProfessionalEdition4.
0.
1forML40xFollowtheinstallationinstructionsgivenintheMontaVistaLinuxProfessionalEdition4.
0whichisavailableontheMontaVistawebsiteatwww.
mvista.
com.
InstallthefollowingCDs:1.
MontaVistaPro4.
0.
1HostBinariesCDforppc_4052.
MontaVistaPro4.
0.
1CrossBinariesCDforppc_4053.
MontaVistaPro4.
0.
1TargetBinariesCDforppc_4054.
MontaVistaPro4.
0.
1XilinxML40xLSPSCDTheinstallationofthefollowingCDsisoptional:1.
MontaVistaDevRocketVersion2.
0.
1CD2.
MontaVistaPro4.
0.
1DocumentationCDInstallingWindRiverLinuxEdition1.
3FollowtheinstallationinstructionsgivenintheWindRiverLinuxPlatformsGettingStarted1.
3whichisavailableontheWindRiverwebsiteatwww.
windriver.
com.
InstallthefollowingCDs:1.
WindRiverWorkbench2.
5.
0.
2.
Note:InstallthisCDfirst.
Theinstallationdirectorymustbespecifiedbytheuserduringthesetup.
2.
WindRiverGNUCompiler3.
4.
4forAllPlatforms,LinuxEdition1.
3forAllArchitectures3.
SetupFiles,Utilities,ReferenceSource,andDocumentationforAllPlatforms,LinuxEdition1.
3forAllArchitectures4.
CrossBuildSystemforBusyBoxRootFileSystemsforAllPlatforms,LinuxEdition1.
3forMIPSandPowerPC5.
CrossBuildSystemforStandardRootFileSystemforAllPlatforms,LinuxEdition1.
3forPowerPCXilinxEDKinstallationCDsSeehttp://www.
xilinx.
com/edktopurchaseorevaluatethelatestXilinxEDKtools.
Linux2.
6CDsandpatchesMontaVistaProfessionalEdition4.
0.
1forXilinxML40XLSPInstallationCDsorWindRiverLinuxEdition1.
3InstallationCDsandML405BSPpatchesTable1:RequiredTools(Contd)ItemDetailsSettinguptheDevelopmentEnvironmentforLinux2.
6XAPP969(v1.
1)February23,2007www.
xilinx.
com3RApplythefollowingpatches:1.
ApplythePPC405ArchitectureSupportPatchrequiredbyXilinxML300/ML403.
ThepatchisavailableontheWindRiverwebsiteasazipfile(gpple_pnele_1_3-ppc405_common.
zip).
Followtheinstructionsinthezipfileforapplyingthepatch2.
ApplytheGPP-LE1.
3forXilinxML403BSPpatches:ThepatchesareavailableontheWindRiverwebsiteasazipfile(gpple_pnele_1_3-xilinx_ml403.
zip).
FollowtheinstructionsinthezipfileforapplyingthepatchSettinguptheDevelopmentEnvironmentforLinux2.
6SetupthedevelopmentenvironmentforLinux2.
6beforestartingthedesign.
Createaprojectdirectorycalledml405_demo.
Fromthispointon,thisprojectdirectoryisreferredtoas.
Createasubdirectorynamedlinuxin.
SettingUptheDevelopmentEnvironmentforMontaVistaPro4.
0.
1Linux1.
OpenanewshellontheHostPCandsetuptheenvironmentbyexecutingthefollowingcommands:$cd/linux$exportPATH=$PATH:/opt/montavista/pro/devkit/ppc/405/binNote:ItisassumedthattheMontaVistaPro4.
0.
1hasbeeninstalledinthe/opt/montavistadirectory.
IfMontaVistaLinuxhasbeeninstalledonaWindowsmachine,thecommandstoopenanewmustberunonaMontaVistaCygwinshell.
2.
CopytheXilinxML40xLSPtothelinuxsubdirectoryoftheprojectdirectorybyexecutingthefollowingcommandsintheshell:$tarcf--C/opt/montavista/pro/devkit/lsp/xilinx-ml40x-ppc_405/linux-2.
6.
10_mvl401.
|tarxf-SettingUptheDevelopmentEnvironmentforWindRiverLinuxEdition1.
31.
OpenanewshellontheHostPCandsetuptheenvironmentbyexecutingthefollowingcommands:$cd/linux$/wrenv.
sh-pwrlinux-1.
3Note:Readthe/readme.
txtfileformoreinformationonrunningtheWindRivertools.
2.
Ifperlisinvokedfromthecurrentshell,confirmthat/usr/bin/perlisexecuted.
Otherwise,BSPbuildingprocessmayabortwitherrors.
$whichperl3.
CopytheXilinxML403BSPtothelinuxdirectoryintheprojectdirectorybyexecutingthefollowingcommand:$/wrlinux-1.
3/wrlinux/configure--enable-kernel=cgl--enable-board=xilinx_ml403--enable-rootfs=glibc_full4.
BuildthelinuxkerneltreeandrootfilesystembyrunningthefollowingcommandinashellopenedontheHostPCinthe/linuxdirectory:$makeall2>&1|teelinux_and_fs.
log&5.
FollowtheinstructionsgiveninChapter4.
DeploymentoftheWindRiverLinuxPlatformsGettingStarted1.
3todeploytherootfilesystem.
StartingaDesignXAPP969(v1.
1)February23,2007www.
xilinx.
com4RStartingaDesignThissectionoutlinesthestepstocreatethehardwaredesign,togeneratetheLinux2.
6BSP,andtogeneratethehardwarebitstreamfortheML405evaluationplatform.
BuildingthePowerPC405systemforML405StarttheXilinxPlatformStudio(XPS)andcreatetheEDKprojectinthedirectory.
UsingtheBaseSystemBuilder1.
ClickOKtostartanewdesignwiththeBaseSystemBuilderwizard.
2.
IntheCreateNewXPSProjectUsingBSBWizardwindow,clickOKtoacceptthedefaultsettings.
3.
IntheBaseSystemBuilder-Welcomewindow,clickNexttocreateanewdesign.
4.
IntheBaseSystemBuilder-SelectBoardwindow,choosethetargetboard.
SelectXilinxastheBoardVendor.
SelectVirtex4ML405EvaluationPlatformastheBoardName.
ClickNexttoacceptthesesettings.
5.
IntheBaseSystemBuilder-SelectProcessorwindow,clickNexttoacceptthePowerPCcontrollerastheprocessorforthedesign.
6.
IntheBaseSystemBuilder-ConfigurePowerPCwindow,selecttheprocessorandbusfrequenciestorun.
Select200.
00MHzfortheProcessorClockFrequencyand66.
67MHzfortheBusClockFrequency.
ClickNexttoacceptthesesettings.
SelectingConfigurationOptionsTheconfigurationoptionsfortheI/Ointerfacesaredisplayedinthesubsequentwindows.
Thenumberofwindowsdisplayeddependsonthescreenresolution.
ClickNexttoadvancetothenextwindow.
Accepttheparametersattheirdefaultvalueswhilemakingthefollowingselections:EnableRS232UART,chooseOPBUART16550asPeripheral,selectConfigureasUART16550,andselectUseInterrupt.
DisableLEDs4BitDisableLEDsPositionDisablePushButtonsPositionEnableIICEEPROMandselectUseInterruptEnableSysACECompactFlashandselectUseInterruptDisableCypressUSBEnableDDRSDRAM64Mx32,andchoosePLBDDRasPeripheralDisableEthernetMACEnableTriModeMACGMII,choosePLBTEMACasPeripheral,chooseScattergatherDMA,andselectUseInterruptDisableTriModeMACGMIIDisableSRAM256Kx32DisableFLASH2Mx321.
IntheClickNexttoacceptthedefaultsettingsintheBaseSystemBuilder-AddInternalPeripheralswindow.
2.
IntheBaseSystemBuilder-SoftwareSetupwindow,disabletheSampleapplicationselectionforboththeMemorytestandPeripheralselftest.
ClickNext.
3.
IntheBaseSystemBuilder-SystemCreatedwindow,whereanoverviewofthesystemisshown,clickGeneratetowritetheconfigurationtothedisk.
4.
IntheBaseSystemBuilder-Finishwindow,clickFinishtocompletetheBaseSystemBuilder.
StartingaDesignXAPP969(v1.
1)February23,2007www.
xilinx.
com5RModifyingtheSoftwareSettingsAfterreturningfromBaseSystemBuildertoXilinxPlatformStudio,theuserhasacompletehardwareproject.
MakethechangesoutlinedinthesubsequentstepstothesoftwarepartoftheprojecttoautomaticallygenerateaLinuxBoardSupportPackage(BSP).
1.
InXPS,selectSoftware→SoftwarePlatformSettingstoopenthesoftwaresettingsdialogbox.
2.
IntheOS&LibrarySettingssectionofthedialogbox,chooselinux_2_6astheoperatingsystem(OS)and1.
00.
aastheOSVersion.
3.
ClickontheOSandLibrariespaneforsettingsomeadditionalparametersnecessaryforgeneratingtheLinuxBSP.
a.
Clickthebuttonintheconnected_periphsfield.
IntheAdd/DeleteListofParameter-Valuesdialogbox.
Thefollowinglistofperipheralsisdisplayed:-RS232_Uart-IIC_EEPROM-SysACE_CompactFlash-TriMode_MAC_GMII-opb_intc_0ClickOKtoacceptthesettingsintheAdd/DeleteListofParameter-Valueswindow.
b.
TheML405has64MBofmemory.
Enter0x04000000tothememorysizeparametertoassignallthememoryforLinux.
c.
Settheuart16550busclockfreqparametertothesamevalueastheBusClockFrequencyintheBaseSystemBuilder.
Enter66666667intothisfield.
d.
ThetargetdirectoryparameterspecifiesthelocationwheretheLinuxBSPiscopied.
CopytheLinuxBSPdirectlyintotheLinuxkernelbeingusedforthedesign.
Enter/linuxforMontaVistaLinuxand/linux/dist/linux-2.
6.
14-cglforWindRiverLinux.
Note:Donotchangethevaluesfortheremainingparameters.
4.
IntheSoftwarePlatformSettingswindow,clickOKtoacceptthesettings.
5.
ClickontheApplicationstab,right-clickonDefault:ppc405_0_bootloop,andenableMarktoInitializeBRAMs.
Allthehardwareandsoftwaresettingsfortheprojecthavebeensuccessfullysetup.
BuildingtheBSPandHardwareFirstgeneratetheLinuxBSPandthenimplementthehardwaretobeabletoworkontheLinuxkernelwhileEDKbuildsthehardware.
1.
BuildtheLinuxBSPbyselectingSoftware→GenerateLibrariesandBSPsfromthemenu.
Byscrollingthroughthelogwindow,theuserisabletoseethattheLinuxBSPhasbeenbuilt.
2.
CopytheTemacadapterattachedwiththisapplicationnotetothe/linux/linux-2.
6.
10_mvl401/drivers/net/xilinx_temacdirectoryforMontaVistaLinuxortothe/linux/dist/linux-2.
6.
14-cgl/drivers/net/xilinx_temacdirectoryforWindRiverLinux.
Note:ThisstepisnotnecessaryforEDKversionslaterthan8.
2.
02i.
3.
BuildthehardwarebitstreambyselectingDeviceConfiguration→UpdateBitstreamfromthemenu.
BuildingtheLinux2.
6KernelXAPP969(v1.
1)February23,2007www.
xilinx.
com6RBuildingtheLinux2.
6KernelBuildingtheMontaVistaPro4.
0.
1KernelforML405Tobuildthelinuxkernel,runthefollowingcommandsintheshellopenedontheHostPCinthe/linuxdirectory:$exportPATH=$PATH:/opt/montavista/pro/devkit/ppc/405/bin$makebzImageNote:ThesecommandsarerunonaMontaVistaCygwinshellifMontaVistaLinuxhasbeeninstalledonaWindowsmachine.
BuildingtheWindRiverLinuxEdition1.
3KernelforML405RebuildthelinuxkernelbyrunningthefollowingcommandsintheshellopenedontheHostPCin/linuxdirectory:$/wrenv.
sh-pwrlinux-1.
3$make-Cdistlinux.
rebuild2>&1|teelinux.
kernel.
log&GeneratinganACEFileandBootingLinuxonML405ThehardwarebitstreamcreatedwiththehardwaredesignandtheELFfilecreatedwhencompilingLinuxarecombinedintoanACEfile.
TheACEfilewillthenbestoredontheCompactFlashthatisshippedwiththeML405andthekernelbooted.
GeneratinganACEFileforMontaVistaPro4.
0.
1KernelTogeneratetheACEfile(top.
ace),opentheEDKshellbyselectingProject→LaunchEDKShellandexecute:$xmd-tclgenace.
tcl-jprog-boardml405-hwimplementation/download.
bit-elflinux/arch/ppc/boot/images/zImage.
elf-acetop.
aceBootingMontaVistaPro4.
0.
1LinuxonML405InserttheCompactFlashfromtheML405intotheCompactFlashcardwriter.
Copythetop.
acefileintotheml405/myacedirectoryofthecompactflash.
RemoveanyotherACEfilesinthemyacedirectory.
RemovetheCompactFlashfromtheCompactFlashwriterandplugitintotheSystemACECFslotoftheML405board.
SettheSystemACECFswitchontheML405boardtoSystemACEandapplypowertotheboard.
Settheterminalto9600,8N1,andnohandshake.
Inthebootupmenu,selecttheoptionMyownACEfile.
TheusercanobservetheLinuxboot.
Loginwithusernameasrootusingthepassword405mlfortherootaccount.
GeneratinganACEFileforWindRiverLinuxEdition1.
3KernelThefilesystemontheCompactFlashprovidedwiththeML405boarddoesnotworkfortheWindRiverLinuxEdition1.
3.
TodeploytherootfilesystemontheCompactFlash,followtheinstructionsgiveninChapter4.
DeploymentoftheWindRiverLinuxPlatformsGettingStarted1.
3.
Togeneratethetop.
aceACEfile,opentheEDKshellbyselectingProject→LaunchEDKShellandexecuting:$xmd-tclgenace.
tcl-jprog-boardml405-hwimplementation/download.
bit-elflinux/dist/linux-2.
6.
14-cgl/arch/ppc/boot/images/zImage.
elf-acetop.
ace-start_address0x00400000-targetppc_hwConclusionXAPP969(v1.
1)February23,2007www.
xilinx.
com7RBootingWindRiverLinuxEdition1.
3onML405InserttheCompactFlashfromtheML405intotheCompactFlashcardwriter.
Copythetop.
acefileintotheml405/myacedirectoryofthecompactflash.
Removeanyotheracefilesinthemyacedirectory.
InserttheCompactFlashfromtheCompactFlashwriterintotheSystemACECFslotoftheML405board.
SettheSystemACECFswitchontheML405boardtoSystemACEandapplypowertotheboard.
Settheterminalto9600,8N1,andnohandshake.
Inthebootupmenu,selecttheoptionMyownACEfile.
TheusercanobservetheLinuxboot.
Loginwithusernameasrootusingthepasswordrootfortherootaccount.
ConclusionThisapplicationnotedescribesthestepsnecessarysettingupandusingtheEmbeddedDevelopmentKit(EDK)andLinux2.
6frominstallationtobootingtheLinuxkernelonaPowerPC405processoravailableontheML405EvaluationPlatform.
References1.
ML405DevelopmentSystem,Xilinx,Inc.
,http://www.
xilinx.
com/ml4052.
MontaVistaLinuxProfessionalEdition4.
0.
13.
WindRiverLinuxPlatformsGettingStarted1.
34.
AutomaticGenerationofLinux2.
6BoardSupportPackagesintheOSandLibrariesDocumentCollection,providedasapartoftheEDKinstallationin/doc/oslib_rm.
pdf.
RevisionHistoryThefollowingtableshowstherevisionhistoryforthisdocument.
DateVersionRevision12/4/061.
0InitialXilinxrelease.
2/23/071.
1RevisedfromML403EvaluationPlatformtoML405EvaluationPlatform.
Includedadapter.
csource.