# usbrh

A small tool and library for the USBRH (USB-connected temperature and humidity sensor).

The USBRH is a product of [Strawberry Linux](https://strawberry-linux.com/).
It uses Sensirion SHT11 sensor.

https://strawberry-linux.com/catalog/items?code=52001

## Install

```shell
# If you are using openSUSE
% sudo zypper install libusb-1_0-devel
# or if you are using Ubuntu
% sudo apt install libusb-dev

% cargo build --release
% sudo install -s target/release/usbrh /usr/local/bin
```

or 

```shell
% cargo install usbrh
```

## Usage

```shell
% usbrh --help
% sudo usbrh
temperature    humidity
25.02    60.00
```

## License

Licensed under either of

 * Apache License, Version 2.0, ([LICENSE-APACHE](LICENSE-APACHE) or http://www.apache.org/licenses/LICENSE-2.0)
 * MIT license ([LICENSE-MIT](LICENSE-MIT) or http://opensource.org/licenses/MIT)

at your option.

## Contribution

Unless you explicitly state otherwise, any contribution intentionally submitted
for inclusion in the work by you, as defined in the Apache-2.0 license, shall be dual licensed as above, without any
additional terms or conditions.

## Acknowledgements

- [USBRH driver for Linux](http://green-rabbit.sakura.ne.jp/usbrh/) for the USB protocol.


## Resources

- https://www.sensirion.com/en/environmental-sensors/humidity-sensors/digital-humidity-sensors-for-accurate-measurements/
- https://www.sensirion.com/fileadmin/user_upload/customers/sensirion/Dokumente/0_Datasheets/Humidity/Sensirion_Humidity_Sensors_SHT1x_Datasheet.pdf
- https://www.sensirion.com/fileadmin/user_upload/customers/sensirion/Dokumente/1_Subsidiaries_Documents/1_Japan/1_Humidity_Sensors/Sensirion_Humidity_Sensors_SHT1x_Datasheet_V5b_J.pdf