Shutter Control
Model J1 manufactured by Ubisys
Zigbee ID: J1 (5502)
Shutter Control
Available from:
Confirmed working with
If the device is following Zigbee standards it is possible it will work with other gateway solutions, it is just not confirmed as working yet!

OTA Updates

This device supports OTA updates. For more information see your gateway's software documentation.

Unique Zigbe2MQTT Configuration

By publishing to zigbee2mqtt/[FRIENDLY_NAME]/set various device attributes can be configured:

    "configure_j1": {
        "windowCoveringType": xxx,
        "configStatus": xxx,
        "installedOpenLimitLiftCm": xxx,
        "installedClosedLimitLiftCm": xxx,
        "installedOpenLimitTiltDdegree": xxx,
        "installedClosedLimitTiltDdegree": xxx,
        "turnaroundGuardTime": xxx,
        "liftToTiltTransitionSteps": xxx,
        "totalSteps": xxx,
        "liftToTiltTransitionSteps2": xxx,
        "totalSteps2": xxx,
        "additionalSteps": xxx,
        "inactivePowerThreshold": xxx,
        "startupSteps": xxx,
        "totalSteps": xxx,
        "totalSteps2": xxx

For further details on these attributes please take a look at the ubisys J1 technical reference manual, chapter “7.2.5. Window Covering Cluster (Server)”.

As an alternative to the attributes listed above, the following properties may be used for convenience:

  • open_to_closed_s: corresponds to totalSteps, but takes value in seconds instead of in full AC waves
  • closed_to_open_s: ditto for totalSteps2,
  • lift_to_tilt_transition_ms: sets both liftToTiltTransitionSteps and liftToTiltTransitionSteps2 (they shall both be equal according to ubisys manual), but takes value in milliseconds instead of in full AC waves
  • steps_per_second: factor to be used for conversion, defaults to 50 full AC waves per second if not provided

By publishing to zigbee2mqtt/[FRIENDLY_NAME]/get/configure_j1 the values of the configuration attributes can also be read back from the device and be printed to the normal zigbee2mqtt log.


By publishing {"configure_j1": {"calibrate": 1}} to zigbee2mqtt/[FRIENDLY_NAME]/set the device can also be calibrated after installation to support more advanced positioning features (i.e. go to lift percentage / go to tilt percentage). This can be combined with setting attributes as shown above, for example:

    "configure_j1": {
        "calibrate" : 1,
        "windowCoveringType": 8,
        "lift_to_tilt_transition_ms": 1600

The calibration procedure will move the shutter up and down several times and the current stage of the calibration process will again be logged to the normal zigbee2mqtt log for the user to get some feedback. For details on the calibration procedure please again take a look at the ubisys J1 technical reference manual, chapter “ Calibration”. Please note that tilt transition steps cannot be determined automatically and must therefore be configured manually for the device to also support “go to tilt percentage”. One possibility to determine the correct value is to take a video of the blinds moving from 0 to 100 percent tilt and then getting the exact timing from the video by playing it slow motion.

Home Assistant cover features when using MQTT discovery

The cover will be offered to Home Assistant as supporting lift and tilt by default, but for covers with reduced functionality this can be passed along to Home Assistant by disabling some of the topics in configuration.yaml, for example:

    friendly_name: cover_not_supporting_tilt'
    tilt_command_topic: null
    tilt_status_topic: null
    friendly_name: cover_supporting_neither_lift_nor_tilt'
    set_position_topic: null
    position_topic: null
    tilt_command_topic: null
    tilt_status_topic: null