0.1.0 • Published 1 year ago

homebridge-duka-smartfan v0.1.0

Weekly downloads
-
License
Apache-2.0
Repository
github
Last release
1 year ago

Homebridge DUKA SmartFan Wifi

This is a Homebridge plugin which allows you to control your DUKA SmartFan Wifi devices from HomeKit. This plugin is heavily based on (PaulMT's Blueberg Vento plugin). Full documentation for a similar SmartFan can be found on (this page]. So far, only the most common features are supported.

Installation

  1. This is Homebridge plugin, so make sure you have Homebridge Server up & running (Homebridge site).
  2. Assign static IP address to your device (see your router settings).
  3. Install homebridge-duka-smartfan plugin using Homebridge UI or use this command: sudo npm install -g homebridge-duka-smartfan.
  4. Configure plugin using Homebridge UI or ~/.homebridge/config.json.
    {
      "platform": "DukaSmartFan",
      "devices": [
        {
          "name": "Bedroom Fan",
          "ip": "192.168.1.1",
          "deviceId": "0123456789ABCDEF",
          "password": "1111"
        }
      ]
    }
    Config properties:
    • Device Name (name): Accessory name in iOS Home app.
    • IP Address (ip): Your device static IP address.
    • Device ID (deviceId): Your device ID (you can find it in DUKA SmartFan mobile app).
    • Password (password): Your device password (default 1111, can be changed in mobile app).

Features:

  • Turning Fan on and off
  • Boost function
  • Control Fanspeed

Supported Models:

  • DUKA SmartFan WiFi - Firmware 2.2

Release notes:

0.1.0

  • Limit fanspeed (30%)
  • Better structure

0.0.6

  • Removed External Switch for now
  • Added Fanspeed control

0.0.5

  • Added External Switch as Motion Sensor

0.0.4

  • Added Boost-function

0.0.3

  • First fork which allows you to add multiple devices and turn the on/off.

Parameter-reference

Parameter NumberModeDescriptionPossible ValuesSize (bytes)
1/0x0001R/W/RWFan On/Off0-Off, 1-On, 2-Invert1
2/0x0002RBattery status0 - discharged (absent), 1-normal rate of charge1
3/0x0003R/W/RW24 hours mode selection0-Off, 1-On, 2-Invert1
4/0x0004RCurrent fan speed (rpm)0...6000 RPM2
5/0x0005R/W/RWBOOST mode On/Off0-Off, 1-On, 2-Invert1
6/0x0006RCurrent BOOST timer countdown in seconds0...86400 seconds3
7/0x0007RCurrent status of the built-in timer0-Off, 1-On1
8/0x0008RCurrent status of fan operation by humidity sensor0-Off, 1-On1
10/0x000ARCurrent status of fan operation by temperature sensor0-Off, 1-On1
11/0x000BRCurrent status of fan operation by motion sensor0-Off, 1-On1
12/0x000CRCurrent status of fan operation by signal from an external switch0-Off, 1-On1
13/0x000DRCurrent status of fan operation in interval ventilation mode0-Off, 1-On1
14/0x000ERCurrent status of fan operation in SILENT mode0-Off, 1-On1
15/0x000FR/W/RWPermission of operation based on humidity sensor readings0-Off, 1-in automatic mode, 2-in manual mode1
17/0x0011R/W/RWPermission of operation based on temperature sensor readings0-Off, 1-On, 2-Invert1
18/0x0012R/W/RWPermission of operation based on motion sensor readings0-Off, 1-On, 2-Invert1
19/0x0013R/W/RWPermission of operation based on signal from an external switch0-Off, 1-On, 2-Invert1
24/0x0018R/W/RW/INC/DECMax speed setpoint30...100 %1
26/0x001AR/W/RW/INC/DECSilent speed setpoint30...100 %1
27/0x001BR/W/RW/INC/DECInterval ventilation speed setpoint30...100 %1
29/0x001DR/W/RWInterval ventilation mode activation0-Off, 1-On, 2-Invert1
30/0x001ER/W/RWSilent mode activation0-Off, 1-On, 2-Invert1
31/0x001FR/W/RWSilent Mode start time in seconds0...86400 seconds3
32/0x0020R/W/RWSilent Mode end time in seconds0...86400 seconds3
33/0x0021R/W/RWCurrent time of the fan internal clock in seconds0...86400 seconds3
35/0x0023R/W/RW/INC/DECTurn-off delay timer/BOOST setpoint0-Off, 2-5 minutes, 3-15 minutes, 4-30 minutes, 6-60 minutes1
36/0x0024R/W/RW/INC/DECTurn-on delay timer setpoint0-Off, 1-2 minutes, 2-5 minutes1
37/0x0025WResetting parameters to factory settingsAny byte1
124/0x007CRDevice search on the local Ethernet networkText ("0...9", "A...F")16
134/0x0086RController base firmware version and dateByte 1-firmware version (major), Byte 2-firmware version (minor), Byte 3-day, Byte 4-month, Byte 5 and Byte 6-year6
148/0x0094R/W/RWWi-Fi operation mode1-client, 2-access point1
149/0x0095R/W/RWWi-Fi name in Client modeText 1 ... 321
150/0x0096R/W/RWWi-Fi passwordText 8 ... 641
153/0x0099R/W/RWWi-Fi data encryption type48-OPEN, 50-WPA_PSK, 51-WPA2_PSK, 52-WPA_WPA2_PSK1
154/0x009AR/W/RWWi-Fi frequency channel1...131
155/0x009BR/W/RWWi-Fi module DHCP0-STATIC, 1-DHCP, 2-Invert1
156/0x009CR/W/RWIP address assigned to Wi-Fi moduleByte 1-0...255, Byte 2-0...255, Byte 3-0...255, Byte 4-0...2554
157/0x009DR/W/RWWi-Fi module subnet maskByte 1-0...255, Byte 2-0...255, Byte 3-0...255, Byte 4-0...2554
158/0x009ER/W/RWWi-Fi module main gatewayByte 1 - 0...255, Byte 2 - 0...255, Byte 3 - 0...255, Byte 4 - 0...2554
160/0x00A0WApply new Wi-Fi parameters and quit Wi-Fi module Setup ModeAny byte1
163/0x00A3RCurrent Wi-Fi module IP address0...2554
185/0x00B9RUnit type21

For more details, visit Blauberg Ventilatoren.

0.1.0

1 year ago

0.0.5

1 year ago

0.0.4

1 year ago

0.0.6

1 year ago

0.0.3

1 year ago

0.0.2

1 year ago

0.0.1

1 year ago