Ecosyste.ms: Awesome

An open API service indexing awesome lists of open source software.

Awesome Lists | Featured Topics | Projects

https://github.com/microsoft/pxt-bluetooth-midi

A Bluetooth Midi package for Microsoft Make Code
https://github.com/microsoft/pxt-bluetooth-midi

makecode microbit midi

Last synced: about 1 month ago
JSON representation

A Bluetooth Midi package for Microsoft Make Code

Awesome Lists containing this project

README

        

# bluetooth-midi [![Build Status](https://travis-ci.org/Microsoft/pxt-bluetooth-midi.svg?branch=master)](https://travis-ci.org/Microsoft/pxt-bluetooth-midi)

A [Bluetooth low energy MIDI](https://www.midi.org/specifications/item/bluetooth-le-midi)
support for the @boardname@.
**iOS only currently**.

### ~hint
![](/static/bluetooth/Bluetooth_SIG.png)

For another device like a smartphone to use any of the Bluetooth "services" which the @boardname@ has, it must first be [paired with the @boardname@](/reference/bluetooth/bluetooth-pairing). Once paired, the other device may connect to the @boardname@ and exchange data relating to many of the @boardname@'s features.

### ~

## Usage

This package allows the @boardname@ to act as a MIDI peripherical, like a piano. It requires to connect to a BLE MIDI device to receive the commands and play them.

This library uses the [MIDI package](/pkg/microsoft/pxt-midi).
Please refer to that project documentation for further details on using MIDI commands.

## Supported Platforms

This package is currently only supported on iOS (iPad/iPhone).
Any app that supports a MIDI keyboard or instrument should work.

### Apple GarageBand

* [iPhone/iPad App](https://itunes.apple.com/us/app/garageband/id408709785?mt=8)

Go to settings (gearwheel), click **Advanced**, click **Bluetooth MIDI device** and connect to the @boardname@.
If the @boardname@ is marked as offline, click **Edit** and **Forget** the device.

## Supported targets

* for PXT/microbit
* for PXT/calliope

(The metadata above is needed for package search.)

## License

MIT

## Code of Conduct

This project has adopted the [Microsoft Open Source Code of Conduct](https://opensource.microsoft.com/codeofconduct/). For more information see the [Code of Conduct FAQ](https://opensource.microsoft.com/codeofconduct/faq/) or contact [[email protected]](mailto:[email protected]) with any additional questions or comments.