Split out fastdotcom into a sensor and component

source/_components/fastdotcom.markdown

@@ -0,0 +1,86 @@
+---
+layout: page
+title: "Fast.com"
+description: "How to integrate Fast.com within Home Assistant."
+date: 2019-02-01 21:30
+sidebar: true
+comments: false
+sharing: true
+footer: true
+logo: fastdotcom.png
+ha_category:
+  - System Monitor
+  - Sensor
+featured: false
+ha_release: 0.88
+ha_iot_class: "Cloud Polling"
+redirect_form:
+  - /components/sensor.fastdotcom/
+---
+
+The `fastdotcom` component uses the [Fast.com](https://fast.com/) web service to measure network bandwidth performance.
+
+<p class='note'>
+Currently fast.com only supports measuring download bandwidth. If you want to measure bandwidth metrics other then download such as ping and upload, utilize the [speedtest](/components/sensor.speedtest) component.
+</p>
+
+Enabling this component will automatically create the Fast.com Sensor.
+
+By default, a speed test will be run every hour. The user can change the update frequency in the configuration by defining the `update_interval` for a speed test to run.
+
+## {% linkable_title Configuration %}
+
+To add Fast.com to your installation, add the following to your `configuration.yaml` file:
+
+Once per hour, on the hour (default):
+
+```yaml
+fastdotcom:
+```
+
+Every half hour of every day:
+
+```yaml
+fastdotcom:
+  update_interval:
+      minutes: 30
+```
+
+{% configuration %}
+update_interval:
+  description: "Minimum time interval between updates. Supported formats: `update_interval: 'HH:MM:SS'`, `update_interval: 'HH:MM'` and Time period dictionary (see example below)."
+  required: false
+  default: 60 minutes
+  type: time
+manual:
+  description: Turn manual mode on or off. Manual mode will disable scheduled speedtests.
+  required: false
+  default: false
+  type: boolean
+{% endconfiguration %}
+
+#### {% linkable_title Time period dictionary example %}
+
+```yaml
+update_interval:
+  # At least one of these must be specified:
+  days: 0
+  hours: 0
+  minutes: 3
+  seconds: 30
+  milliseconds: 0
+```
+
+### {% linkable_title Service %}
+
+Once loaded, the `fastdotcom` component will expose a service (`fastdotcom.speedtest`) that can be called to run a Fast.com speed test on demand. This service takes no parameters. This can be useful if you have enabled manual mode.
+
+```yaml
+action:
+  service: fastdotcom.speedtest
+```
+
+## {% linkable_title Notes %}
+
+- When running on Raspberry Pi, the maximum speed is limited by its 100 Mbit/s LAN adapter.
+- The sensor will return the maximum measured speed during a 15-second test.