homebridge-wattwatchersamber v0.0.6
Amber Homebridge Plugin
This is a plugin for Homebridge. It exposes Amber pricing information to HomeKit.
This plugin has been developed by Wattwatchers as a Proof of Concept.
Plugin installation
- In Homebridge, select the Plugins tab.
- Search for Amber.
- Click 'Install' on the Wattwatchers_Amber plugin card.
Plugin configuration
- In Homebridge, select the Plugins tab.
- Select Settings on the Homebridge Wattwatchers_Amber plugin.
- In the configuration form:
- Enter your Amber API key
- Select whether or not you want to expose pricing information as a custom made accessory (see next section for details)
Once configured, the plugin will automatically expose pricing information for both electricity imports and exports to HomeKit.
HomeKit native accessory vs. custom accessory
This plugin can expose pricing information to HomeKit in 2 ways:
- Through an accessory natively supported by HomeKit and the Home app for iOS. The Home app only supports and displays a specific set of accessories. None of these support pricing information. When opting to expose pricing information as a native accessory, the pricing information will therefore be mapped to an Air Quality Sensor.
- Through a custom accessory. When opting to expose pricing information as a custom accessory, it won't be visible in the Home app, it will hoever be visible and usable in the Eve app.
HomeKit native accessory
The HomeKit native accessory exposes:
The price in cents/kWh This is mapped to nitrogen density (negative price values are set to 0)
The general pricing level This is mapped to air quality. For imports the mapping is as follows:
Amber price level | Air quality |
---|---|
Extremely low | Excellent |
Very low | Good |
Low | Good |
Neutral | Fair |
High | Inferior |
Spike | Poor |
For exports the mapping is as follows:
Amber price level | Air quality |
---|---|
Extremely low | Poor |
Very low | Inferior |
Low | Inferior |
Neutral | Fair |
High | Good |
Spike | Excellent |
Custom accessory
The custom accessory exposes:
- The price in cents/kWh (including negative pricing)
- The spike status (Yes when prices are currently spiking, No if not)
- The general pricing level, mapped as follows:
Amber price level | Price level |
---|---|
Extremely low | 1 |
Very low | 2 |
Low | 2 |
Neutral | 3 |
High | 4 |
Spike | 5 |
Creating automations
The configured switches and sensor will be available within the HomeKit app (when not using a custom accessory) or the Eve app.
Here they can be used to build automations (e.g. turn turn off a device when the cost of imports exceeds a certain level.)
For instructions on how to create automations, visit Apple