当前位置: 首页 > 文档资料 > 光环板帮助文档 >

其他模块

优质
小牛编辑
133浏览
2023-12-01

该部分 API 将帮助您使用其他 mBuild 电子模块。 注意:你需要额外购买包含 mBuild 电子模块扩展包或套装来获得 mBuild 模块以使用这些功能。

省略代码中的halocode

注意:该部分 API 省略了“halocode.”,本篇提及的所有 API 均省略了“halocode.” ,如 led_driver.off( )实际为halocode.led_driver.off()。mBuild 电子模块平台的所有功能均维护在halocode库中,因此我们推荐如下写法,以便将halocode.进行省略,使得代码更简洁。

from halocode import *

通用参数index

所有的 mbuild 电子模块的 API 均有一个参数index,它代表 API 指向的链上的第几个同类型模块。一般,具有默认值1。因此,当链上的每种模块只使用到一个时,你无需关注和独立设置它。 而当链上出现两个同类型模块时,你需要让index等于2、3、4甚至其他数字,以便控制链上的第2个、第3个,甚至第4个同类型模块,比如,motor_driver.set(100, index = 2)表示将链上第二个电机驱动的输出动力变为100。

红外收发

ir.send(message, index = 1) 发送红外消息,参数:

  • message 字符串,长度限制为30个,暂时仅支持英文字母、数字标点的组合。

ir.receive(index = 1) 获得红外收发模块收到的消息。
返回字符串。

ir.record(record_id, index = 1) 录制的红外消息,该 API 会阻塞线程3秒以完成红外信号的录制,参数:

  • record_id 数值,有效值12,红外收发模块最多可以录制两个信号。

ir.send_record(record_id, index = 1) 发送录制的红外消息,参数:

  • record_id 数值,有效值12,红外收发模块最多可以录制两个信号。

ir.is_receive(message, index = 1) 判断红外收发模块是否接受到了特定的红外信号,参数:

  • message 字符串,也可以填写代表红外遥控信号的字符串变量,有效的变量及其含义有:
    变量含义
    IR_REMOTE.up
    IR_REMOTE.down
    IR_REMOTE.left
    IR_REMOTE.right
    IR_REMOTE.set设置
    IR_REMOTE.zero0
    IR_REMOTE.one1
    IR_REMOTE.two2
    IR_REMOTE.three3
    IR_REMOTE.four4
    IR_REMOTE.five5
    IR_REMOTE.six6
    IR_REMOTE.seven7
    IR_REMOTE.eight8
    IR_REMOTE.nine9
    IR_REMOTE.AA
    IR_REMOTE.BB
    IR_REMOTE.CC
    IR_REMOTE.DD
    IR_REMOTE.EE
    IR_REMOTE.FF