Saltar al contenido principal

Integración domótica SmartThings, gratuita y de código abierto

Integración SmartThings para Gladys Assistant

Control your Samsung SmartThings switches, lights, locks, shades and sensors from Gladys.

Ver en GitHubTodas las integraciones externas
info

La documentación de esta integración la escribe su autor y, por ahora, solo está disponible en inglés.

Overview​

This integration connects Gladys Assistant to the Samsung SmartThings cloud, so you can control the SmartThings devices of your account directly from Gladys.

Once configured, every supported device of your SmartThings account appears in the Gladys Discovery screen. The integration maps each SmartThings capability to a Gladys feature, so a single device can expose several features. The supported capabilities are:

  • Switches, plugs & appliances — on/off (switch), and, when metered, instantaneous power (W) and voltage (read-only); Samsung appliances report their power through powerConsumptionReport, and their child lock (samsungce.kidsLock) is exposed read-only. The cumulative lifetime energy counter is intentionally not exposed (a running total is not actionable per-device);
  • Lights — on/off, brightness, hue, saturation and color temperature;
  • Locks — lock / unlock (lock);
  • Motorized shades — position 0–100 % (windowShadeLevel);
  • Thermostats — mode, heating setpoint and cooling setpoint;
  • Sensors (read-only, with history) — temperature, humidity, contact (opening), motion, presence, water leak, smoke, battery, illuminance, CO2 and air-quality index.

Device states are refreshed every 10 seconds, so changes made from the SmartThings app or a physical switch show up in Gladys shortly after.

The integration reads the main component of each device (the standard component of consumer devices). Devices exposing only unsupported capabilities (for example a hub) are not published.

Prerequisites​

  • A Samsung SmartThings account with your devices already added to it in the SmartThings mobile app.
  • Internet access on your Gladys instance: this integration talks to the SmartThings cloud (api.smartthings.com).
  • A Personal Access Token (see below).

Getting a Personal Access Token​

  1. Open https://account.smartthings.com/tokens and sign in with your Samsung / SmartThings account.
  2. Click Generate new token.
  3. Give it a name (for example Gladys).
  4. Select at least these scopes:
    • Devices → List all devices, See all devices, Control all devices;
    • Locations → See all locations.
  5. Click Generate token. The token is shown only once — copy it.

⚠️ Since late 2024, newly created SmartThings Personal Access Tokens expire after 24 hours. This is fine for testing; for permanent use you will need to regenerate the token or use an OAuth2-based setup in a future version of the integration.

Configuration​

  1. Install the integration from the Gladys store.
  2. Open its Configuration screen and paste your Personal Access Token (stored as a secret, never displayed back).
  3. Save. The integration connects to SmartThings and loads your devices.
  4. Open the Discovery screen: your devices are listed there. Add the ones you want, then place them in your rooms and dashboards like any Gladys device.

To use another SmartThings account or a fresh token later, just update the token in the Configuration screen: the integration reconnects and refreshes the device list automatically.

Troubleshooting​

  • "SmartThings is not configured" during discovery — the token is missing: paste it in the Configuration screen and save.
  • The connection status says the token was rejected — the token is invalid or expired (remember the 24-hour expiry): generate a new one and update the configuration.
  • A device is missing from Discovery — make sure it is visible in the SmartThings app with the same account, that it is online, and that it exposes at least one supported capability, then run the discovery again.
  • A device shows fewer features than expected — only the supported capabilities of the main component are mapped; capabilities on other components are not exposed.
  • Commands seem ignored — SmartThings can take a few seconds to relay a command to the device; the state in Gladys reflects the cloud state and catches up at the next 10-second poll.

Parámetros de configuración​

Estos son los parámetros que SmartThings te pide en su pantalla de configuración en Gladys.

ParámetroTipoObligatorioDescripción
Get your Personal Access TokensectionNoOpen the SmartThings token page below and sign in, then click "Generate new token". Give it a name, tick the scopes Devices (list all, see all, control all) and Locations (see all), and generate it. Copy the token (it is shown only once) and paste it in the field below. Note: newly created tokens expire after 24 hours.
SmartThings Personal Access TokensecretSíGenerate a token at https://account.smartthings.com/tokens with the Devices (list, see, control) and Locations (see) scopes. New tokens expire after 24 hours.

Cómo instalar SmartThings en Gladys​

  1. En Gladys, abre Integraciones: SmartThings aparece en el catálogo junto a las integraciones nativas, con una insignia de comunidad.
  2. Haz clic en Instalar. Gladys descarga la imagen Docker (ghcr.io/callemand/gladys-smartthings:1.0.0), la ejecuta en un entorno aislado del núcleo y genera la interfaz de la integración (dispositivos, descubrimiento y configuración).
  3. Abre la pantalla de Configuración de la integración, rellena los parámetros y guarda.
  4. También puedes instalarla directamente desde la URL de su repositorio: https://github.com/callemand/gladys-smartthings.

SmartThings requiere Gladys >=4.62.0. El catálogo de Gladys se actualiza cada hora, así que una nueva versión está disponible como máximo una hora después de publicarse.

¿Todavía no usas Gladys? Es gratuito y de código abierto: sigue la guía de instalación para empezar.

Guías relacionadas​

Sobre las integraciones externas​

SmartThings es una integración externa: una integración comunitaria empaquetada como contenedor Docker y publicada en GitHub. Gladys la instala con un clic y la ejecuta en un entorno aislado del núcleo. La publica y mantiene callemand, no el equipo principal de Gladys.

Suscríbete a la newsletter de Gladys Assistant

Unos pocos correos al mes sobre nuevas versiones y novedades del proyecto. Enviados por Pierre-Gilles Leymarie, fundador del proyecto. Puedes darte de baja cuando quieras 🙂
Última actualización en