Project Files of Planetary Gear Motor Library for Proteus Simulation

PLANETARY GEAR MOTOR LIBRARY FOR PROTEUS SIMULATION - V1.0 (a 36GP-555 winch 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/planetary-gear-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 motor through our BTS7960 Motor Driver library (a SEPARATE library - install it too):
  https://www.theengineeringprojects.com/2026/10/bts7960-motor-driver-library-for-proteus-v1-0.html
Support us (the libraries are free):
  https://www.theengineeringprojects.com/donate

FILE STRUCTURE
Planetary-Gear-Motor-TEP-v1.0/
|-- Proteus Library Files/
|   |-- ArduinoV4TEP.LIB                              201.9 KB   TEP Arduino boards V4.0 (UNO) -> LIBRARY
|   |-- TEPPLANETARY.LIB                               13.0 KB   the library -> LIBRARY folder
|-- Proteus Model Files/
|   |-- TEPARDUINO.DLL                                883.5 KB   the Arduino board model -> MODELS folder
|   |-- TEPPLANETARY.DLL                              309.0 KB   the model -> MODELS folder
|-- Proteus Simulation/
|   |-- Planetary_Demo.hex                             13.1 KB   the demo firmware
|   |-- Planetary-Winch-BTS7960-ArduinoUnoV4.pdsprj    21.2 KB   the demo project
|   |-- TEPARDUINO.DLL                                883.5 KB   copy of the board model
|   |-- TEPPLANETARY.DLL                              309.0 KB   copy of the model
|-- Arduino Code/
|   |-- Planetary_Demo/Planetary_Demo.ino               4.3 KB   the demo sketch (source of the .hex)
|-- README.txt                                        ~15.2 KB   this file
Total: 2.59 MB (unzipped). The C++ source code of the models is not included.

WHAT IS IT?
The 36 mm 12 V planetary gear motor 36GP-555 with a 1:26.8 gearbox - the motor of robot drives,
winches, actuators and lifting
mechanisms - drawn at true scale from the makers' sizes (a 36 x 32.8 mm two-stage gearbox, a 35.8 x
57 mm 555 motor, an 8 mm D-shaft,
118 mm long), our own drawing:
  * The model: the 555 motor (1.5 ohm, 18.6 mV.s/rad, a breakaway friction at rest), two planetary
    stages of 5.18 : 1 (sun 11, planets 17,
    ring 46 teeth), 65 % efficient when the motor drives the load and 55 % when the load drives the
    motor.
  * Modelled from the makers' table at 12 V: 224 RPM / 200 mA free, 170 RPM at 6 kg.cm and 2 A (10.5
    W) rated, 25 kg.cm at 8 A stalled.
    The model: 224 RPM / 200 mA free, 6 kg.cm at 172 RPM / 2.00 A, 25.7 kg.cm at 8 A.
  * A planetary gearbox is BACK-DRIVABLE: a heavy load turns the motor backwards when nothing holds
    it - the opposite of a worm gear. A
    light load is held by friction alone.
  * A winch on the shaft (a drum, a rope, a weight - properties or chips in the pop-up): lift, hold,
    lower, brake (the shorted motor only
    slows the weight down), coast (the weight falls), the top stop and the stall.
  * Click it at Run for the pop-up: the winch and one planetary stage turning, the shaft's
    torque-speed line with the rated point, the
    weight's torque and the working point, eight values, 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 "PLANETARY" in Pick Devices):
  PLANETARYGM36TEP  "Planetary Gear Motor 36GP-555 V1.0" in TEPPLANETARY.LIB (Electromechanical >
  Motors), prefix M, model
                    TEPPLANETARY.DLL (analog). Pins + (the red lead) and - (the black lead). The
                    name starts with PLANETARY so that it
                    sorts after the embedded ARDUINO UNO V4.0.
The demo's driver is our BTS7960 (BTS7960ADVTEP in TEPBTS7960.LIB / TEPBTS7960.DLL): a separate
library - install it from its own package.

THE POP-UP
Click the part at Run. The chips on top change the weight: No weight, 1, 3, 5, 10, 20 kg. Tabs:
    Winch      the gear motor, the drum, the rope and the weight above the floor with a height scale
    and the top pulley, one planetary
               stage turning (the sun on the motor, three planets, the fixed ring), the shaft's
               torque-speed line at the present voltage
               and at 12 V with the rated point, the weight's torque and the working point, and
               eight live values: height and rope speed,
               shaft and motor speed, shaft torque, current, voltage, power in and into the weight,
               the weight and its torque, back-driving.
    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 21 s program runs in about five and a half minutes on
    our PC (with the pop-up open).
  * 3 kg on the 30 mm drum (4.5 kg.cm): lifted at 29.0 cm/s - 185 RPM at the shaft, 1.55 A at 12.0
    V. Braked (the motor shorted): it
    creeps down at 1.54 cm/s with 0.34 A generated. Held with 12 % PWM (1.44 V): still at 43.3 cm
    with 0.96 A. Lowered at 40 %: 16.0 cm/s
    with 0.32 A. Coasting (the enables low): it back-drives the gearbox and falls from 18.3 cm,
    landing at 41.2 cm/s - the BTS7960's
    diodes brake the motor once its voltage passes the supply.
  * 1 kg (a chip in the pop-up): lifted at 33.1 cm/s - 211 RPM, 1.5 kg.cm, 0.65 A. Coasting: HELD BY
    FRICTION at 29.7 cm - too light
    to back-drive the gears. Lowered at 30 %: 10.9 cm/s with almost no current.
  * 20 kg (a chip): it needs 30.0 kg.cm, the motor gives 25.4 kg.cm at 11.9 V - STALLED at 7.92 A
    (held, not lifted); braked, it came
    down and landed at 14.0 cm/s.
  * The pop-up: Winch (the winch, a planetary stage turning, the torque-speed line with the working
    point, eight values), Graphs, Event
    log, Check - all four followed the run; the weight chips worked while running.

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

RUN THE DEMO
"Proteus Simulation\Planetary-Winch-BTS7960-ArduinoUnoV4.pdsprj" (an A4 sheet) - keep the .hex file
and the DLLs beside the project.
  ARD1:   Arduino UNO V4.0 running Planetary_Demo.hex, its serial monitor built in (window "TEP
  Arduino UNO - ARD1").
  DRV1:   our BTS7960 driver: RPWM = D5 (lifting), LPWM = D6 (lowering), R_EN = D7, L_EN = D8, VCC 5
  V, B+ = +12V, B- = GND.
  M1:     the planetary gear motor with its winch: MASS 3 kg, DRUM 30 mm, HEIGHT 0 (on the floor),
  TOP 60 cm.
  1. Lift at 100 %, brake (the weight creeps down), hold at 12 %, lower at 40 %, brake, coast (the 3
  kg weight falls and lands).
  2. With 1 kg (a chip in the pop-up): lift, coast (friction holds it), lower at 30 %, brake.
  3. With 20 kg (a chip): lift at 100 % - stalled; brake - it creeps down and lands.
Closed the monitor? Click the UNO's USB port.

WIRING (the same in Proteus and on a real board)
  the motor's + and - to a motor driver that can carry its stall current (8 A at 12 V): a BTS7960 /
  IBT-2, never an L298 or an L9110S;
  12 V for the driver; PWM on one input lifts, on the other lowers; both inputs low with the driver
  enabled brakes, the enables low coast.
REAL HARDWARE:
 * A planetary gear motor does not hold a heavy load by itself: with the power off the load turns it
   backwards. Use a brake, a worm
   gear or a holding current for loads that must not fall.
 * Its stall current (8 A at 12 V) needs a big driver and wiring; never let it stall for long - it
   heats quickly.
 * Shorting the motor (braking) only slows a falling load; it does not stop it.
 * Fit the drum or the pulley on the D-flat with a set screw; mind the side load on the output
   bearing.

THE DEMO SKETCH ON THE SERIAL MONITOR (Planetary_Demo V1.0, 9600 baud)
The sketch runs its program, then waits. Type a command to drive the winch yourself (it ends the
program):
  u 60    up at 60 %        d 40    down at 40 %        h 12    hold, 12 % up        b    brake
  c    coast
EXPECTED MONITOR OUTPUT
  TEP Planetary Gear Motor - a 36GP-555 winch on a BTS7960
  0.50 s  lift at 100 %
  2.10 s  brake: both PWM low, the motor shorted

PROPERTIES (double-click the part > Edit Properties)
  Weight (MASS)                        kg on the winch rope (3; 0 = none)
  Drum (DRUM)                          the winch drum's diameter, mm (30)
  Start height (HEIGHT)                the weight's height above the floor at the start, cm (0)
  Top (TOP)                            the rope stops at this height (a pulley), cm (60)
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 TEPPLANETARY.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
* FALLING: the driver is off (coasting) and the weight is heavy enough to back-drive the gears -
  brake, or hold with a small drive.
* BRAKED but still moving: braking only slows the weight; a heavy one creeps down. Hold it with a
  small PWM up instead.
* STALLED: the weight needs more torque than the motor gives at this voltage (25 kg.cm at 12 V; 20
  kg on a 30 mm drum needs 29).
* AT THE TOP: the rope reached the pulley - the motor stalls; stop lifting.
* OVER THE RATED CURRENT: more than 2 A for 3 s - a heavy load or a stall; the real motor heats.
* The part is not simulated: TEPPLANETARY.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 (TEPPLANETARY.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\Planetary_Demo\Planetary_Demo.ino, select Arduino Uno and use Sketch > Export Compiled
Binary. Replace the simulation's .hex with the exported HEX. The sketch needs 4,480 bytes of flash
and 477 bytes of RAM.

MODEL SCOPE AND LIMITS
Modelled: the 555 motor (resistance, back-EMF, breakaway, Coulomb and viscous friction, inertia)
with its driver in one circuit; the
gearbox ratio and its forward and backward efficiencies (back-driving, the friction that holds a
light load); the winch (the weight's
torque and inertia through the gears, the slack rope on the floor, the top stop); braking and
coasting through the driver.
Not modelled: the gearbox's backlash, the motor's inductance, heating, the noise, the rope's
stretch, a weight swinging.

VERSION
TEP Planetary Gear Motor library V1.0 (Nov 2026). Device PLANETARYGM36TEP (TEPPLANETARY.LIB /
TEPPLANETARY.DLL). Demo sketch Planetary_Demo V1.0. Demo board: ARDUINO UNO V4.0 (TEP Arduino
Library V4.0) with its built-in serial monitor; driver: our BTS7960 library.