#include <NukiOpener.h>

Inheritance diagram for NukiOpener::NukiOpener:

Collaboration diagram for NukiOpener::NukiOpener:

Public Member Functions
	NukiOpener (const std::string &deviceName, const uint32_t deviceId)

Nuki::CmdResult	addTimeControlEntry (NewTimeControlEntry newTimecontrolEntry)
	Sends a new time(d) control entry via BLE to the opener. This entry is independant of keypad or authorization entries, it will execute the defined action at the defined time in the newTimeControlEntry.

Nuki::CmdResult	disableRtoAfterRing (const bool disable)
	Gets the current config from the opener, updates the disable rto after ring parameter and sends the new config to the opener via BLE.

Nuki::CmdResult	enableAutoBatteryTypeDetection (const bool enable)
	Gets the current advanced config from the opener, updates the enable battery type detection parameter and sends the new advanced config to the opener via BLE.

Nuki::CmdResult	enableButton (const bool enable)
	Gets the current config from the opener, updates the enable button parameter and sends the new config to the opener via BLE.

Nuki::CmdResult	enableDst (const bool enable)
	Gets the current config from the opener, updates the dst parameter and sends the new config to the opener via BLE.

CmdResult	enableLedFlash (const bool enable)
	Gets the current config from the opener, updates the whether or not the flashing LED should be enabled to signal an unlocked door. And sends the new config to the opener via BLE.

Nuki::CmdResult	enablePairing (const bool enable)
	Sets the opener ability to pair with other devices (can be used to prevent unauthorized pairing) Gets the current config from the opener, updates the pairing parameter and sends the new config to the opener via BLE (CAUTION: if pairing is set to false and credentials are deleted a factory reset of the opener needs to be performed before pairing is possible again)

Nuki::CmdResult	enableRandomElectricStrikeDelay (const bool enable)
	Gets the current config from the opener, updates the random electric strike delay parameter and sends the new config to the opener via BLE.

Nuki::CmdResult	enableSoundConfirmation (const bool enable)
	Gets the current config from the opener, updates the enable sound confirmation parameter and sends the new config to the opener via BLE.

const ErrorCode	getLastError () const
	Get the Last Error code received from the opener.

void	getLogEntries (std::list< LogEntry > *requestedLogEntries)
	Get the Log Entries stored on the esp. Only available after executing retreiveLogEntries.

void	getTimeControlEntries (std::list< TimeControlEntry > *timeControlEntries)
	Get the time control entries stored on the esp (after executing retrieveTimeControlEntries())

bool	isBatteryCritical ()
	Returns battery critical state parsed from the battery state byte (battery critical byte)

bool	isKeypadBatteryCritical ()
	Returns keypad battery critical state in case this is supported.

Nuki::CmdResult	lockAction (const LockAction lockAction, const uint32_t nukiAppId=1, const uint8_t flags=0, const char *nameSuffix=nullptr, const uint8_t nameSuffixLen=0)
	Sends lock action cmd via BLE to the opener.

virtual void	logErrorCode (uint8_t errorCode) override

Nuki::CmdResult	removeTimeControlEntry (uint8_t entryId)
	Deletes a time(d) control entry via BLE to the opener. (see addTimeControlEntry())

Nuki::CmdResult	requestAdvancedConfig (AdvancedConfig *retrievedAdvancedConfig)
	Requests advanced config from Opener via BLE.

Nuki::CmdResult	requestBatteryReport (BatteryReport *retrievedBatteryReport)
	Requests battery status from Opener via BLE.

Nuki::CmdResult	requestConfig (Config *retrievedConfig)
	Requests config from Opener via BLE.

Nuki::CmdResult	requestOpenerState (OpenerState *state)
	Requests keyturner state from Opener via BLE.

Nuki::CmdResult	retrieveLogEntries (const uint32_t startIndex, const uint16_t count, const uint8_t sortOrder, const bool totalCount)
	Request the opener via BLE to send the log entries.

void	retrieveOpenerState (OpenerState *openerState)
	Gets the last keyturner state stored on the esp.

Nuki::CmdResult	retrieveTimeControlEntries ()
	Request the opener via BLE to send the existing time control entries.

Nuki::CmdResult	setAdvertisingMode (const AdvertisingMode mode)
	Gets the current config from the opener, updates the advertising frequency parameter and sends the new config to the opener via BLE.

Nuki::CmdResult	setBatteryType (const BatteryType type)
	Gets the current advanced config from the opener, updates the battery type parameter and sends the new advanced config to the opener via BLE.

Nuki::CmdResult	setBusModeSwitch (const bool busModeSwitch)
	Gets the current config from the opener, updates the bus mode switch parameter and sends the new config to the opener via BLE.

Nuki::CmdResult	setDoorbellSuppression (const uint8_t suppression)
	Gets the current config from the opener, updates the doorbell suppression parameter and sends the new config to the opener via BLE.

Nuki::CmdResult	setDoorbellSuppressionDuration (const uint16_t duration)
	Gets the current config from the opener, updates the doorbell suppression duration parameter and sends the new config to the opener via BLE.

Nuki::CmdResult	setDoubleButtonPressAction (const ButtonPressAction action)
	Gets the current advanced config from the opener, updates the double button press action parameter and sends the new advanced config to the opener via BLE.

Nuki::CmdResult	setElectricStrikeDelay (const uint16_t delay)
	Gets the current config from the opener, updates the electric strike delay parameter and sends the new config to the opener via BLE.

Nuki::CmdResult	setElectricStrikeDuration (const uint16_t duration)
	Gets the current config from the opener, updates the electric strike duration parameter and sends the new config to the opener via BLE.

Nuki::CmdResult	setFobAction (const uint8_t fobActionNr, const uint8_t fobAction)
	Gets the current config from the opener, updates the given fob action parameter and sends the new config to the opener via BLE.

Nuki::CmdResult	setIntercomID (const uint16_t intercomID)
	Gets the current config from the opener, updates the intercom id parameter and sends the new config to the opener via BLE.

Nuki::CmdResult	setLatitude (const float degrees)
	Gets the current config from the opener, updates the latitude parameter and sends the new config to the opener via BLE.

Nuki::CmdResult	setLongitude (const float degrees)
	Gets the current config from the opener, updates the longitude parameter and sends the new config to the opener via BLE.

Nuki::CmdResult	setName (const std::string &name)
	Gets the current config from the opener, updates the name parameter and sends the new config to the opener via BLE.

Nuki::CmdResult	setOperatingMode (const uint8_t opmode)
	Gets the current config from the opener, updates the operating mode parameter and sends the new config to the opener via BLE.

Nuki::CmdResult	setRtoTimeout (const uint8_t timeout)
	Gets the current config from the opener, updates the rto timeout parameter and sends the new config to the opener via BLE.

Nuki::CmdResult	setShortCircuitDuration (const uint16_t duration)
	Gets the current config from the opener, updates the short circuit duration parameter and sends the new config to the opener via BLE.

Nuki::CmdResult	setSingleButtonPressAction (const ButtonPressAction action)
	Gets the current advanced config from the opener, updates the single button press action parameter and sends the new advanced config to the opener via BLE.

Nuki::CmdResult	setSoundCm (const uint8_t sound)
	Gets the current config from the opener, updates the sound continuous mode parameter and sends the new config to the opener via BLE.

CmdResult	setSoundLevel (const uint8_t value)
	Gets the current config from the opener, and updates the sound level.

Nuki::CmdResult	setSoundOpen (const uint8_t sound)
	Gets the current config from the opener, updates the sound open parameter and sends the new config to the opener via BLE.

Nuki::CmdResult	setSoundRing (const uint8_t sound)
	Gets the current config from the opener, updates the sound ring parameter and sends the new config to the opener via BLE.

Nuki::CmdResult	setSoundRto (const uint8_t sound)
	Gets the current config from the opener, updates the sound RTO parameter and sends the new config to the opener via BLE.

Nuki::CmdResult	setTimeZoneId (const TimeZoneId timeZoneId)
	Gets the current config from the opener, updates the timezone id parameter and sends the new config to the opener via BLE.

Nuki::CmdResult	setTimeZoneOffset (const int16_t minutes)
	Gets the current config from the opener, updates the timezone offset parameter and sends the new config to the opener via BLE.

Nuki::CmdResult	updateTimeControlEntry (TimeControlEntry TimeControlEntry)
	Sends an updated time(d) control entry via BLE to the opener. (see addTimeControlEntry())

Public Member Functions inherited from Nuki::NukiBle
	NukiBle (const std::string &deviceName, const uint32_t deviceId, const NimBLEUUID pairingServiceUUID, const NimBLEUUID pairingServiceUltraUUID, const NimBLEUUID deviceServiceUUID, const NimBLEUUID gdioUUID, const NimBLEUUID gdioUltraUUID, const NimBLEUUID userDataUUID, const std::string preferencedId)

virtual	~NukiBle ()

Nuki::CmdResult	addAuthorizationEntry (NewAuthorizationEntry newAuthorizationEntry)
	Sends a new authorization entry to the lock via BLE.

Nuki::CmdResult	addKeypadEntry (NewKeypadEntry newKeypadEntry)
	Send a new keypad entry to the lock via BLE.

Nuki::CmdResult	deleteAuthorizationEntry (const uint32_t id)
	Deletes the authorization entry from the lock.

CmdResult	deleteKeypadEntry (uint16_t id)
	Delete a Keypad Entry.

Nuki::CmdResult	genericCommand (Command command, bool withPin=true)
	Sends a custom command to the lock via BLE.

void	getAuthorizationEntries (std::list< AuthorizationEntry > *requestedAuthorizationEntries)
	Get the Authorization Entries stored on the esp (after executing retreiveAuthorizationEntries)

const BLEAddress	getBleAddress () const
	Returns the BLE address of the device if paired.

void	getFingerprintEntries (std::list< FingerprintEntry > *requestedFingerprintEntries)
	Get the Fingerprint Entries stored on the esp (after executing retrieveFingerprintEntries)

void	getKeypadEntries (std::list< KeypadEntry > *requestedKeyPadEntries)
	Get the Keypad Entries stored on the esp (after executing retreieveLogKeypadEntries)

uint16_t	getKeypadEntryCount ()
	Returns the keypad entry count. Only available after executing retreiveKeypadEntries.

unsigned long	getLastHeartbeat ()
	Returns the timestamp (millis) of the last received BLE beacon from the lock.

unsigned long	getLastReceivedBeaconTs () const
	Returns the timestamp in milliseconds when the last ble beacon has been received from the device.

uint16_t	getLogEntryCount ()
	Returns the log entry count. Only available after executing retreiveLogEntries.

void	getMacAddress (char *macAddress)
	Gets the ble mac address of the paired lock stored on the esp.

int	getRssi () const
	Returns the RSSI of the last received ble beacon broadcast.

uint16_t	getSecurityPincode ()
	Gets the pincode stored on the esp. This pincode is used for sending/setting config via BLE to the lock by other methods and needs to be the same pincode as stored in the lock.

uint32_t	getUltraPincode ()

void	initialize (bool initAltConnect=false)
	Initializes stored preferences based on the devicename passed in the constructor, creates the BLE client, sets the BLE callback and checks if the lock is paired (if credentials are stored in preferences)

const bool	isLockUltra () const
	Returns if BLE is pairing/paired/connected with a Smart Lock Ultra.

const bool	isPairedWithLock () const
	Returns pairing state (if credentials are stored or not)

Nuki::PairingResult	pairNuki (AuthorizationIdType idType=AuthorizationIdType::Bridge)
	Checks if credentials are stored in preferences, if not initiate pairing.

void	registerBleScanner (BleScanner::Publisher *bleScanner)
	Registers the BLE scanner to be used for scanning for advertisements from the lock. BleScanner::Publisher is defined in dependent library https://github.com/I-Connect/BleScanner.git.

void	registerLogger (Print *Log)
	Registers a Logger to be used for printing debug logs.

Nuki::CmdResult	requestCalibration ()
	Sends an calibration (mechanical) request to the lock via BLE.

Nuki::CmdResult	requestDailyStatistics ()
	Sends a request for daily statistics to the lock via BLE.

Nuki::CmdResult	requestReboot ()
	Sends an reboot request to the lock via BLE.

void	resetHost ()
	Reset BLE host.

Nuki::CmdResult	retrieveAuthorizationEntries (const uint16_t offset, const uint16_t count)
	Request the lock via BLE to send the existing authorizationentries.

Nuki::CmdResult	retrieveFingerprintEntries ()
	Request the lock via BLE to send the existing fingerprint entries.

Nuki::CmdResult	retrieveKeypadEntries (const uint16_t offset, const uint16_t count)
	Request the lock via BLE to send the existing keypad entries.

bool	saveSecurityPincode (const uint16_t pinCode)
	Saves the pincode on the esp. This pincode is used for sending/setting config via BLE to the lock by other methods and needs to be the same pincode as stored in the lock.

bool	saveUltraPincode (const uint32_t pinCode, bool save=true)

void	setConnectRetries (uint8_t retries)
	Set the BLE Connect number of retries.

void	setConnectTimeout (uint8_t timeout)
	Set the BLE Connect Timeout in seconds.

void	setDebugCommand (bool enable)
	Whether to enable or disable command debug logging.

void	setDebugCommunication (bool enable)
	Whether to enable or disable communication debug logging.

void	setDebugConnect (bool enable)
	Whether to enable or disable connect debug logging.

void	setDebugHexData (bool enable)
	Whether to enable or disable hex data debug logging.

void	setDebugReadableData (bool enable)
	Whether to enable or disable readable data debug logging.

void	setDisconnectTimeout (uint32_t timeoutMs)
	Set the BLE Disconnect Timeout, if longer than ~20 sec the lock will disconnect by itself if there is no BLE communication.

void	setEventHandler (Nuki::SmartlockEventHandler *handler)
	Set the Event Handler object.

void	setPower (esp_power_level_t powerLevel)
	the transmission power.

Nuki::CmdResult	setSecurityPin (const uint16_t newSecurityPin)
	Send the new pincode command to the lock via BLE (this command uses the earlier by saveSecurityPincode() stored pincode which needs to be the same as the pincode stored in the lock)

Nuki::CmdResult	setUltraPin (const uint32_t newSecurityPin)

void	unPairNuki ()
	Delete stored credentials.

Nuki::CmdResult	updateAuthorizationEntry (UpdatedAuthorizationEntry updatedAuthorizationEntry)
	Sends an updated authorization entry to the lock via BLE.

void	updateConnectionState ()
	checks the time past after last connect/communication sent, if the time past > timeout it will disconnect the BLE connection with the lock so that lock will start sending advertisements.

Nuki::CmdResult	updateKeypadEntry (UpdatedKeypadEntry updatedKeyPadEntry)
	Send an updated keypad entry to the lock via BLE.

Nuki::CmdResult	updateTime (TimeValue time)
	Sends the time to be set to the lock via BLE.

Nuki::CmdResult	verifySecurityPin ()
	Send the verify pincode command via BLE to the lock. This command uses the earlier by saveSecurityPincode() stored pincode.

Protected Member Functions
void	handleReturnMessage (Command returnCode, unsigned char *data, uint16_t dataLen) override

Protected Member Functions inherited from Nuki::NukiBle
template<typename TDeviceAction>
Nuki::CmdResult	cmdChallAccStateMachine (const TDeviceAction action)

template<typename TDeviceAction>
Nuki::CmdResult	cmdChallStateMachine (const TDeviceAction action, const bool sendPinCode=false)

template<typename TDeviceAction>
Nuki::CmdResult	cmdStateMachine (const TDeviceAction action)

bool	connectBle (const BLEAddress bleAddress, bool pairing)

template<typename TDeviceAction>
Nuki::CmdResult	executeAction (const TDeviceAction action)

void	extendDisconnectTimeout ()

void	logMessage (const char *message, int level=4)

void	logMessageVar (const char message, const char var, int level=4)

void	logMessageVar (const char *message, unsigned int var, int level=4)

Additional Inherited Members
Protected Attributes inherited from Nuki::NukiBle
bool	debugNukiCommand = false

bool	debugNukiCommunication = false

bool	debugNukiConnect = false

bool	debugNukiHexData = false

bool	debugNukiReadableData = false

uint8_t	errorCode = 0

Command	lastMsgCodeReceived = Command::Empty

Print *	logger = nullptr

Constructor & Destructor Documentation

◆ NukiOpener()

NukiOpener::NukiOpener::NukiOpener	(	const std::string &	deviceName,
		const uint32_t	deviceId )

Here is the call graph for this function:

Member Function Documentation

◆ addTimeControlEntry()

Nuki::CmdResult NukiOpener::NukiOpener::addTimeControlEntry ( NewTimeControlEntry newTimecontrolEntry )

Sends a new time(d) control entry via BLE to the opener. This entry is independant of keypad or authorization entries, it will execute the defined action at the defined time in the newTimeControlEntry.

Parameters

newTimecontrolEntry Nuki api based datatype to send

Here is the call graph for this function:

◆ disableRtoAfterRing()

Nuki::CmdResult NukiOpener::NukiOpener::disableRtoAfterRing ( const bool disable )

Gets the current config from the opener, updates the disable rto after ring parameter and sends the new config to the opener via BLE.

Parameters

disable true if RTO should be disabled after ring

Here is the call graph for this function:

◆ enableAutoBatteryTypeDetection()

Nuki::CmdResult NukiOpener::NukiOpener::enableAutoBatteryTypeDetection ( const bool enable )

Gets the current advanced config from the opener, updates the enable battery type detection parameter and sends the new advanced config to the opener via BLE.

Parameters

enable true if the automatic detection of the battery type is enabled

Here is the call graph for this function:

◆ enableButton()

Nuki::CmdResult NukiOpener::NukiOpener::enableButton ( const bool enable )

Gets the current config from the opener, updates the enable button parameter and sends the new config to the opener via BLE.

Parameters

enable true if button enabled

Here is the call graph for this function:

◆ enableDst()

Nuki::CmdResult NukiOpener::NukiOpener::enableDst ( const bool enable )

Gets the current config from the opener, updates the dst parameter and sends the new config to the opener via BLE.

Parameters

enable The desired daylight saving time mode. false disabled, true european

Here is the call graph for this function:

◆ enableLedFlash()

CmdResult NukiOpener::NukiOpener::enableLedFlash ( const bool enable )

Gets the current config from the opener, updates the whether or not the flashing LED should be enabled to signal an unlocked door. And sends the new config to the opener via BLE.

Parameters

enable true if led enabled

Here is the call graph for this function:

◆ enablePairing()

Nuki::CmdResult NukiOpener::NukiOpener::enablePairing ( const bool enable )

Sets the opener ability to pair with other devices (can be used to prevent unauthorized pairing) Gets the current config from the opener, updates the pairing parameter and sends the new config to the opener via BLE (CAUTION: if pairing is set to false and credentials are deleted a factory reset of the opener needs to be performed before pairing is possible again)

Parameters

enable true if allowed to pair with other devices

Here is the call graph for this function:

◆ enableRandomElectricStrikeDelay()

Nuki::CmdResult NukiOpener::NukiOpener::enableRandomElectricStrikeDelay ( const bool enable )

Gets the current config from the opener, updates the random electric strike delay parameter and sends the new config to the opener via BLE.

Parameters

enable true if random electric strike delay enabled

Here is the call graph for this function:

◆ enableSoundConfirmation()

Nuki::CmdResult NukiOpener::NukiOpener::enableSoundConfirmation ( const bool enable )

Gets the current config from the opener, updates the enable sound confirmation parameter and sends the new config to the opener via BLE.

Parameters

enable true if sound confirmation enabled

Here is the call graph for this function:

◆ getLastError()

const ErrorCode NukiOpener::NukiOpener::getLastError ( ) const

Get the Last Error code received from the opener.

◆ getLogEntries()

void NukiOpener::NukiOpener::getLogEntries ( std::list< LogEntry > * requestedLogEntries )

Get the Log Entries stored on the esp. Only available after executing retreiveLogEntries.

Parameters

requestedLogEntries list to store the returned log entries

◆ getTimeControlEntries()

void NukiOpener::NukiOpener::getTimeControlEntries ( std::list< TimeControlEntry > * timeControlEntries )

Get the time control entries stored on the esp (after executing retrieveTimeControlEntries())

Parameters

timeControlEntries list to store the returned time control entries

◆ handleReturnMessage()

void NukiOpener::NukiOpener::handleReturnMessage	(	Command	returnCode,
		unsigned char *	data,
		uint16_t	dataLen )

overrideprotectedvirtual

Reimplemented from Nuki::NukiBle.

Here is the call graph for this function:

◆ isBatteryCritical()

bool NukiOpener::NukiOpener::isBatteryCritical ( )

Returns battery critical state parsed from the battery state byte (battery critical byte)

Note that retrieveOpenerState() needs to be called first to retrieve the needed data

Returns: true if critical

◆ isKeypadBatteryCritical()

bool NukiOpener::NukiOpener::isKeypadBatteryCritical ( )

Returns keypad battery critical state in case this is supported.

Note that retrieveOpenerState() needs to be called first to retrieve the needed data

Returns: true if critical

◆ lockAction()

Nuki::CmdResult NukiOpener::NukiOpener::lockAction	(	const LockAction	lockAction,
		const uint32_t	nukiAppId = 1,
		const uint8_t	flags = 0,
		const char *	nameSuffix = nullptr,
		const uint8_t	nameSuffixLen = 0 )

Sends lock action cmd via BLE to the opener.

Parameters

lockAction
nukiAppId	0 = App, 1 = Bridge, 2 = Fob, 3 = Keypad
flags	optional
nameSuffix	optional
nameSuffixLen	len of nameSuffix if used

Returns: Nuki::CmdResult

Here is the call graph for this function:

Here is the caller graph for this function:

◆ logErrorCode()

void NukiOpener::NukiOpener::logErrorCode ( uint8_t errorCode )

overridevirtual

Implements Nuki::NukiBle.

Here is the call graph for this function:

◆ removeTimeControlEntry()

Nuki::CmdResult NukiOpener::NukiOpener::removeTimeControlEntry ( uint8_t entryId )

Deletes a time(d) control entry via BLE to the opener. (see addTimeControlEntry())

Parameters

entryId The ID to be deleted, can be retrieved via retrieveTimeControlEntries()

Here is the call graph for this function:

◆ requestAdvancedConfig()

Nuki::CmdResult NukiOpener::NukiOpener::requestAdvancedConfig ( AdvancedConfig * retrievedAdvancedConfig )

Requests advanced config from Opener via BLE.

Parameters

retrievedAdvancedConfig Nuki api based datatype to store the retrieved advanced config

Here is the call graph for this function:

Here is the caller graph for this function:

◆ requestBatteryReport()

Nuki::CmdResult NukiOpener::NukiOpener::requestBatteryReport ( BatteryReport * retrievedBatteryReport )

Requests battery status from Opener via BLE.

Parameters

retrievedBatteryReport Nuki api based datatype to store the retrieved battery status

Here is the call graph for this function:

◆ requestConfig()

Nuki::CmdResult NukiOpener::NukiOpener::requestConfig ( Config * retrievedConfig )

Requests config from Opener via BLE.

Parameters

retrievedConfig Nuki api based datatype to store the retrieved config

Here is the call graph for this function:

Here is the caller graph for this function:

◆ requestOpenerState()

Nuki::CmdResult NukiOpener::NukiOpener::requestOpenerState ( OpenerState * state )

Requests keyturner state from Opener via BLE.

Parameters

state Nuki api based datatype to store the retrieved keyturnerstate

Here is the call graph for this function:

◆ retrieveLogEntries()

Nuki::CmdResult NukiOpener::NukiOpener::retrieveLogEntries	(	const uint32_t	startIndex,
		const uint16_t	count,
		const uint8_t	sortOrder,
		const bool	totalCount )

Request the opener via BLE to send the log entries.

Parameters

startIndex	Startindex of first log msg to be send
count	The number of log entries to be read, starting at the specified start index.
sortOrder	The desired sort order
totalCount	true if a Log Entry Count is requested from the opener

Here is the call graph for this function:

◆ retrieveOpenerState()

void NukiOpener::NukiOpener::retrieveOpenerState ( OpenerState * openerState )

Gets the last keyturner state stored on the esp.

Parameters

openerState Nuki api based datatype to store the retrieved keyturnerstate

◆ retrieveTimeControlEntries()

Nuki::CmdResult NukiOpener::NukiOpener::retrieveTimeControlEntries ( )

Request the opener via BLE to send the existing time control entries.

Here is the call graph for this function:

◆ setAdvertisingMode()

Nuki::CmdResult NukiOpener::NukiOpener::setAdvertisingMode ( const AdvertisingMode mode )

Gets the current config from the opener, updates the advertising frequency parameter and sends the new config to the opener via BLE.

Parameters

mode	0x00 Automatic, 0x01 Normal, 0x02 Slow, 0x03 Slowest (~400ms till ~1s)

Here is the call graph for this function:

◆ setBatteryType()

Nuki::CmdResult NukiOpener::NukiOpener::setBatteryType ( const BatteryType type )

Gets the current advanced config from the opener, updates the battery type parameter and sends the new advanced config to the opener via BLE.

Parameters

type	The type of the batteries present in the smart opener.

Here is the call graph for this function:

◆ setBusModeSwitch()

Nuki::CmdResult NukiOpener::NukiOpener::setBusModeSwitch ( const bool busModeSwitch )

Gets the current config from the opener, updates the bus mode switch parameter and sends the new config to the opener via BLE.

Parameters

busModeSwitch true for analogue mode, false for data mode

Here is the call graph for this function:

◆ setDoorbellSuppression()

Nuki::CmdResult NukiOpener::NukiOpener::setDoorbellSuppression ( const uint8_t suppression )

Gets the current config from the opener, updates the doorbell suppression parameter and sends the new config to the opener via BLE.

Parameters

suppression the desired setting for doorbell suppression (0 = Off, 1 = CM, 2 = RTO, 3 = CM & RTO, 4 = Ring, 5 = CM & Ring, 6 = RTO & Ring, 7 = CM & RTO & Ring)

Here is the call graph for this function:

◆ setDoorbellSuppressionDuration()

Nuki::CmdResult NukiOpener::NukiOpener::setDoorbellSuppressionDuration ( const uint16_t duration )

Gets the current config from the opener, updates the doorbell suppression duration parameter and sends the new config to the opener via BLE.

Parameters

duration the duration in ms of doorbell suppression (only in Operating mode 0x02,0x03,0x04,0x05,0x07,0x08 digital Intercom)

Here is the call graph for this function:

◆ setDoubleButtonPressAction()

Nuki::CmdResult NukiOpener::NukiOpener::setDoubleButtonPressAction ( const ButtonPressAction action )

Gets the current advanced config from the opener, updates the double button press action parameter and sends the new advanced config to the opener via BLE.

Parameters

action the desired action for a double button press

Here is the call graph for this function:

◆ setElectricStrikeDelay()

Nuki::CmdResult NukiOpener::NukiOpener::setElectricStrikeDelay ( const uint16_t delay )

Gets the current config from the opener, updates the electric strike delay parameter and sends the new config to the opener via BLE.

Parameters

delay the desired electric strike delay in ms in case of an electric strike actuation by RTO

Here is the call graph for this function:

◆ setElectricStrikeDuration()

Nuki::CmdResult NukiOpener::NukiOpener::setElectricStrikeDuration ( const uint16_t duration )

Gets the current config from the opener, updates the electric strike duration parameter and sends the new config to the opener via BLE.

Parameters

duration the desired duration in ms of electric strike actuation.

Here is the call graph for this function:

◆ setFobAction()

Nuki::CmdResult NukiOpener::NukiOpener::setFobAction	(	const uint8_t	fobActionNr,
		const uint8_t	fobAction )

Gets the current config from the opener, updates the given fob action parameter and sends the new config to the opener via BLE.

Parameters

fobActionNr	the fob action to change (1 = single press, 2 = double press, 3 = triple press)
fobAction	the desired fob action setting

Here is the call graph for this function:

◆ setIntercomID()

Nuki::CmdResult NukiOpener::NukiOpener::setIntercomID ( const uint16_t intercomID )

Gets the current config from the opener, updates the intercom id parameter and sends the new config to the opener via BLE.

Parameters

intercomID the desired database ID of the connected intercom

Here is the call graph for this function:

◆ setLatitude()

Nuki::CmdResult NukiOpener::NukiOpener::setLatitude ( const float degrees )

Gets the current config from the opener, updates the latitude parameter and sends the new config to the opener via BLE.

Parameters

degrees the desired latitude

Here is the call graph for this function:

◆ setLongitude()

Nuki::CmdResult NukiOpener::NukiOpener::setLongitude ( const float degrees )

Gets the current config from the opener, updates the longitude parameter and sends the new config to the opener via BLE.

Parameters

degrees the desired longitude

Here is the call graph for this function:

◆ setName()

Nuki::CmdResult NukiOpener::NukiOpener::setName ( const std::string & name )

Gets the current config from the opener, updates the name parameter and sends the new config to the opener via BLE.

Parameters

name	max 32 character name

Here is the call graph for this function:

◆ setOperatingMode()

Nuki::CmdResult NukiOpener::NukiOpener::setOperatingMode ( const uint8_t opmode )

Gets the current config from the opener, updates the operating mode parameter and sends the new config to the opener via BLE.

Parameters

opmode the desired operating mode

Here is the call graph for this function:

◆ setRtoTimeout()

Nuki::CmdResult NukiOpener::NukiOpener::setRtoTimeout ( const uint8_t timeout )

Gets the current config from the opener, updates the rto timeout parameter and sends the new config to the opener via BLE.

Parameters

timeout the desired timeout for RTO in minutes

Here is the call graph for this function:

◆ setShortCircuitDuration()

Nuki::CmdResult NukiOpener::NukiOpener::setShortCircuitDuration ( const uint16_t duration )

Gets the current config from the opener, updates the short circuit duration parameter and sends the new config to the opener via BLE.

Parameters

duration the desired duration of the short circuit for BUS mode switching in ms

Here is the call graph for this function:

◆ setSingleButtonPressAction()

Nuki::CmdResult NukiOpener::NukiOpener::setSingleButtonPressAction ( const ButtonPressAction action )

Gets the current advanced config from the opener, updates the single button press action parameter and sends the new advanced config to the opener via BLE.

Parameters

action the desired action for a single button press

Here is the call graph for this function:

◆ setSoundCm()

Nuki::CmdResult NukiOpener::NukiOpener::setSoundCm ( const uint8_t sound )

Gets the current config from the opener, updates the sound continuous mode parameter and sends the new config to the opener via BLE.

Parameters

sound the desired sound setting for continuous mode (0 = No Sound, 1 = Sound1, 2 = Sound2, 3 = Sound3)

Here is the call graph for this function:

◆ setSoundLevel()

CmdResult NukiOpener::NukiOpener::setSoundLevel ( const uint8_t value )

Gets the current config from the opener, and updates the sound level.

Parameters

enable true if led enabled

Here is the call graph for this function:

◆ setSoundOpen()

Nuki::CmdResult NukiOpener::NukiOpener::setSoundOpen ( const uint8_t sound )

Gets the current config from the opener, updates the sound open parameter and sends the new config to the opener via BLE.

Parameters

sound the desired sound setting for open (0 = No Sound, 1 = Sound1, 2 = Sound2, 3 = Sound3)

Here is the call graph for this function:

◆ setSoundRing()

Nuki::CmdResult NukiOpener::NukiOpener::setSoundRing ( const uint8_t sound )

Gets the current config from the opener, updates the sound ring parameter and sends the new config to the opener via BLE.

Parameters

sound the desired sound setting for ring (0 = No Sound, 1 = Sound1, 2 = Sound2, 3 = Sound3)

Here is the call graph for this function:

◆ setSoundRto()

Nuki::CmdResult NukiOpener::NukiOpener::setSoundRto ( const uint8_t sound )

Gets the current config from the opener, updates the sound RTO parameter and sends the new config to the opener via BLE.

Parameters

sound the desired sound setting for RTO (0 = No Sound, 1 = Sound1, 2 = Sound2, 3 = Sound3)

Here is the call graph for this function:

◆ setTimeZoneId()

Nuki::CmdResult NukiOpener::NukiOpener::setTimeZoneId ( const TimeZoneId timeZoneId )

Gets the current config from the opener, updates the timezone id parameter and sends the new config to the opener via BLE.

Parameters

timeZoneId The id of the current timezone or 0xFFFF if timezones are not supported

Here is the call graph for this function:

◆ setTimeZoneOffset()

Nuki::CmdResult NukiOpener::NukiOpener::setTimeZoneOffset ( const int16_t minutes )

Gets the current config from the opener, updates the timezone offset parameter and sends the new config to the opener via BLE.

Parameters

minutes The timezone offset (UTC) in minutes

Here is the call graph for this function:

◆ updateTimeControlEntry()

Nuki::CmdResult NukiOpener::NukiOpener::updateTimeControlEntry ( TimeControlEntry TimeControlEntry )

Sends an updated time(d) control entry via BLE to the opener. (see addTimeControlEntry())

Parameters

TimeControlEntry Nuki api based datatype to send. The ID can be retrieved via retrieveTimeControlEntries()

Here is the call graph for this function:

The documentation for this class was generated from the following files:

src/NukiOpener.h
src/NukiOpener.cpp

Public Member Functions

Protected Member Functions

Additional Inherited Members

Constructor & Destructor Documentation

◆ NukiOpener()

Member Function Documentation

◆ addTimeControlEntry()

◆ disableRtoAfterRing()

◆ enableAutoBatteryTypeDetection()

◆ enableButton()

◆ enableDst()

◆ enableLedFlash()

◆ enablePairing()

◆ enableRandomElectricStrikeDelay()

◆ enableSoundConfirmation()

◆ getLastError()

◆ getLogEntries()

◆ getTimeControlEntries()

◆ handleReturnMessage()

◆ isBatteryCritical()

◆ isKeypadBatteryCritical()

◆ lockAction()

◆ logErrorCode()

◆ removeTimeControlEntry()

◆ requestAdvancedConfig()

◆ requestBatteryReport()

◆ requestConfig()

◆ requestOpenerState()

◆ retrieveLogEntries()

◆ retrieveOpenerState()

◆ retrieveTimeControlEntries()

◆ setAdvertisingMode()

◆ setBatteryType()

◆ setBusModeSwitch()

◆ setDoorbellSuppression()

◆ setDoorbellSuppressionDuration()

◆ setDoubleButtonPressAction()

◆ setElectricStrikeDelay()

◆ setElectricStrikeDuration()

◆ setFobAction()

◆ setIntercomID()

◆ setLatitude()

◆ setLongitude()

◆ setName()

◆ setOperatingMode()

◆ setRtoTimeout()

◆ setShortCircuitDuration()

◆ setSingleButtonPressAction()

◆ setSoundCm()

◆ setSoundLevel()

◆ setSoundOpen()

◆ setSoundRing()

◆ setSoundRto()

◆ setTimeZoneId()

◆ setTimeZoneOffset()

◆ updateTimeControlEntry()