nerves_dht

KO | EN

gitlite — search

#javascript #python #react #typescript #llm #rust #docker #macos #cli #vue #awesome-list #security #pytorch #ios

(★ 14)

Elixir library to read the DHT sensors on Raspberry Pi boards

nerves_dht Latest Version Download

Download Latest Version (.zip)

// repository documentation

Was this content helpful?

★ 0 (0 ratings)

# Nerves DHT

![CI](https://github.com/visciang/nerves_dht/workflows/CI/badge.svg) [![Coverage Status](https://coveralls.io/repos/github/visciang/nerves_dht/badge.svg?branch=master)](https://coveralls.io/github/visciang/nerves_dht?branch=master)

Elixir library to read the DHT series of humidity and temperature sensors on a Raspberry Pi.
The library is supposed to be included in a [nerves project](http://nerves-project.org/).

If you want to build your project directly on a Raspberry (not in a crosscompiling nerves project)
just export `MIX_TARGET` environment variable to you mix build.
Valid values for `MIX_TARGET` are `rpi`, `rp0`, `rp2`, `rp3`, `rp4`.

* Supported sensors: DHT11, DHT22, AM2302
* Supported boards: Raspberry 0, 1, 2, 3, 4

**Note**: the library has no external dependencies and use a C executable to read the sensors data.

## Installation

The package can be installed by adding `nerves_dht` to your list of dependencies in `mix.exs`:

```elixir
def deps do
  [
    {:nerves_dht, git: "https://github.com/visciang/nerves_dht.git", tag: "xxx"}
  ]
end
```

## Usage

```elixir
iex> NervesDHT.read(:am2302, 17)
{:ok, 55.1, 24.719}

iex> NervesDHT.stream(:am2302, 17) |> Enum.take(2)
[{:ok, 55.1, 24.719}, {:ok, 55.12, 24.9}]
```

If you plan to read concurrently from the sensor, add `NervesDHT` to your application supervisor tree:

```elixir
children = [
  {NervesDHT, [name: :my_sensor, sensor: :am2302, pin: 17]},
  ...
]
Supervisor.start_link(children, strategy: :one_for_one)
```

and read with:

```elixir
NervesDHT.device_read(:my_sensor)
NervesDHT.device_stream(:my_sensor)
```

## Test

```sh
$ export CI=true    # to build on a non RPI-nerves host
$ mix compile --warnings-as-errors
$ mix coveralls
```

nerves_dht

nerves_dht Latest Version Download

Today's picks

Was this content helpful?

Recent Feedback

nerves_dht

nerves_dht Latest Version Download

Today's picks

Was this content helpful?

Recent Feedback

Download README