tonewinner-rs232

Async Python library to control Tonewinner AV processors over RS232 serial, built on serialx.

Supports the AT-500 specifically, other models should work but haven't been tested. Please open an issue if you encounter problems with other models.

Installation

pip install tonewinner-rs232

Requires Python 3.12+.

Quick start

import asyncio
from tonewinner_rs232 import TonewinnerReceiver


async def main():
    receiver = TonewinnerReceiver("/dev/ttyUSB0")

    # Establish a connection
    await receiver.connect()

    # Query the receiver's current state
    await receiver.query_state()

    print(f"Power: {receiver.state.power}")
    print(f"Volume: {receiver.state.volume}")
    print(f"Source: {receiver.state.source_name}")

    await receiver.power_off()
    await receiver.disconnect()


asyncio.run(main())

Features

Async API built on serialx
Full state query and real-time state updates
Event subscription for state changes
Power, volume, mute, input source, and sound mode control
Automatic framing of the ##...* Tonewinner RS232 protocol
Built-in CLI for testing

CLI

Just prints current state at the moment.

python -m tonewinner_rs232 /dev/ttyUSB0

Download files

Download the file for your platform. If you're not sure which to choose, learn more about installing packages.

Source Distribution

tonewinner_rs232-1.2.1.tar.gz (12.6 kB view details)

Uploaded Aug 24, 2026 Source

Built Distribution

If you're not sure about the file name format, learn more about wheel file names.

The dropdown lists show the available interpreters, ABIs, and platforms. Enable javascript to be able to filter the list of wheel files.

tonewinner_rs232-1.2.1-py3-none-any.whl (12.6 kB view details)

Uploaded Aug 24, 2026 Python 3

File details

Details for the file tonewinner_rs232-1.2.1.tar.gz.

File metadata

Download URL: tonewinner_rs232-1.2.1.tar.gz
Upload date: Aug 24, 2026
Size: 12.6 kB
Tags: Source
Uploaded using Trusted Publishing? Yes
Uploaded via: twine/7.0.0 CPython/3.13.14

File hashes

Hashes for tonewinner_rs232-1.2.1.tar.gz
Algorithm	Hash digest
SHA256	`55809d0dab35aa0f9f1e568417616e7b8ba41a8d0367f436b71e31f770e8e475`
MD5	`f86b018f42dbd61da9776af2bb0e08d3`
BLAKE2b-256	`bf5bad678919e49c41343f09c277fcb287717baee4e8314c6d930a2cb9a88b92`

See more details on using hashes here.

Provenance

The following attestation bundles were made for tonewinner_rs232-1.2.1.tar.gz:

Publisher: publish.yaml on emma-sg/tonewinner-rs232

Attestations: Values shown here reflect the state when the release was signed and may no longer be current.

Statement:
- Statement type: https://in-toto.io/Statement/v1
- Predicate type: https://docs.pypi.org/attestations/publish/v1
- Subject name: tonewinner_rs232-1.2.1.tar.gz
- Subject digest: 55809d0dab35aa0f9f1e568417616e7b8ba41a8d0367f436b71e31f770e8e475
- Sigstore transparency entry: 2581476925
- Sigstore integration time: Aug 24, 2026
Source repository:
- Permalink: emma-sg/tonewinner-rs232@2d28b6dee440c1263412b4857b42f1825ed9308a
- Branch / Tag: refs/tags/v1.2.1
- Owner: https://github.com/emma-sg
- Access: public
Publication detail:
- Token Issuer: https://token.actions.githubusercontent.com
- Runner Environment: github-hosted
- Publication workflow: publish.yaml@2d28b6dee440c1263412b4857b42f1825ed9308a
- Trigger Event: release