micropython用c添加接口——给module添加function

上一篇我们已经给micropython添加好了一个自定义的module:modtest,但是没有实现任何功能,这一篇就讲讲如何给modtest添加function功能。

函数是分为有参数和无参数的,那么我们就来添加两个function,一个没有参数的,一个有一个参数的。

第一种,先来添加无参数的函数,我们给他起名为test0(这个名字是最终在python层面显示的)。

下面我们先看代码再解释:

所有我们和python对接的函数都要是返回mp_obj_t类型的 ,如果该函数实际不需要返回任何数据我们最后就调用return mp_const_none;

比价重要的一条就是这个了STATIC const MP_DEFINE_CONST_FUN_OBJ_0(modtest_obj_test0,modtest_test0);    micropython针对不同参数类型提供了好几个这种类似的宏定义。这里不深做解释,我们是用的OBJ_0就是代表改函数是0个参数的。

最后一步就是把我们定义的function注册进modtest_globals_table中去,和前面注册module类型类似,MP_QSTR_test0   该名称中的test0会作为我们在pythonfunction显示的名字。

这样就算添加好了,编译烧录看结果:

可以看到python层我们调用 modtest.test0()就可以执行到我们函数中打印的内容。

这里还有个坑需要注意一下,在接口函数里面调用printf的时候,最后的’\n’要加上,要不然打印不出来。

 

第二种:添加一个带有一个参数的函数接口

有了前面的例子,添加带有一个接口的函数就更容易理解了,可以重点看和不带参数的区别,先上代码:

看起来是不是大同小异,定义的函数我们添加了一个mp_obj_t 类型的参数,实际上mp_obj_t 就是一个空指针,这样他可以用来传递任何类型,不管是整数,字符串都可以。具体是什么类型我们在函数内部用mp提供的对应的方法把他提取出来,比如这里认为传进来的是一个int型的,就是用mp_obj_get_int(data) 来提取出来整型。当然micopython还提供了很多其他类似的,需要注意一下是提取字符串的稍微形式上看起来有点区别:           mp_obj_str_get_str(arg)  。

接下来就是使用的宏定义不一样,这个是一个参数的就用MP_DEFINE_CONST_FUN_OBJ_1  (官方一共提供了七种接口,请自行慢慢研究)

后面注册的方式是一样的。好了,下面继续看编译烧录结果:

可以看到我们调用modtest.test1(100)已经成功把参数100传递了进去。

接下来是预告时间:下一篇会讲在module中添加type和在type中添加function的方法步骤

您可能还喜欢...

5 条回复

  1. turbo说道:

    STATIC const MP_DEFINE_CONST_FUN_OBJ_0(modtest_obj_test0,modtest_test0);

    modtest_obj_test0 应当为 modtest_test0_obj

    • 电子创客营说道:

      不是的,这个名字你可以随便定义,只要不重复就行。所以我定义的方式没错,你的也可以编译通过,只要保证定义和使用的地方统一

  2. 小木匠说道:

    楼主你好,我按你的方法,写了modtest.c
    在编译的时候遇到错误:
    est.c:19:18: error: ‘MP_QSTR_test0’ undeclared here (not in a function)
    {MP_ROM_QSTR(MP_QSTR_test0), MP_ROM_PTR(&modtest_obj_test0)},

    ^
    ../../py/obj.h:92:56: note: in definition of macro ‘MP_OBJ_NEW_QSTR’
    #define MP_OBJ_NEW_QSTR(qst) ((mp_obj_t)((((mp_uint_t)(qst)) << 2) | 2))
    ^
    modtest.c:19:6: note: in expansion of macro ‘MP_ROM_QSTR’
    {MP_ROM_QSTR(MP_QSTR_test0), MP_ROM_PTR(&modtest_obj_test0)},

    看上去是没有在build/genhdr/qstrdefs.generated.h中生成test0对应的字符串,我是在port/minimal目录下面加的modtest.c.
    能指点下还需要修改哪个地方吗? 3Q

    • 电子创客营说道:

      首先你不加的时候要确保minimal 可以编译通过,然后再按照我这篇文章https://www.eemaker.com/micropython-add-module.html 确定添加一个module没问题,下一步再按照本片里面的添加一个function。这样确保你每一步都没有出错。如果中间还遇到编译不成功,建议把build文件夹删除再次编译

      • 小木匠说道:

        我这里试了,只有在 /py/qstrdefs.h 里面加上 Q(test0), build/genhdr/qstrdefs.generated.h里面才会生成MP_QSTR_test0, 暂时先用这方法来解决了。