# DALI USB SDK

**Repository Path**: meijay/daliusb

## Basic Information

- **Project Name**: DALI USB SDK
- **Description**: DALI USB SDK 支持美加杰智能的MDA80、MDA82及锐高的DALI-USB接口设备，用户可以轻松开发自己的PC应用，来实现开发调试、生产测试DALI驱动电源产品，也为DALI技术爱好者提供了自由灵活的开发测试条件。
- **Primary Language**: C#
- **License**: Apache-2.0
- **Default Branch**: master
- **Homepage**: None
- **GVP Project**: No

## Statistics

- **Stars**: 10
- **Forks**: 4
- **Created**: 2022-04-25
- **Last Updated**: 2025-04-01

## Categories & Tags

**Categories**: Uncategorized

**Tags**: DALI-USB, DALI

## README



# DALI USB SDK

#### 介绍
**DALI USB SDK** 支持美加杰智能的[**MDA80**、**MDA82**](https://www.meijay.com/product/mda80/)及[锐高的DALI-USB](https://www.tridonic.com/com/en/products/dali-usb.asp)接口设备，用户可以轻松开发自己的PC应用，来实现开发调试、生产测试DALI驱动电源产品，也为DALI技术爱好者提供了自由灵活的开发测试条件。

#### 软件架构

*DALI USB SDK*分为基于*Windows* 操作系统上的 *Microsoft .Net Framework* 的动态链接库*Meijay.DaliUsb.dll*（目前未开放源代码）和用户应用演示项目*DaliUsbDemo*。

用户应用调用*Meijay.DaliUsb.dll*开放出的API，来实现*DALI USB*接口设备枚举并通过*DALI USB*接口设备进行DALI总线数据首发。


#### 安装教程 

##### 代码下载 #####

下载SDK压缩包或者使用Git客户端克隆 *DALI USB SDK*的项目库到本地计算机后，即可打开SDK目录。

国内Git仓库地址：https://gitee.com/meijaytech/daliusb.git

国内Git项目主页：https://gitee.com/meijaytech/daliusb

##### 安装Visual Studio #####

接口访问动态链接库和演示应用Demo均基于*.Net Framework v4.7.2* 开发，推荐直接安装当前最新版本 *Visual Studio Community 2022*， 如果您的Windows操作系统不支持，也可以尝试安装*Visual Studio Community 2019*，理论上应该也可以支持。当然如果您拥有Visual Studio Professional或者Visual Studio Enterprise的最新版本，也是完全可以的。

##### 安装第三方支持软件 #####

由于*DALI USB SDK*目前的工作机制依赖于第三方的后端服务接口，因此您还需要确保当前计算机上已经安装了锐高*DALITools* 软件，该软件包含一个可常驻后台的DALI总线服务进程*DaliBusServer25.exe*以及一个提供与此进程进行本机通信的动态链接文件*DaliBusAccess25.dll*。

推荐直接安装锐高的DALI配置软件*masterCONFIGURATOR*软件，该软件的安装包包括了DALITools软件，默认情况下会伴随*masterCONFIGURATOR*一起安装到用户的计算机上。因为事实上*masterCONFIGURATOR*应用程序也依赖*DaliBusAccess25.dll*及*DaliBusServer25.exe*。请使用不低于*v2.36*版本的*masterCONFIGURATOR*软件，太旧的应用所带的*DaliBusAccess25.dll*版本可能无法使用。

**masterCONFIGURATOR最新版本下载地址**：https://www.tridonic.com/com/en/software-masterconfigurator.asp

下载时可能需要填写一些注册信息然后在您的邮箱中点击锐高发给你的下载链接来下载。

运行安装包完成软件安装，在使用DALI USB SDK之前，建议先运行masterCONFIGURATOR应用并连接你拥有的DALI USB接口设备和DALI控制装置（驱动电源、继电器等）进行一些简单的测试以验证一切正常， 如果你还不熟悉DALI控制装置的调试，可以阅读知乎专栏中的这些文章：[DALI 电源调试和配置参数揭秘](https://zhuanlan.zhihu.com/p/293658615)，[DALI 电源进阶调试招式](https://zhuanlan.zhihu.com/p/344948722)。

#### 使用说明

##### 运行演示Demo #####

打开解决方案*DaliUsbSDK.sln*，选择 *DaliUsbDemoApp*生成并运行。

DaliUsbDemo应用启动后会弹出如下窗体，显示第三方DLL文件版本和枚举当前计算机已连接的DALI USB设备名称。

<img src="Documents/resources/daliusbdemo-main-form.png" alt="DALI USB Demo启动窗体" style="zoom:50%;" />

选择一个*DALI USB*设备，点击 “**API 测试**”按钮，将弹出 DALI USB API测试窗体。

<img src="Documents/resources/daliusbdemo-apitest.png" alt="DALI USB API测试" style="zoom:50%;" />

 一旦检测到DALI USB接口设备，应该尽快点击“API测试”按钮打开测试窗体，因为*DaliBusServer25*进程在没有外部进程连接其服务的情况下，5秒左右会自动退出。如果想让其常驻后台不退出，可以在*DaliBusServer25*启动后，右键点击其在Windows任务栏右下角的图标，打开*DALI Monitor*窗口，*DALI Monitor*将自动打开可用的DALI USB设备，这样一来*DaliBusServer25*后台将不会自动关闭。同理，打开*masterCONFIGURATOR*应用也能达到一样的效果。   

<p float="left" align="middle">
  <img src="Documents\resources\dalibuserver_icon.png" style="zoom:50%;" />
  <img src="Documents\resources\dalibuserver_menu.png" style="zoom:50%;" /> 
</p>


> **注意**：如果没有可用的DALI USB设备，“API测试”按钮将不可用。如果计算机上已经连接了DALI USB设备但未显示，可以等待数秒等*DaliBusServer25*后台进程退出后点击“查找DALI USB设备”重新查找。



##### 创建新项目 #####

参考Demo工程，在Visual Studio中创建新的C# Windows 窗体应用(.Net Framework)，添加*Meijay.DaliUsb.dll* 引用到项目中。



###### 搜索DALI USB接口设备 ######



###### 打开DALI USB 接口 ######



###### 发送 DALI 总线数据 ######



更多使用参考*DALI USB SDK API*说明文档：（待创建）




#### 参与贡献

JoeyTian