Project Files of Quartz Clock Movement Library for Proteus V1.0 (Arduino)

QUARTZ CLOCK MOVEMENT LIBRARY FOR PROTEUS - V1.0 (the wall clock's tick
movement and its Lavet stepping motor, with a dial and hands)
Designed by The Engineering Projects
www.TheEngineeringProjects.com

IMPORTANT LINKS
Article (read it first - pictures, step by step, every feature explained):
  https://www.theengineeringprojects.com/2026/11/quartz-clock-movement-library-for-proteus-v1-0.html
Report a bug or suggest a feature (our forum):
  https://www.theengineeringprojects.com/forum/category/motor-driver-proteus-library
The demo runs on our Arduino UNO V4.0 (included) - working LEDs, RESET and a
built-in serial monitor - its own article:
  https://www.theengineeringprojects.com/2026/10/arduino-uno-library-for-proteus-v40.html
Support us (the libraries are free):
  https://www.theengineeringprojects.com/donate

FILE STRUCTURE
Quartz-Clock-Movement-TEP-v1.0/
|-- Proteus Library Files/
|   |-- ArduinoV4TEP.LIB                              201.9 KB   TEP Arduino boards V4.0 (UNO) -> LIBRARY
|   |-- TEPQCLOCK.LIB                                  22.5 KB   the library -> LIBRARY folder
|-- Proteus Model Files/
|   |-- TEPARDUINO.DLL                                883.5 KB   the Arduino board model -> MODELS folder
|   |-- TEPQCLOCK.DLL                                 309.0 KB   the model -> MODELS folder
|-- Proteus Simulation/
|   |-- Clock_Demo.hex                                 23.9 KB   the demo firmware
|   |-- Quartz-Clock-Movement-ArduinoUnoV4.pdsprj      19.9 KB   the demo project
|   |-- TEPARDUINO.DLL                                883.5 KB   copy of the board model
|   |-- TEPQCLOCK.DLL                                 309.0 KB   copy of the model
|-- Arduino Code/
|   |-- Clock_Demo/Clock_Demo.ino                       6.3 KB   the demo sketch (source of the .hex)
|-- README.txt                                        ~16.3 KB   this file
Total: 2.61 MB (unzipped). The C++ source code of the models is not included.

WHAT IS IT?
A simulation model of the quartz clock movement - the 56 mm square "tick"
movement behind most wall clocks - with its coil taken over by a
microcontroller, as makers do to build their own clocks, slave clocks, word
clocks or a clock that sets itself. Inside the movement a Lavet stepping motor
turns the hands: a small coil, a magnet rotor that turns half a turn for each
pulse, and the gear train to the second hand. Our own model:
  * The coil between A and B (two leads, either way round) is in the circuit
    with its resistance and inductance: 230 ohm and 0.25 H - a 1.5 V coil.
    Two Arduino pins through a resistor, transistors or an H-bridge drive it.
  * A step: a pulse of the opposite polarity to the last step, at least
    2.5 mA for 8 ms. The rotor turns 180 deg and the second hand one second.
  * The pulses must alternate. The rotor is a magnet: a pulse of the same
    polarity as the last step finds it already there and does nothing. A
    pulse that is too short or too weak does nothing either, and a pulse that
    comes within 33 ms of the last step (the rotor still turning) is lost.
    Each miss is logged with its reason.
  * The face: the time set in property START plus the steps, as a 12-hour
    clock; the second hand swings through each step over 25 ms.
  * The run state from the steps over the last 2 s: TICKING (a step a second),
    FAST (more - the hands racing to set the time) or STOPPED (no step for
    2.5 s).
  * Warnings: more than 3 V across the coil (a 1.5 V coil straight on 5 V),
    a coil left on for 0.5 s.
  * The crown: the pop-up's chips set the hands (+1 min, +1 hour, 12:00:00)
    without steps, as the knob at the back of the movement does.
The symbol shows the movement from the front: the black square case with its
QUARTZ label and corner pins, the dial with its minute dots and 12 / 3 / 6 / 9,
and the red and black coil wires to the pins A and B. At Run the hour, minute
and red second hands turn to the face's time. The plate, the PULSE LED (green:
a + pulse A to B, red: a - pulse B to A; it stays lit 0.4 s after each pulse),
the rating line and the strip under the plate (TIME, STEPS, MISSED, OPEN
PANEL) are TEP additions; the real movement has none of them.

ONE DEVICE (search "quartz" or "clock" in Pick Devices):
  QCLOCKTEP      "Quartz Clock Movement V1.0"   (category Electromechanical >
                 Motors), model TEPQCLOCK.DLL
  The pop-up panel "TEP Quartz Clock Movement" opens at Run (and with OPEN
  PANEL on the strip) - the look of the TEP Serial Monitor. Tabs Clock,
  Graphs, Event log and Check; gear and ? icons for Settings and Help; the
  palette icon switches the theme:
    Clock      the state in big letters (TICKING, FAST with the steps a
               second, STOPPED, MISSED A STEP with the reason); the face with
               its hands; the live values (state, step rate, steps, missed,
               the last pulse and its peak, the last miss, the polarity the
               next step needs); the coil current over the last 2.5 s - the
               + and - pulses against the 2.5 mA a step needs. The toolbar:
               the crown (+1 min, +1 hour, 12:00:00).
    Graphs     the step rate, each pulse's peak current and the face against
               the simulated time (racing raises it, missed steps lower it)
               over the last 10, 30 or 60 s. Live / Freeze.
    Event log  TICKING, FAST, STOPPED with the face's time, every MISSED step
               with its reason ("MISSED - 5.7 ms, 6.8 mA: too short or weak
               (a step needs 2.5 mA for 8 ms)"), the crown, the warnings;
               filters All / Motion / Warnings, Pause, Clear
    Check      Good for: hands that do not move, jump only every other second,
               lose time when racing, or a coil that gets warm - the pulses,
               the current, the width, the rate, the voltage, the misses,
               with tips
    Settings   theme, text size, open at Run, window size
    Help       report a bug, suggest a feature, article, updates, donate,
               forum; Copy diagnostics for a bug report

TEST STATUS
V1.0: verified in Proteus 8.5 on 29 Oct 2026 (the demo project as shipped: an
A4 sheet, an Arduino UNO V4.0 with its built-in monitor, R1 470R and the
movement; all pop-ups open). What the runs showed:
  * The project loads and starts cleanly; from 1.3 s the hands tick once a
    second: "TICKING - a step a second, the face at 10:08:00". Each pulse:
    6.8 mA peak, 1.55 V on the coil, 31 ms; the PULSE LED flashes green and
    red in turn.
  * "fast 60": 60 steps at 20 a second - "FAST - more than a step a second
    (the hands racing)" - then TICKING again.
  * "set 10:15": "Racing 344 steps (17.2 s)", the hands stop at 10:15:00 and
    tick on.
  * "wrong": "MISSED - the same polarity again (- B to A): the rotor is
    already there (pulses alternate)"; the next pulse steps again.
  * "width 4": four pulses of 5.7 ms missed - "too short or weak" - and
    STOPPED after 2.5 s; "width 30" ticks again.
  * The crown's +1 hour: 10:15:07 became 11:15:07 with no step.
  * "stop": STOPPED; "run": TICKING. "time": the sketch's count 10:15:16 - the
    face shows 11:15:11, the crown's hour on and the 5 missed steps back.
  Plus automatic checks on a PC, 0 failed: 37 on the movement (the coil from
  5 V through 470 ohm: 7.1 mA, 1.6 V; 10 alternating pulses = 10 steps, the
  face 10 s on, TICKING; STOPPED after 2.5 s; the same polarity twice, a 4 ms
  pulse and a 1.7 mA pulse missed; 12 ms pulses every 50 ms = 20 steps a
  second, FAST; every 20 ms the rotor is still turning - misses; the second
  hand's swing; the over-voltage and coil-on warnings; the start time; every
  event text fits); 3 on the pop-up pages rendered; the demo project read
  back from disk (33 checks: devices, pins, wires, labels, no wire through a
  part, no crossing).

INSTALLATION (about 2 minutes)
1. Close Proteus. Extract the WHOLE ZIP to a normal folder (e.g. Desktop).
2. Copy everything in "Proteus Library Files" (TEPQCLOCK.LIB and our Arduino
   library V4.0, ArduinoV4TEP.LIB) to the LIBRARY folder of Proteus, for
   example:
     C:\Program Files (x86)\Labcenter Electronics\Proteus 8 Professional\LIBRARY
   (on some PCs: C:\ProgramData\Labcenter Electronics\Proteus 8 Professional\
   LIBRARY - use the folder that already holds Proteus's own .LIB files).
3. Copy TEPQCLOCK.DLL and TEPARDUINO.DLL from "Proteus Model Files" to the
   MODELS folder (...\Proteus 8 Professional\MODELS).
4. Delete TEPQCLOCK.IDX from the LIBRARY folder if it is there.
5. Start Proteus. In Pick Devices (P) search "quartz".

RUN THE DEMO
"Proteus Simulation\Quartz-Clock-Movement-ArduinoUnoV4.pdsprj" - keep the .hex
file and the DLLs beside the project.
  ARD1: Arduino UNO V4.0 running Clock_Demo.hex, its serial monitor built in
        (window "TEP Arduino UNO - ARD1").
  R1:   470R - from D2 (net label) to the movement's A.
  M1:   the movement: A through R1 to D2, B on D3 - by net labels.
  1. Press Run. The monitor and the pop-up open (move them aside). The hands
     tick once a second, the PULSE LED green and red in turn.
  2. Type in the monitor and press Send: fast 60, set 10:30, wrong, width 4,
     width 30, stop, run, time.
  3. Set the hands with the pop-up's crown chips (+1 hour), then tell the
     sketch: sync 11:30.
  4. Double-click M1 and set START (e.g. 3:59:50) - the face at the next Run.
  5. The pop-up: Clock, Graphs, Event log, Check.

WIRING (the same idea on a real movement - see REAL HARDWARE)
  Movement        Arduino UNO
   coil A         D2 through a 470R resistor
   coil B         D3
In the sketch (no library needed):
  digitalWrite(2, HIGH); digitalWrite(3, LOW);   // a + pulse ...
  delay(30);
  digitalWrite(2, LOW);                          // ... both LOW again
  // a second later: D3 HIGH, D2 LOW for 30 ms - the - pulse
REAL HARDWARE:
 * Open the movement (the clips at the back), lift out the small board, cut
   the two tracks from the chip to the coil (or take the chip out) and
   solder two thin wires to the coil's pads. Put it back without the AA
   cell.
 * The coil is about 200 - 250 ohm, made for 1.5 V: from 5 V use 470R - 1k in
   series; from 3.3 V about 220R. An Arduino pin gives the few mA easily.
 * Movements differ: most step with 20 - 50 ms pulses; if yours misses steps,
   try "width 50".
 * Only the "tick" movements have this motor. Silent "sweep" movements drive
   theirs with fast pulses all the time - this model is a tick movement.
 * Keep the sketch's count of the face in EEPROM: after a power cut the hands
   do not know where they are, and the sketch must remember for them.

THE DEMO SKETCH ON THE SERIAL MONITOR (Clock_Demo V1.0, 9600 baud)
  set 10:30   race the hands forward to 10:30 (or 10:30:15), 20 steps a second
  fast 60     race 60 steps           sync 10:30  the hands show 10:30 now
  width 30    the pulse width in ms (try 4: every step missed)
  wrong       one pulse of the same polarity as the last one (missed)
  stop / run  stop or start the ticking         time  the sketch's count
  help        the list
EXPECTED MONITOR OUTPUT
  Quartz Clock Movement demo - The Engineering Projects
  The coil between D2 (through R1, 470R) and D3: a 30 ms pulse a second, + then -.
  The hands at 10:08:00
  Commands: set 10:30 | fast 60 | sync 10:30 | width 30 | wrong | stop | run | time | help
  fast 60
  Racing 60 steps (3.0 s)
  Done - the hands at 10:09:14

PROPERTIES (double-click the part > Edit Properties)
  START      the time on the face at the start, h:mm:ss (default 10:08:00 -
             the clock makers' favourite)
Every run starts again from the properties.

TROUBLESHOOTING
* The hands do not move (STOPPED): no pulses - A / B not connected, the
  sketch stopped, or both pins HIGH (no current).
* They move only every other second: the pulses do not alternate - swap the
  pins' roles at each pulse (+ then -). The Check page says "two pulses of
  the same polarity".
* Every step missed, "too short or weak": a pulse under 8 ms, or too little
  current (under 2.5 mA - too big a series resistor).
* The face falls behind when racing: the pulses come faster than about 30 a
  second - the rotor needs 25 ms a step.
* "V on a 1.5 V coil": the coil straight on 5 V - add the series resistor.
* The part is not simulated: TEPQCLOCK.DLL is missing from MODELS and from the
  project folder. No UNO / no monitor window: TEPARDUINO.DLL, or click the
  UNO's USB port.
* The pop-up does not appear: click OPEN PANEL on the strip, or turn "Open the
  panel at Run" on its Settings page back on.

BUG REPORTS AND FEATURE REQUESTS
Please post them in our forum with a screenshot, the Serial Monitor text, the
simulation log and the pop-up's Copy diagnostics text:
  https://www.theengineeringprojects.com/forum/category/motor-driver-proteus-library

SUPPORT US
This library is free. If it saves you time, please support our work:
  https://www.theengineeringprojects.com/donate

LICENCES AND THIRD-PARTY NOTES
* The movement model (TEPQCLOCK.DLL), the symbol and artwork and the Arduino
  Library V4.0 (ArduinoV4TEP.LIB / TEPARDUINO.DLL) are made by The Engineering
  Projects. The model is an independent implementation written from the
  typical data of quartz clock movements and their Lavet stepping motors. The
  models use only standard Windows libraries; no Visual C++ redistributable
  is needed. The C++ source code is not included.
* The demo's .hex is built from the demo sketch and the Arduino AVR core 1.8.6,
  which includes LGPL-licensed code; its source code is available at
  https://github.com/arduino/ArduinoCore-avr/tree/1.8.6
* Proteus is a product of Labcenter Electronics and is not included. Arduino is
  a trademark of Arduino SA. This library is not made or endorsed by any clock
  maker, Arduino or Labcenter.

REBUILDING THE FIRMWARE (OPTIONAL)
The HEX file is supplied; Arduino IDE is not needed to run the demo. To edit
the sketch, open Arduino Code\Clock_Demo\Clock_Demo.ino, select Arduino Uno
and use Sketch > Export Compiled Binary. The sketch needs 8,688 bytes of flash
(27 % of the UNO) and 309 bytes of RAM.

MODEL SCOPE AND LIMITS
Modelled: the coil (resistance and inductance), the pulses (polarity, width,
peak current and voltage), the step rule (alternating, 2.5 mA for 8 ms, 33 ms
apart), the three kinds of miss, the face from START and the steps, the
second hand's swing, the run state, the crown, the over-voltage and coil-on
warnings.
How it runs: the coil is in the circuit as its backward-Euler companion over
the analog step (a conductance and a source); the analog step is held to
0.5 ms while a current flows (and for 50 ms after) and 2 ms without.
Not modelled: the rotor's back-EMF and its bounce, a load on the hands (a
heavy second hand on a weak pulse), the gear backlash, sweep movements.

VERSION
TEP Quartz Clock Movement library V1.0 (Oct 2026). Device QCLOCKTEP
(TEPQCLOCK.LIB / TEPQCLOCK.DLL). Demo sketch Clock_Demo V1.0. Demo board:
ARDUINO UNO V4.0 (TEP Arduino Library V4.0) with its built-in serial monitor.