1.2.3 • Published 5 years ago

@nullent1ty/eq3ble v1.2.3

Weekly downloads
1
License
GPLv3
Repository
-
Last release
5 years ago

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

Maintainers

1.2.3

5 years ago

1.2.2

5 years ago

1.2.1

5 years ago

1.2.0

5 years ago