Add docs for media_player.ps4 component (#8146)

* Created docs for media_player.ps4

* Added PlayStation 4 Logo

* ✏️ Tweaks

* Updated for Integrations/ Renamed

* Update ps4.markdown

* Added service docs.

* Update services.

* typo

* Update ps4.markdown

* updated docs

* Update media_player.ps4.markdown

* Update media_player.ps4.markdown

* Update media_player.ps4.markdown

* Update media_player.ps4.markdown

* Update ha_release to 0.89

source/_components/media_player.ps4.markdown

@@ -0,0 +1,114 @@
+---
+layout: page
+title: "Sony PlayStation 4"
+description: "Instructions on how to integrate a Sony PlayStation 4 into Home Assistant."
+date: 2019-02-12 01:08
+sidebar: true
+comments: false
+sharing: true
+footer: true
+logo: ps4.png
+ha_category: Media Player
+ha_release: 0.89
+ha_iot_class: "Local Polling"
+---
+
+The `ps4` component allows you to control a
+[Sony PlayStation 4 console](https://www.playstation.com/en-us/explore/ps4/).
+
+- This component supports controlling a single PlayStation 4 for your instance. Additional consoles may be supported in a future release.
+
+## {% linkable_title Requirements %}
+
+- Android or iOS device
+- PS4 Second Screen App for [Android](https://play.google.com/store/apps/details?id=com.playstation.mobile2ndscreen&hl=en_US) or [iOS](https://itunes.apple.com/us/app/ps4-second-screen/id1201372796?mt=8) installed on device.
+
+## {% linkable_title Set up %}
+
+1. Download the Second Screen App and make sure that you can find and control your PlayStation 4 normally.
+
+<p class='note'>
+  Read the section "Granting Port Access" below before continuing.
+</p>
+
+2. Navigate to `Configuration -> Integrations` and select `Configure` for `PlayStation 4`.
+
+3. Follow instructions displayed to generate user credentials. You will know this step is completed when a form with fields appears.
+
+4. Pair Home Assistant to your PlayStation 4 by filling in the fields.
+- **Note:** To find your correct region refer to the section [Regions](#regions)
+
+## {% linkable_title Granting Port Access %}
+
+The PlayStation 4 component requires the use of privileged ports to work correctly, specifically UDP port 987 and TCP port 997. Depending on your OS of your Home Assistant instance you may need to allow usage of privileged ports manually.
+Home Assistant installed on a Debian-type OS for example, such as *Debian*, *Hassbian*, *Rassbian*, and *Armbian* may require configuration.
+
+<p class='note warning'>
+  Do not run your <b>Home Assistant</b> instance itself as <b>root</b> or with <b>root/sudo privileges</b> to accomplish this. This would create a security risk for your host system.
+</p>
+
+There are varying methods to perform this, dependent on your OS that is running Home Assistant. Specifically, your *Python Interpreter* which runs your Home Assistant instance needs access to the mentioned ports.
+
+<p class='note'>
+  If your Home Assistant device is running <b>Hass.io</b> on <b>HassOS</b>, it does not require additional configuration.
+</p>
+
+- Example for Debian:
+`sudo setcap 'cap_net_bind_service=+ep' /usr/bin/python3.5`
+Replace "/usr/bin/python3.5" with your path to Python that is running Home Assistant.
+
+
+## {% linkable_title Configuration %}
+
+<p class='note'>
+  The PlayStation 4 component does not use entries from `configuration.yaml`. You must configure this component by using `Integrations`
+</p>
+
+## {% linkable_title Regions %}
+
+Some titles will have different SKUs in the PlayStation Store database depending on your region. You must select your specific region in the setup in order to retrieve the cover art for such titles correctly. If you do not know your [region](https://www.gamerbraves.com/ps4-games-region-codes-explained/), reference the table below:
+
+|  Region ID  |  Locales                                       |
+| ----------- | ---------------------------------------------- |
+| R1          | Bermuda, Canada, United States                 |
+|             | and U.S. territories                           |
+| R2          | The Middle East, Western Europe,               |
+|             | Central Europe, Egypt,                         |
+|             | French overseas territories, Greenland,        |
+|             | Japan, Lesotho, South Africa and Swaziland     |
+| R3          | Southeast Asia, Hong Kong, Macau,              |
+|             | South Korea and Taiwan                         |
+| R4          | Australasia, Central America,                  |
+|             | the Caribbean, Mexico, Oceania, South America  |
+| R5          | The rest of Africa, Former Soviet Union,       |
+|             | the Indian subcontinent, Mongolia, North Korea |
+
+<p class='note'>
+  Region 6: Mainland China, is not supported as there is no English database available.
+</p>
+
+## {% linkable_title Services %}
+
+### {% linkable_title Service `send_command` %}
+
+Emulate button press on PlayStation 4. This emulates the commands available for the PS4 Second Screen App. This is not to be confused with DualShock 4 controller buttons.
+
+| Service data attribute | Optional | Example                      | Description                           |
+| ---------------------- | -------- | ---------------------------- | ------------------------------------- |
+| `entity_id`            | No       | `media_player.playstation_4` | The entity id for your PlayStation 4. |
+| `command`              | No       | `ps`                         | The command you want to send.         |
+
+#### {% linkable_title Available Commands %}
+
+Full list of supported commands.
+
+| Command  | Button Emulated  |
+| -------- | ---------------- |
+| `ps`     | PS (PlayStation) |
+| `option` | Option           |
+| `enter`  | Enter            |
+| `back`   | Back             |
+| `up`     | Swipe Up         |
+| `down`   | Swipe Down       |
+| `left`   | Swipe Left       |
+| `right`  | Swipe Right      |