stevieb9/rpi-dht11 - Githubissues

NAME

RPi::DHT11 - Fetch the temperature/humidity from the DHT11 hygrometer
sensor on Raspberry Pi

SYNOPSIS

    use RPi::DHT11;

    my $pin = 18;

    my $env = RPi::DHT11->new($pin);

    my $temp     = $env->temp;
    my $humidity = $env->humidity;

DESCRIPTION

This module is an interface to the DHT11 temperature/humidity sensor
when connected to a Raspberry Pi's GPIO pins. We use the BCM GPIO pin
numbering scheme.

If you create an RPi::WiringPi object before creating an object in this
class, you can set up the RPi::WiringPi object with whichever pin
numbering scheme you choose, and this module will follow suit. Eg: if
you set RPi::WiringPi to wpi pin scheme, we'll use it here as well.
Note, though, that you MUST create the RPi::WiringPi object before you
create one of this class!

This module requires the wiringPi <http://wiringpi.com/> library to be
installed, and uses WiringPi's GPIO pin numbering scheme (see gpio
readall at the command line).

METHODS

new($pin, $debug)

Parameters:

    $pin

Mandatory. BCM GPIO pin number for the DHT11 sensor's DATA pin..

    $debug

Optional: Bool. True, 1 to enable debug output, False, 0 to disable.

temp('f')

Fetches the current temperature.

Returns an integer of the temperature, in Celcius by default.

Parameters:

    'f'

Optional: Send in the string char 'f' to receive the temp in Farenheit.

humidity

Fetches the current humidity.

Returns the current humidity percentage as an integer.

cleanup

Returns the pin back to default state if it's not already. Called
automatically by DESTROY().

ENVIRONMENT VARIABLES

There are a couple of env vars to help prototype and run unit tests
when not on a RPi board.

RDE_HAS_BOARD

Set to 1 to tell the unit test runner that we're on a Pi.

RDE_NOBOARD_TEST

Set to 1 to tell the system we're not on a Pi. Most methods/functions
will return default (ie. non-live) data when in this mode.

stevieb9 / rpi-dht11

readme