CurbBridge

Bridge between Curb Energy Monitor and SmartThings

This integration adds a new power meter in SmartThings for each sensor on your Curb. They will all update at about 1Hz with only a few seconds latency.

Use of this integration requires an independent server running the bridge software. This is required since the SmartThings API does not provide support for Socket.io. Any computer should work, as long as you can install Node.js and it has access to the internet. The server does not need access to your LAN, so it should even be able to run in a cloud computing environment.

Installation:

SmartThings:

• Publish both the SmartApp and DeviceHandler to your account. Either copy-paste into the IDE or use the GitHub integration.
• Go to the SmartApp settings for the Curb Bridge in the IDE. Verify that OAuth is turned on and the redirect uri is set to http://localhost:8000
• Take note of the Client ID and Client Secret, they will be required later
• Use the mobile app to install the Curb Bridge SmartApp. After install, it won't appear to do anything other than show up on the list of SmartApps.

Bridge Server:

• Install Node.js on the computer you intend to use for the bridge server. I have tested it on an Ubuntu 16.04 x64 desktop and an original Raspberry Pi. It should work for Windows and Mac too. Installers are available here
• Clone or download this repo to the server.
• In the curbbridge folder (containing package.json), run

  npm install .

  in a terminal window.
• Run the server with the command

  node .

• You should see "Server running at http://127.0.0.1:8000/" in the console
• Open a browser and direct it to http://127.0.0.1:8000/
• Enter your ST Client ID in the top box
• Click Connect to SmartThings. A new frame should appear. Select your location and click Authorize. The frame should now indicate "Authorization Success"
• Complete the remaining boxes on the page with your ST Client ID (same as above), Client Secret, Curb username (probably your email address) and Curb password.
• Click Submit. The page should redirect to a blank page with the text "Got It".
• Close the browser and you should see that the node application reporting that it has connected.
• Open your SmartThings app and verify that there are several new power meters added.
• You can stop the server by pressing ctrl+c in the termnial window.
• The server will store the access tokens in a file (CurbBridgeData.json) and will automatically connect on subsequent launches.
• If the tokens expire you will need to re-authenticate in the browser. The expired tokens in the file will be replaced automatically.

Notes:

• The browser used for authentication must be running on the same computer as the server.
• The graphing feature in the SmartThings app is experimental. It relies on an undocumented feature of ST and does not always work. Hopefully ST improves support for htmlTile in the future.