Skip to content

About

Home Assistant integration for NAD amplifiers, tuners and receivers over serial (RS-232) or Ethernet (telnet)

Topics

Resources

Stars

8 stars

Watchers

1 watching

Forks

Repository files navigation

Home Assistant integration for NAD amplifiers, tuners and receivers over serial (RS-232) or Ethernet (telnet)

Python GitHub Release Licence Maintainer Home Assistant HACS
GitHub Sponsors PayPal BuyMeCoffee Patreon

Introduction

Home Assistant integration to control NAD amplifiers, tuners and receivers over serial (RS-232) or Ethernet (telnet).

⚠️ This custom integration replaces the NAD integration that comes with Home Assistant Core. If your NAD device does not follow the v2.x NAD protocol this integration will not work.

Features

  • Installation/Configuration through Config Flow UI.
  • Discovers devices on the network through DHCP and Zeroconf (experimental).
  • Imports YAML configuration as used by Home Assistant Core.
  • Asynchronous, built on serialx.
  • Connects over serial (RS-232) or Ethernet (telnet).
  • Supports Serial to Ethernet/WiFi bridge and ESPHome Serial Proxy.
  • Detects the device model and loads the matching configuration.
  • Detects the device type (amplifier, tuner, receiver) for models without configuration.
  • Read, set, increment and decrement any supported setting.
  • Reads the source names on supported devices.
  • Supports zones on multi-zone receivers.
  • Change the serial port or URL without removing the device.

Supported protocol

If your device follows the second generation NAD protocol (v2.x), it is supported by this integration. This protocol is used by NAD amplifiers, tuners and receivers with a serial (RS-232) or Ethernet port.

⚠️ The binary protocol that some NAD devices, like the D-series, use on TCP port 50001 is not supported.

Commands for the second generation NAD protocol have the following format:

<Setting><Operator><Value> like Main.Volume=-30

Read more about the supported protocol.

Supported devices

The following devices are known to work:

Receivers:

  • T755
  • T757

Additionally, the integration includes untested configuration files for the following devices:

Receivers:

  • T765
  • T775
  • T777
  • T785
  • T787

Surround preamplifiers:

  • M15HD
  • T175
  • T187

Amplifiers:

  • C356
  • C368
  • C388

Tuners:

  • C427

Other NAD devices that use the supported protocol should work too, with a basic set of settings: power, model, version, volume, mute and source.

Installation

HACS

The recommended way to install this Home Assistant integration is by using HACS. Click the following button to open the integration directly on the HACS integration page.

Install NAD from HACS.

Manually

  • Copy the custom_components/nad directory of this repository into the config/custom_components/ directory of your Home Assistant installation
  • Restart Home Assistant

Adding a new NAD device

YAML import

Existing YAML configurations as used by the Home Assistant Core NAD integration are imported automatically.

min_volume, max_volume, volume_step and sources are no longer used; the integration takes them from the device or device configuration. TCP type YAML configurations are not supported; uninstall this custom integration and keep using the Home Assistant Core NAD integration for these devices.

After a successful import you can remove the YAML configuration.

Discovery

NAD devices with an Ethernet port are discovered automatically on your network. Go to Settings > Devices & services and select Add on the discovered NAD device.

Manually

ⓘ To connect to the Ethernet (telnet) interface of your device use socket://<ip address>:23

When your connection is right a new NAD integration and device will now be added to your Integrations view. If your connection is not right you will get a Failed to connect error message.

Contribution and appreciation

Do you enjoy using this Home Assistant integration? You can contribute to this integration, or show your appreciation, in the following ways.

Contribute your NAD model

Is your NAD device supported by this Home Assistant integration but not listed under Supported devices? Let me know your NAD model so I can improve the overview of supported devices.

Contribute your language

If you would like to use this Home Assistant integration in your own language you can provide a translation file as found in the custom_components/nad/translations directory. Create a pull request (preferred) or issue with the file attached.

More on translating custom integrations can be found here.

Star this integration

Help other Home Assistant and NAD users find this integration by starring this GitHub page. Click ⭐ Star on the top right of the GitHub page.

Support my work

Please consider supporting my work through one of the following platforms, your contribution is greatly appreciated and keeps me motivated:

GitHub Sponsors PayPal BuyMeCoffee Patreon

Home Assistant support

Let me answer your Home Assistant questions. During a 1 hour Q&A session I help you solve your Home Assistant related issues.

What can be done in one hour:

  • Home Assistant walkthrough, I explain to you what's where in the Home Assistant UI
  • Install and configure a Home Assistant integration
  • Explain and create scenes
  • Explain and create a simple automation
  • Install a ZHA quirk, to make your unsupported Zigbee device work in Home Assistant

What takes more time:

  • Depending on the severity I might be able to help you with recovering your crashed Home Assistant
  • Support for Home Assistant Integration developers

Hire me

If you would like to have a Home Assistant integration developed for your product or are in need of a freelance Python developer for your project please contact me, you can find my email address on my GitHub profile.

About

Home Assistant integration for NAD amplifiers, tuners and receivers over serial (RS-232) or Ethernet (telnet)

Topics

Resources

Stars

8 stars

Watchers

1 watching

Forks

Releases

Sponsor this project

Packages

Used by

Contributors

Languages