+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. +
+ +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 index 4bc83ad9537..46244107308 100644 --- a/source/_components/sensor.usps.markdown +++ b/source/_components/sensor.usps.markdown @@ -13,27 +13,6 @@ ha_release: 0.36 ha_iot_class: "Cloud Polling" --- -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 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. +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, add the following lines to your `configuration.yaml`: - -```yaml -# Example configuration.yaml entry -sensor: - - platform: usps - username: YOUR_USERNAME - password: YOUR_PASSWORD -``` - -You will see two new sensors, one for packages and one for mail. - -Configuration options for the USPS Sensor: - -- **username** (*Required*): The username to access the MyUSPS service. -- **password** (*Required*): The password for the given username. -- **name** (*Optional*): Prefix for sensor names (defaults to "USPS") - --The USPS sensor logs into the MyUSPS website to scrape package data. It does not use an API. -
+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 new file mode 100644 index 00000000000..af9b12c4f8c --- /dev/null +++ b/source/_components/usps.markdown @@ -0,0 +1,38 @@ +--- +layout: page +title: USPS +description: "Interface USPS mail and package information to Home Assistant." +date: 2017-07-28 20:00 +sidebar: true +comments: false +sharing: true +footer: true +logo: usps.png +ha_category: Hub +ha_release: 0.52 +ha_iot_class: "Cloud Polling" +--- + +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 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. + +To enable this component, add the following lines to your `configuration.yaml`: + +```yaml +# Example configuration.yaml entry +usps: + username: YOUR_USERNAME + password: YOUR_PASSWORD +``` + +You will see two new sensors, one for packages and one for mail and a camera to rotate through images of incoming mail for the current day. + +Configuration options for the USPS component: + +- **username** (*Required*): The username to access the MyUSPS service. +- **password** (*Required*): The password for the given username. +- **name** (*Optional*): Prefix for sensor names (defaults to "USPS") + ++The USPS sensor logs into the MyUSPS website to scrape package data. It does not use an API. +