Arduino

arduino库中所有扩展方法及属性皆依赖于arduino扩展包，使用前请导入arduino

import arduino

arduino 支持烧录固件‘mCookie’与‘mCookie扩展’。文中凡支持float类型或有效字符串float类型的参数，在实际运行中都是将其直接转换成int型。例如 2.3 等价于 2 、'2.6' 等价于 2

1、设置引脚高低电平

arduino.digitalWrite(port, type)
"""
    port : 要设置引脚状态的端口，默认为2/3, 参数为2
    type : 引脚电平状态，包含0(Low)、1(High)
    功能 : 用于设置指定端口的电平状态
    参数类型 : port、type皆适用于int、float及纯数字型字符串
    适用模块 : 传感器扩展板
"""

2、读取数字引脚

arduino.digitalRead(port)
"""
    port : 要获取引脚状态的端口，默认为2/3, 参数为2
    功能 : 读取指定引脚当前的开关状态
    返回值类型 : 返回值类型包含0(未工作状态)、1(工作状态)
    参数类型 : port 适用于int、 float及纯数字型字符串
"""

3、判定引脚高低电平

arduino.digitalRead(port) == type
"""
    port : 要获取引脚状态的端口，默认为2/3, 参数为2
    type : 引脚电平状态，包含0(Low)、1(High)
    功能 : 读取指定引脚当前的开关状态
    返回值类型 : 返回值类型包含0(未工作状态)、1(工作状态)
    参数类型 : port 适用于int、 float及纯数字型字符串
    适用模块 : 传感器扩展板
"""

这是一个组合型的指令，由引脚电平状态读取指令与判断指令相组合而生成。使用时可以参考并修改判断指令以达到实现特殊需求的效果

4、读取模拟引脚

arduino.analogRead(port)
"""
    port: 模拟引脚端口，默认为A0，参数为0
    功能 : 读取指定模拟引脚的输入值
    返回值类型 : 返回值类型为int型
    参数类型 : port 适用于int、 float及纯数字型字符串
"""

5、设置引脚PWM值

arduino.analogWrite(port, pwm)
"""
    port : 引脚端口，默认为3， 参数为3
    pwm : 输出pwm值
    功能 : 向指定引脚输出特定频率的pwm值
    参数类型 : port、pwm皆适用于int、 float及纯数字型字符串
"""

6、映射

arduino.map(num, snum1, snum2, enum1, enum2)
"""
    num : 目标值，属于snum1到snum2范围内的数据
    snum1 : 映射前的起始值
    snum2 : 映射前的终止值
    enum1 : 要映射的起始值
    enum2 : 要映射的终止值
    功能 : 将snum1至snum2范围内的数值num映射到enum1至enum2范围内
    返回值类型 : 返回值类型为int型
    参数类型 : num、snum1、snum2、enum1、enum2皆适用于int、 float及纯数字型字符串
"""

此函数主要起到一个对数值进行映射的作用，以便于将数值限制在一个有效的或实际需要范围内，例如，将数值1-1000范围内的500映射到1-100的范围内就是50.此处的500即为num,1-1000为snum1-snum2,1-100为enum1-enum2,50为映射后的返回值

7、约束

max(min(max_num, num), min_num)
"""
    num :  要进行约束的数值
    min_num : 约束范围最小值
    max_num : 约束范围最大值
    功能 : 将要约束的值，约束在指定的范围内
    返回值类型 : 返回值类型为int
    参数类型 : num、min_num、max_num
"""

此为一个由min()与max()组合的复合函数，主要作用是将目标值限定在规定的范围内，当目标值小于限定范围内最小值时取限定范围的最小值，反之亦然