---
id: crownstone-uart
version: "2.7.0"
license: unclear
license_treatment: unclear
maintenance: dormant
---

# crownstone-uart

License: unclear · Maintenance: dormant · Downloads: 73.6K/mo

## What it is and what it does

Crownstone UART is an official Python library for communicating with Crownstone smart home devices through a USB serial connection. It wraps the crownstone-core library and pyserial to provide an asyncio-based interface for discovering, switching, and monitoring Crownstone smart plugs and relays. The library uses the Crownstone USB adapter as a bridge to communicate with the mesh network of Crownstone devices.

The package is designed for home automation scenarios where you need programmatic control over Crownstone hardware—discovering device IDs, switching outlets on and off, and reading power consumption data. It requires Python 3.7 or higher and relies on platform-specific USB drivers (SiliconLabs on macOS, standard serial access on Linux and Windows). The library is dormant as of 2022, so compatibility with recent Crownstone firmware or Python versions beyond 3.7 is not guaranteed.

Use it for:

- Discover and list all Crownstone devices on your network to obtain their IDs for automation.
- Remotely switch Crownstone smart plugs on and off from a Python application.
- Monitor real-time power consumption data from connected Crownstone devices.
- Build home automation workflows that integrate Crownstone hardware with other Python-based systems.
- Debug or test Crownstone mesh network communication via direct USB serial access.

## Worth the install?

AI-flagged interpretation of the facts above — verify before relying.

Python library for controlling Crownstone smart home devices via USB serial connection, requiring a Crownstone USB adapter.

Yes, if you own Crownstone hardware and need direct USB control from Python. The low install friction and absence of known vulnerabilities make it safe to try. However, the dormant maintenance status (last release 2022-11-03) and unclear license metadata are significant concerns—verify license compliance and test compatibility with your specific Crownstone firmware version before committing to production use.

## Install

pip install crownstone-uart
uv add crownstone-uart
poetry add crownstone-uart

## Installing crownstone-uart

Before you install: Low install friction with a pure-Python wheel, but the package is dormant—last release was 2022-11-03, over 1380 days ago. No recent maintenance activity despite an active repository.

License in practice: License treatment is unclear; the description excerpt states MIT but the metadata does not confirm it. Verify the actual license before relying on this package in a commercial or restricted context.

Quickstart:

pip install crownstone-uart

from crownstone_uart import CrownstoneUart

crownstone = CrownstoneUart(port='/dev/ttyUSB0')
crownstone.start()

Requires a physical Crownstone USB adapter and Python 3.7 or higher. On Linux, user must be in the dialout group (or uucp on Arch) to access the serial port without root. On macOS, requires SiliconLabs USB-to-UART driver.

Verify before relying:

- Whether the MIT license claim in the description is authoritative or whether the package is actually unlicensed.
- Whether the library remains compatible with current Crownstone firmware versions and USB adapter hardware.
- Whether the dormant status reflects stable maturity or abandoned development.

## Package facts

- License: not declared (unclear)
- Python support: supports_current
- Install friction: low
- Maintenance: dormant
- Downloads: 73.6K/month (top 15,000 on PyPI)
- Known vulnerabilities: none known

## Tags

crownstone smart home control, crownstone usb uart bridge, smart plug python library, home automation serial control, crownstone device communication, usb to uart smart home, crownstone power management, smart-home, serial-communication, iot-control

[View on SkillFed](https://skillfed.io/packages/crownstone-uart) · [View on PyPI](https://pypi.org/project/crownstone-uart/)