Standard Library

Import hardwave.stdlib to register all standard-library types and components with the global registries. You do not need to import submodules individually.

import hardwave
import hardwave.stdlib

from hardwave.types import TypeRegistry
from hardwave.components import ComponentRegistry

# List all registered types
for t in TypeRegistry.instance().list_types():
    print(f"{t.name:25s} {t.unit}")

# List all component categories
print(ComponentRegistry.instance().list_categories())

Signal types (30)

Electrical

Name	Unit	Description
`DCVoltage`	V	DC electrical potential
`ACVoltage`	V_rms	AC RMS voltage
`Current`	A	Electrical current
`Resistance`	Ω	Electrical resistance
`Capacitance`	F	Capacitance
`Inductance`	H	Inductance
`Power`	W	Electrical power
`Frequency`	Hz	Signal frequency
`AnalogSignal`	V	Generic analog 0-5V
`PWMSignal`	-	dict `{frequency_hz, duty_cycle}`
`DigitalSignal`	-	0 or 1
`I2CBus`	-	dict `{sda, scl, address, data}`
`SPIBus`	-	dict `{mosi, miso, sclk, cs}`
`UARTStream`	-	dict `{baud_rate, data}`

Mechanical

Name	Unit
`Torque`	N·m
`AngularVelocity`	rad/s
`AngularPosition`	rad
`LinearForce`	N
`LinearVelocity`	m/s
`LinearPosition`	m
`Pressure`	Pa
`MechanicalPower`	W

Thermal

Name	Unit
`Temperature`	°C
`HeatFlux`	W/m²
`ThermalResistance`	°C/W

Control and data

Name	Unit
`ControlSignal`	- (0.0-1.0)
`BooleanSignal`	-
`Timestamp`	s
`ByteArray`	-
`JSONPayload`	-

Components (28)

Electrical / Passive

Component	Key Ports	Solver
`Resistor`	voltage → current, power	Formula (Ohm’s Law)
`Capacitor`	current → voltage, stored_energy	ODE (dV/dt = I/C)
`Inductor`	voltage → current, stored_energy	ODE (dI/dt = V/L)
`Diode`	anode_voltage, cathode_voltage → current, power_loss	Formula (Shockley)
`VoltageSource`	set_voltage → voltage_out	Formula
`CurrentSource`	set_current → current_out	Formula
`Ground`	- → voltage (0V)	Formula

Import from hardwave.stdlib.components.passive.

Electrical / Active

Component	Key Ports	Solver
`NPNTransistor`	base_current, vce → collector_current, power	Formula (piecewise)
`NMOSFET`	gate_voltage, vds → drain_current, power	Formula (square-law)
`OpAmp`	v_plus, v_minus, supply → v_out	Formula (ideal, rail-clamped)
`VoltageRegulator`	v_in, load_current → v_out, power_loss	Formula

Import from hardwave.stdlib.components.active.

Electromechanical

Component	Key Ports	Solver
`DCMotor`	voltage, load_torque → angular_velocity, current, winding_temp, health, fault_code	ODE (coupled E-M-T; thermal fault rules)
`StepperMotor`	step_pulses, load_torque → angular_position, current	Discrete
`ServoMotor`	pwm_signal, load_torque → angular_position, current	Discrete
`BrushlessMotor`	phase_voltages, load_torque → angular_velocity, phase_currents	ODE
`LinearActuator`	pwm_signal, load_force → linear_position, current	ODE

Import from hardwave.stdlib.components.motors.

Sensors

Component	Key Ports	Solver
`TemperatureSensor`	ambient_temperature → analog_out	Formula + Gaussian noise
`IMU`	linear_acceleration, angular_velocity → i2c_out	Formula
`Encoder`	angular_position → pulse_count, angular_velocity	Formula
`UltrasonicSensor`	target_distance → pulse_out	Formula + noise + latency
`Camera`	scene_description → image_frame	Placeholder (V2)

Import from hardwave.stdlib.components.sensors.

Microcontrollers

Component	Key Ports	Solver
`Arduino`	gpio_inputs → gpio_outputs, uart	Firmware callable (signal-level)
`ESP32`	gpio_inputs, wifi_rx → gpio_outputs, wifi_tx, uart	Firmware callable
`RaspberryPi`	gpio_inputs → gpio_outputs, uart, i2c, spi	Firmware callable

Import from hardwave.stdlib.components.mcu.

MCU firmware is modelled at the signal level: what values appear on pins at each time step. Pass a Python callable as the firmware parameter to drive GPIO outputs. Actual code execution is a V2 feature.

Power

Component	Key Ports	Solver
`LiPoCell`	charge_current, discharge_current → terminal_voltage, soc, temperature, health, fault_code	ODE (SOC/thermal; over-discharge & thermal damage faults)
`BatteryPack`	charge_current, discharge_current → terminal_voltage, capacity_ah	Composite
`BuckConverter`	v_in, duty_cycle, load_current → v_out, efficiency	Formula
`BoostConverter`	v_in, duty_cycle, load_current → v_out, efficiency	Formula

Import from hardwave.stdlib.components.power.

DCMotor and LiPoCell include runtime fault detection. See Component Faults and Health for fault codes, rated-limit parameters, and degraded output behaviour.

Using stdlib components

from hardwave.simulation import SimulationGraph, SimulationEngine
from hardwave.stdlib.components.passive import VoltageSource, Resistor

graph = SimulationGraph()
graph.add_component(VoltageSource("vs", param_values={"voltage": 9.0}))
graph.add_component(Resistor("r1", param_values={"resistance": 1_000.0}))
graph.connect("vs", "voltage_out", "r1", "voltage")

result = SimulationEngine(graph).run(inputs={})
print(result.get_output("r1", "current"))

For high-fidelity models beyond the open-source library, see Premium Components.

Getting Started

Guides

Simulation

Reference

Signal types (30)

Electrical

Mechanical

Thermal

Control and data

Components (28)

Electrical / Passive

Electrical / Active

Electromechanical

Sensors

Microcontrollers

Power

Using stdlib components

​Signal types (30)

​Electrical

​Mechanical

​Thermal

​Control and data

​Components (28)

​Electrical / Passive

​Electrical / Active

​Electromechanical

​Sensors

​Microcontrollers

​Power

​Using stdlib components

Signal types (30)

Electrical

Mechanical

Thermal

Control and data

Components (28)

Electrical / Passive

Electrical / Active

Electromechanical

Sensors

Microcontrollers

Power

Using stdlib components