基于arduino的ESP32上蓝牙midi音乐设备开发教程

news2024/11/29 6:36:47

简介

开发环境

开发过程

函数介绍

简介

首先看几个视频，大佬们做的东西，都是基于esp32。

自制卡林巴电子琴，可通过蓝牙连接手机库乐队 MIDI Boy【理科生的第一件乐器】_哔哩哔哩_bilibili

【Totoro】模仿“埙”的电子吹奏乐器_哔哩哔哩_bilibili

开发环境

esp32开发板

android手机，因为我只有android手机，ios没有验证过。

arduino2.3.2

自乐班自乐班 - 锣钹科技 (robkoo.com)

开发过程

打开raduino，安装库中搜索“BLE-MIDI”并安装。

先这样选，后面需要手动更改，

配置开发板

如果你用了其他esp32模块，根据需要进行选择。

现在我们需要手动修改一下库，以为刚刚全部下载的依赖库中包含了多余的库。

我们到“项目文件夹地址”的目录中

我们看到一共下载了4个库，我们需要手动把ArduinoBLE文件夹删掉，因为这个库里面的东西与esp32的ble库冲突。

现在我们就准备好了全部的环境。

函数介绍

我的功能定义的比较简单，就是蓝牙能够连接上手机，然后代码能够让手机发出音乐，所以这里我就说一下必须用到的函数，额外的功能自行学习吧。

需要引用的头文件

#include <BLEMIDI_Transport.h>
#include <hardware/BLEMIDI_ESP32.h>

BLEMIDI_CREATE_DEFAULT_INSTANCE()

定义了蓝牙设备，名字是默认的“Esp32-BLE-MIDI”

#define BLEMIDI_CREATE_INSTANCE(DeviceName, Name)

如果需要定义特别的名字，可以调用上面的宏，如：BLEMIDI_CREATE_INSTANCE("MyBLEserver",MIDI)

MIDI.begin();

初始化蓝牙midi设备。

    BLEMIDI_Transport &setHandleConnected(void (*fptr)())
    {
        _connectedCallback = fptr;
        return *this;
    }

    BLEMIDI_Transport &setHandleDisconnected(void (*fptr)())
    {
        _disconnectedCallback = fptr;
        return *this;
    }

设备连接和断开回调。可以如下方法使用。

  BLEMIDI.setHandleConnected([]() {
    isConnected = true;
    digitalWrite(LED_BUILTIN, HIGH);
  });

  BLEMIDI.setHandleDisconnected([]() {
    isConnected = false;
    digitalWrite(LED_BUILTIN, LOW);
  });

void MidiInterface<Transport, Settings, Platform>::sendNoteOn(DataByte inNoteNumber,
                                                     DataByte inVelocity,
                                                     Channel inChannel)

发送信息给手机，inNoteNumber播放的音节，inVelocity音量0-100,0表示关闭，inChannel通道，对于midi音乐设备没有用到，直接写1即可。

音节的表可以看【低功耗蓝牙】④ 蓝牙MIDI协议-CSDN博客文章。

下面我贴一下我的测试代码，

#include <BLEMIDI_Transport.h>

//#include <hardware/BLEMIDI_ESP32_NimBLE.h>
#include <hardware/BLEMIDI_ESP32.h>
//#include <hardware/BLEMIDI_nRF52.h>
//#include <hardware/BLEMIDI_ArduinoBLE.h>

BLEMIDI_CREATE_DEFAULT_INSTANCE()

unsigned long t0 = millis();
bool isConnected = false;
#define LED_BUILTIN 2
#define BUTTON_PIN 0
// -----------------------------------------------------------------------------
// When BLE connected, LED will turn on (indication that connection was successful)
// When receiving a NoteOn, LED will go out, on NoteOff, light comes back on.
// This is an easy and conveniant way to show that the connection is alive and working. 
// -----------------------------------------------------------------------------
void setup()
{
  MIDI.begin();
  Serial.begin(9600);

  pinMode(LED_BUILTIN, OUTPUT);
  pinMode(BUTTON_PIN, INPUT_PULLUP);
  digitalWrite(LED_BUILTIN, LOW);

  BLEMIDI.setHandleConnected([]() {
    isConnected = true;
    digitalWrite(LED_BUILTIN, HIGH);
  });

  BLEMIDI.setHandleDisconnected([]() {
    isConnected = false;
    digitalWrite(LED_BUILTIN, LOW);
  });

  MIDI.setHandleNoteOn([](byte channel, byte note, byte velocity) {
    digitalWrite(LED_BUILTIN, LOW);
  });
  MIDI.setHandleNoteOff([](byte channel, byte note, byte velocity) {
    digitalWrite(LED_BUILTIN, HIGH);
  });
}

// -----------------------------------------------------------------------------
//
// -----------------------------------------------------------------------------
void loop()
{
  // MIDI.read();
  int buttonState = digitalRead(BUTTON_PIN);
  if ((buttonState == LOW) && isConnected) {
    Serial.printf("123\n");
    MIDI.sendNoteOn (60, 100, 1);
    delay(500);
    MIDI.sendNoteOn (70, 100, 1);
    delay(5000);
    MIDI.sendNoteOn (60, 0, 1);
    MIDI.sendNoteOn (70, 0, 1);
  }
  delay(10);
}

下载完成后手机上打开自乐班软件，找到“设备管理”，“其他MIDI”，“BLE MIDI设备”，点击“Esp32-BLE-MIDI”，连接完成后名字后面会有一个小黄点。