# OtaSoftwareUpdateRequestorTrait.ChangeReasonEnum

# OtaSoftwareUpdateRequestorTrait.ChangeReasonEnum


```
enum OtaSoftwareUpdateRequestorTrait.ChangeReasonEnum : Enum, ClusterEnum
```

<br />

|---|---|---|
| [kotlin.Any](https://kotlinlang.org/api/latest/jvm/stdlib/kotlin/-any/index.html) |||
| ↳ | [kotlin.Enum](https://kotlinlang.org/api/latest/jvm/stdlib/kotlin/-enum/index.html) ||
|   | ↳ | [com.google.home.matter.standard.OtaSoftwareUpdateRequestorTrait.ChangeReasonEnum](https://developers.home.google.com/reference/kotlin/com/google/home/matter/standard/OtaSoftwareUpdateRequestorTrait.ChangeReasonEnum) |

*** ** * ** ***

The reason for an OTA change.

## Summary

| ### Enum Values |
|---|---|
| `https://developers.home.google.com/reference/kotlin/com/google/home/matter/standard/OtaSoftwareUpdateRequestorTrait.ChangeReasonEnum#DelayByProvider` | The OTA provider requests the client to wait. |
| `https://developers.home.google.com/reference/kotlin/com/google/home/matter/standard/OtaSoftwareUpdateRequestorTrait.ChangeReasonEnum#Failure` | A prior operation failed. |
| `https://developers.home.google.com/reference/kotlin/com/google/home/matter/standard/OtaSoftwareUpdateRequestorTrait.ChangeReasonEnum#Success` | A prior operation succeeded. |
| `https://developers.home.google.com/reference/kotlin/com/google/home/matter/standard/OtaSoftwareUpdateRequestorTrait.ChangeReasonEnum#TimeOut` | A timeout occurred. |
| `https://developers.home.google.com/reference/kotlin/com/google/home/matter/standard/OtaSoftwareUpdateRequestorTrait.ChangeReasonEnum#Unknown` | An unknown reason. |
| `https://developers.home.google.com/reference/kotlin/com/google/home/matter/standard/OtaSoftwareUpdateRequestorTrait.ChangeReasonEnum#UnknownValue` | The enum value is out of range. |

| ### Public functions |
|---|---|
| `https://kotlinlang.org/api/latest/jvm/stdlib/kotlin/-string/index.html` | `@https://developers.home.google.com/reference/kotlin/com/google/home/annotation/HomeExperimentalGenericApi https://developers.home.google.com/reference/kotlin/com/google/home/matter/standard/OtaSoftwareUpdateRequestorTrait.ChangeReasonEnum#toDescription()()` |
| `https://developers.home.google.com/reference/kotlin/com/google/home/matter/standard/OtaSoftwareUpdateRequestorTrait.ChangeReasonEnum` | `https://developers.home.google.com/reference/kotlin/com/google/home/matter/standard/OtaSoftwareUpdateRequestorTrait.ChangeReasonEnum#valueOf(kotlin.String)(value: https://kotlinlang.org/api/latest/jvm/stdlib/kotlin/-string/index.html)` Returns the enum constant of this type with the specified name. |
| `https://kotlinlang.org/api/latest/jvm/stdlib/kotlin/-array/index.html<https://developers.home.google.com/reference/kotlin/com/google/home/matter/standard/OtaSoftwareUpdateRequestorTrait.ChangeReasonEnum>` | `https://developers.home.google.com/reference/kotlin/com/google/home/matter/standard/OtaSoftwareUpdateRequestorTrait.ChangeReasonEnum#values()()` Returns an array containing the constants of this enum type, in the order they're declared. |

| ### Public properties |
|---|---|
| `https://developers.home.google.com/reference/kotlin/kotlin/enums/EnumEntries<https://developers.home.google.com/reference/kotlin/com/google/home/matter/standard/OtaSoftwareUpdateRequestorTrait.ChangeReasonEnum>` | `https://developers.home.google.com/reference/kotlin/com/google/home/matter/standard/OtaSoftwareUpdateRequestorTrait.ChangeReasonEnum#entries()` Returns a representation of an immutable list of all enum entries, in the order they're declared. |
| `open https://kotlinlang.org/api/latest/jvm/stdlib/kotlin/-string/index.html` | `https://developers.home.google.com/reference/kotlin/com/google/home/matter/standard/OtaSoftwareUpdateRequestorTrait.ChangeReasonEnum#traitId()` Trait identifier of the Matter Cluster that defines the enum Data Type. |
| `open https://kotlinlang.org/api/latest/jvm/stdlib/kotlin/-string/index.html` | `https://developers.home.google.com/reference/kotlin/com/google/home/matter/standard/OtaSoftwareUpdateRequestorTrait.ChangeReasonEnum#typeName()` Name of the Matter Data Type that the enum belongs to, in UpperCamelCase, e.g. "AlarmCodeEnum" from Door Lock Cluster. |
| `open https://kotlinlang.org/api/latest/jvm/stdlib/kotlin/-u-long/index.html` | `https://developers.home.google.com/reference/kotlin/com/google/home/matter/standard/OtaSoftwareUpdateRequestorTrait.ChangeReasonEnum#value()` Integer identifier of the enum value per the Matter Application Clusters spec, e.g. 1 for Door Lock Cluster AlarmCodeEnum.LockFactoryReset. |

## Enum Values

### DelayByProvider

```
val OtaSoftwareUpdateRequestorTrait.ChangeReasonEnum.DelayByProvider: OtaSoftwareUpdateRequestorTrait.ChangeReasonEnum
```

The OTA provider requests the client to wait.

### Failure

```
val OtaSoftwareUpdateRequestorTrait.ChangeReasonEnum.Failure: OtaSoftwareUpdateRequestorTrait.ChangeReasonEnum
```

A prior operation failed.

### Success

```
val OtaSoftwareUpdateRequestorTrait.ChangeReasonEnum.Success: OtaSoftwareUpdateRequestorTrait.ChangeReasonEnum
```

A prior operation succeeded.

### TimeOut

```
val OtaSoftwareUpdateRequestorTrait.ChangeReasonEnum.TimeOut: OtaSoftwareUpdateRequestorTrait.ChangeReasonEnum
```

A timeout occurred.

### Unknown

```
val OtaSoftwareUpdateRequestorTrait.ChangeReasonEnum.Unknown: OtaSoftwareUpdateRequestorTrait.ChangeReasonEnum
```

An unknown reason.

### UnknownValue

```
val OtaSoftwareUpdateRequestorTrait.ChangeReasonEnum.UnknownValue: OtaSoftwareUpdateRequestorTrait.ChangeReasonEnum
```

The enum value is out of range. For example, a newer Matter cluster definition may support enum values not yet supported by the Home APIs.

## Public functions

### toDescription

```
@HomeExperimentalGenericApi
fun toDescription(): String
```

### valueOf

```
fun valueOf(value: String): OtaSoftwareUpdateRequestorTrait.ChangeReasonEnum
```

Returns the enum constant of this type with the specified name. The string must match exactly an identifier used to declare an enum constant in this type. (Extraneous whitespace characters are not permitted.)

| Throws |
|---|---|
| `https://kotlinlang.org/api/latest/jvm/stdlib/kotlin/-illegal-argument-exception/index.html` | if this enum type has no constant with the specified name |

### values

```
fun values(): Array<OtaSoftwareUpdateRequestorTrait.ChangeReasonEnum>
```

Returns an array containing the constants of this enum type, in the order they're declared.

This method may be used to iterate over the constants.

## Public properties

### entries

```
val entries: EnumEntries<OtaSoftwareUpdateRequestorTrait.ChangeReasonEnum>
```

Returns a representation of an immutable list of all enum entries, in the order they're declared.

This method may be used to iterate over the enum entries.

### traitId

```
open val traitId: String
```

Trait identifier of the Matter Cluster that defines the enum Data Type. Refer to `https://developers.home.google.com/reference/kotlin/com/google/home/matter/serialization/ClusterId#traitId()` for the format.

### typeName

```
open val typeName: String
```

Name of the Matter Data Type that the enum belongs to, in UpperCamelCase, e.g. "AlarmCodeEnum" from Door Lock Cluster.

### value

```
open val value: ULong
```

Integer identifier of the enum value per the Matter Application Clusters spec, e.g. 1 for Door Lock Cluster AlarmCodeEnum.LockFactoryReset.