home-assistant.io/source/_components/fastdotcom.markdown

layout, title, description, date, sidebar, comments, sharing, footer, logo, ha_category, featured, ha_release, ha_iot_class, redirect_from

layout	title	description	date	sidebar	comments	sharing	footer	logo	ha_category	featured	ha_release	ha_iot_class	redirect_from
page	Fast.com	How to integrate Fast.com within Home Assistant.	2019-02-01 21:30	true	false	true	true	fastdotcom.png	System Monitor Sensor	false	0.88	Cloud Polling	/components/sensor.fastdotcom/

The fastdotcom component uses the Fast.com web service to measure network bandwidth performance.

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.

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):

fastdotcom:

Every half hour of every day:

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 %}

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.

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.