bambu-lab

通过 MQTT 控制 Bambu Lab 3D 打印机（A1、P1P、X1）。使用此技能进行打印监控、状态查询、控制（暂停/停止）以及打印结束或错误时的通知。需要带有访问代码的 LAN 模式。

# Bambu Lab 3D-Drucker Skill

Steuerung und Überwachung von Bambu Lab 3D-Druckern über MQTT im lokalen Netzwerk.

## Konfiguration

Standard-Konfiguration (anpassbar in `scripts/bambu.sh`):
- **Host:** `192.168.30.103` (A1 Drucker)
- **Port:** `8883` (MQTT über TLS)
- **Username:** `03919A3A2200009` (Seriennummer)
- **Passwort:** `33576961` (Access Code)
- **Model:** A1

## Verwendung

Nutze das Skript `scripts/bambu.sh` für alle Operationen:

```bash
./skills/bambu-lab/scripts/bambu.sh <befehl>
```

### Befehle

**Status & Überwachung:**
- `status` - Aktueller Druckstatus
- `progress` - Druckfortschritt in %
- `temps` - Temperaturen (Nozzle, Bed, Chamber)
- `watch` - Live-Überwachung (läuft dauerhaft)

**Steuerung:**
- `pause` - Druck pausieren
- `resume` - Druck fortsetzen
- `stop` - Druck abbrechen
- `light on|off` - Druckerlicht an/aus
- `fans <0-255>` - Lüftergeschwindigkeit

**Benachrichtigungen:**
- `notify` - Starte Überwachung mit Telegram-Benachrichtigung

**MQTT Debug:**
- `raw` - Rohe MQTT-Nachrichten anzeigen

## Beispiele

```bash
# Status abfragen
./skills/bambu-lab/scripts/bambu.sh status

# Druckfortschritt
./skills/bambu-lab/scripts/bambu.sh progress

# Live-Überwachung
./skills/bambu-lab/scripts/bambu.sh watch

# Druck pausieren
./skills/bambu-lab/scripts/bambu.sh pause

# Mit Benachrichtigung
./skills/bambu-lab/scripts/bambu.sh notify
```

## Automatische Benachrichtigungen

Für automatische Benachrichtigungen bei Druckende:

```bash
# Im Hintergrund starten
./skills/bambu-lab/scripts/bambu.sh notify &
```

Oder per Cron/Heartbeat regelmäßig ausführen.

## API Referenz

Siehe [references/mqtt.md](references/mqtt.md) für vollständige MQTT-Dokumentation.

## Unterstützte Modelle

- ✅ A1 (getestet)
- ✅ A1 Mini
- ✅ P1P / P1S
- ✅ X1 / X1C

Alle Modelle nutzen das gleiche MQTT-Protokoll im LAN-Mode.

---

## 中文说明

# Bambu Lab 3D 打印机技能

通过本地网络的 MQTT 控制和监控 Bambu Lab 3D 打印机。

## 配置

默认配置（可在 `scripts/bambu.sh` 中调整）：
- **Host:** `192.168.30.103`（A1 打印机）
- **Port:** `8883`（MQTT over TLS）
- **Username:** `03919A3A2200009`（序列号）
- **Passwort:** `33576961`（访问代码）
- **Model:** A1

## 用法

使用脚本 `scripts/bambu.sh` 执行所有操作：

```bash
./skills/bambu-lab/scripts/bambu.sh <befehl>
```

### 命令

**状态与监控：**
- `status` - 当前打印状态
- `progress` - 打印进度（%）
- `temps` - 温度（喷嘴、热床、腔室）
- `watch` - 实时监控（持续运行）

**控制：**
- `pause` - 暂停打印
- `resume` - 继续打印
- `stop` - 中止打印
- `light on|off` - 打印机灯光开/关
- `fans <0-255>` - 风扇速度

**通知：**
- `notify` - 启动带 Telegram 通知的监控

**MQTT 调试：**
- `raw` - 显示原始 MQTT 消息

## 示例

```bash
# 查询状态
./skills/bambu-lab/scripts/bambu.sh status

# 打印进度
./skills/bambu-lab/scripts/bambu.sh progress

# 实时监控
./skills/bambu-lab/scripts/bambu.sh watch

# 暂停打印
./skills/bambu-lab/scripts/bambu.sh pause

# 带通知
./skills/bambu-lab/scripts/bambu.sh notify
```

## 自动通知

打印结束时的自动通知：

```bash
# 在后台启动
./skills/bambu-lab/scripts/bambu.sh notify &
```

或通过 Cron/Heartbeat 定期执行。

## API 参考

完整的 MQTT 文档请参见 [references/mqtt.md](references/mqtt.md)。

## 支持的型号

- ✅ A1（已测试）
- ✅ A1 Mini
- ✅ P1P / P1S
- ✅ X1 / X1C

所有型号在 LAN 模式下使用相同的 MQTT 协议。