1. 金橙子MarkEzd.dll开发入门指南第一次接触激光打标二次开发的朋友可能会被各种专业术语吓到但其实只要掌握几个核心概念就能快速上手。MarkEzd.dll是北京金橙子科技为EZCAD2激光打标软件提供的开发接口相当于给开发者开了一个后门让我们可以直接控制打标机的核心功能。我刚开始做激光打标项目时最头疼的就是每次都要手动操作EZCAD2软件。后来发现通过MarkEzd.dll可以把所有操作自动化。比如我们有个客户需要在500个金属件上打不同序列号手动操作要一整天用dll开发后2小时就全自动完成了。开发环境搭建其实很简单确保安装了EZCAD2软件建议2.14.6以上版本准备Visual Studio开发环境VC6.0到VS2019都支持获取MarkEzd.dll和对应的头文件MarkEzdDll.h// 最简单的初始化示例 HINSTANCE hDLL LoadLibrary(TEXT(MarkEzd.dll)); typedef int (*LMC1_INITIAL)(TCHAR*, BOOL, HWND); LMC1_INITIAL lmc1_Initial (LMC1_INITIAL)GetProcAddress(hDLL, lmc1_Initial); TCHAR ezcadPath[MAX_PATH] TEXT(C:\\EZCAD2\\); lmc1_Initial(ezcadPath, FALSE, NULL);新手最容易踩的坑就是路径问题。记得dll和你的程序必须放在EZCAD2安装目录下而且调用时EZCAD2不能正在运行。我有次调试了半天才发现是因为EZCAD2在后台没完全退出。2. 核心函数解析与实战应用2.1 设备控制三剑客任何激光打标程序都离不开这三个基础函数lmc1_Initial: 初始化控制卡相当于打开激光器的电源开关lmc1_LoadEzdFile: 加载模板文件就像把设计图纸放进机器lmc1_Mark: 开始打标相当于按下启动按钮// 典型工作流程 int ret lmc1_Initial(ezcadPath, FALSE, NULL); if(ret ! LMC1_ERR_SUCCESS) { // 错误处理 } ret lmc1_LoadEzdFile(TEXT(template.ezd)); if(ret ! LMC1_ERR_SUCCESS) { // 错误处理 } // 修改文本内容 lmc1_ChangeTextByName(TEXT(serial_no), TEXT(A20240001)); // 开始打标 ret lmc1_Mark(FALSE);特别要注意错误处理。有次我们产线上的设备突然报错就是因为没检查lmc1_Mark的返回值。后来加了这段代码就稳定多了if(ret LMC1_ERR_STOPSIGNAL) { MessageBox(NULL, TEXT(设备急停被触发), TEXT(错误), MB_ICONERROR); } else if(ret LMC1_ERR_OUTTIME) { MessageBox(NULL, TEXT(加工超时), TEXT(错误), MB_ICONERROR); }2.2 动态内容替换技巧lmc1_ChangeTextByName是我们最常用的函数但有些高级用法手册上没写。比如要打标的文本特别长时直接调用可能会失败。这时可以分步操作// 先清空原有文本 lmc1_ChangeTextByName(TEXT(long_text), TEXT()); // 分段设置 CString longText GetFromDatabase(); // 从数据库获取长文本 for(int i0; ilongText.GetLength(); i100) { CString chunk longText.Mid(i, 100); lmc1_ChangeTextByName(TEXT(long_text), chunk); Sleep(10); // 稍作延迟 }对于需要频繁变更的内容建议使用模板变量的方式。我们在汽车零部件项目中就这样做在EZCAD2中创建模板文本对象命名为{DATE}、{SN}等程序中实时替换CString currentDate CTime::GetCurrentTime().Format(%Y-%m-%d); lmc1_ChangeTextByName(TEXT({DATE}), currentDate); CString serialNo GenerateSerialNumber(); lmc1_ChangeTextByName(TEXT({SN}), serialNo);3. 构建自动化标刻系统3.1 数据库集成方案真正的自动化系统需要连接数据库。我们给电子厂做的解决方案是这样的架构SQL Server存储产品信息序列号、生产日期、质检结果等中间服务程序定时查询未打标记录调用MarkEzd.dll完成打标更新数据库状态// 数据库操作示例 CADODatabase db; db.Open(_T(ProviderSQLOLEDB;Data Source192.168.1.100;Initial CatalogProduction;User IDsa;Password123456;)); CADORecordset rs(db); rs.Open(_T(SELECT * FROM Products WHERE IsMarked0)); while(!rs.IsEOF()) { CString productID rs.GetFieldValue(_T(ProductID)); CString serialNo rs.GetFieldValue(_T(SerialNo)); lmc1_LoadEzdFile(_T(template.ezd)); lmc1_ChangeTextByName(_T(serial_no), serialNo); if(lmc1_Mark(FALSE) LMC1_ERR_SUCCESS) { db.ExecuteSQL(_T(UPDATE Products SET IsMarked1 WHERE ProductID) productID _T()); } rs.MoveNext(); }3.2 流水线集成实战对于自动化产线还需要处理飞行打标Fly Marking。关键是要配合传感器信号// 配置飞行打标参数 lmc1_SetPenParam(1, 1, 1000, 80, 25, 20000, 100, 100, 100, 100, 1000, 100, 100, 0.1, 0.5, 1, FALSE, 0, 0.5); // 等待传感器信号 while(true) { WORD inputStatus; lmc1_ReadPort(inputStatus); if(inputStatus 0x01) { // 检测IN0信号 lmc1_Mark(TRUE); // 启用飞行打标模式 break; } Sleep(10); }我们给瓶装水生产线做的方案中通过编码器实时获取流水线速度double flySpeed 0.0; lmc1_GetFlySpeed(flySpeed); // 动态调整打标参数 if(flySpeed 1.5) { lmc1_SetPenParam(1, 1, 1500, 85, 25, 25000, 100, 100, 100, 100, 1500, 100, 100, 0.1, 0.5, 1, FALSE, 0, flySpeed); }4. 高级功能与性能优化4.1 多对象批量处理技巧当需要处理大量对象时直接逐个操作会很慢。这时可以用批量处理// 获取所有对象数量 int count lmc1_GetEntityCount(); // 批量修改文本 for(int i0; icount; i) { TCHAR name[256]; lmc1_GetEntityName(i, name); if(_tcsstr(name, _T(DATE_))) { CString newText CTime::GetCurrentTime().Format(_T(%m-%d)); lmc1_ChangeTextByName(name, newText); } }对于图形对象可以用lmc1_MoveEnt统一调整位置// 整体移动所有对象 for(int i0; icount; i) { TCHAR name[256]; lmc1_GetEntityName(i, name); lmc1_MoveEnt(name, 10.0, 5.0); // X方向移动10mmY方向移动5mm }4.2 错误处理与日志记录稳定的工业系统必须有完善的错误处理。我们开发了这样的日志系统void LogError(int errorCode) { CString msg; switch(errorCode) { case LMC1_ERR_EZCADRUN: msg _T(EZCAD正在运行); break; case LMC1_ERR_NOFINDCFGFILE: msg _T(找不到配置文件); break; // ...其他错误码处理 default: msg _T(未知错误); } CTime time CTime::GetCurrentTime(); CString logEntry; logEntry.Format(_T([%s] 错误 %d: %s\n), time.Format(_T(%Y-%m-%d %H:%M:%S)), errorCode, msg); // 写入日志文件 CStdioFile file; if(file.Open(_T(marking_log.txt), CFile::modeCreate|CFile::modeNoTruncate|CFile::modeWrite)) { file.SeekToEnd(); file.WriteString(logEntry); file.Close(); } // 同时输出到调试窗口 OutputDebugString(logEntry); }在每次调用dll函数后都检查返回值int ret lmc1_Mark(FALSE); if(ret ! LMC1_ERR_SUCCESS) { LogError(ret); // 必要时停止设备 EmergencyStop(); }
基于金橙子MarkEzd.dll的激光打标二次开发实战：从函数解析到自动化标刻系统构建
1. 金橙子MarkEzd.dll开发入门指南第一次接触激光打标二次开发的朋友可能会被各种专业术语吓到但其实只要掌握几个核心概念就能快速上手。MarkEzd.dll是北京金橙子科技为EZCAD2激光打标软件提供的开发接口相当于给开发者开了一个后门让我们可以直接控制打标机的核心功能。我刚开始做激光打标项目时最头疼的就是每次都要手动操作EZCAD2软件。后来发现通过MarkEzd.dll可以把所有操作自动化。比如我们有个客户需要在500个金属件上打不同序列号手动操作要一整天用dll开发后2小时就全自动完成了。开发环境搭建其实很简单确保安装了EZCAD2软件建议2.14.6以上版本准备Visual Studio开发环境VC6.0到VS2019都支持获取MarkEzd.dll和对应的头文件MarkEzdDll.h// 最简单的初始化示例 HINSTANCE hDLL LoadLibrary(TEXT(MarkEzd.dll)); typedef int (*LMC1_INITIAL)(TCHAR*, BOOL, HWND); LMC1_INITIAL lmc1_Initial (LMC1_INITIAL)GetProcAddress(hDLL, lmc1_Initial); TCHAR ezcadPath[MAX_PATH] TEXT(C:\\EZCAD2\\); lmc1_Initial(ezcadPath, FALSE, NULL);新手最容易踩的坑就是路径问题。记得dll和你的程序必须放在EZCAD2安装目录下而且调用时EZCAD2不能正在运行。我有次调试了半天才发现是因为EZCAD2在后台没完全退出。2. 核心函数解析与实战应用2.1 设备控制三剑客任何激光打标程序都离不开这三个基础函数lmc1_Initial: 初始化控制卡相当于打开激光器的电源开关lmc1_LoadEzdFile: 加载模板文件就像把设计图纸放进机器lmc1_Mark: 开始打标相当于按下启动按钮// 典型工作流程 int ret lmc1_Initial(ezcadPath, FALSE, NULL); if(ret ! LMC1_ERR_SUCCESS) { // 错误处理 } ret lmc1_LoadEzdFile(TEXT(template.ezd)); if(ret ! LMC1_ERR_SUCCESS) { // 错误处理 } // 修改文本内容 lmc1_ChangeTextByName(TEXT(serial_no), TEXT(A20240001)); // 开始打标 ret lmc1_Mark(FALSE);特别要注意错误处理。有次我们产线上的设备突然报错就是因为没检查lmc1_Mark的返回值。后来加了这段代码就稳定多了if(ret LMC1_ERR_STOPSIGNAL) { MessageBox(NULL, TEXT(设备急停被触发), TEXT(错误), MB_ICONERROR); } else if(ret LMC1_ERR_OUTTIME) { MessageBox(NULL, TEXT(加工超时), TEXT(错误), MB_ICONERROR); }2.2 动态内容替换技巧lmc1_ChangeTextByName是我们最常用的函数但有些高级用法手册上没写。比如要打标的文本特别长时直接调用可能会失败。这时可以分步操作// 先清空原有文本 lmc1_ChangeTextByName(TEXT(long_text), TEXT()); // 分段设置 CString longText GetFromDatabase(); // 从数据库获取长文本 for(int i0; ilongText.GetLength(); i100) { CString chunk longText.Mid(i, 100); lmc1_ChangeTextByName(TEXT(long_text), chunk); Sleep(10); // 稍作延迟 }对于需要频繁变更的内容建议使用模板变量的方式。我们在汽车零部件项目中就这样做在EZCAD2中创建模板文本对象命名为{DATE}、{SN}等程序中实时替换CString currentDate CTime::GetCurrentTime().Format(%Y-%m-%d); lmc1_ChangeTextByName(TEXT({DATE}), currentDate); CString serialNo GenerateSerialNumber(); lmc1_ChangeTextByName(TEXT({SN}), serialNo);3. 构建自动化标刻系统3.1 数据库集成方案真正的自动化系统需要连接数据库。我们给电子厂做的解决方案是这样的架构SQL Server存储产品信息序列号、生产日期、质检结果等中间服务程序定时查询未打标记录调用MarkEzd.dll完成打标更新数据库状态// 数据库操作示例 CADODatabase db; db.Open(_T(ProviderSQLOLEDB;Data Source192.168.1.100;Initial CatalogProduction;User IDsa;Password123456;)); CADORecordset rs(db); rs.Open(_T(SELECT * FROM Products WHERE IsMarked0)); while(!rs.IsEOF()) { CString productID rs.GetFieldValue(_T(ProductID)); CString serialNo rs.GetFieldValue(_T(SerialNo)); lmc1_LoadEzdFile(_T(template.ezd)); lmc1_ChangeTextByName(_T(serial_no), serialNo); if(lmc1_Mark(FALSE) LMC1_ERR_SUCCESS) { db.ExecuteSQL(_T(UPDATE Products SET IsMarked1 WHERE ProductID) productID _T()); } rs.MoveNext(); }3.2 流水线集成实战对于自动化产线还需要处理飞行打标Fly Marking。关键是要配合传感器信号// 配置飞行打标参数 lmc1_SetPenParam(1, 1, 1000, 80, 25, 20000, 100, 100, 100, 100, 1000, 100, 100, 0.1, 0.5, 1, FALSE, 0, 0.5); // 等待传感器信号 while(true) { WORD inputStatus; lmc1_ReadPort(inputStatus); if(inputStatus 0x01) { // 检测IN0信号 lmc1_Mark(TRUE); // 启用飞行打标模式 break; } Sleep(10); }我们给瓶装水生产线做的方案中通过编码器实时获取流水线速度double flySpeed 0.0; lmc1_GetFlySpeed(flySpeed); // 动态调整打标参数 if(flySpeed 1.5) { lmc1_SetPenParam(1, 1, 1500, 85, 25, 25000, 100, 100, 100, 100, 1500, 100, 100, 0.1, 0.5, 1, FALSE, 0, flySpeed); }4. 高级功能与性能优化4.1 多对象批量处理技巧当需要处理大量对象时直接逐个操作会很慢。这时可以用批量处理// 获取所有对象数量 int count lmc1_GetEntityCount(); // 批量修改文本 for(int i0; icount; i) { TCHAR name[256]; lmc1_GetEntityName(i, name); if(_tcsstr(name, _T(DATE_))) { CString newText CTime::GetCurrentTime().Format(_T(%m-%d)); lmc1_ChangeTextByName(name, newText); } }对于图形对象可以用lmc1_MoveEnt统一调整位置// 整体移动所有对象 for(int i0; icount; i) { TCHAR name[256]; lmc1_GetEntityName(i, name); lmc1_MoveEnt(name, 10.0, 5.0); // X方向移动10mmY方向移动5mm }4.2 错误处理与日志记录稳定的工业系统必须有完善的错误处理。我们开发了这样的日志系统void LogError(int errorCode) { CString msg; switch(errorCode) { case LMC1_ERR_EZCADRUN: msg _T(EZCAD正在运行); break; case LMC1_ERR_NOFINDCFGFILE: msg _T(找不到配置文件); break; // ...其他错误码处理 default: msg _T(未知错误); } CTime time CTime::GetCurrentTime(); CString logEntry; logEntry.Format(_T([%s] 错误 %d: %s\n), time.Format(_T(%Y-%m-%d %H:%M:%S)), errorCode, msg); // 写入日志文件 CStdioFile file; if(file.Open(_T(marking_log.txt), CFile::modeCreate|CFile::modeNoTruncate|CFile::modeWrite)) { file.SeekToEnd(); file.WriteString(logEntry); file.Close(); } // 同时输出到调试窗口 OutputDebugString(logEntry); }在每次调用dll函数后都检查返回值int ret lmc1_Mark(FALSE); if(ret ! LMC1_ERR_SUCCESS) { LogError(ret); // 必要时停止设备 EmergencyStop(); }
