jeena/home-assistant.github.io
1
0
Fork 0
Code Issues Pull requests Projects Packages Wiki Activity Actions

Updated docs for USPS component camera addition (#3074)

Browse source 
* Updated docs for USPS component camera addition

* Bump to 0.51 release

* Bump release to 0.52

* Sync docs with final PR

* Fix typo
This commit is contained in:
John Mihalic 2017-08-20 15:40:30 -04:00 • committed by Fredrik Lindqvist
parent c0fa3e6d1e
commit 0aebbe3fcf
3 changed files with 71 additions and 23 deletions
Download patch file Download diff file Expand all files Collapse all files

25
source/_components/sensor.usps.markdown
View file

@ -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")
<p class='note warning'>
The USPS sensor logs into the MyUSPS website to scrape package data. It does not use an API.
</p>
To enable this sensor in your installation, set up the [USPS component](/components/usps) with your username and password.