Skip to content

Latest commit

 

History

History

st-multipurpose-sensor

Folders and files

NameName
Last commit message
Last commit date

parent directory

..
profiles
profiles
 
 
src
src
 
 
README.md
README.md
 
 
config.yml
config.yml
 
 
fingerprints.yml
fingerprints.yml
 
 

README.md

Sample Edge Driver for SmartThings Multipurpose Sensor

Model: IM6001-MPP04

Protocol: Zigbee

Prerequisites

  1. Set up the SmartThings CLI according to the configuration document.
  2. Add the Edge Driver plugin to the CLI.
  3. Configure your development environment for the SmartThingsEdgeDrivers
  4. A SmartThings hub with firmware version 000.038.000XX or greater and a SmartThings Multipurpose sensor (Zigbee).

Uploading Your Driver to SmartThings

Note: Review the installation tutorial in our Developer's Community.

  1. Compile the driver:
       smartthings edge:drivers:package driver/
  1. Next, create a channel for your driver
smartthings edge:channels:create
  1. Enroll your driver into the channel
smartthings edge:channels:enroll
  1. Publish your driver to the channel
smartthings edge:drivers:publish
  1. If the package was successfully created, you can call the command below and follow the on-screen prompts to install the Driver in your Hub:
       smartthings edge:drivers:install

You should see the confirmation message: "Driver {driver-id} installed to Hub {hub-id}"

  1. Use your WiFi router or the SmartThings IDE > My Hubs to locate and copy the IP Address for your Hub.

  2. From a computer on the same local network as your Hub, open a new terminal window and run the command to get the logs from all the installed drivers.

       smartthings edge:drivers:logcat --hub-address=x.x.x.x -a

Onboarding your New Device

  1. Open the SmartThings App and go to the location where the hub is installed.

  2. Go to Add (+) > Device or select Scan Nearby (If you have more than one, select the corresponding Hub as well)

  3. Put your device in pairing mode; the specifications will vary by manufacturer (for the SmartThings Multipurpose sensor, press the device’s reset button once).

  4. Keep the terminal view open until you see only reporting values messages in the logs.

Example Output

<ZigbeeDevice: device-id [source-id] (Multipurpose Sensor f1)> emitting event: {"attribute_id":"temperature","component_id":"main","state":{"unit":"C","value":28.66},"capability_id":"temperatureMeasurement"}

If your Device paired correctly and the Driver was applied, you should not see any errors in the logs (including "UNSUPPORTED" responses to any Zigbee TX message). You can validate this by opening the SmartThings app and controlling and/or viewing all of the devices Capabilities (e.g., open/close or change the temperature).