Arduino库
如果您不使用Arduino, 可以看看开发章节
安装
PlatformIO
在PlatformIO中使用本库,在platformio.ini中添加如下内容或者通过UI搜索BULLM_ExtendModule添加
ini
[env:myenv]
...
lib_deps =
bullm/BULLM_ExtendModule
...Arduino IDE
在Arduino IDE中,直接在库管理器中搜索BULLM_ExtendModule并安装即可。注意是BULLM_ExtendModule不是ExtendMotor
简单示例
c
#include <Wire.h>
#include "BULLM_ExtendRelay.h"
BULLM_ExtendRelay relays(0x27); // 实例化,默认地址为0x27
void setup() {
Serial.begin(115200);
Wire.begin(4, 5); // 初始化I²C
if (relays.begin()) { // 初始化,并把8个IO配置为输出模式
Serial.println("BULLM_ExtendRelay found");
relays.openAllRelay(); // 初始化成功时松开所有继电器
} else {
Serial.println("BULLM_ExtendRelay not found");
}
}构造函数
| 构造函数 | 说明 |
|---|---|
BULLM_ExtendRelay() | 使用默认地址 |
BULLM_ExtendRelay(uint8_t addr) | 指定 I²C 地址 |
BULLM_ExtendRelay(uint8_t addr, TwoWire &i2c) | 指定 I²C 地址与 I²C 总线对象 |
方法
初始化
| 方法 | 用途 | 返回值 |
|---|---|---|
bool begin() | 初始化芯片,并把 8 个 IO 全部配置为输出模式 | 是否成功 |
控制继电器的方法
继电器为低电平吸合:输出 0 吸合,输出 1 松开。
| 方法 | 用途 | 参数 | 返回值 |
|---|---|---|---|
bool closeAllRelay() | 吸合所有继电器 | 无 | 是否成功 |
bool openAllRelay() | 松开所有继电器 | 无 | 是否成功 |
bool setRelay(uint8_t pin, bool state) | 控制其中一路继电器状态 | pin: 0~7,表示 0~7 路继电器 state: 0 为吸合,1 为松开 | 是否成功 |
bool setRelayAll(uint8_t states) | 一次控制 8 路继电器的状态 | 一个字节数据,每一 bit 表示一路 例如: 0b11110000,4~7 为松开(1),0~3 为吸合(0) | 是否成功 |
示例
c
// 吸合 3 号继电器,其他不变
uint8_t state = relays.getRelayAll(); // 先读取当前状态
state &= ~(1 << 3); // 对应位置 0(吸合)
relays.setRelayAll(state);
// 直接指定 8 路状态:0 号吸合,其余松开
relays.setRelayAll(0b11111110);读取继电器状态
| 方法 | 用途 | 参数 | 返回值 |
|---|---|---|---|
bool getRelay(uint8_t pin) | 读取指定继电器的状态 | pin: 0~7 | 该路状态 |
uint8_t getRelayAll() | 一次读取 8 路继电器的状态 | 无 | 8 路状态,每个 bit 对应一路 |
Rev.2 使用 PCA9554 的 8 个 IO 全部用于继电器控制,因此不再提供额外的自定义 IO。