From db0d17f8c5214fe7bbd7112e463c3e4ee0a2a711 Mon Sep 17 00:00:00 2001 From: Sam Neurohack Date: Fri, 8 Jan 2021 23:35:08 +0100 Subject: [PATCH] Better readme --- README.md | 32 +++++++++++++++++++++++--------- 1 file changed, 23 insertions(+), 9 deletions(-) diff --git a/README.md b/README.md index ae57be6..f492682 100644 --- a/README.md +++ b/README.md @@ -1,20 +1,34 @@ -midiOSCesp -v0.1 - +midiOSCesp v0.1 By Sam Neurohack -ESP operations in micropython, we use : -ESP 8266 from https://www.wemos.cc/en/latest/d1/d1_mini_lite.html +Forward incoming midi messages as OSC message (UDP) to micropython host to trigger hardware event. In example : noteon, noteoff lights on/off some leds connected to an ESP 8266. -Micropython firmware (select v1.13 with the right RAM amount): https://micropython.org/download/esp8266/ +Remember to edit netconf.py for network/OSC configuration. +Connect the led strip data line to D5 (GPIO 14) -Flash firmware, upload python files, run files,... thonny IDE : https://thonny.org/ +* Computer side : List and hook to all midi devices (real or virtual). OSC commands generated from incoming midi messages : + - /noteon MidiChannel, note, velocity + - /noteoff MidiChannel, note + - /rawcc MidiChannel, CCnumber, CCvalue + - /clock + - /start + - /stop + +* Micropython/ESP side : + + - interpret /noteon and /noteoff and switch one led in a led strip. Changing or adding functions to clock or other midi msg is easy, look lserver.py. Look midix.py to get extensive list of transmitted midi messages. + + - ESP 8266 from https://www.wemos.cc/en/latest/d1/d1_mini_lite.html + + - Micropython firmware (select v1.13 with the right RAM amount): https://micropython.org/download/esp8266/ + + - Flash firmware, upload python files, run files,... thonny IDE : https://thonny.org/ + + - Great tutorials : https://randomnerdtutorials.com/getting-started-thonny-micropython-python-ide-esp32-esp8266/ -Great tutorials : https://randomnerdtutorials.com/getting-started-thonny-micropython-python-ide-esp32-esp8266/ -Connect the led strip to D5 (GPIO 14) More soon... \ No newline at end of file