Калібровка філаменту¶

BamDude має вбудований майстер калібровки філаменту, який тюнить параметри друку на філамент — pressure-advance K, flow ratio, ліміти швидкості й температури — прямо всередині BamDude. Більше не треба тримати відкритим десктопний Bambu Studio лише заради калібровки: майстер відтворює флоу калібровки Bambu Studio проти твого власного підключеного принтера.

Результат pressure-advance із майстра напряму годує K-профіль — на тій сторінці описано, як отримане K зберігається, синкається та застосовується per-spool.

Як відкрити майстер¶

Картка кожного принтера має kebab-меню (⋮) з двома сусідніми пунктами калібровки:

Пункт меню	Що відкриває
Filament Calibration	Сам майстер калібровки — обери режим, наріж, надрукуй, збережи результат.
Calibration History	Модалка зі збереженими в BamDude рядками калібровки поруч із live K-profile таблицею принтера.

Як він нарізає¶

Це ключова відмінність від фіксованого тестового друку. Майстер не постачає канонічний, заздалегідь нарізаний 3MF і не друкує його наосліп. Для кожного режиму він нарізає геометрію калібрувального scaffold проти твоїх активних пресетів принтера / процесу / філаменту через підключений OrcaSlicer або Bambu Studio sidecar — точно так, як це робить десктопний майстер калібровки Bambu Studio.

Per-mode preset overrides (wall loops, line width, initial-layer speed, spiral mode тощо) застосовуються перед нарізкою, тож калібрувальний об'єкт поводиться ідентично калібровці Bambu Studio.

Нарізаний .gcode.3mf далі FTP-иться на принтер і запускається як реальний друк через звичайний dispatch-pipeline. Оскільки він іде тим самим шляхом, що й будь-який job із бібліотеки, plate-change макроси та chamber-light MQTT-екшени спрацьовують так само, як для звичайного друку.

Потрібен slicer sidecar

Майстру потрібен доступний OrcaSlicer або Bambu Studio sidecar для нарізки. Сконфігуруй його в Settings перед запуском калібровки. Без slicer-а майстер не зможе видати придатний до друку 3MF.

Режими калібровки¶

Pressure Advance¶

Три pressure-advance режими, всі повністю production:

Режим	Що друкує
PA Line	Серія single-perimeter ліній, кожна зі зростаючим K.
PA Pattern	Сітковий патерн, що показує якість K по 2D-полю.
PA Tower	Вертикальна вежа з K, що інкрементиться по висоті.

Усі три проходять повний флоу: нарізка → FTP → друк → save-діалог → K-профіль збережений і прив'язаний до AMS-слота.

Вежі¶

Режим	Що друкує
Temperature Tower	Вежа, у якої температура сопла спадає на 5 °C кожні 10 мм бенду — кожен бенд має ембоснуте число температури.
Volumetric Speed Tower	Spiral-mode вежа, у якої швидкість зовнішньої стінки наростає з висотою.
VFA Tower	Вежа Vibration Fine Artifacts — теж spiral-mode, швидкість зовнішньої стінки наростає з висотою.
Retraction Tower	Двостовпова вежа на стрінги — кожен 1 мм висоти ретрактить трохи більше філаменту.

Усі чотири production. Це print-and-eyeball калібровки: оператор зчитує найчистіший бенд (Temperature), висоту фейлу (Volumetric Speed, VFA) або висоту, де стрінги між стовпами зникають (Retraction) оком, далі користується калькулятором фінального кроку (див. нижче). Для Temperature Tower початкова/кінцева температури за замовчуванням беруться під матеріал завантаженого філаменту — PLA 230→190 °C, PETG 250→230 °C, ABS/ASA 270→230 °C тощо.

Flow Rate¶

Двопрохідний тест, що калібрує filament_flow_ratio — множник, який масштабує екструзію, щоб виходило стільки пластика, скільки треба. Прохід 1 (грубий) друкує плиту з 9 квадратів з модифікаторами від −20 % до +20 % кроком 5 %, центрованих на поточному filament_flow_ratio твого філамент-пресета. Оператор обирає найрівніший квадрат у coarse-save діалозі майстра; прохід 2 (точний) друкує 10 квадратів з модифікаторами від −9 % до 0 %, центрованих на coarse-piku. Фінальний ratio = coarse_pick × (100 + fine_modifier) / 100 — записується в історію калібровок, далі копіюєш у slicer-профіль.

Базове значення, на якому друкується тест — filament_flow_ratio обраного філамент-пресета, авто-підставляється на verify-download сторінці, коли пресет local або резолвиться; оператор може перебити baseline на свіжу 1.0, щоб тестувати «з нуля», не редагуючи slicer-профіль.

Production. Двопрохідний автодиспатч у майстрі працює end-to-end — прохід 1 нарізається, друкується, обираєш квадрат, прохід 2 автоматично нарізається з обраним baseline, друкується, обираєш квадрат, майстер зберігає.

У розробці¶

Тільки Auto (lidar-driven, X1 / H2D Pro) калібровка ще не вийшла. Вона показана сірою у майстрі на сумісних принтерах до релізу.

Життєвий цикл режиму¶

Кожен режим перебуває в одному з трьох станів. Саме так BamDude безпечно викочує режим калібровки — режими градуюють від disabled через verification до production.

Стан	У майстрі	Значення
`disabled`	Сірий, не обирається	Ще не в цьому білді.
`verification`	Обирається, з кнопкою Download sliced 3MF	Перехідний sign-off стан. Оператор може завантажити нарізаний майстром вивід і порівняти його з десктопним Bambu Studio, перш ніж режиму довірять керувати реальним друком.
`production`	Повний флоу майстра	Нарізка → FTP → друк → save. Режиму довіряють.

Крок збереження / завершення¶

Як завершується калібровка, залежить від родини режиму.

Pressure Advance режими¶

Pressure-advance режими завершуються save-діалогом:

PA Line / PA Pattern — оператор зчитує K-мітку, надруковану біля найчистішої лінії чи колонки, і вводить її напряму.
PA Tower — оператор вимірює висоту (мм), де кути найгостріші, і BamDude обчислює K:
```
K = start + step × height_mm
```

Результат записується в рядок filament_calibration, пушиться в 16-слотову K-profile історію принтера через MQTT і прив'язується до AMS-слота — тож наступні друки автоматично його використовують.

Tower режими (Temperature, VFA, Volumetric Speed, Retraction)¶

Tower режими — print-and-eyeball. Результат — це slicer-side налаштування, без runtime-ручки на принтері. Крок завершення дає калькулятор: введи виміряну висоту (мм), і BamDude застосує per-mode формулу, показавши результат inline.

Режим	Формула	Одиниця
Temperature Tower	`result = start − ⌊height / 10⌋ × 5`	°C
Volumetric Speed Tower	`result = start + height × step`	mm³/s
VFA Tower	`result = start + ⌊height / 5⌋ × step`	mm/s
Retraction Tower	`result = start + ⌊max(0, height − 0.4)⌋ × step`	mm

Temperature Tower спадає на 5 °C кожні 10 мм бенду; VFA бандить швидкість кожні 5 мм; Retraction Tower бандить кожен 1 мм понад 1.4 мм базу — звідси цілочисельне ділення в усіх трьох.

Натискання Save result записує значення в історію калібровки як фермовий запис — "цей філамент, на цьому принтері + соплі, скалібровано до X".

Tower-результат — інертний запис

На відміну від pressure-advance результату, tower-результат не застосовується автоматично нікуди — це slicer-side налаштування без printer-side ручки, яку можна було б запушити. Збережений рядок — це запис для довідки. Скопіюй значення у filament-профіль свого slicer-а власноруч.

Ідентичність результату¶

Кожен результат калібровки ключується по 5-tuple:

(принтер, філамент, діаметр сопла, nozzle volume type, екструдер)

Ідентичність — per-printer-instance: два ідентичні принтери на фермі можуть нести незалежні значення калібровки для того ж філаменту. Майстер ніколи не припускає, що калібровка філаменту на одному принтері покриває решту.

Auto-bind на старті друку¶

Активна pressure-advance калібровка auto-binds на кожному старті друку. BamDude пере-матчить live cali-індекс принтера по стабільній 5-tuple ідентичності щоразу, коли друк починається.

Це означає, що реордери AMS-слотів і RFID re-tap не можуть тихо відкотити на невірне K — навіть якщо індекс слота зсунувся, правильна калібровка пере-прив'язується зі збереженої в BamDude ідентичності перед запуском друку.

Модалка Calibration History¶

Kebab-пункт Calibration History відкриває модалку, що показує збережені в BamDude рядки калібровки пліч-о-пліч із live 16-слотовою K-profile таблицею принтера.

На кожен рядок можна:

Set active — зробити цю калібровку прив'язаною для свого слота.
Delete — видалити збережений рядок.
Refresh from printer — пере-прочитати live cali-індекс принтера для цього рядка.

Tower-результати теж тут, показані з одиницею, похідною від режиму (VFA в mm/s, Volumetric Speed в mm³/s), тож історія читається коректно незалежно від родини режиму.

H2D двоекструдерний¶

На H2D / H2D Pro майстер показує вкладки на екструдер. Кожен екструдер калібрується незалежно — свої режими, свої результати, своя 5-tuple ідентичність (екструдер — частина ключа). Калібровка лівого екструдера ніколи не чіпає правий.

Дозволи¶

Permission	Ефект
`printers:update`	Запускати майстер калібровки.
`kprofiles:read`	Дивитися модалку Calibration History.

Траблшутинг¶

Режим сірий

Режим у стані disabled у цьому білді — він ще не вийшов. Auto (lidar-driven) калібровка викочується окремо; перевір changelog на білд, що її вмикає.

Калібрувальний друк не задиспатчився

Майстер нарізає через slicer sidecar. Підтверди, що OrcaSlicer або Bambu Studio sidecar сконфігурований і доступний у Settings.
Перевір, що принтер онлайн із зеленим статус-діодом і не в середині друку — калібрувальний job диспатчиться через звичайний pipeline і стає в чергу за активним друком.

Збережене K ніби не застосовується на наступному друку

Pressure-advance результати auto-bind-яться на старті друку через 5-tuple ідентичність. Глянь Calibration History, чи рядок set active для слота.
Перевір, що діаметр сопла і nozzle volume type збігаються — результат ключується по обох, тож зміна сопла дає окрему, незматчену ідентичність, поки не перекалібруєш.

Tower-результат не дав ефекту

Очікувано — tower-результат (VFA, Volumetric Speed, Retraction) або Flow Rate-результат — це інертний запис, не printer-side налаштування. Скопіюй значення у filament-профіль свого slicer-а власноруч.