在mm32f3270上为MicroPython启用Timer模块

2024-02-28 13:32

本文主要是介绍在mm32f3270上为MicroPython启用Timer模块,希望对大家解决编程问题提供一定的参考价值,需要的开发者们随着小编来一起学习吧!

在mm32f3270上为MicroPython启用Timer模块

文章目录

  • 在mm32f3270上为MicroPython启用Timer模块
    • Requirements
    • Implementation
    • Application

昨天阅读micropython的材料时,特别注意了这个名字的写法,官方正式使用的是“MicroPython",确实有两个字母是大写的。我在这个项目的开发过程中一直秉承继承原汁原味的原生风格,自然也要使用“正确”的名字。后面的笔记中,均使用“MicroPython”这个名字。

Requirements

MicroPython的开发者官网文档中描述了对Timer模块的规范定义:https://docs.micropython.org/en/latest/library/machine.Timer.html

Timer的实例化传参直接用的id号,并且支持一个“-1”的id号表示创建虚拟定时器。“-1”的id号是可选项。我打算仅实现硬件对应的id。软件定时器意思不大。

Timer暴露给用户的全部是通过callback实现的,我看到esp的实现里有value函数,但标准实现中没有,我认为这个意思不大,也就不实现了。

Timer就是基本定时器,周期计数而已,用户在初始化实例的时候,指定唤醒频率即可直接启动,连start函数都没有。但有两种唤醒模式,分别对应两个累成员变量:Timer.ONE_SHOT和Timer_PERIODIC。

Timer相对于别的模块,一个实现难点是,增加的 callback 的机制。但 callback 函数是在 python 代码中传入的,怎么能在 C 语言层面上硬件中断服务程序中被调用呢。通过阅读stm32、mimxrt 和 esp 的移植,发现了一个关键的函数 mp_sched_schedule()函数,用于在定时器中断到来之时,实现在C语言层面上将python的程序注入到python内核的主线程参与调度的做法。目前只找到了一篇文章对 mp_sched_schedule() 函数的机制简要说明,见《MicroPython中Python与C代码是如何交互的》

mimxrt 的 Timer 基于 PIT 实现,固定使用一个 PIT,但是使用了其中的多通道。在 MM32 的实现上,具有的多通道的定时器(tim_16b、tim_32b、tim_adv)都用来作为PWM输出和编码器输入了,我最终选择使用仅具有计数功能的 tim_basic,但需要使用两个Instance。这里少不了还要实现一个 find_timer() 的函数以及一组预先分配好的conf结构体。

Implementation

使用 ports/mimxrt/machine_timer.c作为模板,完成mm32的Timer模块的实现。

STATIC mp_obj_t machine_timer_obj_init_helper () 函数中的实例化参数清单

    static const mp_arg_t allowed_args[] ={{ MP_QSTR_mode,         MP_ARG_KW_ONLY | MP_ARG_INT, {.u_int = TIMER_MODE_PERIODIC} },{ MP_QSTR_callback,     MP_ARG_REQUIRED | MP_ARG_KW_ONLY | MP_ARG_OBJ, {.u_rom_obj = MP_ROM_NONE} },{ MP_QSTR_period,       MP_ARG_KW_ONLY | MP_ARG_INT, {.u_int = 0xffffffff} },{ MP_QSTR_tick_hz,      MP_ARG_KW_ONLY | MP_ARG_INT, {.u_int = 1000} },{ MP_QSTR_freq,         MP_ARG_KW_ONLY | MP_ARG_OBJ, {.u_rom_obj = MP_ROM_NONE} },};

Timer 对象的类型定义,要存放好硬件相关信息,同时能保存这些动态配置信息

typedef struct
{void   * callback;uint32_t period;uint32_t tick_hz;uint32_t freq;uint32_t mode;
} machine_timer_conf_t;typedef struct
{mp_obj_base_t    base;      // object base class.TIM_BASIC_Type * timer_port;IRQn_Type        timer_irqn;uint32_t         timer_id;machine_timer_conf_t *conf;
} machine_timer_obj_t;

这里的 callback 搞了个无差别指针,后面用强制类型转换骗过编译器吧。后来通过实际调试发现问题,改用“mp_obj_t callback”。

把machine_timer_obj_t的实例化放在machine_timer.c中吧,因为没有涉及引脚相关的定义,就不放在 machine_pin_board_pins.c 中了。

machine_timer_conf_t timer_conf[MACHINE_TIMER_NUM];const machine_timer_obj_t timer0 = {.base = {&machine_timer_type}, .timer_port = TIM6, .timr_irqn = TIM6_IRQn, .timer_id = 0u, .conf = &timer_conf[0]};
const machine_timer_obj_t timer1 = {.base = {&machine_timer_type}, .timer_port = TIM7, .timr_irqn = TIM7_IRQn, .timer_id = 1u, .conf = &timer_conf[1]};const machine_timer_obj_t * machine_timer_objs[] =
{&timer0 ,&timer1 ,
};

再实现 timer_find()函数:

const machine_timer_obj_t *timer_find(mp_obj_t user_obj)
{/* 如果传入参数本身就是一个Timer的实例,则直接送出这个Timer。 */if ( mp_obj_is_type(user_obj, &machine_timer_type) ){return user_obj;}/* 如果传入参数是一个Timer ID号,则通过索引在Timer清单中找到这个通道,然后送出这个通道的实例化对象。 */if ( mp_obj_is_small_int(user_obj) ){uint8_t timer_idx = MP_OBJ_SMALL_INT_VALUE(user_obj);if ( timer_idx < MACHINE_TIMER_NUM ){return machine_timer_objs[timer_idx];}}mp_raise_ValueError(MP_ERROR_TEXT("Timer doesn't exist"));
}

突然发现,对于硬件模块,在 make_new 函数中安排开模块时钟挺好的,对应配引脚复用功能也不错。通常make_new函数中会调用init_helper函数,init_helper通常还会被init直接调用,暴露给用户。但实际上,init函数不仅仅是作为首次配置,更多是修改模块硬件属性,在运行时配置。因此,像开时钟、配引脚这种一次性的操作,放到make_new里更合适。

对于Timer,不涉及到引脚。涉及到引脚也不能在这里写死。目前的类对象结构体中,都已经包含了引脚复用功能的选项,而且要考虑动态复用的可能性,所以不会再pin_init.c或者make_new中一次性写死,而是放在init_helper中,每次在使用init配置类功能,都重新配置一遍引脚。至于访问时钟,我直接在clock_init.c中全部开启,也浪费不了多少电。

mp_obj_t machine_timer_obj_make_new(const mp_obj_type_t *type, size_t n_args, size_t n_kw, const mp_obj_t *args)
{mp_arg_check_num(n_args, n_kw, 1, MP_OBJ_FUN_ARGS_MAX, true);const machine_timer_obj_t *timer = timer_find(args[0]);if ( (n_args >= 1) || (n_kw >= 0) ){mp_map_t kw_args;mp_map_init_fixed_table(&kw_args, n_kw, args + n_args); /* 将关键字参数从总的参数列表中提取出来,单独封装成kw_args。 */machine_timer_obj_init_helper(timer, n_args - 1, args + 1, &kw_args);}return (mp_obj_t)timer;
}

其余函数都是常规实现。

特别需要注意中断服务程序的设计,这也是Timer模块实现的一个难点。

static void machine_timer_irq_handler(uint32_t timer_id)
{const machine_timer_obj_t * self = machine_timer_objs[timer_id];uint32_t flags = TIM_BASIC_GetInterruptStatus(self->timer_port);if (0u != (flags & TIM_BASIC_STATUS_UPDATE_PERIOD) ){if (self->conf->callback){mp_sched_schedule(self->conf->callback, MP_OBJ_FROM_PTR(self));}}TIM_BASIC_ClearInterruptStatus(self->timer_port, flags);if (self->conf->mode == TIMER_MODE_ONE_SHOT){TIM_BASIC_Stop(self->timer_port);}
}
void TIM6_IRQHandler(void) { machine_timer_irq_handler(0); }
void TIM7_IRQHandler(void) { machine_timer_irq_handler(1); }

要在于调用 mp_sched_schedule() 函数。若要使用 mp_sched_schedule() 函数,需要在mpconfigport.h文件中启用 MICROPY_ENABLE_SCHEDULER。

#define MICROPY_ENABLE_SCHEDULER            (1) /* enable scheduler components, using in irq. */

关于 mp_sched_schedule() 函数,其定义在 py/scheduler.c 文件中:

bool MICROPY_WRAP_MP_SCHED_SCHEDULE(mp_sched_schedule)(mp_obj_t function, mp_obj_t arg) {mp_uint_t atomic_state = MICROPY_BEGIN_ATOMIC_SECTION();bool ret;if (!mp_sched_full()) {if (MP_STATE_VM(sched_state) == MP_SCHED_IDLE) {MP_STATE_VM(sched_state) = MP_SCHED_PENDING;}uint8_t iput = IDX_MASK(MP_STATE_VM(sched_idx) + MP_STATE_VM(sched_len)++);MP_STATE_VM(sched_queue)[iput].func = function;MP_STATE_VM(sched_queue)[iput].arg = arg;MICROPY_SCHED_HOOK_SCHEDULED;ret = true;} else {// schedule queue is fullret = false;}MICROPY_END_ATOMIC_SECTION(atomic_state);return ret;
}

从源代码中可以看出,这个函数要求在第一个参数传入回调的函数,第二个参数传入回调函数的参数。在 machine_timer_irq_handler() 函数中,将make_new中存入的callback和timer对象本身作为参数传入python的调度器。这个要特别注意,在python中,也要定义格式相同的函数作为回调函数传入。在callback内部,可以通过传入的参数访问到timer对象实例的所有资源。

Application

终于到验证环节了,我经历了一下午各种猜各种试各种调,终于搞出来一个能那得出手的测试用例了。

from machine import Pin
from machine import Timer
import utimeled0 = Pin('PA1', mode=Pin.OUT_PUSHPULL)
led1 = Pin('PA2', mode=Pin.OUT_PUSHPULL)led0_flag = False
led1_flag = Falsedef t0_callback(self):global led0_flagif led0_flag:led0.low()else:led0.high()led0_flag = not led0_flagt0 = Timer(0, mode=Timer.PERIODIC, callback=t0_callback, period=500)while True:utime.sleep_ms(200)if led1_flag:led1.low()else:led1.high()led1_flag = not led1_flag

两个小灯以不同的频率交替闪烁,成了。

这篇关于在mm32f3270上为MicroPython启用Timer模块的文章就介绍到这儿,希望我们推荐的文章对编程师们有所帮助!



http://www.chinasem.cn/article/755639

相关文章

Go 1.23中Timer无buffer的实现方式详解

《Go1.23中Timer无buffer的实现方式详解》在Go1.23中,Timer的实现通常是通过time包提供的time.Timer类型来实现的,本文主要介绍了Go1.23中Timer无buff... 目录Timer 的基本实现无缓冲区的实现自定义无缓冲 Timer 实现更复杂的 Timer 实现总结在

Node.js net模块的使用示例

《Node.jsnet模块的使用示例》本文主要介绍了Node.jsnet模块的使用示例,net模块支持TCP通信,处理TCP连接和数据传输,具有一定的参考价值,感兴趣的可以了解一下... 目录简介引入 net 模块核心概念TCP (传输控制协议)Socket服务器TCP 服务器创建基本服务器服务器配置选项服

Python利用自带模块实现屏幕像素高效操作

《Python利用自带模块实现屏幕像素高效操作》这篇文章主要为大家详细介绍了Python如何利用自带模块实现屏幕像素高效操作,文中的示例代码讲解详,感兴趣的小伙伴可以跟随小编一起学习一下... 目录1、获取屏幕放缩比例2、获取屏幕指定坐标处像素颜色3、一个简单的使用案例4、总结1、获取屏幕放缩比例from

nginx-rtmp-module模块实现视频点播的示例代码

《nginx-rtmp-module模块实现视频点播的示例代码》本文主要介绍了nginx-rtmp-module模块实现视频点播,文中通过示例代码介绍的非常详细,对大家的学习或者工作具有一定的参考学习... 目录预置条件Nginx点播基本配置点播远程文件指定多个播放位置参考预置条件配置点播服务器 192.

golang1.23版本之前 Timer Reset方法无法正确使用

《golang1.23版本之前TimerReset方法无法正确使用》在Go1.23之前,使用`time.Reset`函数时需要先调用`Stop`并明确从timer的channel中抽取出东西,以避... 目录golang1.23 之前 Reset ​到底有什么问题golang1.23 之前到底应该如何正确的

多模块的springboot项目发布指定模块的脚本方式

《多模块的springboot项目发布指定模块的脚本方式》该文章主要介绍了如何在多模块的SpringBoot项目中发布指定模块的脚本,作者原先的脚本会清理并编译所有模块,导致发布时间过长,通过简化脚本... 目录多模块的springboot项目发布指定模块的脚本1、不计成本地全部发布2、指定模块发布总结多模

Python中构建终端应用界面利器Blessed模块的使用

《Python中构建终端应用界面利器Blessed模块的使用》Blessed库作为一个轻量级且功能强大的解决方案,开始在开发者中赢得口碑,今天,我们就一起来探索一下它是如何让终端UI开发变得轻松而高... 目录一、安装与配置:简单、快速、无障碍二、基本功能:从彩色文本到动态交互1. 显示基本内容2. 创建链

Node.js 中 http 模块的深度剖析与实战应用小结

《Node.js中http模块的深度剖析与实战应用小结》本文详细介绍了Node.js中的http模块,从创建HTTP服务器、处理请求与响应,到获取请求参数,每个环节都通过代码示例进行解析,旨在帮... 目录Node.js 中 http 模块的深度剖析与实战应用一、引言二、创建 HTTP 服务器:基石搭建(一

Ubuntu 怎么启用 Universe 和 Multiverse 软件源?

《Ubuntu怎么启用Universe和Multiverse软件源?》在Ubuntu中,软件源是用于获取和安装软件的服务器,通过设置和管理软件源,您可以确保系统能够从可靠的来源获取最新的软件... Ubuntu 是一款广受认可且声誉良好的开源操作系统,允许用户通过其庞大的软件包来定制和增强计算体验。这些软件

python中的与时间相关的模块应用场景分析

《python中的与时间相关的模块应用场景分析》本文介绍了Python中与时间相关的几个重要模块:`time`、`datetime`、`calendar`、`timeit`、`pytz`和`dateu... 目录1. time 模块2. datetime 模块3. calendar 模块4. timeit