Skip to content

Turning an ESP32 DevKit into an OSC client for wireless interaction processing.

License

Notifications You must be signed in to change notification settings

ElTrasho3000/OSC32

Folders and files

NameName
Last commit message
Last commit date

Latest commit

 

History

9 Commits
 
 
 
 
 
 
 
 
 
 

Repository files navigation

OSC32 – Wireless interaction processing

Software V0.1

Hardware ESP32-DevKit ESP32-SOC

Introduction

The OSC32-Project aims to serve an easy to use device for wireless interaction processing. Whether you use it for live visuals or interactive installations, the setup is supposed to be dead simple.

OSC32 – in its current version – makes use of the OpenSoundControl-protocol to transmit values of analogue inputs (e.g. a potentiometer, a button, a temperature sensor, etc.) from the point they are obtained to a host.

Typically the host is a computer on which the values are used to trigger a variety of events. A popular use case is the combination with mapping software like MadMapper.

The project is maintained by IotSteve and ElTrasho3000.

Usage

Prerequisities

Installation

  • Either download or clone this repository
  • Open the PlatformIO-Project inside the repository in VSCode
  • Navigate to PlatformIO in primary side bar
  • Connect your ESP32 Dev Board
    (Currently only tested on Dev Kit C V2 with EPS32-WROOM-32)
  • Under "Project Tasks" go to "Platform -> Build Filesystem Image"
    Build
  • When it's done, go to "Upload Filesystem Image"
    Upload
  • Then Build(Ctrl+Alt+B) and Upload(Ctrl+Alt+U)
  • Once the upload is succesfully finished, the device is ready to use

Setup

Hardware

  • We will offer a breakout board in the future
  • We recommend using a breadboard to make wiring easier
  • To enable setup-mode connect GPIO-14 to 3v3 and re-/start device
    (The pin is set to INPUT_PULLDOWN, using a switch to
    connect to 3v3 is recommended for long-term usage)
  • RGB-LED red is GPIO-25
  • RGB-LED green is GPIO-26
  • RGB-LED blue is GPIO-27
  • Analog input 1 is GPIO-34
  • Analog input 2 is GPIO-35
  • Analog input 3 is GPIO-32
  • Analog input 4 is GPIO-33

Software

In setup mode:

  • The LED lights up red
  • Connect to the WiFi Access Point named "OSC-Setup-Terminal-[device ID]"
  • Open a browser and go to "192.168.4.1"(The default ESP32-IP)
  • You will reach the Network Setup page
    NetSet
  • Enter your desired configuration and press "Submit"
  • You should be redirected to success page
    NetSetSuccess
  • Restart the device



In operation mode:

  • While the LED is blinking green, the devices tries to connect to
    WiFi, using the configuration entered in setup mode
  • The LED starts blinking blue when WiFi connection is etablished
    and the device is ready
  • Connect to the WiFi you will be working in
  • Open a browser and got to the IP you declared in the setup as "ESP IP"
  • You will reach the OSC-Terminal
    OSCsetings
  • Enter your desired configuration and press "Send settings"
  • You should be redirected to success page
    OSCrunning
  • As long as the OSC-service is running, the LED lights up blue
  • If you want to change settings, press "Reset"

About

Turning an ESP32 DevKit into an OSC client for wireless interaction processing.

Topics

Resources

License

Stars

Watchers

Forks

Releases

No releases published

Packages

No packages published