SKManagerDelegate Protocol Reference

Conforms to NSObject
Declared in SKManager.h

Overview

The SKManagerDelegate protocol defines methods that a delegate of the global available SKManager object can optionally implement to handle the communication with a blukiiSmartKey and some other generall processes of the SKManager.

Generall

– SKManagerDidUpdateState:

Invoked due to the change of the iOS bluetooth availability.

- (void)SKManagerDidUpdateState:(SKManagerStates)state

Parameters

state

The new state of the SKManager.

Declared In

SKManager.h

– SKManagerDidResetSecuritySettings

Invoked due to the execution of a reset security settings request or if any internal security dependent operation has failed.

- (void)SKManagerDidResetSecuritySettings

See Also

Declared In

SKManager.h

Searching for SmartKeys

– SKManagerDidReceiveSmartKeys:

Invoked when a SmartKey search request from the SKManager has been completed

- (void)SKManagerDidReceiveSmartKeys:(NSArray *)keys

Parameters

keys

Array with the located SmartKey’s. They are represented as objects from the SmartKey class. If no SmartKey has been located during the last request interval the array will be empty.

Discussion

The SKManager invokes this method when the related request interval is done. If a SmartKey is already linked as personal SmartKey due to the call of linkSmartKey:, it will no longer be available in the keys array.

See Also

Declared In

SKManager.h

– SKManagerDidFindLinkedSmartKey:

Invoked when a the SmartKey that is linked as personal SmartKey has been found during a request interval.

- (void)SKManagerDidFindLinkedSmartKey:(SmartKey *)linkedKey

Parameters

linkedKey

The linked SmartKey representation.

Discussion

This method indicates if the personal SmartKey was found during the search interval which is triggered by [SKManager requestSmartKeysWithTimeout:repeated:].

See Also

Declared In

SKManager.h

Communicaton state

– SKManagerDidConnectToSmartKey:

Invoked due to the execution of a connection request.

- (void)SKManagerDidConnectToSmartKey:(BOOL)successful

Parameters

successful

true: The connection is established successful. false: The connection could not be established.

See Also

Declared In

SKManager.h

– SKManagerDidDisconnectFromSmartKey:

Invoked when the connection to the SmartKey has been disconnected or interrupted.

- (void)SKManagerDidDisconnectFromSmartKey:(SKManagerDisconnectReasons)reason

Parameters

reason

The reason for the disconnect as SKManagerDisconnectReasons value

See Also

Declared In

SKManager.h

– SKManagerLinkedSmartKeyReady

Invoked when the linked SmartKey is connected and ready for further communication.

- (void)SKManagerLinkedSmartKeyReady

Discussion

When this method is invoked, the linked SmartKey will be ready for further communication. Its recommended to wait for the invocation of this method after a call of the connectToSmartKey: Method.

See Also

Declared In

SKManager.h

– SKManagerDidResetSmartKeyConfig:

Invoked due to the execution of SmartKey configuration reset request.

- (void)SKManagerDidResetSmartKeyConfig:(BOOL)successful

Parameters

successful

Indicate whether the reset has been done successfully or not. If it is succeeded the value will be true. If the reset fails the value will be false.

Discussion

Resetting the SmartKey configuration is only possible when the reset config command is sent within the first 30 seconds after a power on reset of the SmartKey. (e.g. due to a battery replacement).

See Also

Declared In

SKManager.h

Update values

– SKManagerDidUpdateConfigState:

Invoked due to the execution of a read config request.

- (void)SKManagerDidUpdateConfigState:(SmartKeyConfigStates)config

Parameters

config

The config state of the linked SmartKey as SmartKeyConfigStates value

See Also

Declared In

SKManager.h

– SKManagerDidUpdateBatteryLevel:

Invoked due to the execution of a read battery level request.

- (void)SKManagerDidUpdateBatteryLevel:(uint8_t)level

Parameters

level

The battery level of the linked SmartKey represented as a uint8_t value: 0% - 100%

See Also

Declared In

SKManager.h

Configuration

– SKManagerDidFinishConfiguration:

Invoked when the configuration which has been triggered by the invocation of one of the configuration methods is done.

- (void)SKManagerDidFinishConfiguration:(BOOL)successful

Parameters

successful

Indicates whether the configuration has been done successfully or not. If its succeeded the value is true otherwise, if the configuration has failed, the value will be false.

See Also

Declared In

SKManager.h

Authentication

– SKManagerDidUpdateAuthenticationState:

Invoked when the SKManager successfully authenticated with the linked SmartKey.

- (void)SKManagerDidUpdateAuthenticationState:(SKManagerAuthenticationStates)state

Parameters

state

The new authentication state

Discussion

The authentication is different with the three security levels.

  • Convenience-Mode: The authentication is successful when the SKManager located the SmartKey as result of a requestSmartKey: search interval.
  • Pairing-Mode: In this mode the authentication must be triggered by the SKManager method initiateAuthenticationChallenge. If the authenticationChallenge succeed the authentication will be granted here.
  • Secure-Mode: In this mode the authentication is a process of multiple steps. It must be triggered by the SKManager method initiateAuthenticationChallenge. If the authenticationChallenge succeed the authentication will be granted here.

See Also

Declared In

SKManager.h

– SKManagerDidDetectModifiedSmartKey:

This method will be invoked when a SmartKey with wrong encryption keys or other configuration flags like the linked one has been detected.

- (void)SKManagerDidDetectModifiedSmartKey:(SmartKey *)sk

Parameters

sk

Representation of the modified SmartKeys

Discussion

If this method is invoked the SKManager still has resetted all the security settings too through the invocation of [SKManager resetSecuritySettings]

Declared In

SKManager.h