Compare commits
3 Commits
v0.9.1-bet
...
v0.9.1-bet
| Author | SHA1 | Date | |
|---|---|---|---|
| a7469cce9a | |||
| 8394f77767 | |||
| c97253597b |
250
README.en.md
Normal file
250
README.en.md
Normal file
@@ -0,0 +1,250 @@
|
|||||||
|
# KX-Bridge – Anycubic Kobra X Moonraker Bridge
|
||||||
|
|
||||||
|
**Version:** 0.9.1-beta4
|
||||||
|
**Status:** Public Beta – suitable for home users, feedback welcome
|
||||||
|
|
||||||
|
KX-Bridge is a Moonraker-compatible HTTP/WebSocket bridge for the **Anycubic Kobra X** 3D printer. It allows you to control the printer through OrcaSlicer and other Moonraker-compatible software — no Klipper, no Raspberry Pi required.
|
||||||
|
|
||||||
|
---
|
||||||
|
|
||||||
|
## What's supported?
|
||||||
|
|
||||||
|
- Printer status (temperature, progress, state)
|
||||||
|
- File transfer and print start
|
||||||
|
- Print control: pause, resume, cancel
|
||||||
|
- Temperature control during an active print
|
||||||
|
- Print speed (Silent / Normal / Sport)
|
||||||
|
- AMS filament change (load / unload)
|
||||||
|
- Light and fan control
|
||||||
|
- Web UI with dashboard, temperature cards, axis control, and camera view
|
||||||
|
- Settings and self-update directly in the browser (⚙ menu)
|
||||||
|
- OrcaSlicer connection (Moonraker protocol)
|
||||||
|
|
||||||
|
---
|
||||||
|
|
||||||
|
## Requirements
|
||||||
|
|
||||||
|
- Anycubic Kobra X on your local network (LAN, no Wi-Fi client isolation)
|
||||||
|
- Printer MQTT credentials (→ see [Extracting credentials](#extracting-credentials))
|
||||||
|
- Docker **or** Python 3.9+ **or** the pre-built Linux binary
|
||||||
|
|
||||||
|
---
|
||||||
|
|
||||||
|
## Quick start – Docker (recommended)
|
||||||
|
|
||||||
|
```bash
|
||||||
|
# 1. Create .env
|
||||||
|
cp .env.example .env
|
||||||
|
# Fill in your printer data (→ extract_credentials)
|
||||||
|
|
||||||
|
# 2. Start the bridge
|
||||||
|
docker compose up -d
|
||||||
|
|
||||||
|
# 3. In OrcaSlicer: add printer → "Moonraker" → http://BRIDGE-IP:7125
|
||||||
|
```
|
||||||
|
|
||||||
|
Check logs:
|
||||||
|
```bash
|
||||||
|
docker compose logs -f
|
||||||
|
```
|
||||||
|
|
||||||
|
Update:
|
||||||
|
```bash
|
||||||
|
docker compose pull && docker compose up -d
|
||||||
|
```
|
||||||
|
|
||||||
|
---
|
||||||
|
|
||||||
|
## Quick start – Binary (Linux)
|
||||||
|
|
||||||
|
```bash
|
||||||
|
chmod +x kx-bridge
|
||||||
|
./kx-bridge --printer-ip 192.168.x.x --username userXXXX --password XXXXX \
|
||||||
|
--device-id XXXXX --mode-id 20030
|
||||||
|
```
|
||||||
|
|
||||||
|
Or place a `.env` file in the same directory — the bridge reads it automatically.
|
||||||
|
|
||||||
|
---
|
||||||
|
|
||||||
|
## Quick start – Python directly
|
||||||
|
|
||||||
|
```bash
|
||||||
|
pip install aiohttp
|
||||||
|
python kobrax_moonraker_bridge.py --printer-ip 192.168.x.x ...
|
||||||
|
# Or fill in .env and start without arguments
|
||||||
|
python kobrax_moonraker_bridge.py
|
||||||
|
```
|
||||||
|
|
||||||
|
---
|
||||||
|
|
||||||
|
## Extracting credentials
|
||||||
|
|
||||||
|
The MQTT credentials are printer-specific and are generated on first connection with AnycubicSlicerNext. The `extract_credentials` tool reads them from the memory of the running slicer.
|
||||||
|
|
||||||
|
**Requirement:** AnycubicSlicerNext must be running and connected to the printer.
|
||||||
|
|
||||||
|
### Windows
|
||||||
|
|
||||||
|
```
|
||||||
|
extract_credentials.exe --write-env
|
||||||
|
```
|
||||||
|
|
||||||
|
Writes the found credentials directly to `.env`.
|
||||||
|
|
||||||
|
### Linux
|
||||||
|
|
||||||
|
```bash
|
||||||
|
chmod +x extract_credentials
|
||||||
|
./extract_credentials --write-env
|
||||||
|
```
|
||||||
|
|
||||||
|
### Output
|
||||||
|
|
||||||
|
```
|
||||||
|
[*] Process found: AnycubicSlicerNext.exe (PID 1234)
|
||||||
|
[*] 1986 memory segments read (738.8 MB)
|
||||||
|
[*] Analyzing ... 100% (739 MB)
|
||||||
|
|
||||||
|
=======================================================
|
||||||
|
RESULTS
|
||||||
|
=======================================================
|
||||||
|
Username userXXXXXXXXXX (hits: 47)
|
||||||
|
Password *************** (hits: 1046)
|
||||||
|
Device-ID xxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxx (hits: 3504)
|
||||||
|
Printer IP 192.168.x.x (hits: 3036)
|
||||||
|
=======================================================
|
||||||
|
|
||||||
|
Hint: pass --write-env to save credentials to '.env'.
|
||||||
|
```
|
||||||
|
|
||||||
|
All credentials are **processed locally only** — nothing is sent to external servers.
|
||||||
|
|
||||||
|
---
|
||||||
|
|
||||||
|
## Configuration (.env)
|
||||||
|
|
||||||
|
```env
|
||||||
|
PRINTER_IP=192.168.x.x # Printer IP address
|
||||||
|
MQTT_PORT=9883 # Default, do not change
|
||||||
|
MQTT_USERNAME=userXXXXXXXX # Starts with "user"
|
||||||
|
MQTT_PASSWORD=XXXXXXXXXXXXXX # ~15 characters, mixed case
|
||||||
|
DEVICE_ID=xxxxxxxx... # 32-character hex string
|
||||||
|
MODE_ID=20030 # Kobra X default
|
||||||
|
```
|
||||||
|
|
||||||
|
---
|
||||||
|
|
||||||
|
## OrcaSlicer setup
|
||||||
|
|
||||||
|
1. Add printer → **Anycubic Kobra X** (or generic Klipper printer)
|
||||||
|
2. Connection type: **Moonraker**
|
||||||
|
3. Host: `http://BRIDGE-HOST:7125`
|
||||||
|
4. Test connection → should show "Online"
|
||||||
|
|
||||||
|
---
|
||||||
|
|
||||||
|
## Web UI
|
||||||
|
|
||||||
|
The bridge serves a web interface at `http://BRIDGE-HOST:7125`:
|
||||||
|
|
||||||
|
| Section | Function |
|
||||||
|
|---------|----------|
|
||||||
|
| Dashboard | Printer status, progress, temperature overview |
|
||||||
|
| Temperatures | Set nozzle and bed temperature directly |
|
||||||
|
| Motion | X/Y/Z movement, motor release |
|
||||||
|
| Print Speed | Silent / Normal / Sport |
|
||||||
|
| Fan / Light | Fan speed and work light |
|
||||||
|
| AMS | Load / unload filament |
|
||||||
|
| Camera | Live preview (if supported by printer) |
|
||||||
|
| ⚙ Settings | MQTT credentials, poll interval, self-update |
|
||||||
|
|
||||||
|
### Self-update
|
||||||
|
|
||||||
|
The ⚙ menu in the web UI lets you check for new versions and update the bridge in place — no reinstallation needed. After the download the bridge restarts automatically with the new version.
|
||||||
|
|
||||||
|
---
|
||||||
|
|
||||||
|
## bridge.sh (Linux service manager)
|
||||||
|
|
||||||
|
```bash
|
||||||
|
./bridge.sh start # Start bridge in background
|
||||||
|
./bridge.sh stop # Stop bridge
|
||||||
|
./bridge.sh restart # Restart
|
||||||
|
./bridge.sh status # Check status and port
|
||||||
|
./bridge.sh log 50 # Show last 50 log lines
|
||||||
|
```
|
||||||
|
|
||||||
|
---
|
||||||
|
|
||||||
|
## Printer states
|
||||||
|
|
||||||
|
The bridge translates internal Kobra states into Moonraker-compatible states:
|
||||||
|
|
||||||
|
| Kobra state | Meaning |
|
||||||
|
|-------------|---------|
|
||||||
|
| free | Ready |
|
||||||
|
| printing / busy | Printing |
|
||||||
|
| pausing / paused | Paused |
|
||||||
|
| resuming / resumed | Resuming |
|
||||||
|
| stopping / stoped | Stopping |
|
||||||
|
| finished | Complete |
|
||||||
|
| canceled | Cancelled |
|
||||||
|
| failed | Error |
|
||||||
|
|
||||||
|
---
|
||||||
|
|
||||||
|
## Troubleshooting
|
||||||
|
|
||||||
|
**Port 7125 already in use:**
|
||||||
|
```bash
|
||||||
|
./bridge.sh stop # or: fuser -k 7125/tcp
|
||||||
|
./bridge.sh start
|
||||||
|
```
|
||||||
|
|
||||||
|
**Invalid credentials / connection refused:**
|
||||||
|
- Start AnycubicSlicerNext, connect to the printer, then run `extract_credentials` again
|
||||||
|
- If the result looks uncertain: `extract_credentials --verbose` shows all candidates
|
||||||
|
- Manually enter the correct candidate in `.env` and restart the bridge
|
||||||
|
|
||||||
|
**Temperature changes are ignored:**
|
||||||
|
- During an active print, temperature changes are sent via a separate channel — this is normal and the bridge handles it automatically.
|
||||||
|
|
||||||
|
**Docker: Permission denied:**
|
||||||
|
```bash
|
||||||
|
sudo usermod -aG docker $USER
|
||||||
|
# Log out and back in
|
||||||
|
```
|
||||||
|
|
||||||
|
**Docker: .env not found:**
|
||||||
|
```bash
|
||||||
|
# .env must be in the same directory as docker-compose.yml
|
||||||
|
cp .env.example .env && nano .env
|
||||||
|
```
|
||||||
|
|
||||||
|
---
|
||||||
|
|
||||||
|
## Logs
|
||||||
|
|
||||||
|
```bash
|
||||||
|
# Docker
|
||||||
|
docker compose logs -f kx-bridge
|
||||||
|
|
||||||
|
# Binary / Python
|
||||||
|
tail -f /tmp/bridge.log # when using bridge.sh
|
||||||
|
```
|
||||||
|
|
||||||
|
---
|
||||||
|
|
||||||
|
## Security notes
|
||||||
|
|
||||||
|
- The bridge binds to `0.0.0.0:7125` by default — use on your local network only
|
||||||
|
- `.env` contains printer credentials — do not share publicly
|
||||||
|
- The credentials are printer-specific and have no access to Anycubic cloud services
|
||||||
|
|
||||||
|
---
|
||||||
|
|
||||||
|
## License & legal
|
||||||
|
|
||||||
|
This project was created through interoperability research under §69e UrhG (German copyright law).
|
||||||
|
For private, non-commercial use only.
|
||||||
285
README.md
285
README.md
@@ -1,185 +1,250 @@
|
|||||||
# KX-Bridge
|
# KX-Bridge – Anycubic Kobra X Moonraker Bridge
|
||||||
|
|
||||||
Verbindet den Anycubic Kobra X mit OrcaSlicer – ohne Klipper, ohne Raspberry Pi.
|
**Version:** 0.9.1-beta4
|
||||||
|
**Status:** Public Beta – für Heimanwender geeignet, Feedback willkommen
|
||||||
|
|
||||||
KX-Bridge läuft auf deinem PC oder NAS und stellt eine Schnittstelle bereit, über die OrcaSlicer den Drucker direkt steuern kann: Druckstart, Temperatur, Fortschritt, AMS-Farbwechsel.
|
KX-Bridge ist eine Moonraker-kompatible HTTP/WebSocket-Bridge für den **Anycubic Kobra X** 3D-Drucker. Sie ermöglicht die Steuerung des Druckers über OrcaSlicer und andere Moonraker-kompatible Software, ohne dass Klipper oder ein Raspberry Pi benötigt wird.
|
||||||
|
|
||||||
---
|
---
|
||||||
|
|
||||||
## Enthaltene Dateien
|
## Was wird unterstützt?
|
||||||
|
|
||||||
| Datei | Beschreibung |
|
- Druckerstatus (Temperatur, Fortschritt, Zustand)
|
||||||
|-------|-------------|
|
- Dateiübertragung und Druckstart
|
||||||
| `kobrax_moonraker_bridge.py` | Bridge-Hauptprogramm |
|
- Drucksteuerung: Pause, Fortsetzen, Abbrechen
|
||||||
| `extract_credentials.exe` | Zugangsdaten aus AnycubicSlicerNext auslesen (Windows) |
|
- Temperaturregelung während des laufenden Drucks
|
||||||
| `extract_credentials` | Zugangsdaten aus AnycubicSlicerNext auslesen (Linux) |
|
- Druckgeschwindigkeit (Leise / Normal / Sport)
|
||||||
| `kobra_x_orcaslicer_preset.zip` | OrcaSlicer-Druckerprofil für den Kobra X |
|
- AMS-Farbwechsel (Einziehen / Ausziehen)
|
||||||
| `bridge.sh` | Service-Manager für Linux |
|
- Licht- und Lüftersteuerung
|
||||||
| `Dockerfile` / `docker-compose.yml` | Docker-Deployment |
|
- Web-UI mit Dashboard, Temperaturkarten, Achsensteuerung und Kameraansicht
|
||||||
| `.env.example` | Konfigurationsvorlage |
|
- Einstellungen und Self-Update direkt im Browser (⚙-Menü)
|
||||||
|
- OrcaSlicer-Verbindung (Moonraker-Protokoll)
|
||||||
|
|
||||||
---
|
---
|
||||||
|
|
||||||
## Voraussetzungen
|
## Voraussetzungen
|
||||||
|
|
||||||
- Anycubic Kobra X im LAN-Modus (Drucker muss über LAN erreichbar sein, nicht nur über Anycubic-Cloud)
|
- Anycubic Kobra X im lokalen Netzwerk (LAN, nicht WLAN-Isolation)
|
||||||
- PC, NAS oder Server im gleichen Netzwerk (Windows oder Linux)
|
- MQTT-Credentials des Druckers (→ siehe [Credentials extrahieren](#credentials-extrahieren))
|
||||||
- Docker oder Python 3.9+
|
- Docker **oder** Python 3.9+ **oder** direkt die Linux-Binary
|
||||||
- MQTT-Zugangsdaten des Druckers → [Schritt 1](#schritt-1-zugangsdaten-ermitteln)
|
|
||||||
|
|
||||||
---
|
---
|
||||||
|
|
||||||
## Schnellstart
|
## Schnellstart – Docker (empfohlen)
|
||||||
|
|
||||||
### Schritt 1: Zugangsdaten ermitteln
|
|
||||||
|
|
||||||
Die Bridge benötigt druckerspezifische MQTT-Zugangsdaten.
|
|
||||||
|
|
||||||
> Wichtig: Der Drucker muss sich im LAN-Modus befinden. Nur wenn der Drucker direkt über LAN (nicht ausschließlich über die Anycubic-Cloud) erreichbar ist, können die Zugangsdaten ermittelt und die Bridge genutzt werden.
|
|
||||||
|
|
||||||
Die Zugangsdaten werden mit `extract_credentials` aus dem laufenden AnycubicSlicerNext ausgelesen.
|
|
||||||
|
|
||||||
Vorbereitung: AnycubicSlicerNext starten und mit dem Drucker verbinden (bis der Drucker-Status angezeigt wird).
|
|
||||||
|
|
||||||
Windows:
|
|
||||||
```
|
|
||||||
extract_credentials.exe --write-env
|
|
||||||
```
|
|
||||||
|
|
||||||
Linux:
|
|
||||||
```bash
|
|
||||||
chmod +x extract_credentials
|
|
||||||
./extract_credentials --write-env
|
|
||||||
```
|
|
||||||
|
|
||||||
Die Zugangsdaten werden automatisch in `.env` gespeichert.
|
|
||||||
|
|
||||||
> Falls das Ergebnis unsicher wirkt: `--verbose` zeigt alle gefundenen Kandidaten. Den richtigen Wert manuell in `.env` eintragen.
|
|
||||||
|
|
||||||
---
|
|
||||||
|
|
||||||
### Schritt 2: Konfiguration prüfen
|
|
||||||
|
|
||||||
```bash
|
```bash
|
||||||
|
# 1. .env anlegen
|
||||||
cp .env.example .env
|
cp .env.example .env
|
||||||
# .env öffnen und Werte kontrollieren
|
# .env mit deinen Druckerdaten befüllen (→ extract_credentials)
|
||||||
|
|
||||||
|
# 2. Bridge starten
|
||||||
|
docker compose up -d
|
||||||
|
|
||||||
|
# 3. In OrcaSlicer: Drucker → "Moonraker" → http://BRIDGE-IP:7125
|
||||||
|
```
|
||||||
|
|
||||||
|
Logs prüfen:
|
||||||
|
```bash
|
||||||
|
docker compose logs -f
|
||||||
|
```
|
||||||
|
|
||||||
|
Update:
|
||||||
|
```bash
|
||||||
|
docker compose pull && docker compose up -d
|
||||||
```
|
```
|
||||||
|
|
||||||
---
|
---
|
||||||
|
|
||||||
### Schritt 3: Bridge starten
|
## Schnellstart – Binary (Linux)
|
||||||
|
|
||||||
Option A – Docker (empfohlen):
|
|
||||||
```bash
|
|
||||||
docker compose up -d
|
|
||||||
```
|
|
||||||
Läuft im Hintergrund, startet automatisch nach Systemneustart.
|
|
||||||
|
|
||||||
Option B – Linux Binary:
|
|
||||||
```bash
|
```bash
|
||||||
chmod +x kx-bridge
|
chmod +x kx-bridge
|
||||||
./kx-bridge
|
./kx-bridge --printer-ip 192.168.x.x --username userXXXX --password XXXXX \
|
||||||
# Oder mit Service-Manager:
|
--device-id XXXXX --mode-id 20030
|
||||||
./bridge.sh start
|
|
||||||
```
|
```
|
||||||
|
|
||||||
Option C – Python direkt:
|
Oder mit `.env`-Datei im gleichen Verzeichnis – die Bridge liest sie automatisch.
|
||||||
|
|
||||||
|
---
|
||||||
|
|
||||||
|
## Schnellstart – Python direkt
|
||||||
|
|
||||||
```bash
|
```bash
|
||||||
pip install aiohttp
|
pip install aiohttp
|
||||||
|
python kobrax_moonraker_bridge.py --printer-ip 192.168.x.x ...
|
||||||
|
# Oder .env befüllen, dann ohne Argumente starten
|
||||||
python kobrax_moonraker_bridge.py
|
python kobrax_moonraker_bridge.py
|
||||||
```
|
```
|
||||||
|
|
||||||
---
|
---
|
||||||
|
|
||||||
### Schritt 4: OrcaSlicer-Profil installieren
|
## Credentials extrahieren
|
||||||
|
|
||||||
1. `kobra_x_orcaslicer_preset.zip` in OrcaSlicer importieren:
|
Die MQTT-Zugangsdaten sind druckerspezifisch und werden beim ersten Verbindungsaufbau mit dem AnycubicSlicerNext generiert. Das Tool `extract_credentials` liest sie aus dem RAM des laufenden Slicers aus.
|
||||||
Datei → Konfigurationen importieren → ZIP auswählen
|
|
||||||
2. Anycubic Kobra X als Drucker auswählen
|
|
||||||
|
|
||||||
---
|
**Voraussetzung:** AnycubicSlicerNext muss gestartet und mit dem Drucker verbunden sein.
|
||||||
|
|
||||||
### Schritt 5: OrcaSlicer verbinden
|
### Windows
|
||||||
|
|
||||||
1. Drucker-Einstellungen öffnen
|
```
|
||||||
2. Verbindungstyp: Moonraker
|
extract_credentials.exe --write-env
|
||||||
3. Adresse: `http://IP-DES-BRIDGE-PC:7125` eintragen
|
```
|
||||||
4. Auf "Test" klicken – bei erfolgreicher Verbindung erscheint eine Bestätigungsmeldung
|
|
||||||
|
|
||||||
---
|
Schreibt die gefundenen Credentials direkt in `.env`.
|
||||||
|
|
||||||
## bridge.sh – Service-Manager (Linux)
|
### Linux
|
||||||
|
|
||||||
```bash
|
```bash
|
||||||
./bridge.sh start # Im Hintergrund starten
|
chmod +x extract_credentials
|
||||||
./bridge.sh stop # Beenden
|
./extract_credentials --write-env
|
||||||
|
```
|
||||||
|
|
||||||
|
### Ausgabe
|
||||||
|
|
||||||
|
```
|
||||||
|
[*] Prozess gefunden: AnycubicSlicerNext.exe (PID 1234)
|
||||||
|
[*] 1986 Speichersegmente gelesen (738.8 MB)
|
||||||
|
[*] Analysiere ... 100% (739 MB)
|
||||||
|
|
||||||
|
=======================================================
|
||||||
|
ERGEBNISSE
|
||||||
|
=======================================================
|
||||||
|
Username userXXXXXXXXXX (Treffer: 47)
|
||||||
|
Password *************** (Treffer: 1046)
|
||||||
|
Device-ID xxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxx (Treffer: 3504)
|
||||||
|
Drucker-IP 192.168.x.x (Treffer: 3036)
|
||||||
|
=======================================================
|
||||||
|
|
||||||
|
Hinweis: --write-env übergeben um Credentials in '.env' zu speichern.
|
||||||
|
```
|
||||||
|
|
||||||
|
Alle Credentials werden **ausschließlich lokal verarbeitet** — keine Übertragung an externe Server.
|
||||||
|
|
||||||
|
---
|
||||||
|
|
||||||
|
## Konfiguration (.env)
|
||||||
|
|
||||||
|
```env
|
||||||
|
PRINTER_IP=192.168.x.x # IP des Druckers
|
||||||
|
MQTT_PORT=9883 # Standard, nicht ändern
|
||||||
|
MQTT_USERNAME=userXXXXXXXX # Beginnt mit "user"
|
||||||
|
MQTT_PASSWORD=XXXXXXXXXXXXXX # ~15 Zeichen, gemischt
|
||||||
|
DEVICE_ID=xxxxxxxx... # 32-stelliger Hex-String
|
||||||
|
MODE_ID=20030 # Kobra X Standard
|
||||||
|
```
|
||||||
|
|
||||||
|
---
|
||||||
|
|
||||||
|
## OrcaSlicer verbinden
|
||||||
|
|
||||||
|
1. Drucker hinzufügen → **Anycubic Kobra X** (oder generischer Klipper-Drucker)
|
||||||
|
2. Verbindungstyp: **Moonraker**
|
||||||
|
3. IP: `http://BRIDGE-HOST:7125`
|
||||||
|
4. Verbindung testen → sollte "Online" anzeigen
|
||||||
|
|
||||||
|
---
|
||||||
|
|
||||||
|
## Web-UI
|
||||||
|
|
||||||
|
Die Bridge stellt unter `http://BRIDGE-HOST:7125` eine Web-Oberfläche bereit:
|
||||||
|
|
||||||
|
| Bereich | Funktion |
|
||||||
|
|---------|----------|
|
||||||
|
| Dashboard | Druckerstatus, Fortschritt, Temperaturübersicht |
|
||||||
|
| Temperaturen | Nozzle und Bett direkt setzen |
|
||||||
|
| Achsen | X/Y/Z-Bewegung, Motorfreigabe |
|
||||||
|
| Druckgeschwindigkeit | Leise / Normal / Sport |
|
||||||
|
| Lüfter / Licht | Lüfterdrehzahl und Drucklicht |
|
||||||
|
| AMS | Filament einziehen / ausziehen |
|
||||||
|
| Kamera | Live-Vorschau (falls Drucker unterstützt) |
|
||||||
|
| ⚙ Einstellungen | MQTT-Zugangsdaten, Poll-Intervall, Self-Update |
|
||||||
|
|
||||||
|
### Self-Update
|
||||||
|
|
||||||
|
Über das ⚙-Menü in der Web-UI kann die Bridge auf neue Versionen prüfen und sich selbst aktualisieren — ohne Neuinstallation. Nach dem Download startet die Bridge automatisch mit der neuen Version neu.
|
||||||
|
|
||||||
|
---
|
||||||
|
|
||||||
|
## bridge.sh (Linux Service-Manager)
|
||||||
|
|
||||||
|
```bash
|
||||||
|
./bridge.sh start # Bridge im Hintergrund starten
|
||||||
|
./bridge.sh stop # Bridge beenden
|
||||||
./bridge.sh restart # Neustarten
|
./bridge.sh restart # Neustarten
|
||||||
./bridge.sh status # Status anzeigen
|
./bridge.sh status # Status und Port prüfen
|
||||||
./bridge.sh log 50 # Letzte 50 Log-Zeilen
|
./bridge.sh log 50 # Letzte 50 Log-Zeilen
|
||||||
```
|
```
|
||||||
|
|
||||||
---
|
---
|
||||||
|
|
||||||
## Docker – Nützliche Befehle
|
## Druckerzustände
|
||||||
|
|
||||||
```bash
|
Die Bridge übersetzt die internen Kobra-Zustände in Moonraker-kompatible Zustände:
|
||||||
docker compose up -d # Starten
|
|
||||||
docker compose down # Stoppen
|
| Kobra-Zustand | Bedeutung |
|
||||||
docker compose logs -f # Logs verfolgen
|
|---------------|-----------|
|
||||||
docker compose pull && docker compose up -d # Update
|
| free | Bereit |
|
||||||
```
|
| printing / busy | Druckt |
|
||||||
|
| pausing / paused | Pausiert |
|
||||||
|
| resuming / resumed | Wird fortgesetzt |
|
||||||
|
| stopping / stoped | Wird gestoppt |
|
||||||
|
| finished | Abgeschlossen |
|
||||||
|
| canceled | Abgebrochen |
|
||||||
|
| failed | Fehler |
|
||||||
|
|
||||||
---
|
---
|
||||||
|
|
||||||
## Fehlerbehebung
|
## Fehlerbehebung
|
||||||
|
|
||||||
Port 7125 belegt:
|
**Port 7125 bereits belegt:**
|
||||||
```bash
|
```bash
|
||||||
./bridge.sh stop
|
./bridge.sh stop # oder: fuser -k 7125/tcp
|
||||||
./bridge.sh start
|
./bridge.sh start
|
||||||
```
|
```
|
||||||
|
|
||||||
Verbindungstest in OrcaSlicer schlägt fehl:
|
**Credentials ungültig / Verbindung abgelehnt:**
|
||||||
- Firewall prüfen: Port 7125 muss erreichbar sein
|
- AnycubicSlicerNext starten, mit Drucker verbinden, `extract_credentials` erneut ausführen
|
||||||
- Bridge-Log prüfen: `./bridge.sh log` oder `docker compose logs`
|
- Falls das Ergebnis unsicher wirkt: `extract_credentials --verbose` zeigt alle Kandidaten an
|
||||||
- Drucker-IP in `.env` korrekt?
|
- Den richtigen Kandidaten manuell in `.env` eintragen und Bridge neu starten
|
||||||
|
|
||||||
Zugangsdaten werden abgelehnt:
|
**Temperaturänderungen werden ignoriert:**
|
||||||
- AnycubicSlicerNext starten, mit Drucker verbinden
|
- Während eines laufenden Drucks werden Temperaturänderungen über einen separaten Kanal gesendet — das ist normal und wird von der Bridge automatisch erkannt.
|
||||||
- `extract_credentials --verbose` ausführen und alle Kandidaten prüfen
|
|
||||||
- Richtigen Wert manuell in `.env` eintragen, Bridge neu starten
|
|
||||||
|
|
||||||
Docker: Permission denied:
|
**Docker: Permission denied:**
|
||||||
```bash
|
```bash
|
||||||
sudo usermod -aG docker $USER
|
sudo usermod -aG docker $USER
|
||||||
# Neu einloggen, dann erneut versuchen
|
# Neu einloggen
|
||||||
|
```
|
||||||
|
|
||||||
|
**Docker: .env nicht gefunden:**
|
||||||
|
```bash
|
||||||
|
# .env muss im gleichen Verzeichnis wie docker-compose.yml liegen
|
||||||
|
cp .env.example .env && nano .env
|
||||||
```
|
```
|
||||||
|
|
||||||
---
|
---
|
||||||
|
|
||||||
## Konfigurationsreferenz (.env)
|
## Logs
|
||||||
|
|
||||||
| Parameter | Beschreibung | Beispiel |
|
```bash
|
||||||
|-----------|-------------|---------|
|
# Docker
|
||||||
| `PRINTER_IP` | IP-Adresse des Druckers | `192.168.1.100` |
|
docker compose logs -f kx-bridge
|
||||||
| `MQTT_PORT` | MQTT-Port (nicht ändern) | `9883` |
|
|
||||||
| `MQTT_USERNAME` | Benutzername (beginnt mit „user") | `userXXXXXXXXXX` |
|
# Binary / Python
|
||||||
| `MQTT_PASSWORD` | Passwort (~15 Zeichen) | `***` |
|
tail -f /tmp/bridge.log # bei Nutzung von bridge.sh
|
||||||
| `DEVICE_ID` | Geräte-ID (32 Hex-Zeichen) | `xxxxxxxx...` |
|
```
|
||||||
| `MODE_ID` | Modell-ID (Kobra X Standard) | `20030` |
|
|
||||||
|
|
||||||
---
|
---
|
||||||
|
|
||||||
## Sicherheitshinweise
|
## Sicherheitshinweise
|
||||||
|
|
||||||
- Alle Zugangsdaten werden ausschließlich lokal verarbeitet
|
- Die Bridge bindet standardmäßig auf `0.0.0.0:7125` — nur im lokalen Netzwerk nutzen
|
||||||
|
- `.env` enthält Drucker-Credentials — nicht öffentlich teilen
|
||||||
|
- Die Credentials sind druckerspezifisch und haben keinen Zugang zu Anycubic-Cloud-Diensten
|
||||||
|
|
||||||
---
|
---
|
||||||
|
|
||||||
## Hinweis zur Nutzung
|
## Lizenz & Rechtliches
|
||||||
|
|
||||||
Dieses Projekt dient der privaten Nutzung und der Herstellung von Interoperabilität zwischen dem Anycubic Kobra X und freier Software (OrcaSlicer).
|
Dieses Projekt entstand durch Interoperabilitätsforschung gem. §69e UrhG.
|
||||||
|
Ausschließlich für private, nicht-kommerzielle Nutzung.
|
||||||
`extract_credentials` liest ausschließlich den Arbeitsspeicher des auf deinem eigenen PC laufenden AnycubicSlicerNext-Prozesses. Es werden keine Daten übertragen oder gespeichert, außer in die lokale `.env`-Datei. Das Tool funktioniert nur für den Prozess des Druckers, dem du selbst gehörst.
|
|
||||||
|
|
||||||
Das Projekt steht in keiner Verbindung zu Anycubic und wird nicht kommerziell betrieben.
|
|
||||||
|
|||||||
@@ -394,14 +394,14 @@ class KobraXClient:
|
|||||||
def stop_camera(self) -> dict | None:
|
def stop_camera(self) -> dict | None:
|
||||||
return self.publish("video", "stopCapture")
|
return self.publish("video", "stopCapture")
|
||||||
|
|
||||||
def pause_print(self) -> dict | None:
|
def pause_print(self, taskid: str = "-1") -> dict | None:
|
||||||
return self.publish("print", "pause")
|
return self.publish("print", "pause", {"taskid": taskid})
|
||||||
|
|
||||||
def resume_print(self) -> dict | None:
|
def resume_print(self, taskid: str = "-1") -> dict | None:
|
||||||
return self.publish("print", "resume")
|
return self.publish("print", "resume", {"taskid": taskid})
|
||||||
|
|
||||||
def stop_print(self) -> dict | None:
|
def stop_print(self, taskid: str = "-1") -> dict | None:
|
||||||
return self.publish("print", "stop")
|
return self.publish("print", "stop", {"taskid": taskid})
|
||||||
|
|
||||||
# -- G-Code Upload -------------------------------------------------------
|
# -- G-Code Upload -------------------------------------------------------
|
||||||
|
|
||||||
|
|||||||
@@ -48,6 +48,12 @@ KOBRA_TO_KLIPPER_STATE = {
|
|||||||
"checking": "printing",
|
"checking": "printing",
|
||||||
"updated": "printing",
|
"updated": "printing",
|
||||||
"init": "printing",
|
"init": "printing",
|
||||||
|
"pausing": "paused",
|
||||||
|
"paused": "paused",
|
||||||
|
"resuming": "printing",
|
||||||
|
"resumed": "printing",
|
||||||
|
"stopping": "printing",
|
||||||
|
"stoped": "standby",
|
||||||
"finished": "complete",
|
"finished": "complete",
|
||||||
"failed": "error",
|
"failed": "error",
|
||||||
"canceled": "standby",
|
"canceled": "standby",
|
||||||
@@ -118,6 +124,9 @@ class KobraXBridge:
|
|||||||
self._state["print_state"] = KOBRA_TO_KLIPPER_STATE.get(kobra_state, "printing")
|
self._state["print_state"] = KOBRA_TO_KLIPPER_STATE.get(kobra_state, "printing")
|
||||||
if kobra_state:
|
if kobra_state:
|
||||||
self._state["kobra_state"] = kobra_state
|
self._state["kobra_state"] = kobra_state
|
||||||
|
if kobra_state in ("stoped", "canceled"):
|
||||||
|
self._state["progress"] = 0.0
|
||||||
|
self._state["filename"] = ""
|
||||||
self._state["filename"] = d.get("filename", self._state["filename"])
|
self._state["filename"] = d.get("filename", self._state["filename"])
|
||||||
if "progress" in d:
|
if "progress" in d:
|
||||||
self._state["progress"] = float(d["progress"]) / 100.0
|
self._state["progress"] = float(d["progress"]) / 100.0
|
||||||
@@ -519,17 +528,20 @@ class KobraXBridge:
|
|||||||
|
|
||||||
async def handle_print_pause(self, request):
|
async def handle_print_pause(self, request):
|
||||||
loop = asyncio.get_event_loop()
|
loop = asyncio.get_event_loop()
|
||||||
await loop.run_in_executor(None, self.client.pause_print)
|
taskid = self._state.get("taskid", "-1")
|
||||||
|
await loop.run_in_executor(None, lambda: self.client.pause_print(taskid))
|
||||||
return web.json_response({"result": "ok"})
|
return web.json_response({"result": "ok"})
|
||||||
|
|
||||||
async def handle_print_resume(self, request):
|
async def handle_print_resume(self, request):
|
||||||
loop = asyncio.get_event_loop()
|
loop = asyncio.get_event_loop()
|
||||||
await loop.run_in_executor(None, self.client.resume_print)
|
taskid = self._state.get("taskid", "-1")
|
||||||
|
await loop.run_in_executor(None, lambda: self.client.resume_print(taskid))
|
||||||
return web.json_response({"result": "ok"})
|
return web.json_response({"result": "ok"})
|
||||||
|
|
||||||
async def handle_print_cancel(self, request):
|
async def handle_print_cancel(self, request):
|
||||||
loop = asyncio.get_event_loop()
|
loop = asyncio.get_event_loop()
|
||||||
await loop.run_in_executor(None, self.client.stop_print)
|
taskid = self._state.get("taskid", "-1")
|
||||||
|
await loop.run_in_executor(None, lambda: self.client.stop_print(taskid))
|
||||||
return web.json_response({"result": "ok"})
|
return web.json_response({"result": "ok"})
|
||||||
|
|
||||||
async def handle_octoprint_version(self, request):
|
async def handle_octoprint_version(self, request):
|
||||||
@@ -1118,7 +1130,7 @@ function toggleTheme(){
|
|||||||
// ── i18n ──
|
// ── i18n ──
|
||||||
var LANG_DE={
|
var LANG_DE={
|
||||||
header_status_standby:'Bereit',header_status_printing:'Druckt',header_status_complete:'Fertig',header_status_error:'Fehler',
|
header_status_standby:'Bereit',header_status_printing:'Druckt',header_status_complete:'Fertig',header_status_error:'Fehler',
|
||||||
kobra_free:'Bereit',kobra_busy:'Beschäftigt',kobra_printing:'Druckt',kobra_preheating:'Aufheizen',kobra_auto_leveling:'Nivellierung',kobra_checking:'Prüfung',kobra_updated:'Aktualisierung',kobra_init:'Initialisierung',kobra_finished:'Abgeschlossen',kobra_failed:'Fehler',kobra_canceled:'Abgebrochen',kobra_offline:'Offline',
|
kobra_free:'Bereit',kobra_busy:'Beschäftigt',kobra_printing:'Druckt',kobra_preheating:'Aufheizen',kobra_auto_leveling:'Nivellierung',kobra_checking:'Prüfung',kobra_updated:'Aktualisierung',kobra_init:'Initialisierung',kobra_pausing:'Pausiert...',kobra_paused:'Pausiert',kobra_resuming:'Fortsetzen...',kobra_resumed:'Fortgesetzt',kobra_stopping:'Stoppt...',kobra_stoped:'Gestoppt',kobra_finished:'Abgeschlossen',kobra_failed:'Fehler',kobra_canceled:'Abgebrochen',kobra_offline:'Offline',
|
||||||
nav_dashboard:'Dashboard',nav_print:'Druck',nav_temps:'Temperaturen',nav_motion:'Achsen',nav_ams:'AMS',nav_extras:'Licht / Lüfter',nav_console:'Konsole',
|
nav_dashboard:'Dashboard',nav_print:'Druck',nav_temps:'Temperaturen',nav_motion:'Achsen',nav_ams:'AMS',nav_extras:'Licht / Lüfter',nav_console:'Konsole',
|
||||||
card_progress:'Fortschritt',card_temps:'Temperaturen',card_light_fan:'Lüfter',card_speed:'Druckgeschwindigkeit',card_cam:'Kamera',
|
card_progress:'Fortschritt',card_temps:'Temperaturen',card_light_fan:'Lüfter',card_speed:'Druckgeschwindigkeit',card_cam:'Kamera',
|
||||||
speed_silent:'🐢 Leise',speed_normal:'⚡ Normal',speed_sport:'🚀 Sport',
|
speed_silent:'🐢 Leise',speed_normal:'⚡ Normal',speed_sport:'🚀 Sport',
|
||||||
@@ -1143,7 +1155,7 @@ var LANG_DE={
|
|||||||
};
|
};
|
||||||
var LANG_EN={
|
var LANG_EN={
|
||||||
header_status_standby:'Ready',header_status_printing:'Printing',header_status_complete:'Complete',header_status_error:'Error',
|
header_status_standby:'Ready',header_status_printing:'Printing',header_status_complete:'Complete',header_status_error:'Error',
|
||||||
kobra_free:'Ready',kobra_busy:'Busy',kobra_printing:'Printing',kobra_preheating:'Preheating',kobra_auto_leveling:'Auto Leveling',kobra_checking:'Checking',kobra_updated:'Updating',kobra_init:'Initializing',kobra_finished:'Finished',kobra_failed:'Error',kobra_canceled:'Cancelled',kobra_offline:'Offline',
|
kobra_free:'Ready',kobra_busy:'Busy',kobra_printing:'Printing',kobra_preheating:'Preheating',kobra_auto_leveling:'Auto Leveling',kobra_checking:'Checking',kobra_updated:'Updating',kobra_init:'Initializing',kobra_pausing:'Pausing...',kobra_paused:'Paused',kobra_resuming:'Resuming...',kobra_resumed:'Resumed',kobra_stopping:'Stopping...',kobra_stoped:'Stopped',kobra_finished:'Finished',kobra_failed:'Error',kobra_canceled:'Cancelled',kobra_offline:'Offline',
|
||||||
nav_dashboard:'Dashboard',nav_print:'Print',nav_temps:'Temperatures',nav_motion:'Motion',nav_ams:'AMS',nav_extras:'Light / Fan',nav_console:'Console',
|
nav_dashboard:'Dashboard',nav_print:'Print',nav_temps:'Temperatures',nav_motion:'Motion',nav_ams:'AMS',nav_extras:'Light / Fan',nav_console:'Console',
|
||||||
card_progress:'Progress',card_temps:'Temperatures',card_light_fan:'Fan',card_speed:'Print Speed',card_cam:'Camera',
|
card_progress:'Progress',card_temps:'Temperatures',card_light_fan:'Fan',card_speed:'Print Speed',card_cam:'Camera',
|
||||||
speed_silent:'🐢 Silent',speed_normal:'⚡ Normal',speed_sport:'🚀 Sport',
|
speed_silent:'🐢 Silent',speed_normal:'⚡ Normal',speed_sport:'🚀 Sport',
|
||||||
|
|||||||
Reference in New Issue
Block a user