Freescale Semiconductor 802.15.4 manual Chapter Port Integration Reference Guide, 1 HCS08 Compiler

Page 43

Chapter 6

Port Integration Reference Guide

This chapter describes the Embedded Bootloader source code release deliverables and how to integrate them to make an executable Embedded Bootloader for a specific PCB.

NOTE

For user convenience, several readme.txt files containing more information are located in various subfolders.

6.1 Embedded Bootloader Build Environment

This chapter describes the Embedded Bootloader build environment. The Embedded Bootloader application is built under the Metrowerks IDE CodeWarrior Development Studio for Freescale HC08 3.0, build 030506.

6.1.1 HCS08 Compiler

All Embedded Bootloader source files are compiled with the following compiler and with the ‘Generate Code for HCS08’ Code Generation option enabled.

Source file:

hw_hc08_compiler.dll, version 5.0.8.0

Setting: -Cs08 -CswMaxLF0 -CswMinLF0 -CswMinSLB9999 -Lasm=%n.lst -Lasmc=h - Ot -Ou -Onf -OnB=alr -OnCstVar -OnPMNC -Or -TE1uE -WmsgNu=acdet

6.1.2 HCS08 Linker

All Embedded Bootloader object files are linked with the following linker to build an executable file.

Source file:

hw_hc08_linker.dll, version 5.0.8.0

Setting:

-B -EnvSRECORD=s19 -EnvTEXTPATH=Zigbee_Data\Zigbee_Debug\ -

 

WStdoutOn

The Embedded Bootlaoder MUST be linked with the following linker file.

.\Embedded_Bootloader\prm\Embedded_Bootloader_HCS08.ach

Specific allocated code and variables must not be reallocated, but users can add new code and data segments.

NOTE

The 802.15.4 and Zigbee applications that interface to the Embedded Bootloader must be linked with the "Ptc_w_Embedded_Bootloader.ach" file for proper functionality.

6.1.3 HCS08 LibMaker

The delivered libraries were made with the following libmaker.

Freescale Semiconductor

Embedded Bootloader Reference Manual, Rev. 0.0

6-1

Image 43
Contents 802.15.4/Zigbee Embedded Bootloader How to Reach Us USA/Europe/Locations Not Listed Contents Embedded Bootloader Programming Embedded Bootloader Public Function Description Audience Conventions References Target Chapter Embedded Bootloader DescriptionAxiom AXM-0308 Ported TargetsPotential Issues FeaturesBenefits Optional Firmware Upload Settings Upload Firmware Chapter Using the Embedded BootloaderUse Case One Use Case Two Safe Mode BootUpdating Non-volatile Memory NVM An Example of How to Change the MAC AddressUart Baud Rate System Bus FrequencyChapter Test Tool Zigbee Flash Tool Graphical User Interface GUI Version Using the Tools Menu OptionView Menu Option Using the View Menu OptionFirmware Upload Selecting the Firmware File to UploadAfter a Successful Firmware Upload Changing the NVM Data in Flash or File Using the Help MenuSystem Configuration Window Command Line Version Parameter List Command Line Version CMDFlash Erase Disabled Example Normal Use Example DefaultEmbedded Bootloader Reference Manual, Rev Programming To An Empty Erased Board Chapter Embedded Bootloader ProgrammingConnection Assistant Window Load Executable Window Status Window Upgrading The Embedded Bootloader Connection Assistant Window Programmer Expert Window S19 File Window Status Window Embedded Bootloader Reference Manual, Rev Application Support Files Embedded Bootloader ImageChapter Application Integration Reference Guide Product DeliverablesCompiler Defines Unreferenced SymbolsApplication Application Linker File2 Gb60io.h System Clock SetupApplication Support Files DigiType.h3 Crt0.c and Crt.h NVData.c and NVData.h EmbeddedBootloader.h and EmbeddedBootloader.cISRVectors.c DummyIsr.c 2 HCS08 Linker Embedded Bootloader Build EnvironmentChapter Port Integration Reference Guide 1 HCS08 CompilerSource Files EmbeddedBootloader.mcpEmbeddedBootloaderFunctionalityLib.Lib 2 HCS08FlashLib.LibCompiler #defines Porting to a Specific TargetCode and Data Segments Standard LibrariesTarget.h Source FilesEmbeddedBootloaderTarget.h ResetVector.cHWInit.c HWInit.hMain.c 802.15.4/Zigbee Application Accessible Functions Chapter Embedded Bootloader Public Function DescriptionEnableDownloadFirmware Embedded Bootloader boot flag UpdateNVRAM HardResetFLICGSetup NVFlashSetupOutput None UARTPortSelectEmbedded Bootloader Reference Manual, Rev 128 Direct Port Registers Chapter Embedded Bootloader Memory Map1BFF 4BFF 4DFF 4FFF 8BFF 8DFF 8FFF Embedded Bootloader Reference Manual, Rev FFB0 Ffbf Cursive = fixed register and vectors in flash Embedded Bootloader Reference Manual, Rev Folder Structure Appendix a Release Folder and File StructureFile Structure EmbeddedBootloaderFunctionalityLib.Lib Functionality library Embedded Bootloader Reference Manual, Rev