Kako funkcionira veza 3DPM + HA?

Prije nego počnemo klikati, vrijedi razumjeti što zapravo gradimo — da nam ništa ne izgleda kao magija.

Velika slika

Tvoj Bambu P1S je na Wi-Fi mreži. Home Assistant (HA) se spaja na njega i čita status u realnom vremenu — stvari poput "tiska li trenutno?", "koliko grama filamenta koristi ovaj print?", "koliko minuta je ostalo?".

Kada se status printera promijeni (npr. s idle na running), HA pokreće automatizaciju. Ta automatizacija poziva 3DPM API — praktički šalje poruku "hej, printer upravo je počeo 90-minutni print koji troši 45g filamenta iz slota 1". 3DPM to prima, kreira zapis o printu i skida filament iz inventara — sve automatski.

Tok podataka korak po korak

5 događaja koja pratimo

Što je API ključ?

API ključ je tvoja osobna lozinka za 3DPM API. Dokazuje 3DPM-u da zahtjev dolazi s tvog Home Assistanta — a ne od nekog drugog. Naći ćeš ga u 3DPM pod Settings → API. Izgleda kao dugački niz slučajnih znakova, npr. a8058e74d9d8ec984dd29293...

Što je Printer ID?

Svaki printer koji dodaš u 3DPM dobiva jedinstveni UUID — dugi ID koji izgleda poput b7b71ff0-1a91-11f1-b989-566fc143004c. To govori API-ju koji printer printa. Naći ćeš ga u 3DPM pod Settings → Printers → Edit.

Što ti treba

HACS je community app store za HA. Bez njega ne možeš instalirati Bambu Lab integraciju.

Instaliraj Terminal add-on

1. Idi na Settings → Add-ons → Add-on Store
2. Traži Terminal & SSH i instaliraj
3. Klikni Start pa Open Web UI

Pokreni HACS installer

1. U terminal prozoru zalijepi ovu naredbu i pritisni Enter:

wget -O - https://get.hacs.xyz | bash -

2. Pričekaj zelene poruke — gotovo kad vidiš HACS is now installed
3. Restart HA: Settings → System → Restart

Aktiviraj HACS

1. Idi na Settings → Devices & Services → Add Integration
2. Traži HACS i klikni
3. Prihvati uvjete i poveži GitHub račun (treba besplatni GitHub račun)

1. Klikni HACS u izborniku
2. Klikni Integrations tab
3. Klikni + Explore & Download Repositories
4. Traži: Bambu Lab
5. Odaberi Bambu Lab od autora greghesp
6. Klikni Download → potvrdi
7. Restart HA

1. Idi na Settings → Devices & Services → Add Integration
2. Traži Bambu Lab i klikni
3. Bira se način spajanja: Cloud (upiši email i lozinku Bambu računa) ili Local (upiši IP adresu i Access Code printera)
4. Preporučujemo Cloud za početnike — samo email i lozinka pa gotovo
5. Unesi podatke i klikni Submit

Svaki senzor ima jedinstveni ID oblika: sensor.p1s_SERIJSKIBROJ_naziv_senzora

Kako pronaći

1. Idi na Developer Tools → States
2. U filter upiši p1s
3. Vidiš sve senzore svog P1S printera s njihovim entity ID-ovima

1. Idi na Settings → Add-ons → Add-on Store
2. Traži File editor i instaliraj
3. Uključi Show in sidebar
4. Klikni Start pa Open Web UI

Ovaj fajl govori HA-u kako zvati 3DPM API. Dodajemo 4 REST komande.

API ključ

1. U 3DPM idi na Settings → API
2. Kopiraj API ključ

Otvori fajl

1. U File Editoru klikni ikonu foldera → klikni configuration.yaml

Dodaj na kraj fajla

Zamijeni TVOJ_API_KLJUČ s ključem iz 3DPM:

rest_command:

  3dpm_start_print:
    url: "https://3dprintmanager.eu/api.php?key=TVOJ_API_KLJUČ&action=start_print"
    method: POST
    headers:
      content_type: 'application/json'
    payload: >-
      {
        "printer_id": "{{ printer_id }}",
        "job_name": "{{ job_name | replace('\"', '\\\"') }}",
        "duration_minutes": {{ duration | int(0) }},
        "mapping": {{ mapping | default('[]') }}
      }

  3dpm_finish_print:
    url: "https://3dprintmanager.eu/api.php?key=TVOJ_API_KLJUČ&action=finish_print"
    method: POST
    headers:
      content_type: 'application/json'
    payload: >-
      {
        "printer_id": "{{ printer_id }}",
        "slot": {{ slot | int(-1) }},
        "amount_used": {{ amount | float(0) }},
        "hours": {{ hours | float(0) }}
      }

  3dpm_fail_print:
    url: "https://3dprintmanager.eu/api.php?key=TVOJ_API_KLJUČ&action=fail_print"
    method: POST
    headers:
      content_type: 'application/json'
    payload: >-
      {
        "printer_id": "{{ printer_id }}",
        "progress": {{ progress | float(-1) }}
      }

  3dpm_pause_print:
    url: "https://3dprintmanager.eu/api.php?key=TVOJ_API_KLJUČ&action=pause_print"
    method: POST
    headers:
      content_type: 'application/json'
    payload: >-
      {
        "printer_id": "{{ printer_id }}"
      }

  3dpm_resume_print:
    url: "https://3dprintmanager.eu/api.php?key=TVOJ_API_KLJUČ&action=resume_print"
    method: POST
    headers:
      content_type: 'application/json'
    payload: >-
      {
        "printer_id": "{{ printer_id }}",
        "slot": {{ slot | int(-1) }},
        "duration_minutes": {{ duration | int(0) }}
      }

Spremi i provjeri

1. Spremi fajl
2. Idi na Developer Tools → YAML → Check Configuration
3. Ako piše "Configuration valid!" — restart HA

U svakoj automatizaciji zamijeni sensor.p1s_SERIAL_* s tvojim entity ID-ovima iz Koraka 4, i UUID_PRINTERA s Printer ID-om iz 3DPM.

Automatizacija 1 — Start Print

alias: "3DPM: Start Print"
description: Prijavljuje novi print 3DPM-u kad P1S počne printati
triggers:
  - entity_id: sensor.p1s_SERIAL_print_status
    to: running
    trigger: state
conditions:
  - condition: template
    value_template: "{{ trigger.from_state.state != 'pause' }}"
actions:
  - wait_template: "{{ states('sensor.p1s_SERIAL_current_stage') | lower == 'printing' }}"
    timeout: "00:15:00"
    continue_on_timeout: false
  - delay: "00:00:05"
  - action: rest_command.3dpm_start_print
    data:
      printer_id: "UUID_PRINTERA"
      job_name: "{{ states('sensor.p1s_SERIAL_gcode_file').split('/')[-1] }}"
      duration: "{{ (states('sensor.p1s_SERIAL_remaining_time') | float(0) * 60) | round(0) }}"
      mapping: >-
        {% set tray_idx = state_attr('sensor.p1s_SERIAL_active_tray', 'tray_index') | int(-1) %}
        {% set slot = 0 if tray_idx in [254, -1] else tray_idx + 1 %}
        {% set weight_val = states('sensor.p1s_SERIAL_print_weight') | replace('g', '') | trim | float(0) | round(2) %}
        [{"slot": {{ slot }}, "weight": {{ weight_val }}}]
mode: single

Automatizacija 2 — Finish Print

alias: "3DPM: Finish Print"
description: Zatvara posao u 3DPM-u kad print završi (grami su skinuti na startu)
triggers:
  - entity_id: sensor.p1s_SERIAL_print_status
    to: finish
    trigger: state
actions:
  - action: rest_command.3dpm_finish_print
    data:
      printer_id: "UUID_PRINTERA"
      slot: >-
        {% set tray_idx = state_attr('sensor.p1s_SERIAL_active_tray', 'tray_index') | int(-1) %}
        {{ 0 if tray_idx in [254, -1] else tray_idx + 1 }}
      amount: >-
        {% set total_w = states('sensor.p1s_SERIAL_print_weight') | replace('g', '') | trim | float(0) %}
        {% set prog = states('sensor.p1s_SERIAL_print_progress') | float(100) %}
        {{ (total_w * (prog / 100)) | round(2) }}
      hours: 0
mode: single

Automatizacija 2b — Neuspjeli ili otkazani print

Print koji zaustaviš na printeru, ili koji ne uspije, stiže kao failed. 3DPM vraća na rolu filament koji nije isprintan, prema napretku koji je printer javio.

alias: "3DPM: Failed or Cancelled Print"
description: Vraća neisprintani filament na rolu kad je print otkazan ili neuspio
triggers:
  - entity_id: sensor.p1s_SERIAL_print_status
    to: failed
    trigger: state
actions:
  - action: rest_command.3dpm_fail_print
    data:
      printer_id: "UUID_PRINTERA"
      progress: "{{ states('sensor.p1s_SERIAL_print_progress') | float(-1) }}"
mode: single

Automatizacija 3 — Pause Print

alias: "3DPM: Pause Print"
description: Javlja 3DPM-u da je print pauziran
triggers:
  - entity_id: sensor.p1s_SERIAL_print_status
    to: pause
    trigger: state
actions:
  - action: rest_command.3dpm_pause_print
    data:
      printer_id: "UUID_PRINTERA"
mode: single

Automatizacija 4 — Resume Print

alias: "3DPM: Resume Print"
description: Javlja 3DPM-u da se print nastavlja s novim preostalim vremenom
triggers:
  - entity_id: sensor.p1s_SERIAL_print_status
    from: pause
    to: running
    trigger: state
actions:
  - wait_template: "{{ state_attr('sensor.p1s_SERIAL_active_tray', 'tray_index') | int(-1) >= 0 }}"
    timeout: "00:05:00"
    continue_on_timeout: true
  - delay: "00:00:05"
  - action: rest_command.3dpm_resume_print
    data:
      printer_id: "UUID_PRINTERA"
      slot: >-
        {% set tray_idx = state_attr('sensor.p1s_SERIAL_active_tray', 'tray_index') | int(-1) %}
        {{ 0 if tray_idx in [254, -1] else tray_idx + 1 }}
      duration: "{{ (states('sensor.p1s_SERIAL_remaining_time') | float(0) * 60) | round(0) }}"
mode: single

Brzi test — pozovi API ručno

1. Idi na Developer Tools → Services
2. Service: rest_command.3dpm_start_print
3. Service data:

printer_id: "UUID_PRINTERA"
job_name: "test_poziv"
duration: "30"
mapping: '[{"slot": 1, "weight": 5}]'

4. Klikni Call Service → provjeri u 3DPM je li se pojavio testni job ✅

Pravi test

1. Pokreni print na P1S normalno (iz Bambu Studio ili Handy app)
2. U HA provjeri: Automations → 3DPM: Start Print → Traces — vidiš li zeleni trace? ✅
3. U 3DPM je li vidljiv print u scheduleru? ✅
4. Kad print završi — je li se gramaza role smanjila? ✅

Česti problemi

Wie funktioniert die 3DPM + HA Verbindung?

Bevor wir anfangen zu klicken, lohnt es sich zu verstehen, was wir eigentlich aufbauen.

Das große Bild

Dein Bambu P1S ist im WLAN. Home Assistant (HA) verbindet sich damit und liest den Status in Echtzeit — Dinge wie "druckt es gerade?", "wie viele Gramm Filament verbraucht dieser Druck?", "wie viele Minuten sind noch übrig?".

Wenn sich der Status des Druckers ändert (z.B. von Leerlauf auf Drucken), löst HA eine Automatisierung aus. Diese Automatisierung ruft die 3DPM API auf — sendet eine Nachricht wie "Hey, der Drucker hat gerade einen 90-minütigen Druck mit 45g Filament aus Slot 1 gestartet". 3DPM empfängt das, erstellt einen Druckauftrag und zieht das Filament vom Inventar ab — vollautomatisch.

Datenfluss Schritt für Schritt

Die 5 Ereignisse, die wir verfolgen

Was ist der API-Schlüssel?

Der API-Schlüssel ist dein persönliches Passwort für die 3DPM API. Du findest ihn in 3DPM unter Settings → API. Er sieht aus wie ein langer zufälliger String, z.B. a8058e74d9d8ec984dd29293...

Was ist die Drucker-ID?

Jeder in 3DPM hinzugefügte Drucker bekommt eine eindeutige UUID — eine lange ID wie b7b71ff0-1a91-11f1-b989-566fc143004c. Du findest sie in 3DPM unter Settings → Printers → Edit.

Was du brauchst

1. Gehe zu Settings → Add-ons → Add-on Store
2. Suche Terminal & SSH und installiere es
3. Klicke Start dann Open Web UI
4. Im Terminal-Fenster diesen Befehl eingeben und Enter drücken:

wget -O - https://get.hacs.xyz | bash -

5. Warte auf grüne Ausgabe — fertig wenn HACS is now installed erscheint
6. HA neu starten: Settings → System → Restart
7. Gehe zu Settings → Devices & Services → Add Integration
8. Suche HACS, akzeptiere die Bedingungen, verknüpfe GitHub-Konto

1. Klicke HACS in der Seitenleiste → Tab Integrations
2. Klicke + Explore & Download Repositories
3. Suche: Bambu Lab → wähle Bambu Lab von greghesp
4. Klicke Download → bestätigen → HA neu starten

1. Gehe zu Settings → Devices & Services → Add Integration
2. Suche Bambu Lab und klicke darauf
3. Wähle Cloud (empfohlen für Anfänger — E-Mail + Passwort des Bambu-Kontos eingeben) oder Local (IP-Adresse + Access Code des Druckers)
4. Daten eingeben und Submit klicken

Jeder Sensor hat eine eindeutige ID nach dem Muster: sensor.p1s_SERIENNUMMER_sensor_name

1. Gehe zu Developer Tools → States
2. Im Filter-Feld p1s eingeben
3. Alle P1S-Sensoren mit ihren Entity-IDs werden angezeigt

1. Gehe zu Settings → Add-ons → Add-on Store
2. Suche File editor → installieren
3. Show in sidebar aktivieren → Start → Open Web UI

1. API-Schlüssel in 3DPM kopieren: Settings → API
2. Im File Editor configuration.yaml öffnen

Ans Ende der Datei anfügen — DEIN_API_SCHLÜSSEL ersetzen:

rest_command:

  3dpm_start_print:
    url: "https://3dprintmanager.eu/api.php?key=DEIN_API_SCHLÜSSEL&action=start_print"
    method: POST
    headers:
      content_type: 'application/json'
    payload: >-
      {
        "printer_id": "{{ printer_id }}",
        "job_name": "{{ job_name | replace('\"', '\\\"') }}",
        "duration_minutes": {{ duration | int(0) }},
        "mapping": {{ mapping | default('[]') }}
      }

  3dpm_finish_print:
    url: "https://3dprintmanager.eu/api.php?key=DEIN_API_SCHLÜSSEL&action=finish_print"
    method: POST
    headers:
      content_type: 'application/json'
    payload: >-
      {
        "printer_id": "{{ printer_id }}",
        "slot": {{ slot | int(-1) }},
        "amount_used": {{ amount | float(0) }},
        "hours": {{ hours | float(0) }}
      }

  3dpm_fail_print:
    url: "https://3dprintmanager.eu/api.php?key=DEIN_API_SCHLÜSSEL&action=fail_print"
    method: POST
    headers:
      content_type: 'application/json'
    payload: >-
      {
        "printer_id": "{{ printer_id }}",
        "progress": {{ progress | float(-1) }}
      }

  3dpm_pause_print:
    url: "https://3dprintmanager.eu/api.php?key=DEIN_API_SCHLÜSSEL&action=pause_print"
    method: POST
    headers:
      content_type: 'application/json'
    payload: >-
      {
        "printer_id": "{{ printer_id }}"
      }

  3dpm_resume_print:
    url: "https://3dprintmanager.eu/api.php?key=DEIN_API_SCHLÜSSEL&action=resume_print"
    method: POST
    headers:
      content_type: 'application/json'
    payload: >-
      {
        "printer_id": "{{ printer_id }}",
        "slot": {{ slot | int(-1) }},
        "duration_minutes": {{ duration | int(0) }}
      }

1. Datei speichern → Developer Tools → YAML → Check Configuration
2. Bei "Configuration valid!" → HA neu starten

sensor.p1s_SERIAL_* durch deine Entity-IDs ersetzen, UUID_DRUCKER durch die Drucker-ID aus 3DPM.

Automatisierung 1 — Druck starten

alias: "3DPM: Start Print"
description: Meldet neuen Druckauftrag an 3DPM wenn P1S zu drucken beginnt
triggers:
  - entity_id: sensor.p1s_SERIAL_print_status
    to: running
    trigger: state
conditions:
  - condition: template
    value_template: "{{ trigger.from_state.state != 'pause' }}"
actions:
  - wait_template: "{{ states('sensor.p1s_SERIAL_current_stage') | lower == 'printing' }}"
    timeout: "00:15:00"
    continue_on_timeout: false
  - delay: "00:00:05"
  - action: rest_command.3dpm_start_print
    data:
      printer_id: "UUID_DRUCKER"
      job_name: "{{ states('sensor.p1s_SERIAL_gcode_file').split('/')[-1] }}"
      duration: "{{ (states('sensor.p1s_SERIAL_remaining_time') | float(0) * 60) | round(0) }}"
      mapping: >-
        {% set tray_idx = state_attr('sensor.p1s_SERIAL_active_tray', 'tray_index') | int(-1) %}
        {% set slot = 0 if tray_idx in [254, -1] else tray_idx + 1 %}
        {% set weight_val = states('sensor.p1s_SERIAL_print_weight') | replace('g', '') | trim | float(0) | round(2) %}
        [{"slot": {{ slot }}, "weight": {{ weight_val }}}]
mode: single

Automatisierung 2 — Druck beenden

alias: "3DPM: Finish Print"
description: Schließt den Auftrag in 3DPM ab, wenn der Druck endet (Gramm wurden beim Start abgezogen)
triggers:
  - entity_id: sensor.p1s_SERIAL_print_status
    to: finish
    trigger: state
actions:
  - action: rest_command.3dpm_finish_print
    data:
      printer_id: "UUID_DRUCKER"
      slot: >-
        {% set tray_idx = state_attr('sensor.p1s_SERIAL_active_tray', 'tray_index') | int(-1) %}
        {{ 0 if tray_idx in [254, -1] else tray_idx + 1 }}
      amount: >-
        {% set total_w = states('sensor.p1s_SERIAL_print_weight') | replace('g', '') | trim | float(0) %}
        {% set prog = states('sensor.p1s_SERIAL_print_progress') | float(100) %}
        {{ (total_w * (prog / 100)) | round(2) }}
      hours: 0
mode: single

Automatisierung 2b — Fehlgeschlagener oder abgebrochener Druck

Ein am Drucker gestoppter oder fehlgeschlagener Druck kommt als failed an. 3DPM bucht das nicht gedruckte Filament anhand des gemeldeten Fortschritts auf die Spule zurück.

alias: "3DPM: Failed or Cancelled Print"
description: Bucht nicht gedrucktes Filament zurück, wenn ein Druck abgebrochen wird oder fehlschlägt
triggers:
  - entity_id: sensor.p1s_SERIAL_print_status
    to: failed
    trigger: state
actions:
  - action: rest_command.3dpm_fail_print
    data:
      printer_id: "UUID_DRUCKER"
      progress: "{{ states('sensor.p1s_SERIAL_print_progress') | float(-1) }}"
mode: single

Automatisierung 3 — Druck pausieren

alias: "3DPM: Pause Print"
description: Benachrichtigt 3DPM dass der Druck pausiert ist
triggers:
  - entity_id: sensor.p1s_SERIAL_print_status
    to: pause
    trigger: state
actions:
  - action: rest_command.3dpm_pause_print
    data:
      printer_id: "UUID_DRUCKER"
mode: single

Automatisierung 4 — Druck fortsetzen

alias: "3DPM: Resume Print"
description: Benachrichtigt 3DPM dass der Druck mit aktualisierter verbleibender Zeit fortgesetzt wird
triggers:
  - entity_id: sensor.p1s_SERIAL_print_status
    from: pause
    to: running
    trigger: state
actions:
  - wait_template: "{{ state_attr('sensor.p1s_SERIAL_active_tray', 'tray_index') | int(-1) >= 0 }}"
    timeout: "00:05:00"
    continue_on_timeout: true
  - delay: "00:00:05"
  - action: rest_command.3dpm_resume_print
    data:
      printer_id: "UUID_DRUCKER"
      slot: >-
        {% set tray_idx = state_attr('sensor.p1s_SERIAL_active_tray', 'tray_index') | int(-1) %}
        {{ 0 if tray_idx in [254, -1] else tray_idx + 1 }}
      duration: "{{ (states('sensor.p1s_SERIAL_remaining_time') | float(0) * 60) | round(0) }}"
mode: single

Schnelltest — API manuell aufrufen

1. Gehe zu Developer Tools → Services
2. Service: rest_command.3dpm_start_print
3. Service data:

printer_id: "UUID_DRUCKER"
job_name: "api_test"
duration: "30"
mapping: '[{"slot": 1, "weight": 5}]'

4. Klicke Call Service → in 3DPM prüfen ob ein Testauftrag erscheint ✅

Häufige Probleme