|
__user_initial_stackheap()<br />RealView Compilation Tools for µVision Libraries and Floating Point Support Guide Version 4.0 <br /> <br />Home > The C and C++ Libraries > Tailoring the runtime memory model > __user_initial_stackheap() <br /><br />2.10.5. __user_initial_stackheap()<br />__user_initial_stackheap()在旧程序中比较常见,该函数的最新替代函数为__user_setup_stackheap().<br /><br />Migrating to RVCT v4.0 from RVCT v2.x and earlier<br />RVCT v2.x 及之前的版本, Image$$ZI$$Limt的值决定是否调用__user_initial_stackheap()。如果开发人员使用scatter文件,那么 Image$$ZI$$Limt不会被定义,此时开发人员必须重新实现__user_initial_stackheap()的函数体,不然编译不会成功。<br /><br />或者,在程序中可以用 __user_setup_stackheap() 来代替__user_initial_stackheap()。<br /><br />Migrating to RVCT v4.0 from RVCT v3.x<br />RVCT v3.x 及之后版本， µVision 库里包含了更多__user_initial_stackheap()的函数体,这样编译器可以根据开发人员scatter文件的内容自动选择合适的函数体。换句话说，针对RVCT v3.x及之后的版本，使用scatter文件的开发人员可以不再重新实现__user_initial_stackheap()的函数体。 See Using a scatter-loading description file for more information.<br /><br />语法<br />extern __value_in_regs struct __user_initial_stackheap __user_initial_stackheap(unsigned R0, unsigned SP, unsigned R2, unsigned SL);<br />用法<br />__user_initial_stackheap() 的返回值规则：<br /><br />堆底地址放在 r0，堆底指堆内最小地址<br /><br />栈顶地址放在r1，栈顶指栈内最大地址<br /><br />堆顶地址放在r2，堆顶指堆内最大地址<br /><br />栈底地址放在 r3，栈底指栈内最小地址。<br /><br />如果该函数函数体重新定义,必须遵循三点：<br /><br />使用栈的字节数必须小于88 bytes<br /><br />除了 r12 (ip)之外不能乱用别的寄存器<br /><br />堆内需要保持8字节对齐。（栈里应该也需要,看KEIL的例程）<br /><br />针对默认的 one-region 模型, r2 和 r3 中的值被忽略,r0 和 r1中存储的两个地址之间存储区都被堆所使用。针对 two-region 模型, 堆顶地址由 r2中的值决定,栈底地址由r3中的值决定。<br /><br />当__main() 被调用时,sp (r13)的值会被作为参数传递到r1中。__user_initial_stackheap()的默认函数体由sys_stackheap.o目标提供（ using the semihosting SYS_HEAPINFO） 。<br /><br />To create a version of __user_initial_stackheap() that inherits sp from the execution environment and does not have a heap, set r0 and r2 to the value of r3 and return. See __user_setup_stackheap()) for more information. <br /><br />rt_misc.h中__initial_stackheap 结构体的定义：<br /><br />struct __initial_stackheap{<br /> unsigned heap_base, stack_base, heap_limit, stack_limit;<br />};<br />注意<br />由于使用全递减栈，stack_base 的值等于栈内最高地址加0x1<br /><br />See the examples directory for example reimplementations of this function.<br /><br />返回值<br />使用One-region存储器模型或Two-region存储器模型决定r0 到 r3中的返回值 ：<br /><br />One-region <br /><br />(r0,r1) 是单一的堆+栈区域. r1 大于 r0.，r2 和 r3 忽略。<br /><br />Two-region <br />(r0, r2) 分配为堆， (r3, r1) 分配为栈. r2 大于等于 r0. r3 小于 r1.<br /><br />使用scatter-loading （分散加载）描述文件<br />默认__user_initial_stackheap() 函数体需要使用Image$$ZI$$Limt模型,如果开发人员使用scatter文件的话,Image$$ZI$$Limt模型不会被定义。然而, µVision 的C库里提供了一些__user_initial_stackheap() 的函数体，开发人员可以通过scatter文件中的内容来控制开发环境来调用具体哪一个函数体。<br /><br />自动选择 one-region 存储器模型<br />在分散加载文件中定义一个特殊的执行域ARM_LIB_STACKHEAP.，给该域定义EMPTY 属性。<br /><br />这样,编译器就会从库中选择一个__user_initial_stackheap() 的函数体以ARM_LIB_STACKHEAP为堆-栈合并域,这个函数体需要用到 Image$$ARM_LIB_STACKHEAP$$Base 和Image$$ARM_LIB_STACKHEAP$$ZI$$Limit两个模型。<br /><br />自动选择 two-region 存储器模型<br />在分散加载文件中定义两个特殊的执行域,ARM_LIB_HEAP 和 ARM_LIB_STACK.，给这两个域都定义EMPTY 属性。<br /><br />这样,编译器就会从库中选择一个用到 Image$$ARM_LIB_HEAP$$Base, Image$$ARM_LIB_HEAP$$ZI$$Limit, Image$$ARM_LIB_STACK$$Base, and Image$$ARM_LIB_STACK$$ZI$$Limit.四个模型的__user_initial_stackheap() 的函数体。<br /><br />sp会通过ARM_LIB_STACKHEAP （one-region 存储器模型）或者 ARM_LIB_STACK （two-region 存储器模型）进行初始化。<br /><br />错误信息<br />如果使用了scatter文件，但是没有在scatter文件中定义特定的域（ARM_LIB_STACKHEAP/ARM_LIB_HEAP 和 ARM_LIB_STACK），也没有重定义__user_initial_stackheap(),函数体，函数库在调试信息中报错。<br /><br />Copyright © 2007, 2008 ARM Limited. All rights reserved. ARM DUI 0378B <br />Non-Confidential Unrestricted Access <br /> <br />Home > The C and C++ Libraries > Tailoring the runtime memory model > __user_initial_stackheap() <br /><br />Copyright © Keil, An ARM Company. All rights reserved.<br /> |
|
楼主
