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.
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.
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 themv 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: