LaCrosse to MQTT gateway

This is a gateway to receive temperature and humidity from (868 MHz)

• LaCrosse IT+ - temperature + humidity sensors
• WH1080 - Weatherstations
• TX35-IT - temperature + humidity sensors
• TX38-IT - indoor temperature sensors
• WH1080 - Weatherstations
• WS1600 - Weatherstations
• WT440XH - temperature + humidity sensors
• TX22-IT - Weatherstations
• W136 - Weatherstations
• EMT7110 - Energy Meter
• WH24 - Weathersensor
• WH25 - Pressure Sensor

and publish them to a MQTT broker.

The code was originally inspired by LaCrosseITPlusReader but the original code has been completely reworked since then. It is designed to run on a "TTGO LORA" board which has a SX1276 RF chip and a SSD1306 OLED on board.

At first installation just connect to the WiFi: Lacrosse2mqttAP and connect the device to your network with the wizard.

The web page is showing the received sensors with their values, the configuration page allows to specify a name / label for every sensor ID. To clear a label for a sensor, just enter an empty label.

MQTT publishing of values

On the config page, you can enter the hostname / IP of your MQTT broker. The topics published are:

• lacrosse/climate/<LABEL>/temp temperate
• lacrosse/climate/<LABEL>/humi humidity (if available) or
• lacrosse/id_<ID>/temp, lacrosse/id_<ID>/humi the same but per ID. Note that the ID may change after a battery change! Labels can be rearranged after a battery change for stable naming.
• lacrosse/id_<ID>/state additional flags "low_batt", "init" (for new battery state), "RSSI" (signal), "baud" (data rate) as JSON string

FHEM Connector

Set FHEM Mode in the settings to use the serial output from the gateway as a direct replacement for the original LaCrosseGateway (LGW) 'define myLaCrosseGW LaCrosseGateway :81'

First upload

• Open Chrome or any chromium based browser.
• Download newest firmware (lacrose2mqtt.YYYY.XX.X.bin) at the release page.
• Connect the board with your computer over USB.
• Open ESP Web Tools
• Click "connetct" and chose the right COM-Port.
• Upload the bin file (follow the instuctions).

Firmware update

Download newest firmware (lacrose2mqtt.YYYY.XX.X.bin) at the release page. The software update can be uploaded via the "Update software" link from the configuration page

Reset WiFi

Long press (5s) the PRG button

Toggle Display

Short press the PRG button

Debugging

More information about the current state is printed to the serial console, configured at 115200 baud.

Dependencies / credits

The following libraries are needed for building (could all be installed via arduino lib manager, github url only for reference):

• LittleFS_esp32

• PubSubClient

• ArduinoJson

• Adafruit SSD1306

• Adafruit GFX

• WiFiManager

• Heltec Boards

Nice2have

• Avoid 0.000kbs decode
• Avoid send ID data over MQTT if name is chosen
• Refractor Code

Know problems

Source/Idea

This project uses code and protocol descriptions derived from LaCrosseITPlusReader10, which itself is based on the LaCrosse IT+ Reader contributed to the FHEM project. See LICENSES.md for details.

Licenses and Attributions

This project uses code derived from FHEM protocol implementations and various open-source libraries. For complete license information and attributions, see LICENSES.md.