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-daikin-airbase

v3.2.5

Published

A Homebridge plugin providing support for the Daikin Airbase.

Downloads

55

Readme

Homebridge Daikin Airbase

A Homebridge plugin providing support for the Daikin Airbase WiFi module (BRP15B61).

It allows to turn on/off the aircon, set it to cool/heat/fan/dry/auto mode (when supported), change the target temperature and the fan speed.

Daikin devices will be auto-discovered on the network and mapped to individual accessories in the Home app. Each device will be represented as an accessory group with:

  • A heater/cooler service allowing to set the aircon to cool/heat or auto mode, as well as the threshold temperatures,
  • A switch allowing to turn on/off fan mode,
  • A fan service allowing to change the aircon's fan speed (low/medium/high) if your device supports changing fan speed,
  • A second switch allowing to turn on/off dry mode if your device supports that mode.

In addition, if your system includes a Daikin Zone Controller, zones will be auto-discovered and mapped to an additional accessory group, with one switch for enabling/disabling each zone.

Requirements

  • Node version 11 or above (verify with node --version).
  • Homebridge version 1.0.0 or above.

Installation

  1. Install homebridge using:
npm install -g homebridge
  1. Install the plugin using:
npm install -g homebridge-daikin-airbase
  1. Update your configuration file. See bellow for a sample.

Note: it is also possible to install this plugin in a local npm package instead using the homebridge option --plugin-path.

Configuration

General settings

To configure homebridge-daikin-airbase, add the DaikinAirbase platform to the platforms section of your homebridge's config.js file:

{
    "bridge": { "...": "..." },

    "description": "...",

    "platforms": [
        {
            "platform": "DaikinAirbase",
            "name": "Daiking Airbase"
        }
    ]
}

With the above configuration, the platform will perform UDP auto-discovery of the Daikin devices on the local network.

The platform can be configured with the following parameters:

| Parameter | Type | Default | Note | | ---------------------------- | ----------------------- | ------- | -------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------- | | hostname | String or Array(String) | null | Optional - The hostname(s) on your local network of the Daikin Airbase modules (e.g. 192.168.1.10). Supports a single hostname as String or multiple hostnames in an Array. | | pollingInterval | Number (minutes) | 5 | Optional - The polling interval for refreshing the platform's accessories state for automations, in minutes. By detault set to 5 minutes, it can be set to 0 to disable polling. Note that the information is refreshed on demand when using the Home app, this configuration is only used for background state updates so that automations can react on them. | | useIndividualZoneControls | Boolean | false | Optional - Defines whether to map each zone switch to an individual accessory when a Daikin Zone Controller is available (true), or to map all zone switches to a single grouped accessory (false, default). | | overrides | Object or null | null | Optional - Allows to override Daikin Airbase property values. If left undefined, property values retrieved from the Airbase will be used. Use at your own risk. See below for supported overrides. | | overrides.fanRateSupported | Boolean | N/A | Optional - Define to override the ability to change the fan speed. | | overrides.fanModeSupported | Boolean | true | Optional - Define to override the ability to control the aircon's fan mode. | | overrides.dryModeSupported | Boolean | N/A | Optional - Define to override the ability to control the aircon's dry mode. |

Notes

Accessory order

While the platform adds the different accessories in a specific order, the actual display order in the Apple Home app cannot be controlled by the plugin. You may find that accessories are not sorted in the order you expected. An easy work around for that situation is to simply rename the accessories inside the Home app to suit your needs.

Accessory caching

Once the platform has discovered an airbase module on the network, either through auto-discovery or static IP mapping, it will create the associated homekit accessories. These accessories will then be cached by homebridge.

As a safeguard, the platform will never unregister accessories if they cannot be contacted anymore. In consequence, if you are removing an airbase module from your network, you will have to clear the accessory cache of the homebridge-daikin-airbase plugin manually to unmap the unused accessories.

Accessories also cache their settings. This means that certain technical properties of your Daikin system will not be reflected on the accessories instantly after they are changed (for instance, Zone Controller names, maximum temperature, number of fan speeds, etc.). Restarting the homebridge server twice will ensure that the accessories use an up to date cache for these values.

Contribute

Please feel free to contribute to this plugin by adding support for new device types, implementing new features or fixing bugs. Pull requests are welcome.