Suucha.Can.Zlg.Native 0.1.0

Suucha.Can.Zlg.Native

This package contains the native runtime libraries (DLLs) for ZLG CAN devices.

📌 Version Information

• ZLG Native DLL Version: 20260414 (April 14, 2026)
• Copyright: (C) 2012-2025 Guangzhou ZHIYUAN Electronics Co., Ltd.
• License: BSD-3-Clause
• Official Documentation: ZLG CAN API Manual

Note: The official ZLG documentation link above contains:

• Native DLL download links
• API reference and usage documentation
• Device-specific integration guides
• Example code and best practices

📦 What's Included

Architecture Support

• ✅ x86 (32-bit) - runtimes/win-x86/native/
• ✅ x64 (64-bit) - runtimes/win-x64/native/

Native Libraries

• zlgcan.dll - Main ZLG CAN driver interface
• kerneldlls/ - Device-specific kernel drivers for:
  • USBCAN series (USBCAN-I, USBCAN-II, USBCAN-E-U, etc.)
  • CANET series (CANET-E-U, CANET-2E-U, etc.)
  • CANFDNET series (CANFDNET-200U, CANFDNET-400U, etc.)
  • USBCANFD series (USBCANFD-100U, USBCANFD-200U, etc.)
  • PCIe CAN devices
  • WiFi CAN devices
  • And more...

⚠️ Important Notes

Prerequisites

Before using this library, you must install:

1. ZLG Device Drivers (Required)

   • Download from: ZLG Driver Manual
   • Install the driver package for your specific device model
   • Verify installation in Windows Device Manager

2. Visual C++ Redistributable (Required)

   • VC++ 2013 is the primary requirement
   • Older versions (2008, 2010) may be needed for some devices
   • See main README.md for download links

Do NOT Reference This Package Directly

This is a runtime dependency package. You should NOT add it as a direct reference.

❌ Wrong:

<PackageReference Include="Suucha.Can.Zlg.Native" Version="0.1.0" />

✅ Correct:

<PackageReference Include="Suucha.Can.Zlg.Devices" Version="0.1.0" />

The native DLLs will be automatically included when you reference Suucha.Can.Zlg.Devices.

🏗️ Architecture

The native DLLs are automatically deployed based on your platform:

Your Application
├── [AnyCPU build]
│
├── When running on x86 system
│   └── Uses: runtimes/win-x86/native/zlgcan.dll
│
└── When running on x64 system
    └── Uses: runtimes/win-x64/native/zlgcan.dll

🔧 Supported Device Families

This package supports ALL ZLG CAN device families:

📄 License

BSD-3-Clause License

Copyright (C) 2012-2025 Guangzhou ZHIYUAN Electronics Co., Ltd.

These native libraries are proprietary software owned by ZLG. Redistribution is permitted under BSD-3-Clause terms, but you must:

• Keep copyright notices
• Not claim ZLG endorsement
• Have valid ZLG hardware

License Files Included in Package:

• zlgcan_License.txt - Original ZLG license (Chinese and English)
• Main project LICENSE - Full dual-license details (MIT + BSD-3-Clause)

🔗 Related Packages

• Suucha.Can.Core - Core abstractions and interfaces
• Suucha.Can.Zlg.Devices - Unified device implementation (supports all ZLG device types)

📚 More Information

• ZLG CAN API Manual: Official Documentation & Downloads
• ZLG Device Drivers: Driver Downloads
• ZLG Official Website: http://www.zlg.cn
• Suucha.Can Project: https://github.com/suucha/Suucha.Can

🆘 Support

For ZLG Hardware & Native DLL Support:

• 📖 ZLG CAN API Documentation
• 🌐 ZLG Official Website
• Contact ZLG technical support directly

For Suucha.Can Wrapper Library Issues:

• 🐛 GitHub Issues
• 💬 GitHub Discussions