Author image Irakliy Sunguryan

NAME

Device::SDS011 - Module to work with SDS011 particulate matter laser sensor

SYNOPSIS

    use Device::SDS011;

    my $sensor = Device::SDS011->new('/dev/ttyUSB0');

    $sensor->sensor_mode(1);    # wake up (if in sleeping mode)
    sleep 5;
    $sensor->reporting_mode(1); # 1 = Report query mode
    $sensor->working_period(0); # 0 = Continuous mode

    while (1) {
        my ($pm25, $pm10);
        for (1..3) {
            my ($pm25_tmp,$pm10_tmp) = @{$sensor->query_data};
            $pm25 += $pm25_tmp;
            $pm10 += $pm10_tmp;
            sleep 3;
        }
        printf "PM25:%.2f, PM10:%.2f\n", $pm25/3, $pm10/3;
        $sensor->sensor_mode(0); # enter sleep mode
        sleep 60 * 15;
    }

DESCRIPTION

Module to receive data from, and control SDS011 particulate matter sensor.

This module uses Device::SerialPort for communicating with sensor. Laser Dust Sensor Control Protocol v1.3 is implemented.

Data retrieved

SDS011 uses the principle of laser scattering in the air, can be obtained from 0.3 to 10 microns suspended particulate matter concentration.

This module allows retrieving PM 2.5 mass in mg/m3 and PM 10 mass in mg/m3 sensor readings.

CONSTRUCTOR

Device::SDS011->new( $usb_device )

Creates and returns a new Device::SDS011 object, open specified port, and configure it according to the protocol: 9600 bps with 8 data bit, no parity, one stop bit.

The $usb_device option is passed on to Device::SerialPort (please see documentation for this module).

    my $sensor = Device::SDS011->new('/dev/ttyUSB0');

METHODS

$sensor->live_data

Returns current PM readings as an arrayref [PM 2.5, PM 10].

Ex.: [8.77,17.73]

By default the sensor device works in Active reporting mode with Continuous working period, which means it reports PM readings every 1 second continuously. This method can be used to read the values.

$sensor->query_data

Requests sensor data. Returns current PM readings as an arrayref [PM 2.5, PM 10].

Also see the reporting_mode() method.

$sensor->reporting_mode

$sensor->reporting_mode( $mode )

Sets report mode. Valid values: 0 (active) and 1 (query). When parameter value is not specified it returns current reporting mode (0 or 1).

* Report active mode Sensor automatically reports a measurement data in a work period.

* Report query mode Sensor received query data command to report a measurement data.

$sensor->sensor_mode

$sensor->sensor_mode( $mode )

Sets sensor mode. Valid values: 0 (sleep) and 1 (work). When parameter value is not specified it returns current sensor mode (0 or 1).

"Service life is the key parameter of laser dust sensor. The laser diode in this sensor has high quality and its service life is up to 8000 hours. If you don't need real-time data (such as filter, air quality monitoring, etc.), you can use the discontinuous working method to prolong the service life."

$sensor->working_period

$sensor->working_period( $mode )

Sets working period. Valid values: 0 (continuous), and 1-30 minute(s) -- work 30 seconds, and sleep n*60-30 seconds. When parameter value is not specified it returns current working period.

$sensor->firmware

Returns sensor's firmware version: a string of format YY-MM-DD (year, month, date).

$sensor->device_id

$sensor->device_id( $id_byte_1, $id_byte_2 )

    say join ' ', map { sprintf '%02x', $_ } @{$sensor->device_id};
    my $newID = $sensor->device_id( 0xD0, 0xEA ); # returns [0xD0,0xEA]

Sets Device ID. Returns new device ID -- arrayref to two ID bytes. When no ID specified returns current device ID.

NOTE: All methods of this module will save/update (internally) the Device ID, since all commands return it. If this command is called first, it will (ab)use reporting_mode() method to get the ID.

$sensor->done

Destroys the Device::SerialPort object. Re-connect is not possible.

AUTHOR

Irakliy Sunguryan

DEVELOPMENT & ISSUES

Repository: https://github.com/OpossumPetya/pi-air-monitor.

Please report any bugs at GitHub, or RT.

LICENSE AND COPYRIGHT

Copyright 2019 Irakliy Sunguryan

This program is free software; you can redistribute it and/or modify it under the terms of either: the GNU General Public License as published by the Free Software Foundation; or the Artistic License.