2024.12.5
Home ▸ Integrations ▸

LaCrosse

The lacrosse sensor integrationIntegrations connect and integrate Home Assistant with your devices, services, and more. [Learn more] 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.yamlThe configuration.yaml file is the main configuration file for Home Assistant. It lists the integrations to be loaded and their specific configurations. In some cases, the configuration needs to be edited manually directly in the configuration.yaml file. Most integrations can be configured in the UI. [Learn more] file. After changing the configuration.yamlThe configuration.yaml file is the main configuration file for Home Assistant. It lists the integrations to be loaded and their specific configurations. In some cases, the configuration needs to be edited manually directly in the configuration.yaml file. Most integrations can be configured in the UI. [Learn more] file, restart Home Assistant to apply the changes. The integration is now shown on the integrations page under Settings > Devices & services. Its entities are listed on the integration card itself and on the Entities tab.

# 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.yamlThe configuration.yaml file is the main configuration file for Home Assistant. It lists the integrations to be loaded and their specific configurations. In some cases, the configuration needs to be edited manually directly in the configuration.yaml file. Most integrations can be configured in the UI. [Learn more] 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

Related topics