/Wingie2

Wingie2, a handheld stereo resonator that you can use as a development platform.

Primary LanguageC++GNU General Public License v3.0GPL-3.0

Wingie2

Wingie2 Front Small

如何建立编程环境(适用于想更改或编写固件的人,如果只想重刷固件请见右侧 Releases)

How to build programming environment (For those who want to modify or write their own firmware, if you just want to flash original firmware, see Releases on the right side)

编译过程 Compiling

安装 Faust 并将路径加入 PATH(osx)Install Faust and add it to PATH (osx)

在编写完 .dsp 文件之后,使用 faust2esp32 -ac101 -lib <Your File Name>.dsp 命令编译 Faust .dsp 文件,解压所生成的 zip 文件,并将内容移至你的 Arduino 代码文件夹下。可以通过建立批处理文档将此过程自动化,以节省时间。下面的例子是 OSX 上的做法。

To compile Faust .dsp file, use the command faust2esp32 -ac101 -lib <Your File Name>.dsp then unzip the generated file and put them into your Arduino sketch folder. You can also automate this process by creating a batch processing file. Following is an example for OSX.

#!/bin/bash
cd "$(dirname "$BASH_SOURCE")" || {
    echo Error getting script directory >&2
    exit 1
}

faust2esp32 -ac101 -lib <Your File Name>.dsp

unzip -o <Your File Name>.zip

mv -f ./<Your File Name>/*.* ./<Your Arduino Sketch Folder>

在 Windows 上,可创建相同功能的 .bat 文件。

A .bat file of identical functions can be created for Windows.

如何建立编程环境 How to build programming environment

中文

  1. 下载 Arduino https://www.arduino.cc/en/software

  2. 打开下列菜单,在“附加开发版管理器网址“中填入下面的链接 https://raw.githubusercontent.com/espressif/arduino-esp32/gh-pages/package_esp32_index.json

c1 c2

  1. 在 Arduino 软件中,打开菜单 工具-开发版-开发板管理器,搜索 ESP32 并安装。安装完毕之后选择 ESP32 Dev Module

c3 c4

  1. 将 “Libraries” 中的内容放到 文稿/Arduino/Libraries 下面

  2. 打开 Arduino 软件,点击菜单 项目->加载库->库管理器。搜索并安装 Francois Best 的 MIDI Library 和 Adafruit AW9523 库

c5 c6

  1. 打开 Wingie2.ino。选择端口(cu.usbserial-xxxxx 或者 cu.SLAB_USBtoUART)。点击菜单 工具->Upload Speed 改成 460800,点击上传

English

  1. Download Arduino https://www.arduino.cc/en/software

  2. Open the preferences and paste this web address in "Addtional Boards Manager URLs" https://raw.githubusercontent.com/espressif/arduino-esp32/gh-pages/package_esp32_index.json

c1 c2

  1. In Arduino software, open the menu Tools-Development Board-Board Manager, search for ESP32 and install (use version 2.0.4 -- this project does not work properly yet with version 2.0.5)

c3 c4

  1. Copy the files in the "Libraries" directory of the project to Documents/Arduino/Libraries

  2. Open Arduino software, click menu Sketch->Include Library->Manage Libraries. Install MIDI Library by Francois Best and Adafruit AW9523 Library

c5 c6

  1. Open Wingie2.ino. Choose port (on macOS, is should be named cu.usbserial-xxxxx or cu.SLAB_USBtoUART; on Windows, it will probably be named COMxxx). click menu Tools->Upload Speed, change it to 51200, hit upload

http://mengqimusic.com

Including a part of the I2C Device Library http://i2cdevlib.com/