2025.4.2
Home ▸ Integrations ▸

Crownstone

The Crownstone integration allows you to control your Crownstones either via the cloud or using a Crownstone USB dongle.

The Crownstone integration supports the following Crownstone devices:

  • Crownstone Plug (This can be plugged directly into an existing power outlet)
  • Crownstone Built-In One (This can be put behind power outlets, lamp fixtures, or switches)

Configuration

To add the Crownstone integration to your Home Assistant instance, use this My button:

Manual configuration steps

If the above My button doesn’t work, you can also perform the following steps manually:

  • Browse to your Home Assistant instance.

  • Go to Settings > Devices & Services.

  • In the bottom right corner, select the Add Integration button.

  • From the list, select Crownstone.

  • Follow the instructions on screen to complete the setup.

Options

Options for Crownstone can be set via the user interface, by taking the following steps:

  • Browse to your Home Assistant instance.
  • Go to Settings > Devices & Services.
  • If multiple instances of Crownstone are configured, choose the instance you want to configure.
  • Select the integration, then select Configure.
Use a Crownstone USB dongle to enable local data transmission

Enabling this option will launch a flow, which will allow you to configure a Crownstone USB dongle. Disabling this option will remove current configuration.

Crownstone Sphere where the USB is located

This option is available when a Crownstone USB dongle is configured, and there are multiple Crownstone Spheres available. You can select in which Sphere the USB dongle is currently located.

Crownstones

Crownstones have the ability to dim, however dimming is disabled by default. To enable dimming for a Crownstone:

  1. Go to your Crownstone app
  2. Tap on a Crownstone that you want to enable the dimming functionality
  3. Tap on Abilities
  4. Toggle Dimming on

When you have changed an ability through the Crownstone app, the change will be automatically updated in Home Assistant. Note that Home Assistant will reload the entry when dimming is changed.

Enabling dimming is at own risk. It is recommended to only use dimming on lights.

Crownstone USB

The default connection method of the Crownstone integration is Cloud Polling. However, a Crownstone USB is available. Instead of switching and dimming Crownstones using the Cloud, this dongle hooks directly into the Crownstone mesh to switch Crownstones, which means the latencies are really low.

Furthermore, the Crownstone USB dongle allows for independent switching of Crownstones. When using the Cloud, a smartphone must be in the Sphere to switch the Crownstone.