Confirmed working with
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 tototalSteps
, but takes value in seconds instead of in full AC wavesclosed_to_open_s
: ditto fortotalSteps2
,lift_to_tilt_transition_ms
: sets bothliftToTiltTransitionSteps
andliftToTiltTransitionSteps2
(they shall both be equal according to ubisys manual), but takes value in milliseconds instead of in full AC wavessteps_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.
Calibration
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 “7.2.5.1. 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:
'0x001fee0000001234':
friendly_name: cover_not_supporting_tilt'
homeassistant:
tilt_command_topic: null
tilt_status_topic: null
'0x001fee0000001234':
friendly_name: cover_supporting_neither_lift_nor_tilt'
homeassistant:
set_position_topic: null
position_topic: null
tilt_command_topic: null
tilt_status_topic: null