Project Files of LRA Vibration Motor Library for Proteus Simulation

LRA VIBRATION MOTOR LIBRARY FOR PROTEUS SIMULATION - V1.0 (a 10 mm coin LRA that resonates, with a pop-up)
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/lra-vibration-motor-library-for-proteus.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, no Virtual Terminal to wire - its own article:
  https://www.theengineeringprojects.com/2026/10/arduino-uno-library-for-proteus-v40.html
The demo drives the LRA through our L9110S Motor Driver library (a SEPARATE library - install it too):
  https://www.theengineeringprojects.com/2026/10/l9110s-motor-driver-library-for-proteus-v1-0.html
Support us (the libraries are free):
  https://www.theengineeringprojects.com/donate

FILE STRUCTURE
LRA-Vibration-Motor-TEP-v1.0/
|-- Proteus Library Files/
|   |-- ArduinoV4TEP.LIB                              201.9 KB   TEP Arduino boards V4.0 (UNO) -> LIBRARY
|   |-- TEPLRA10.LIB                                   10.9 KB   the library -> LIBRARY folder
|-- Proteus Model Files/
|   |-- TEPARDUINO.DLL                                883.5 KB   the Arduino board model -> MODELS folder
|   |-- TEPLRA10.DLL                                  303.0 KB   the model -> MODELS folder
|-- Proteus Simulation/
|   |-- LRA_Demo.hex                                   21.1 KB   the demo firmware
|   |-- LRA-L9110S-ArduinoUnoV4.pdsprj                 20.6 KB   the demo project
|   |-- TEPARDUINO.DLL                                883.5 KB   copy of the board model
|   |-- TEPLRA10.DLL                                  303.0 KB   copy of the model
|-- Arduino Code/
|   |-- LRA_Demo/LRA_Demo.ino                           6.0 KB   the demo sketch (source of the .hex)
|-- README.txt                                        ~13.8 KB   this file
Total: 2.59 MB (unzipped). The C++ source code of the models is not included.

WHAT IS IT?
A 10 mm coin linear resonant actuator (LRA), the vibration motor of phones, watches and game
controllers, drawn at true scale (a 10 x
3.7 mm steel can, a flex tab and its leads; our own drawing, no maker's mark):
  * Inside, a voice coil pushes a small mass that rides on springs, so it shakes strongly at one
    frequency - its resonance - and hardly at all
    a few hertz away. It needs AC at that frequency, not DC.
  * Modelled from the maker's datasheet of the common 10 mm coin LRA: 2 Vrms rated (2.05 V max) as a
    sine at 175 Hz, 67 mA typical (90 mA
    max), 1.5 G peak-to-peak on a 100 g test sled, 24.4 ohm, resonance 174 +/- 8 Hz, the response
    about 6.5 Hz wide at half power, rise
    37 ms, stop 177 ms.
  * The model: the coil and its back-EMF, the mass on its springs (Q 33) solved with the circuit;
    the vibration of whatever it is fixed to.
  * Measured each cycle: the drive's fundamental and frequency, the back-EMF's phase against the
    drive (0 at resonance), the currents, the
    power; each burst's rise and stop, with and without an active brake.
  * Click it at Run for the pop-up: the mass on its springs, the frequency response with the working
    point, a scope of the drive and the
    back-EMF, graphs, an event log and a check page.
The body is drawn as on the real part and to true scale against our Arduino.
The TEP signature and the pop-up are TEP additions.

ONE DEVICE (search "LRACOIN" in Pick Devices):
  LRACOIN10TEP  "LRA Vibration Motor V1.0" in TEPLRA10.LIB (Electromechanical > Motors), prefix M,
  model TEPLRA10.DLL (analog). Pins +
                (the red lead) and - (the black lead), 400 thou apart (the L9110S's outputs). The
                name starts with L so that it sorts after
                the embedded ARDUINO UNO V4.0.
The demo's driver is our L9110S (L9110SADVTEP in TEPL9110S.LIB / TEPL9110S.DLL): a separate library
- install it from its own package.

THE POP-UP
Click the part at Run. Tabs:
    LRA        the mass on its springs with its swing, the frequency response at the present drive
    (the half-power band shaded) with the
               working point, a scope of the last 20 ms (the drive, the back-EMF, the vibration),
               and eight live values: vibration,
               frequency, drive, current, back-EMF phase, power, rise, stop.
    Graphs     the live values over the last 2, 6 or 15 s. Live / Freeze.
    Event log  every change and warning; filters All / Changes / Warnings, Pause, Clear
    Check      what the part is doing and what to look at, each with a verdict (green = fine, amber
    = check, red = wrong)
    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 8 Nov 2026 (the demo project as shipped: an A4 sheet, an Arduino UNO V4.0).
What the runs showed (the model's own numbers and the sketch's monitor):
  * The project loads and starts cleanly; the 11.6 s program runs in about three and a half minutes
    on our PC (with the pop-up open).
  * 175 Hz from the L9110S (a three-level wave from the UNO's Timer1): 1.98 Vrms at its fundamental,
    175.0 Hz - VIBRATING at 1.47 G
    peak-to-peak on the 100 g mount, the mass swinging +/-1.91 mm, the back-EMF 3 degrees from the
    drive; 94 mA rms in the coil, 66 mA of it
    at 175 Hz (the datasheet: 67 mA), 241 mW.
  * Rise: half the rated 1.5 G in 34.7 ms (the datasheet: 37 ms). Stop with the coil shorted: under
    0.04 G 180.4 ms after the drive ended
    (the datasheet: 177 ms). With an active brake (6 cycles against the motion): 62.5 ms.
  * The sweep from 150 to 200 Hz: 0.40 G at 163.7 Hz (the back-EMF 71 degrees ahead of the drive),
    1.32 G at 173.5 Hz; the best 1.48 G
    at 175.0 Hz. At 150 Hz with the same drive: only 0.20 G (OFF RESONANCE). At 175 Hz with half the
    drive (1.00 Vrms): 0.74 G.
  * The pop-up: LRA (the mass on its springs, the frequency response with the working point, the
    scope), Graphs, Event log, Check - all
    four followed the run; the rings round the can on the sheet grew with the vibration.

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" (TEPLRA10.LIB and our Arduino library V4.0,
ArduinoV4TEP.LIB, with the ARDUINO UNO V4.0 used by the demo) to the LIBRARY folder of Proteus, for
example:
     C:\Program Files (x86)\Labcenter Electronics\Proteus 8 Professional\LIBRARY
   (use the folder that already holds Proteus's own .LIB files).
3. Copy TEPLRA10.DLL and TEPARDUINO.DLL from "Proteus Model Files" to the MODELS folder (...\Proteus
8 Professional\MODELS).
4. Delete TEPLRA10.IDX from the LIBRARY folder if it is there (Proteus makes a new index).
5. Start Proteus. In Pick Devices (P) search "LRACOIN".

RUN THE DEMO
"Proteus Simulation\LRA-L9110S-ArduinoUnoV4.pdsprj" (an A4 sheet) - keep the .hex file and the DLLs
beside the project.
  ARD1:   Arduino UNO V4.0 running LRA_Demo.hex, its serial monitor built in (window "TEP Arduino
  UNO - ARD1").
  DRV1:   our L9110S driver: A-IA = D9, A-IB = D10 (Timer1 makes a three-level 175 Hz wave), VCC 5
  V, A-OA / A-OB to the LRA.
  M1:     the LRA: F0 175 Hz, MOUNT 100 g (the datasheet's test sled).
  1. 175 Hz at 2 Vrms, then stop (it rings down); again, then an active brake (6 cycles against the
  motion).
  2. A sweep from 150 to 200 Hz (the resonance shows as the peak); 150 Hz (off resonance); 175 Hz at
  1 Vrms (half the drive).
Closed the monitor? Click the UNO's USB port.

WIRING (the same in Proteus and on a real board)
  + and - to an H-bridge (or a haptic driver such as the DRV2605L): AC at the LRA's resonance, about
  2 Vrms; never a steady DC voltage.
REAL HARDWARE:
 * Drive it at its own resonance (174 +/- 8 Hz for this size): a fixed 175 Hz may be several hertz
   off on a real part - a haptic driver
   with auto-resonance finds it.
 * Keep under 2.05 Vrms; a square drive heats the coil more than a sine for the same vibration (the
   harmonics do not shake it).
 * Fix it firmly to the case: the vibration you feel is the mass's reaction through the mounting.

THE DEMO SKETCH ON THE SERIAL MONITOR (LRA_Demo V1.0, 9600 baud)
The sketch runs its program, then waits. Type a command:
  f 180    play 180 Hz        v 1.5    1.5 Vrms        s    stop        b    brake (6 cycles against
  the motion)
EXPECTED MONITOR OUTPUT
  TEP LRA demo - 10 mm coin LRA on an L9110S, 5 V
  2.50 s  175 Hz at 2.0 Vrms: the rated drive
  3.10 s  stop: the coil shorted - it rings down

PROPERTIES (double-click the part > Edit Properties)
  Resonant frequency (F0)              Hz (175; the datasheet: 174 +/- 8 Hz)
  Mount (MOUNT)                        the mass it shakes, g (100 = the datasheet's test sled)
Every run starts again from the properties.

LINKS.INI (OPTIONAL)
The Help page cards of the pop-up open web pages. To point them somewhere else without a new DLL,
put a text file named links.ini next to TEPLRA10.DLL with lines KEY=URL, for example:
  ARTICLE=https://www.theengineeringprojects.com/...
Keys: WEBSITE, FORUM, BUG_REPORT, FEATURE_REQUEST, ARTICLE, USER_GUIDE,
UPDATE_CHECK, DONATE. Only http:// and https:// links are used; lines starting
with # are comments.

TROUBLESHOOTING
* Hardly any vibration: the drive is off the resonance - a few hertz matter (the response is about
  6.5 Hz wide).
* DC on the coil: a steady voltage holds the mass aside and does not shake it - drive AC.
* OVER-DRIVEN: more than 2.05 Vrms at its fundamental.
* It buzzes on after the drive stops: the springs ring (stop 177 ms) - brake it with a few cycles
  against the motion.
* The part is not simulated: TEPLRA10.DLL is missing from MODELS and from the project folder. No UNO
  / no monitor window: TEPARDUINO.DLL is missing, or click the UNO's USB port.

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

WEBSITE
  https://www.theengineeringprojects.com/

LICENCES AND THIRD-PARTY NOTES
* The model (TEPLRA10.DLL), the symbols and artwork, the other parts of ours in the demo and the
  Arduino Library V4.0 (ArduinoV4TEP.LIB / TEPARDUINO.DLL, with its built-in TEP Serial Monitor
  Advance) are made by The Engineering Projects. The models use only standard Windows libraries; no
  Visual C++ redistributable is needed.
  The C++ source code is not included.
* Arduino UNO V4.0 (ArduinoV4TEP.LIB / TEPARDUINO.DLL, our Arduino Library V4.0 - its
  microcontroller is Proteus's own AVR model): The Engineering Projects,
  https://www.theengineeringprojects.com/2026/10/arduino-uno-library-for-proteus-v40.html
* The .hex file 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 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\LRA_Demo\LRA_Demo.ino, select Arduino Uno and use Sketch > Export Compiled Binary.
Replace the simulation's .hex with the exported HEX. The sketch needs 7,662 bytes of flash and 572
bytes of RAM.

MODEL SCOPE AND LIMITS
Modelled: the coil's resistance and back-EMF, the mass on its springs with its damping, solved with
the driver; the reaction on the mount;
the drive's fundamental, frequency and phase measured each cycle; rise and stop times.
Not modelled: the coil's inductance (85.8 uH: 0.1 ohm at 175 Hz), the springs' wear and temperature
drift, the mass hitting its end stops.

VERSION
TEP LRA Vibration Motor library V1.0 (Nov 2026). Device LRACOIN10TEP (TEPLRA10.LIB / TEPLRA10.DLL).
Demo sketch LRA_Demo V1.0. Demo board: ARDUINO UNO V4.0 (TEP Arduino Library V4.0) with its built-in
serial monitor; driver: our L9110S library.