added documentation for monoprice platform (home-assistant#3495)

etsinko · fabaff · commit e42a0fb95647 · 2017-10-18T22:39:45.000+02:00
* added monoprice page

* updated markdown

* updated markdown

* renamed mp-logo.svg to monoprice.svg
updated ha_release to 0.55

* fixed some typos

* switched logo from white to black

* updated release

* Grammar; Added missing determiner
diff --git a/source/_components/media_player.monoprice.markdown b/source/_components/media_player.monoprice.markdown
@@ -0,0 +1,49 @@
+---
+layout: page
+title: "Monoprice 6-Zone Amplifier"
+description: "Instructions on how to integrate Monoprice 6-Zone Home Audio Controller into Home Assistant."
+date: 2017-10-02 11:45
+sidebar: true
+comments: false
+sharing: true
+footer: true
+logo: monoprice.svg
+ha_category: Media Player
+ha_release: 0.56
+ha_iot_class: "Local Polling"
+---
+
+The `monoprice` platform allows you to control [Monoprice 6-Zone Amplifier](https://www.monoprice.com/product?p_id=10761) using a serial connection.
+
+To add a Monoprice device to your installation, add the following to your `configuration.yaml` file:
+
+```yaml
+# Example configuration.yaml entry
+media_player:
+  - platform: monoprice
+    port: /dev/ttyUSB0
+    zones:
+      11:
+        name: Main Bedroom
+      12:
+        name: Living Room
+      13:
+        name: Kitchen
+      14:
+        name: Bathroom
+      15:
+        name: Dining Room
+      16:
+        name: Guest Bedroom
+    sources:
+      1: 
+        name: Sonos
+      5:
+        name: Chromecast
+```
+
+Configuration variables:
+
+- **port** (*Required*): The serial port to which Monoprice amplifier is connected
+- **zones** (*Required*): This is the list of zones available. Valid zones are 11,12,13,14,15,16. In case multiple Monoprice devices are stacked together the list of valid zones is extended by 21,22,23,24,25,26 for the second device and 31,32,33,34,35,36 for the third device. Each zone must have a name assigned to it.
+- **sources** (*Required*): The list of sources available. Valid source numbers are 1,2,3,4,5,6. Each source number corresponds to the input number on the Monoprice amplifier. Similar to zones, each source must have a name assigned to it.
diff --git a/source/images/supported_brands/monoprice.svg b/source/images/supported_brands/monoprice.svg
@@ -0,0 +1,105 @@
+<?xml version="1.0" encoding="UTF-8" standalone="no"?>
+<!-- Generator: Adobe Illustrator 19.0.0, SVG Export Plug-In . SVG Version: 6.00 Build 0)  -->
+
+<svg
+   xmlns:dc="http://purl.org/dc/elements/1.1/"
+   xmlns:cc="http://creativecommons.org/ns#"
+   xmlns:rdf="http://www.w3.org/1999/02/22-rdf-syntax-ns#"
+   xmlns:svg="http://www.w3.org/2000/svg"
+   xmlns="http://www.w3.org/2000/svg"
+   xmlns:sodipodi="http://sodipodi.sourceforge.net/DTD/sodipodi-0.dtd"
+   xmlns:inkscape="http://www.inkscape.org/namespaces/inkscape"
+   version="1.1"
+   id="Layer_1"
+   x="0px"
+   y="0px"
+   viewBox="0 0 420 60"
+   style="enable-background:new 0 0 420 60;"
+   xml:space="preserve"
+   inkscape:version="0.91 r"
+   sodipodi:docname="monoprice.svg"><metadata
+     id="metadata3500"><rdf:RDF><cc:Work
+         rdf:about=""><dc:format>image/svg+xml</dc:format><dc:type
+           rdf:resource="http://purl.org/dc/dcmitype/StillImage" /></cc:Work></rdf:RDF></metadata><defs
+     id="defs3498" /><sodipodi:namedview
+     pagecolor="#ffffff"
+     bordercolor="#666666"
+     borderopacity="1"
+     objecttolerance="10"
+     gridtolerance="10"
+     guidetolerance="10"
+     inkscape:pageopacity="0"
+     inkscape:pageshadow="2"
+     inkscape:window-width="1920"
+     inkscape:window-height="1028"
+     id="namedview3496"
+     showgrid="false"
+     inkscape:zoom="4.1404762"
+     inkscape:cx="210"
+     inkscape:cy="1.0178263"
+     inkscape:window-x="0"
+     inkscape:window-y="0"
+     inkscape:window-maximized="1"
+     inkscape:current-layer="g3457" /><style
+     type="text/css"
+     id="style3455">
+	.st0{fill:#FFFFFF;}
+</style><g
+     id="g3457"><path
+       class="st0"
+       d="M51.3,4.4C57.2,4.4,62,9.2,62,15.1v29.9c0,5.9-4.8,10.7-10.7,10.7H21.4c-5.9,0-10.7-4.8-10.7-10.7V15.1   c0-5.9,4.8-10.7,10.7-10.7H51.3 M53.3,25.2c0-2-0.7-3.7-2.1-5.1c-1.4-1.4-3.1-2.1-5.1-2.1c-2,0-3.7,0.7-5.1,2.1   c-1.4,1.4-2.1,3.1-2.1,5.1v7.3c0,1.6-0.8,2.4-2.4,2.4c-1.6,0-2.4-0.8-2.4-2.4v-6.8v-0.4c0-2-0.7-3.7-2.1-5.1   c-1.4-1.4-3.1-2.1-5.1-2.1c-2,0-3.7,0.7-5.1,2.1c-1.4,1.4-2.1,3.1-2.1,5.1v14.5c0,1.6,0.8,2.4,2.4,2.4s2.4-0.8,2.4-2.4V25.2h0   c0-1.6,0.8-2.4,2.4-2.4c1.6,0,2.4,0.8,2.4,2.4v7.3c0,2,0.7,3.7,2.1,5.1c1.4,1.4,3.1,2.1,5.1,2.1c2,0,3.7-0.7,5.1-2.1   c1.4-1.4,2.1-3.1,2.1-5.1V32v-6.8c0-1.6,0.8-2.4,2.4-2.4c1.6,0,2.4,0.8,2.4,2.4h0l0,14.5c0,1.6,0.8,2.4,2.4,2.4   c1.6,0,2.4-0.8,2.4-2.4V25.2z"
+       id="path3459"
+       style="fill:#000000" /><path
+       class="st0"
+       d="M146,12c5.4,0,9.9,1.7,13.5,5.1c3.6,3.4,5.4,7.7,5.4,12.9c0,5.2-1.8,9.5-5.5,12.8c-3.6,3.4-8.2,5.1-13.8,5.1   c-5.3,0-9.7-1.7-13.2-5.1c-3.5-3.4-5.3-7.6-5.3-12.7c0-5.2,1.8-9.6,5.3-13C136.1,13.7,140.6,12,146,12z M146.2,16.8   c-4,0-7.3,1.3-9.9,3.8c-2.6,2.5-3.9,5.7-3.9,9.6c0,3.8,1.3,6.9,3.9,9.4c2.6,2.5,5.8,3.8,9.7,3.8c3.9,0,7.2-1.3,9.8-3.8   c2.6-2.6,3.9-5.8,3.9-9.6c0-3.7-1.3-6.8-3.9-9.4C153.2,18,150,16.8,146.2,16.8z"
+       id="path3461"
+       style="fill:#000000" /><path
+       class="st0"
+       d="M202.8,12.3h4.8v35.4h-4.4l-23.7-27.3v27.3h-4.8V12.3h4.1l23.9,27.5V12.3z"
+       id="path3463"
+       style="fill:#000000" /><path
+       class="st0"
+       d="M236.2,12c5.4,0,9.9,1.7,13.5,5.1c3.6,3.4,5.4,7.7,5.4,12.9c0,5.2-1.8,9.4-5.4,12.8c-3.6,3.4-8.2,5.1-13.7,5.1   c-5.3,0-9.7-1.7-13.2-5.1c-3.5-3.4-5.3-7.6-5.3-12.7c0-5.2,1.8-9.6,5.3-13C226.3,13.8,230.7,12,236.2,12z M236.4,16.8   c-4,0-7.3,1.3-9.9,3.8c-2.6,2.5-3.9,5.7-3.9,9.6c0,3.8,1.3,6.9,3.9,9.4c2.6,2.5,5.8,3.8,9.7,3.8c3.9,0,7.2-1.3,9.8-3.8   c2.6-2.6,3.9-5.7,3.9-9.5c0-3.7-1.3-6.8-3.9-9.4C243.4,18.1,240.2,16.8,236.4,16.8z"
+       id="path3465"
+       style="fill:#000000" /><path
+       class="st0"
+       d="M265.1,47.7V12.3h11.2c3.4,0,6.1,0.9,8.1,2.7s3,4.3,3,7.3c0,2.1-0.5,3.9-1.5,5.5c-1,1.6-2.4,2.7-4.2,3.5   c-1.8,0.7-4.4,1.1-7.7,1.1h-3.7v15.3H265.1z M275.4,16.8h-5.2v11.1h5.5c2.1,0,3.6-0.5,4.8-1.5c1.1-1,1.7-2.4,1.7-4.2   C282.2,18.6,279.9,16.8,275.4,16.8z"
+       id="path3467"
+       style="fill:#000000" /><path
+       class="st0"
+       d="M322.6,45.2c-0.7-1-1.7-2.5-3-4.5c-2-3.2-3.5-5.4-4.6-6.7c-0.8-0.9-1.5-1.6-2.3-2.3c0.4-0.1,0.8-0.2,1.1-0.4   c1.8-0.7,3.2-1.9,4.2-3.5c1-1.6,1.5-3.4,1.5-5.5c0-3.1-1-5.5-3-7.3c-2-1.8-4.7-2.7-8.1-2.7h-11.2v35.4h5.1V32.4h2.4   c1,0.1,1.7,0.2,2.2,0.5c0.7,0.4,1.5,1,2.4,1.9c0.9,0.9,1.8,2,2.9,3.5l1.7,2.8l1.6,2.6l1,1.4c0.2,0.2,0.3,0.3,0.3,0.4l1.5,2.3h6   L322.6,45.2z M302.5,16.8h5.2c4.5,0,6.7,1.8,6.7,5.4c0,1.8-0.6,3.2-1.7,4.2c-1.1,1-2.7,1.5-4.8,1.5h-5.5V16.8z"
+       id="path3469"
+       style="fill:#000000" /><path
+       class="st0"
+       d="M332.6,12.3h5.1v35.4h-5.1V12.3z"
+       id="path3471"
+       style="fill:#000000" /><path
+       class="st0"
+       d="M379,39.4V45c-3.7,2-7.9,3-12.8,3c-3.9,0-7.3-0.8-10-2.4s-4.9-3.7-6.5-6.5c-1.6-2.8-2.4-5.8-2.4-9   c0-5.1,1.8-9.4,5.5-12.9c3.6-3.5,8.1-5.2,13.5-5.2c3.7,0,7.8,1,12.3,2.9v5.4c-4.1-2.3-8.1-3.5-12-3.5c-4,0-7.4,1.3-10,3.8   c-2.7,2.5-4,5.7-4,9.5c0,3.9,1.3,7,3.9,9.5c2.6,2.5,6,3.7,10,3.7C370.8,43.4,374.9,42.1,379,39.4z"
+       id="path3473"
+       style="fill:#000000" /><path
+       class="st0"
+       d="M388.6,12.3h20.1v4.5h-15v10.8h14.5v4.5h-14.5v11h15.5v4.5h-20.6V12.3z"
+       id="path3475"
+       style="fill:#000000" /><g
+       id="g3477"
+       style="fill:#000000"><path
+         class="st0"
+         d="M98.9,39.5L98.9,39.5l10.6-27.2h7.7v35.4h-5V18.1h-0.1l-11.8,29.6h-3.2L85.5,18.1h-0.1v29.6h-4.8V12.3h7.7    L98.9,39.5z"
+         id="path3479"
+         style="fill:#000000" /></g></g><g
+     id="XMLID_235_" /><g
+     id="XMLID_236_" /><g
+     id="XMLID_237_" /><g
+     id="XMLID_238_" /><g
+     id="XMLID_239_" /><g
+     id="XMLID_240_" /><g
+     id="XMLID_241_" /><g
+     id="XMLID_242_" /><g
+     id="XMLID_243_" /><g
+     id="XMLID_244_" /><g
+     id="XMLID_245_" /><g
+     id="XMLID_246_" /><g
+     id="XMLID_247_" /><g
+     id="XMLID_248_" /><g
+     id="XMLID_249_" /></svg>
