# Design This file fixes the circuits, the timings and the dumps a build must match. The toolchain can vary, as long as the numbers here hold. ## Formulas Astable period `T = 0.693 * (ra + 2*rb) * c`, high time `0.693 * (ra + rb) * c`, low time `0.693 * rb * c`, duty `high / T`. Monostable width `1.1 * r * c` (the file states which resistor). Bounds ±5% unless the file tightens them. ## Model A shipped 555 subcircuit or a behavioural equivalent with 1/3 and 2/3 trip points, in `models/`. The netlists are `circuits/`. ## Inputs | Key | Label | Default | Notes | | --- | --- | --- | --- | | `vcc` | Supply, V | 5 | From 4.5 to 15, the supply used in the default suite. | | `ra` | Ra, ohms | 10000 | A timing resistor, from 1000 to 1e6. | | `rb` | Rb, ohms | 10000 | A second timing resistor, from 1000 to 1e6. | | `c` | C, farads | 1e-7 | The timing capacitor, from 1e-9 to 1e-5. | | `applications` | Two application circuits | on | A documented LED flasher and a one-shot, besides the two canonical forms. | | `model_note` | A model card | on | A shipped 555 model card; if off, a behavioural source with the same trip points may be used, as in the file. | | `engine` | Engine | ngspice | other is an equivalent SPICE that still consumes the same netlists and produces comparable plots. | ## Acceptance at the defaults A 555 in the canonical astable and monostable circuits, plus two applications when the option is on. Plots come from ngspice (or a documented equivalent). | Quantity | Value | Tolerance | Source | | --- | --- | --- | --- | | Astable R1, R2, C | 10 kΩ, 10 kΩ, 100 nF | 1% | Default | | Astable period | ln(2) * (R1 + 2*R2) * C = 2.08 ms | 5% | Measured peak to peak | | Astable duty | (R1+R2)/(R1+2*R2) = 66.7% | 5% | High time over period | | Monostable R, C | 10 kΩ, 100 nF | 1% | Pulse width 1.1 * R * C = 1.10 ms | | Trip points | 1/3 and 2/3 of VCC | 2% | VCC is 5.0 V | ngspice writes a CSV of each plot. A script checks period, duty and trip points against this table. The LED flasher and the one-shot, when applications are on, have their own rows in a shipped `fixtures/timer-plots.json`. No breadboard is required. ## Screenshots These pictures are plots of a real circuit simulation of the reference netlist in `reference/astable.cir`, at the default inputs. They are not drawings of a product that has not been built or simulated. The first picture is the one Spekkr shows on the spec's card. A build may ship its own goldens; those goldens are of that build and do not have to match these frames pixel-for-pixel. | File | What it shows | | --- | --- | | `shots/astable.png` | Astable period 2.08 ms, duty 66.7% | | `shots/monostable.png` | Monostable 1.10 ms pulse after a trigger | ## How to verify 1. Run the simulation or the HDL testbench at the defaults, with no physical board. 2. Compare periods, trip points, register dumps or frames to the acceptance table in this file. 3. Corrupt one documented value on purpose and confirm the check fails. 4. Ngspice (or an equivalent) plots are measured against documented periods, duty cycles, pulse widths, and trip points, within a stated bound. Application circuits, if on, are included. No breadboard and no oscilloscope are required.