aranet4

README

aranet4

This is a fork of the aranet4 package, tweaked to use tiny-go/bluetooth to support Bluetooth cross-platform (e.g. MacOS/Windows as well as Linux).

aranet4 is a Bluez based driver for the Aranet4 air quality monitor.

Installation

aranet4-ls

$> go install sbinet.org/x/aranet4/cmd/aranet4-ls
$> aranet4-ls
CO2:         547 ppm
temperature: 19.85°C
pressure:    980.5 hPa
humidity:    29%
quality:     green
battery:     96%
interval:    5m0s
time-stamp:  2022-01-20 15:48:28 UTC

$> aranet4-ls -ts -o out.csv
CO2:         547 ppm
temperature: 19.85°C
pressure:    980.5 hPa
humidity:    29%
quality:     green
battery:     96%
interval:    5m0s
time-stamp:  2022-01-20 15:48:28 UTC

$> head out.csv
id;timestamp (UTC);temperature (°C);humidity (%);pressure (hPa);CO2 (ppm)
0;2022-01-18 13:53:28;20.30;38;982.3;667
1;2022-01-18 13:58:28;21.30;36;982.3;836
2;2022-01-18 14:03:28;21.20;36;982.2;763
3;2022-01-18 14:08:28;21.10;35;982.2;825
4;2022-01-18 14:13:28;21.05;35;982.2;807
5;2022-01-18 14:18:28;21.00;34;982.3;765
6;2022-01-18 14:23:28;20.95;34;982.2;928
7;2022-01-18 14:28:28;20.90;34;982.2;911
8;2022-01-18 14:33:28;20.85;34;982.2;861

aranet4-srv

aranet4-srv is a simple HTTP server that plots the full history of data samples one can retrieve from an aranet4 sensor.

This Go-based driver is heavily inspired from Anrijs/Aranet4-Python. Thanks a bunch.

Documentation

Index

• Variables
• type Data
  • func (data Data) String() string
• type Device
  • func New(addr string) (*Device, error)
  • func (dev *Device) Close() error
  • func (dev *Device) Interval() (time.Duration, error)
  • func (dev *Device) Name() (string, error)
  • func (dev *Device) NumData() (int, error)
  • func (dev *Device) Read() (Data, error)
  • func (dev *Device) ReadAll() ([]Data, error)
  • func (dev *Device) Since() (time.Duration, error)
  • func (dev *Device) Version() (string, error)
• type Quality
  • func (st Quality) String() string

Variables

var (
	// ErrNoData indicates a missing data point.
	// This may happen during sensor calibration.
	ErrNoData = errors.New("aranet4: no data")
)

Types

type Data

type Data struct {
	H, P, T float64
	CO2     int
	Battery int
	Quality Quality

	Interval time.Duration
	Time     time.Time
}

Data holds measured data samples provided by Aranet4.

func (Data) String

func (data Data) String() string

type Device

type Device struct {
	// contains filtered or unexported fields
}

func New

func New(addr string) (*Device, error)

func (*Device) Close

func (dev *Device) Close() error

func (*Device) Interval

func (dev *Device) Interval() (time.Duration, error)

func (*Device) Name

func (dev *Device) Name() (string, error)

func (*Device) NumData

func (dev *Device) NumData() (int, error)

func (*Device) Read

func (dev *Device) Read() (Data, error)

func (*Device) ReadAll

func (dev *Device) ReadAll() ([]Data, error)

This doesnt really work right now.

func (*Device) Since

func (dev *Device) Since() (time.Duration, error)

func (*Device) Version

func (dev *Device) Version() (string, error)

type Quality

type Quality int

Quality gives a general assessment of air quality (green/yellow/red).

• green: [ 0 - 1000) ppm
• yellow: [1000 - 1400) ppm
• red: [1400 - ...) ppm

func (Quality) String

func (st Quality) String() string