@nullent1ty/eq3ble v1.2.3
EQ3BLE
node.js package to control an EQ3 bluetooth thermostat
disclaimer
This is a fork of https://github.com/maxnowack/node-eq3ble. The original project uses a dependency which is not working with Node v10. Unfortunately the author does not maintain this package anymore, so I forked and fixed it.
install
You can find this project on npmjs: https://www.npmjs.com/package/@nullent1ty/eq3ble
npm install @nullent1ty/eq3ble
discovering
See the noble-device discovering api for more methods
import EQ3BLE from 'eq3ble'
EQ3BLE.discover((device) => {
device.connectAndSetup().then(() => {
// ...
})
})
methods
every method returns a promise to indicate the execution progress
getInfo()
reads the device info. Returns an object like this:
{
status: {
manual: Boolean, // manual mode activated
holiday: Boolean, // holiday mode activated
boost: Boolean, // boost active
dst: Boolean, // daylight saving time active
openWindow: Boolean, // window is opened
lowBattery: Boolean, // battery is low
},
valvePosition: Number, // 0-100 position of the valve
targetTemperature: Number // temperature visible on the display
}
setBoost(Boolean)
activates or deactivates the boost
automaticMode()
switch to automatic mode
manualMode()
switch to manual mode
ecoMode()
switch to eco / holiday mode
setLock(Boolean)
activates or deactivates locking
turnOff()
turns off heating / sets valve position to 0
turnOn()
turns on heating / sets valve position to 100
setTemperature(Number)
sets the temperature (valid values are 4.5 - 30)
setTemperatureOffset(Number)
sets the temperature offset
updateOpenWindowConfiguration(temperature: Number, duration: Number)
updates the window open configuration
setDateTime(Date)
updates the date and time of the thermostat
License
Licensed under GPLv3 license. Copyright (c) 2015 Max Nowack
Contributions
Contributions are welcome. Please open issues and/or file Pull Requests.
Original authors
- Max Nowack (maxnowack)
Maintainers
- Dominique Mattern (NullEnt1ty)