Skip to content

MSchenkl/ha-canton-smart-connect

Folders and files

NameName
Last commit message
Last commit date

Latest commit

 

History

1 Commit
 
 
 
 
 
 
 
 
 
 
 
 

Repository files navigation

Canton Smart Connect 5.1 - Home Assistant Integration

hacs_badge GitHub Release License: MIT

Custom Home Assistant integration for the Canton Smart Connect 5.1 soundbar/AV receiver. Controls the device via the reverse-engineered FFAA binary protocol over TCP.

Dashboard Card

Features

Entity Type Description
Power Switch Turn the device on/off
Input Select Switch input source (BDP, SAT, PS, TV, CD, DVD, PAD, AUX, NET)
Sound Mode Select Set sound mode (Stereo, Movie, Music)
Preset Select Activate presets 1-10
Bass Number EQ bass level (-10 to +10)
Mid Number EQ mid level (-10 to +10)
Treble Number EQ treble level (-10 to +10)
Volume Number Volume level (0-70)
Bluetooth Pairing Button Enter Bluetooth pairing mode

Volume Control

For reliable volume control, use the Google Cast integration alongside this integration. The Canton Smart Connect has a built-in Chromecast receiver. Add the Google Cast integration in Home Assistant and it will automatically discover the device, providing a media_player entity with volume slider and mute control.

Installation

HACS (Recommended)

  1. Open HACS in Home Assistant
  2. Go to Integrations
  3. Click the three dots menu (top right) → Custom repositories
  4. Add https://github.com/MSchenkl/ha-canton-smart-connect as Integration
  5. Search for "Canton Smart Connect" and install
  6. Restart Home Assistant

Manual

  1. Copy the custom_components/canton/ folder to your Home Assistant config/custom_components/ directory
  2. Restart Home Assistant

Configuration

  1. Go to SettingsDevices & ServicesAdd Integration
  2. Search for Canton Smart Connect
  3. Enter the IP address of your Canton device (default port: 50006)

Dashboard Card

Example YAML for a dashboard card with all controls:

type: entities
title: Canton Smart Connect 5.1
icon: mdi:amplifier
show_header_toggle: false
entities:
  - entity: switch.canton_smart_connect_5_1_ffaa_power
  - entity: media_player.canton_smart_connect_5_1
    name: Volume (Chromecast)
    icon: mdi:volume-high
  - entity: select.canton_smart_connect_5_1_ffaa_input
  - entity: select.canton_smart_connect_5_1_ffaa_sound_mode
  - entity: select.canton_smart_connect_5_1_ffaa_preset
  - type: divider
  - entity: number.canton_smart_connect_5_1_ffaa_bass
    name: Bass
  - entity: number.canton_smart_connect_5_1_ffaa_mid
    name: Mid
  - entity: number.canton_smart_connect_5_1_ffaa_treble
    name: Treble
  - type: divider
  - entity: button.canton_smart_connect_5_1_ffaa_bluetooth_pairing

Note: The media_player entity comes from the Google Cast integration. Tap on it to open the volume slider.

Note: Entity IDs may vary depending on your setup. Check Developer ToolsStates and filter for "canton" to find your actual entity IDs.

Protocol

This integration communicates with the Canton Smart Connect 5.1 via a proprietary binary protocol (FFAA) on TCP port 50006. Each frame starts with the magic bytes FF AA followed by a command ID, type byte, length, and data payload. The protocol was reverse-engineered from network captures of the official Canton App.

License

MIT

About

Canton Plugin für Home Assistant

Resources

License

Stars

Watchers

Forks

Releases

No releases published

Packages

 
 
 

Contributors

Languages