LuatOS-SOC接口文档(air780E)-- i2c - I2C操作

常量

i2c.exist(id)

i2c编号是否存在

参数

返回值

例子

-- 检查i2c1是否存在
if i2c.exist(1) then
    log.info("存在 i2c1")
end

---

i2c.setup(id, speed, slaveAddr)

i2c初始化

参数

返回值

例子

-- 初始化i2c1
i2c.setup(1, i2c.FAST) -- 端口正确就一定成功
-- 如需判断i2c id是否合法, 请使用 i2c.exist 函数

---

i2c.createSoft(scl,sda,delay)

新建一个软件i2c对象

参数

返回值

例子

-- 注意！这个接口是软件模拟i2c，速度可能会比硬件的慢
-- 不需要调用i2c.close接口
-- 初始化软件i2c
local softI2C = i2c.createSoft(1, 2, 5)
i2c.send(softI2C, 0x5C, string.char(0x0F, 0x2F))
-- 注意, 第3个参数是 2023.06.19 添加的delay
-- 通过调整delay参数的值, 可增加或降低I2C的速度

---

i2c.send(id, addr, data,stop)

i2c发送数据

参数

返回值

例子

-- 往i2c0发送1个字节的数据
i2c.send(0, 0x68, 0x75)
-- 往i2c1发送2个字节的数据
i2c.send(1, 0x5C, string.char(0x0F, 0x2F))
i2c.send(1, 0x5C, {0x0F, 0x2F})

---

i2c.recv(id, addr, len)

i2c接收数据

参数

返回值

例子

-- 从i2c1读取2个字节的数据
local data = i2c.recv(1, 0x5C, 2)

---

i2c.writeReg(id, addr, reg, data,stop)

i2c写寄存器数据

参数

返回值

例子

-- 从i2c1的地址为0x5C的设备的寄存器0x01写入2个字节的数据
i2c.writeReg(1, 0x5C, 0x01, string.char(0x00, 0xF2))

---

i2c.readReg(id, addr, reg, len)

i2c读寄存器数据

参数

返回值

例子

-- 从i2c1的地址为0x5C的设备的寄存器0x01读出2个字节的数据
i2c.readReg(1, 0x5C, 0x01, 2)

---

i2c.close(id)

关闭i2c设备

参数

返回值

例子

-- 关闭i2c1
i2c.close(1)

---

i2c.readDHT12(id)

从i2c总线读取DHT12的温湿度数据

参数

返回值

例子

-- 从i2c0读取DHT12
i2c.setup(0)
local re, H, T = i2c.readDHT12(0)
if re then
    log.info("dht12", H, T)
end

---

i2c.readSHT30(id,addr)

从i2c总线读取DHT30的温湿度数据(由”好奇星”贡献)

参数

返回值

例子

-- 从i2c0读取SHT30
i2c.setup(0)
local re, H, T = i2c.readSHT30(0)
if re then
    log.info("sht30", H, T)
end

---

i2c.transfer(id, addr, txBuff, rxBuff, rxLen)

i2c通用传输，包括发送N字节，发送N字节+接收N字节，接收N字节三种功能，在发送转接收过程中发送reStart信号,解决类似mlx90614必须带restart信号，但是又不能用i2c.send来控制的，比如air105

参数

返回值

例子

local result, _ = i2c.transfer(0, 0x11, txbuff, rxbuff, 1)
local result, _ = i2c.transfer(0, 0x11, txbuff, nil, 0)	--只发送txbuff里的数据，不接收数据，典型应用就是写寄存器了，这里寄存器地址和值都放在了txbuff里
local result, _ = i2c.transfer(0, 0x11, "\x01\x02\x03", nil, 1) --发送0x01， 0x02，0x03，不接收数据，如果是eeprom，就是往0x01的地址写02和03，或者往0x0102的地址写03，看具体芯片了
local result, rxdata = i2c.transfer(0, 0x11, "\x01\x02", nil, 1) --发送0x01， 0x02，然后接收1个字节，典型应用就是eeprom
local result, rxdata = i2c.transfer(0, 0x11, 0x00, nil, 1) --发送0x00，然后接收1个字节，典型应用各种传感器

---

i2c.xfer(id, addr, txBuff, rxBuff, rxLen, transfer_done_topic, timeout)

i2c非阻塞通用传输，类似transfer，但是不会等到I2C传输完成才返回，调用本函数会立刻返回，I2C传输完成后，通过消息回调

参数

返回值

例子

local result = i2c.xfer(0, 0x11, txbuff, rxbuff, 1, "I2CDONE") if result then result, i2c_id, succ, error_code = sys.waitUntil("I2CDONE") end if not result or not succ then log.info("i2c fail, error code", error_code) else log.info("i2c ok") end

---

i2c.scan(id)

扫描i2c设备

参数

返回值

例子

-- 本函数于2023.07.04添加
-- 这个函数的主要目标是为了在开发期扫描i2c设备
-- 有些BSP在指定addr无响应时会输出日志,导致输出会被打乱
i2c.scan()