fritzdect-aha-nodejs

NodeJS library using the AHA api of Fritzbox to control DECT smarthome devices.
This library is not, in any way, affiliated or related to AVM GmbH or Fritz GmbH. Use it at your own risk.

!Test and Release

Features

- javascript methods to use DECT-devices connected to fritzbox
- control switches, thermostats, blinds, lamps
- control grouped devices
- control configured templates
- uses new session ID method (FW >7.25), as well as the fallback to md5 method
- no production dependencies for the API itself (the dependencies are only related to the testscript and emulation)

Getting Started

it is an common js module with named exports.
it exposes 2 classes, the API (Fritz) and an emulation (FritzEmu)

$3

- nodejs >20 (may work with older version, but tested with > 14)
- fritzbox FW >6.69

$3

install the released version on npm with

``javascript
npm install fritzdect-aha-nodejs
`

$3

`javascript
const Fritz = require('fritzdect-aha-nodejs').Fritz;
fritz = new Fritz(yourUsername, yourPassword, your.Url || '', your.options || {});

//your async function
...
const login = await fritz.login_SID();
const devicelistinfos = await fritz.getDeviceListInfos();
const logout = await fritz.logout_SID();
...
``

see the example.js.

API Calls

$3

| API-call | implements FB call |
| :----------------------- | :------------------- |
| getDeviceListInfos() | getdevicelistinfos |
| getTemplateListInfos() | gettemplatelistinfos |
| getTriggerListInfos() | gettriggerlistinfos |
| getColorDefaults() | getcolordefaults |
| getDeviceInfos(ain) | getdeviceinfos |
| getBasicDeviceStats(ain) | getbasicdevicestats |
| getSwitchList() | getswitchlist |
| getSwitchState(ain) | getswitchstate |
| getSwitchPresent(ain) | getswitchpresent |
| getSwitchPower(ain) | getswitchpower |
| getSwitchEnergy(ain) | getswitchenergy |
| getSwitchName(ain) | getswitchname |
| getTemperature(ain) | gettemperature |
| getHkrTsoll(ain) | gethkrtsoll |
| getHkrKomfort(ain) | gethkrkomfort |
| getHkrAbsenk(ain) | gethkrabsenk |
| getUserPermissions() | not a FB call |

$3

| API-call | implements FB call |
| :------------------------------------- | :--------------------- |
| applyTemplate(ain) | applytemplate |
| setSwitchOn(ain) | setswitchon |
| setSwitchOff(ain) | setswitchoff |
| setSwitchToggle(ain) | setswitchtoggle |
| setSimpleOn(ain) | setsimpleonoff&onoff=1 |
| setSimpleOff(ain) | setsimpleonoff&onoff=0 |
| setSimpleToggle(ain) | setsimpletoggle |
| setTempTarget(ain, temp) | sethkrtsoll |
| setHkrBoost(ain, time) | sethkrboost |
| setWindowOpen(ain, time) | sethkrwindowopen |
| setBlind(ain, target) | setblind |
| setLevel(ain, level) | setlevel |
| setColorTemperature(ain, temp) | setcolortemperature |
| setColor(ain, saturation, hue) | setcolor |
| setUnmappedColor(ain, saturation, hue) | setunmappedcolor |
| setTriggerActive(ain, active) | settriggeractive |

Changelog

$3

- (foxthefox) eslint >9.0

$3

- (foxthefox) new functions setSimpleToggle, setLevelPercentage, setUnmappedColor, setTriggerActive
- (foxthefox) remove spaces in ain if part of the function call
- (foxthefox) extended testing
- (foxthefox) debug-flag as new parameter during instantiation

$3

- (foxthefox) forgotten "this." at apiresponse

$3

- (foxthefox) recfactoring of emulation (breaking change), variable testdata can be injected

$3

- (foxthefox) use of User-Agent
- (foxthefox) implementation of new commands from API version 1.57

$3

- (foxthefox) skipping usage of chalk, figlet

$3

- (foxthefox) common js module with 2 named exports Fritz and FritzEmu

$3

- (foxthefox) first release on npm as ESM

License

Copyright (c) 2022-2023 foxthefox

see [LICENSE.md]

Acknowledgments

- based on ideas of https://github.com/andig/fritzapi

Related Projects

- ioBroker.fritzdect