【.Net Micro Framework PortingKit – 12】SysTick驱动开发

SysTick驱动对TinyCLR来说非常重要，.Net Micro Framework系统的多线程和多任务（对托管代码来说是单任务多线程，但是还存在和托管代码同时运行的任务，如我们用MFDeploy程序Ping TinyCLR或擦写Flash 的时候，就是另外的任务在执行）就是靠它来实现的。

SysTick驱动有三个功用，一是我们上面所说的多任务和多线程支持；二是获得系统当前Tick，以此实现延时等待，比如我们常见的Events_WaitForEvents函数就靠它来实现延时功能的；三是为Native代码提供两个版本的Sleep函数。

和ARM7或ARM9相比，Cortex-M3系列的CPU提供了SysTick这个feature，所以我们就不需要用Timer来模拟Tick的功能了，直接用系统提供的SysTick就可以了。Cortex-M3的SysTick其定时器计数是递减的，递减到0就会触发中断（当然要使TICKINT使能），然后自动会加载LOAD寄存器的值，启动下一次计数循环。

LOAD寄存器可填入的最大值为0x00FFFFFF，对72M主频的CPU来说，大概会有250毫秒左右的延时。由于VAL寄存器的值是递减的，所以在移植相关代码的时候要特别注意，我们概念中的Tick的值应该是（LOAD-VAL）。

在CortexM3.h文件中添加如下代码，以便于配置SysTick寄存器。

struct CortexM3_SysTick

{

    static const UINT32 c_Base = 0xE000E010;

    /****/ volatile UINT32 CTRL;  //0xE000E010

    static const    UINT32 CTRL_COUNTFLAG= ((UINT32)0x00010000); 

    static const    UINT32 CTRL_CLKSOURCE= ((UINT32)0x00000004);

    static const    UINT32 CTRL_TICKINT= ((UINT32)0x00000002);

    static const    UINT32 CTRL_ENABLE= ((UINT32)0x00000001);

    /****/ volatile UINT32 LOAD;  //0xE000E014

    static const    UINT32 LOAD_RELOAD= ((UINT32)0x00FFFFFF); 

    /****/ volatile UINT32 VAL;  //0xE000E018

    static const    UINT32 VAL_CURRENT= ((UINT32)0x00FFFFFF); 

    /****/ volatile UINT32 CALIB;  //0xE000E01C

    static const    UINT32 CALIB_NOREF= ((UINT32)0x80000000); 

    static const    UINT32 CALIB_SKEW= ((UINT32)0x40000000); 

    static const    UINT32 CALIB_TENMS= ((UINT32)0x00FFFFFF);     

};

然后在/DeviceCode/Targets/Native/CortexM3/DeviceCode/SysTick新建四个文件SysTick.h、SysTick.cpp、SysTick_Functions.cpp、dotNetMF.proj。

在SysTick.h中创建SYSTICK_Driver结构体，SysTick.cpp存放该结构体的具体实现代码。

struct SYSTICK_Driver

{

    static const UINT32 c_MaxTimerValue = 0xFFFFFF; //16777215  最大 250ms左右的定时

 

    volatile UINT64 m_Tick;

    volatile UINT64 m_nextCompare;

   

    static BOOL Initialize  ();

    static BOOL Uninitialize();

    static UINT64 CounterValue();

    static void SetCompareValue( UINT64 CompareValue );

    static INT64 TicksToTime( UINT64 Ticks );

    static INT64 CurrentTime();

    static void Sleep_uSec( UINT32 uSec );

    static void Sleep_uSec_Loop( UINT32 uSec );

    static void ISR( void* Param );

};

Cortex-M3内核下的UINT64 CounterValue()函数的具体实现不同于.Net Micro Framework自带的各平台上的源码，所以有必要介绍一下它的实现：

UINT64 SYSTICK_Driver::CounterValue()

{

    GLOBAL_LOCK(irq);

    CortexM3_SysTick &SysTick= CortexM3::SysTick();

    UINT32 value = (SysTick.LOAD - SysTick.VAL);

  

    if(SysTick.CTRL & CortexM3_SysTick::CTRL_COUNTFLAG)

    {

        g_SYSTICK_Driver.m_Tick+=SysTick.LOAD;          

    }

    

    return  g_SYSTICK_Driver.m_Tick + value;

}

Value的值为(SysTick.LOAD - SysTick.VAL)，这是和其它平台的驱动一个区别。此外m_Tick也是我新添加的，它是不断累加计数的，但是它不能真实反映系统开机以来的Tick数，因为SysTick有可能会被禁止中断，也就是说ISR函数不能保证整个系统运行期内都被正常触发。

ISR是一个重点，它是系统实现多任务和多线程的“动力源”。

void SYSTICK_Driver::ISR( void* Param )

{   

    if(CounterValue() >= g_SYSTICK_Driver.m_nextCompare)

    {

       HAL_COMPLETION::DequeueAndExec();

    }

    else

    {

        SetCompareValue( g_SYSTICK_Driver.m_nextCompare );

    }

}

HAL_COMPLETION::DequeueAndExec()代码是关键，每间隔一个指定的时间就会执行一次任务，常见间隔时间为20ms。

Sleep_uSec函数是通过Tick计数计算延时间隔的。

void __section(SectionForFlashOperations) SYSTICK_Driver::Sleep_uSec( UINT32 uSec )

{

    GLOBAL_LOCK(irq);

    CortexM3_SysTick &SysTick= CortexM3::SysTick();  

    UINT32 maxDiff  = CPU_MicrosecondsToTicks( uSec );   //每微秒的滴答数

        SysTick.LOAD =   maxDiff & 0xFFFFFF;  

    while(!(SysTick.CTRL & CortexM3_SysTick::CTRL_COUNTFLAG));

}

__section(SectionForFlashOperations)标识该函数会被拷贝到RAM中去运行（保证执行时间）。

而Sleep_uSec_Loop函数则是通过汇编代码的循环实现的，延时相对比较精确。

void __section(SectionForFlashOperations) SYSTICK_Driver::Sleep_uSec_Loop( UINT32 uSec )

{

    // iterations must be signed so that negative iterations will result in the minimum delay

    uSec *= (SYSTEM_CYCLE_CLOCK_HZ / CLOCK_COMMON_FACTOR);

    uSec /= (ONE_MHZ               / CLOCK_COMMON_FACTOR);

 

    // iterations is equal to the number of CPU instruction cycles in the required time minus

    // overhead cycles required to call this subroutine.

    int iterations = (int)uSec - 14;      // Subtract off call & calculation overhead

    CYCLE_DELAY_LOOP2(iterations);

}

CYCLE_DELAY_LOOP2的实现代码是汇编，我把它放在FirstEntry.s文件里了，具体代码如下：

IDelayLoop2

    EXPORT  IDelayLoop2

    subs    r0,r0, #2          ;; 1 cycle

    bgt     IDelayLoop2        ;; 1 cycle

      mov     pc, lr              ;; 5 cycles 

Sleep_uSec_Loop函数实现代码中的uSec – 14是从其它CPU代码中拷贝来的，针对Cortex-M3应该是多少，我还没有细算过，以后有时间再补上这一课。

在NativeSample.proj中添加如下条目，就可以测试SysTick驱动了：

  <ItemGroup>

    <RequiredProjects Include="$(SPOCLIENT)/DeviceCode/Targets/Native/CortexM3/DeviceCode/SysTick/dotNetMF.proj" />

    <DriverLibs Include="SysTick.$(LIB_EXT)" />

  </ItemGroup>

在NativeSample.cpp中我们只能通过Events_WaitForEvents( 0, 1000 )代码测试SysTick驱动的一部分功能，全部的功能要在TinyCLR项目去测试了。

小插曲：在实现LCD驱动的时候，初始化LCD寄存器需要延时，在采用CYCLE_DELAY_LOOP2时，debug版本和release版本有很大的区别，debug可正常运行，但是release会有问题，在Sleep_uSec_Loop函数开始添加GLOBAL_LOCK(irq)代码就可以了，但是这样一改在TinyCLR代码中能正常运行的debug版本就会出问题了。可见嵌入式开发的难点不在于代码的编写，而在于调试。