DoorLockTrait.Attributes

@Generated(value = ["GoogleHomePlatformCodegen"])
interface DoorLockTrait.Attributes : ClusterStruct

Known direct subclasses
DoorLock

API for the DoorLock trait.


Attributes for the DoorLock cluster.

Summary

Public functions

open StructDescriptor

Returns the descriptor for the struct.

open Any?

Returns the value of the field for the given tag ID.

Public properties

List<UInt>

A list of client-generated commands which are supported by this cluster server instance.

Boolean?

Indicates whether the lock is able to process remote Lock, Unlock, or Unlock with Timeout commands.

UByte?
List<ByteArray>?
ByteArray?
ByteArray?
ByteArray?
ByteArray?
List<ByteArray>?
List<UInt>

A list of the attribute IDs of the attributes supported by the cluster instance.

UInt?

The number of seconds to wait after unlocking a lock before it automatically locks again.

UShort

The revision of the server cluster specification supported by the cluster instance.

DoorLockTrait.DlCredentialRuleMask?

Bitmap which indicates which credential rules are supported by the door lock.

DoorLockTrait.DlDefaultConfigurationRegister?

The default settings for the door lock device.

UInt?

The number of door closed events that have occurred since it was last zeroed.

UInt?

The number of door opened events that have occurred since it was last zeroed.

DoorLockTrait.DoorStateEnum?

The current door state as defined in DoorStateEnum.

Boolean?

Enables or disables an inside LED that allows the user to see at a glance if the door is locked.

Boolean?

Enable or disable local programming of certain features, as enumerated in the localProgrammingFeatures attribute.

Boolean?

Enables or disables the ability to lock the door lock with a single touch on the door lock.

Boolean?

Enable or disable a button inside the door that is used to put the lock into privacy mode.

UShort?

The number of minutes a PIN, RFID, fingerprint, or other credential associated with a user of type ExpiringUser remains valid after its first use before expiring.

DoorLockTrait.Feature

Whether the server supports zero or more optional cluster features.

List<UInt>

A list of server-generated commands (server to client) which are supported by this cluster server instance.

String?

The language used for the user interface.

UByte?

The settings for the LED support three different modes.

DoorLockTrait.DlLocalProgrammingFeatures?

The local programming features that are disabled when the enableLocalProgramming attribute is set to false.

DoorLockTrait.DlLockState?

Indicates the current state of the lock.

DoorLockTrait.DlLockType?

The type of lock.

UByte?

The maximum length in bytes of a PIN Code on this device.

UByte?

The maximum length in bytes of a RFID Code on this device.

UByte?

The minimum length in bytes of a PIN Code on this device.

UByte?

The minimum length in bytes of a RFID Code on this device.

UShort?
UShort?
UByte?

The number of credentials that could be assigned for each user.

UByte?

The number of holiday schedules supported for the door lock device.

UShort?

The number of PIN users supported.

UShort?

The number of RFID users supported.

UShort?

Number of total users supported by the lock.

UByte?

The number of configurable week day schedules supported per user.

UByte?

The number of configurable year day schedules supported per user.

UShort?

This attribute holds the number of minutes the door has been open since the last time it transitioned from closed to open.

DoorLockTrait.OperatingModeEnum?

The current operating mode of the lock.

Boolean?

true if the door lock server requires that an optional PINs be included in the payload of remote lock operation events like Lock, Unlock, Unlock with Timeout and Toggle in order to function.

Boolean?

true if it is ok for the door lock to send PINs over the air.

UByte?

Has one of four possible settings:

  • 0 - Silent Mode
  • 1 - Low Volume
  • 2 - High Volume
  • 3 - Medium Volume

DoorLockTrait.DlSupportedOperatingModes?

Indicates which operating modes are supported by the lock.

UByte?

The number of seconds that the lock shuts down following wrong code entry.

UByte?

The number of incorrect credential attempts allowed before the lock enters the lockout state.

Public functions

getDescriptor

@HomeExperimentalGenericApi
open fun getDescriptor(): StructDescriptor

Returns the descriptor for the struct.

getFieldValueById

@HomeExperimentalGenericApi
open fun getFieldValueById(tagId: UInt): Any?

Returns the value of the field for the given tag ID.

Public properties

acceptedCommandList

val acceptedCommandList: List<UInt>

A list of client-generated commands which are supported by this cluster server instance.

actuatorEnabled

val actuatorEnabled: Boolean?

Indicates whether the lock is able to process remote Lock, Unlock, or Unlock with Timeout commands.

Access type: Read

aliroBleAdvertisingVersion

val aliroBleAdvertisingVersion: UByte?

aliroExpeditedTransactionSupportedProtocolVersions

val aliroExpeditedTransactionSupportedProtocolVersions: List<ByteArray>?

aliroGroupResolvingKey

val aliroGroupResolvingKey: ByteArray?

aliroReaderGroupIdentifier

val aliroReaderGroupIdentifier: ByteArray?

aliroReaderGroupSubIdentifier

val aliroReaderGroupSubIdentifier: ByteArray?

aliroReaderVerificationKey

val aliroReaderVerificationKey: ByteArray?

aliroSupportedBleUwbProtocolVersions

val aliroSupportedBleUwbProtocolVersions: List<ByteArray>?

attributeList

val attributeList: List<UInt>

A list of the attribute IDs of the attributes supported by the cluster instance.

autoRelockTime

val autoRelockTime: UInt?

The number of seconds to wait after unlocking a lock before it automatically locks again. 0 = disabled.

Access type: Write

clusterRevision

val clusterRevision: UShort

The revision of the server cluster specification supported by the cluster instance.

credentialRulesSupport

val credentialRulesSupport: DoorLockTrait.DlCredentialRuleMask?

Bitmap which indicates which credential rules are supported by the door lock. Valid values are defined by DlCredentialRuleMask.

Access type: Read

defaultConfigurationRegister

val defaultConfigurationRegister: DoorLockTrait.DlDefaultConfigurationRegister?

The default settings for the door lock device. Valid values are defined by DlDefaultConfigurationRegister.

Access type: Read

doorClosedEvents

val doorClosedEvents: UInt?

The number of door closed events that have occurred since it was last zeroed.

Access type: Write

doorOpenEvents

val doorOpenEvents: UInt?

The number of door opened events that have occurred since it was last zeroed.

Access type: Write

doorState

val doorState: DoorLockTrait.DoorStateEnum?

The current door state as defined in DoorStateEnum.

Access type: Read

enableInsideStatusLed

val enableInsideStatusLed: Boolean?

Enables or disables an inside LED that allows the user to see at a glance if the door is locked.

Access type: Write

enableLocalProgramming

val enableLocalProgramming: Boolean?

Enable or disable local programming of certain features, as enumerated in the localProgrammingFeatures attribute. When set to true, local programming is enabled on the door lock for all features. Otherwise, local programming is disabled for those features whose bit is set to 0 in the localProgrammingFeatures attribute.

Access type: Write

enableOneTouchLocking

val enableOneTouchLocking: Boolean?

Enables or disables the ability to lock the door lock with a single touch on the door lock.

Access type: Write

enablePrivacyModeButton

val enablePrivacyModeButton: Boolean?

Enable or disable a button inside the door that is used to put the lock into privacy mode. When the lock is in privacy mode it cannot be manipulated from the outside.

Access type: Write

expiringUserTimeout

val expiringUserTimeout: UShort?

The number of minutes a PIN, RFID, fingerprint, or other credential associated with a user of type ExpiringUser remains valid after its first use before expiring.

Access type: Write

featureMap

val featureMap: DoorLockTrait.Feature

Whether the server supports zero or more optional cluster features. A cluster feature is a set of cluster elements that are mandatory or optional for a defined feature of the cluster. If a cluster feature is supported by the cluster instance, then the corresponding bit is set to 1, otherwise the bit is set to 0 (zero).

generatedCommandList

val generatedCommandList: List<UInt>

A list of server-generated commands (server to client) which are supported by this cluster server instance.

language

val language: String?

The language used for the user interface.

Access type: Write

ledSettings

val ledSettings: UByte?

The settings for the LED support three different modes.

  • 0 - Never use LED for signalling events.
  • 1 - Use LED to signal all but access-allowed events.
  • 2 - Use LED to signal all events.

Access type: Write

localProgrammingFeatures

val localProgrammingFeatures: DoorLockTrait.DlLocalProgrammingFeatures?

The local programming features that are disabled when the enableLocalProgramming attribute is set to false. Valid values are defined by DlLocalProgrammingFeatures.

Access type: Write

lockState

val lockState: DoorLockTrait.DlLockState?

Indicates the current state of the lock. Valid values are defined by DlLockState.

Access type: Read

lockType

val lockType: DoorLockTrait.DlLockType?

The type of lock. Valid values are defined by DlLockType.

Access type: Read

maxPinCodeLength

val maxPinCodeLength: UByte?

The maximum length in bytes of a PIN Code on this device.

Access type: Read

maxRfidCodeLength

val maxRfidCodeLength: UByte?

The maximum length in bytes of a RFID Code on this device.

Access type: Read

minPinCodeLength

val minPinCodeLength: UByte?

The minimum length in bytes of a PIN Code on this device.

Access type: Read

minRfidCodeLength

val minRfidCodeLength: UByte?

The minimum length in bytes of a RFID Code on this device.

Access type: Read

numberOfAliroCredentialIssuerKeysSupported

val numberOfAliroCredentialIssuerKeysSupported: UShort?

numberOfAliroEndpointKeysSupported

val numberOfAliroEndpointKeysSupported: UShort?

numberOfCredentialsSupportedPerUser

val numberOfCredentialsSupportedPerUser: UByte?

The number of credentials that could be assigned for each user.

Access type: Read

numberOfHolidaySchedulesSupported

val numberOfHolidaySchedulesSupported: UByte?

The number of holiday schedules supported for the door lock device.

Access type: Read

numberOfPinUsersSupported

val numberOfPinUsersSupported: UShort?

The number of PIN users supported.

Access type: Read

numberOfRfidUsersSupported

val numberOfRfidUsersSupported: UShort?

The number of RFID users supported.

Access type: Read

numberOfTotalUsersSupported

val numberOfTotalUsersSupported: UShort?

Number of total users supported by the lock.

Access type: Read

numberOfWeekDaySchedulesSupportedPerUser

val numberOfWeekDaySchedulesSupportedPerUser: UByte?

The number of configurable week day schedules supported per user. Week day schedules are used to restrict access to a specified time window on certain days of the week. The schedule is repeated each week.

Access type: Read

numberOfYearDaySchedulesSupportedPerUser

val numberOfYearDaySchedulesSupportedPerUser: UByte?

The number of configurable year day schedules supported per user. Year day schedules are used to restrict access to a specified date and time window.

Access type: Read

openPeriod

val openPeriod: UShort?

This attribute holds the number of minutes the door has been open since the last time it transitioned from closed to open.

Access type: Write

operatingMode

val operatingMode: DoorLockTrait.OperatingModeEnum?

The current operating mode of the lock. Valid values are defined by OperatingModeEnum.

Access type: Write

requirePinforRemoteOperation

val requirePinforRemoteOperation: Boolean?

true if the door lock server requires that an optional PINs be included in the payload of remote lock operation events like Lock, Unlock, Unlock with Timeout and Toggle in order to function.

Access type: Write

sendPinOverTheAir

val sendPinOverTheAir: Boolean?

true if it is ok for the door lock to send PINs over the air.

Access type: Write

soundVolume

val soundVolume: UByte?

Has one of four possible settings:

  • 0 - Silent Mode
  • 1 - Low Volume
  • 2 - High Volume
  • 3 - Medium Volume

Access type: Write

supportedOperatingModes

val supportedOperatingModes: DoorLockTrait.DlSupportedOperatingModes?

Indicates which operating modes are supported by the lock. Valid values are defined by DlSupportedOperatingModes.

Access type: Read

userCodeTemporaryDisableTime

val userCodeTemporaryDisableTime: UByte?

The number of seconds that the lock shuts down following wrong code entry. The valid range is 1-255.

Access type: Write

wrongCodeEntryLimit

val wrongCodeEntryLimit: UByte?

The number of incorrect credential attempts allowed before the lock enters the lockout state. The valid range is 1-255.

Access type: Write