Smartthings schema connector

Using SmartApp tokens

When SmartThings sends a request to your SmartApp for the INSTALL, UPDATE, and EVENT lifecycles, it includes an authorization token on the request body.
The authorization token has its OAuth scopes defined as below.

OAuth scopes for SmartApp token

The scopes for a SmartApp token are derived from the following steps:

  1. When you create a SmartApp, you must also ensure that a set of OAuth scopes are whitelisted for your SmartApp. These whitelisted scopes are what your SmartApp may request during the installation process.

    NOTE : The SmartThings Developer Workspace will require you to select a set of OAuth scopes to be whitelisted for your SmartApp.

  2. In your SmartApp, during the INITIALIZE phase of the CONFIGURATION lifecycle, you specify any non-entity-specific permissions your SmartApp requires. Entity-specific permissions, such as device-specific permissions, are handled by the DEVICE setting. The permissions requested must be present in the whitelist defined in step 1).

  3. The specific OAuth scopes for an installation are then created from the requested permissions in 1) and 2) above.

Whitelisting OAuth scopes

NOTE : Whether you are using Developer Workspace or working on the command line, you are required to explicitly select a set of OAuth scopes to be whitelisted for your SmartApp.

Setting and updating the whitelisted OAuth scopes

To explicitly whitelist the OAuth scopes or to update the OAuth scopes, which may be requested by your SmartApp, make a request to the API (), using a personal access token (the token must have the permission).

The example below shows a request to update a SmartApp’s OAuth settings. In this example the SmartApp will be able to request permissions to read and execute commands on devices, as well as read and write schedules.
You should replace the values with those required for your SmartApp.

Step 3: Create a Device Handler in the IDE

A Device Handler is a representation of a physical device in the SmartThings platform. It is responsible for communicating between the actual device and the SmartThings platform.

  1. Under «My Device Handlers», click «Create a New Device Handler».
  2. In the From Template tab, select the protocol (Zigbee Home Automation or 3.0; Zigbee Light Link ; Z-Wave) and capabilities that correspond to your device.
    • If there is no Device Handler match (i.e. a New Device Handler Form is created), we recommend creating a Device Handler From Example. See below.
    • If there is a Device Handler match, the corresponding Device Handler is shown. Enter the required fields to create a unique fingerprint for your device. Required fields may include: Manufacturer Name/ID, Product ID, Model Name/ID, Device Join Name, Namespace, Device Handler Name.
  3. Click the «Update Existing Device Handler» or «Create» button. You will see the template code.
  4. Click «Save». Then click «Publish» and «For Me» to publish this Device Handler in your account.

NOTE : We recommend using an existing Device Handler whenever possible. This allows you to add or remove a fingerprint for your device.

There are two other ways to create a Device Handler in the IDE:

  • From Code: Copy the Groovy code from an existing Device Handler in the SmartThingsPublic repo and paste it in the empty field in the IDE.
  • From Example: Select an existing Device Handler from this tab in the IDE.

Views

There are three main views of a device in the SmartThings app.

Detail View

This describes what the device will look like once the device card is tapped, and the device is being displayed full screen.

Automation View

The automation section describes how the process for setting up an automation for a device will look. This includes which UI elements will be used for the «if» () part of the automation, as well is the «then» () part.

States

Within the context of device configurations, states override the formatted state strings as defined in the capability presentation . This allows devices to have state strings that are relevant to their particular device integration.

Actions

Similar to Device Configuration states, actions here are meant as overrides to the underlying capability presentation values that the device is referencing

Conditions

Conditions define states that will trigger automations to fire. These can be defined within capability presentations, but overridden here if a device wishes to deviate from that definition in some way.
See capability presentation conditions

Light

Set light value

Bixby Commands Examples Capabilities
Change the / dimming level to «Change the light bulb dimming level to 25»
Maximize/Minimize the brightness of the / «Maximize the brightness of the light» «Minimize the brightness of the light»

Dim / Brighten by a certain percentage

Bixby Commands Examples Capabilities
Dim the / by 50% «Dim the light name by 50%»
Brighten the / by 50% «Brighten the light by 50%»

Change the color

Bixby Commands Examples Capabilities
Change the / color to «Change the light color to Blue»

Check status

Bixby Commands Examples Capabilities
Check the dimming level of the / «Check the dimming level of the light bulb»

Cloud Connector

You will set up a Connector to handle the interaction types. This Connector can be a WebHook endpoint or AWS Lambda function.

Option 1: AWS Lambda

NOTE : Lambdas for SmartThings Schema must be deployed in one of the following regions, based on your availability:

  • ap-northeast-1 (Tokyo)
  • us-east-1 (N. Virginia)
  • eu-west-1 (Ireland)

Example

Create a new Lambda function at https://aws.amazon.com. Select Author from Scratch for your Lambda function.

Enter the following details for your new Lambda function:

  • Name: «demoSTSchema» (to follow our example)
  • Runtime: «Node.js» (we used version 8.10)
  • Role: Create a new role
  • Role Name: «demoSTSchema»
  • Click Create function

ARN for your Lambda function

Locate the ARN after creating your Lambda function. It will look like the below example:

You will provide the ARN to SmartThings when in Developer Workspace.

Provide SmartThings permissions to your Lambda function

Using the AWS CLI, give SmartThings permissions to access your Lambda function.

Run the following command:

  • is your named profile for your CLI. See documentation.
  • is the Lambda function we just created.
  • 148790070172 is the SmartThings account you are granting permissions to.

Cloud Connector code

Use the following example code for your AWS Lambda. The code includes generic responses for SmartThings interaction requests.

Paste and save this into the file.

is a package published to npm by SmartThings. Download the package using .

Save the index.js file.

See the example instructions .

Приложение

Делаем своё устройство совместимым со SmartThings

  • Основное преимущество – увеличение ценности продукта благодаря автоматической интеграции со всей экосистемой.
  • При условии прохождения функционального тестирования, вы можете наклеить на коробочку продукта лого: «Совместимо со SmartThings»,  тем самым вы гарантируете беспроблемную установку и настройку устройства в экосистеме SmartThings.
  • Как и с любой платформой, ваша задача облегчается: вам уже не нужно стараться и разрабатывать, к примеру, пользовательский интерфейс – вы можете воспользоваться стандартными кнопками и прочими элементами интерфейса SmartThings.
  • Вы получаете пиар и аудиторию пользователей благодаря коммьюнити SmartThings (оно живое и активное).

Приложение: SmartThings или SmartThings Classic?

После того, как вы включили свой хаб, пришло время подумать о приложении SmartThings, и здесь нам нужно прояснить небольшую путаницу … Прежде чем мы проясним разницу между этими приложениями, мы заявим, что пользовательский интерфейс оставляет желать лучшего. что бы вы ни выбрали. Это разочарование, и мы не можем его скрыть. В самом деле, мы сделаем еще один шаг и предположим, что SmartThings – действительно не лучшая платформа для тех, кто отдаленно не интересуется технологиями, или для новичков в умном доме. Ситуация улучшается, но предполагается определенный уровень технического интеллекта. Исходное приложение все еще работает, и теперь оно было переименовано в SmartThings Classic. Компания Samsung взяла свое собственное приложение Connect и переименовала его в SmartThings. Так…

  • Новое приложение: SmartThings
  • Старое приложение: SmartThings Classic

Не говоря уже о путанице с названием, которое теперь должно быть понятным, это старое раздутое приложение объединяет не менее 40 приложений для умного дома от Samsung под одним зонтом. Очевидно, это не способствует оптимальному взаимодействию с пользователем. Значит, с новым приложением все хорошо? Нет, не совсем! В то время как процедуры и автоматизация – подробнее об этом в свое время – несомненно, были улучшены, основная проблема заключается в использовании приложения на любых устройствах, кроме телефонов Samsung. Если у вас есть один из них, вам повезло. С другой стороны, если вы владелец iPhone, вы, скорее всего, обнаружите ряд сбоев и вялую работу, которые, вероятно, заставят вас броситься на одеяло безопасности SmartThings Classic. Хотя мы уверены, что над этим ведутся работы, на данный момент вы можете найти новое приложение SmartThings на устройствах Apple проблематичным. С другой стороны, После того, как вы настроены и работаете, новое приложение, как правило, становится интуитивно понятным, хотя оно достаточно отличается от SmartThings Classic, и вам захочется потратить немного времени на ознакомление с настройками, действиями и условиями. Настроить в приложении очень просто, так что Samsung здесь все хорошо. После проверки, чтобы убедиться, что ваш хаб полностью обновлен, он просканирует, чтобы найти совместимые устройства. После подключения вы просто переходите на главную панель инструментов для управления. Легче не становится. Какие устройства имеет смысл добавить в вашу экосистему SmartThings? После проверки, чтобы убедиться, что ваш хаб полностью обновлен, он просканирует, чтобы найти совместимые устройства. После подключения вы просто переходите на главную панель инструментов для управления. Легче не становится. Какие устройства имеет смысл добавить в вашу экосистему SmartThings? После проверки, чтобы убедиться, что ваш хаб полностью обновлен, он просканирует, чтобы найти совместимые устройства. После подключения вы просто переходите на главную панель инструментов для управления. Легче не становится. Какие устройства имеет смысл добавить в вашу экосистему SmartThings?

Тонкости, о которых вам следует знать

Советую обратить внимание вот на это:

  1. Для работы нужно чтобы устройства подключены к вай фай сети.
  2. Управление устройствами приложением SmartThings возможно при наличии регистрации всех устройств в учетке Samsung Account.
  3. Функциональность может меняться в зависимости от типа устройства, страны, телефона, версии приложения. Для уточнения стоит обращаться в тех поддержку Самсунга (кстати для этого часто в телефонах Самсунг уже есть встроенный модуль поддержки).
  4. Нужно проверить устройство — нет никакого специального теста, достаточно на самом устройстве/на коробке найти надпись Works with SmartThings. На крайняк она может быть в инструкции/руководстве.
  5. Точно неизвестно — говорится что какие-то пользовательские возможности, картинки, что это спецом сделали с целью иллюстрации.

Step 4: Test your device integration

  1. Open the SmartThings app and enable Developer Mode[link to (note that you will not be using My Testing Devices for testing).
  2. Create a Location in the format Brandname-streview (e.g. samsung-streview).
  3. Select Add Device in the app and click Scan nearby to find your device.
  4. Add your device and hub to the Location you created in Step 2.
  5. Start testing your device with the SmartThings app by verifying the self-test guidelines and running the test cases.

Once you have successfully completed tests, send an invitation to the user to join this Location. This allows the SmartThings team to test and approve your device for publication.

Откуда взялось приложение Smart Things?

Samsung, как и любая продвинутая компания современного мира, пытается поспеть за инновациями, куда входит трендовая сегодня система умного дома. Для последнего требуется управление, которое хранится на андроиде.

Smart Things – это как раз то самое приложение, которое позволяет управлять системой умного дома, а точнее, всеми умными устройствами в доме. Но для того, чтобы система заработала, должны быть подключены хоть какие-то устройства. То есть, если вы не пользуетесь технологиями умного дома, то по сути вам это приложение и не пригодится.

Для тех, кто не планирует использовать приложение для управления технологиями в своем доме, функцию можно удалить, но помните, что скорее всего при обновлениях она опять восстановится, так как является дефолтным приложением самсунговских проектов.

Что поддерживает Smart Things? Все приборы и технологии, у которых есть пометка «Works with SmartThings». Обычно ее можно найти или на упаковке прибора, или на самом гаджете. Обычно это кондиционеры, холодильники, телевизоры, домашние кинотеатры, системы сигнализации, световые устройства и пр.

Обратите внимание:

Как работает Нетфликс?

March 5, 2018

Release Contents

  • Developer Workspace

    Self-published projects in local SmartThings SDK are listed in the Web Console.

  • Local SDK
    • IDE: Self-publishing the devices is now supported.
    • IDE: UI manifest editor only supports viewing of the UI manifest.json file.
    • CLI: Changed the generic device plugin URI.

Known Issues

  • On the Web Console a few capabilities for cloud-connected devices in unexpected ways:
    • Color Control: The blue color is not well set when you select Blue in the Palette. You will see that the Color Picker is selected even though you do not see Blue selected.
    • Smoke Detector: You cannot see state in the Dashboard, but you can check status on the Detail page.

Discovery Callback

A discovery callback interaction allows a third-party partner to perfom on-demand discovery of devices.

    • : Schema type.
    • : Schema version.
    • : Interaction type of payload.
    • : Any string of alphanumeric characters and dashes less than 128 characters is valid, but a version 4 UUID, which is a UUID generated from random numbers, is recommended.
    • : Token type.
    • : Token issued by third-party cloud; the context for the request.

Example response

    • : Schema type.
    • : Schema version.
    • : Interaction type of payload.
    • : Matching request ID from request.
  • : Array of devices for user account.
    • : Device ID at third-party cloud.
    • : Pass-through cookie for setting custom key/value pairs. Should not contain personally identifiable information and cannot be greater than 5 KB.
    • : (Optional) Label of the device shown to the user.
    • : Manufacturer info for the device.
      • : Name of the manufacturer, preferably partner name.
      • : Unique model number that identifies the device model.
      • : (Optional) Hardware version.
      • (Optional) Software/firmware version.
    • : (Optional) Device context info.
      • : Location name associated with the device.
      • : Groups that include the device.
      • : (Optional) Categories associated with the device.
    • : Device handler type name. When using a custom device profile, the value should be the device profile ID.

July 3, 2018

Release Contents

  • Documentation
    • Added Scenes API Documents
      • Working with Scenes
    • Updated Capabilities Reference to support more available capabilities
    • Added Blogs
      • How to design Pages in a SmartApp
      • How to apply a Public Key on a WebHook endpoint
  • Developer Workspace
    • Enabled editing of device profiles
    • You can now download the self-assessment checklist when submitting a certification request.
    • All developers that belong to the same organization can access self-published devices and Automations regardless of their country.
    • Added ability to remove images uploaded as device onboarding information
    • Added ability to update min and max values of Range for capabilities related to Temperature, e.g., Oven Setpoint and Thermostat Setpoint
    • More capabilities are now supported!

SmartThings и протоколы связи: WiFi, Z-Wave и Zigbee

SmartThings без проблем работает с WiFi, Zigbee и Z-Wave.

  • Wi-Fi: хотя SmartThings не поставляется с радио Wi-Fi, поскольку это сетевое устройство в вашем домашнем Wi-Fi, есть большая вероятность, что любые смарт-устройства WiFi, которые у вас уже есть, будут работать.
  • Zigbee: SmartThings работает в той же сети 2,4 ГГц, что и Wi-Fi, по протоколу Zigbee, но это не означает, что все устройства Zigbee будут работать. Вы всегда должны внимательно проверять совместимость, прежде чем совершать покупку. Например, с лампами Philips Hue вы сможете подключиться к платформе SmartThings только с помощью Hue Bridge, поскольку он работает на настроенной версии Zigbee.
  • Z-Wave: Обычно вы не сможете использовать датчик Z-Wave в обычной сети Zigbee. SmartThings решает эту проблему, запекая в радиостанции Zigbee.

Если вас смущает разница между Zigbee и Z-Wave, ознакомьтесь с нашей недавней статьей о том, как эти протоколы работают в вашем умном доме. Наряду с этим был добавлен Bluetooth 4.1, чтобы обеспечить максимальную совместимость, чтобы вы могли создать умный дом своей мечты без особых ограничений.

Лучшие устройства, совместимые с SmartThings: Что такое Samsung SmartThings?

Samsung SmartThings завоевал известность в пространстве Интернета вещей (IoT). Как интеллектуальное решение для подключения к дому, SmartThings обеспечивает бесплатную связь между различными устройствами, от датчиков и концентраторов до камер и лампочек. Разрушение SmartThings далее, есть программная сторона, а также аппаратный компонент. В основе Samsung SmartThings находится центр умного дома. После установки концентратора SmartThings вы можете загрузить приложение для выбранной вами операционной системы (ОС). После этого вы можете синхронизировать различные устройства. Концентратор SmartThings сертифицирован для протокола Z-Wave, а также может подключаться к нескольким другим платформам, включая Zigbee.

Как работает SmartThings?

Samsung SmartThings использует различные протоколы, такие как Z-Wave и ZigBee. Большинство устройств, совместимых с Z-Wave или ZigBee, должны сохранять функциональность с концентратором SmartThings. Но устройству, сертифицированному Z-Wave или ZigBee, все еще требуется обработчик устройства SmartThings для обеспечения реальной функциональности. Для устройств, на которых отсутствует обработчик SmartThings, возможно, есть средства для его интеграции по неофициальным каналам, но вам нужно будет немного заняться программированием “сделай сам” (DIY) или обратиться к ресурсам сообщества, таким как форумы SmartThings. Концентратор подключается к маршрутизатору и использует свой массив протоколов связи для связи с устройствами и датчиками, что позволяет им взаимодействовать друг с другом, а также с облаком.

Что такое SmartThings-совместимое устройство и что оно может делать?

Другие видео: 9 способов, которыми умный дом может улучшить вашу жизнь.

Проще говоря, совместимое с SmartThings устройство – это гаджет, сертифицированный для взаимодействия с концентратором SmartThings. Таким образом, он использует протоколы связи, такие как ZigBee или Z-Wave. Датчик или устройство SmartThings синхронизируется с концентратором и связывается с ним, а также с другими датчиками и устройствами. Затем вы можете управлять ими с помощью различных средств, включая ручное управление, например, включение и выключение устройств, автоматизацию, срабатывание датчиков и т.д.

Например, моя квартира оснащена умными лампочками. Поскольку SmartThings совместим с голосовыми помощниками, такими как Google Assistant и Amazon Alexa, я могу использовать голосовые команды для управления освещением, например включением и выключением света и изменением цвета. Совет для профессионалов: это сцепление для чтения в постели, так как вам не нужно вырываться из-под одеяла, чтобы переключиться на выключатель и выключить его. Кроме того, я использую датчик движения, который я настроил с помощью процедуры, которая включается в определенное время и включает, а затем выключает свет.

Опции Smart Things

Основная задача программы — настроить домашний уют в автоматическом режиме. Она позволяет автоматизировать заданные пользователем задачи независимо от их сложности.

1. Освещение. Автоматизация происходит за счет «умных» лампочек или готовых осветительных приборов. Цена таких лампочек выше обычных, но это того стоит. Можно настроить освещение по времени и определённым действиям пользователя.

2. Водоснабжение. Существуют «умные» водопроводные вентили и бойлеры. Взаимодействуя с другими приборами, они могут отключать подачу воды, если зафиксирована протечка, и нагревать воду до определенной температуры.

3. Электрические бытовые приборы. Вы можете давать команду бытовым приборам или розеткам Samsung прямо со своего смартфона, находясь где угодно. Например, вы забыли выключить утюг или телевизор. С «Умным домом» это не проблема. Главное, чтобы WI-FI исправно работал.

4. Различные датчики. К ним относятся датчики движения, задымления, протечки, температуры и влажности. Их работу можно выстроить в различные сценарии.а) Хозяин возвращается домой и автоматически срабатывает датчик движения. Свет в прихожей загорается, а через пять минут он сам отключается. Одновременно с этим можно настроить, чтобы включался электрический чайник и уставший семьянин сможет испить горячего чая.

б) Датчики задымления обычно устанавливают на потолке, чтобы уловить наличие поднимающегося дыма. Этот датчик от Samsung очень чувствительный. При фиксации минимального количества продуктов горения он включает встроенную сигнализацию и отправляет сообщение пользователю в программу Smart Things. Теперь, где бы ни находился хозяин, он всегда будет в курсе происходящего и сможет предупредить родственников или вызвать пожарную охрану. Создав сценарий, можно при срабатывании датчика задымления автоматически отключить все электрические приборы.

в) Датчик протечки работает при замыкании двух контактов на устройстве, когда они оба находятся в воде. Извещение поступает на смартфон. При создании сценария следующим шагом может быть перекрытие водоснабжения, если, конечно, встроен в систему подобный гаджет. Это актуально в сезон отпусков как гарантия от дорогостоящего ремонта, особенно соседской квартиры снизу.

г) Датчики температуры больше подойдут для комфорта. Их можно настроить так, чтобы при определенных значениях включался или отключался кондиционер. Причем необязательно, чтобы он был фирмы Samsung. Главное, чтобы прибор был подключен через «умную» розетку.

д) Датчик влажности будет полезен молодым родителям. Новорожденный должен находиться в квартире при определенной влажности, и технологии опять придут на помощь. Выстроив сценарий нужным образом, можно устроить включение и отключение увлажнителя воздуха при определенных показаниях влажности.

Вариантов очень много. Все зависит только от воображения пользователя и наличия гаджетов, поддерживающих SmartThings.

Краткое руководство по настройке и преимущества SmartThings

Что касается поддерживаемых устройств – не обязательно иметь смартфон или планшет компании Samsung. В данный момент разработаны версии для новейших устройств на базе Android и iOS, доступны по следующим ссылкам:

  • Play Market.
  • iTunes.

После скачивания и установки программы на ваше устройство входим в него, следуем простым инструкциям системы по созданию учётной записи.

Далее автоматически запустится поиск поддерживаемых устройств (они все должны быть включены, активны), а затем группировка по различным параметрам: бытовая техника, системы контроля и тому подобное.

На этом собственно всё – далее никаких особых знаний не требуется, лишь фантазия и точное понимание того, что требуется от системы именно пользователю. Из преимуществ системы чаще всего выделяют:

  • Простоту в установке и первоначальном поиске устройств с поддержкой SmartThings.
  • Универсальность и свобода в выборе смартфона-пульта (имеется в виду бренд).
  • Удобное приложение, без сложных манипуляций и определений.
  • Возможность обновления системы умного дома в любое время и в любом месте (новые настройки будут загружены по прибытию домой или путём автоматической смены на расстоянии).

В случае возникновения проблем с эксплуатацией, мелких сбоев приложения, развитое сообщество разработчиков поможет в течение суток – проверено счастливыми владельцами системы.

Что такое  Smart ThingsЧто такое Smart Things

SAMSUNG SmartThings Starter Kit

Обалдеть. Существует набор для умного дома — можно заказать в интернете (например на Амазоне). Называется SAMSUNG SmartThings Starter Kit, вот как выглядит:

SAMSUNG SmartThings Starter Kit — фирменный набор, вот что входит в него:

  1. Датчик движения — всегда на шухере.
  2. Невероятно умная розетка. Все сама понимает без лишних слов подключает.
  3. Обычный езернет-кабель для подключения к роутеру.
  4. 4 батарейки типа АА — должно хватить надолго.
  5. Датчик отслеживания дверей — закрытые или открытые. А то еще забудете дверь закрыть.. оно вам нужно? Я думаю нет, поэтому установите SmartThings.
  6. Датчик включения света когда чел зашел. Выключение когда вышел. Все четко. Удобно, экономим время. А то еще включаем свет руками постоянно — хватит это терпеть!
  7. Есть датчик, который будет сигнализировать — эй, ты дверь или окно забыл закрыть!
  8. Датчик изменения температуры, вибрации.. также будет отслеживание резких перепад температур, резкие вибрации. Удобно, вы всегда будете знать — нет ли опасно низкой температуры? не трясет ли в комнате? Если все норм — можно дальше спать спокойно

Refreshing your tokens

To obtain a new token set (access and refresh), make a POST request to , using the latest unexpired refresh token, client ID, and client secret.

The request requires user authentication; the client ID is used as the user, and the client secret as the password.

The following form data should be sent on the request:

Parameter Description
Specify to receive a new token.
The client ID of your SmartApp.
The client secret of your SmartApp.
The latest unexpired refresh token received by your SmartApp during the INSTALL or UPDATE phase.

An example request using cURL:

Store your refresh token! : The Client ID and Client Secret can be found in Developer Workspace when creating your SmartApp.
They will be only be displayed once, so be sure to note them when creating your SmartApp.

SmartApp token duration

SmartApp authorization and refresh token expiration durations are:

  • Authorization tokens: five minutes
  • Refresh tokens: thirty days
Оцените статью
Рейтинг автора
5
Материал подготовил
Илья Коршунов
Наш эксперт
Написано статей
134
Добавить комментарий