mcsMQTT HomeSeer HS3 Plug-in - mcssprinklers.com

1 Page 1 mcsMQTT HomeSeer HS3 Plug-in Michael McSharry October 19, 2019 Version Page 2 Contents 1 Introduction .. 14 2 Installation .. 14 3 Environment & Architecture .. 16 mqtt Environment .. 16 mcsMQTT Plug-in Architecture .. 16 4 Quick Start .. 17 Q&A .. 17 How do I get started .. 17 How do I view the mqtt Topic Payload in HS Device .. 18 How do I setup a Command/Response Device so HS can control mqtt item and show its status 18 How do I control an existing HS Device with a mqtt Topic .. 18 I want to subscribe to a Topic, but the Topic has not yet been published through the broker 18 The Device Management UI is not showing what I want for mqtt Devices, how do I change it 19 I see Dim for HS Device Status, how do I remove or change Dim .. 19 Payload numbers contains periods for decimal. I need them to be comma .. 19 How do I know if I am communicating with mqtt broker.

2 19 Where do I look when things go wrong .. 19 How do I know if a client has stopped publishing mqtt messages .. 20 How do I publish a mqtt message when some event has been triggered in HS .. 20 How do I chart the time history of a topic s payload .. 20 How do I chart the time history of a HS device .. 20 How do I change Payload temperature from Centigrade to Fahrenheit .. 20 My mqtt payload is wattage rate, but I want HS to provide daily wattage use .. 20 How do I easily initialize an IOT device with one-tiime configuration messages .. 21 Page 3 I have been experimenting and have topics that will never be used again. How do I permanently remove them .. 21 How do I group devices in HS Device Management display .. 21 How do I automatically associate sets of mqtt topics .. 21 How do I setup device with different status and control payloads .. 23 How do I conveniently control a colored light.

3 24 How do I change the subscribe Topic that is associated with a HS Device .. 27 How do I remove Topics that have become obsolete .. 28 How do I update HS Device with minimum resource utilization .. 28 How do I associate multiple topics to the same HS Device .. 29 How do I use multiple Topics to change status of single HS Device .. 30 How do I connect to multiple brokers .. 31 How to record changes to HS Log .. 33 How to view CSV payloads in separate HS Devices .. 33 Default Settings for mcsMQTT .. 34 Automatic Setup of Device to Topic Relationship .. 34 Manual Setup of Device to Topic Relationship .. 36 Leveraging Association and Edit/Add Tabs .. 36 Leveraging Multiple mcsMQTT Browser 37 Tasmota Considerations .. 37 5 Sending mqtt Messages .. 38 Send mqtt via HS3 Device Change .. 41 Send User-Customized Topics and Payloads .. 42 Send mqtt via Event Action.

4 44 Send mqtt via Script .. 46 Sending Periodic Status .. 47 Sending Configuration / Setup Messages .. 48 Sending Messages to LED Messaging Sign .. 50 Messaging Sign Use Cases .. 51 6 Receiving mqtt Topics .. 54 Receive mqtt Payload in HS3 56 Page 4 Payload Textual Transformations .. 57 Payload Numeric Transformations .. 59 Payload OtherTransformations .. 60 Controlling HS3 Device via mqtt Topic .. 63 mqtt Receive Event Triggers .. 64 Topic Wildcards .. 65 Scripting Callback .. 65 7 Display Filtering and Sorting .. 67 8 History .. 69 9 Charts .. 71 10 mcsMQTT Self Signed Certificate Support .. 75 Part I. SSL/TLS Communications .. 75 Why encrypt your IOT/ mqtt Network .. 75 SSL Communications Overview .. 75 Root Signed and Self-Signed certificates .. 76 SSL Options that NEED CLOSURE .. 79 Installing SSL support on the mcsMQTT Plug-in .

5 80 SSL/TLS Certificate creation: .. 80 Software/Tools: .. 80 Certificate Creation .. 80 Mosquitto Broker configuration for SSL .. 85 11 Bluetooth Low Energy (BLE) Page .. 87 BLE Page 87 Getting Started with BLE .. 88 Tasmota 90 Tips .. 91 Setup Tab .. 92 Page Viewing Options .. 92 Configuration Parameters Table .. 93 Beacons Locations Table .. 95 Scanner Location Table .. 97 Page 5 Location Tab .. 98 Distance Tab .. 99 24 Hour Tab .. 102 12 Performance Considerations .. 104 HS Event Callbacks .. 104 Express Mode .. 104 Subscription Topics .. 105 Plug-in Startup .. 108 Browser Page Rendering .. 109 13 Reference Tool Tips .. 110 General Tab .. 110 mcsMQTT Management .. 110 mqtt Broker Operations .. 111 Inbound (Subscription) Management .. 113 Outbound (Publish) Management .. 115 Association Tab .. 118 Filters to Restrict Number of Displayed Rows in Association Table.

6 119 Associations Build/Display Control .. 119 Association Table Header .. 120 Association Table Row Parameters .. 120 Edit/Add Tab .. 123 Start Reference .. 123 Publish (Outbound) .. 123 Subscription (Inbound).. 125 Sign Popup .. 130 Edit Popup .. 131 PubList/Sign Tab .. 133 Publication List .. 133 Sign Use Setup .. 134 Statistics Tab .. 136 History Tab .. 137 Page 6 Filters History by Category, Topic and 137 History Table Build/Display Control .. 138 History Table Header .. 138 Chart Tab .. 139 Chart Definition Load / Save .. 140 Date/Time Range Selection .. 140 Topic/Item Selection .. 140 Chart Y Axis Scaling .. 141 Chart Build/Display Control .. 141 BLE Setup Tab .. 141 Page Viewing Options .. 141 Beacon Locations with Last 24 Hours Data .. 141 Scanner Locations .. 142 Configuration Parameters .. 143 14 Zigbee2 mqtt .

7 145 Zigbee2mqtt Firmware .. 146 Zigbee Sniffer .. 150 New Zigbee Devices .. 151 15 Sonoff Basic Applications with Tasmota .. 154 Firmware Upload .. 154 WiFi Garage Door Control .. 156 Pulse Counter .. 162 Low Volume Water Flow .. 167 Multiple Light Control on Single Switch .. 170 Failback Irrigation Controller .. 176 Doppler Radar Motion Sensor .. 187 InfraRed Motion Direction Sensor .. 199 Motion Direction Version 2 .. 208 Mouse Trap Notification .. 212 Mouse Hotel Version 215 Notification Frame .. 217 Page 7 CID Robocall Blocker .. 225 Tuya Reflash with Tasmota or Other Favorite Firmware .. 232 WS-1 Smart 233 Luntak US101/US/102/US103/X6 WiFi Plug .. 235 EVA LOGIK Smartplug .. 237 WS212 WiFi Dual Plug with Energy Monitoring .. 239 NX-SP201 Slitinto Dual Energy Monitoring Plug .. 243 BN-LINK BNC-60/U133TJ Energy Monitor Plug (BL0937).

8 245 Wheswell USB Power / Mains Power Wifi Power Strip with Surge Protection .. 251 Closet Door Light Control and Monitor .. 255 Fake TV .. 261 Bluetooth Low Energy Scanner .. 264 ESP32 Beacon Tracking .. 264 Beacon Location Algorithm .. 264 BLE Scanning & Reporting .. 265 Signal Processing Filters .. 266 Beacon Management .. 267 BLE on Raspberry Pi .. 277 Prototype .. 282 RFID .. 296 CheaperRFID .. 296 Cheapest RFID .. 298 LED Matrix Sign .. 309 LED Sign Construction .. 309 LED Sign Usage .. 313 Led Sign API Details .. 318 Led Sign Configuration .. 320 Page 8 Page 9 List of Figures Figure 1 Wildcard Topic Setup .. 23 Figure 2 Color Bulb Parameter Mapping .. 26 Figure 3 HS Device Setup for Color Control .. 26 Figure 4 HS Color Picker Control .. 27 Figure 5 Association of multiple Topics to same HS Device .. 30 Figure 6 Multiple Broker Setup.

9 32 Figure 7 Broker Identification for Received Topics .. 32 Figure 8 Multiple Brokers Online Statistic .. 32 Figure 9 Broker Selection for Non- Plug-in Devices .. 33 Figure 10 HS Log of mqtt -based changes .. 33 Figure 11 CSV type Payload Selection .. 34 Figure 12 CSV Type HS Device Creation .. 34 Figure 13 Non- Plug-in Device Association .. 38 Figure 14 Non- Plug-in Device Manual Setup .. 39 Figure 15 Messaging Sign Properties .. 39 Figure 16 Plug-in Device Subscription Association .. 40 Figure 17 Plug-in Device Publish Setup .. 41 Figure 18 Example of Controlling a mcsMQTT Device .. 42 Figure 19 mqtt Event Action .. 45 Figure 20 Substitution Variables in Event Action .. 46 Figure 21 Send mqtt Publication List Event Action .. 46 Figure 22 mqtt Broker Connection Event Trigger .. 48 Figure 23 Publication List to Setup a Lora Frequency .. 49 Figure 24 Control/Status UI setup in Device Management to Support Sign Type.

10 50 Figure 25 General Tab Setup Options .. 55 Figure 26 Base, Rate, and Accumulation Device Associations .. 59 Figure 27 Edit of Status for Numeric Devices .. 60 Figure 28 mcsMQTT Devices Mapping to Specific mqtt Topics .. 64 Figure 29 mqtt Receive Event Triggers .. 65 Figure 30 Topic Filter Setup .. 68 Figure 31 History Filter Selection .. 69 Figure 32 History Display .. 70 Figure 33 Chart Setup .. 72 Figure 34 Chart Display .. 73 Figure 35 Espressif Flash Download Tool .. 89 Figure 36 ESP32 Startup Log .. 90 Figure 37 BLE Setup Tab Viewing Options .. 92 Figure 38 BLE Configuration Parameters Table .. 94 Figure 39 Beacon Location Table .. 96 Figure 40 Scanners Locations Table .. 98 Figure 41 Beacon Current Locations Graphic .. 99 Page 10 Figure 42 Beacon Distance from Scanner 101 Figure 43 Beacon 24 Hours History Graphic .. 103 Figure 44 mqtt Statistics .. 107 Figure 45 mqtt Statistics in HS Devices.