工作流程:安排專案建置順序以避免返工¶
本頁是專案各部分放進去的順序——機台、工件、控制器、刀具、程式原點、任務——手動或透過 HTTP API 皆可,某一步有路由時,路由就寫在那一步旁邊。它是專案建構的第 2 節,方法的其餘部分都在那一頁:單一自足的專案資料夾、執行所讀取的路由、控制器自己的表,以及判定專案已完成的那次重播。這些路由所依賴的登入、回應封套與以鍵編輯物件的模式,見透過 HTTP 驅動網頁服務(英文,未鏡像)。
建置順序¶
後面的步驟會讀前面的結果,所以這個順序花費最少:
- 新專案,建在它最終的路徑上。它不是空的——見新專案一開始就有什麼。
- 工具機,然後是主軸能力。
- 工件:毛胚幾何、目標幾何、解析度、工件通往程式原點錨點與夾具安裝點那兩條連接的變換器,然後是材料與切削參數。材料照檔案寫的數值使用:
HeatConductivity_WdmK(W/(m·K))、Density_gdcm3(g/cm³)或HeatCapacity_JdgK(J/(g·K))不是有限的正數,或超出固體的範圍——例如密度填成 kg/m³——載入的回應會在messages帶回警告,session 或播放開始時也會再點名一次(Material-ThermalConstants--NotFinitePositive、Material-ThermalConstants--OutOfRange)。檔案缺少該元素的材料視為未給定,不會以任何預設值代入:每一把刀具都略過熱模型,溫度停在環境溫度、磨耗維持為零,材料則在同樣的地方被點名(Material-ThermalConstants--NotGiven)。零件若是以 CAM 匯出的網格送來,而不是分別標明的毛胚與設計 CAD,就先判斷那個網格是什麼、程式原點在它的哪裡——見由參照網格建立工件,那一頁也列出 STL 欄位的 API 呼叫。 - 控制器:先定品牌——之後再切換品牌會重設品牌專屬的表——然後是控制器自己的表(專案建構 §4)。
-
刀具庫,逐把刀具依這個順序——每一步都讀前一步的結果:
- 先建立,再編號。 新刀具取刀具庫裡最大號碼再加一;把它改號成程式所呼叫的 T 號(
POST /api/ToolHouse/CreateTool,再POST /api/ToolHouse/RenameTool?toolId=…&newId=…)。補正表更新之後,這個號碼也就是 H 字語與 D 字語所讀的補正列。 - 刃包絡形(
PUT /api/Cutter/{id}/shaper-profile),例如{"AptType": "BallApt", "Diameter_mm": 4, "FluteHeight_mm": 5};AptType是ColumnApt、ConeApt、BallApt、TaperApt與GeneralApt之一,不分大小寫,帶不帶Apt都可以。球形輪廓只需要直徑與有效切削長度。刀具本體的路由會在第一次使用時建立該刀具的銑刀,所以不必另外呼叫。 - 刃雕構型(
PUT /api/Cutter/{id}/fluting),放在刃包絡形之後:側刃讀的是刀具本體現在的刃包絡形,所以之後改了刃包絡形,側刃會跟著改,不必重新送一次刃雕構型。它是整份取代的:"Type": "uniform"是必要的——其他任何值都以 400 拒絕——而且沒送的其他每一個欄位都取這條路由自己的預設值——2 刃、螺旋角 30°、徑向前角 0°、徑向後角 5°、刃偏移角 0°。前角 0° 並不是中性值,因為前角決定每個刃點所產生之力的方向;刀具表沒給時,依工件材料選一個(刀具幾何)。每一個值都要送,包括先前輸入過的刃偏移角,以及側向刃雕本身("SideContour": {"Type": "consthelix", …}):沒帶側向刃雕、或帶著這條路由不認得之類型的刃雕構型,一樣會被接受,而刃上就沒有側刃。 - 一般屬性(
PUT /api/Cutter/{id}/general):刀具本體自己的後角(ReliefAngle_deg)與刃口半徑(HoneRadius_um)——新的刀具本體為 5° 與 30 µm。這個後角是刃雕構型的徑向後角之外的第二個值,也是仿真唯一讀取的那一個:刃緣磨耗、刀具溫度、每一步的後刀面檢查與 NC 優化的後角限制都取用它;只送刃雕構型的話,它會停在 5°。刀具表上的後角要送到這裡(刀具幾何)。沒送的欄位保留原值,重新送出刃雕構型或刃包絡形也不會改動這兩個值。這條路由的回應本體是空的;GET /api/ToolHouse/{id}會在cutter.general底下讀回這兩個值。 - 刀尖至刀把鼻端高度——也就是伸出量(
PUT /api/ToolHouse/{id}/exposed-height)。新刀具從 0 開始,刀具本體藏在刀把裡。 - 安裝角——刀具本體在刀把裡轉過多少(
PUT /api/ToolHouse/{id}/setup-angle,請求本體就是一個單純的度數)。它預設為 0,只有銑削物理會讀它;刃的角位置有影響時就要填,例如以感測器自己的座標系回報的智慧刀把(智慧刀把)。它是夾持的屬性,所以重新送出刃雕構型也不會把它洗掉。 - 刀把。 先列出資源庫(
GET /api/file-explorer/list?rootName=ResourceDir&relativePath=Holder):那裡的.Holder檔帶著完成的輪廓。沒有任何路由能把它載入到刀具上,所以用GET /api/file-explorer/read-text讀它,再照下面的方式把它的 Z–R 數對整份送出。設定刀把類型(POST /api/ToolHouse/SetHolderType),讀取它的輪廓鍵(帶著工作階段鍵呼叫POST /api/CylindroidHolder/Get,會在cylindroidKey裡回應,形式為<sessionKey>-HolderCylindroid),用POST /api/Cylindroid/UpdateAllPairs取代整份輪廓——新柱狀刀把的輪廓是從 Z 40 到 Z 80 的 Ø6 佔位,在刀把重新導出它之前不會增加任何長度——然後呼叫POST /api/CylindroidHolder/UpdateGeometryContent,讓刀把重新導出它的長度。輪廓的座標系見刀具幾何。 - 夾持柱。 經由刀具本體建立它(
POST /api/Cutter/{id}/upper-beam/create?kind=Cylindroid&key=…——新的柱狀體存放在你傳入的鍵之下),在那個鍵上用POST /api/Cylindroid/UpdateAllPairs寫入數對——從刀尖量起,第一組在刃頂,最後一組在刀具全長處(刀具幾何)——然後呼叫POST /api/Cutter/{id}/upper-beam/resync,並讀它傳回的警告;空清單就是通過。 - 刀具材料,刀具有塗層的話也包括塗層。沒有刃部材料的刀具不會執行熱物理,也不會回報應力比(
Tool-FluteMaterial--Missing)。刃部、刀柄與塗層材料照工件材料的方式檢查:載入回應的messages與換刀時,會點名不是有限正數、或超出固體範圍的熱常數,也會點名檔案缺少元素的常數:它視為未給定、不以預設值代入,讓那把刀具沒有熱步驟,一如缺少刃部材料時(Material-ThermalConstants--NotGiven);刀具材料檔缺少硬度或磨耗係數曲線(TemperatureVsHardnessCurve、TemperatureVsWearCoefficientCurve)時,在讀取曲線的位置——作為刃部材料或塗層材料,而非刀柄材料——也照樣點名(Material-WearCurves--NotGiven):原生熱模型不涵蓋那把刀具。 - 智慧刀把的觀測點,在刀具帶著感測器時。新刀具指向刀把鼻端,高度為 0;見智慧刀把。
接著從刀具庫更新補正表,並核對每一個刀長列是否等於刀把的量規長度加上伸出量。
GET /api/ToolHouse/{id}會傳回儲存的刃雕構型、包絡形與夾持數值——setupAngle_deg也在其中——供最後一次讀回核對。 - 先建立,再編號。 新刀具取刀具庫裡最大號碼再加一;把它改號成程式所呼叫的 T 號(
-
程式原點:工件擺好、機構鏈載入之後,依這件工作所需的方向把兩者對齊——見程式原點對齊。客戶提供了記錄下來的偏移時,保留它們,把零件移到它們上面(專案建構 §4);只有在規劃一件沒有記錄偏移的工作時,才從模型推導出一列。好幾件零件共用工作臺時,只有帶著程式原點錨點的那件零件,它那一列可以來自模型:其他零件的各列,是那一列加上零件間距。
- 任務——見依製程安排任務。
- 儲存,然後把存好的檔案載回來再檢查一次。無法乾淨地重新載入的專案,就還沒建好。
載入工具機之後核對軸組¶
載入工具機之後核對軸組(重要)
載入工具機之後要核對軸組。每一根軸都是工具機的一個角色(AxisX … AxisC),繫結到它的某一條連接上;機構鏈檔案是依連接名稱(X/Y/Z/A/B/C)繫結它們的,所以一條還停在編寫時預設名稱的連接不會繫結任何軸,那根軸就悄悄地不存在。對線性軸而言,控制器的軸清單顯示不出這一點——每個品牌預設組都已宣告了 X、Y、Z,而機構鏈只會增加軸——所以要讀角色:GET /api/mech/equipment-topology/roles/machine-tool 列出每一根軸、它所繫結的連接,以及它的檢查結果(未繫結的軸就只是未繫結;AxisTransformerMismatch 點名種類不對的連接)。每一根軸都需要一條帶著 DynamicTranslation(X、Y、Z)或 DynamicRotation(A、B、C)的連接;機構鏈本身用 POST /api/mech/machine-tool/xml 取得。主軸(Spindle)不是軸,而且是按拓樸找的,不是按名稱:抵達刀具安裝點所掛之處的那條連接,帶著繞刀具安裝點 −Z、穿過其原點旋轉的 DynamicRotation 時,就是主軸。沒有主軸的機台照原本的方式播放,只是主軸在畫面上不會轉;旋轉軸偏離刀具軸的會被標為 SpindleOffToolAxis。