新代科技
1
新代科技
一對多 API 使用說明書
Version 1.0.11
2016/12/13
新代科技
2
目 錄
一、系統簡介................................................................................................................5
1. 解決方案架構................................................................................................5
2. 如何透過人機設定控制器開啟 Dipole........................................................6
二、 如何使用 RemoteCNC API .........................................................................8
三、資料型態及回傳錯誤說明....................................................................................9
1. 資料型態........................................................................................................9
2. 回傳錯誤說明................................................................................................9
四、 基本類別......................................................................................................11
1. isUSBExist ： 是否有 USB 插入 .............................................................11
2. SeriesNo：控制器序號 ...............................................................................11
3. MainBoardPlatformName：控制器主機板型號........................................11
4. READ_information：基本相關資訊..........................................................11
5. READ_status：狀態資訊............................................................................11
6. READ_position：座標資訊........................................................................12
7. WRITE_relpos：設定相對座標數值 .........................................................12
8. READ_gcode：G Code ...............................................................................12
9. READ_othercode：其他 Code(H Code,D Code,T Code,M Code,B Code,F
Code,S Code) .......................................................................................................12
新代科技
3
10. READ_spindle：進給率/轉速 ....................................................................13
11. READ_time：時間......................................................................................13
12. READ_part_count：工件數........................................................................13
13. DOWNLOAD_work_record：下載遠端加工記錄檔案............................14
14. IsDipoleSupported：是否可以在給定的 timeout 時間內透過 dipole 連線
14
五、 警報類別函式..............................................................................................15
1. READ_alm_current：目前發生的警報......................................................15
2. READ_alm_history：警報履歷..................................................................15
六、 刀具補正類別函式......................................................................................16
1. READ_offset_title：取得刀具 Offset 的標題列........................................16
2. READ_offset_all：取得所有刀具 Offset...................................................16
3. READ_offset_scope：依指定範圍取得刀具 Offset..................................16
4. READ_offset_single：取得單筆刀具 Offset .............................................16
5. WRITE_offset_all：寫入所有刀具 Offset .................................................17
6. WRITE_offset_single：寫入單筆刀具 Offset ...........................................17
7. READ_offset_count：取得刀具 Offset 筆數.............................................17
七、 工件座標類別函式......................................................................................18
5. READ_work_coord_axis：取得工件座標的標題名稱 .............................18
6. READ_work_coord_all：取得所有工件座標資料....................................18
新代科技
4
7. READ_work_coord_scope：依指定範圍取得工件座標資料 ..................18
8. READ_work_coord_single：取得單筆工件座標資料..............................19
9. WRITE_work_coord_all：寫入所有工件座標資料..................................19
10. WRITE_work_coord_single：寫入單筆工件座標資料 ............................19
11. READ_work_coord_count：取得工件座標筆數.......................................19
八、 Macro 變數類別函式(共通變數)...............................................................20
1. READ_macro_all：取得所有 Macro 變數(共通變數)資料......................20
2. READ_macro_scope：依指定範圍取得 Macro(共通變數)變數資料......20
3. WRITE_macro_all：寫入所有 Macro 變數(共通變數)資料 ....................20
4. READ_macro_single：取得單筆 Macro 變數(共通變數)資料 ................20
5. WRITE_macro_single：寫入單筆 Macro 變數(共通變數)資料 ..............20
6. READ_macro_variable：取得 Macro 變數(共通變數)起始及終止編號.21
九、 加工程式類別函式......................................................................................22
1. WRITE_nc_main：指定加工程式 .............................................................22
2. READ_nc_mem_list：取得機台內部加工程式清單 ................................22
3. UPLOAD_nc_mem：上傳加工程式至控制器..........................................22
4. DOWNLOAD_nc_mem：下載加工程式至控制器 ..................................22
5. DEL_nc_mem：刪除控制器內的加工程式 ..............................................22
6. READ_nc_pointer：取得目前 NC 正在執行的指標(行號)......................23
新代科技
5
7. READ_nc_current_block：取得目前程式正在執行及未來要執行的單節
23
8. READ_nc_freespace：剩餘空間容量(k) ...................................................23
9. READ_nc_OPLog：取得操作記錄............................................................23
十、 系統參數類別函式......................................................................................24
3. READ_param_max：取得機台參數最大號碼..........................................24
4. READ_param_schema：取得所有參數資料.............................................24
5. READ_param_data：取得參數資料 ..........................................................24
6. WRITE_param_single：寫入單筆參數資料..............................................24
十一、 PLC 類別函式.............................................................................................25
1. READ_plc_type：取得 PLC 位址的型別..................................................25
2. READ_plc_type2：取得 PLC 位址的型別及位址大小............................25
3. READ_plc_addr：取得 PLC 位址資料......................................................25
4. WRITE_plc_addr：寫入 PLC 位址資料....................................................25
5. READ_plc_ver：PLC 版本.........................................................................26
6. DOWNLOAD_plc_ladder：下載遠端 ladder 檔案 ...................................26
7. READ_plc_ibit：取得 PLC I Bit 位址資料 ...............................................26
8. READ_plc_obit：取得 PLC O Bit 位址資料.............................................26
9. READ_plc_cbit：取得 PLC C Bit 位址資料 .............................................26
10. READ_plc_sbit：取得 PLC S Bit 位址資料..............................................26
