AXA Remote component for ESPHome.

Introduction

This ESPHome External Component lets you control an AXA Remote window opener.

Features:

• Open/Stop/Close the window
• Move window to a given position
• Calibrate the open/close timings
• Use remote control simultaneously

Using the remote control

The AXA Remote only reports if the device is locked or unlocked. When using the remote control to open the window from a closed position the integration can detect this and report the state accordingly. The same applies for closing the window with the remote control till a fully closed position. However stopping the window or partially opening/closing the window with the remote control can not be detected and the exact position the window is opened at will not correspond with the real position.

Hardware required:

• ESP8266, ESP32 or other ESPHome supported micro controller
• LIN-bus controller or any other kind of level converter
• External power supply

Wiring

The AXA Remote has two identical RJ25 (6P6C) connectors, a pin on one connector is connected with the same pin on the other connector. The pinout is as follows:

Pin	Function
1	Vin
2	GND
3	RX/TX
4	RX/TX
5	GND
6	Vin

Wiring a LIN-bus controller as level converter goes as follows:

Powering the AXA Remote

The outer pins of the RJ25 are the + voltage input and pin 2/5 the 0 voltage. The official AXA Remote power supply delivers 7.5 Volt, however the device also seems to work fine on 9 Volt. The voltage does influence the speed and noise of the device, a lower voltage runs the device slower and less noisy while a higher voltage faster and noisier.

Protocol

This are the protocol details:

Serial port settings: 19200 baud 8N2

Device command: DEVICE, returns the device type, AXA RV2900 2.0 on my device.
Version command: VERSION, returns the firmware version of the AXA Remote.
Status command: STATUS, returns the current lock state.
Open command: OPEN, opens the window opener.
Stop command: STOP, stops the window opener.
Close command: CLOSE, closes the window opener.
Help command: HELP, shows the available commands.

Each command is ended with a carriage return and newline \r\n.

Lock states

• Unlocked
• Strong Locked
• Weak Locked

Quirks

After a power outage the AXA Remote always reports the lock state as unlocked even though the window is closed and locked. Only opening and closing the window will reset the lock state.

ESPHome example configuration:

esphome:
  name: axaremote
  friendly_name: AXA Remote

external_components:
  - source: github://rrooggiieerr/esphome-axaremote

esp8266:
  board: nodemcu

# Enable logging
logger:
  level: INFO

# Enable Home Assistant API
api:
  encryption:
    key: ...

ota:
  - platform: esphome
    password: ...

wifi:
  ssid: !secret wifi_ssid
  password: !secret wifi_password

uart:
  tx_pin: ...
  rx_pin: ...
  baud_rate: 19200
  stop_bits: 2

cover:
  - platform: axaremote
    name: "AXA Remote"
    close_duration: 50s
    auto_calibrate: True

Configuration variables:

• close_duration (Optional): The close duration from fully open to fully locked. From this time the unlock, open, close and lock durations are derived.
• auto_calibrate (Optional): Enable/disable auto calibration of the unlock, open, close and lock durations.

Calibration

This AXA Remote component for ESPHome can automatically calibrate the unlock, open, close and lock durations. To do this open the window fully and close the window from the ESPHome device. The component will measure the time it takes until the lock is in one of the locked states. By default the close duration is logged as info message to the ESPHome logging console. You can then use this value to set the close_duration of your ESPHome configuration YAML. You can also enable auto_calibrate which will automatically update the unlock, open, close and lock durations every time the window is closed from fully open to fully closed and locked.

Support my work

Do you enjoy using this ESPHome component? Then consider supporting my work using one of the following platforms, your donation is greatly appreciated and keeps me motivated:

Hire me

If you're in need for a freelance ESP developer for your project please contact me, you can find my email address on my GitHub profile.