FortrezZ FMI Flow Meter — SmartThings Installation Guide

Installation guide for configuring the FortrezZ FMI Flow Meter Interface with a SmartThings Z-Wave home automation hub — covers device handler setup, SmartApp installation, and pairing the Flow Meter to the network.

Overview

This guide walks through integrating the FortrezZ Flow Meter Interface (FMI) into a SmartThings Z-Wave network using FortrezZ's custom device handler and SmartApp code (published on FortrezZ's GitHub repository), then configuring the resulting dashboard for monitoring water flow.

Step 1 — Access Developer Resources

• Visit FortrezZ's GitHub repository to find the device handler and SmartApp code needed for the hub.
• Open a separate browser window and log into the SmartThings developer/IDE portal (graph.api.smartthings.com) from a PC.

Note: This manual integration method applies to the SmartThings Classic/Groovy IDE. SmartThings may have officially certified these device handlers since publication, which would remove the need for the manual steps below — check the current SmartThings Marketplace first.

Step 2 — Create the Device Handler

1. In the SmartThings IDE, select the My Device Handlers tab and click Create New Device Handler.
2. Select From Code.
3. Open the devicehandler.groovy script from FortrezZ's GitHub repository.
4. Select all the code, copy it from GitHub, and paste it into the SmartThings code editor tab.
5. Click Create to complete, then click Save and Publish, For Me.

A successful publish displays "Device type published successfully" at the top of the IDE.

Step 3 — Create the SmartApp

1. Select the My SmartApps tab and click New SmartApp.
2. Choose which SmartApp to use — the standard Alert App is the primary one documented for the Flow Meter.
3. Open the smartapp.groovy script from GitHub, select all, copy, and paste it into the SmartApp code editor.
4. Click Create, then Save and Publish, For Me.

A successful publish displays "SmartApp published successfully" at the top.

Step 4 — Add the Flow Meter to SmartThings

1. Open the SmartThings mobile app and use the normal "+ Add a Thing" procedure.
2. Press the program button on the FMI. Once SmartThings discovers it, follow the prompts to name the device and assign it a location.
3. In the Marketplace, scroll down to My Apps and find the SmartApp created above.
4. Select the Flow Meter SmartApp and complete the on-screen steps to finish installation.

Dashboard Features

Once installed, the Flow Meter tile displays:

• Yesterday's total usage and today's running total
• Month view and week view, with the prior period always shown in grey for comparison
• Current flow rate, recalculated every minute
• Water temperature at the FMI sensor location
• Flow detected / water off status indicators
• Battery level indicator
• A high-flow alert ("More than 5 GPM flow detected"), updated every minute
• A button to toggle between chart and list views, and a manual refresh button

Support

For device handler or SmartApp code updates, always check FortrezZ's GitHub repository (github.com/fortrezz/smartthings) for the latest version, since SmartThings platform changes over time may require corresponding updates to the community code.