Page Comparison

This experiment uses the HDMI display and timer counter function of the Plus1 7021 platform to introduce the basic programming method, which involves interrupt use. The Plus1 7021 system provides four general-purpose 16-bit This experiment uses the HDMI display and timer counter function of the Plus1 7021 platform to introduce the basic programming method, which involves interrupt use. The Plus1 7021 system provides four general-purpose 16-bit count timers, timer0 to timer3. When the preset value is reached, the corresponding interrupt signal is generated by each timer。

...

The corresponding 32-bit registers are described in detail, please refer to the online technical documentation provided as follows:

10. General Purpose Timers

Here is a brief introduction to the meaning of related registers, as shown in the following table:

安装目录 The regmap_q628.h under the installation directory \SP7021\workspace\sp7021\ include 文件夹下的regmap_q628.h定义了这四个寄存器，如下图红色folder defines these four registers, as marked in red below:

regmap_q628.h

struct stc_regs {

    unsigned int stc_15_0;       // 12.0

    unsigned int stc_31_16;      // 12.1

    unsigned int stc_64;         // 12.2

    unsigned int stc_divisor;    // 12.3

    unsigned int rtc_15_0;       // 12.4

    unsigned int rtc_23_16;      // 12.5

    unsigned int rtc_divisor;    // 12.6

    unsigned int stc_config;     // 12.7

    unsigned int timer0_ctrl;    // 12.8 Timer Register

    unsigned int timer0_cnt;     // 12.9 Timer Register

    unsigned int timer1_ctrl;    // 12.10 Timer Register

    unsigned int timer1_cnt;     // 12.11 Timer Register

    unsigned int timerw_ctrl;    // 12.12

    unsigned int timerw_cnt;     // 12.13

    unsigned int stc_47_32;      // 12.14

    unsigned int stc_63_48;      // 12.15

    unsigned int timer2_ctl;     // 12.16 Timer Register

    unsigned int timer2_pres_val;// 12.17 Timer Register

    unsigned int timer2_reload;  // 12.18 Timer Register

    unsigned int timer2_cnt;     // 12.19 Timer Register

    unsigned int timer3_ctl;     // 12.20 Timer Register

    unsigned int timer3_pres_val;// 12.21 Timer Register

    unsigned int timer3_reload;  // 12.22 Timer Register

    unsigned int timer3_cnt;     // 12.23 Timer Register

    unsigned int stcl_0;         // 12.24

    unsigned int stcl_1;         // 12.25

    unsigned int stcl_2;         // 12.26

    unsigned int atc_0;          // 12.27

    unsigned int atc_1;          // 12.28

    unsigned int atc_2;          // 12.29

    unsigned int timer0_reload;  // 12.30 Timer Register

    unsigned int timer1_reload;  // 12.31 Timer Register

};

#define STC_REG     ((volatile struct stc_regs *)RF_GRP(12, 0))

HDMI显示及定时器中断控制实验需要如下3个文件，如下：The HDMI display and timer interrupt control experiment require the following 3 files, as follows：

1） 安装目录 Install directory \SP7021\workspace\sp7021\ 文件夹下的mainmain.c

2） 安装目录 Install directory \SP7021\workspace\sp7021\testapi\util 文件夹下的timer\timer.c

3） 安装目录 Install directory \SP7021\workspace\sp7021\include\util\util文件夹下的timertimer.h

main.c

int main(void)

{

    printf("Build @%s, %s\n", __DATE__, __TIME__);

    hw_init();

    sys_init();

disp_hdmi_init();

    timer_test_init();/*interrupt test api */

    sp_interrupt_setup(); /* interrupt manager module init */

    while(1);

}

Step1:首先时系统及硬件初始化：hw: First, system and hardware initialization: hw_init (); sys_init ();

Step2: HDMI 显示初始化设置display initialization setting disp_hdmi_init ()，如下：, as follows：

void disp_hdmi_init()

{

    sp_disp_init();

    sp_enable_log_to_osd();

    sp_osd_draw_string("Display and Timer test...",240,50,20,113);

}

The function of sp_enable_log_to_osd () 的功能实现将串口调试信息printfrealizes sending serial debugging information printf () 送到HDMI显示接口to HDMI display interface;

The function of sp_osd_draw_string（）的功能实现在HDMI显示画面的指定坐标位置显示ASCII字符string () realizes the display of ASCII characters at the specified coordinate position of the HDMI display screen

Step3: 然后时调用timer.c中定义的计数定时器初始化函数timerThen call the count timer initialization function timer_test_init () defined in timer.c;

Step4: 最后调用系统中断管理函数spFinally call the system interrupt management function sp_interrupt_setup ();

上面的4个函数只有timerOf the above four functions, only timer_test_init () 是由用户根据应用需求编写，其它都是系统提供。timer_test_init() 的函数体实现在timer.c中，负责计数定时器timer3进行初始化工作，包含计数时钟的选择，定时值设置，定时器中断配置及对应的中断处理函数操作。is written by the user according to the application requirements, and the others are provided by the system.

The function body of timer_test_init () is implemented in timer.c, which is responsible for the initialization of counting timer timer3, including the selection of counting clock, setting of timer value, timer interrupt configuration and corresponding interrupt processing function operation.

 timer.c

#include "common_all.h"

#include "cache.h"

#include "sp_interrupt.h"

#define TIMER3_TICKS        (90 - 1)        /* 1s */

#define TIMER3_CONFIG_STC   (1 << 2)    /* src: stc */

#define TIMER3_RELOAD       (1 << 1)    /* timer3 auto reload */

#define TIMER3_RUN          (1 << 0)    /* timer3 run */

#define TIMER3_STOP         (0 << 0)    /* timer3 stop */

#define TIMER3_INT  (154)

static unsigned int g_repeat_cnt = 0;

void timer3_interrupt_control_mask(int enable)

static void timer3_isr_cfg()

void timer3_callback(void)

void timer_test_init()

timer.c提供实现定时器控制实验的4个方法函数及宏定义，分别讲解如下：c provides 4 method functions and macro definitions for implementing timer control experiments, which are explained as follows：

 void timer3_interrupt_control_mask(int enable)

{

    if (enable != 0) {

        /* enable timer3 interrupt */

        hal_interrupt_unmask(TIMER3_INT);

    } else {

        hal_interrupt_mask(TIMER3_INT);

    }

}

用来控制计数定时器3中断的开与关;enable为0时关闭中断，为1时开启中断}

}

Used to control the opening and closing of the count timer 3 interrupt; when the enable is 0, the interrupt is turned off, and when it is 1, the interrupt is turned on

static void timer3_isr_cfg() 

{

    printf("[CFG] Timer3\n");

    STC_REG->timer3_ctl = TIMER3_CONFIG_STC | TIMER3_RELOAD;

    STC_REG->timer3_pres_val = 999;

    STC_REG->timer3_reload = TIMER3_TICKS;

    STC_REG->timer3_cnt = TIMER3_TICKS;

    hal_interrupt_configure(TIMER3_INT, 0, 1);

    timer3_interrupt_control_mask(1);

    STC_REG->timer3_ctl |= TIMER3_RUN;

}实现计数定时器每1秒产生1次中断，相关配置工作如下：

Realize that the count timer generates an interrupt every 1 second. The related configuration work is as follows：

1)    STC_REG->timer3_ctl = TIMER3_CONFIG_STC | TIMER3_RELOAD;

计时钟选择STC 90KHZ 时钟；操作方式为重复操作Select clock as STC 90KHZ clock; operation mode is repeated operation

2)    STC_REG->timer3_pres_val = 999;   计数时钟预处理设置为999，表示每收到1000个STC 90KHZ时钟，timer3 才计数1次；= 999;

   Counting clock preprocessing is set to 999, which means that timer3 only counts once every 1000 STC 90KHZ clocks are received；

3)    STC_REG->timer3_reload = TIMER3_TICKS;

计数预值设置为89, 表示timer3 计数90次后，重新开始计数The pre-count value is set to 89, which means that timer3 starts counting again after 90 times

4)    STC_REG->timer3_cnt = TIMER3_TICKS;计数初值设置为89，因为计数器是 UP to DOWN 的方式，即从初值计数到0完成1次操作；

The initial count value is set to 89, because the counter is UP to DOWN, that is, from the initial value count to 0 to complete 1 operation；

5)    hal_interrupt_configure(TIMER3_INT, 0, 1);这是系统提供的中断设置函数，共有3个参数需要设置，如下：

This is the interrupt setting function provided by the system. There are 3 parameters to be set, as follows：

     void hal_interrupt_configure(int vector, int level, int up)

     int vector ：中断号，系统分配指定，每个定时器都有自己专门的中断号：

time0的中断号是151

time1的中断号是152

time2的中断号是153

time3的中断号是154：Interrupt number, assigned by the system, each timer has its own dedicated interrupt number：

The interrupt number of time0 is 151

The interrupt number of time1 is 152

The interrupt number of time2 is 153

The interrupt number of time3 is 154

     int level ：中断信号触发方式

0：边沿触发

1：电平触发：Interrupt signal trigger mode

0：Edge trigger

1：Level trigger

     int  up    ：中断信号极性方式

0：负极性(负边沿或负电平)

1：正极性(正边沿或正电平：Interrupt signal polarity

0：Negative polarity (negative edge or negative level)

1：Positive polarity (positive edge or positive level)

6)    timer3_interrupt_control_mask(1);    开启计数定时器3中断

Turn on count timer 3 interrupt

7)    STC_REG->timer3_ctl |= TIMER3_RUN;

    启动计数定时器3,计数开始    Start counting timer 3, counting starts

void timer3_callback(void)

{

    printf("@Timer3[%d]\n", ++g_repeat_cnt);

}是对应的中断处理函数操作，将中断的次数显示在IDE 环境的Terminal窗口，同时也送到HDMI终端显示。

It is the corresponding interrupt processing function operation, which displays the number of interrupts in the Terminal window of the IDE environment, and also sends them to the HDMI terminal for display.

void timer_test_init()

{

    static interrupt_operation timer3_opt;

    memcpy(timer3_opt.dev_name, "Timer3", strlen("Timer3"));

    timer3_opt.vector = TIMER3_INT;

    timer3_opt.device_config = timer3_isr_cfg;

    timer3_opt.interrupt_handler = timer3_callback;

    interrupt_register(&timer3_opt);

}

是中断初始化操作，完成中断函数的注册，包含上面定义的3个函数的调用_opt);

}

It is an interrupt initialization operation to complete the registration of the interrupt function, including the call of the three functions defined above

timer.h

#ifndef __TIMER_H__

#define __TIMER_H__

void timer_test_init();

#endif // __TIMER_H__

When a function in timer.c 中的函数被其它文件中的函数调用时，需要在timer.h中申明在Plus1 IDE环境中compile后，下载到平台运行，在terminal窗口看到如下信息is called by a function in another file, it needs to be declared in timer.h

After compile in the Plus1 IDE environment, download to the platform to run, and see the following information in the terminal window

...