不可或缺的PrepareImageRegions函数

//=====================================================================
//TITLE:
// 不可或缺的PrepareImageRegions函数
//AUTHOR:
// norains
//DATE:
// Friday 3-December-2010
//Environment:
// MDK 4.1
// .Net Micro Framework 4.1
//=====================================================================

如果大家看了《main函数之前究竟发生了什么？》（http://blog.csdn.net/norains/archive/2010/12/03/6052029.aspx）这篇文章，应该已经知道在main函数之前，MDK究竟为我们做了什么。但如果转到.NMF，可能大家就犯愁了：.NMF没有main函数！这看起来似乎不是什么大问题，但实际上这问题却很严重。根据文档我们可以知道，MDK只有发现存在main函数的定义的时候，才会自动生成__main函数！如果没有__main函数，很多初始化就无法完成，离散文件中的装载域就无法映射到执行域。

如果你还不明白这无法映射的严重性，那么我们来看个例子。有一个全局的static变量g_iVal，它初始化的代码如下：

static int g_iVal = 50;

假如代码的装载域无法映射到运行域的话，那么最直接的结果就是，当你使用g_iVal时，数值不是50，而是一个随机的数值！我想，再也不会有比这更严重的事情了吧？

为什么会有这结果呢？因为我们的代码是放在装载域（可能是flash，也可能是其它），g_iVal的数值自然也处在该域；但程序跑起来之后，g_iVal的地址已经被印射到内存（也就是执行域），但其数值却有没有被拷贝到相应的内存位置！我们用MDK生成的工程进行调试，之所以数值会被拷贝到执行域，是因为有__main函数打理这一切！

那么现在在.NMF的环境下，我们要如何做到这步？莫非要自己声明一个main函数，然后手动调用__main？答案自然是不行，因为.NMF的设置，会让MDK不会自动生成__main函数！那么我们应该怎么做？其实答案很简单，之所以前面会啰嗦那么一大堆，主要是解释为什么会产生这种情况的原因，以及这种情况所带来的结果而已。如果要解决这问题，只需要在你的solution的BootstrapCode函数中调用PrepareImageRegions函数即可。

PrepareImageRegions函数是在tinyhal.CPP中实现的，其完整的代码如下：

void __section(SectionForBootstrapOperations) PrepareImageRegions()
{
    //
    // Copy RAM RO regions into proper location.
    //
    {
        UINT32* src = (UINT32*)&LOAD_RAM_RO_BASE; 
        UINT32* dst = (UINT32*)&IMAGE_RAM_RO_BASE;
        UINT32  len = (UINT32 )&IMAGE_RAM_RO_LENGTH; 

        Prepare_Copy( src, dst, len );
    }

    //
    // Copy RAM RW regions into proper location.
    //
    {
        UINT32* src = (UINT32*)&Load$$ER_RAM_RW$$Base; 
        UINT32* dst = (UINT32*)&Image$$ER_RAM_RW$$Base;
        UINT32  len =  (UINT32)&Image$$ER_RAM_RW$$Length; 

        Prepare_Copy( src, dst, len );
    }

    //
    // Initialize RAM ZI regions.
    //
    {
        UINT32* dst = (UINT32*)&Image$$ER_RAM_RW$$ZI$$Base;
        UINT32  len = (UINT32 )&Image$$ER_RAM_RW$$ZI$$Length;

        Prepare_Zero( dst, len );
    }
}

 

代码条理非常简单，无非就是获取装载域和执行域的地址，然后通过Prepare_Copy进行拷贝而已。而这Prepare_Copy的实现也仅仅是个循环，然后赋值，代码如下：

static void __section(SectionForBootstrapOperations) Prepare_Copy( UINT32* src, UINT32* dst, UINT32 len )
{
    if(dst != src)
    {
        while(len)
        {
            *dst++ = *src++;

            len -= 4;
        }
    }
}

唯一让各位迷惑的可能是类似& Image$$ER_RAM_RW$$Base这样的变量是哪里来的，其实源头就在于离散文件，也就是solution下面的scatterfile_tools_XXX.xml文件。比如，& Image$$ER_RAM_RW$$Base变量对应的就是scatterfile_tools_XXX.xml中所定义的ER_RAM_RW。