Skip to content

tmlong/webCoRE-Presence

Repository files navigation

webCoRE Presence

https://github.com/tmlong/webCoRE

Overview

This app is an attempt to breathe new life into the webCoRE presence sensor to continue providing more consistent geofencing updates. This works with the webCoRE SmartApp for creating powerful location-based automation.

  

Installation

Device Handler

Requires the webCoRE SmartApp to be installed.

  1. Within the SmartThings IDE, click on 'My Device Handlers'.
  2. Follow the steps below depending on how you install webCoRE.

Github Integration

  1. Click the 'Update from Repo' button.
  2. Click the 'webCoRE (master)' option from the drop-down list.
  3. Select the 'webCoRE Presence Sensor' device type from the list.
  4. Select 'Publish', then click 'Execute Update'.
  5. Ensure the 'webCoRE Presence Sensor' is listed and marked with a 'Published' status.

Source Code

  1. Click the '+ Create New Device Handler' button.
  2. Select the 'From Code' tab and paste in the source code from here.
  3. Click 'Create'.
  4. Click 'Publish', then click 'For Me'.
  5. Ensure the 'webCoRE Presence Sensor' is listed and marked with a 'Published' status.

Android App

Requires access to the device's location.

  1. Install the webCoRE Presence app from the Google Play Store.

Configuration

Presence Sensor

Adding a presence sensor will appear as a new device in your SmartThings app.

  1. Open the webCoRE Presence app and login to your dashboard.
  2. Click the Add Presence Sensor icon to add a presence sensor.
    • As an alternative, the presence sensor can be setup under the 'Settings' > 'Places' > 'Setup sensor' option from within the dashboard. Either option will work just fine and have the same end result.
    • Note: Once the presence sensor is configured, the 'Setup sensor' option from within the dashboard will no longer be available until the app is reinstalled.
  3. Location updates will be started immediately.

Options

Location updates are polled with a minimum interval of 120s and distance of 100m.

App

  • Add Presence Sensor Add a presence sensor.
    • This option will overwrite the existing presence sensor, if one already exists.
  • Location Updates Started Location updates started.
    • Clicking this icon will stop location updates.
    • This option will appear once a presence sensor is configured.
  • Location Updates Stopped Location updates stopped.
    • Clicking this icon will start location updates.
    • This option will appear once a presence sensor is configured.
  • Refresh Location Refresh location.
    • Clicking this icon will immediately update the location.
    • This option will appear once a presence sensor is configured.

Notification

  • Location Updates Started (Away) Location updates started (Away).
  • Location Updates Started (Home) Location updates started (Home).
  • Location Updates Stopped Location updates stopped.

Links

License

Copyright 2019 Todd Long

Licensed under the Apache License, Version 2.0 (the "License");
you may not use this file except in compliance with the License.
You may obtain a copy of the License at

   http://www.apache.org/licenses/LICENSE-2.0

Unless required by applicable law or agreed to in writing, software
distributed under the License is distributed on an "AS IS" BASIS,
WITHOUT WARRANTIES OR CONDITIONS OF ANY KIND, either express or implied.
See the License for the specific language governing permissions and
limitations under the License.