Skip to main content

octo-bed-protocol

The wire protocol of Octo adjustable bed controllers (the RC2 receiver and its relatives) over Bluetooth Low Energy, as used by the Octo Bed Home Assistant integration.

It builds frames and reads replies. It opens no connections and depends on no Bluetooth stack, so it can be used and tested without hardware.

import octo_bed_protocol as octo

octo.move(octo.MOTOR_HEAD, up=True).hex(" ")  # '40 02 70 00 01 0b 02 40'
octo.stop().hex(" ")  # '40 02 73 00 00 0b 40'

reader = octo.FrameReader()
features = octo.Features()
for packet in reader.feed(notification):
    features.add(packet)

Every frame goes to characteristic ffe1 of service ffe0. How each byte was established is recorded in docs/protocol.md.

Not affiliated with, endorsed by, or supported by Octo. All trademarks belong to their owners.

Metadata

Release files for octo-bed-protocol 0.2.0

For a detailed explanation of source distributions (sdists) and built distributions (wheels), please see the package formats documentation.

Source distribution (sdist)

Source distribution for octo-bed-protocol 0.2.0
File Size Uploaded
octo_bed_protocol-0.2.0.tar.gz 8.0 kB Details

Built distribution (wheel)

Table of built distributions (wheels) for octo-bed-protocol 0.2.0
File Interpreter ABI Platform
octo_bed_protocol-0.2.0-py3-none-any.whl Python 3 none any Details

Total release size: 15.0 kB

Release files / octo_bed_protocol-0.2.0.tar.gz

Download URL octo_bed_protocol-0.2.0.tar.gz
Size 8.0 kB
Tags Source
SHA-256 checksum
How to use checksums
55fa1e86ff417a4e0ef09d8f6496e4cb6bb1823faeacfa17f3a68748f68b03e3
BLAKE2b-256 checksum
How to use checksums
ad832c88ea0462c06421b483820ec2749b6040ab8b9b51acaa5955dd18316f2a
Upload date
Uploaded using Trusted Publishing?
What is trusted publishing?
Yes
Uploaded via twine/7.0.0 CPython/3.13.14

Provenance

Provenance describes where a file came from. On PyPI, provenance is shared via attestations, which provide a verifiable record of the build or publishing details. View details, limitations and caveats.

PyPI Publish Attestation

PyPI verified that this artifact, at this checksum, originated from the publisher listed below.

Signed by GitHub Actions, verified by PyPI on Sep 22, 2026.

Transparency log

Release files / octo_bed_protocol-0.2.0-py3-none-any.whl

Download URL octo_bed_protocol-0.2.0-py3-none-any.whl
Size 7.0 kB
Tags Python 3
SHA-256 checksum
How to use checksums
e7d202c3125b1c8e37b735b070355e2f712e4e2ac1a8898bf16fcc697bea4030
BLAKE2b-256 checksum
How to use checksums
867fffeab3eaf44aa29b094c0bba06f6181416db08b8f156aa2824b58defda86
Upload date
Uploaded using Trusted Publishing?
What is trusted publishing?
Yes
Uploaded via twine/7.0.0 CPython/3.13.14

Provenance

Provenance describes where a file came from. On PyPI, provenance is shared via attestations, which provide a verifiable record of the build or publishing details. View details, limitations and caveats.

PyPI Publish Attestation

PyPI verified that this artifact, at this checksum, originated from the publisher listed below.

Signed by GitHub Actions, verified by PyPI on Sep 22, 2026.

Transparency log

Release history Release notifications | RSS feed

This release

0.2.0 This release

2 release files

Anthropic, PBC Visionary sponsor Bloomberg Visionary sponsor Hudson River Trading Visionary sponsor Meta Visionary sponsor NVIDIA Visionary sponsor Microsoft Sustainability sponsor Depot Continuous Integration AWS Cloud computing and Security Sponsor Datadog Monitoring Fastly CDN Google Download Analytics Sentry Error logging StatusPage Status page