From I-CubeX Wiki
Jump to: navigation, search

WiConnect manages the USB, BLE-MIDI or WiFi-OSC/WS communications of the WiDig. It runs on the WiDig together with its other firmware.

Use Connect (v1.6.4 or higher for MacOS, v1.54 or higher for Windows) to find out which version of WiConnect is running on the WiDig. Click on the text "Firmware" (not the firmware number) in the upper left corner of Connect to switch to displaying the WiConnect version information. Click again, now on the text "WiConnect", to switch back to the firmware information.

WiConnect can be uploaded using DoayeeESP32DFU for MacOS (High Sierra or higher) or Windows. Switch between WiConnect versions as needed.

To upload one of WiConnect versions listed below, execute the following steps (do not click the "Erase ESP" button):

  1. In Connect, verify that the firmware version matches the one required as per the information in the Releases section below.
    If not, update the firmware by clicking "Check firmware" in Connect for MacOS, or on Windows by running FirmwareX.
  2. Click the link below under Releases, of the WiConnect version you want to upload to the WiDig, to download it to your computer.
  3. Click "Remove" in the digitizer view of the WiDig entry in Connect.
    Make sure no other software is using the serial port of the WiDig.
  4. Open DoayeeESP32DFU.
    On MacOS you may need to right-click (or click-while-holding-down-the-control-key) the app to open it. See below under Known Issues.
  5. Select the Serial Port (contains the text "SLAB" on MacOS and "COM" on Windows) from the pull-down menu.
  6. Set the Baud Rate to 926100 if it isn't already.
  7. Click the Browse button in the "Flash App .." row to select the WiConnect file from your computer.
  8. Click "Flash".
  9. When the text "Hard Resetting via RTS pin" appears in the terminal window the upload is completed.
  10. Click "Refresh Devices" from the pull-down menu in Connect for MacOS or "Refresh" in the digitizer view of Connect for Windows to start using the WiDig.

When switching between different versions of WiConnect for WiFi, you may need to clear the cache of your browser to ensure that server-side code is loaded properly.

Once WiConnect is uploaded, refer to the quickstart page for WiFi or BLE to operate and configure the WiDig.

DoayeeESP32DFU macos.png



  • 13 Nov 2023: WiConnect 2.015 WiFi-OSC/WS with OSC control, WiFi auto-reconnect, USB pass-thru and LED control (requires firmware 8.306 or higher and internet access)
  • 13 Apr 2023: WiConnect 1.924 WiFi-OSC/WS with USB pass-thru and LED control (pre-release version, requires firmware 8.20 or higher and internet access)


Known Issues

  • WiConnect 2.014: At 2 ms sampling interval in host mode, data loss occurs resulting in MIDI protocol errors. Turning off OSC communication resolves this. In host mode the parameters are separated by commas in OSC messages. WiConnect 2.015 changes this to underscores.
  • WiConnect 2.013: Clearing the WiDig's standalone mode configuration via Connect will not reset all actuator output settings. When switching between host and standalone mode in Connect some settings are not set to default or restored correctly. Wi-Connect 2.014 solves this.
  • WiConnect 2.012 and lower: The actuators page doesn't update values correctly. WiConnect 2.013 resolves this.
  • WiConnect 2.000: When using sampling intervals around 10 ms and lower, while communication via USB works fine, data may not transmit reliably via WiFi (using OSC or WS) or the WiDig may not respond correctly to the web UI or the Connect UI. WiConnect 2.014 significantly improves on this issue.
  • WiConnect 1.000 - 1.203: After disconnecting BLE the WiDig cannot be re-connected via BLE. Re-plugging power or pressing the button on the top of the WiDig should resolve this. This issue is fixed as of WiConnect 1.204.
  • WiConnect 1.000 - 1.104: The BLE-MIDI name may be "WDxxx" instead of eg. "WD123", where 123 would be the last 3 digits of the serial number. Pressing the button on the top of the WiDig should resolve this. This issue is fixed as of WiConnect 1.203.
  • DoayeeESP32DFU: If on MacOS you get a warning from Apple's GateKeeper that it can't run and should be moved to the trash then the easiest way around this is to right-click (or click-while-holding-down-the-control-key) the app. This will give you the option to open the app. DoayeeESP32DFU works on MacOS High Sierra or higher on Intel or M1 hardware, or on Windows.