重定位编译文件

//=====================================================================
//TITLE:
//    重定位编译文件
//AUTHOR:
//    norains
//DATE:
//    Wednesday  29-September-2010
//Environment:
//    KEIL MDK 4.0
//    .NET Micro Framework
//=====================================================================

 

    如果想将.Net Micro Framework移植到新的硬件平台，免不了要对里面的文件进行一番修改。比如最初的启动文件FirstEntry.s，也许你就要在上面删删减减。那么，遇到这种情况，是不是直接在原文件中修改呢？我想，这应该是最为简单的，也最不容易出错的方法。但如果真的这么做了，那么问题就随之而来了。因为在FirstEntry.s修改的地方，是针对特定平台的，但该文件却是公共的。也就是说，你修改了之后，可能这个文件就不再适合别的Solution了。也许你会说，这没关系，别的Solution我一辈子都不会用到。就假设这说法成立吧，但如果你要将辛勤劳动的成功和别人分享，那你是不是也要求对方将这公共文件也更改呢？万一对方要使用多个Solution呢？所以，我们不应该直接在原文件上进行修正，而要另辟蹊径。

 

    以重定位FirstEntry.s文件为例子。包含该文件的工程位于./DeviceCode/cores/dotNetMF.proj，而这个工程恰好又被NativeSample.proj所依赖。因为移植都是从NativeSample入手，所以我们就在这个文件上进行捣鼓。

 

    首先，将原来的./DeviceCode/cores/dotNetMF.proj文件拷贝到./[SOLUTION]/DeviceCode/CORES/ARM文件夹中。在这里，[SOLUTION]指的是我们目标SOLUTION的路径。

 

    接着，更改NativeSample.proj。之前对于./DeviceCode/cores/dotNetMF.proj的路径依赖是这么写的：

 

    <RequiredProjects Include="$(SPOCLIENT)/DeviceCode/cores/arm/dotNetMF.proj" />

 

    现在我们改为：

 

 <RequiredProjects Include="$(SPOCLIENT)/Solutions/STM32F103ZE_RedCow/DeviceCode/cores/arm/dotNetMF.proj" />

 

    好了，那么现在连接的就是我们的./[SOLUTION]/DeviceCode/CORES/ARM文件了。不过，如果你这时候调用MSBUILD编译的话，肯定会出错。因为原来./DeviceCode/cores/dotNetMF.proj定义的编译文件，都是用相对路径的，现在dotNetMF.proj位置移动了，强制编译肯定要出错。为了修正这个问题，需要将相对路径更改为绝对路径。当然，这绝对路径也不是定死的，因为$(SPOCLIENT)宏定义表示的是.Net Micro Framework的根目录，这对于和朋友分享Solution非常重要。另外一点需要注意的是，除了FirstEntry.s以外，别的都不用重定位，也就还是用原来的文件。

 

    完整的修改后的./DeviceCode/cores/dotNetMF.proj文件如下：

 

<Project ToolsVersion="4.0" DefaultTargets="Build" xmlns="http://schemas.microsoft.com/developer/msbuild/2003">
  <PropertyGroup>
    <AssemblyName>TinyHal</AssemblyName>
    <ProjectGuid>{8b626ac4-c8ce-48d9-a7db-0d59f0874983}</ProjectGuid>
    <Size>
    </Size>
    <Description>Core HAL library</Description>
    <Level>HAL</Level>
    <LibraryFile>TinyHal.$(LIB_EXT)</LibraryFile>
    <ProjectPath>$(SPOCLIENT)/Solutions/STM32F103ZE_RedCow/DeviceCode/cores/arm/dotNetMF.proj</ProjectPath>
    <ManifestFile>TinyHal.$(LIB_EXT).manifest</ManifestFile>
    <Groups>System</Groups>
    <LibraryCategory>
      <MFComponent xmlns:xsi="http://www.w3.org/2001/XMLSchema-instance" xmlns:xsd="http://www.w3.org/2001/XMLSchema" Name="TinyHal_HAL" Guid="{37C37BC0-3CA6-4C1C-A26F-4761A7BA3C05}" ProjectPath="" Conditional="" xmlns="">
        <VersionDependency xmlns="http://schemas.microsoft.com/netmf/InventoryFormat.xsd">
          <Major>4</Major>
          <Minor>0</Minor>
          <Revision>0</Revision>
          <Build>0</Build>
          <Extra />
          <Date>2009-04-30</Date>
        </VersionDependency>
        <ComponentType xmlns="http://schemas.microsoft.com/netmf/InventoryFormat.xsd">LibraryCategory</ComponentType>
      </MFComponent>
    </LibraryCategory>
    <Documentation>
    </Documentation>
    <PlatformIndependent>False</PlatformIndependent>
    <CustomFilter>
    </CustomFilter>
    <Required>False</Required>
    <IgnoreDefaultLibPath>False</IgnoreDefaultLibPath>
    <IsStub>False</IsStub>
    <Directory>Solutions/STM32F103ZE_RedCow/DeviceCode/cores/arm</Directory>
    <PlatformIndependentBuild>false</PlatformIndependentBuild>
    <Version>4.0.0.0</Version>
  </PropertyGroup>
  <Import Project="$(SPOCLIENT)/tools/targets/Microsoft.SPOT.System.Settings" />
  <Import Project="$(SPOCLIENT)/Framework/Features/PreStackInit_HAL.libcatproj" />
  <PropertyGroup>
    <OutputType Condition="'$(PLATFORM_FAMILY)'=='arm'">Library</OutputType>
  </PropertyGroup>

  <ItemGroup Condition="'$(INSTRUCTION_SET)'=='arm' or '$(INSTRUCTION_SET)'=='thumb' ">
    <Compile Include="$(SPOCLIENT)/DeviceCode/cores/arm/AssemblyCode/arm/$(AS_SUBDIR)/cpwait.s" />
    <Compile Include="$(SPOCLIENT)/DeviceCode/cores/arm/AssemblyCode/arm/$(AS_SUBDIR)/FirstEntry.s" />
    <Compile Include="$(SPOCLIENT)/DeviceCode/cores/arm/AssemblyCode/arm/$(AS_SUBDIR)/IDelayLoop.s" />
    <Compile Include="$(SPOCLIENT)/DeviceCode/cores/arm/AssemblyCode/arm/$(AS_SUBDIR)/Sampling_Profiler_RAM.s" />
    <Compile Include="$(SPOCLIENT)/DeviceCode/cores/arm/AssemblyCode/arm/$(AS_SUBDIR)/VectorsHandlers.s" />
    <Compile Include="$(SPOCLIENT)/DeviceCode/cores/arm/AssemblyCode/arm/$(AS_SUBDIR)/VectorsTrampolines.s" />
    <Compile Include="$(SPOCLIENT)/DeviceCode/cores/arm/Diagnostics/FIQAssembly/$(AS_SUBDIR)/FiqSubhandler_MC9328.s"/>
  </ItemGroup>

  <ItemGroup Condition="'$(INSTRUCTION_SET)'=='thumb2'">
    <Compile Include="$(SPOCLIENT)/Solutions/STM32F103ZE_RedCow/DeviceCode/cores/arm/AssemblyCode/thumb2/$(AS_SUBDIR)/FirstEntry.s" />
    <Compile Include="$(SPOCLIENT)/DeviceCode/cores/arm/AssemblyCode/thumb2/$(AS_SUBDIR)/IDelayLoop.s" />
    <Compile Include="$(SPOCLIENT)/DeviceCode/cores/arm/AssemblyCode/thumb2/$(AS_SUBDIR)/Sampling_Profiler_RAM.s" />
    <Compile Include="$(SPOCLIENT)/DeviceCode/cores/arm/AssemblyCode/thumb2/$(AS_SUBDIR)/VectorsHandlers.s" />
    <Compile Include="$(SPOCLIENT)/DeviceCode/cores/arm/AssemblyCode/thumb2/$(AS_SUBDIR)/VectorsTrampolines.s" />
  </ItemGroup>

  <ItemGroup>
    <HFiles Include="$(SPOCLIENT)/DeviceCode/Initialization/MasterConfig.h" />
    <Compile Include="$(SPOCLIENT)/DeviceCode/cores/arm/Diagnostics/Aborts.cpp" />
    <Compile Include="$(SPOCLIENT)/DeviceCode/cores/arm/Diagnostics/FIQ_Profiler.cpp" />
    <Compile Include="$(SPOCLIENT)/DeviceCode/cores/arm/Diagnostics/RamTest.cpp" />
    <Compile Include="$(SPOCLIENT)/DeviceCode/cores/arm/Diagnostics/RamTest.h" />
    <LIB_FIRSTENTRY_OBJ Include="$(OBJ_DIR)/FirstEntry.$(OBJ_EXT)" />
  </ItemGroup>
  <ItemGroup>
    <ExtraProjects Include="$(SPOCLIENT)/DeviceCode/cores/arm/dotNetMF_loader.proj" Condition="'$(PLATFORM_FAMILY)'=='arm'" />
  </ItemGroup>
  <Import Project="$(SPOCLIENT)/tools/targets/Microsoft.SPOT.System.Targets" />
</Project>

 

    从修改后的文件看出，不用重定位的文件都以$(SPOCLIENT)/DeviceCode为路径前缀，如：

 

 <Compile Include="$(SPOCLIENT)/DeviceCode/cores/arm/AssemblyCode/thumb2/$(AS_SUBDIR)/IDelayLoop.s" />

 

    只有需要重定位的FirstEntry.s文件的路径前缀不同，如：

 

<Compile Include="$(SPOCLIENT)/Solutions/STM32F103ZE_RedCow/DeviceCode/cores/arm/AssemblyCode/thumb2/$(AS_SUBDIR)/FirstEntry.s" />

 

    这个语句的意思是，需要编译的FirstEntry.s文件是位于我们的./Solution/[SOLUTION]/cores/ARM目录之下的，而不是的原文件。

 

    在这里唯一需要注意的是，STM32F103ZE_RedCow是我所建立的Solution的文件夹名，如果你的Solution和我的不同，只需要直接修改即可。