sensor - Sensor Operation Library#

Adapted Air780E Air780EP Air780EPS Air201

Note

This page document is automatically generated by this file. If there is any error, please submit issue or help modify pr, thank you!

Tip

This library has its own demo,click this link to view the demo example of sensor

Example

-- Please consult demo/dht11 demo/ds18b20

sensor.ds18b20(pin, check_crc)#

Get DS18B20 temperature data

Parameters

Incoming Value Type

Explanation

int

gpio Port number

boolean

whether to verify the crc value. the default value is true. not verifying the crc value can increase the probability of successful reading, but the wrong value may be read.

Return Value

return value type

explanation

int

Temperature data, unit 0.1 degrees Celsius, error code returned when reading failure

boolean

Returns true on success, otherwise false

Examples

while 1 do
    sys.wait(5000)
    local val,result = sensor.ds18b20(17, true) -- GPIO17 and check the CRC value
    -- val 301 == 30.1 Celsius
    -- result true Read success
    log.info("ds18b20", val, result)
end

sensor.w1_reset(pin)#

Single bus protocol, reset device

Parameters

Incoming Value Type

Explanation

int

gpio Port number

Return Value

return value type

explanation

nil

No Return

Examples

None


sensor.w1_connect(pin)#

Single bus protocol, connecting devices

Parameters

Incoming Value Type

Explanation

int

gpio Port number

Return Value

return value type

explanation

boolean

Returns true on success and true on failure false

Examples

None


sensor.w1_write(pin, data1,data2)#

Single bus protocol, write data to the bus

Parameters

Incoming Value Type

Explanation

int

gpio Port number

int

The first data

int

The second data, can write n data

Return Value

return value type

explanation

nil

No return value

Examples

None


sensor.w1_read(pin, len)#

Single bus protocol, read data from the bus

Parameters

Incoming Value Type

Explanation

int

gpio Port number

int

Read Length

Return Value

return value type

explanation

int

Returns N integers by the length of the read

Examples

None


sensor.hx711(pin_date,pin_clk)#

Obtaining pressure sensing data for the Hx711

Parameters

Incoming Value Type

Explanation

int

gpio port number of the data

int

gpio port number of the clock

Return Value

return value type

explanation

int

hx711 Read the data

Examples

--  If the device is not present it will get stuck on the read interface
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)#

Get cs1237 sensor data

Parameters

Incoming Value Type

Explanation

int

gpio port number of the data

int

gpio port number of the clock

Return Value

return value type

explanation

int

cs1237 Read the data

Examples

--  If the device is not present it will get stuck on the read interface
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)--Get raw data
        end
    end
)

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

set ws2812b output (gpio drive mode)

Parameters

Incoming Value Type

Explanation

int

ws2812b gpio port number

string/zbuff

The data to be sent (if it is zbuff data, it will ignore the pointer position and always start from 0 offset.)

int

T0H Time, indicating how many nops are delayed, each model is different, adjust it yourself

int

T0L Time, indicating how many delays nop

int

T1H Time, indicating how many delays nop

int

T1L Time, indicating how many delays nop

Return Value

None

Examples

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)#

Set ws2812b output (pwm drive mode, pwm is required to output 800k frequency, otherwise this method cannot be used)

Parameters

Incoming Value Type

Explanation

int

pwm Port number

string/zbuff

The data to be sent (if it is zbuff data, it will ignore the pointer position and always start from 0 offset.)

Return Value

None

Examples

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

sensor.ws2812b_spi(pin,data)#

Set the ws2812b output (spi drive mode, spi is required to output 5M frequency, otherwise this method cannot be used)

Parameters

Incoming Value Type

Explanation

int

spi Port number

string/zbuff

The data to be sent (if it is zbuff data, it will ignore the pointer position and always start from 0 offset.)

Return Value

None

Examples

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

sensor.dht1x(pin)#

Obtain temperature and humidity data of DHT11/DHT12

Parameters

Incoming Value Type

Explanation

int

gpio Port number

boolean

whether to verify the crc value. the default value is true. not verifying the crc value can increase the probability of successful reading, but the wrong value may be read.

Return Value

return value type

explanation

int

Humidity data in 0.01%, error value returned on read failure

int

Temperature data in 0.01 degrees Celsius, error value returned when reading failed

boolean

Returns true on success, otherwise false

Examples

while 1 do
    sys.wait(1000)
    local h,t,r = sensor.dht1x(17, true) -- GPIO17 and check the CRC value
    log.info("dht11", h/100,t/100,r)--90.1 23.22
end

sensor.sc12a(sda,scl)#

Get channel data for sc12a touched

Parameters

Incoming Value Type

Explanation

int

gpio port number of the data

int

gpio port number of the clock

Return Value

return value type

explanation

int

If the read is successful, the reshaped data is returned. If the read fails, the error value is returned.

Examples

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

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

Single-bus command read and write YHM27XX

Parameters

Incoming Value Type

Explanation

int

gpio Port number

int

Chip ID

int

register address

int

The data to be written, if not filled, it means to read data from the register.

Return Value

return value type

explanation

boolean

Returns true on success and true on failure false

int

Return register value after successful reading, no return after successful writing

Examples

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