Software-Defined Hardware

import { createSimBoard } from '@typecad/simulator';

const board = createSimBoard({
  boardType: 'arduino-uno',
  digitalPinCount: 14,
  analogPinCount: 6,
  i2cBusCount: 1,
  spiBusCount: 1,
  uartCount: 1,
});

const led = board.digital(13);       // SimDigitalPin
const sensor = board.analog(0);      // SimAnalogPin (A0)
const motor = board.pwm(9);          // SimPWMPin
const intPin = board.interrupt(2);   // SimInterruptPin
const serial = board.serial(0);      // SimSerialPort
const i2c = board.i2c(0);            // SimI2CBus
const spi = board.spi(0);            // SimSPIBus

board.digitalPins   // ReadonlyMap<number, SimDigitalPin>
board.analogPins    // ReadonlyMap<number, SimAnalogPin>
board.pwmPins       // ReadonlyMap<number, SimPWMPin>
board.interruptPins // ReadonlyMap<number, SimInterruptPin>
board.serialPorts   // ReadonlyMap<number, SimSerialPort>
board.i2cBuses      // ReadonlyMap<number, SimI2CBus>
board.spiBuses      // ReadonlyMap<number, SimSPIBus>

board.reset();  // Reset every pin, port, and bus to initial state

import { ArduinoUno } from '@typecad/board-arduino-uno';
import { createBoardFromDefinition } from '@typecad/simulator';

const board = createBoardFromDefinition(ArduinoUno);

// The pin layout matches the real Uno:
board.digital(13).asOutput().high();   // LED on PB5 (pin 13)
board.pwm(9).pwm(50);                  // PWM on PB1 (pin 9)
board.analog(0).injectVoltage(2.5);    // A0, 10-bit ADC, 5V reference

// Buses match the board's peripheral count:
board.serial(0).begin(9600);
board.i2c(0).attachDevice(0x76, mockSensor);

const pin = board.digital(13);

pin.asOutput(1);      // OUTPUT mode, initial HIGH
pin.asInput();        // INPUT mode
pin.asInputPullUp();  // INPUT_PULLUP mode, value driven to 1

pin.write(1);         // Drive HIGH
pin.write(0);         // Drive LOW
pin.high();           // Drive HIGH
pin.low();            // Drive LOW
pin.toggle();         // Flip current value

pin.read();           // → true (HIGH) or false (LOW)
pin.isHigh();         // → boolean
pin.isLow();          // → boolean
pin.getBitValue();    // → 0 or 1 (plain number)

pin.injectValue(1);   // Simulate an external HIGH signal
pin.injectValue(0);   // Simulate an external LOW signal

pin.high();
pin.low();
pin.high();

const history = pin.getHistory();
// [{ from: 0, to: 1, timestamp: ... }, { from: 1, to: 0, ... }, { from: 0, to: 1, ... }]

pin.clearHistory();   // Clear the history

pin.pulse(100);       // Toggle twice (simulates a pulse; duration not awaited)
pin.tone(440);        // Returns a no-op tone attachment
pin.noTone();         // No-op

const a0 = board.analog(0);

a0.injectValue(512);          // Simulate sensor reading of 512
console.log(a0.readAnalog()); // → 512
console.log(a0.readVoltage()); // → ~2.5 (based on 5V reference)

a0.injectVoltage(2.5);        // → readAnalog() ≈ 512 on a 10-bit / 5V ADC
a0.setResolution(12);         // Change ADC resolution (default 10-bit)
a0.setAnalogReference(3.3);   // Change reference voltage (default 5.0V)

const motor = board.pwm(9).asOutput();

motor.pwm(50);                  // 50% duty cycle
console.log(motor.getPwmPercent()); // → 50

// Writing a raw value > 1 is treated as an analog/PWM value and scaled
motor.write(128);               // ~50% on an 8-bit (0-255) resolution
console.log(motor.getPwmPercent()); // → ~50

motor.pwm(0);                   // 0% deactivates PWM
console.log(motor.isPwmActive()); // → false

const intPin = board.interrupt(2);

let edges = 0;
intPin.onRising(() => { edges++; });

// Fire an explicit interrupt edge
intPin.fireInterrupt('rising', 1);
console.log(edges); // → 1

// Or simulate a full 0→1 / 1→0 transition, which fires the matching edge
intPin.simulateTransition(0, 1); // fires onRising (and onChange if set)
intPin.simulateTransition(1, 0); // fires onFalling (and onChange if set)

const serial = board.serial(0);
serial.begin(9600);
serial.print("Hello ");
serial.println("World");

// Inspect what firmware wrote
const text = serial.peekTxAsString();     // → "Hello World\r\n" (doesn't clear)
const output = serial.flushTx();          // → [72, 101, 108, ...] (clears buffer)

// Simulate receiving data from another device
serial.injectRx("OK\r\n");

// Firmware can now read it
console.log(serial.available());  // → 4
console.log(serial.readLine());   // → "OK" (trailing \r\n stripped)

import { createSimBoard } from '@typecad/simulator';
import { describe, done } from '@typecad/expect';

const board = createSimBoard({ boardType: 'arduino-uno' });
const led = board.digital(13);

let toggleCount = 0;
// Track state changes
led.asOutput(0);
for (let i = 0; i < 10; i++) {
  led.toggle();
}
const history = led.getHistory();

describe('Blink')
  .it('toggles 10 times')
    .expect(history.length).toBe(10)
  .it('alternates HIGH and LOW')
    .expect(history[0].to).toBe(1)
    .expect(history[1].to).toBe(0);

done();