Skip to main content
The generator needs a sketch flashed once. It receives the signal you have open in the editor and plays it on its outputs.
It does not connect to the internet, to a cloud, or to any server: the link is always point to point, over the USB cable or your WiFi.
There are two different firmwares. This is the app link one (USB / WiFi); the other is the microSD player. Each board holds one at a time: a board running the microSD one does not appear in Connect device until you flash this one, and the other way round. In the app, the question mark next to each guide’s title is a reminder.

What you need

Flashing it

1

Install the core

Arduino IDE → Boards Manager → esp32 by Espressif Systems.
2

Pick the board

ESP32 Dev Module, or ESP32S3 Dev Module with USB CDC On Boot: Enabled (Tools menu), and the port it is plugged into.
3

Upload the sketch

Open oryx_signal_esp32.ino and upload. It needs no external libraries.
4

Close the serial monitor

Before connecting from the app: while it is open, the port is taken.
The serial monitor (921 600 baud) shows a greeting at boot.
Without the Arduino IDE: in the app, in Connect device, the code icon next to the title opens the firmware guide; there, Flash from the browser → Flash. Plug the board in over USB, pick its port and the browser writes the latest published version (Chrome, Edge or Opera). It tells an ESP32 from an ESP32-S3 on its own and flashes the build for that chip. The WiFi network saved on the device is kept.The same guide has the Arduino IDE steps and the code, read from GitHub every time it opens, with a button to copy it.

Reception

RX channels need the link firmware with reception: the device turns those pins into inputs, stamps every edge with its time and sends the app what arrived on each lap. Analog RX channels are measured with the ADC on GPIO 34, 35, 32 and 33 (classic ESP32). With an older firmware, a signal with RX channels is not sent (the app says so). See Reception.

Outputs

One pin per channel, in editor order. Once connected, the app panel shows which GPIO each channel comes out of.
The device takes the 16 digital channels you can design in Oryx, but only the first 8 have a pin. Channels 9 to 16 arrive with the signal and the firmware keeps them: in the sketch, canalesExtra holds their value at every moment (bit 0 = channel 9) and the empty escribirCanalesExtra function is called on every change, ready for your code to send them wherever you need (an I2C expander, a 74HC595, another board). In the app they show as No pin.
The ESP32-S3 has no DAC, so it does not output analog signals: outputting them needs a classic ESP32. It does measure analog RX channels, on GPIO 1, 2, 8 and 9 (see Reception).

Voltage

The voltage (0 to 99.99 V) is only received and kept: the device does not use it. Digital outputs always swing to 3.3 V and analog ones use the full DAC range (0 to 3.3 V). In the sketch it sits in the mv variable, in millivolts, for whoever wants to put it to use in their own circuit (a power stage, an external DAC, whatever it takes).

Device limits

If your signal does not fit, the app tells you before sending it and explains what was adjusted.

Speed

In the app it is a single box with the unit to pick: µs/step, RPM, bps or Hz (see Connect the device). It reaches the device in two ways:
  • µs/step, bps and Hz arrive as a step time (SET T), with decimals.
  • RPM arrives as RPM (SET R). One full pass of the signal is one engine revolution:
The step time is used with its decimals, not rounded to the microsecond, so the real speed is the one you asked for. With RPM, if another signal with a different length arrives, the device works the step time out again by itself. Changing the speed adjusts playback immediately, like an engine: the pass carries on from where it was, without going back to the start or cutting a pulse. The lap counter is not zeroed: that is what Restart is for.

When the signal stops on its own

If the cable comes loose or you close the tab, the signal stops and the outputs go low. It is on purpose: the device cannot find out that nobody is on the other end, so if it goes a while without receiving orders it treats the link as finished.