This Home Assistant integration allows you to monitor the status and attributes of your Elegoo 3D printer, bringing valuable information directly into your smart home dashboard. Currently, this integration focuses on exposing sensor data, providing insights into your printer's operation and status. More features and controls may be added in future updates.
This integration currently exposes the following sensors for your Elegoo Printer:
These sensors tell you about the printer's capabilities and limits. Think of them as the printer's specifications.
- Maximum Release Film Usage: Shows the maximum lifespan or usage limit for the release film.
- Maximum UV LED Temperature: The highest temperature the UV LED is allowed to reach. (Unit: °C)
- Connected Video Streams: How many video streams are currently connected to the printer.
- Maximum Video Streams: The maximum number of video streams you can connect at the same time.
These sensors give you live updates on the printer's current operation and the progress of your print job.
- UV LED Temperature: The current temperature of the UV LED. (Unit: °C)
- Total Print Time: The total amount of time this printer has been printing, ever. (Unit: Milliseconds, displayed in Hours)
- Current Print Time: How long the current print job has been running. (Unit: Milliseconds, displayed in Hours)
- Remaining Print Time: The estimated time left for the current print job to finish. (Unit: Milliseconds, displayed in Hours)
- Total Layers: The total number of layers in the print job.
- Current Layer: Which layer is being printed right now.
- Remaining Layers: How many layers are left to print.
- Print Completion Percentage: How much of the print job is finished. (Unit: %)
- File Name: The name of the file you're printing.
- Print Status: What the printer is currently doing (e.g., "Printing," "Idle," "Error").
- Print Error: If there's a problem, this will show the type of error.
- Release Film Status: The current status of the release film.
This integration is installed manually through the Home Assistant Community Store (HACS) as it is not yet in the default HACS repository. Follow these steps to install:
-
Ensure HACS is Installed: If you don't have HACS installed, follow the HACS installation instructions first.
-
Add Custom Repository:
- Go to your Home Assistant instance.
- Navigate to HACS > Integrations.
- Click the three dots in the top right corner and select "Custom repositories".
- In the "Add custom repository" dialog:
- Repository URL:
https://github.com/danielcherubini/elegoo-homeassistant - Category: Select "Integration".
- Repository URL:
- Click "ADD".
-
Install the Integration:
- Navigate to HACS > Integrations.
- Click the "+" Explore & download repositories button in the bottom right corner.
- Search for "Elegoo Printer" (or the name of your repository if different).
- Click on the Elegoo Printer Integration card.
- Click "Download" in the bottom right corner.
- Select the desired version (usually the latest) and click "Download".
-
Restart Home Assistant: After the installation is complete, restart your Home Assistant instance for the integration to be loaded.
Currently, this integration needs to know your IP Address of your printer, in the future it will automatically find it on your network. So when you add a printer it will ask for your IP Address.
This is the initial release of the Elegoo Printer integration, focusing on sensor data. Future updates may include:
- More Sensors: Exposure of additional printer parameters and status information.
- Control Features: Potential for controlling printer functions directly from Home Assistant (e.g., starting/stopping prints, pausing, etc.).
- Support for more Elegoo Printer Models: Expanding compatibility to a wider range of Elegoo printers.
Stay tuned for updates and feel free to contribute with feature requests and bug reports!
For any issues or feature requests, please open an issue on the GitHub repository. Contributions are welcome!
This integration is released under the MIT License.