Creality | ioBroker

Для чего нужен этот адаптер?

Обеспечивает подключение принтеров Creality Klipper (основная целевая платформа: SPARKX i7 с CFS lite) к ioBroker через два локальных API:

Moonraker HTTP (порт по умолчанию)7125 ) — статистика печати, температура, вентиляторы, коробка с филаментом CFS, G-код
Creality WebSocket (порт по умолчанию)9999 ) — Светодиодная индикация положения инструмента, пауза/возобновление/остановка, состояние пользовательского интерфейса выравнивания/самотестирования, оставшееся время (printLeftTime )

Одного Moonraker недостаточно для корректной работы Creality UI (например, прокачка уровня, пока Klipper продолжает сообщать о прогрессе).standby ) или подсветка инструментальной головки.

Производитель: Creality . Другие модели Creality Klipper могут работать с перебоями; на данный момент протестирована только модель SPARKX i7.

Конфигурация

Параметр	По умолчанию	Описание
Хост / IP-адрес	—	Адрес принтера (обязательно)
Порт HTTP Moonraker	`7125`	Обратный прокси Fluidd часто использует`4408`
Порт Creality WebSocket	`9999`	Светодиодная индикация и элементы управления печатью на инструментальной головке.
Интервал опроса	`5` с	Опрос Moonraker (мин. 2 с)
ключ API	пустой	Дополнительная авторизация Moonraker
Управление печатью / CFS / Вентиляторы	на	Переключатели функций для дерева состояний

Один принтер на один адаптер.

Точки данных

Подcreality.<instance>.* (примеры):

Состояние	Описание
`state` /`stateKlipper` /`selfTestStep`	Статус пользовательского интерфейса / Klipper
`currentJob.*`	Ход выполнения, файл, время, слои, подача/поток, активная нить
`info.*`	Модель, прошивка, имя хоста, серийный номер, диск, часы/задания печати, ошибки
`temp.*`	Форсунка, основание, коробка/камера
`fans.partCooling`	Процент охлаждения детали (соответствует показаниям слайсера/принтера; Creality)`fan0_min` переназначение)
`fans.partCoolingPwm`	Охлаждение детали с помощью ШИМ в процентах (рабочий цикл аппаратного обеспечения из Moonraker)
`fans.` /`cfs.`	Другие вентиляторы / CFS (опционально)
`control.light` /`sleepMode` /`pause` /`resume` /`stop`	Элементы управления
`webcam.available`	Камера присутствует (только для чтения; локальный API не может её выключить на SPARKX i7).
`webcam.streamUrl`	URL для iframe VIS (страница Creality WebRTC, по умолчанию)`http://<host>:8000` )
`webcam.webrtcUrl`	конечная точка сигнализации WebRTC

Примечание к веб-камере: SPARKX использует WebRTC на этом порту.8000 не классический MJPEG.webcam.streamUrl Ссылки на страницу просмотра Creality — можно использовать в iframe VIS, если браузер может получить доступ к IP-адресу принтера. Для использования с Home Assistant / go2rtc.webcam.webrtcUrl .

Поддерживать

Если вам нравится наша работа и вы хотели бы нас поддержать, мы будем благодарны за любое пожертвование. (Эта ссылка ведет на наш счет PayPal и не связана с ioBroker.)

Changelog

0.4.1 (2026-08-25)

(skvarel) Fixed currentJob.filament* for external spool holder (filament_rack) when CFS is not active

0.4.0 (2026-08-20)

(skvarel) Adapter requires admin >= 7.8.23 now.

0.3.0 (2026-08-14)

(skvarel) Fixed button states control.pause|resume|stop to use read: false
(skvarel) Added manufacturer / SPARKX i7 product links to README
(skvarel) Modified CFS temperature/humidity roles to value.temperature / value.humidity
(skvarel) Modified Moonraker poll loop to use setTimeout chain instead of setInterval
(skvarel) Modified currentJob.finishAt to include local date (YYYY-MM-DD HH:MM)

0.2.0 (2026-08-08)

(skvarel) Fixed part cooling fan % to match slicer/display (Creality fan0_min remapping)
(skvarel) Added fans.partCoolingPwm for raw PWM duty cycle

0.1.4 (2026-08-02)

(skvarel) Fixed string state roles for repository object check

License

MIT License

Permission is hereby granted, free of charge, to any person obtaining a copy of this software and associated documentation files (the "Software"), to deal in the Software without restriction, including without limitation the rights to use, copy, modify, merge, publish, distribute, sublicense, and/or sell copies of the Software, and to permit persons to whom the Software is furnished to do so, subject to the following conditions:

The above copyright notice and this permission notice shall be included in all copies or substantial portions of the Software.

THE SOFTWARE IS PROVIDED "AS IS", WITHOUT WARRANTY OF ANY KIND, EXPRESS OR IMPLIED, INCLUDING BUT NOT LIMITED TO THE WARRANTIES OF MERCHANTABILITY, FITNESS FOR A PARTICULAR PURPOSE AND NONINFRINGEMENT. IN NO EVENT SHALL THE AUTHORS OR COPYRIGHT HOLDERS BE LIABLE FOR ANY CLAIM, DAMAGES OR OTHER LIABILITY, WHETHER IN AN ACTION OF CONTRACT, TORT OR OTHERWISE, ARISING FROM, OUT OF OR IN CONNECTION WITH THE SOFTWARE OR THE USE OR OTHER DEALINGS IN THE SOFTWARE.