mirror of
https://github.com/maziggy/bambuddy.git
synced 2026-10-09 07:25:44 +02:00
maziggy
6fb814c5ea
The Bambu Lab X2D (launched April 2026, dual-nozzle, enclosed, hardened
steel rod gantry, AMS 2 Pro compatible) identifies itself as internal
model code N6 via SSDP/MQTT, and real serials begin with 20P9. None of
these identifiers existed in Bambuddy's registries, so the camera
service fell back to the chamber-image protocol on port 6000 (X2D
doesn't speak it), firmware-check logged "Unknown printer model: N6",
and the dual-nozzle K-profile paths — gated on the H2D serial prefix
"094" — would have treated X2D as single-nozzle.
Backend:
- Register N6 → X2D across every registry (PRINTER_MODEL_ID_MAP,
PRINTER_MODEL_MAP, STEEL_ROD_MODELS, ETHERNET_MODELS,
CHAMBER_TEMP_SUPPORTED_MODELS, firmware-check API keys + wiki path,
virtual-printer SSDP/product/serial tables, DB vp_model_fixes).
- supports_rtsp(): match the X2 display-name prefix and the N6 internal
code; camera now routes to RTSP on port 322.
- Dual-nozzle serial prefix check in bambu_mqtt.delete_kprofile and
kprofiles.set_kprofile broadened to ("094", "20P9") — X2D now takes
the H2D-style cali_idx in-place edit path.
- is_h2d model gate in bambu_mqtt.start_print extended with "X2D" so
timelapse / bed_leveling / flow_cali / vibration_cali / layer_inspect
are sent as integers and external-spool ams_id 254/255 routing is
preserved (H2D-style deputy-nozzle addressing).
X2D uses hardened steel rods like P2S — it is intentionally placed in
STEEL_ROD_MODELS, not CARBON_ROD_MODELS. A regression-guard test pins
the classification.
Frontend:
- mapModelCode in PrintersPage and SpoolBuddyAmsPage handle N6 and X2D.
- Enclosure-door badge and airduct-mode whitelists include X2D.
- MaintenancePage.getMaintenanceWikiUrl routes X2D to P2S wiki URLs for
steel-rod lubrication, belt tension, cold-pull, and PTFE tube
(exported to enable direct unit testing).
Tests:
- test_printer_models.py: TestX2DModel (10 assertions).
- test_bambu_mqtt.py: X2D in start_print ams_mapping and is_h2d gate;
TestDeleteKProfileDualNozzleDetection across H2D, X2D, P2S, X1C.
- MaintenancePageWikiUrls.test.tsx: 15 assertions covering X2D, P2S
regression, X1C/H2D/A1Mini regression, and model-name normalisation.
Docs:
- README: added X2 series to the supported printers table.
- CHANGELOG: new entry under 0.2.3b4 Fixed.
Credit to @krautech for the report and debug bundle, and to @legend813
for PR #989 which seeded most of the registry changes — rod-type
classification was corrected (steel, not carbon) and the dual-nozzle /
K-profile / is_h2d gaps were added on top.
102 lines
5.0 KiB
TypeScript
102 lines
5.0 KiB
TypeScript
/**
|
|
* Resolve a Bambu Lab wiki URL for a maintenance task based on the printer model.
|
|
*
|
|
* Model families:
|
|
* - X1, P1 → carbon rods
|
|
* - P2S, X2D → hardened steel rods (X2D shares P2S's gantry — #988)
|
|
* - A1, A1 Mini → linear rails (Y axis)
|
|
* - H2D, H2C, H2S → linear rails (X-axis lubrication)
|
|
*
|
|
* Returns null when no wiki page applies (e.g. "Clean Carbon Rods" on an H2D),
|
|
* which the caller renders as a task with no clickable help link.
|
|
*/
|
|
export function getMaintenanceWikiUrl(typeName: string, printerModel: string | null): string | null {
|
|
const model = (printerModel || '').toUpperCase().replace(/[- ]/g, '');
|
|
|
|
const isX1 = model.includes('X1');
|
|
const isP1 = model.includes('P1');
|
|
const isA1Mini = model.includes('A1MINI');
|
|
const isA1 = model.includes('A1') && !isA1Mini;
|
|
const isH2D = model.includes('H2D');
|
|
const isH2C = model.includes('H2C');
|
|
const isH2S = model.includes('H2S');
|
|
const isH2 = isH2D || isH2C || isH2S;
|
|
const isP2S = model.includes('P2S');
|
|
const isX2D = model.includes('X2D');
|
|
// X2D shares the hardened steel rod hardware and belt layout with P2S,
|
|
// so its maintenance routes use the P2S wiki pages until dedicated
|
|
// X2D pages are published by Bambu Lab.
|
|
const isSteelRod = isP2S || isX2D;
|
|
|
|
switch (typeName) {
|
|
case 'Lubricate Steel Rods':
|
|
if (isSteelRod) return 'https://wiki.bambulab.com/en/p2s/maintenance/lubricate-x-y-z-axis';
|
|
return null;
|
|
|
|
case 'Clean Steel Rods':
|
|
if (isSteelRod) return 'https://wiki.bambulab.com/en/p2s/maintenance/lubricate-x-y-z-axis';
|
|
return null;
|
|
|
|
case 'Lubricate Linear Rails':
|
|
if (isA1Mini) return 'https://wiki.bambulab.com/en/a1-mini/maintenance/lubricate-y-axis';
|
|
if (isA1) return 'https://wiki.bambulab.com/en/a1/maintenance/lubricate-y-axis';
|
|
if (isH2) return 'https://wiki.bambulab.com/en/h2/maintenance/x-axis-lubrication';
|
|
return null;
|
|
|
|
case 'Clean Nozzle/Hotend':
|
|
if (isX1 || isP1) return 'https://wiki.bambulab.com/en/x1/troubleshooting/nozzle-clog';
|
|
if (isA1Mini || isA1) return 'https://wiki.bambulab.com/en/a1-mini/troubleshooting/nozzle-clog';
|
|
if (isH2) return 'https://wiki.bambulab.com/en/h2/maintenance/nozzl-cold-pull-maintenance-and-cleaning';
|
|
if (isSteelRod) return 'https://wiki.bambulab.com/en/p2s/maintenance/cold-pull-maintenance-hotend';
|
|
return 'https://wiki.bambulab.com/en/x1/troubleshooting/nozzle-clog';
|
|
|
|
case 'Check Belt Tension':
|
|
if (isX1) return 'https://wiki.bambulab.com/en/x1/maintenance/belt-tension';
|
|
if (isP1) return 'https://wiki.bambulab.com/en/p1/maintenance/p1p-maintenance';
|
|
if (isA1Mini) return 'https://wiki.bambulab.com/en/a1-mini/maintenance/belt_tension';
|
|
if (isA1) return 'https://wiki.bambulab.com/en/a1/maintenance/belt_tension';
|
|
if (isH2D) return 'https://wiki.bambulab.com/en/h2/maintenance/belt-tension';
|
|
if (isH2C) return 'https://wiki.bambulab.com/en/h2c/maintenance/belt-tension';
|
|
if (isH2S) return 'https://wiki.bambulab.com/en/h2s/maintenance/belt-tension';
|
|
if (isSteelRod) return 'https://wiki.bambulab.com/en/p2s/maintenance/belt-tension';
|
|
return 'https://wiki.bambulab.com/en/x1/maintenance/belt-tension';
|
|
|
|
case 'Clean Carbon Rods':
|
|
if (isX1 || isP1) return 'https://wiki.bambulab.com/en/general/carbon-rods-clearance';
|
|
return null;
|
|
|
|
case 'Clean Linear Rails':
|
|
if (isA1Mini) return 'https://wiki.bambulab.com/en/a1-mini/maintenance/lubricate-y-axis';
|
|
if (isA1) return 'https://wiki.bambulab.com/en/a1/maintenance/lubricate-y-axis';
|
|
if (isH2) return 'https://wiki.bambulab.com/en/h2/maintenance/x-axis-lubrication';
|
|
return null;
|
|
|
|
case 'Clean Build Plate':
|
|
return 'https://wiki.bambulab.com/en/filament-acc/acc/pei-plate-clean-guide';
|
|
|
|
case 'Check PTFE Tube':
|
|
if (isX1 || isP1) return 'https://wiki.bambulab.com/en/x1/maintenance/replace-ptfe-tube';
|
|
if (isA1Mini || isA1) return 'https://wiki.bambulab.com/en/a1-mini/maintenance/ptfe-tube';
|
|
if (isH2D) return 'https://wiki.bambulab.com/en/h2/maintenance/replace-ptfe-tube-on-h2d-printer';
|
|
if (isH2S) return 'https://wiki.bambulab.com/en/h2s/maintenance/replace-ptfe-tube-on-h2s-printer';
|
|
if (isH2C) return 'https://wiki.bambulab.com/en/h2/maintenance/replace-ptfe-tube-on-h2d-printer'; // H2C uses H2D guide
|
|
if (isSteelRod) return 'https://wiki.bambulab.com/en/x1/maintenance/replace-ptfe-tube'; // P2S/X2D use similar PTFE
|
|
return 'https://wiki.bambulab.com/en/x1/maintenance/replace-ptfe-tube';
|
|
|
|
case 'Replace HEPA Filter':
|
|
case 'HEPA Filter':
|
|
case 'Replace Carbon Filter':
|
|
case 'Carbon Filter':
|
|
if (isH2) return 'https://wiki.bambulab.com/en/h2/maintenance/replace-smoke-purifier-air-filte';
|
|
return 'https://wiki.bambulab.com/en/x1/maintenance/replace-carbon-filter';
|
|
|
|
case 'Lubricate Left Nozzle Rail':
|
|
case 'Left Nozzle Rail':
|
|
if (isH2) return 'https://wiki.bambulab.com/en/h2/maintenance/x-axis-lubrication';
|
|
return null;
|
|
|
|
default:
|
|
return null;
|
|
}
|
|
}
|