From eea8330a8c879c3458fdb7364bf3d0f94df50ef9 Mon Sep 17 00:00:00 2001 From: joopster Date: Thu, 5 Jan 2017 21:33:50 +0100 Subject: [PATCH] Add NAD documentation --- source/_components/media_player.nad.markdown | 50 +++++++++++++++++++ source/images/supported_brands/nad.png | Bin 0 -> 28886 bytes 2 files changed, 50 insertions(+) create mode 100644 source/_components/media_player.nad.markdown create mode 100644 source/images/supported_brands/nad.png diff --git a/source/_components/media_player.nad.markdown b/source/_components/media_player.nad.markdown new file mode 100644 index 00000000000..eaf93d8aed0 --- /dev/null +++ b/source/_components/media_player.nad.markdown @@ -0,0 +1,50 @@ +--- +layout: page +title: "NAD" +description: "Instructions how to integrate NAD receivers into Home Assistant." +date: 2016-01-05 20:00 +sidebar: true +comments: false +sharing: true +footer: true +logo: nad.png +ha_category: Media Player +ha_release: 0.36 +ha_iot_class: "Local Polling" +--- + + +The `nad` platform allows you to control a [NAD receiver](http://nadelectronics.com) through RS232 from Home Assistant. + +To add an NAD receiver to your installation, add the following to your `configuration.yaml` file: + +```yaml +# Example configuration.yaml entry +media_player: + - platform: nad + serial_port: /dev/ttyUSB0 + name: NAD Receiver + min_volume: -60 + max_volume: -20 + sources: + 1: 'Kodi' + 2: 'TV' +``` + +Configuration variables: + +- **serial_port** (*Required*): The serial port . Default is `/dev/ttyUSB0` +- **name** (*Optional*): Name of the device. Default is NAD Receiver. +- **min_volume** (*optional*): Minimum volume in dB to use with the slider. Default is `-92` +- **max_volume** (*optional*): Maximum volume in dB to use with the slider. Default is `-20` +- **sources** (*Optional*): A list of mappings from source to source name. Valid sources are `1 to 10`. + +The min_volume and max_volume are there to protect you against misclicks on the slider so you will not blow up your speakers when you go from -92dB to +20dB. +You can still force it to go higher or lower than the values set with the plus and minus buttons. + +

+On linux the user running home-assistant needs `dialout` permissions to access the serial port. +This can be added to the user by doing `sudo usermod -a -G dialout `. +Be aware that the user might need to logout and logon again to activate these permissions. +

+ diff --git a/source/images/supported_brands/nad.png b/source/images/supported_brands/nad.png new file mode 100644 index 0000000000000000000000000000000000000000..241f5135764a8e8f64e3f9f9e9d02f255dfceeab GIT binary patch literal 28886 zcmdqJhgXy7_68bd#4{=~98sEx!l)<+GBl+{hh_srq)8P7M3AC}4nZ9OsWMWODj*t&1pBVZ`3;+q>X@AGN-8LkorSI)Os@ z|Aj)4;g9@hP$bu8w>^iV#M-bT$KFRs%WwnbpJq8y>+!KavD&)U=mzE85Yq9

5!YHIc#5;x}W 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 literal 0 HcmV?d00001