ioBroker.sureflap

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.

Changeable Values

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

Structure

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

WORK IN PROGRESS

(Sickboy78) reduce log messages
(Sickboy78) add node.js 26 to test matrix

3.4.3 (2026-08-29)

(Sickboy78) dependency updates
(copilot) Adapter requires node.js >= 22 now
(Sickboy78) code refactoring
(Sickboy78) added unit tests

3.4.2 (2026-01-09)

(Sickboy78) dependency updates
(Sickboy78) add AlCalzone's Release Script

3.4.1 (2025-10-22)

(Sickboy78) dependency updates
(Sickboy78) migration to npm trusted publishing

3.4.0 (2025-08-11)

(Sickboy78) removed deprecated util.promisify

3.3.0 (2025-07-13)

(Sickboy78) added translations for unknown pet setting

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.

Sure Flap