OpenHW Studio Component Telemetry Reference

This document serves as the master reference for all component-level telemetry parameters exposed by the OpenHW Studio simulation engine. Each component reports its internal state, electrical properties, and custom metrics during high-frequency simulation loops, allowing the frontend console, logic analyzer, and delta-filtering engine to monitor hardware behavior with zero overhead.

---

🌐 Universal Telemetry (Available on ALL Boards & Components)

Because every simulation entity inherits from the master BaseComponent class, the following hardware-level parameters are automatically available across 100% of components and microcontroller boards. They can be selected in the Telemetry Selection Modal and monitored via O(1) Delta filtering:

Parameter Name	Description
pins	Tracks the live digital logic state (HIGH true / LOW false) of all active pins on the component or board.
pinToggles	Tracks the cumulative number of times each individual pin transitioned between HIGH and LOW during simulation.
analogVoltages	Tracks the live simulated analog voltage level (in Volts) across all active pins.
i2cTraffic	Contains the most recent 16 bytes transmitted or received by the component over the I2C bus.
spiTraffic	Contains the most recent 16 bytes transmitted or received by the component over the SPI bus.
serialBytes	Tracks the cumulative byte volume transmitted via hardware UART or SoftwareSerial.
pwmTraffic	Tracks the cumulative count of PWM pulses or duty cycle updates processed on the component pins.
oneWireTraffic	Tracks the cumulative count of 1-Wire protocol reset and bit-write transactions.
pioTraffic	Tracks the cumulative count of Programmable I/O (PIO) state machine pin transitions.
i2sTraffic	Tracks the cumulative count of I2S digital audio frames transmitted or received.

---

⚡ Microcontroller Boards

Microcontroller board components expose telemetry primarily for their onboard diagnostic LEDs, as well as optional Deep Silicon Debugging metrics (deepSiliconRegisters, deepSiliconSRAM, deepSiliconTimers, deepSiliconPower, deepSiliconInterrupts) when enabled via the F1 Quick Actions menu.

Component Name / Type	Telemetry Parameters	Description
openhw-arduino-uno wokwi-arduino-uno	leds (l, tx, rx, pwr) deepSiliconRegisters deepSiliconSRAM deepSiliconTimers deepSiliconPower deepSiliconInterrupts	Tracks onboard LEDs. When Deep Silicon Debugging is enabled, streams live CPU registers (PC, SP, SREG, cycles), 2,048 bytes of SRAM, hardware timers (TCNT0-2), WDT/sleep modes, and pending IRQs.
openhw-arduino-mega wokwi-arduino-mega	leds (l, tx, rx, pwr) deepSiliconRegisters deepSiliconSRAM deepSiliconTimers deepSiliconPower deepSiliconInterrupts	Tracks onboard LEDs, CPU registers, SRAM, hardware timers, power domains, and interrupts.
openhw-arduino-nano wokwi-arduino-nano	leds (l, tx, rx, pwr) deepSiliconRegisters deepSiliconSRAM deepSiliconTimers deepSiliconPower deepSiliconInterrupts	Tracks onboard LEDs, CPU registers, SRAM, hardware timers, power domains, and interrupts.
openhw-pico wokwi-pi-pico	led deepSiliconRegisters deepSiliconSRAM deepSiliconTimers deepSiliconPower deepSiliconInterrupts	Tracks GP25 LED. When Deep Silicon Debugging is enabled, streams ARM core registers, SRAM snapshots, 64-bit microsecond timer, clock domains, and NVIC IRQs.
openhw-pico-w wokwi-pi-pico-w	led deepSiliconRegisters deepSiliconSRAM deepSiliconTimers deepSiliconPower deepSiliconInterrupts	Tracks CYW43 LED, ARM core registers, SRAM snapshots, microsecond timer, clock domains, and NVIC IRQs.
openhw-attiny85 wokwi-attiny85	pins deepSiliconRegisters deepSiliconSRAM deepSiliconTimers deepSiliconPower deepSiliconInterrupts	Tracks active pin states, CPU registers, SRAM snapshots, timers, power domains, and interrupts.

🔬 Deep Silicon Debugging & Modal Filtering

When Deep Silicon Debugging is toggled ON in the F1 menu, the simulation runner extracts internal silicon state and attaches it to the board's telemetry tree under entry.details.deepSilicon.

To give you complete bandwidth control, you can filter this data using the Select Telemetry Components modal:

• deepSiliconRegisters: Streams lightweight CPU Core & Execution State (PC, SP, SREG, cycles).
• deepSiliconSRAM: Streams the full 2,048-byte memory map. If unchecked, the runner skips memory slicing entirely, saving massive Web Worker bandwidth!
• deepSiliconTimers: Streams Internal Hardware Timers & Prescalers (TCNT0, TCNT1, TCNT2, or RP2040 64-bit time).
• deepSiliconPower: Streams Power Domains & Watchdog Timer status (WDT enable/timeout, sleepMode).
• deepSiliconInterrupts: Streams Interrupt Controller status (Global SREG.I enable flag and pending IRQ vectors).

---

💡 Displays & Visual Indicators

Component Name / Type	Telemetry Parameters	Description
openhw-led wokwi-led	illuminated, brightness, color, burnedOut, glow, voltageDrop, current	Tracks illumination status, PWM brightness, forward voltage drop, current draw in mA, and overcurrent burnout faults.
openhw-rgb-led wokwi-rgb-led	color, r, g, b, voltageDrop	Tracks individual Red, Green, and Blue channel intensities and composite hex color representation.
openhw-ssd1306-oled wokwi-ssd1306	vram, invert, allOn, displayOn, displayStartLine, segmentRemap, comScanDir, displayOffset, vramDirty, updateCount, powerStatus, displayMode, contrast, vramFillPercentage, addressingMode	Comprehensive OLED telemetry tracking the 1024-byte VRAM buffer, active addressing modes (Page/Horiz/Vert), hardware contrast, inversion state, and active pixel fill percentage.
openhw-max7219 wokwi-max7219-matrix	intensity, scanLimit, shutdown, decodeMode, updateCount	Tracks the MAX7219 SPI display driver state, including brightness intensity (0-15), active scan limit, shutdown mode status, and BCD decode mode configuration.
openhw-lcd1602 wokwi-lcd1602	cursorX, cursorY, backlight, lines, illuminated	Tracks the 16x2 character display buffer (lines), current cursor coordinates, and backlight illumination status.
openhw-lcd1602-i2c openhw-lcd2004-i2c	lines, illuminated, backlight	Tracks the I2C-expanded character display buffer (lines) and backlight relay state.
openhw-ili9341 wokwi-ili9341	powerOn, t	Tracks the TFT display power state and frame update timestamps.
openhw-nokia-5110 wokwi-nokia-5110	fbStr	Tracks the serialized PCD8544 monochrome framebuffer string representation.
openhw-7segment wokwi-7segment	a, b, c, d, e, f, g, dp	Tracks the individual active logic states of all 7 display segments plus the decimal point.
openhw-tm1637-7segment wokwi-tm1637-7segment	display, colon, brightness, on	Tracks the 4-digit character buffer (display), center colon indicator, brightness level (0-7), and power state.
openhw-neopixel-matrix wokwi-neopixel-matrix	pixels, brightness, count	Tracks the RGB color array buffer (pixels) for the entire LED matrix, global brightness, and total pixel count.
openhw-neopixel-ring wokwi-neopixel-ring	pixels, brightness, count	Tracks the RGB color array buffer (pixels) for the circular Neopixel ring.
openhw-ws2812b wokwi-ws2812b	pixels, brightness, count	Tracks the RGB color array buffer (pixels) for addressable LED strips.

---

🎛️ Actuators, Motors & Audio

Component Name / Type	Telemetry Parameters	Description
openhw-servo wokwi-servo	angle, pulseWidthMs, speed, moving	Tracks the physical servo horn angle (0-180°), incoming PWM pulse width in milliseconds, rotational speed, and active motion state.
openhw-motor wokwi-motor	speed	Tracks the DC motor rotational speed resulting from applied voltage/PWM.
openhw-stepper-motor wokwi-stepper-motor	angle	Tracks the precise rotational angle of the bipolar stepper motor shaft.
openhw-a4988 wokwi-a4988	active, stepCount	Tracks the A4988 stepper driver active enable state and accumulated step pulses.
openhw-buzzer wokwi-buzzer	playing, isBuzzing, frequency, volume, muted	Tracks active piezo buzzer tone generation, output frequency in Hz, volume, and mute status.
openhw-pcm5102 openhw-max98357	lastLeftSample, lastRightSample, peakAmplitude	Tracks I2S decoded PCM samples and the visual peak amplitude.
openhw-inmp441 openhw-sph0645	peakAmplitude, liveMicEnabled, bufferIndex	Tracks the live Web Audio microphone status and captured amplitude levels.
openhw-5w-speaker	audioChunk	Tracks the Web Audio PCM chunks streamed from a connected DAC or amplifier.
openhw-relay-module wokwi-relay	active	Tracks the electromechanical relay coil state (energized/active vs de-energized).
openhw-motor-driver openhw-l293d	active	Tracks the dual H-bridge motor driver enable and channel switching states.

---

🎚️ Inputs & Interactive Controls

Component Name / Type	Telemetry Parameters	Description
openhw-pushbutton wokwi-pushbutton	pressed, bounceCount, voltage	Tracks the physical button press state, mechanical contact bounce counter, and output pin voltage.
openhw-resistor wokwi-resistor	resistance, voltageDrop, current, powerDissipation	Tracks nominal resistance in Ohms, forward voltage drop, current draw, and power dissipation in Watts.
openhw-potentiometer wokwi-potentiometer	angle, value, voltageOut	Tracks rotary knob wiper angle, normalized percentage value (0-100), and divided output voltage.
openhw-slide-potentiometer wokwi-slide-potentiometer	value, voltageOut	Tracks linear slider wiper position (0-100) and divided output voltage.
openhw-rotary-encoder wokwi-ky-040	rot, sw	Tracks accumulated rotary encoder detent steps (rot) and the integrated pushbutton switch state (sw).
openhw-membrane-keypad wokwi-membrane-keypad	pressedKey, rows, cols	Tracks the active matrix row/col scanning lines and the currently depressed character key.
openhw-analog-joystick wokwi-analog-joystick	x, y, pressed	Tracks dual-axis potentiometer positions (x, y from 0.0 to 1.0) and the integrated Z-axis pushbutton.
openhw-dip-switch-8 wokwi-dip-switch-8	switches, values	Tracks the individual binary states of all 8 slide switches in the DIP package.

---

📡 Sensors & Advanced Peripherals

Component Name / Type	Telemetry Parameters	Description
openhw-mpu6050 wokwi-mpu6050	ax, ay, az, gx, gy, gz, temp	Tracks 3-axis accelerometer values (ax, ay, az in g), 3-axis gyroscope angular velocities (gx, gy, gz in °/s), and internal die temperature.
openhw-ds1307-rtc wokwi-ds1307	running, time	Tracks the I(2)C Real-Time Clock oscillator status (running) and current simulated ISO timestamp.
openhw-bmp180 wokwi-bmp180	temp, pressure, altitude	Tracks barometric pressure in Pascals, ambient temperature in °C, and calculated altitude in meters.
openhw-dht22 wokwi-dht22	temperature, humidity, lastReadMs, error	Tracks relative humidity (%), temperature (°C), last sensor polling timestamp, and protocol checksum errors.
max30102 wokwi-max30102	ir, red, temp, active	Tracks optical photoplethysmography IR and Red LED reflectance ADC counts, die temperature, and active status.
openhw-hc-sr04 wokwi-hc-sr04	distance, echoTimeMs	Tracks the simulated obstacle distance in centimeters and the resulting ultrasonic echo pulse duration.
openhw-pir-motion-sensor wokwi-pir-motion-sensor	motion, triggerCount	Tracks active passive infrared motion detection latching and cumulative trigger events.
openhw-photoresistor wokwi-photoresistor-sensor	lux, resistance, voltage	Tracks simulated ambient illuminance in Lux, resulting LDR resistance, and voltage divider output.
openhw-photodiode wokwi-photodiode	light	Tracks incident light level falling on the photodiode junction.
openhw-ldr-module wokwi-ldr-module	light, threshold, dOut	Tracks analog light level, onboard comparator potentiometer threshold, and the resulting digital output pin state (dOut).
openhw-soil-moisture-sensor wokwi-soil-moisture-sensor	moisture	Tracks simulated volumetric water content percentage (0-100%).
openhw-ntc-thermistor wokwi-ntc-temperature-sensor	temperature, resistance, voltage	Tracks simulated temperature in °C, NTC thermistor resistance, and analog voltage output.
openhw-sd-card wokwi-sd-card	cardInserted, status	Tracks SPI SD card insertion state, initialization status, and active SPI command responses.
openhw-ds18b20 wokwi-ds18b20	temperature, powered, resolution	Tracks 1-Wire temperature in °C, power connection status, and configured ADC bit resolution.
openhw-ir-receiver wokwi-ir-receiver	protocol, lastCode, demodulatedSignal, powered	Tracks decoded IR protocol name, last received hex command code, live demodulated pin state, and power status.
openhw-mfrc522 wokwi-mfrc522	powered, cardPresent, cardUID	Tracks 3.3V power connection status, RFID card presence latching, and active 4-byte card UID string.
openhw-nrf24l01	power, mode, frequency, rxQueueSize, txQueueSize, statusReg	Tracks transceiver power state, TX/RX mode, active frequency, queue sizes, and internal status register.
openhw-cc1101	state, frequency, modulation, rxQueueSize, txFifoSize, interruptPin	Tracks state machine state, frequency, modulation format, FIFO buffer sizes, and the interrupt pin state.

---

🧮 Logic Gates & Integrated Circuits

Component Name / Type	Telemetry Parameters	Description
shift_register openhw-nlsf595 wokwi-74hc595	latch, clock, data, oe, pins, r, g, b	Tracks shift register control lines (ST_CP, SH_CP, DS, OE), parallel output pin states (pins), and RGB channel mappings.
openhw-cd74hc4067 wokwi-cd74hc4067	activeChannel	Tracks the currently selected analog/digital multiplexer channel (0-15) based on the 4 address select lines.
logic-mux-2to1	d0High, d1High, selHigh, outputHigh	Tracks the logic states of input D0, input D1, the Select line, and the resulting multiplexed output.
logic-d-flipflop	d, clk, q, qbar	Tracks Data input, Clock input, output Q, and inverted output Q-bar.
logic-d-flipflop-r	d, clk, r, q, qbar	Tracks Data, Clock, asynchronous Reset, output Q, and inverted output Q-bar.
logic-d-flipflop-dsr	d, clk, s, r, q, qbar	Tracks Data, Clock, asynchronous Set, asynchronous Reset, output Q, and inverted output Q-bar.
logic-clock-generator	out	Tracks the oscillating digital output square wave state.
logic-ic-74xx	icType, outputs	Tracks the specific 74-series TTL logic IC model (e.g., 7408, 7400, 7432) and the logic states of all output pins.

---

🔋 Power, Wiring & Diagnostics

Component Name / Type	Telemetry Parameters	Description
openhw-battery wokwi-battery	voltage, capacity	Tracks battery terminal voltage and remaining charge capacity percentage.
openhw-charger wokwi-tp4056	charging, charged	Tracks TP4056 LiPo charging status indicator LEDs (Charging vs Fully Charged).
openhw-power-supply wokwi-power-supply	voltage, current	Tracks regulated output voltage and current draw.
openhw-logic-analyzer wokwi-logic-analyzer	active	Tracks whether the virtual logic analyzer is actively sampling digital channels.
openhw-simulation-monitor	simulationSpeed, timeDriftMs, executionJitterMs, frameSkips, workerBufferLatency, workerCpuLoadPercentage, telemetrySerializationTimeMs, telemetryPayloadBytes, canvasFps, uiMainThreadBlockedTimeMs, workerMessageQueueLagMs	Advanced real-time simulation health diagnostic instrument. Tracks Web Worker CPU load, execution jitter, time drift, frame skips, serialization latency, and telemetry packet bandwidth.
openhw-diode openhw-npn-transistor	[] (Stateless)	Purely electrical components; nodal voltages/currents are tracked via universal Nodal Analysis telemetry rather than explicit component state.
openhw-breadboard openhw-breadboard-half openhw-breadboard-mini	[] (Stateless)	Passive wiring distribution boards; electrical connectivity is managed by the simulation netlist topology.