HomeKit Restructure (new config options) (#12997)

* Restructure
* Pincode will now be autogenerated and display using a persistence notification
* Added 'homekit.start' service
* Added config options
* Renamed files for types
* Improved tests
* Changes (based on feedback)
* Removed CONF_PIN_CODE
* Added services.yaml
* Service will only be registered if auto_start=False
* Bugfix names, changed default port
* Generate aids with zlib.adler32
* Added entity filter, minor changes
* Small changes

homeassistant/components/homekit/util.py

@@ -0,0 +1,46 @@
+"""Collection of useful functions for the HomeKit component."""
+import logging
+
+import voluptuous as vol
+
+from homeassistant.core import split_entity_id
+from homeassistant.const import (
+    ATTR_CODE)
+import homeassistant.helpers.config_validation as cv
+from .const import HOMEKIT_NOTIFY_ID
+
+_LOGGER = logging.getLogger(__name__)
+
+
+def validate_entity_config(values):
+    """Validate config entry for CONF_ENTITY."""
+    entities = {}
+    for key, config in values.items():
+        entity = cv.entity_id(key)
+        params = {}
+        if not isinstance(config, dict):
+            raise vol.Invalid('The configuration for "{}" must be '
+                              ' an dictionary.'.format(entity))
+
+        domain, _ = split_entity_id(entity)
+
+        if domain == 'alarm_control_panel':
+            code = config.get(ATTR_CODE)
+            params[ATTR_CODE] = cv.string(code) if code else None
+
+        entities[entity] = params
+    return entities
+
+
+def show_setup_message(bridge, hass):
+    """Display persistent notification with setup information."""
+    pin = bridge.pincode.decode()
+    message = 'To setup Home Assistant in the Home App, enter the ' \
+              'following code:\n### {}'.format(pin)
+    hass.components.persistent_notification.create(
+        message, 'HomeKit Setup', HOMEKIT_NOTIFY_ID)
+
+
+def dismiss_setup_message(hass):
+    """Dismiss persistent notification and remove QR code."""
+    hass.components.persistent_notification.dismiss(HOMEKIT_NOTIFY_ID)