Home Assistant Home Assistant

LaCrosse

The lacrosse sensor platform is using the data provided by a Jeelink USB dongle or this Arduino sketch.

Tested Devices

  • Technoline TX 29 IT (temperature only)
  • Technoline TX 29 DTH-IT (including humidity)
  • TFA Dostmann LaCrosse sensors (type 30.3147.IT)

Setup

Since the sensor change their ID after each powercycle/battery change you can check what sensor IDs are available by using the command-line tool pylacrosse from the pylacrosse package.

sudo pylacrosse -d /dev/ttyUSB0 scan

Or, when using Docker containers:

docker exec -it <containername> pylacrosse -d /dev/ttyUSB0 scan

If you are using the Home Assistant OS or Supervised installation method, these methods are not available for you. The use of an additional computer to figure out the ID is advised.

For TX 29 DTH-IT sensors you can also read the ID from the display and calculate the ID as followed: hex2dec(ID_on_display) / 4.

Configuration

To use your lacrosse compatible sensor in your installation, add the following to your configuration.yaml file:

# Example configuration.yaml entry
sensor:
  - platform: lacrosse
    sensors:
      sensor_identifier:
        type: SENSOR_TYPE
        id: SENSOR_ID

Configuration Variables

Looking for your configuration file?
device string Required, default: /dev/ttyUSB0

The serial device.

baud integer Required, default: 57600

The serial baudrate.

led boolean (Optional, default: false)

Activate or deactivate the Jeelink LED.

frequency integer (Optional)

Initial frequency in 5kHz steps.

datarate integer (Optional)

Set the data rate in kbps. Special values for well-known settings are: 0: 17.241 kbps, 1: 9.579 kbps, 2: 8.842 kbps.

toggle_mask integer (Optional)

The following values can be combined bitwise: 1 = 17.241 kbps, 2 = 9.579 kbps, 4 = 8.842 kbps

toggle_interval integer (Optional)

Enable the toggle mode and set the interval in seconds.

sensors map Required

A list of your sensors.

name string (Optional)

The name of the sensor.

type string Required

The type of the sensor. Options: battery, humidity, temperature

id integer Required

The LaCrosse Id of the sensor.

Examples

To setup a LaCrosse sensor with multiple sensors, add the following to your configuration.yaml file:

# Example configuration.yaml entry
sensor:
  - platform: lacrosse
    device: /dev/ttyUSB0
    baud: 57600
    sensors:
      kitchen_humidity:
        name: Kitchen Humidity
        type: humidity
        id: 72
      kitchen_temperature:
        name: Kitchen Temperature
        type: temperature
        id: 72
      kitchen_lacrosse_battery:
        name: Kitchen Sensor Battery
        type: battery
        id: 72