Teensy MIDI 8x8

Teensy MIDI 8x8 is a project designed to provide an 8x8 MIDI interface using a Teensy microcontroller. This repository contains the necessary code and configuration files to get started with the project.

Table of Contents

• Installation
• Usage
• Project Structure
• Contributing

Installation

To set up this project, you will need to have PlatformIO installed. PlatformIO is an open-source ecosystem for IoT development that supports multiple platforms and frameworks.

1. Clone the repository:

   git clone --recursive https://forge.rights.ninja/jeff/teensy-midi-8by8.git
   cd teensy-midi-8by8
   

2. Open the project with PlatformIO:

   • Launch PlatformIO IDE.
   • Open the teensy-midi-8by8 directory.

3. Build and upload:

   • Connect your Teensy microcontroller to your computer.
   • Use PlatformIO to build and upload the project to your Teensy.

Usage

Once the project is uploaded to your Teensy, it will function as an 8x8 MIDI interface. You can connect your MIDI devices to the Teensy and start using it with your preferred MIDI software.

Project Structure

The project directory is structured as follows:

teensy-midi-8by8/
├── .gitignore
├── .gitmodules
├── .vscode/
│   └── extensions.json
├── include/
│   └── […]
├── lib/
│   └── […]
├── src/
│   ├── main.cpp
│   └── name.c
├── test/
│   └── […]
└── platformio.ini

• .gitignore: Specifies files and directories to be ignored by Git.
• .gitmodules: Contains information about the Git submodules used in the project.
• .vscode/extensions.json: Recommended extensions for Codium or VS Code.
• include/: Directory for header files.
• lib/: Directory for external libraries.
• src/: Directory for the main source code.
  • main.cpp: Main application code.
  • name.c: Defines the USB device name.
• test/: Directory for test files.
• platformio.ini: PlatformIO configuration file.

Contributing

Contributions are welcome! Please follow these steps to contribute:

1. Fork the repository.
2. Create a new branch: git checkout -b my-feature-branch.
3. Make your changes and commit them: git commit -m 'Add some feature'.
4. Push to the branch: git push origin my-feature-branch.
5. Submit a pull request.