Project Files of SimpleFOC Mini Driver Library for Proteus Simulation

SIMPLEFOC MINI DRIVER LIBRARY FOR PROTEUS SIMULATION - V1.0 (a DRV8313 three-phase BLDC driver board, 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/simplefoc-mini-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 our 2204 Gimbal Motor library (a SEPARATE library - install it too):
  https://www.theengineeringprojects.com/2026/11/2204-gimbal-motor-library-for-proteus.html
Support us (the libraries are free):
  https://www.theengineeringprojects.com/donate

FILE STRUCTURE
SimpleFOC-Mini-Driver-TEP-v1.0/
|-- Proteus Library Files/
|   |-- ArduinoV4TEP.LIB                              201.9 KB   TEP Arduino boards V4.0 (UNO) -> LIBRARY
|   |-- TEPSFOCMINI.LIB                                18.1 KB   the library -> LIBRARY folder
|-- Proteus Model Files/
|   |-- TEPARDUINO.DLL                                883.5 KB   the Arduino board model -> MODELS folder
|   |-- TEPSFOCMINI.DLL                               294.0 KB   the model -> MODELS folder
|-- Proteus Simulation/
|   |-- SFOC_Demo.hex                                  24.1 KB   the demo firmware
|   |-- SFOCMINI-GIMBAL2204-ArduinoUnoV4.pdsprj        20.0 KB   the demo project
|   |-- TEPARDUINO.DLL                                883.5 KB   copy of the board model
|   |-- TEPSFOCMINI.DLL                               294.0 KB   copy of the model
|-- Arduino Code/
|   |-- SFOC_Demo/SFOC_Demo.ino                         6.1 KB   the demo sketch (source of the .hex)
|-- README.txt                                        ~14.2 KB   this file
Total: 2.58 MB (unzipped). The C++ source code of the models is not included.

WHAT IS IT?
The SimpleFOC Mini v1.1, the small open-source BLDC driver board of the SimpleFOC project for gimbal
motors and field-oriented control,
drawn at true scale (a 26 x 20 mm board with the DRV8313, its capacitors, the input header, the
motor and power pads and the optional header;
our own drawing):
  * A TI DRV8313: three independent half-bridges, each with a high-side and a low-side switch of
    0.24 ohm, 2.5 A peak. IN1, IN2 and IN3
    each drive one output: high = the output to V+, low = to V-. With three PWMs a microcontroller
    makes three average voltages - a voltage
    vector that turns the motor's field. EN low opens all three outputs.
  * From the board's documentation and the DRV8313 datasheet: 8 - 35 V on this board; nSP (sleep)
    and nRT (reset), active low; nFT (fault)
    low on under-voltage, over-current (3 - 5 A, latched until a reset or a power cycle) or
    over-temperature (160 C); the chip's 3.3 V
    regulator gives 10 mA; PWM up to 250 kHz.
  * The model: the three half-bridges averaged and solved with the motor, each input's PWM measured
    period by period, EN, sleep with its
    1 ms wake-up, reset, the faults on nFT, the die temperature, the regulator.
  * Click it at Run for the pop-up: the three half-bridges with their duty, voltage and current, the
    voltage vector, the controls and the
    faults; tiles, 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 "SIMPLEFOC" in Pick Devices):
  SIMPLEFOCMINITEP  "SimpleFOC Mini Driver V1.0" in TEPSFOCMINI.LIB (Electromechanical > Motor
  Drivers), prefix U, model TEPSFOCMINI.DLL
                    (mixed: the inputs and nFT digital, the half-bridges and 3V3 analog). Pins IN1
                    IN2 IN3 EN GND on the left, M1 M2 M3 V+ V-
                    on the right, 3V3 nRT nSP nFT along the bottom. The name starts with S so that
                    it sorts after the embedded ARDUINO UNO
                    V4.0.
The demo's motor is our 2204 gimbal motor (GIMBAL2204TEP in TEPGIMBAL2204.LIB / TEPGIMBAL2204.DLL):
a separate library - install it from its
own package.

THE POP-UP
Click the part at Run. Tabs:
    Driver     the three half-bridges (each switch lit by its share of the period, the output's
    average voltage and current), the voltage
               vector the three outputs make (its size and electrical angle, with the three duties),
               the controls EN / nSP / nRT / nFT and
               the faults; eight live values: supply, PWM, outputs, current, vector, die, 3V3,
               fault.
    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 10.4 s program runs in about three and a half minutes
    on our PC (with both pop-ups open).
  * On 12 V with our 2204 gimbal motor: the three inputs at 31.4 kHz from the UNO's Timer1 and
    Timer2, a 2 V voltage vector (SimpleFOC's
    open loop): at EN high the motor holds at 11.5 deg, 0.47 A. The +-60 deg sweep at 0.5 Hz: 66 /
    38 / 46 % duty, a 2.00 V vector at
    343 deg, 0.45 A in the phases, 0.123 A from the supply; the motor follows at up to about 31 RPM.
  * 2 rev/s: 41 / 67 / 42 % at one moment, a 1.99 V vector at 122 deg, 0.45 A, 0.117 A from 12 V;
    the motor at 122 RPM.
  * nSP low: SLEEP - all six switches off, 0.001 A, the motor coasts to rest; nSP high: awake 1 ms
    later, the motor back in step at 120 RPM.
    EN low: DISABLED - all outputs open (0.005 A). A 20 ms nRT pulse: RESET, then the hold. nFT
    stayed high: no fault.
  * The pop-up: Driver (the half-bridges with their duty and current, the voltage vector, the
    controls and the faults), Graphs (the three
    duties), 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" (TEPSFOCMINI.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 TEPSFOCMINI.DLL and TEPARDUINO.DLL from "Proteus Model Files" to the MODELS folder
(...\Proteus 8 Professional\MODELS).
4. Delete TEPSFOCMINI.IDX from the LIBRARY folder if it is there (Proteus makes a new index).
5. Start Proteus. In Pick Devices (P) search "SIMPLEFOC".

RUN THE DEMO
"Proteus Simulation\SFOCMINI-GIMBAL2204-ArduinoUnoV4.pdsprj" (an A4 sheet) - keep the .hex file and
the DLLs beside the project.
  ARD1:   Arduino UNO V4.0 running SFOC_Demo.hex, its serial monitor built in (window "TEP Arduino
  UNO - ARD1").
  U1:     the SimpleFOC Mini on 12 V: IN1 IN2 IN3 = D9 D10 D11 (31 kHz PWM), EN = D8, nRT = D5, nSP
  = D6, nFT = D7 (read back).
  M1:     our 2204 gimbal motor: LOAD 0.002 N.m, INERTIA 30 g.cm2; A B C from M1 M2 M3.
  1. EN high: hold; a +-60 deg sweep at 0.5 Hz (a gimbal panning); 2 rev/s (a 2 V voltage vector,
  open loop as SimpleFOC does it).
  2. nSP low (sleep: the motor coasts), nSP high; EN low (all open), EN high; a reset pulse on nRT;
  hold.
Closed the monitor? Click the UNO's USB port.

WIRING (the same in Proteus and on a real board)
  V+ / V- the supply (8 - 35 V), M1 M2 M3 the motor's phases; IN1 IN2 IN3 to three PWM pins
  (SimpleFOC: BLDCDriver3PWM(IN1, IN2, IN3, EN)),
  EN to a pin (or high), GND to the controller's ground; nSP / nRT may stay open (pulled up), nFT to
  an input to read the faults.
REAL HARDWARE:
 * The 3V3 pin gives only 10 mA: not enough to power a microcontroller.
 * For gimbal motors (over 10 ohm) the board needs no current sensing: the voltage you set decides
   the current.
 * An over-current latches the output off: pull nRT low (or cycle the power) to clear it - toggling
   EN does not.

THE DEMO SKETCH ON THE SERIAL MONITOR (SFOC_Demo V1.0, 9600 baud)
The sketch runs its program, then waits. Type a command:
  v 2      turn at 2 rev/s     a 45     go to 45 deg     s 0 / s 1    sleep / wake     e 0 / e 1
  EN low / high
EXPECTED MONITOR OUTPUT
  TEP SimpleFOC Mini demo - a 2204 gimbal motor in open loop, 12 V
  0.50 s  EN high: hold at 0 deg
  1.00 s  sweep +-60 deg at 0.5 Hz

PROPERTIES (double-click the part > Edit Properties)
  (none: like the real board, 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 TEPSFOCMINI.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
* DISABLED: EN is low or not connected (the chip's pull-down) - all outputs open.
* An output stays at V-: its IN pin is not connected (it reads low).
* nFT low: under-voltage (under 6.6 V), an over-current (pull nRT low to clear it) or
  over-temperature.
* The motor does not follow: the voltage vector is too small for the load, or the field turns too
  fast for it to keep up.
* The part is not simulated: TEPSFOCMINI.DLL is missing from MODELS and from the project folder.
* The part is not simulated: TEPSFOCMINI.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 (TEPSFOCMINI.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\SFOC_Demo\SFOC_Demo.ino, select Arduino Uno and use Sketch > Export Compiled Binary.
Replace the simulation's .hex with the exported HEX. The sketch needs 8,766 bytes of flash and 519
bytes of RAM.

MODEL SCOPE AND LIMITS
Modelled: the three half-bridges (averaged, 0.24 ohm a switch, synchronous), each input's PWM per
period, EN (Hi-Z), sleep (1 ms wake-up), reset,
under-voltage, the latched over-current at 4 A (5 us), over-temperature (the die through 45 K/W -
our figure), nFT, the 3.3 V regulator.
Not modelled: the PWM ripple, the 90 ns dead time and the switching delays, the body diodes while
open, the board's capacitors.

VERSION
TEP SimpleFOC Mini Driver library V1.0 (Nov 2026). Device SIMPLEFOCMINITEP (TEPSFOCMINI.LIB /
TEPSFOCMINI.DLL). Demo sketch SFOC_Demo V1.0. Demo board: ARDUINO UNO V4.0 (TEP Arduino Library
V4.0) with its built-in serial monitor; motor: our 2204 Gimbal Motor library.