Project Files of DRV8833 Motor Driver Library for Proteus Simulation

DRV8833 MOTOR DRIVER LIBRARY FOR PROTEUS SIMULATION - V1.0 (a dual H-bridge for two small DC motors, 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/drv8833-motor-driver-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 two motors of our TT Gear Motor library (a SEPARATE library - install it too):
  https://www.theengineeringprojects.com/2026/10/tt-gear-motor-library-for-proteus-v1-0.html
Support us (the libraries are free):
  https://www.theengineeringprojects.com/donate

FILE STRUCTURE
DRV8833-Motor-Driver-TEP-v1.0/
|-- Proteus Library Files/
|   |-- ArduinoV4TEP.LIB                              201.9 KB   TEP Arduino boards V4.0 (UNO) -> LIBRARY
|   |-- TEPDRV8833.LIB                                 16.0 KB   the library -> LIBRARY folder
|-- Proteus Model Files/
|   |-- TEPARDUINO.DLL                                883.5 KB   the Arduino board model -> MODELS folder
|   |-- TEPDRV8833.DLL                                312.5 KB   the model -> MODELS folder
|-- Proteus Simulation/
|   |-- DRV8833_Demo.hex                               18.4 KB   the demo firmware
|   |-- DRV8833-TTGEAR-ArduinoUnoV4.pdsprj             20.8 KB   the demo project
|   |-- TEPARDUINO.DLL                                883.5 KB   copy of the board model
|   |-- TEPDRV8833.DLL                                312.5 KB   copy of the model
|-- Arduino Code/
|   |-- DRV8833_Demo/DRV8833_Demo.ino                   4.5 KB   the demo sketch (source of the .hex)
|-- README.txt                                        ~14.3 KB   this file
Total: 2.61 MB (unzipped). The C++ source code of the models is not included.

WHAT IS IT?
The common DRV8833 motor driver module of robot kits - the small 12-pin board for two DC motors or
one stepper - drawn at true scale (an
18.5 x 16 mm red board with the TI DRV8833 in the middle, the input row IN1 IN2 VCC GND IN3 IN4 and
the output row EEP OUT1 OUT2 OUT3 OUT4
ULT; our own drawing, no maker's mark):
  * The chip (its datasheet): two H-bridges, 2.7 - 10.8 V, 1.5 A RMS and 2 A peak a bridge, 0.36 ohm
    a bridge (high + low side).
  * The input table: xIN1 xIN2 = 10 forward, 01 reverse, 11 brake (both low sides on: slow decay),
    00 coast (all open: fast decay).
    For the speed, a PWM on one input: with the other input LOW the off time is fast decay (the
    bridge opens, the motor coasts); with the
    other input HIGH it is slow decay (the motor is shorted in the off time, so it is braked down to
    the speed).
  * EEP is the chip's nSLEEP: high = on, low = sleep (all outputs open, 1.6 uA); 1 ms to wake. ULT
    is its nFAULT: open drain, low on an
    over-current (2 - 3.3 A in a bridge: that bridge off and retried every 1.35 ms),
    over-temperature or under-voltage.
  * The model: the two bridges averaged and solved with the motors, each input's PWM measured period
    by period, the body diodes, sleep,
    the faults on ULT, the die temperature.
  * Click it at Run for the pop-up: the two H-bridges with their switches, the motor voltage and
    current, the input table with each
    bridge's row lit, the sleep and fault flags; 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 "DRV8833" in Pick Devices):
  DRV8833TEP  "DRV8833 Motor Driver V1.0" in TEPDRV8833.LIB (Electromechanical > Motor Drivers),
  prefix U, model TEPDRV8833.DLL (mixed: the
              inputs, EEP and ULT digital, the bridges analog). Pins IN1 IN2 VCC GND IN3 IN4 on the
              left, EEP OUT1 OUT2 OUT3 OUT4 ULT on
              the right. The name starts with D so that it sorts after the embedded ARDUINO UNO
              V4.0.
The demo's motors are our TT gear motors (TTGEARMOTORTEP in TEPTTGEAR.LIB / TEPTTGEAR.DLL): a
separate library - install it from its own
package.

THE POP-UP
Click the part at Run. Tabs:
    Driver     the two H-bridges (each switch lit by its share of the time, the motor's voltage and
    current, the bridge's mode), the input
               table with each bridge's row lit (A yellow, B green), EEP / ULT and the faults; eight
               live values: supply, bridge A, bridge
               B, PWM, motor A, motor B, die, ULT.
    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 9 s program runs in about three minutes on our PC
    (with the three pop-ups open).
  * The DRV8833 on 6 V, two TT gear motors: both forward (10) at 5.94 V, 0.15 A, 245 RPM. Half speed
    (977 / 490 Hz PWM, 50 %): 0.1 s later
    motor A (slow decay) is down to 128 RPM, motor B (fast decay: the bridge open, coasting at 4.18
    V back-EMF) still at 190 RPM; both then
    settle at 2.95 V, 0.14 A. Stop: 0.1 s later A (brake, 11) is at 0 RPM, B (coast, 00) still at 64
    RPM.
  * A straight into reverse at full speed: 2.87 A - over the 2.6 A over-current threshold (2 - 3.3 A
    in the datasheet): FAULT, ULT low, 29
    trips (the 1.35 ms retries) in about 50 ms, then reversing (-2.27 A, -5.18 V) to 245 RPM CCW; B
    braked first (-0.99 A), then reversed
    without a trip. EEP low: SLEEP, both coasting; EEP high: reversing again; both braked. The die
    27.9 C at the most.
  * The pop-up: Driver (the two H-bridges, the input table lit, the sleep and fault flags), Graphs,
    Event log, Check - all four followed
    the run.

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" (TEPDRV8833.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 TEPDRV8833.DLL and TEPARDUINO.DLL from "Proteus Model Files" to the MODELS folder
(...\Proteus 8 Professional\MODELS).
4. Delete TEPDRV8833.IDX from the LIBRARY folder if it is there (Proteus makes a new index).
5. Start Proteus. In Pick Devices (P) search "DRV8833".

RUN THE DEMO
"Proteus Simulation\DRV8833-TTGEAR-ArduinoUnoV4.pdsprj" (an A4 sheet) - keep the .hex file and the
DLLs beside the project.
  ARD1:   Arduino UNO V4.0 running DRV8833_Demo.hex, its serial monitor built in (window "TEP
  Arduino UNO - ARD1").
  U1:     the DRV8833 on 6 V: IN1 D5, IN2 D6, IN3 D9, IN4 D10 (PWM pins), EEP D8, ULT D7 (the UNO's
  pull-up).
  M1, M2: our TT gear motors: motor A on OUT1 OUT2, motor B on OUT3 OUT4.
  1. Both forward; half speed with A in slow decay and B in fast decay; stop with A braked and B
  coasting.
  2. Both forward; A straight into reverse (the over-current trips), B braked first, then reversed;
  EEP low (sleep), high; both brake.
Closed the monitor? Click the UNO's USB port.

WIRING (the same in Proteus and on a real board)
  VCC 2.7 - 10.8 V (the motors' supply; the chip makes its own logic supply), GND to the
  controller's ground too. OUT1 OUT2 to one motor,
  OUT3 OUT4 to the other (or the two coils of a stepper). IN1 - IN4 to PWM pins, EEP high (a pin or
  VCC), ULT to an input with a pull-up.
REAL HARDWARE:
 * Brake before reversing a fast motor: straight into reverse the current is the supply plus the
   motor's back-EMF over its resistance.
 * Keep VCC under 10.8 V: two Li-ion cells (8.4 V) or four AA cells are fine, 12 V is not.
 * EEP left open sleeps the chip on this model (the chip's pull-down): tie it high.

THE DEMO SKETCH ON THE SERIAL MONITOR (DRV8833_Demo V1.0, 9600 baud)
The sketch runs its program, then waits. Type a command:
  a 150 / b -200    a motor's speed (-255 - 255, slow decay)    x    brake both    c    coast both
  e 0 / e 1    EEP low / high
EXPECTED MONITOR OUTPUT
  DRV8833 motor driver - The Engineering Projects
  IN1 IN2 / IN3 IN4: 10 fwd, 01 rev, 11 brake, 00 coast; PWM + low = fast decay, PWM + high = slow
  decay

PROPERTIES (double-click the part > Edit Properties)
  (none: like the real module, the inputs set everything)
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 TEPDRV8833.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
* SLEEP: EEP is low or not connected - all outputs open.
* A motor does not turn: both its inputs are low (coast) or high (brake), or the motor is not on its
  two outputs.
* ULT low: an over-current (2 - 3.3 A, retried every 1.35 ms), over-temperature or under-voltage
  (under 2.6 V).
* The motor runs at the wrong speed: slow and fast decay invert the duty differently - with IN1
  high, a larger PWM on IN2 is SLOWER.
* The part is not simulated: TEPDRV8833.DLL is missing from MODELS and from the project folder.
* The part is not simulated: TEPDRV8833.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 (TEPDRV8833.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\DRV8833_Demo\DRV8833_Demo.ino, select Arduino Uno and use Sketch > Export Compiled
Binary. Replace the simulation's .hex with the exported HEX. The sketch needs 6,698 bytes of flash
and 247 bytes of RAM.

MODEL SCOPE AND LIMITS
Modelled: the two H-bridges (averaged, 0.18 ohm a switch), each input's PWM per period, the input
table with slow and fast decay, the body
diodes (0.7 V), sleep (1 ms wake-up), under-voltage, the over-current at 2.6 A (4 us; retried every
1.35 ms), over-temperature (the die
through 45 K/W - our figure), ULT.
Not modelled: the PWM ripple (in fast decay a real motor's current also stops in each off time at
low PWM frequencies, so a lightly
loaded motor runs faster than here), the dead time, the current regulation through the sense pins
(grounded on this module).

VERSION
TEP DRV8833 Motor Driver library V1.0 (Nov 2026). Device DRV8833TEP (TEPDRV8833.LIB /
TEPDRV8833.DLL). Demo sketch DRV8833_Demo V1.0. Demo board: ARDUINO UNO V4.0 (TEP Arduino Library
V4.0) with its built-in serial monitor; motors: our TT Gear Motor library.