home
Welcome to the mk-blindcontrol V8 wiki!
Original MKSMARTHOUSE V2 Blind Control Kit
For Installation and supply of kits including videos visit MK SMARTHOUSE
GUI integration for setup, firmware upgrade, resetting, changing settings on the Fly.
TASMOTA MQTT format and control option standards.
TELEMENTRY. JSON format on controller. SSID, signal information, servo position etc.
SPEED. Blind speed can be changed via MQTT command option and GUI.
AUTO OTA UPGRADE. Initiate global or individual firmware upgrade command via MQTT option to all devices.
FIRMWARE Check for firmware updates available from Repository Server.
BUTTON Provision for external push button control for multi function. Open/close, set to 50% and reset. Requires easy modification to PCB and option enabled in GUI.
BATTERY SYSTEM Provision for Battery/Solar operation with battery monitoring. Requires hardware modification and option enabled in GUI.
DISCOVERY SSDP enabled for network discovery on Windows machines. Device will be listed in Network Devices allowing support information and directly connecting to device via File Explorer.
Home Assistant Auto Discovery Auto generation YMAL for Home assistant discovery. See note below for template being implemented
Openhab Auto Discovery Auto generation for Openhab platform. See note below for template.
Username and Password required for some options. Username, it will be admin. And Password will be password. Password can be changed in SETUP.
MANUAL User Downloads from Repository and uploads via file manager.
AUTO Automatically Download and install via OTA Server as setup in configuration OTAAuto path. Manual Reboot required.
CHECK Connects to Repository Server for latest release and advises of installed version, release version and upgrade impact.
REBOOT Restart controller via GUI .
RESET Erase all settings, formats file system, restarts into AP setup mode. Password = password . (or password you changed to) . Username = admin.
ALIGN This sets the servo motor to the correct OPEN position during initial install, use this after configuring other options , Swing
direction to close, motor
LIMIT SET Set Open and Closed Limits via GUI slider.
SAVE Save settings, and also force publish Auto Discovery if enabled.
FILE MANAGER. Upload and download config files and device state data files.
SETUP Configure settings such as MQTT topic, Controller Name, Speed, Swing direction etc.
Host Device Name The name of the controller, also will be the ID shown in network. Eg. BlindControl1.
Device Friendly Name Device Friendly Name eg. Kitchen Blind
Device Unique Name Device Friendly Name auto converted eg kitchen_blind
MQTT Server MQTT server address. Eg 192.168.0.100.
Device MQTT Topic. Device topic for scribing to MQTT. Eg BlindControl1. This can be different to Host name. such as kitchen blind.
MQTT Port TCP port for MQTT Server connection. Eg 1883 . MQTT User ID user id to connect to MQTT Server
MQTT Password to connect to MQTT Server if enabled.
MQTT Authentication Set to TRUE if password required.
Admin Password to access certain functions that are protected. Default is password. Can be changed in setup.
OTAAuto path URL path to firmware mk-blindcontrol.bin can be your own OTA Server or REPO Server. http://mountaineagle-technologies.com.au/tasmota/mk-blindcontrol.bin
Blind Speed blind opens and closes, SLOW or FAST.
Motor Installed Side Position the servo motor is installed. LEFT or RIGHT.
Swing Direction To Close From the open position the direction to close. UP or DOWN.
Open Limit Open limit set position.
Closed Limit Closed limit set position.
Weight Slip Correction Blind will go from closed state to open before repositioning to intermediate range between 40 and 60 percent open. This is due to mechanical slip during weight transfer in this range. Default is on. Off will give incorrect positioning. Eg 45 degrees would be 60-70 degrees.
Auto Discovery Enable for discovery YMAL generation into Home Assistant and Openhab . ENABLED-BASIC, ENABLED-TILT, DISABLED. See notes
Remote Button Connected Enable if remote push button connected for manual control. Default NO. (Requires hardware modification).
Battery System Enable if device running on Battery/Solar setup, this is in Development stage. Default is NO. If YES the following will need Entering.
Battery Capacity mAh Battery capacity in mAh eg.3600.
System Power Watts Total power of device. Eg.0.4
Battery check in Sec Checks Battery State monitor for cap discharge times.
Telemetry Update period Time in seconds for Telemetry reporting.
Topic cmnd/< Device Base Topic >/Restartwith payload 1 Will restart the controller. Eg cmnd/BlindControl2/Restart payload 1
Topic cmnd/< Device Base Topic >/upgrade with payload 1 Will download and install firmware from the OTA Server. Eg cmnd/BlindControl2/upgrade payload 1. Note Reboot is automatically initiated.
Topic cmnd/< Device Base Topic >/SPEED with payload SLOW or FAST will change the speed of the blind and save the new setting. Eg cmnd/BlindControl2/SPEED payload SLOW
The TASMOTA global topic can be used for Restart and upgrade functions
cmnd/tasmotas/Restart payload 1 . Will restart all devices
cmnd/tasmotas/upgrade payload 1 . Will upgrade all devices
cmnd/< Device Base Topic >/Config payload Set . Will broadcast Auto Discovery Home Assistant
platform = "mqtt";
~ = _identifier; Friendly converted. E.g. Kitchen Blind >> kitchen_blind
name = Friendly Name; e.g. Kitchen Blind
unique_id = _identifier; e.g kitchen_blind
command_topic = "cmnd/"+_identifier+"/POWER";
state_topic = "stat/"+_identifier+"/STATE";
availability_topic = "tele/"+_identifier+"/LWT";
retain = false;
payload_open = "0";
payload_close = "100";
payload_stop = "STOP";
state_open = "0";
state_closed = "100";
payload_available = "Online";
payload_not_available = "Offline";
tilt_command_topic = "cmnd/"+_identifier+"/tilt";
tilt_status_topic = "stat/"+_identifier+"/tilt-state";
tilt_min = 0;
tilt_max = 100;
tilt_closed_value = 0;
tilt_opened_value = 100;
device_class = "blind";
platform = "mqtt";
~ = _identifier;
name = Friendly Name;
unique_id = _identifier;
command_topic = "cmnd/"+_identifier+"/POWER";
state_topic = "stat/"+_identifier+"/STATE";
availability_topic = "tele/"+_identifier+"/LWT";
retain = false;
payload_open = "0";
payload_close = "100";
payload_stop = "STOP";
state_open = "0";
state_closed = "100";
payload_available = "Online";
payload_not_available = "Offline";
device_class = "blind";
Openhab is based on sitemaps so you need to manually configure sitemap. see examples
If you are using Home Assistant, make sure retain message is set to false in the YMAL file for the blind section.
Delete all Retained messages in MQTT for command power topics. Check Below links
https://youtu.be/dbSw6VkI-x4 Video on Retained messages
http://mqtt-explorer.com/ used to edit MQTT Data Base
The firmware has been modified to control 2 servo motors from independent Data lines instead of one. This does require a modification to the circuit board by soldering the control wire to a pin on the ESP chip as follows
GPIO 13 aka D7 already part of PCB GPIO 14 aka D5 requires solder connection to this PIN on ESP chip on Matt’s PCB
The positive and Negative are connected to the existing terminals for servo
Note:- the second servo mirrors the first in movement it is a slave ONLY and can not be adjusted separately. Manual physical trim adjustments is required to obtain Symmetry.