> For the complete documentation index, see [llms.txt](https://docs.haohaodada.cn/llms.txt). Markdown versions of documentation pages are available by appending `.md` to page URLs; this page is available as [Markdown](https://docs.haohaodada.cn/jiao-xue-chan-pin/arduino-kai-yuan-ying-jian/haodamidi-mo-kuai.md).

# haodaMIDI模块

## 概述

        MIDI(Musical Instrument Digital Interface)乐器数字接口，解决电声乐器的通信问题，MIDI传输的不是声音信号，而是音符、控制参数等指令,它指示MIDI设备要做什么，怎么做，如演奏哪个音符、多大音量等。它们被统一表示成MIDI消息(MIDI Message)。

        haodaMIDI采用入门级硬音源芯片，5颗高品质钽电容保证音质。可以接入各种控制器控制如microbit、掌控、好搭酷、Arduino、徽章板等。haodaMIDI硬音源带耳放，可以接耳机播放。硬音源带127种乐器音色，60余打击乐器，可以图形化编程，控制简单，完全可以制作各种电声乐器，或自动演奏乐器（相当于一支乐队）。

![](https://3988445729-files.gitbook.io/~/files/v0/b/gitbook-legacy-files/o/assets%2F-LWF1jkbOkV3Cs8uqgVf%2F-Lqdv2O_xuC5uZsMqzPx%2F-LqdzmdHsbuddxKYZ25w%2FhaodaMIDI-1.png?alt=media\&token=7866e005-0fdc-4675-8f5a-20acea37364a)

## 参数

波 特 率：31.25×( 1±0.01) Kbaud

工作电压：3.3V 接 口：XH2.54mm-3P

信        号：1-地 2-电源 3-信号 

尺        寸：48x24mm

## 控制代码

        haodaMIDI通信息协议为异步串口协议，波特率为312500，只要向通过信号线S发送MIDI控制指令，就能驱动haodaMIDI发出各种乐器的声音。 

        haodaMIDI有16个通道，其中第10通道是打击乐节奏通道，标准MIDI协议就可以通道，部分控制指令(三字节）案例

### 切换通道音色

第一字节：C+通道4b，第二字节：通道音色（0-127），第三字节同第二字节 

示例：0xC0 0x02 0x02，表示把第一通道的音色切换为电钢琴。

### 演奏音符

第一字节：9+通道4b（除10通道），第二字节：音符（0-127），第三字节力度（音量0-127） 

示例：0x90 0x48 0x32，表示向第一通道发送4音阶的音符C，力度是50。

### 演奏打击乐

第一字节：99（第10通道），第二字节：打击乐器名，第三字节力度（单量0-127） 示例：0x99 0x35 0x64，表示大鼓发音力度为100。

## 示例

### 徽章板和好搭酷

1、电脑作为MIDI：将徽章板或好搭酷与电脑通过USB线连接，编写代码下载到设备，下载成功后，电脑音频输出音乐。

![](https://3988445729-files.gitbook.io/~/files/v0/b/gitbook-legacy-files/o/assets%2F-LWF1jkbOkV3Cs8uqgVf%2F-Lqdv2O_xuC5uZsMqzPx%2F-LqeBNOgiS2zN-NKdYiP%2FhaodaMIDI-3.png?alt=media\&token=634be0d8-9b74-441b-a8d5-db69eb5d3d50)

![](https://3988445729-files.gitbook.io/~/files/v0/b/gitbook-legacy-files/o/assets%2F-LWF1jkbOkV3Cs8uqgVf%2F-Lqdv2O_xuC5uZsMqzPx%2F-LqeBSfR7ylqpvzbsdIL%2FhaodaMIDI-4.png?alt=media\&token=b04bbc2d-8a53-4a88-9a46-ed466788c7bd)

2、连接haodaMIDI模块：将haodaMIDI与徽章板或好搭酷的扩展接口连接，并连接音响或耳机，下载程序后，haodaMIDI通过音响或耳机播放音乐。

![](https://3988445729-files.gitbook.io/~/files/v0/b/gitbook-legacy-files/o/assets%2F-LWF1jkbOkV3Cs8uqgVf%2F-LsVpruYwC-UQNosTq-j%2F-LsVrZabkqOQiHLg7c4g%2Fhaodamidi-ff-1.png?alt=media\&token=9c761280-b329-4460-b369-abc9959899a4)

![](https://3988445729-files.gitbook.io/~/files/v0/b/gitbook-legacy-files/o/assets%2F-LWF1jkbOkV3Cs8uqgVf%2F-LsVpruYwC-UQNosTq-j%2F-LsVrgfiM15NkYsuIlR2%2Fhaodamidi-ff-2.png?alt=media\&token=7fc11063-db0c-4f6a-af4f-497335ae0439)

![](https://3988445729-files.gitbook.io/~/files/v0/b/gitbook-legacy-files/o/assets%2F-LWF1jkbOkV3Cs8uqgVf%2F-LsVpruYwC-UQNosTq-j%2F-LsVrm263J5JNPu9j0xf%2Fhaodamidi-ff-3.png?alt=media\&token=6466aa8a-600b-4d2a-89c0-14eaed0e3e48)

[点击此处](http://www.haohaodada.com/hz/) 进入徽章板编程界面

[点击此处](http://www.haohaodada.com/Core/) 进入好搭酷编程界面

### Arduino UNO

![](https://3988445729-files.gitbook.io/~/files/v0/b/gitbook-legacy-files/o/assets%2F-LWF1jkbOkV3Cs8uqgVf%2F-Lqdv2O_xuC5uZsMqzPx%2F-LqeC1tvocV4tyQ5_W4_%2FhaodaMIDI-5.png?alt=media\&token=6c8005c5-6fb2-4ed3-a7ea-8dd1f747c410)

![](https://3988445729-files.gitbook.io/~/files/v0/b/gitbook-legacy-files/o/assets%2F-LWF1jkbOkV3Cs8uqgVf%2F-Lqdv2O_xuC5uZsMqzPx%2F-LqeCN-qJklfDoZM06zs%2FhaodaMIDI-6.png?alt=media\&token=4a271477-e05a-4f5b-a9b7-c1c388265cb4)

使用前，先加载库文件，库文件见附录。

### micro:bit

![](https://3988445729-files.gitbook.io/~/files/v0/b/gitbook-legacy-files/o/assets%2F-LWF1jkbOkV3Cs8uqgVf%2F-Lqdv2O_xuC5uZsMqzPx%2F-LqeCp_HXy7Yy5HCG9q6%2FhaodaMIDI-7.png?alt=media\&token=4f246ffa-a3d5-409b-a00b-2c3a20860be1)

![](https://3988445729-files.gitbook.io/~/files/v0/b/gitbook-legacy-files/o/assets%2F-LWF1jkbOkV3Cs8uqgVf%2F-LrmJJ4CTxsZ4MGQYvBD%2F-LrmJOYCpVOK-GZmXAf4%2F_U%5BN%7B_92GHF%5BNA5U\(3CNPSO.png?alt=media\&token=5874ac95-7b66-4f30-ac7b-f21ae1da9a95)

![](https://3988445729-files.gitbook.io/~/files/v0/b/gitbook-legacy-files/o/assets%2F-LWF1jkbOkV3Cs8uqgVf%2F-LrmJJ4CTxsZ4MGQYvBD%2F-LrmJ_QjKLUaIrHb0dWt%2FQCKRTCY%5DT41~O_\(GZNVJ\)17.png?alt=media\&token=b4edfef8-d331-4aaf-a736-8d6147b1eced)

haodaMIDI扩展包链接：<https://github.com/Haohaodada-official/pxt-haodaMIDI.git>

### 掌控板

![](https://3988445729-files.gitbook.io/~/files/v0/b/gitbook-legacy-files/o/assets%2F-LWF1jkbOkV3Cs8uqgVf%2F-Lqdv2O_xuC5uZsMqzPx%2F-LqeE62mtgugS7upLmOD%2FhaodaMIDI-8.png?alt=media\&token=055dc159-3762-4c32-b86b-bd7db489436c)

## 常见问题

Q:5V控制器怎么使用

A:可以采用降压3.3V供电，信号线串电阻限流就可以正常工作。

## 附件

Arduino库

{% file src="/files/-LqeIXWE\_zGYngzfoNHz" %}