Emulate cloud server for Oregon Scientific LW301

Installation

python3 setup.py install

Requirements:

• python 3.5+
• tornado 5+

Usage

lw301_server

Default config loaded from /etc/lw301-server/config.conf.

Config path may be overridden by environment value LW301_SERVER_CONFIG.

Available options:

lw301_server --help

CLI options overrided config options.

Triggers

InfluxDB

Enable by --enable-influxdb option. See --help for all options.

Trigger send recieved values to influxdb.

Values send as soon as they recieved from the weather station.

Written data:

Measurement	Tags	Fields
temperature	mac, channel	celsius (float)
humidity	mac, channel	relative (int)
pressure	mac	mmhg (int), hpa (int)

MQTT

TODO

How to catch LW301 traffic

Summary:

• overwrite DNS for some domains
• proxy :80 to this app

TODO: instructions & sample configs.

DNS

Domains resolved by LW301:

• static.oregonscientific.com – some init routines
• gateway.weather.oregonscientific.com - sending data
• blackbox-c.infra.idtcsd.net - ?

API

Note: history data lost if app stopped.

GET /api/history/temperature

{
    "history": [
        {
            "timestamp": 1532271317,
            "utc_datetime": "2018-07-22 17:55:17",
            "value": {
                "celsius": 22.1,
                "channel": 1,
                "mac": "00001234abcd"
            }
        },
        // ...
    ],
    "measurement": "temperature"
}

GET /api/history/humidity

{
    "history": [
        {
            "timestamp": 1532271317,
            "utc_datetime": "2018-07-22 17:55:17",
            "value": {
                "channel": 1,
                "mac": "00001234abcd",
                "relative": 79
            }
        },
        // ...
    ],
    "measurement": "humidity"
}

GET /api/history/pressure

{
    "history": [
        {
            "timestamp": 1532271186,
            "utc_datetime": "2018-07-22 17:53:06",
            "value": {
                "hPa": 982,
                "mac": "00001234abcd",
                "mmHg": 736
            }
        },
        // ...
    ],
    "measurement": "pressure"
}

Licence

Apache License 2.0