From 76ab93af93a82762fcbfdce842fd0375f476050c Mon Sep 17 00:00:00 2001 From: Mike O'Driscoll Date: Mon, 12 Feb 2018 22:44:22 -0500 Subject: [PATCH] Add documentation for new Start.ca sensor (#4658) New sensor for ISP usage data for Start.ca --- source/_components/sensor.startca.markdown | 84 +++++++++++++++++++++ source/images/supported_brands/startca.png | Bin 0 -> 24554 bytes 2 files changed, 84 insertions(+) create mode 100644 source/_components/sensor.startca.markdown create mode 100644 source/images/supported_brands/startca.png diff --git a/source/_components/sensor.startca.markdown b/source/_components/sensor.startca.markdown new file mode 100644 index 00000000000..cd92fe272ce --- /dev/null +++ b/source/_components/sensor.startca.markdown @@ -0,0 +1,84 @@ +--- +layout: page +title: "Start.ca" +description: "Instructions on how to integrate Start.ca data usage within Home Assistant." +date: 2018-02-12 00:00 +sidebar: true +comments: false +sharing: true +footer: true +logo: startca.png +ha_category: Sensor +ha_release: 0.64 +ha_iot_class: "Cloud Polling" +--- + +Integrate your [Start.ca](https://www.start.ca/) account information into Home Assistant. + +You can get your API key from: + +[Start.ca Usage API](https://www.start.ca/support/usage/api) + +To use your Start.ca sensor in your installation, add the following to your `configuration.yaml` file: + +```yaml +# Example configuration.yaml entry +sensor: + - platform: startca + api_key: API_KEY + total_bandwidth: 400 + monitored_variables: + - usage + - usage_gb + - limit + - used_download + - used_upload + - used_total + - grace_download + - grace_upload + - grace_total + - total_download + - total_upload + - used_remaining +``` + +{% configuration %} +api_key: + description: The Start.ca API key to access the service. + required: true + type: string +total_bandwidth: + description: Your bandwidth limit in gigabytes. Set to `0` for unlimited plans without a cap. + required: true + type: string +monitored_conditions: + description: Conditions to display in the frontend. + required: true + type: list + keys: + usage: + description: Bandwidth usage (percentage). + usage_gb: + description: Bandwidth usage (gigabytes). + limit: + description: Monthly bandwidth limit (gigabytes). + used_download: + description: Bandwidth used by download outside the grace period (gigabytes). + used_upload: + description: Bandwidth used by upload outside the grace period (gigabytes). + used_total: + description: Total bandwidth (download and upload sum calculation) used outside the grace period (gigabytes). + grace_download: + description: Bandwidth used by download during the grace period (gigabytes). + grace_upload: + description: Bandwidth used by upload during the grace period (gigabytes). + grace_total: + description: Total bandwidth (download and upload sum calculation) used during the unlimited period (gigabytes). + total_download: + description: Total bandwidth download (Grace + Used) (gigabytes). + total_download: + description: Total bandwidth upload (Grace + Used) (gigabytes). + used_remaining: + description: Remaining bandwidth calucated from used and supplied total bandwidth (gigabytes). +{% endconfiguration %} + diff --git a/source/images/supported_brands/startca.png b/source/images/supported_brands/startca.png new file mode 100644 index 0000000000000000000000000000000000000000..8b64a25c402ec04f669542afd8358c7f96c06b78 GIT binary patch literal 24554 zcmb4rg;yKh7wsejcPZ{tplG4EJA8PdNbzC?iWT=jDK5p`y|_~}K!H-+tw4a{?hY^g zz4iWpM_2@AWoAw;_ujM5-uon6Lrno2gB$|@0Bj{i*|z`yh9Z8SL_?I~D9K7`duARid--b5d5NEF3tf+Xlp+8J z&yO4-A9!|0QXXKDDiw4KW~lBRI44XiEjFm8cZ^iqq&Ml4x7n;$sHPV!930e6pd=@e zGJFb4A^r3PsP{Bez?3dX^T}SNA>i*P9q0Fu7hWAxF#b85srzATZdfC0;fNDObG$~;Ig zX5-&?+9rYIfHUQQbEalL6ZHQcD~M7CsQ!0Qo-73r{@=kU9!`)e;$@TrWR`~Do&TN9 z`@01){_k8$>qKYt-2Yu~lx5@p|AG%SNTj856vT27!Vzb{P4?wk6dyGptNMnZFzDCm zfEPa3jJeNS;MIy{jHk%J6 zo{O9uAOM+HTC2YAM*(oWW+^#UwvJV&2d+z#+ddvt0Uuv9Qottq_xcOgo?tN>QS$mp zK!5s&TYtEEG|GyXPCL-%OdW^`sGz=6sl}57NrGX6T66`wXeS?{1;f3OE)JM2cF^b_!^J-c_+;PD$xsa0>iK`ovUQ7k@?Df*~{4>Jm zP>88&N}ez+HME6ElVlaJ>(pv%cYm&Va6(M%5BVW?haijePFLz;)gBkXUJNxP^`597Pci9qWq= z9hPvN{Vbmev6CE0;@gBo8mq8yzd3g9VGu-tk>XhbR^STLRpi*xZRMqY2leRz8p)3L z@&0$UJ}Jxh!=?fKhKYzs9HRXig`oQ&ZM0OW8hD?=NutnoF5XuNCP)Qbi?_}%1Oe7dYd_h0NvluR;B!4pj3DT0mD*rDbhL%1n^eu6r`RlsP&%&sV_{GmSm z9fnD5VAR;kaUhs=KwKReOVapDufB&z@6%5g5OL@o^|7k>7LbaROOR~jB{osA?sj?) znl><}v8{0ULt+)yYrmPr*1=Guz8W=2%VuG?A z8}7Ohc?=V}iA}YG#_5Cl(#Qk2(UOBoX*HxybqGCiXQpQ#l0W#_=evg*%pYd57*piP z6;QCW8?PrZM$~OgZV`D~!?^h1ML{bY2InQRM!qj9ZdG-q=90IHMs{mtD0za)Y%AW6 z+bpdfqOPdY7F+k3M79WVcX!wHI#F7?l3hWZx{Hw~$l9z8C-Y)5q?S#8F3`4Dh|y)E zzs51;E8Um1N34N>(0(|{eLt1I>&7O9mRaa_a0%CG8+wlcoiW<@SdoX<>hSdkDcyv- zp&pB;W5Vbp32OA?!_8~<9Lj0bW>UBjFgB9j8;b{;7x^Eim581-R&®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 literal 0 HcmV?d00001