Changes to the :ref:`thermostatCoolingSetpoint` Capability:
coolingSetpointMin
andcoolingSetpoingMax
attributes replaced withcoolingSetpointRange
.
Changes to the :ref:`thermostatFanMode` Capability:
supportedThermostatFanModes
attribute added.
Changes to the :ref:`thermostatHeatingSetpoint` Capability:
heatingSetpointMin
andheatingSetpointMax
attributes replaced withheatingSetpointRange
.
Changes to the :ref:`thermostatMode` Capability:
supportedThermostatModes
attribute added.
Changes to the :ref:`thermostatSetpoint` Capability:
thermostatSetpointMin
andthermostatSetpointMax
attributes replaced withthermostatSetpointRange
.
Changes to the :ref:`thermostat` Capability:
coolingSetpointMin
andcoolingSetpointMax
attributes replaced withcoolingSetpointRange
.heatingSetpointMin
andheatingSetpointMax
attributes replaced withheatingSetpointRange
.thermostatSetpointMin
andthermostatSetpointMax
attributes replaced withthermostatSetpointRange
.supportedThermostatFanModes
attribute added.supportedThermostatModes
attribute added.
- :ref:`HubAction reference documentation <hubaction_ref>` updated to clarify that
HOST
parameter is part of the headers map.
- Asynchronous HTTP requests now support optional response handler methods. For cases when you just need to make a request, but don't care about the response, just pass
null
for the response handler. Docs updated :ref:`here <async_http_api_ref>`. - Creating a Composite Device Handler? Check out the new :ref:`composite_device_tiles` documentation!
- Some changes and additions to several Capabilities:
getAllActivities()
andgetCurrentActivity()
Commands removed from :ref:`mediaController` Capability.startActivity()
Command updated to accept the ID of the activity, instead of the name.- Optional
coolingSetpointMin
andcoolingSetpointMax
attributes added to the :ref:`thermostatCoolingSetpoint` Capability. - Optional
heatingSetpointMin
andheatingSetpointMax
attributes added to the :ref:`thermostatHeatingSetpoint` Capability. - Optional
thermostatSetpointMin
andthermostatSetpointMax
attributes added to the :ref:`thermostatSetpoint` Capability. - Optional
coolingSetpointMin
,coolingSetpointMax
,heatingSetpointMin
,heatingSetpointMax
,thermostatSetpointMin
, andthermostatSetpointMax
attributes added to the :ref:`thermostat` Capability.
- :ref:`Image capturing and viewing documentation <working_with_camera_photos>` is here! Learn how to store, retrieve, and display images from a LAN- or Cloud-connected camera device.
- Updated :ref:`Rate Limiting documenation <rate_limits>` with new child SmartApp and Device Handler limits, as well as clarify existing rate limits.
- Composite Devices are here! Composite Devices allow developers to better model devices through a parent-child relationship between Device Handlers. Check out the :ref:`documentation <composite-devices>` and leverage this new design pattern for your composite devices!
- SmartThings has a new set of color standards for Device Handler Tiles. The :ref:`tiles_colors` documentation covers all the new color standards.
- Updates to the :ref:`style_guide` and existing documentation to conform to new guidelines.
- Do you have custom LAN device integrations? If so, check out the :ref:`automatic_LAN_device_discovery` documentation to see what (if any) impact this has on your custom code.
- Does your SmartApp or Device Handler need to execute every minute? Instead of writing your own cron expression, use the new :ref:`smartapp_run_every_1_minute`!
- Need to convert color values between hexadecimal and RGB? The :ref:`color_util_ref` class has what you need.
- If you are writing a parent-child SmartApp, check out the :ref:`expanded and clarified documentation <parent_child_smartapp_parent>` for using the
app()
input type. - A new capability, :ref:`bridge`, allows devices to declare they act as a bridge to other devices.
- A new attribute,
held
, has been added to the :ref:`button` capability! - The :ref:`style_guide` has been updated with guidelines for document title and headings capitalization and formatting. If you are a contributor to these docs, make sure you check it out!
- Did you notice? We've updated the :ref:`docs homepage <docs_home_page>` to help readers quickly identify and navigate to common areas of interest.
- Z-Wave fingerprinting updates! The :ref:`zwave-fingerprinting` documentation has been expanded and updated with the latest information.
- Get information about a Device's status and last activity using the new :ref:`device_get_status` and :ref:`device_get_last_activity` methods.
- New to Device Handler development, or looking for a refresher? We've overhauled our :ref:`device-handler-quickstart` to ensure you can get up and running quickly and pain-free.
- Do you use cron to create recurring schedules? Have you seen if you could replace that often-difficult to understand, write, and maintain cron expression with any of our :ref:`runEvery* <schedule_run_every>` methods? We've updated the :ref:`documentation <scheduling_recurring_schedules>` to highlight these methods and encourage their use, instead of using cron.
- Did you know you can copy code examples right to your clipboard? We updated the UX to increase the visibility of this handy feature.
- Search, discover and communicate with the devices in your network with the
HubAction
class. Check out the :ref:`new reference document for HubAction <hubaction_ref>`. - If you need to get the account ID associated with an installed SmartApp, check out the :ref:`isa_ref_get_account_id` method available on the :ref:`installed_smart_app_wrapper` object!
- We've updated the :ref:`editor_and_simulator` guide to clarify that you need to ensure you are on the correct shard when creating SmartApps or Device Handlers.
- A new Capability, :ref:`infraredLevel`, is now available!
- Thinking about setting up a regular on and off schedule for your SmartThings? See our latest update, with examples, in :ref:`schedule_using_cron`.
- Confused about sharding and where to publish your SmartApp or Device Handler? Here is a big picture view that clarifies :ref:`Publishing Custom Code <publishing>`.
- Did you know there's a default delay between commands when you send a sequence of them to the Hub? See :ref:`smartapp_sendhubcommand` reference documentation for details.
- Quick, how do you know what Capabilities are supported by SmartThings? Checkout out the new generated :ref:`capabilities_taxonomy`, now live.
- Don't know much about ZigBee? We got you covered with our updated ZigBee documentation in the :ref:`zigbee_primer` and :ref:`zigbee_ref` guides.
- What you, as a developer, must know while working with the SmartThings IDE. Checkout latest in the :ref:`hubs-and-locations` guide.
- Did you know you can refresh any page of the SmartApp on the mobile device with a set interval? See the :ref:`dynamic-page-options` guide.
- Changed code blocks to use the monokai dark theme.
- Added ability to copy code blocks to the clipboard.
- Added documentation for :ref:`working with time zones <smartapp_timezones>`.
- Fixed warnings related to lexical parsing of code blocks.
- Documented new :ref:`device_ref_model_name` and :ref:`device_ref_manufacturer_name`.
- Styling and organiational changes to the left-hand navigation.
- Internal build error fixes.
- Revised timeTodayAfter() method description in the :ref:`smartapp_ref` Guide
- Added :ref:`smartapp-time-methods` guide to the SmartApp Developers Guide
- Fixed up scheduling reference docs in :ref:`device_handler_ref`, and :ref:`smartapp_ref` Guides
- Clarify getting latest device state in :ref:`device_ref`, and :ref:`smartapp_working_with_devices`
- Corrected timeZone() method description in the :ref:`smartapp_ref` Guide
- Documentation for :ref:`smartapp_nextoccurrence`.
- Documentation for :ref:`smartapp_get_all_child_apps`, :ref:`smartapp_find_all_child_apps_by_name`, :ref:`smartapp_find_all_child_apps_by_namespace_and_name`, :ref:`smartapp_find_child_app_by_namespace_and_name`, and :ref:`smartapp_get_all_child_apps`.
- Updated documentation for :ref:`smartapp_get_child_apps` to reflect that only "complete" child app installations will be returned.
- Changed reference API docs to use getter forms instead of property access.
- New attribute values added for the :ref:`lock` capability.
- Typo fixes and other copy edits.
- Documentation for :ref:`beta asynchronous HTTP APIs <async_http_guide>`
- Typo fixes and other copy edits
- Moved rate limiting documentation into its own :doc:`guide <ratelimits/index>`
- Typo fixes and other copy edits
- Documented :ref:`sms_rate_limits`
- Fixed typos
- Added instructions for creating a simple code example when :ref:`creating a developer support ticket <developer_support_form>`.
- Added :ref:`documentation <custom_remove_button>` for specifying a custom Remove button for preferences.
- Added documentation for :ref:`passing data to schedule handler methods <scheduling_passing_data>`.
- Added :ref:`best practices <review_guidelines_parent_child>` for parent-child relationships.
- Updated the repository's README with pull request guidelines.
- Added scheduling APIs to the :ref:`device_handler_ref` reference documentation (including all
runEvery*
APIs, which are now supported in Device Handlers). - Fixed broken cron tutorial link the :ref:`smartapp-scheduling` guide.
- Added note to the :ref:`first SmartApp tutorial <first-smartapp-tutorial>` and :ref:`editor_and_simulator` that the Simulator is inconsistent with the mobile application.
- Added link to the Z-Wave public spec on the following Z-Wave pages: :ref:`Building Z-Wave Device Handlers <zwave-device-handlers>` and :ref:`Z-Wave Primer <zwave-primer>`
- Updated the :ref:`Color Control <colorControl>` capability to correctly reflect the capability definition.
- Updated Jinja template to add some more features for the ongoing generated capability documentation project.
- Fixed minor grammatical errors.
- Update to the :ref:`State and Atomic State documentation <storing-data>` to reorganize, clarify, and expand content.
- Removed Occupancy capability
- Fixed :ref:`smartapp_unschedule` docs to clarify that a specific handler method name can be passed to
unschedule()
.
- Fixing RTD build
- Fixing RTD build
- Typos and spelling fixes
- Added more around the generated capabilities documentation framework
- Added :ref:`web_services_smartapps_troubleshooting` document to the SmartApp Web Services guide
- Fixed :ref:`colorControl` example code in the capabilities reference
- Fix :ref:`documentation <smartapp_subscribe_to_command>` for
subscribeToCommand()
(only takes a Device argument, not a list of Devices) - Typos and spelling fixes
- :ref:`Documentation <logging_exceptions>` for the ability to pass a
Throwable
to logging methods to get more logging details about the exception shown in the logs.
- Make edits to Makefile as a first step in getting generated capabilities documentation integrated into the documentation build.
- Added :ref:`zigbee_parse_zone_status` documentation
- Added documentation for :ref:`zigbee_additional_zigbee_classes`
- Clarified :ref:`smartapp_find_child_app_by_name` API documentation
- Added :doc:`documentation <device-type-developers-guide/other-available-apis>` to Device Handler Guide for other useful APIs available to Device Handlers, including Scheduling, HTTP Requests, and State.
- Fixed documentation for :ref:`Event.dateValue <event_date_value>` to indicate that it returns
null
if date cannot be parsed - Various fixes for reStructuredText formatting and legal syntax warnings
- Moved this documentation change log to top of navigation
- Document the new :ref:`hideWhenEmpty <prefs_hide_when_empty>` preferences option.
- Add a strong warning to the :ref:`State documentation <storing-data>` to emphasize the importance of never mixing
atomicState
andstate
in the same SmartApp.
- :ref:`Documented <webservices_smartapp_enable_oauth>` the new redirect URI field on OAuth SmartApps
- Added documentation for working with collections in :ref:`State <state_collections>` and :ref:`Atomic State <atomic_state_collections>`.
- Added documentation for :doc:`ref-docs/app-state-ref`
- Added documentation for :doc:`ref-docs/installed-smart-app-wrapper-ref`
- Added :ref:`clarification <run_api_smartapp_simulator>` that the callable URL for Web Services SmartApps will vary by installed location
- Updated developer call schedule
- Splitting the Music Player capability into three capabilities
- Audio Notification
- Music Player
- Tracking Music Player
- Adding :doc:`Code Review Guidelines and Best Practices <code-review-guidelines>` for SmartApps and Device Handlers.
- Fix spelling of "capability" in :ref:`attribute_ref` docs
- Fix capitalization of "localIP" in :ref:`hub_ref` docs
- Document the :ref:`developer_support_form` form
- Document :doc:`Device Handler Preferences <device-type-developers-guide/device-preferences>`
- Document :ref:`device-specific preference inputs <device_specific_inputs>`
- Clarify :doc:`tools-and-ide/github-integration` only available in the US
- Add
additionalParams
argument for ZigBee library. :doc:`Docs <ref-docs/zigbee-ref>` | GitHub PR
- Updated and expanded Device Handler tiles docs. :doc:`Docs <device-type-developers-guide/tiles-metadata>` | GitHub PR.