README.md

Homebridge La Crosse View

Homebridge Plugin Providing La Crosse View (iOS, android) sensors support

Compatible sensors

Any La Crosse Technology temperature or humidity sensor compatible with La Crosse View system.

List of La Cross View system sensor compatible

Requirements

• a La Crosse View account (iOS, android)
• compatible sensor added to La Crosse View account

Installation

Before installing this plugin, you should install Homebridge using the official instructions.

Install via Homebridge Config UI X

1. Search for La Crosse View on the Plugins tab of Config UI X.
2. Install the Homebridge La Crosse View plugin and use the form to enter your La Crosse View application credentials.

Manual Installation

1. Install this plugin using: sudo npm install -g homebridge-lacrosseview --unsafe-perm.
2. Edit config.json manually to add your La Crosse View credentials. See below for instructions on that.

Configuration

It is recommended to use Homebridge Config UI X to setup the configuration if you don't want to manually edit JSON files.

"platforms": [{
  "platform": "LaCrosseView",
  "email": "your-la-crossse-view@email.com",
  "password": "your-la-crosse-view-password",

  "devicesToExclude": ["id-device"],
  "locationsToExclude": ["id-location"],
  "pollingInterval": 200,
  "fakeGatoEnabled": false
}]

• platform: (Required) Must always be set to LaCrosseView.
• email: (Required) Your La Crosse View application email
• password: (Required) Your La Crosse View application password
• pollingInterval: Interval in seconds to update data (Default to 200)
• devicesToExclude: Device ids to exclude (Default to [])
• locationsToExclude: Location ids to exclude (Default to [])
• fakeGatoEnabled: If historical data should be reported to the Elgato Eve App (Default to false)
• fakeGatoStoragePath: Custom path where to save fakegato history (Default to homebridge user path)

You can find device / location ids in your homebridge logs in debug mode

Elgato Eve

This plugin has support for adding historical data to the Elgato Eve App by using the excellent module fakegato-history.

To enable the Elgato Eve feature set fakeGatoEnabled to true in config.json

{
  "fakeGatoEnabled": true
}

fakegato-history caches historical values into a json-file. Usually located in /var/lib/homebridge or ~/.homebridge. To customise this one can set fakeGatoStoragePath to the desired path:

{
  "fakeGatoStoragePath": "/tmp/"
}

Incompatible sensors

If you have a La Crosse View sensor that is not yet supported by this plugin you can help adding support for it by following these steps:

1. Run homebridge in debug mode
2. Create a new issue and post your homebridge logs.

Acknowledgements

• Keith Prickett and Stuart Kuredjian for the original code to access La Crossse View API:
  • https://github.com/keithprickett/lacrosse_weather
  • https://github.com/dbconfession78/py_weather_station
• The homebridge team for homebridge and homebridge-plugin-template