Adding Jarolift covers to the Home Assistant

Here will be described a quick and easy way how to add the Jarolift integration to the Home Assistant and how to configure it. This integration is used to control Jarolift radio capable rollo motors. In my case the type of the motors is TDEF, but integration may work with other radio capable motors. As a remote I'll be using Broadlink RM4 Pro. This remote has to be configured in Home Assistant by using Broadlink integration and you need to write down the entity id of this device, you'll need it to configure Jarolift integration.

The code for this integration can be found here: (Unofficial) Jarolift Integration for Home Assistant.

The necessary keys for the integration can be found by searching Jarolift pastebin.

Adding integration using HACS

Prerequisite for this type of adding of the integration is to having setup HACS.

In your Home Assistant go HACS -> Integrations -> Additional configuration (three dots in the upper right corner) -> Custom repositories.

In the Repository field put the repository address: https://github.com/weaseel/hass-jarolift. For the Category chose Integration and finally click the ADD button.

Now you can install the Jarolift integration as usual.

Configuration

Prerequisite for this configuration that you have keys needed for the Jarolift encryption. As mentioned at the beginning of this document.

These keys are in the format:

MSB: '0x12345678'
LSB: '0x09876543'

The next what you need to prepare is group-ids and serial nos. For each device you will require one group id and one serial. Please use for each controlled cover (Jarolift motor) it's own serial number. Please be aware that group-ids are treated as binary enabled/disabled values. For example if you use 0x0005 for group-id, this will possibly control 2 covers, the ones with group-ids 0x0001 and 0x0004.

In my case I have 9 covers to control so I created the following config in the main configuration.yaml:

jarolift:
  remote_entity_id: remote.rm4pro_remote
  MSB: '0x12345678'
  LSB: '0x09876543'

cover:
  - platform: jarolift
    covers:
      - name: 'Buero'
        group: '0x0001'
        serial: '0x106ac01'
      - name: 'Whonzimmer'
        group: '0x0002'
        serial: '0x106ac02'
      - name: 'Balkon'
        group: '0x0004'
        serial: '0x106ac03'
      - name: 'SchlafzimmerTuer'
        group: '0x0008'
        serial: '0x106ac04'
      - name: 'SchlafzimmerFenster'
        group: '0x0010'
        serial: '0x106ac05'
      - name: 'Kueche'
        group: '0x0020'
        serial: '0x106ac06'
      - name: 'Kinderzimmer'
        group: '0x0040'
        serial: '0x106ac07'
      - name: 'Spielzimmer'
        group: '0x0080'
        serial: '0x106ac08'
      - name: 'Bad'
        group: '0x0100'
        serial: '0x106ac09'

As you can see, the serial numbers are incremental and the group ids are power of 2, binary shift left.

After this configuration is added or changed you have to restart your Home Assistant.

If all OK after the restart, you should see all your covers listed in the entities in Home Assistant.

Learning the cover codes to the Home assistant - pairing

Set the controlled cover into learning mode. This can be done by using an already paired remote and pressing the button up and the button down at the same time and then pressing eight times the button stop. If the cover is turned into learning mode,the cover will confirm it by shortly going up and then down.

In your home assistant go to the Developer tools -> Services and find the service Jarolift integration: learn. In the field Service data put the corresponding group and the serial of your device you want to pair and click the button CALL SERVICE. I suggest that you prepare this call before turning the cover into learning mode.

If pairing is successful the cover will go shortly up and then down as confirmation.

Repeat this process for every cover you have.