63 lines
1.8 KiB
Markdown
63 lines
1.8 KiB
Markdown
|
# API cheatsheet
|
|||
|
|
|
|||
|
|
```js
|
|||
|
|
import {
|
|||
|
|
Circuit,
|
|||
|
|
Resistor, VoltageSource, CurrentSource, Capacitor, Potentiometer, NTCThermistor, Switch,
|
|||
|
|
Diode, LED, BJT_NPN,
|
|||
|
|
} from '../src/index.js';
|
|||
|
|
|
|||
|
|
const c = new Circuit();
|
|||
|
|
c.addComponent(new VoltageSource('V1', 'vcc', 'gnd', 5));
|
|||
|
|
c.addComponent(new Resistor('R1', 'vcc', 'out', 1000));
|
|||
|
|
c.addComponent(new LED('LED1', 'out', 'gnd', 'red'));
|
|||
|
|
|
|||
|
|
c.solveDC(); // { nodeVoltages, branchCurrents }
|
|||
|
|
c.nodeVoltage('out'); // 2.0 V
|
|||
|
|
c.branchCurrent('V1'); // −0.0136 A (source convention)
|
|||
|
|
|
|||
|
|
// Transient
|
|||
|
|
c.addComponent(new Capacitor('C1', 'out', 'gnd', 1e-6, 0));
|
|||
|
|
const samples = c.runTransient(/* tEnd */ 0.01, /* dt */ 1e-5, /* sampleEvery */ 10);
|
|||
|
|
|
|||
|
|
// Non-linear helpers
|
|||
|
|
led.currentThrough(c.state); // A
|
|||
|
|
led.brightness(c.state); // 0..1 (I/ratedCurrent)
|
|||
|
|
|
|||
|
|
// Parametric components
|
|||
|
|
pot.setWiper(0.75); // 0..1
|
|||
|
|
ntc.setTemperatureC(25);
|
|||
|
|
switch.set(true);
|
|||
|
|
```
|
|||
|
|
|
|||
|
|
## AVR harness
|
|||
|
|
|
|||
|
|
```js
|
|||
|
|
import { AVRHarness } from '../src/avr/AVRHarness.js';
|
|||
|
|
import { potToPwmProgram, adcReadProgram } from '../src/avr/programs.js';
|
|||
|
|
|
|||
|
|
const avr = new AVRHarness();
|
|||
|
|
avr.load(intelHexText); // or avr.loadProgram(Uint16Array)
|
|||
|
|
|
|||
|
|
avr.runCycles(16_000_000); // 1 s of 16 MHz AVR
|
|||
|
|
avr.getPin(13); // 0 or 1
|
|||
|
|
avr.onPinChange(13, (s) => { ... });
|
|||
|
|
avr.getPWMDuty(9); // 0..1
|
|||
|
|
avr.setAnalogVoltage(0, 2.5); // inject 2.5 V on A0
|
|||
|
|
avr.getSerialOutput(); // String buffer from USART TX
|
|||
|
|
```
|
|||
|
|
|
|||
|
|
## AVR mini-assembler
|
|||
|
|
|
|||
|
|
```js
|
|||
|
|
import { LDI, OUT, IN, STS, LDS, RJMP, SBRC, SBRS, NOP, assemble } from '../src/avr/asm.js';
|
|||
|
|
|
|||
|
|
const prog = assemble([
|
|||
|
|
LDI(16, 0xFF),
|
|||
|
|
OUT(0x04, 16), // DDRB = 0xFF
|
|||
|
|
LDI(16, 0x20),
|
|||
|
|
OUT(0x05, 16), // PORTB |= pin13
|
|||
|
|
RJMP(-1), // loop forever (back to self)
|
|||
|
|
]);
|
|||
|
|
```
|