Add Mikrotik hub category and update example config (home-assistant#10044)

slackr31337 · frenck · commit 429995413cfc · 2019-08-08T20:30:09.000+02:00
* Updating for Mikrotik Hub

* Add hub category and example config
diff --git a/source/_components/mikrotik.markdown b/source/_components/mikrotik.markdown
@@ -3,6 +3,7 @@ title: "MikroTik"
 description: "Instructions on how to integrate MikroTik/RouterOS based devices into Home Assistant."
 logo: mikrotik.png
 ha_category:
+  - Hub
   - Presence Detection
 ha_release: 0.44
 redirect_from:
@@ -11,7 +12,11 @@ redirect_from:
 
 The `mikrotik` platform offers presence detection by looking at connected devices to a [MikroTik RouterOS](http://mikrotik.com) based router.
 
-## Configuring `mikrotik` device tracker
+There is currently support for the following device types within Home Assistant:
+
+- Presence Detection
+
+## Configuring `mikrotik` hub
 
 You have to enable accessing the RouterOS API on your router to use this platform.
 
@@ -33,9 +38,8 @@ To use a MikroTik router in your installation, add the following to your `config
 
 ```yaml
 # Example configuration.yaml entry
-device_tracker:
-  - platform: mikrotik
-    host: IP_ADDRESS
+mikrotik:
+  - host: IP_ADDRESS
     username: ROUTEROS_USERNAME
     password: ROUTEROS_PASSWORD
 ```
@@ -70,9 +74,14 @@ ssl:
   default: false
   type: boolean
 method:
-  description: Override autodetection of device scanning method. Can be `wireless` to use local wireless registration, `capsman` for capsman wireless registration, or `ip` for DHCP leases.
+  description: Override autodetection of device scanning method. Can be `wireless` to use local wireless registration, `capsman` for capsman wireless registration, or `dhcp` for DHCP leases.
   required: false
   type: string
+arp_ping:
+  description: Use ARP ping with DHCP method for device scanning.
+  required: false
+  default: false
+  type: boolean
 {% endconfiguration %}
 
 <div class='note info'>
@@ -113,17 +122,25 @@ To use this device tracker you need restricted privileges only. To enhance the s
 /user set password="YOUR_PASSWORD" homeassistant
 ```
 
-## Using the additional configuration to the `mikrotik` device tracker entry in your `configuration.yaml` file:
+## Using the additional configuration to the `mikrotik` entry in your `configuration.yaml` file:
 
 ```yaml
-device_tracker:
-  - platform: mikrotik
-    host: 192.168.88.1
+mikrotik:
+  - host: 192.168.88.1
+    username: homeassistant
+    password: YOUR_PASSWORD
+    ssl: true
+    arp_ping: true
+    method: dhcp
+    track_devices: true
+
+  - host: 192.168.88.2
     username: homeassistant
     password: YOUR_PASSWORD
     ssl: true
     port: 8729
     method: capsman
+    track_devices: true
 ```
 
 See the [device tracker integration page](/components/device_tracker/) for instructions on how to configure the people to be tracked.
