跳转至

sensor - 传感器操作库

{bdg-success}已适配 {bdg-primary}Air780E {bdg-primary}Air780EP {bdg-primary}Air780EPS {bdg-primary}Air201

本页文档由[这个文件](https://gitee.com/openLuat/LuatOS/tree/master/luat/modules/luat_lib_sensor.c)自动生成。如有错误,请提交issue或帮忙修改后pr,谢谢!
本库有专属demo,[点此链接查看sensor的demo例子](https://gitee.com/openLuat/LuatOS/tree/master/demo/dht11)

示例

-- 请查阅demo/dht11 demo/ds18b20

sensor.ds18b20(pin, check_crc)

获取DS18B20的温度数据

参数

传入值类型 解释
int gpio端口号
boolean 是否校验crc值,默认为true. 不校验crc值能提高读取成功的概率,但可能会读取到错误的值

返回值

返回值类型 解释
int 温度数据,单位0.1摄氏度,读取失败时返回错误码
boolean 成功返回true,否则返回false

例子

while 1 do
    sys.wait(5000)
    local val,result = sensor.ds18b20(17, true) -- GPIO17且校验CRC值
    -- val 301 == 30.1摄氏度
    -- result true 读取成功
    log.info("ds18b20", val, result)
end

sensor.w1_reset(pin)

单总线协议,复位设备

参数

传入值类型 解释
int gpio端口号

返回值

返回值类型 解释
nil 无返回

例子


sensor.w1_connect(pin)

单总线协议,连接设备

参数

传入值类型 解释
int gpio端口号

返回值

返回值类型 解释
boolean 成功返回true,失败返回false

例子


sensor.w1_write(pin, data1,data2)

单总线协议,往总线写入数据

参数

传入值类型 解释
int gpio端口号
int 第一个数据
int 第二个数据, 可以写N个数据

返回值

返回值类型 解释
nil 无返回值

例子


sensor.w1_read(pin, len)

单总线协议,从总线读取数据

参数

传入值类型 解释
int gpio端口号
int 读取的长度

返回值

返回值类型 解释
int 按读取的长度返回N个整数

例子


sensor.hx711(pin_date,pin_clk)

获取Hx711的压力传感数据

参数

传入值类型 解释
int 数据的gpio端口号
int 时钟的gpio端口号

返回值

返回值类型 解释
int hx711读到的数据

例子

--  如果设备不存在会卡在读取接口
sys.taskInit(
    function()
        sys.wait(1000)
        local maopi = sensor.hx711(0,7)
        while true do
            sys.wait(2000)
            a = sensor.hx711(0,7) - maopi
            if a > 0 then
                log.info("tag", a / 4.6)
            end
        end
    end
)

sensor.cs1237(pin_date,pin_clk)

获取cs1237传感数据

参数

传入值类型 解释
int 数据的gpio端口号
int 时钟的gpio端口号

返回值

返回值类型 解释
int cs1237读到的数据

例子

--  如果设备不存在会卡在读取接口
sys.taskInit(
    function()
        sys.wait(1000)
        local cs1237_data = sensor.cs1237(0,7)
        while true do
            sys.wait(2000)
            cs1237_data = sensor.cs1237(0,7) - maopi
            log.info("cs1237_data:", cs1237_data)--得到原始数据
        end
    end
)

sensor.ws2812b(pin,data,T0H,T0L,T1H,T1L)

设置ws2812b输出(gpio驱动方式)

参数

传入值类型 解释
int ws2812b的gpio端口号
string/zbuff 待发送的数据(如果为zbuff数据,则会无视指针位置始终从0偏移开始)
int T0H时间,表示延时多少个nop,每个型号不一样,自己调
int T0L时间,表示延时多少个nop
int T1H时间,表示延时多少个nop
int T1L时间,表示延时多少个nop

返回值

例子

local buff = zbuff.create({8,8,24})
buff:drawLine(1,2,5,6,0x00ffff)
sensor.ws2812b(7,buff,300,700,700,700)

sensor.ws2812b_pwm(pin,data)

设置ws2812b输出(pwm驱动方式,需要pwm能输出800k频率,否则无法使用此方法)

参数

传入值类型 解释
int pwm端口号
string/zbuff 待发送的数据(如果为zbuff数据,则会无视指针位置始终从0偏移开始)

返回值

例子

local buff = zbuff.create({8,8,24})
buff:setFrameBuffer(8,8,24,0x0000ff)
sensor.ws2812b_pwm(7,buff)

sensor.ws2812b_spi(pin,data)

设置ws2812b输出(spi驱动方式,需要spi能输出5M频率,否则无法使用此方法)

参数

传入值类型 解释
int spi端口号
string/zbuff 待发送的数据(如果为zbuff数据,则会无视指针位置始终从0偏移开始)

返回值

例子

local buff = zbuff.create({8,8,24})
buff:setFrameBuffer(8,8,24,0x0000ff)
sensor.ws2812b_spi(2,buff)

sensor.dht1x(pin)

获取DHT11/DHT12的温湿度数据

参数

传入值类型 解释
int gpio端口号
boolean 是否校验crc值,默认为true. 不校验crc值能提高读取成功的概率,但可能会读取到错误的值

返回值

返回值类型 解释
int 湿度数据,单位0.01%,读取失败时返回错误值
int 温度数据,单位0.01摄氏度,读取失败时返回错误值
boolean 成功返回true,否则返回false

例子

while 1 do
    sys.wait(1000)
    local h,t,r = sensor.dht1x(17, true) -- GPIO17且校验CRC值
    log.info("dht11", h/100,t/100,r)--90.1 23.22
end

sensor.sc12a(sda,scl)

获取sc12a被触摸的通道数据

参数

传入值类型 解释
int 数据的gpio端口号
int 时钟的gpio端口号

返回值

返回值类型 解释
int 读取成功返回整形数据,读取失败时返回错误值

例子

while true do
  local temp1=sensor.sc12a(4,7)
  if bit.rshift(bit.band( temp1, 0x8000), 15 )==0x01 then
    log.info("被按下的有通道0")
  end
  if bit.rshift(bit.band( temp1, 0x4000), 14 )==0x01 then
    log.info("被按下的有通道1")
  end
  if bit.rshift(bit.band( temp1, 0x2000), 13 )==0x01 then
    log.info("被按下的有通道2")
  end
  if bit.rshift(bit.band( temp1, 0x1000), 12 )==0x01 then
    log.info("被按下的有通道3")
  end
  if bit.rshift(bit.band( temp1, 0x800), 11 )==0x01 then
    log.info("被按下的有通道4")
  end
  if bit.rshift(bit.band( temp1, 0x400), 10 )==0x01 then
    log.info("被按下的有通道5")
  end
  if bit.rshift(bit.band( temp1, 0x200), 9 )==0x01 then
    log.info("被按下的有通道6")
  end
  if bit.rshift(bit.band( temp1, 0x100), 8 )==0x01 then
    log.info("被按下的有通道7")
  end
  if bit.rshift(bit.band( temp1, 0x80), 7 )==0x01 then
    log.info("被按下的有通道8")
  end
  if bit.rshift(bit.band( temp1, 0x40), 6 )==0x01 then
    log.info("被按下的有通道9")
  end
  if bit.rshift(bit.band( temp1, 0x20), 5 )==0x01 then
    log.info("被按下的有通道10")
  end
  if bit.rshift(bit.band( temp1, 0x10), 4 )==0x01 then
    log.info("被按下的有通道11")
  end
  sys.wait(200)
end

sensor.yhm27xxx(pin, chip_id, reg, data)

单总线命令读写YHM27XX

参数

传入值类型 解释
int gpio端口号
int 芯片ID
int 寄存器地址
int 要写入的数据,如果没填,则表示从寄存器读取数据

返回值

返回值类型 解释
boolean 成功返回true,失败返回false
int 读取成功返回寄存器值,写入成功无返回

例子

while 1 do
    sys.wait(1000)
    local result, data = sensor.yhm27xxx(15, 0x04, 0x05)
    log.info("yhm27xxx", result, data)
end