Giter Club home page Giter Club logo

hass-tryfi's Introduction

TryFi for Home Assistant

beta_badge release_date hacs_badge

This allows you to integrate TryFi Smart GPS Collars with Home Assistant.

Features

Current functionality includes:

  • Device Tracker - your pet will show up in HA using the GPS coordinates from the collar
  • Step Counter - it will report your pets daily, weekly, and monthly steps
  • Distance Counter - it will report your pets daily, weekly and monthly distance
  • Battery Level - it will report your Pet's collar battery level
  • Collar Light - you can control the light on the collar by turning it on and off (color selection coming soon!)
  • Lost Dog Mode - allows you to "unlock" your dog if it is lost and "lock" it when it is found
  • Bases - reports the status of the base (online/offline)

Donate

If you would like to donate you can use my TryFi referral code "395FX4" on your next purchase.

Installation

Pre-Requisities

  • Home Assistant >= 0.0.117
  • TryFi dog collar with active cellular subscription
  • HACS is already installed

Installation Methods

HACS Install

  1. Search for TryFi under Integrations in the HACS Store tab.
  2. Add the Integration to your HA and configure.

Manual Install

  1. In your /config directory, create a custom_components folder if one does not exist.
  2. Copy the tryfi folder and all of it's contents to your custom_components directory.
  3. Restart Home Assistant.
  4. Add the Integration to your HA and configure.

Configuration

  1. After installing TryFi go to Configuration --> Integrations and add a new Integration
  2. Search for TryFi
  3. Enter in your TryFi username and password. Optionally you can select a polling frequency option (in seconds). Suggestion is nothing less then 5.
  4. Click Submit

Setup

Validation

Once you have added the integration, you will see 1 or more devices and entities associated with this integration. To validate its accuracy, you can review the steps and distance counters for your pet or its current whereabouts.

Integration

Dog Device and Entities

Device

Dog Device

Entities

Dog Entities

Base Device and Entities

Base Device and Entities

How to Use

Light Collar

The light on your Pet's collar is represented as a light switch in HA. It can either be turned on or off.

Lovelace

Lost Dog Mode

TryFi is equiped with a "Lost Dog Mode" functionality. In HA this is represented by a "lock" device similar to a lock in your home. If the pet is "locked" then everything is safe and secure. If the pet is unlocked then it must be lost :(

Lovelace

Lovelace

Entities

type: entities
entities:
  - entity: lock.harley_lost_state
  - entity: sensor.harley_collar_battery_level
  - entity: sensor.home_base
  - entity: sensor.harley_daily_steps
  - entity: sensor.harley_weekly_steps
  - entity: sensor.harley_monthly_steps
  - entity: sensor.harley_daily_distance
  - entity: sensor.harley_weekly_distance
  - entity: sensor.harley_monthly_distance

Light

type: light
entity: light.harley_collar_light

Automation Examples

Turn on the Collar Light After Dark

Turns on the collar light after dark if the pet is not home.

- id: '1604060166498'
  alias: Turn on Light After Dark If Not Home
  description: ''
  trigger:
  - platform: sun
    event: sunset
  condition:
  - condition: and
    conditions:
    - condition: device
      device_id: a7237a6c1144fcd90828b21de2572603
      domain: device_tracker
      entity_id: device_tracker.pet_tracker
      type: is_not_home
  action:
  - type: turn_on
    device_id: a7237a6c1144fcd90828b21de2572603
    entity_id: light.pet_collar_light
    domain: light
  mode: single

Known Issues

  • It sometimes takes time for the status to accurately refresh in HA. For example the light on/off status and the lock/unlock status.

Future Enhacements

  • Allow for the selection of the LED light color
  • Enable possibility of if pet not home and not with owner then trigger lost dog mode

Version History

0.0.9

  • Updated dependency version of pytryfi
  • Fixed Issue #30 - Convert to Async

0.0.8

  • Updating dependency version of pytryfi

0.0.7

  • Updating dependency version of pytryfi

0.0.6

  • Steps unit was added to enable charting of dogs steps over time.

0.0.5

0.0.4

0.0.3

  • Multiple bases fix

0.0.2

  • Documentation updates

0.0.1

  • Initial Release with basic functionality including light on/off, device tracker, lock mode of dog and general stats

Links

hass-tryfi's People

Contributors

ktibow avatar ppicazo avatar sbabcock23 avatar

Recommend Projects

  • React photo React

    A declarative, efficient, and flexible JavaScript library for building user interfaces.

  • Vue.js photo Vue.js

    ๐Ÿ–– Vue.js is a progressive, incrementally-adoptable JavaScript framework for building UI on the web.

  • Typescript photo Typescript

    TypeScript is a superset of JavaScript that compiles to clean JavaScript output.

  • TensorFlow photo TensorFlow

    An Open Source Machine Learning Framework for Everyone

  • Django photo Django

    The Web framework for perfectionists with deadlines.

  • D3 photo D3

    Bring data to life with SVG, Canvas and HTML. ๐Ÿ“Š๐Ÿ“ˆ๐ŸŽ‰

Recommend Topics

  • javascript

    JavaScript (JS) is a lightweight interpreted programming language with first-class functions.

  • web

    Some thing interesting about web. New door for the world.

  • server

    A server is a program made to process requests and deliver data to clients.

  • Machine learning

    Machine learning is a way of modeling and interpreting data that allows a piece of software to respond intelligently.

  • Game

    Some thing interesting about game, make everyone happy.

Recommend Org

  • Facebook photo Facebook

    We are working to build community through open source technology. NB: members must have two-factor auth.

  • Microsoft photo Microsoft

    Open source projects and samples from Microsoft.

  • Google photo Google

    Google โค๏ธ Open Source for everyone.

  • D3 photo D3

    Data-Driven Documents codes.