# MDS DotNET Serial

**Repository Path**: MicroDistanceStudio/mds-dot-net-serial

## Basic Information

- **Project Name**: MDS DotNET Serial
- **Description**: 为LabVIEW写的.NET串口工具包
- **Primary Language**: Unknown
- **License**: Apache-2.0
- **Default Branch**: master
- **Homepage**: None
- **GVP Project**: No

## Statistics

- **Stars**: 6
- **Forks**: 0
- **Created**: 2024-10-23
- **Last Updated**: 2025-09-12

## Categories & Tags

**Categories**: Uncategorized

**Tags**: dotNET

## README

# 🔌 LabVIEW .NET SerialPort 封装库

本项目是一个使用 LabVIEW 封装的 .NET `System.IO.Ports.SerialPort` 类库，旨在帮助开发者在 LabVIEW 中更高效、灵活地操作串口通信，而无需使用传统 VISA 串口节点。

🛠 **适用环境：LabVIEW 2015 或更高版本（32/64 位均可）**  
📦 **依赖平台**：Windows + .NET Framework 4.5 或更高版本

---

## ✨ 项目亮点

- ✅ 基于 .NET `System.IO.Ports.SerialPort` 封装
- ✅ 实现基础串口通信功能：
  - 打开/关闭串口
  - 设置端口参数（波特率、数据位、停止位、校验等）
  - 串口数据读写（同步）
  - 事件监听（可扩展支持接收中断等）
- ✅ 使用 LabVIEW 面向对象方式封装，接口清晰
- ✅ 所有 VI 均配有中文注释，适合国内开发者
- ✅ 支持与其他 .NET 封装组件（如 Stream）结合使用

---

## 🚀 快速开始

1. 克隆本仓库或下载源码；
2. 安装 .NET Framework（默认 Windows 自带）；
3. 打开 `Examples/Demo - Send and Receive.vi`；
4. 配置端口参数，连接串口设备，运行即可进行数据收发。

---

## 📌 支持的操作方法

| VI 名称                        | 功能说明                           |
|-------------------------------|------------------------------------|
| `Open.vi`                     | 打开串口连接                       |
| `Close.vi`                    | 关闭串口                           |
| `Write.vi`                    | 写入字节数据/字符串                 |
| `Read.vi`                     | 读取指定长度的数据                  |
| `ReadExisting.vi`             | 读取串口缓冲区当前所有数据         |
| `Set Config.vi`               | 设置端口号、波特率、校验、停止位等 |
| `BytesToRead.vi`              | 获取当前可读取字节数               |

---

## 🧪 示例演示

> ✅ 向串口发送字符串命令并读取响应  
> ✅ 配置串口参数（如 COM3、115200、8-N-1）  
> ✅ 检测串口是否开启，读取缓冲区数据

---

## 🔧 可扩展方向

- 异步数据接收（基于 .NET 事件）  
- 与 `Stream` 封装结合实现高级协议  
- 多串口管理与自动扫描  
- 串口调试终端界面 UI 封装

---

## 📝 许可证

本项目采用 MIT 协议开源，欢迎学习、使用、贡献和二次开发。

---

## 👤 作者与维护

- **微距离 | MicroDistance Studio**  
- 🔗 项目主页：https://gitee.com/MicroDistanceStudio  
- 💬 有任何建议或问题，欢迎提交 Issue 或 PR！

---