From db67c4db0b3e39eb7ff5a6d02413a65fec211210 Mon Sep 17 00:00:00 2001 From: Klaas Schoute Date: Mon, 25 Feb 2019 19:44:29 +0100 Subject: [PATCH] =?UTF-8?q?=F0=9F=9A=9C=20Merges/Redirect=20USPS=20compone?= =?UTF-8?q?nt=20pages=20(#8732)?= MIME-Version: 1.0 Content-Type: text/plain; charset=UTF-8 Content-Transfer-Encoding: 8bit --- source/_components/camera.usps.markdown | 32 ------------------- source/_components/sensor.usps.markdown | 18 ----------- source/_components/usps.markdown | 42 ++++++++++++++++++++++--- 3 files changed, 38 insertions(+), 54 deletions(-) delete mode 100644 source/_components/camera.usps.markdown delete mode 100644 source/_components/sensor.usps.markdown diff --git a/source/_components/camera.usps.markdown b/source/_components/camera.usps.markdown deleted file mode 100644 index e589a349a57..00000000000 --- a/source/_components/camera.usps.markdown +++ /dev/null @@ -1,32 +0,0 @@ ---- -layout: page -title: USPS Camera -description: "Instructions on how to set up USPS camera within Home Assistant." -date: 2017-07-28 20:00 -sidebar: true -comments: false -sharing: true -footer: true -logo: usps.png -ha_category: Camera -ha_release: 0.52 -ha_iot_class: "Cloud Polling" ---- - -The `usps` camera component allows you to view the mail piece images made available through USPS via the Informed Delivery service. You must "Opt-In" to [Informed Delivery](https://informeddelivery.usps.com/box/pages/intro/start.action) to see mail images. This works in concert with [USPS sensors](/components/sensor.usps). - -

-You must have the [USPS component](/components/usps/) configured to use this camera. The camera will be setup if the `usps` component is configured and the required configuration is set. -

- -## {% linkable_title Configuration %} - -To customize the interval that mail images are rotated in the mail camera you can edit your `configuration.yaml` file with the following settings: -```yaml -# Example configuration.yaml entry -camera: - - platform: usps - scan_interval: 5 -``` - -To enable this camera in your installation, set up the [USPS component](/components/usps) with your username and password. diff --git a/source/_components/sensor.usps.markdown b/source/_components/sensor.usps.markdown deleted file mode 100644 index 89d7029a0a8..00000000000 --- a/source/_components/sensor.usps.markdown +++ /dev/null @@ -1,18 +0,0 @@ ---- -layout: page -title: USPS Sensor -description: "Instructions on how to set up USPS sensors within Home Assistant." -date: 2017-01-06 08:00 -sidebar: true -comments: false -sharing: true -footer: true -logo: usps.png -ha_category: Postal Service -ha_release: 0.36 -ha_iot_class: "Cloud Polling" ---- - -The `usps` sensor component allows you to view statistics on incoming mail and packages made available through USPS via the Informed Delivery service. You must "Opt-In" to [Informed Delivery](https://informeddelivery.usps.com/box/pages/intro/start.action) to see mail images. This works in concert with [USPS camera](/components/camera.usps). - -To enable this sensor in your installation, set up the [USPS component](/components/usps) with your username and password. diff --git a/source/_components/usps.markdown b/source/_components/usps.markdown index ed59717190f..5d11f98817c 100644 --- a/source/_components/usps.markdown +++ b/source/_components/usps.markdown @@ -8,29 +8,40 @@ comments: false sharing: true footer: true logo: usps.png -ha_category: Postal Service +ha_category: + - Postal Service + - Camera + - Sensor ha_release: 0.52 ha_iot_class: "Cloud Polling" +redirect_from: + - /components/camera.usps/ + - /components/sensor.usps/ --- The `usps` platform allows one to track deliveries and inbound mail from the [US Postal Service (USPS)](https://www.usps.com/). In addition to having a USPS account, you will need to complete the "Opt-In" process for packages by clicking "Get Started Now" on [this page](https://my.usps.com/mobileWeb/pages/intro/start.action). You must also "Opt-In" to [Informed Delivery](https://informeddelivery.usps.com/box/pages/intro/start.action) to see inbound mail. +There is currently support for the following device types within Home Assistant: + +- [Camera](#camera) +- [Sensor](#sensor) + ## {% linkable_title Prerequisites %} This component requires that a headless-capable web browser is installed on your system - either PhantomJS or Google Chrome. Preferably use Chrome if your operating system supports it, since PhantomJS is deprecated.

- If you are using a Raspberry Pi, you must use PhantomJS. +If you are using a Raspberry Pi, you must use PhantomJS.

- Hass.io containers are based on Alpine Linux. PhanthomJS is not available for Alpine Linux. Therefore it is currently not possible to use this component on Hass.io. +Hass.io containers are based on Alpine Linux. PhanthomJS is not available for Alpine Linux. Therefore it is currently not possible to use this component on Hass.io.

### {% linkable_title PhantomJS %} -Install the latest version of [PhantomJS]( http://phantomjs.org/download.html). Ensure the executable is on your `PATH`. `phantomjs --version` should work and report the correct version. This is the default option and requires no further configuration. +Install the latest version of [PhantomJS](http://phantomjs.org/download.html). Ensure the executable is on your `PATH`. `phantomjs --version` should work and report the correct version. This is the default option and requires no further configuration.

Don't use apt-get to install PhantomJS. This version is not compatible. @@ -86,3 +97,26 @@ name:

The USPS sensor logs into the MyUSPS website to scrape package data. It does not use an API.

+ +## {% linkable_title Camera %} + +The `usps` camera component allows you to view the mail piece images made available through USPS via the Informed Delivery service. You must "Opt-In" to [Informed Delivery](https://informeddelivery.usps.com/box/pages/intro/start.action) to see mail images. This works in concert with [USPS sensors](#sensor). + +### {% linkable_title Configuration %} + +To customize the interval that mail images are rotated in the mail camera you can edit your `configuration.yaml` file with the following settings: + +```yaml +# Example configuration.yaml entry +camera: + - platform: usps + scan_interval: 5 +``` + +To enable this camera in your installation, set up the USPS component first. + +## {% linkable_title Sensor %} + +The `usps` sensor component allows you to view statistics on incoming mail and packages made available through USPS via the Informed Delivery service. You must "Opt-In" to [Informed Delivery](https://informeddelivery.usps.com/box/pages/intro/start.action) to see mail images. This works in concert with [USPS camera](#camera). + +To enable this sensor in your installation, set up the USPS component first. \ No newline at end of file