Transition Trait (tran)

Smooth value transitions.

AttributeValue
Idtag:google.com,2018:m2m:traits:transition:v1:v0#r0
Short-Idtran
Has-Childrenno

This trait is implemented by things that support smooth transitions for some properties. Only properties in the state section can be transitioned smoothly.

State Properties

NameKeyRWReqDescription
Durations/tran/dXXXTransition duration, in seconds
Speeds/tran/spXXTransition duration, in percentage of maximum speed

s/tran/d : Duration

Transition duration, in seconds.

AttributeValue
Value Typenullable real number
FlagsREQ, RW, VOLATILE, NO_TRANS

When updated simultaneously with other state changes, it indicates the duration of the transition between the old state and the specified state. When read it indicates the time remaining in the current transition. The current transition can be halted by setting this to zero. Sometimes physical limitations will force a minimum duration that is longer than specified. The maximum value that is required to be supported is 604800, or one week. The resolution must be at or below one tenth of a second for durations of less than one hour.

s/tran/sp : Speed

Transition duration, in percentage of maximum speed.

AttributeValue
Value Typenullable percentage (0.0-1.0)
FlagsEXPERIMENTAL, RW, VOLATILE, NO_TRANS

This is an alternative to specifying the duration of a transition for Things where certain properties cannot be physically transitioned faster than a certain speed. The units of this property are a percentage of full speed. The implementation SHOULD allow this parameter to be adjusted as the transition is occurring. This property SHOULD NOT be implemented unless it makes sense for the underlying hardware.

Metadata Properties

NameKeyRWReqDescription
TraitURIm/tran/turiXXThe URI that uniquely identifies the specification used to implement this trait.

m/tran/turi : TraitURI

The URI that uniquely identifies the specification used to implement this trait.

AttributeValue
Value TypeURI-reference
FlagsCONST, REQ