Upgrade Prusa Link to new /v1/ API (#29699)

* Upgrade PrusaLink documentation

* Update wording

* Update codeowners

* PrusaLink: add info on credentials (#30012)

* Add links how to update the printer

* tiny tweaks

---------

Co-authored-by: c0ffeeca7 <38767475+c0ffeeca7@users.noreply.github.com>
This commit is contained in:
Niklas Wagner 2023-12-20 08:41:17 +01:00 committed by GitHub
parent c2645278cf
commit 578fe72d93
No known key found for this signature in database
GPG Key ID: 4AEE18F83AFDEB23

View File

@ -8,6 +8,7 @@ ha_release: '2022.9'
ha_config_flow: true
ha_codeowners:
- '@balloob'
- '@Skaronator'
ha_domain: prusalink
ha_integration_type: integration
ha_platforms:
@ -17,16 +18,21 @@ ha_platforms:
ha_dhcp: true
---
The PrusaLink integration allows you to monitor your [Prusa 3D printer](https://www.prusa3d.com) and its progress with your Home Assistant installation. This integration works with Prusa MINI and Prusa MK4.
This integration requires PrusaLink v2. If you have the Prusa MINI, you need to run firmware 4.4.0 or later.
The PrusaLink integration allows you to monitor your [Prusa 3D printer](https://www.prusa3d.com) and its progress with your Home Assistant installation. This integration works with Prusa MINI, Prusa MK3.9/MK4 and Prusa XL. It does not work with the older Raspberry Pi Prusa Link printers.
When adding the integration, you will be asked to provide a {% term host %} and an API key. These are the credentials you set up when setting up PrusaLink on your printer.
This integration has been updated to utilize the latest v1 API endpoints, which require firmware version 4.7.0 or later. If you own a Prusa Mini, please make sure your printer is running firmware 5.1.0 or a more recent version. Firmware versions 4.7.x and 5.0.x are not available for this model.
To obtain the host name and API key/password:
Firmware update guides can be found here:
- [Prusa Mini](https://help.prusa3d.com/article/firmware-updating-mini-mini_124784)
- [Prusa MK4/XL](https://help.prusa3d.com/article/how-to-update-firmware-mk4-xl_453086)
To obtain the hostname, username, and password:
- On your printer, navigate to **Settings** > **Network** > **PrusaLink**.
- Find the device's **IP address**. Alternatively, you can look for the printer's IP address or hostname on your router.
- Depending on your model, the entry may not be called **API key**, but **Password**.
- Note that for some models, the username may not be visible, as it is hardcoded to `maker`.
- Depending on your model, the entry may not be called **Password**, but **API key**.
{% include integrations/config_flow.md %}