TapHome Examples

Youtube playlist

Maybe not all of my projects end up being documented here, but you can always see my TapHome related videos here: https://www.youtube.com/playlist?list=PLk9erb9HGsPhJlSvm_UjzvUL-I5gnqaYE

Integrating SmartThings Switch or Plug with Power Metering

This process assumes you have a SmartThings account and device(s) are registered in the SmartThings network. To create this integration I used a BlitzWolf BW-SHP15 zigbee plug with power metering, but any Zigbee/Matter/Z-Wave from other manufacturer should work.

First, create a new template device in the Packet Parser Integration. Go to Settings / Hardware, here either create a new Packet Parser interface or if it already exsists, select it. Click Add From Template, select SmartThings Samsung and select SmartThings Switch-Plug with Power Metering.

First, we need to create a new Bearer Token for the communication. Go to https://account.smartthings.com/tokens and create a new personal access token (Click on Generate New Token). Give it a name, select Devices and click on Generate Token. Write down the token number, we will need it later. And don't share this token with anyone.

Now go to https://my.smartthings.com/ find the device you want to integrate, and copy the Device ID from here:

Now, go back to TapHome app, select the new Module that you added from the template and update the Token and the Device ID here:

Also on the top right conrner, click on the 3 dots and rename the Module to more meaningful name, as you would import this template for each smart device:

Back on the module, scroll down to the 2 devices: Click on each of them, Click Service Settings on the next page and edit the Name, Zone Category, Device Type to match you setup.

This is all, now your device should work. If you have another smart device in the SmartThings networks you want to integrate, start the process again and import the same template again. The Token would be the same, but the Device ID would obviously different.

Zigbee2MQTT Integration

In order to access Zigbee devices locally, I created a Zigbee2MQTT server that handles the Zigbee traffic and also runs a MQTT Broker to serve this information to TapHome. TapHome connects to this server using the packet parser communication.

I have an entire video on this setup:

Setting up the integration

• Before you create the setup in TapHome, start adding your Zigbee devices to the Zigbee2MQTT network and also rename them. You can verify if it is all working in MQTT Explorer. You can check my video below for details.
• In the TapHome application select Settings/Hardware and click on Add new interface. Select Packet Parser. If you prefer you can rename this to Zigbee2MQTT by clickin on the 3 dots (top right) and select Rename.
• Next click on Add Module. My examples should be added to the built in Library under Zigbee2MQTT, but if not, you find the files here.
• Once added, click on the new module just got added and make the following changes:
  • Click on the three dots and Rename and rename the module to a more meaningful name, like "Kitchen motion sensor".
  • Update the MQTT Broker IP Address and the Root topic.
  • Click on the Service Settings button, update Name, Zone, Category and also User and Password which is the user and password for the MQTT Broker.
  • Rename the devices as well accordingly.

This should complete the integration and the new device is available in TapHome. Repeat the steps for each Zigbee device you have.