npm package discovery and stats viewer.

Discover Tips

  • General search

    [free text search, go nuts!]

  • Package details

    pkg:[package-name]

  • User packages

    @[username]

Sponsor

Optimize Toolset

I’ve always been into building performant and accessible sites, but lately I’ve been taking it extremely seriously. So much so that I’ve been building a tool to help me optimize and monitor the sites that I build to make sure that I’m making an attempt to offer the best experience to those who visit them. If you’re into performant, accessible and SEO friendly sites, you might like it too! You can check it out at Optimize Toolset.

About

Hi, 👋, I’m Ryan Hefner  and I built this site for me, and you! The goal of this site was to provide an easy way for me to check the stats on my npm packages, both for prioritizing issues and updates, and to give me a little kick in the pants to keep up on stuff.

As I was building it, I realized that I was actually using the tool to build the tool, and figured I might as well put this out there and hopefully others will find it to be a fast and useful way to search and browse npm packages as I have.

If you’re interested in other things I’m working on, follow me on Twitter or check out the open source projects I’ve been publishing on GitHub.

I am also working on a Twitter bot for this site to tweet the most popular, newest, random packages from npm. Please follow that account now and it will start sending out packages soon–ish.

Open Software & Tools

This site wouldn’t be possible without the immense generosity and tireless efforts from the people who make contributions to the world and share their work via open source initiatives. Thank you 🙏

© 2024 – Pkg Stats / Ryan Hefner

homebridge-ambiclimate

v2.2.1

Published

Ambi Climate plugin for Homebridge

Downloads

23

Readme

homebridge-ambiclimate

NPM Version Dependency Status

Ambi Climate plugin for homebridge. This plugin presently supports:

  • Current Temperature (implementation of Temperature Sensor Service)
  • Current Relative Humidity (Implementation of Humidity Sensor Service)
  • Current Fan state (Implementation of Fan Service)
  • Turn On/Off (Implementation of Switch) - where "off" and "on" modes are configurable

as such each physical device appears within HomeKit Apps as four logical devices with the same name.

A separate plugin for Ambi Climate is available - homebridge-ambiclimate-thermostat exposes Ambi Climate devices as a Thermostat services within Homekit.

Installation

npm install -g homebridge-ambiclimate

This plugin augments a pre-existing implementation of homebridge. Refer to nfarina/homebridge for installation instructions.

Register a OAuth Client in the Ambi Dev Portal for each Ambi Climate device by following the steps on the Quick Start page. You require the Client Id and Client Secret of that client in order to use this wrapper.

Update your homebridge configuration file (as below).

Configuration

"accessories" : [
    {
        "accessory": "AmbiClimate",
        "name": "<Name for Accessory>",
        "roomName": "<Name of Ambi Climate Device>",
        "locationName": "<Name of Ambi Climate Location>",
        "clientId": "<Ambi Climate OAuth Client Id>",
        "clientSecret": "<Ambi Climate OAuth Client Secret>",
        "username": "<Ambi Climate Username>",
        "password": "<Ambi Climate Password>",
        "onMode": "Comfort",
        "offMode": "Away_Temperature_Upper",
        "offValue": 25
    }
]

Separate homebridge accessories can be defined for each Ambi Climate device to be controlled.

  • accessory: Must be "AmbiClimate"
  • name: Can be anything, this will be the name of the Accessory within HomeKit Apps
  • room_name: Must match the value within the Ambi Climate App
  • location_name: Must match the value within the Ambi Climate App
  • clientId: The Client Id value for the OAUTH Client obtained from Ambi Dev Portal
  • clientSecret: The Client Secret value for the OAUTH Client obtained from Ambi Dev Portal
  • username: Your Ambi Climate username
  • password: Your Ambi Climate password
  • onMode: (Optional) The mode to put Ambi Climate into when turning it on - defaults to Comfort
  • onValue: (Optional) Value associated with the on mode
  • offMode: (Optional) The mode to put Ambi Climate into when turning it offMode - defaults to Off
  • offValue: (Optional) Value associated with the off mode

The following values are supported for onMode and offMode:

  • Comfort
  • Off
  • Away_Temperature_Upper
  • Away_Temperature_Lower
  • Away_Humidity_Upper
  • Temperature

To Do

  • Refactor to a Platform plugin. This is predicated on Ambi Labs exposing a capability in their public API to retrieve all devices installed in a given location.
  • Implement Fan Service set capabilities. This is predicated on Ambi Labs exposing a capability in their public API to set fan state.