Our Dongguan engineers hear one question constantly: does a CCD laser marking machine’s vision software really support secondary development PLC communication interface 1? Buyers who skip this check often discover the answer after delivery.
To check if a CCD laser marking machine’s vision software supports secondary development, request the actual SDK, confirm it exposes camera, vision, calibration, and marking functions through a documented API or protocol, review the license, and run a working external demo before purchase.
That sounds simple. In practice, the phrase “supports secondary development” means very different things to different suppliers. Below, I break the check into four practical steps. Each step comes from real projects on our own production lines and from customers across Europe, Asia, and North America.
What Features Should I Look for to Confirm SDK or API Availability for Secondary Development?
Last year a Turkish customer sent us a brochure from another supplier. It said "SDK supported". The install folder had no header files, no DLL exports, nothing to call.
Look for a dedicated SDK folder with header, library, and DLL files, an API reference, C# and C++ sample projects, documented communication protocols, scripting or plugin support, and clear license terms. These features confirm real secondary development access rather than a marketing claim.
The first thing I tell buyers is this: interface openness is the foundation. If the supplier does not provide an API, SDK, or at least a documented communication protocol 2, nothing else matters. So I start every evaluation by sorting the machine into one of three levels.
Three levels of "support"
| Level | What you can do | Typical interface | Enough for custom software? |
|---|---|---|---|
| Parameter customization | Change recipes, exposure, lighting, templates, marking fields | Vendor GUI only | No |
| External control | Trigger inspection or marking, send product data, receive OK/NG | I/O, TCP/IP, PLC registers, database | Partly |
| True secondary development | Call vision and marking functions from your own application | SDK, API, DLL library files, source code examples | Yes |
Many machines sold as "open" sit at level two. That is fine for a basic automated production line integration. It is not fine if you want to write your own recognition logic or embed the visual positioning system 3 inside your own quality software.
What I look for inside the installation folder
When we hand a machine to a customer's developer, we point them to concrete files. You should ask any supplier for the same evidence:
- A dedicated "SDK" or "Developer" subfolder containing .h header files and .lib files.
- DLL library files that actually export functions for both laser control and image acquisition.
- Help files that mention "Secondary Development", "API Reference", or "COM Interface".
- Sample projects in C#, C++, or LabVIEW that compile and run.
- Native Python bindings or .pyd files, which matter if your team works with an image processing library like OpenCV or AI tools like PyTorch.
- A scripting console or plugin menu that runs LUA, Python, or VBScript.
- A "headless mode" or command line interface for background processing.
- A virtual device or simulation driver so developers can debug without the physical hardware.
- Any RESTful endpoints or WebSocket listeners for web-based control and data logging.
A laser SDK is not a vision SDK
This is the trap I see most often. Some marking platforms do offer solid C# and C++ support with manuals and demo code. EZCAD, for example, publishes C++ and C# development resources for its EZCAD2 and EZCAD3 software. That proves the laser controller is open. It does not prove the CCD machine vision algorithms 4 are exposed. Ask the supplier directly: does the API control camera connection, trigger mode, exposure, light source, template loading, pattern matching, OCR, coordinate calibration, marking-file generation, and result logging? If the answer covers only the laser side, you have a laser SDK with a closed camera bolted on.
How Can I Verify Compatibility With My Existing Automation Software Before Purchasing?
There is a trade-off we weigh on every automated line project: a certified PLC protocol gives deterministic control, but an open API gives flexibility. Most factories need both.
Verify compatibility by listing your PLC, MES, and ERP interfaces, matching them to the machine's supported protocols such as TCP/IP, Modbus TCP, PROFINET, EtherNet/IP, or OPC UA, then running a "hello vision" test that triggers capture, returns coordinates, and logs results.
System compatibility is the fourth point on my personal checklist, and it is where purchasing managers lose the most time. The reason is simple. "Supports PLC communication" and "supports software secondary development 5" are two different claims. A PLC communication interface may expose fixed registers and signals only. A rich SDK may lack certified industrial automation protocols. I always check for one industrial control path and one higher-level data path.
Match the interface to the job
| Integration path | Best for | Limitation |
|---|---|---|
| Discrete digital I/O | Start, ready, complete, alarm signals | No data content |
| PROFINET / EtherNet/IP / Modbus TCP / EtherCAT | Deterministic machine control from a PLC | Cannot change algorithms or read images |
| TCP/IP socket commands | Sending serial numbers, variable text, receiving results | Needs a documented message format |
| OPC UA / REST / database | MES, ERP, SCADA, traceability | Not for real-time sync |
| SDK / API function calls | Embedding vision and marking in your own software | Requires developer effort and licenses |
When we design systems for automotive or battery customers, the PLC handles the cycle, and the MES receives structured data through TCP/IP or a database. The vision and marking functions sit underneath, reachable by the SDK when the customer wants deeper control.
Run a "hello vision" test
Before any purchase, ask the supplier to let your developer build a tiny external application. It should:
- Connect to the camera.
- Capture one image.
- Run a positioning or inspection task.
- Return coordinates and a pass/fail result.
- Send a simulated marking command.
- Log the result to a file or database.
If step three or step four cannot be completed with documented interfaces, the third-party software compatibility you were promised is not real. While you are at it, record the operating environment: Windows version, 32-bit or 64-bit, .NET Framework or modern .NET, required runtime libraries, and whether the SDK can run without the vendor's full graphical application.
Check the state machine, not just the start command
In my experience, most integration failures come from race conditions, not weak algorithms. A reliable machine exposes states such as Idle, Ready, Capturing, Processing, Alignment Successful, Alignment Failed, Marking, Mark Complete, Verification Complete, Fault, and Resetting. Ask whether triggers are timestamped, whether there is a timeout, whether repeated triggers can create duplicate marks, and how the software recovers after a camera or network disconnect. For data exchange, insist on structured messages with explicit fields, a unique part ID, a timestamp, and an acknowledgment. Avoid flat strings like "START12345". They look easy but are very hard to troubleshoot on a live line.
Which Documentation or Technical Support Should I Request From the Supplier to Confirm Development Capabilities?
A project manager from Germany once asked me for "the manual". I sent him six documents instead, because one PDF never covers a full SDK.
Request the full SDK documentation package: API reference, installation guide, source code examples, error-code list, calibration procedure, license agreement, and version compatibility notes. Also ask for a live external demo, named engineering contact, and a written commitment on debugging help and future upgrades.
Checking the development documentation is the second point on my checklist, and clear technical support is the fifth. I group them together here because they are two sides of the same promise. Good SDK documentation reduces how often you need support. Good support rescues you when the documentation falls short.
The documentation package I expect to see
| Document | Must explain | Red flag |
|---|---|---|
| API reference | Every callable function, parameters, return values, coordinate units | Function names with no descriptions |
| Installation guide | Runtime dependencies, drivers, camera compatibility, clean-PC setup | "Install our full software first" with no alternative |
| Source code examples | Camera trigger, alignment, marking command, verification, error recovery | Only a laser-only demo, no camera code |
| Error-code list | Codes, meanings, recommended recovery | Generic "unknown error" |
| Calibration procedure | Camera-to-laser transform, distortion correction, multi-point calibration | Calibration locked inside the vendor GUI |
| Threading and memory notes | Thread safety, callback behavior, image-buffer ownership | No mention at all |
| License agreement | Runtime fees, per-station limits, redistribution rights, dongle requirements | Verbal assurances only |
| Version compatibility | Supported OS, .NET versions, support period for the chosen version | No stated support lifetime |
The calibration document deserves extra attention. A visual positioning system must translate camera pixels into laser coordinates. Ask whether the SDK exposes calibration routines, transformation matrices, camera-to-laser offsets, lens-distortion correction, rotation and scale parameters, and Z-axis compensation. Without these, your custom application can find the part but cannot place the mark.
Support you should test, not trust
Our team in Dongguan includes 20 solution design engineers, and I still tell customers to judge us by a proof-of-concept rather than by promises. Ask the supplier to demonstrate, on a clean industrial computer, a complete external application that triggers the camera, corrects coordinates, sends a marking command, reads back a verification result, and recovers from a forced fault. Then confirm three things in writing: who answers developer questions, how fast they respond, and whether debugging help and later upgrades are included or billed.
Licensing is where "free SDK" quietly becomes expensive. Review the one-time SDK fee, runtime license per machine, per-camera or per-station charges, feature licenses for OCR or deep learning, annual maintenance, upgrade fees, and any dongle requirement. Ask one direct question: can I deploy the finished application to multiple machines in multiple factories without paying again? Get the end-user license agreement before development begins, not after.
What Questions Should I Ask the Manufacturer to Avoid Hidden Limitations in Vision Software Customization?
The hardest lesson we learned came from a Vietnamese battery line. The API worked, but the customer could not change the matching rule. We now define "customizable" in writing.
Ask exactly which vision and marking functions are exposed, whether raw images and intermediate results are accessible, whether recognition rules and marking flows can be customized, which languages and licenses apply, how errors recover, and whether the supplier will prove it with your parts.
Function extension is the third point on my personal checklist. Can you customize recognition rules, marking flows, and parameters? This is where hidden limitations hide. A supplier may expose a pass/fail result but keep the machine vision algorithms, the raw image, and the confidence score locked away. The questions below are the ones I would ask any manufacturer, including us.
The questionnaire
- What exactly does "secondary development" include in your offer?
- Is a vision SDK included, or only a laser-control SDK?
- Which API functions control acquisition, processing, alignment, marking, and verification?
- Which programming languages and operating systems are supported?
- Can my external program receive raw images, processed images, and intermediate measurements?
- Can it change camera, lighting, and recipe parameters?
- Can it perform camera-to-laser calibration?
- Which communication protocols are available?
- Is the API synchronous, asynchronous, or callback-based?
- What are the timing and throughput limits?
- How are errors and reconnections handled?
- What runtime licenses are required?
- Can the finished application run on multiple machines?
- Is source code available, and at what cost?
- How long will you support this software version?
- Can you provide a working demo using my part samples?
Is an open SDK always better?
Buyers sometimes push back here, and the objection is fair. An open API adds development, validation, cybersecurity, and maintenance work. For a stable, single-product line, a vendor's built-in vision tools for part detection, mark alignment, and code verification may deploy faster and run more reliably. I agree with that for simple cases. The problem is what happens next. If the factory later adds a new product, a different camera, a new barcode format, or a new MES, a closed system forces paid vendor customization every time. The right answer is to match openness to your roadmap. If you run many products or many machines, pay for the SDK now.
The same logic applies to AI. Vision systems are moving from rule-based inspection toward deep-learning classification 6 and anomaly detection. That helps with irregular-part localization, surface defects, and OCR under poor contrast. But AI needs representative training data, model validation, and often a GPU. Ask whether the SDK exposes model deployment and version management, or whether "AI vision" is just a prepackaged tool you cannot call externally.
A staged acceptance test
| Stage | What to verify |
|---|---|
| 1. Documentation review | SDK, API reference, license, supported platforms, sample code received |
| 2. Connectivity | External app connects to camera, controller, and lighting |
| 3. Vision | Positioning, inspection, OCR, or code reading runs from your code |
| 4. Coordinates | Offsets and rotations produce correct marks across the full work area |
| 5. Production cycle | Normal, misaligned, missing parts, and interrupted communication |
| 6. Fault recovery | Camera disconnect, network loss, forced NG, application restart |
| 7. Deployment | Clean industrial PC, no undocumented development environment |
| 8. Handover | Backups, calibration data, versions, license keys, maintenance procedures |
Avoid any integration that depends on undocumented registry settings, hard-coded paths, or reverse-engineered commands. They work in the lab and break after the next Windows update.
Conclusion
Vague SDK claims cause costly surprises after delivery. Demand exposed functions, documentation, licenses, and a working demo. Our Lansulaser team is ready to prove it on your parts.
Footnotes
1. Professional organization providing standards for industrial automation and control systems. ↩︎
2. Foundational information on communication protocols used in industrial software integration. ↩︎
3. International standards organization covering quality and technical specifications for positioning systems. ↩︎
4. Authoritative source for machine vision algorithms and image processing libraries. ↩︎
5. General definition of software development processes and secondary development concepts. ↩︎
6. Leading framework for deep-learning classification and AI model development. ↩︎