diff --git a/source/_components/sense.markdown b/source/_components/sense.markdown new file mode 100644 index 00000000000..63611b0b7be --- /dev/null +++ b/source/_components/sense.markdown @@ -0,0 +1,50 @@ +--- +layout: page +title: Sense +description: "Instructions on how to integrate Sense within Home Assistant." +date: 2018-10-22 22:50 +sidebar: true +comments: false +sharing: true +footer: true +logo: sense.png +ha_category: Energy +ha_iot_class: "Cloud Polling" +ha_release: 0.82 +redirect_from: /components/sensor.sense/ +--- + +Integrate your [Sense](https://sense.com) meter information into Home Assistant. + +## {% linkable_title Configuration %} + +To enable this sensor in your installation, add the following to your `configuration.yaml` file: + +```yaml +# Example configuration.yaml entry +sense: + email: CLIENT_ID + password: CLIENT_SECRET +``` + +Sensors are added for both usage and production with the following names: + +- **Active Usage/Production**: Current active power usage/production in Watts. Updated every 60 seconds. +- **Daily/Weekly/Monthly Usage/Production**: Daily/Weekly/Monthly power usage/production in kWh. Updated every 5 minutes. + +Binary sensors are created for each of the devices detected by your Sense monitor to show their power state. + +{% configuration %} +email: + description: The email associated with your Sense account/application. + required: true + type: string +password: + description: The password for your Sense account/application. + required: true + type: string +timeout: + description: Seconds for timeout of API requests + required: false + type: positive_int +{% endconfiguration %} diff --git a/source/_components/sensor.sense.markdown b/source/_components/sensor.sense.markdown deleted file mode 100644 index f894c5312e2..00000000000 --- a/source/_components/sensor.sense.markdown +++ /dev/null @@ -1,77 +0,0 @@ ---- -layout: page -title: Sense -description: "Instructions on how to integrate Sense within Home Assistant." -date: 2018-01-11 13:50 -sidebar: true -comments: false -sharing: true -footer: true -logo: sense.png -ha_category: Energy -ha_iot_class: "Cloud Polling" -ha_release: 0.65 ---- - - -Integrate your [Sense](https://sense.com) meter information into Home Assistant. - -## {% linkable_title Configuration %} - -To enable this sensor in your installation, add the following to your `configuration.yaml` file: - -```yaml -# Example configuration.yaml entry -sensor: - platform: sense - email: CLIENT_ID - password: CLIENT_SECRET - monitored_conditions: - - active_usage - - active_production - - daily_usage - - daily_production -``` - -Two types of sensors can be monitored and will be created with the following names: - -- **Active Usage/Production**: Current active power usage/production in Watts. Updated every 30 seconds. -- **Daily Usage/Production**: Daily power usage/production in kWh. Updated every 5 minutes. - -Weekly, Monthly and Yearly variants are also available. - -{% configuration %} -email: - description: The email associated with your Sense account/application. - required: true - type: string -password: - description: The password for your Sense account/application. - required: true - type: string -monitored_conditions: - description: List of sensors to display in the front end. - required: true - type: list - keys: - active_usage: - description: The current power usage in W. - active_production: - description: The current solar production in W. - daily_usage: - description: Total power used for current day in kWh. - daily_production: - description: Total power produced for current day in kWh. - weekly_usage: - description: Total power used for current week in kWh. - weekly_production: - description: Total power produced for current week in kWh. - monthly_usage: - description: Total power used for current month in kWh. - monthly_production: - description: Total power produced for current month in kWh. - yearly_usage: - description: Total power used for current year in kWh. - yearly_production: - description: Total power produced for current year in kWh. -{% endconfiguration %}