|
|
| (7 intermediate revisions by 3 users not shown) |
| Line 1: |
Line 1: |
| − | The Device object (Technically DeviceWrapper, ChildDeviceWrapper and ParentDeviceWrapper) is composed of methods that allow you to interact with the settings and values of a device. This object is available to Apps that have been given access via a device selection input, as child devices of Apps and other devices and a driver also has access to this via the device object.
| |
| | | | |
| − | ===<code>events</code>===
| + | <big>'''We're moving!''' Please visit http://docs2.hubitat.com for the latest documentation.</big> |
| − | :Retrieve a list of events for the device. By default the maximum number of events returned in the list is 10 which can be overridden by the max option.
| |
| | | | |
| − | :;Signature
| + | <big> |
| − | :: <code>List<Event> events()</code>
| + | This document is available at: http://docs2.hubitat.com/en/developer/device-object |
| − | :: <code>List<Event> events(Map options)</code> | + | </big> |
| − | | |
| − | :;Parameters
| |
| − | ::options - Optional values for getting the list of events. Possible values:
| |
| − | :::''max'' - The maximum number of events to retrieve.
| |
| − | | |
| − | :;Returns
| |
| − | ::List of Event objects for the device
| |
| − | | |
| − | | |
| − | ===<code>eventsSince</code>===
| |
| − | :Retrieve a list of events since a date/time.
| |
| − | | |
| − | :;Signature
| |
| − | :: <code>List<Event> eventsSince(Date startDate)</code>
| |
| − | :: <code>List<Event> eventsSince(Date startDate, Map options)</code>
| |
| − | | |
| − | :;Parameters
| |
| − | :: startDate - The date/time to list events since.
| |
| − | ::options - Optional values for getting the list of events. Possible values:
| |
| − | :::''max'' - The maximum number of events to retrieve.
| |
| − | | |
| − | :;Returns
| |
| − | ::A list of Events (defaults to 10 events unless otherwise specified in options)
| |
| − | | |
| − | :;Examples
| |
| − | | |
| − | // Get events since 8:00 am today
| |
| − | def events = eventsSince(timeToday("08:00"))
| |
| − | | |
| − | // Get a maximum of 5 events
| |
| − | def events = eventsSince(timeToday("08:00"), [max:5])
| |
| − | | |
| − | ===<code>getName</code>===
| |
| − | :Retrieve the name of the device.
| |
| − | | |
| − | :;Signature
| |
| − | :: <code>String getName()</code>
| |
| − | | |
| − | :;Parameters
| |
| − | :: none
| |
| − | | |
| − | :;Returns
| |
| − | ::String - The name of the device
| |
| − | | |
| − | ===<code>setName</code>===
| |
| − | :Update the name of the device.
| |
| − | | |
| − | :;Signature
| |
| − | :: <code>void setName(String name)</code>
| |
| − | | |
| − | :;Parameters
| |
| − | ::name - the new name for the device.
| |
| − | | |
| − | :;Returns
| |
| − | ::none
| |
| − | | |
| − | ===<code>getLabel</code>===
| |
| − | :Retrieve the label of the device.
| |
| − | | |
| − | :;Signature
| |
| − | :: <code>String getLabel()</code>
| |
| − | | |
| − | :;Parameters
| |
| − | :: none
| |
| − | | |
| − | :;Returns
| |
| − | ::String - The label of the device
| |
| − | | |
| − | ===<code>setLabel</code>===
| |
| − | :Update the label of the device.
| |
| − | | |
| − | :;Signature
| |
| − | :: <code>void setLabel(String label)</code>
| |
| − | | |
| − | :;Parameters
| |
| − | ::label - the new label for the device.
| |
| − | | |
| − | :;Returns
| |
| − | ::none
| |
| − | | |
| − | ==<code>Additional to be documented</code>==
| |
| − | List<Event> eventsBetween(Date startDate, Date endDate)
| |
| − | List<Event> eventsBetween(Date startDate, Date endDate, Map options = null)
| |
| − | List<State> statesSince(String attributeName, Date startDate)
| |
| − | List<State> statesSince(String attributeName, Date startDate, Map options = null)
| |
| − | void sendEvent(Map properties)
| |
| − | void updateSetting(String name, Map options)
| |
| − | void updateSetting(String name, Long value)
| |
| − | void updateSetting(String name, Boolean value)
| |
| − | void updateSetting(String name, String value)
| |
| − | void updateSetting(String name, Double value)
| |
| − | void updateSetting(String name, Date value)
| |
| − | void updateSetting(String name, List value)
| |
| − | void removeSetting(String name)
| |
| − | void clearSetting(String name)
| |
| − | Long getIdAsLong()
| |
| − | String getId()
| |
| − | String getEndpointId()
| |
| − | String getZigbeeId()
| |
| − | Hub getHub()
| |
| − | Map getData()
| |
| − | void updateDataValue(String name, String value)
| |
| − | String getDataValue(String name)
| |
| − | String getDeviceDataByName(String name)
| |
| − | String getStatus()
| |
| − | String getDisplayName()
| |
| − | void setDisplayName(String displayName)
| |
| − | String getDeviceNetworkId()
| |
| − | void setDeviceNetworkId(String dni)
| |
| − | Object currentValue(String attributeName)
| |
| − | Object currentValue(String attributeName, boolean skipCache)
| |
| − | State currentState(String attributeName)
| |
| − | State currentState(String attributeName, boolean skipCache)
| |
| − | Object latestValue(String attributeName)
| |
| − | Object latestValue(String attributeName, boolean skipCache)
| |
| − | State latestState(String attributeName)
| |
| − | State latestState(String attributeName, boolean skipCache)
| |
| − | List<State> getCurrentStates()
| |
| − | List<Command> getSupportedCommands()
| |
| − | List<Attribute> getSupportedAttributes()
| |
| − | List<Capability> getCapabilities()
| |
| − | Boolean hasCommand(String command)
| |
| − | Boolean hasAttribute(String attribute)
| |
| − | Boolean hasCapability(String capability)
| |
| − | Date getLastActivity()
| |
| − | Long getParentDeviceId()
| |
| − | Long getParentAppId()
| |
| − | Boolean getIsComponent()
| |
| − | boolean isDisabled()
| |
