diff --git a/ReadMe.MD b/ReadMe.MD index 98e7a12..3f8b898 100644 --- a/ReadMe.MD +++ b/ReadMe.MD @@ -1,10 +1,10 @@ -

BeoGateway: Indigo Server Plugin for Bang and Olufsen AV Systems +# BeoGateway: Indigo Server Plugin for Bang and Olufsen AV Systems ![](Resources/Bang-Olufsen-Logo.png) *Please note this plugin is not endorsed or affiliated with Bang & Olufsen in any way* -

Introduction +## Introduction Plugin for the [Indigo Domotics](https://www.indigodomo.com) Home Automation software allowing integration and control of Bang and Olufsen AV systems. The plugin provides the following functionality: @@ -28,12 +28,12 @@ The plugin provides the following functionality: [1]: Via the [HomeKit Bridge](https://www.indigodomo.com/pluginstore/172/) Plugin -

Requirements +## Requirements Compatible with legacy DataLink (via 1611 converter), MasterLink, and modern NetworkLink products, including the BeoLink Converter ML/NL. The code requires a MasterLink or BeoLink Gateway to run - it is untested with the BeoLiving Intelligence -

Basic Setup and Use +## Basic Setup and Use 1. Install the plugin from the Indigo Plugin Store. 2. Configure the plugin providing the following information for your gateway: @@ -45,9 +45,9 @@ The code requires a MasterLink or BeoLink Gateway to run - it is untested with t 5. Devices can only access sources defined in their config on the gateway and will recognise at least the channel/tracks included in their favourites lists. Some sources (e.g. NetworkLink sources) may recognise additional channels and track data. 6. Devices can be switched On/Off and toggled via the indigo UI -

Advanced Functions +## Advanced Functions -

Plugin Events/Triggers +### Plugin Events/Triggers The plugin can respond to various events on the B&O network including: - All Standby Events @@ -58,11 +58,11 @@ The plugin can respond to various events on the B&O network including: These events can be found under the 'BeoGateway Plugin Event' list in Indigo's Create New Trigger dialogue -

Plugin Actions +### Plugin Actions Indigo Events can trigger a number of actions on the B&O Network including: -

BeoGateway Plugin Actions: +#### BeoGateway Plugin Actions: - Request BLGW Home Integration Protocol State Updates for all devices - Send a BLGW Home Integration Protocol Command (*only on BLGW - see below*) @@ -71,7 +71,7 @@ Indigo Events can trigger a number of actions on the B&O Network including: - Post a Message to the Notification Centre (*see below*) - Send All Standby Command -

BeoGateway Device Actions: +#### BeoGateway Device Actions: - Send Beo4 Source Selection Command - Send Beo4 Key @@ -79,7 +79,7 @@ Indigo Events can trigger a number of actions on the B&O Network including: - Send BeoRemote One Key - Request Device State Update -

Protocol Monitoring +### Protocol Monitoring Network traffic monitoring to the Indigo log be toggled in the plugin config menu: - [x] Verbose Mode @@ -113,7 +113,7 @@ BeoGateway Plugin volume: 26 ``` -

Apple Music Control +### Apple Music Control Apple Music control can be toggled in the plugin config menu: - [x] Control Apple Music @@ -141,7 +141,7 @@ The controls are mapped as follows: | Red | Red | More of the Same | Blue | Blue | Play the Album that the Current Track Resides On -

State Reporting in Apple Notification Centre +### State Reporting in Apple Notification Centre State reports in the notification centre can be toggled in the config menu - [x] Post Notifications @@ -151,7 +151,7 @@ State reports in the notification centre can be toggled in the config menu It is also possible to trigger notifications via any Indigo event using the action: "BeoGateway Plugin Actions/Post Message in Notification Centre" -

Home Integration Protocol Commands +### Home Integration Protocol Commands The BeoLink Gateway (BLGW) provides a Home Integration Protocol for external automation services to communicate with devices ont he B&O Network. A copy of the documentation for the protocol is included in the plugin's Resources/Documentation folder, and the overview below is lifted from that document. @@ -212,7 +212,7 @@ commands or events. ``` c */*/BUTTON/*/PRESS" + CR + LF ``` -

Credits +## Credits The code draws heavily on the existing [MLGW](https://github.com/giachello/mlgw) project by user Giachello, but is recoded for Python 2.7. His work underpins the decoding of raw MasterLink packets for the ML Command Line Protocol.