https://github.com/taigrr/temper

Library for accessing temperature functions from TEMPer devices
https://github.com/taigrr/temper

temper temperature-sensor

Last synced: about 2 months ago
JSON representation

Library for accessing temperature functions from TEMPer devices

• Host: GitHub
• URL: https://github.com/taigrr/temper
• Owner: taigrr
• License: 0bsd
• Created: 2022-11-11T07:52:08.000Z (over 2 years ago)
• Default Branch: master
• Last Pushed: 2023-03-14T04:21:55.000Z (about 2 years ago)
• Last Synced: 2025-01-17T00:19:41.900Z (3 months ago)
• Topics: temper, temperature-sensor
• Language: Go
• Homepage:
• Size: 20.5 KB
• Stars: 0
• Watchers: 1
• Forks: 0
• Open Issues: 0
• Metadata Files:
  • Readme: README.md
  • Funding: .github/FUNDING.yml
  • License: LICENSE

Awesome Lists containing this project

README

        
# temper

[![Latest Release](https://img.shields.io/github/release/taigrr/temper.svg?style=for-the-badge)](https://github.com/taigrr/temper/releases)

[![Software License](https://img.shields.io/badge/license-0BSD-blue.svg?style=for-the-badge)](/LICENSE)

[![Go ReportCard](https://goreportcard.com/badge/github.com/taigrr/temper?style=for-the-badge)](https://goreportcard.com/report/taigrr/temper)

[![Go Doc](https://img.shields.io/badge/godoc-reference-blue.svg?style=for-the-badge)](https://pkg.go.dev/github.com/taigrr/temper)

A zero-dependency library to read USB TEMPer thermometers on Linux.

## Configuration

On Linux you need to set up some udev rules to be able to access the device as

a non-root/regular user.

Edit `/etc/udev/rules.d/99-temper.rules` and add these lines:

```

SUBSYSTEM=="hidraw", ATTRS{idVendor}=="1a86", ATTRS{idProduct}=="e025", GROUP="plugdev", SYMLINK+="temper%n"

SUBSYSTEM=="hidraw", ATTRS{idVendor}=="0c45", ATTRS{idProduct}=="7401", GROUP="plugdev", SYMLINK+="temper%n"

SUBSYSTEM=="hidraw", ATTRS{idVendor}=="0c45", ATTRS{idProduct}=="7402", GROUP="plugdev", SYMLINK+="temper%n"

SUBSYSTEM=="hidraw", ATTRS{idVendor}=="1130", ATTRS{idProduct}=="660c", GROUP="plugdev", SYMLINK+="temper%n"

```

Note that there are many versions of the TEMPer USB and your

`idVendor` and `idProduct` ATTRs may differ.

Make sure your user is part of the `plugdev` group and reload the rules with

`sudo udevadm control --reload-rules`.

Unplug and replug the device.

## Example Code

There are examples on how to use this repo in [examples/main.go](/examples/main.go)

Additionally, there is a cli-tool available at [temper-cli](https://github.com/taigrr/temper-cli)

## Acknowledgement

During my development I tested my code against the shell script found in [this article](https://funprojects.blog/2021/05/02/temper-usb-temperature-sensor/).

As I only have one TEMPer device, I have sourced the product and vendor IDs for

other TEMPer devices for the sample `.rules` file (above) from [this repo](https://github.com/edorfaus/TEMPered/blob/master/libtempered/temper_type.c).