iobroker.sureflap
v3.4.2
Adpater for smart pet devices from Sure Petcare
0/weekUpdated 1 months agoMITUnpacked: 576.6 KB
Published by Sickboy78
npm install iobroker.sureflap
ioBroker.sureflap
!Stable Version
!Number of Installations (latest)
!Test and Release
Adpater for smart pet devices from Sure Petcare®
Configuration
Required:
Add username and password from your Sure Petcare® account on the adapter configuration page.
Optional:
Enable or disable JSON event history and configure number of items.
Optional:
Set battery full and empty thresholds when using rechargeable batteries. This affects the battery
percentage values.
Description
The adapter provides information about the settings and status of your pet flap, cat flap, feeder or water dispenser.
It also shows the location of your pets and their food and water consumption (with feeder and/or water dispenser).
It lets you control the lockmode and curfew of your flap and set the location of your pets.
The adapter requires Node 20 or newer.
$3
The following states can be changed and will take effect on your device respectively will be reflected in your Sure
Petcare® app.
| state | description | allowed values |
|--------------------------------------------------------------------|--------------------------------------------------------------------------------------|-----------------------------------------------------------------------------------------|
| HOUSEHOLD_NAME.HUB_NAME.control.led_mode | sets the brightness of the hub leds | 0 - off
1 - high
4 - dimmed |
| HOUSEHOLD_NAME.HUB_NAME.DEVICE_NAME.control.pets.PET_NAME.assigned | assigns or unassigns the pet to or from the device | true or false |
| HOUSEHOLD_NAME.HUB_NAME.FEEDER_NAME.control.close_delay | sets the close delay of the feeder lid | 0 - fast
4 - normal
20 - slow |
| HOUSEHOLD_NAME.HUB_NAME.FLAP_NAME.control.curfew_enabled | enables or disables the configured curfew | true or false |
| HOUSEHOLD_NAME.HUB_NAME.FLAP_NAME.control.current_curfew | sets the current_curfew,
supports 1 (pet flap) or up to 4 (cat flap) curfew times | [{"enabled":true\|false, "lock_time":"xx:xx", "unlock_time":"xx:xx"}, ...] |
| HOUSEHOLD_NAME.HUB_NAME.FLAP_NAME.control.lockmode | sets the lockmode | 0 - open
1 - lock in
2 - lock out
3 - closed (lock in and out) |
| HOUSEHOLD_NAME.HUB_NAME.FLAP_NAME.control.pets.PET_NAME.type | sets the pet type for the assigned pet and flap | 2 - outdoor pet
3 - indoor pet |
| HOUSEHOLD_NAME.pets.PET_NAME.inside | sets whether your pet is inside | true or false |
$3
The adapter creates the following hierarchical structure:
adapter
├ HOUSEHOLD_NAME
│ ├ HUB_NAME
│ │ ├ online
│ │ ├ serial_number
│ │ ├ signal
│ │ │ ├ device_rssi
│ │ │ └ hub_rssi
│ │ ├ version
│ │ │ ├ firmware
│ │ │ └ hardware
│ │ ├ control
│ │ │ └ led_mode
│ │ ├ FELAQUA_NAME
│ │ │ ├ battery
│ │ │ ├ battery_percentage
│ │ │ ├ online
│ │ │ ├ serial_number
│ │ │ ├ signal
│ │ │ │ ├ device_rssi
│ │ │ │ └ hub_rssi
│ │ │ ├ version
│ │ │ │ ├ firmware
│ │ │ │ └ hardware
│ │ │ ├ water
│ │ │ │ ├ fill_percent
│ │ │ │ ├ last_filled_at
│ │ │ │ └ weight
│ │ │ └ control
│ │ │ └ pets
│ │ │ └ PET_NAME
│ │ │ └ assigned
│ │ ├ FEEDER_NAME
│ │ │ ├ battery
│ │ │ ├ battery_percentage
│ │ │ ├ online
│ │ │ ├ serial_number
│ │ │ ├ signal
│ │ │ │ ├ device_rssi
│ │ │ │ └ hub_rssi
│ │ │ ├ version
│ │ │ │ ├ firmware
│ │ │ │ └ hardware
│ │ │ ├ bowls
│ │ │ │ └ 0..1
│ │ │ │ ├ fill_percent
│ │ │ │ ├ food_type
│ │ │ │ ├ last_filled_at
│ │ │ │ ├ Last_zeroed_at
│ │ │ │ ├ target
│ │ │ │ └ weight
│ │ │ └ control
│ │ │ ├ pets
│ │ │ │ └ PET_NAME
│ │ │ │ └ assigned
│ │ │ └ close_delay
│ │ └ FLAP_NAME
│ │ ├ battery
│ │ ├ battery_percentage
│ │ ├ curfew_active
│ │ ├ last_enabled_curfew
│ │ ├ online
│ │ ├ serial_number
│ │ ├ control
│ │ │ ├ pets
│ │ │ │ └ PET_NAME
│ │ │ │ ├ assigned
│ │ │ │ └ type
│ │ │ ├ curfew_enabled
│ │ │ ├ current_curfew
│ │ │ └ lockmode
│ │ ├ signal
│ │ │ ├ device_rssi
│ │ │ └ hub_rssi
│ │ └ version
│ │ ├ firmware
│ │ └ hardware
│ ├ history
│ │ └ json
│ │ └ 0..24
│ └ pets
│ └ PET_NAME
│ ├ inside
│ ├ name
│ ├ since
│ ├ food
│ │ ├ last_time_eaten
│ │ ├ time_spent
│ │ ├ times_eaten
│ │ └ dry..wet
│ │ └ weight
│ ├ movement
│ │ ├ last_direction
│ │ ├ last_flap
│ │ ├ last_flap_id
│ │ ├ last_time
│ │ ├ time_spent_outside_
│ │ └ times_outside
│ └ water
│ ├ last_time_drunk
│ ├ time_spent
│ ├ times_drunk
│ └ weight
└ info
├ all_devices_online
├ connection
├ last_update
├ offline_devices
└ version
Notes
SureFlap®, Sure Petcare® and Felaqua® are registered trademarks of SureFlap Ltd.
The pictures of the SureFlap® devices are provided free to use
from Sure Petcare®.
Changelog
$3
* (Sickboy78) dependency updates
* (Sickboy78) add AlCalzone's Release Script
$3
* (Sickboy78) dependency updates
* (Sickboy78) migration to npm trusted publishing
$3
* (Sickboy78) removed deprecated util.promisify
$3
* (Sickboy78) added translations for unknown pet setting
$3
* (Sickboy78) fixed unknown pet getting deleted at adapter startup
$3
* (Sickboy78) fixed bug with unknown pet movement
$3
* (Sickboy78) fixed bug with unknown pet movement
$3
* (Sickboy78) added unknown pet movement
$3
* (Sickboy78) made pet assignment controllable
* (Sickboy78) dependency updates
$3
* (Sickboy78) prevent log spam from missing rssi
$3
* (Sickboy78) improved handling of number of bowls
* (Sickboy78) added version specific handling of deprecated data
* (Sickboy78) dependency updates
$3
* (Sickboy78) fix for curfew not being 24-hour format
* (Sickboy78) fix typos in warnings
$3
* (Sickboy78) complete refactoring of surepet API
* (Sickboy78) complete refactoring of internal data structure
* (Sickboy78) added list of offline devices
* (Sickboy78) switched to jsonConfig
* (Sickboy78) dependency updates
$3
* (Sickboy78) fixed a bug when feeder does not have bowls data
$3
* (Sickboy78) quick fix for surepet API changes
* (Sickboy78) dependency updates
$3
* (Sickboy78) improved responsive design for admin page
* (Sickboy78) added nodejs 22 to test matrix
* (Sickboy78) dependency updates
$3
* (Sickboy78) improved handling of missing, invalid or incomplete data from API
* (Sickboy78) improved error handling for pets
* (Sickboy78) fixed no battery data error
* (Sickboy78) dependency updates
$3
* (Sickboy78) added new data to feeder
* (Sickboy78) added new data to water dispenser
* (Sickboy78) dependency updates
$3
* (Sickboy78) added new json curfew
* (Sickboy78) added new json history
* (Sickboy78) fix lock mode is undefined
* (Sickboy78) code cleanup and refactoring
* (Sickboy78) dependency updates
$3
* (Sickboy78) dependency updates
$3
* (Sickboy78) bugfix for outside times not beeing shown
$3
* (Scrounger) option to enable history data
* (Sickboy78) added number of history entries to configuration
$3
* (Sickboy78) added flap id to last movement
* (Sickboy78) fixed a bug where hub was recognized as obsolete device because of same name as a device
* (Sickboy78) fixed a bug where setting lockmode or curfew was not working because of flap having same name as the hub
$3
* (Sickboy78) added last movement for pets
* (Sickboy78) added time spent outside today for pets
* (Sickboy78) dependency updates
$3
* (Sickboy78) added api host to config and set default to new api
* (Sickboy78) improved removing of obsolete objects
$3
* (Sickboy78) added signal strength and hardware and firmware version of devices
$3
* (Sickboy78) fixed get_history_since call failing because of API changes
* (Sickboy78) added workaround for removed parent object because of API changes
* (Sickboy78) removed wrongly created objects because of API changes
$3
* (Sickboy78) repetitive errors are now logged as debug to avoid spamming the error log
* (Sickboy78) increased timeout for surepet API from 60 to 120 seconds
* (Sickboy78) added removal of deleted or renamed pets
* (Sickboy78) security updates
$3
* (Sickboy78) fixed undefined serial number
* (Sickboy78) dependency updates
$3
* (Sickboy78) adjustments for Surepet API changes
$3
* (Sickboy78) fixed false login error in case pet had no photo
$3
* (Sickboy78) added battery voltage configuration
* (Sickboy78) added translation for adapter settings
* (Sickboy78) security updates
$3
* (Sickboy78) added display of serial numbers
$3
* (Sickboy78) added Felaqua support
* (Sickboy78) improved battery and battery percentage indicator (reduced outliers)
$3
* (Sickboy78) code improvements
* (Sickboy78) improved error handling if no pet has been assigned yet
$3
* (Sickboy78) improved error and timeout handling
* (Sickboy78) optimized subscribed states
$3
* (Sickboy78) removed pet type control from pet flap (is a cat flap exclusive feature)
* (Sickboy78) fixed wrong default value for info.last_update
* (Sickboy78) testing updates for js-controller 4
* (Sickboy78) security updates
$3
* (Sickboy78) bugfix and security updates
$3
* (Sickboy78) removed old encrypt/decrypt from index_m
* (Sickboy78) added adapter unloaded guard in case unload happens during data requests
$3
* (Sickboy78) added food type, target weight and remaining food in feeder
* (Sickboy78) added todays pet food consumption, times eaten and time spent
$3
* (Sickboy78) added history
* (Sickboy78) added last update time
$3
* (Sickboy78) added feeder support (closing delay of lid)
* (Sickboy78) added led control for hub
* (Sickboy78) added assigned pets for flap and feeder devices
* (Sickboy78) added pet type control (indoor or outdoor) for assigned pets for flap devices
* (Apollon77) update CI testing
$3
* (Sickboy78) fixed bug in case pets didn't have a position (e.g. no flaps, only feeder in use)
$3
* (Sickboy78) added state curfew_active for pet flap devices
* (Sickboy78) fixed normalization of device names
* (Sickboy78) fixed changeable values not resetting when change fails
$3
* (Sickboy78) code improvements from review
* (Sickboy78) fixed timezone bug
$3
* (Sickboy78) fixed bug setting lockmode and inside values
$3
* (Sickboy78) initial release
License
MIT License
Permission is hereby granted, free of charge, to any person obtaining a copy
of this software and associated documentation files (the "Software"), to deal
in the Software without restriction, including without limitation the rights
to use, copy, modify, merge, publish, distribute, sublicense, and/or sell
copies of the Software, and to permit persons to whom the Software is
furnished to do so, subject to the following conditions:
The above copyright notice and this permission notice shall be included in all
copies or substantial portions of the Software.
THE SOFTWARE IS PROVIDED "AS IS", WITHOUT WARRANTY OF ANY KIND, EXPRESS OR
IMPLIED, INCLUDING BUT NOT LIMITED TO THE WARRANTIES OF MERCHANTABILITY,
FITNESS FOR A PARTICULAR PURPOSE AND NONINFRINGEMENT. IN NO EVENT SHALL THE
AUTHORS OR COPYRIGHT HOLDERS BE LIABLE FOR ANY CLAIM, DAMAGES OR OTHER
LIABILITY, WHETHER IN AN ACTION OF CONTRACT, TORT OR OTHERWISE, ARISING FROM,
OUT OF OR IN CONNECTION WITH THE SOFTWARE OR THE USE OR OTHER DEALINGS IN THE
SOFTWARE.
Copyright (c) 2025-2026 Sickboy78